Create AP bill
Create an AP bill for a vendor with one or more lines. On Hold by default.
POST https://cotlet.dev/api/v1/acumatica/vendors/{vendor_id}/ap-bills
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). |
Request
curl -X POST https://cotlet.dev/api/v1/acumatica/vendors/V000123/ap-bills \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"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"}]}'result = client.call("acumatica", "create_ap_bill", {"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"}]})const result = await cotlet.call('acumatica', 'create_ap_bill', {"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"}]});cotlet call acumatica create_ap_bill --data '{"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
{
"reference_nbr": "004812",
"vendor_id": "V000123",
"vendor_ref": "INV-20418",
"status": "On Hold",
"total": 1240
}