Bill Imports

Import outstanding purchase bills from CSV. Bills are imported in the payables direction, the mirror of invoice (receivables) imports: the same import engine runs against the payables clearing account instead of the receivables one.

Precondition gates (the same as invoice imports):

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

On confirm, the engine creates the migrated bills, posts the contra-wash clearing entries that move each bill onto the payables ledger, and records the payment already made against any partially paid bill. 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 Bill Imports object

Endpoints

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

Endpoints

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

The Bill Imports Objectjson

{
  "id": "dimp_4",
  "filename": "outstanding-bills.csv",
  "direction": "payable",
  "cutoverDate": "2026-02-28",
  "canConfirm": true
}