Zoho Books Connector
Status: In development: its code is written and tested on its own, but it does not work end to end on the platform yet. It cannot be installed.
| Kind | Version | Publisher | Licence |
|---|---|---|---|
| Connector | 1.1.0 | ZAITRACK | Apache-2.0 |
What it does
Posts the platform's own records to the organisation's Zoho Books, in its own Zoho data centre (including Saudi Arabia and the UAE): a completed work order as a bill or an expense on the account its cost centre is mapped to, a partner's invoices and credit notes as Zoho invoices and credit notes. Each record is sent once (Zoho's reference_number), within Zoho's request limits, and its outcome is kept. It also reads the invoices modified since the last read, every 30 minutes (optional). Through an OAuth 2.0 client's refresh token. In development until a live Zoho Books organisation proves it.
- Regions: IN, AE, US, EU
- Capabilities:
integration.erp.sync.fact.invoice,integration.erp.write_back,integration.erp.post.bill,integration.erp.post.invoice
How to use it
Not yet: see its status above.
Configuration
| Setting | Type | Required | Allowed values and default |
|---|---|---|---|
zoho_dc | string | yes | one of com, eu, in, com.au, jp, ca, com.cn, sa, ae; Where the Zoho account is: com (US), eu, in, com.au, jp, ca, com.cn, sa (Saudi Arabia), ae (UAE) |
zoho_org_id | string | yes | Zoho Books → Settings → Organisation profile |
zoho_paid_through_account_id | string | no | The Zoho account an expense posted from the platform is paid from (Settings, Chart of accounts; the id is in the account's URL); needed only for expenses |
zoho_sync_invoices | string | no | one of true, false; default "true"; Read the organisation's invoices every 30 minutes (needs the scope ZohoBooks.invoices.READ); false when the connector only posts |
zoho_calls_per_minute | string | no | The most Books calls this connector makes in a minute (Zoho allows 100 per organisation; default 90) |
zoho_calls_per_day | string | no | The most Books calls it makes in a UTC day (Zoho allows 1,000 on Free, 2,000 Standard, 5,000 Professional, 10,000 above; default 1,000) |
Credentials
Each is a secret setting of the installation: kept sealed (OpenBao in production), never shown again; Adapter Studio shows it as set.
zoho_client_idzoho_client_secretzoho_refresh_token
Limits
- Memory: 256 MB
- Time per call: 30,000 ms
- Largest message: 1,048,576 bytes
- Calls at once: 16
- Network: only
www.zohoapis.com,accounts.zoho.com,www.zohoapis.eu,accounts.zoho.eu,www.zohoapis.in,accounts.zoho.in,www.zohoapis.com.au,accounts.zoho.com.au,www.zohoapis.jp,accounts.zoho.jp,www.zohoapis.ca,accounts.zohocloud.ca,www.zohoapis.com.cn,accounts.zoho.com.cn,www.zohoapis.sa,accounts.zoho.sa,www.zohoapis.ae,accounts.zoho.ae
Troubleshooting
- Credentials refused. The secret settings must be the ones the provider issued for this account and environment (sandbox or live); give them again in Adapter Studio, since they are never shown back.
- Rate limited. The provider's limit applies to the account: calls are retried with a growing pause; spread scheduled work or ask the provider for a higher limit.
- Nothing is sent or synced. The installation must be active, its version approved; it reaches only the hosts listed under Limits.
- Webhooks rejected. The webhook secret must match the one configured at the provider; a request whose signature does not match is refused.
Source
adapters/connectors/zoho-books