CLIBooks
Books
25 `hanzo` commands for Books, each calling one operation on api.hanzo.ai.
Package books is double-entry accounting: chart of accounts, ledger, bank reconciliation, and the reports that prove the books balance.
25 commands · API reference →
| Command | Calls | What it does |
|---|---|---|
hanzo books accounts | GET /v1/books/accounts | Returns the org's chart of accounts — the seeded fixed chart every posting key in the ledger refers to. |
hanzo books ask | POST /v1/books/ask | Answers a plain-language question about the caller's own books — "what is my MRR?", "how long is my runway?" — with… |
hanzo books bank exchange | POST /v1/books/bank/exchange | Finish connecting a bank account (not yet available) |
hanzo books bank import | POST /v1/books/bank/import | Import a bank statement file into your books |
hanzo books bank sync | POST /v1/books/bank/sync | Pulls every connected bank (Plaid/Teller) for the caller's org, maps each fetched transaction to a posting and books it… |
hanzo books bank token | POST /v1/books/bank/token | Begin connecting a bank account (not yet available) |
hanzo books bank transactions | GET /v1/books/bank/transactions | Returns the org's normalized bank transactions, newest first — every row the import and connector paths have ingested,… |
hanzo books bank unreconciled | GET /v1/books/bank/unreconciled | Returns the org's unmatched bank inflows and their open clarifying questions — the queue a human answers so an… |
hanzo books export | GET /v1/books/export | Returns the complete financial package for the caller's org over (from, to]: the trial balance, the P&L, the balance… |
hanzo books gl | GET /v1/books/gl | ListGL returns the org's most recent GL Entry rows, newest first. |
hanzo books inbox get | GET /v1/books/inbox | Returns the org's open document queue — everything uploaded but not yet booked, newest first, each with its extracted… |
hanzo books inbox create | POST /v1/books/inbox | Queue a document for later scanning |
hanzo books metrics | GET /v1/books/metrics | Metrics returns the org's deterministic SaaS-metrics snapshot over an optional (from, to] window — MRR, ARR, revenue,… |
hanzo books pnl | GET /v1/books/pnl | Returns the org's accrual-basis Profit & Loss over an optional (from, to] window of RFC3339 posting times: recognized… |
hanzo books position | GET /v1/books/position | Returns the org's Balance Sheet as of to (empty = all time), with the Assets == Liabilities + Equity equation proof. |
hanzo books questions | GET /v1/books/questions | Returns the clarifying questions the caller's own recent GL raises — the unusual postings a founder should look at… |
hanzo books rules get | GET /v1/books/rules | Returns the org's auto-categorization rules, highest priority first. |
hanzo books rules create | POST /v1/books/rules | Creates or updates one auto-categorization rule, keyed by its pattern — writing a pattern that already exists REPLACES… |
hanzo books scan book | POST /v1/books/scan/book | Posts a reviewed scanned bill to the ledger. |
hanzo books scan create | POST /v1/books/scan | Scan a receipt or invoice into a proposed voucher |
hanzo books sync | POST /v1/books/sync | Sync ingests the caller's OWN org from commerce into BOTH ledgers (live and sandbox) and reports how many new vouchers… |
hanzo books transactions | GET /v1/books/transactions | Returns the org's booked ledger as a single-line register, newest first: one row per voucher, with its date,… |
hanzo books trial | GET /v1/books/trial | Returns the org's trial balance over an optional [from, to] window of RFC3339 posting times, including the… |
hanzo books vendors get | GET /v1/books/vendors | Returns the org's vendor book: each canonical vendor, the alias spellings a receipt may print it under, and the expense… |
hanzo books vendors create | POST /v1/books/vendors | Creates or updates one vendor in the org's vendor book, keyed by its canonical name — writing a canonical name that… |
How is this guide?