Create AP bill
Create an AP bill for a vendor with one or more lines. On Hold by default.
MCP tool acumatica_write → create_ap_bill
write Confirm
Creates a bill in Bills and Adjustments for one vendor. With hold set to true, the default, the bill is saved On Hold and cannot be released until someone removes the hold. The total is the sum of the lines. Taxes and approvals follow your Acumatica setup, so a bill can come back Pending Approval. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| vendor_id string required | string | Vendor ID as shown in Acumatica, from list_vendors. |
| vendor_ref string required | string | The vendor's own invoice number. |
| date date required | date | Document date. |
| due_date date | date | Due date. Default: set by the vendor terms in Acumatica. |
| hold boolean | boolean | true saves the document On Hold so you can review it. false saves it as Balanced, ready to release. Default: true. |
| lines array required | array | Objects with description (string), amount (number) and account (string, an account number from your chart of accounts). |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "acumatica_write",
"arguments": {
"operation": "create_ap_bill",
"arguments": {
"vendor_id": "V000123",
"vendor_ref": "INV-20418",
"date": "2026-10-12",
"due_date": "2026-11-11",
"hold": true,
"lines": [
{
"description": "Printer paper, 40 boxes",
"amount": 960,
"account": "60100"
},
{
"description": "Toner cartridges",
"amount": 280,
"account": "60100"
}
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"reference_nbr": "004812",
"vendor_id": "V000123",
"vendor_ref": "INV-20418",
"status": "On Hold",
"total": 1240
},
"isError": false
}