Create Accounting Bill
Creates a new accounting bill with line items and automatic journal entry generation.
This endpoint allows for complex bill creation with:
- Multiple line items with different accounts, departments, and vendor assignments
- Automatic accounts payable journal entry creation
- Tax calculations and tax account handling
- Exchange rate support for multi-currency transactions
- Custom field support for additional bill metadata
Requirements:
- All referenced accounts must exist and be active
- Vendor must exist
- Entity must exist
- Line items must have valid amounts and descriptions
- Currency must be valid for the entity
- Accounting date must be before closed book date
Authorizations
Token-based authentication with required prefix "Token"
Body
120custom- Customnet_5- Net 5net_7- Net 7net_10- Net 10net_15- Net 15net_20- Net 20net_30- Net 30net_40- Net 40net_45- Net 45net_60- Net 60net_90- Net 90net_105- Net 105net_120- Net 120due_on_receipt- Due on Receipt
custom, net_5, net_7, net_10, net_15, net_20, net_30, net_40, net_45, net_60, net_90, net_105, net_120, due_on_receipt 9^\d{9}$Israel tax compliance: bill classification type
other- Otherequipment- Equipment
other, equipment 250partial- Partially Paidopen- Openpaid- Paidpayment_not_found- Payment Not Foundpayment_pending- Payment Pendingvoided- Voided
partial, open, paid, payment_not_found, payment_pending, voided 3-100000000000000 < x < 100000000000000-100000000000000 < x < 100000000000000inclusive- Inclusiveexclusive- Exclusive
inclusive, exclusive BILL- BillPAYROLL- PayrollREIMBURSEMENT- Reimbursement
BILL, PAYROLL, REIMBURSEMENT -2147483648 <= x <= 2147483647Payment term for this bill
Accounts Payable account for this bill
Response
Return AP account name with number in 'number - name' format, similar to name_and_number.
-1000000000000000000 < x < 1000000000000000000-1000000000000000000 < x < 1000000000000000000Navan data region (US/EU) for a Navan-sourced bill, else None.
Mirrors ramp_use_sandbox: the frontend builds the "Open in Navan" deep
link from source_id and uses this to pick the web-app host
(US -> app.navan.com, EU -> app-fra.navan.com). Navan bills carry no FK to
their connection, so the region is resolved per customer and memoized to
avoid an N+1 lookup across a bill list.
Withholding context for the bill's entity (AP side).
estimated_withholding_amount covers only the remaining amount due (null once
fully paid); withheld_to_date is the signed sum of posted withholding (AP legs
are credits, reversals debits), so actuals replace the estimate as payments post.
Certificate-based schemes estimate from the vendor certificate's rate valid today
(falling back to the scheme default).
120custom- Customnet_5- Net 5net_7- Net 7net_10- Net 10net_15- Net 15net_20- Net 20net_30- Net 30net_40- Net 40net_45- Net 45net_60- Net 60net_90- Net 90net_105- Net 105net_120- Net 120due_on_receipt- Due on Receipt
custom, net_5, net_7, net_10, net_15, net_20, net_30, net_40, net_45, net_60, net_90, net_105, net_120, due_on_receipt 9^\d{9}$Israel tax compliance: bill classification type
other- Otherequipment- Equipment
other, equipment 250partial- Partially Paidopen- Openpaid- Paidpayment_not_found- Payment Not Foundpayment_pending- Payment Pendingvoided- Voided
partial, open, paid, payment_not_found, payment_pending, voided 3-100000000000000 < x < 100000000000000-100000000000000 < x < 100000000000000inclusive- Inclusiveexclusive- Exclusive
inclusive, exclusive BILL- BillPAYROLL- PayrollREIMBURSEMENT- Reimbursement
BILL, PAYROLL, REIMBURSEMENT -2147483648 <= x <= 2147483647Payment term for this bill
Accounts Payable account for this bill