# Books URL: https://docs.hanzo.ai/docs/cli/books > The `hanzo books` commands. Also for this capability: [API](https://docs.hanzo.ai/docs/openapi/books) · **CLI** · [SDKs](https://docs.hanzo.ai/docs/sdks) Double-entry accounting: chart of accounts, ledger, bank reconciliation, and the reports that prove the books balance. [API reference →](https://docs.hanzo.ai/docs/openapi/books) ```bash 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. |