IQ Books — Invoices

Create a purchase invoice

Creates a purchase invoice. Issued by default (posts the AP + VAT-control journal). Pass issue: false for a draft. 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}/purchase-invoices

Request

  • Base URL: https://api.reconcileiq.com
  • URL: https://api.reconcileiq.com/api/v1/iqbooks/organisations/{organisationId}/purchase-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.