Zoho Books – Gotchas

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

The status of the bill will be "submitted" by default when creating a bill.

The allowed values for the status field are "draft", "submitted" and "void" when using the update method. Please send status updates separately from other bill updates.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

By default, the status of the bill will be set to "authorised".

Allowed values for the status are "draft", "authorised", and "voided" when using the update method. Please send status updates separately from other updates for Credit Notes.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

The status field can be updated to either "active" or "inactive". Please send status updates separately from other updates for the customer.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

Zoho Books supports only one customer and one rebilling (rebillable) flag per expense at the header level. Only provide these in the first line_item — they will be mapped to the header-level fields and applied to all lines. If differentiated treatment is required, create separate expenses.

Zoho Books supports only one customer and one rebilling (rebillable) flag per expense at the header level. When reading, all line_items will return the same customer and rebilling values.

Zoho Books supports only one customer and one rebilling (rebillable) flag per expense at the header level. Only provide these in the first line_item — they will be mapped to the header-level fields and applied to all lines. If differentiated treatment is required, create separate expenses.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

Please ensure that status updates are sent separately from other invoice item updates.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

By default, the status of the invoice will be set to "draft".

The allowed values for the status field are "draft", "submitted", and "void" when using the update method. Please ensure that status updates are sent separately from other invoice updates.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

Journal entries are returned in Zoho's internal entry-number order, newest created first — not by posting date. Zoho's own default sorts by journal_date, which has no unique tiebreaker, and paginating over it means a page boundary falling inside a group of same-dated entries silently duplicates some records and skips others. Entry number is unique per organization, so pagination over it is stable. In practice the two orders are close, because entry numbers are assigned in creation order; they diverge for back-dated entries, where an entry created today for an earlier period sorts first rather than by its posted_at.

To sort by posting date instead, pass ?pass_through[sort_column]=journal_date&pass_through[sort_order]=D — but note this reinstates the duplicate-and-skip behaviour at page boundaries, so only use it for a single page rather than when paginating a full ledger.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

current_balance on a single ledger account is sourced from Zoho's closing_balance, which differs from the list endpoint's balance in three ways: it is an absolute value (the list returns a signed balance, negative when the balance sits on the account's non-normal side), it includes future-dated transactions, and system-computed accounts (e.g. Retained Earnings) return 0. For signed, as-of-today balances across accounts, use the list endpoint (GET /accounting/ledger-accounts).

For ledger accounts, please update the "active" status separately from other updates.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

By default, the status of the purchase order will be set to "draft".

Allowed values for the status are "draft", "open", "billed" and "deleted" when using the update method. Please send status updates separately from other updates for the supplier.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.

The status field can be updated to either "active" or "inactive". Please send status updates separately from other updates for the supplier.

Zoho Books does not expose a total record count in list responses. meta.total_count will not appear.