Create Purchase Invoice
POST/api/purchase-invoices
Create a new purchase invoice linked to a purchase order.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Either purchase_invoice_lines or financial_lines must be provided on creation. Invoice lines must belong to the specified purchase order and must not be fully invoiced.
When financial_lines are provided, each entry requires: id (an existing financial_lines.id), quantity (numeric), and amount (numeric). A 422 is returned if any are missing.
Invoice line quantity: each purchase_invoice_lines[].quantity_invoiced must be at least 1 and less than 10,000,000 (the same per-line ceiling as a purchase order line). Larger values return 422 with "Quantity is too large (Index #n)."
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.