IQ Books — Invoices

Create a sales invoice

Creates a sales invoice. By default the invoice is issued, posting the AR + VAT-control double-entry journal via the native validated path. Pass issue: false to leave it as a draft. document_type: 'quote' is never auto-issued. Requires scope iqbooks:write. Requires a vat_control-role account to exist in the organisation when the posting carries VAT; otherwise 422 unprocessable_entity ("VAT Control account is required ...").

post/api/v1/iqbooks/organisations/{organisationId}/sales-invoices

Request

  • Base URL: https://api.reconcileiq.com
  • URL: https://api.reconcileiq.com/api/v1/iqbooks/organisations/{organisationId}/sales-invoices
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Path parameters

organisationIdinteger required

IQ Books organisation id. The caller must be an accepted member; otherwise 404 (no existence leak).

Request body

contact_idinteger required

Customer id (sales) or supplier id (purchase).

invoice_numberstring
invoice_datestring date
due_datestring date
currencystring
descriptionstring
document_type'invoice' | 'credit_note' | 'quote'
issueboolean

Default true (posts the journal). false leaves a draft. Ignored (never issued) for quotes.

Response

A single invoice (with lines).

Changes

No recorded changes to this operation across all 1 revision of this API.