Invoice Imports

Import outstanding sales invoices from CSV. Invoices are imported in the receivables direction, the mirror of bill (payables) imports: the same import engine runs against the receivables clearing account instead of the payables one.

Precondition gates (the same as bill imports):

Opening balances must already be imported.
Those opening balances must be in Clearing Mode (not Direct).
The Cash VAT scheme is not supported (CASH_VAT_UNSUPPORTED).

On confirm, the engine creates the migrated invoices, posts the contra-wash clearing entries that move each invoice onto the receivables ledger, and records the payment already received against any partially paid invoice. The clearing account must net to zero (opening balance plus import delta), and this is verified at commit; if it does not net to zero the whole confirm is rolled back.

All monetary values in API responses are formatted as pounds (for example "1500.00"). Internal storage uses pence.

→ The Invoice Imports object

Endpoints

POSThttps://app.speybooks.com/api/v1/invoice-imports/uploadUpload invoices file GEThttps://app.speybooks.com/api/v1/invoice-imports/{id}Get invoice import details DELETEhttps://app.speybooks.com/api/v1/invoice-imports/{id}Delete an invoice import POSThttps://app.speybooks.com/api/v1/invoice-imports/{id}/confirmConfirm invoice import POSThttps://app.speybooks.com/api/v1/invoice-imports/{id}/voidVoid invoice import

Endpoints

POST/v1/invoice-imports/upload GET/v1/invoice-imports/{id}DELETE/v1/invoice-imports/{id}POST/v1/invoice-imports/{id}/confirm POST/v1/invoice-imports/{id}/void

The Invoice Imports Objectjson

{
  "id": "dimp_3",
  "filename": "outstanding-invoices.csv",
  "direction": "receivable",
  "cutoverDate": "2026-02-28",
  "canConfirm": true
}