Zoho Books limits and reduced data reads
Information about Zoho Books API rate limits and when Codat reads reduced datasets.
To minimize the performance impact of the rate limits described below, by default Codat reads a reduced dataset from Zoho Books for some data types.
The following table summarizes the fields which are excluded when reading reduced datasets from Zoho Books.
| Data type read | Fields excluded |
|---|---|
| Bills |
If reading complete datasets, the following fields on bill line items are always populated as 0.00 in Codat:
|
| Credit Notes | Line items |
| Customers | Address and contact information |
| Invoices | Line items |
To remove these restrictions and read complete datasets for the supported Zoho Books data types, please raise a ticket through our support request form. After removing the restrictions, fetching large volumes of data from the above data types can take multiple days to complete.
Zoho Books doesn't support retrieving the totalTaxAmount for an invoice. As a result, when line items are excluded from invoices, Codat can't calculate the total tax due, and shows the totalTaxAmount as 0.00.
Zoho Books rate limits
The Zoho Books APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. has the following connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform. limits and rate limits:
- APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. daily rate limit
- Per-minute rate limit
- Concurrent rate limit
- Refresh token limit
Our Zoho Books integration works within these limits to minimize the performance impact of reading and writing large volumes of data. To do so, the integration maximises the number of records retrieved per APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. call for most data types. However, for certain data types, the integration can only fetch a single record for each APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. call to Zoho Books, impacting performance. This also applies to additional data types where the restrictions on reading reduced datasets described above are removed.
APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. daily rate limit
The APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. daily rate limit lets organizations make a limited number of APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. calls to Zoho Books per day. The limit varies based on the plan your organization uses (see Zoho Books' API Call Limit).
If the cumulative number of APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. calls to the organization you are trying to linkLink The authorization flow that allows end users to connect their accounting, banking, or commerce platforms to your application via Codat. to exceeds the daily limit, you might encounter the following issues:
- Queued data fetches: these are included in the next day's limit.
- Failed data fetches: these are indicated in Codat as fetch errors.
The daily rate is shared between all APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. requests made to an organization from all users, and any service providers, such as Codat, that can access data through the Zoho Books APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms..
Per-minute rate limit
Zoho Books usesrs can make about 100 APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. calls per minute for each organization — the per-minute rate limit.
This rate limit can affect the performance of the integration when reading data from and writing to Zoho Books.
Concurrent rate limit
Zoho Books also limits the maximum number of APIAPI A set of rules and protocols that allows different software applications to communicate with each other. Codat provides APIs for accessing financial data from accounting, banking, and commerce platforms. calls that can be simultaneously active for the same organization using its concurrent rate limit.
The concurrent rate limit varies based on the plan of the organization and is noted in Zoho Books' Concurrent Rate Limiter.
Refresh token limit
The refresh token limit applies to each user.
You can connect a Zoho Books organization to one or more Codat companies a maximum of 20 times.
The refresh token limit applies to the following actions in Codat:
- Linking new companies.
- Re-linking existing companies.
After 21 connectionsConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform., the refresh token of the initially linked companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. (that is, the oldest connectionConnection A link between a Codat company and a data source (like an accounting platform). Each connection represents authorized access to pull or push data from that platform.) is set to invalid. Any syncsSync The process of fetching the latest data from a connected data source. Syncs can be triggered manually or run automatically on a schedule. from this companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. will fail until the companyCompany In Codat, a company represents your customer's business entity. Companies can have multiple connections to different data sources. is re-linked.