Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

My invoices are missing in Zoho Books or the sync keeps failing

Short answer

The Zoho Books API needs an organization ID on every request, works on one data centre domain, and limits calls per minute, per day and at the same time. Break any of these and invoices are refused with a 429 or an error. Work out which one before re-sending anything, or you may create duplicates.

  • Written for business owners
  • Updated
  • By Maaz Zindani, Senior Software Engineer

Does this sound like your situation?

  • Invoices created in my app never appear in Zoho Books.
  • Some invoices arrive and then the sync stops.
  • The log shows 429 or too many requests.
  • The sync worked, then failed after I moved my Zoho account or added another organization.
  • I am afraid re-sending will create double invoices.

Why does this happen?

  1. The per-minute and daily limits were reached

    Zoho Books states a limit per organization per minute, with a 429 response, and a daily limit that depends on your plan, with its own 429 code. A catch-up that sends a backlog at once reaches the per-minute limit fast.

  2. Too many calls at the same time

    Zoho Books also limits simultaneous calls, with a lower number on free plans, and answers with a 429 and its own code when it is exceeded. A sync that runs several workers in parallel meets this limit first.

  3. The wrong organization ID

    Every request must include an organization_id. If your business has more than one organization, or the ID was copied from another account, invoices go to the wrong place or are refused.

  4. The wrong data centre domain

    Zoho Books runs on several data centre domains, such as .com, .eu, .in and .com.au. The API address must use the domain of the account's own web address, otherwise requests fail even though the credentials are right.

  5. The authorisation lapsed or lacks a scope

    Zoho Books calls carry an OAuth token in the Authorization header. If the authorisation was revoked, the user who gave it was removed or the token no longer covers invoices, calls fail until someone authorises again.

What can I do about it today?

  1. Do not re-send invoices yetIf a failed call actually created the invoice, sending it again makes a duplicate on a document your customer and your accountant will see.
  2. Compare one invoice on both sidesPick one missing invoice and write down its number, date and amount in your app, then search for it in Zoho Books.
  3. Check the Zoho web addressNote whether it ends in .com, .eu, .in or another domain, and send that to your developer.
  4. Count how many invoices are missingNote the first and last invoice number in the gap.
  5. Tell your accountantMissing invoices change the figures for the period, and they should know before they close it.

When should I bring someone in?

  • Customers have been invoiced in your app but the books do not show it.
  • You have already re-sent some and now see duplicates.
  • More than one tool writes into the same Zoho Books organization.

How do I handle it?

  1. Match the invoices both waysI compare invoice numbers in your app with those in Zoho Books, to list what is missing and what is doubled.
  2. Read Zoho's current API rulesI check the limits, the organization ID, the data centre domain and the scopes against Zoho's documentation.
  3. Make sending safe to repeatEach invoice carries a reference that is checked before it is created, so a retry never makes a second one.
  4. Pace the backlog and reportThe missing invoices are sent through a queue within the limits, and you get a list of what was sent, what failed and why.

The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.

What do owners ask about this?

Will duplicate invoices be made when I re-send?

They can be, if the first attempt actually created the invoice. A check against the invoice reference before creating avoids it.

Why does it say 429?

Zoho Books uses 429 for its per-minute, daily and simultaneous-call limits, each with its own code, so the code tells which limit was hit.

Is this a tax or accounting question?

No. I look at how the data moves. Ask your accountant how the missing invoices should be treated.

Sources

How was this page made?

I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.

For your developer: the technical fixes

Next step

Want this off your desk?

Send me a few lines on where things stand. I reply within 24 hours.