Create AR invoice
Create an AR invoice for a customer with one or more lines. On Hold by default.
POST https://cotlet.dev/api/v1/acumatica/customers/{customer_id}/ar-invoices
write Confirm
Creates an invoice in Invoices and Memos for one customer. With hold set to true, the default, the invoice is saved On Hold; with false it is saved Balanced and can be released. The total is the sum of quantity times unit price over the lines. Taxes follow your Acumatica setup. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| customer_id string required | string | Customer ID as shown in Acumatica, from list_customers. |
| date date required | date | Document date. |
| 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), quantity (number) and unit_price (number). |
Request
curl -X POST https://cotlet.dev/api/v1/acumatica/customers/C000045/ar-invoices \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-10-31","hold":false,"lines":[{"description":"Hosting, October","quantity":1,"unit_price":2400},{"description":"Support hours","quantity":5,"unit_price":150}]}'result = client.call("acumatica", "create_ar_invoice", {"customer_id":"C000045","date":"2026-10-31","hold":False,"lines":[{"description":"Hosting, October","quantity":1,"unit_price":2400},{"description":"Support hours","quantity":5,"unit_price":150}]})const result = await cotlet.call('acumatica', 'create_ar_invoice', {"customer_id":"C000045","date":"2026-10-31","hold":false,"lines":[{"description":"Hosting, October","quantity":1,"unit_price":2400},{"description":"Support hours","quantity":5,"unit_price":150}]});cotlet call acumatica create_ar_invoice --data '{"customer_id":"C000045","date":"2026-10-31","hold":false,"lines":[{"description":"Hosting, October","quantity":1,"unit_price":2400},{"description":"Support hours","quantity":5,"unit_price":150}]}'Example response
{
"reference_nbr": "002231",
"customer_id": "C000045",
"status": "Balanced",
"total": 3150
}