Books

The hanzo books commands.

Also for this capability: API · CLI · SDKs

Double-entry accounting: chart of accounts, ledger, bank reconciliation, and the reports that prove the books balance.

hanzo books gl

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

Command	What it does
`hanzo books accounts`	Returns the org's chart of accounts — the seeded fixed chart every posting key in the ledger refers to.
`hanzo books ask`	Answers a plain-language question about the caller's own books — "what is my MRR?", "how long is my runway?" — with figures taken from their ledger, never a guessed number.
`hanzo books export`	Returns the complete financial package for the caller's org over (from, to]: the trial balance, the P&L, the balance sheet, and the GL detail behind them — the four statements a tax preparer or an investor asks for, assembled from the one ledger in a single read so they cannot disagree with each other.
`hanzo books gl`	Returns the org's most recent GL Entry rows, newest first.
`hanzo books metrics`	Returns the org's deterministic SaaS-metrics snapshot over an optional (from, to] window — MRR, ARR, revenue, COGS, burn, gross margin, net income, cash, deferred revenue, monthly burn and runway — as raw int64-cent figures AND the same figures already formatted.
`hanzo books pnl`	Returns the org's accrual-basis Profit & Loss over an optional (from, to] window of RFC3339 posting times: recognized revenue, matched cost, and the net.
`hanzo books position`	Returns the org's Balance Sheet as of `to` (empty = all time), with the Assets == Liabilities + Equity equation proof.
`hanzo books questions`	Returns the clarifying questions the caller's own recent GL raises — the unusual postings a founder should look at (outliers, reversals, round-offs, uncosted revenue, an overdrawn wallet), sharpest first.
`hanzo books sync`	Ingests the caller's OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers posted to each.
`hanzo books transactions`	Returns the org's booked ledger as a single-line register, newest first: one row per voucher, with its date, description, vendor, category, source and amount in exact cents.
`hanzo books trial`	Returns the org's trial balance over an optional [from, to] window of RFC3339 posting times, including the opening/closing columns and the TotalDebit == TotalCredit proof that the books balance.

Bank

Command	What it does
`hanzo books bank import`	Import a bank statement file into your books
`hanzo books bank sync`	Pulls every connected bank (Plaid/Teller) for the caller's org, maps each fetched transaction to a posting and books it idempotently, then advances that connector's cursor so the next sync resumes where this one stopped.
`hanzo books bank transactions`	Returns the org's normalized bank transactions, newest first — every row the import and connector paths have ingested, with its amount in exact cents, its direction, and whether it has been matched to a voucher yet.
`hanzo books bank unreconciled`	Returns the org's unmatched bank inflows and their open clarifying questions — the queue a human answers so an unexplained deposit is never guessed into revenue.

Inbox

Command	What it does
`hanzo books inbox create`	Queue a document for later scanning
`hanzo books inbox get`	Returns the org's open document queue — everything uploaded but not yet booked, newest first, each with its extracted summary and the confidence the scanner resolved its category at.

Rules

Command	What it does
`hanzo books rules create`	Creates or updates one auto-categorization rule, keyed by its pattern — writing a pattern that already exists REPLACES that row's category and priority.
`hanzo books rules get`	Returns the org's auto-categorization rules, highest priority first.

Scan

Command	What it does
`hanzo books scan book`	Posts a reviewed scanned bill to the ledger.
`hanzo books scan create`	Scan a receipt or invoice into a proposed voucher

Vendors

Command	What it does
`hanzo books vendors create`	Creates or updates one vendor in the org's vendor book, keyed by its canonical name — writing a canonical name that already exists REPLACES that row's aliases and default category.
`hanzo books vendors get`	Returns the org's vendor book: each canonical vendor, the alias spellings a receipt may print it under, and the expense account new bills from it default to.

Was this page useful?

PreviousMarketplace NextCaptable