The Opening Balances object

An opening balance import represents a trial balance CSV processed through the OBCE engine. Each import tracks parsed rows, account mappings, balance proof results, and the final committed journal.

Attributes

id string
Prefixed identifier. Always starts with dimp_.
filename string
Original filename of the uploaded CSV.
totalRows string
Total data rows parsed from the CSV.
status string
Import lifecycle: pending, completed, or voided.
engineVersion string
OBCE engine version used for this import.
createdAt string
ISO 8601 timestamp when the import was uploaded.
completedAt string
ISO 8601 timestamp when the import was confirmed, or null if pending.
cutoverDate string
The date for the opening balance journal (defaults to last day of previous month).
openingBalanceMode string
Either direct (standard) or clearing (enables outstanding doc imports).
canConfirm string
Whether the import passes all gates: balance proof, mapping completeness, singleton check.
mappings string
Array of account mapping objects with 5-tier resolution results.
lines string
Array of preview journal lines (one per mapped account).
balanceProof string
Balance equation validation: total debits must equal total credits.
unmapped string
Array of source labels that could not be auto-mapped to chart of accounts.
errors string
Array of error strings preventing confirmation.