Skip to main content

Create Bill

POST 
/api/bills

Creates a standalone bill. Note: This endpoint is currently not used in practice — bills are typically created via purchase order or warehouse transfer nested routes.

Authentication: Requires Bearer token.

Fields:

  • vendor_id (required): ID of the vendor
  • invoice_number (required, unique): Invoice reference number
  • invoice_date (required): Invoice date (YYYY-MM-DD)
  • link_type (required): Type of link — 'purchase_order' or 'warehouse_transfer'
  • link_id (required): ID of the linked record
  • currency_id (optional): Currency ID
  • currency_rate (optional): Exchange rate
  • proration_strategy (required): One of cost_based, quantity_based, manual
  • lines (required): Array of bill lines
    • lines.*.description: Line description
    • lines.*.quantity: Quantity
    • lines.*.amount: Unit amount
    • lines.*.nominal_code_id: Nominal code ID
    • lines.*.tax_rate_id: Tax rate ID (optional)
  • allocations (optional): Array of allocation objects
    • allocations.*.purchase_order_line_id: PO line ID
    • allocations.*.allocation_amount: Amount to allocate

Request​

Responses​

Successful response