Zoho Books – Gotchas

Service ID: zoho-books

Zoho Books is cloud-based accounting software in which you can record, audit and analyze all financial transactions easily. With secure data storage, easy navigation and customizable features, Zoho Books provide a head start in accounting for small businesses.

⚠️

15 gotchas across 9 resources

These are connector-specific behaviors and limitations to be aware of when integrating.

Bills2 gotchas

addbillsAdd

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

updatebillsUpdate

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.

Credit Notes2 gotchas

addcreditNotesAdd

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

updatecreditNotesUpdate

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.

Customers1 gotcha

updatecustomersUpdate

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

Expenses3 gotchas

addexpensesAdd

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.

oneexpensesOne

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.

updateexpensesUpdate

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.

updateinvoiceItemsUpdate

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

Invoices2 gotchas

addinvoicesAdd

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

updateinvoicesUpdate

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.

updateledgerAccountsUpdate

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

addpurchaseOrdersAdd

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

updatepurchaseOrdersUpdate

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.

Suppliers1 gotcha

updatesuppliersUpdate

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