The Bill Imports object

A bill import represents an outstanding-bills CSV processed in the payables direction. It is structurally identical to an invoice import with the accounting direction reversed.

Attributes

idstring

Prefixed identifier. Always starts with dimp_.

filenamestring

Original filename of the uploaded CSV.

directionstring

Always payable for bill imports.

cutoverDatestring

Inherited from the opening balance journal date.

statusstring

Import lifecycle: pending, completed, or voided.

engineVersionstring

The import engine version used for this import.

createdAtstring

ISO 8601 timestamp when the import was uploaded.

completedAtstring

ISO 8601 timestamp when the import was confirmed, or null if pending.

rowsstring

Array of parsed bill rows with supplier contact resolution outcomes.

clearingProofstring

Clearing zero-sum validation: opening balance plus import delta must equal zero.

canConfirmstring

Whether the import passes all gates: clearing zero-sum, contact resolution, at least one valid row, no errors.

errorsstring

Array of error strings preventing confirmation.

warningsstring

Array of parse-level warnings (for example ignored columns, date format ambiguity).

The Bill Imports Objectjson

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