Maaz Zindani

Loading the index…

↑↓ move↵ openesc close4072 pages

Help for owners

Invoices from my app are not showing up in Xero

Short answer

Invoices fail to reach Xero when the app lost its authorisation, sent too many calls, sent a record Xero refused, or is connected to a Xero plan without invoicing. Find the first invoice that is missing and the error behind it before re-sending anything.

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

Does this sound like your situation?

  • Invoices created in my app are not in Xero.
  • Some arrive and others do not, with no obvious pattern.
  • The app says it synced, but Xero has nothing.
  • A big batch partly went through and then stopped.
  • It stopped on a date and has not worked since.

Why does this happen?

  1. The app is no longer authorised

    Xero states that access tokens expire after 30 minutes, unused refresh tokens expire after 60 days, and that when you refresh you should replace the old refresh token with the new one. An app that does not save the new token, or has been idle too long, is locked out.

  2. It exceeded Xero's call limits

    Per connection Xero allows 5 calls in progress, 60 calls a minute and 5000 calls a day, and returns HTTP 429 with a Retry-After header saying how long to wait. Sending each invoice as its own call fills that allowance quickly. Xero says several invoices can be created in a single call.

  3. The connected organisation has no invoicing

    Xero notes that its Cashbook and Ledger plans exclude features such as invoicing but can still be connected to through the API. The connection works while invoices have nowhere to go.

  4. Xero refused the invoice

    A missing contact, an account code that does not exist, a tax rate that does not match, or a locked period can all cause refusal. Xero states that if a tax rate is not sent, the only default it uses is the tax rate from the account code, so the app must send what it means.

  5. The app logged success without checking

    A sync that treats any reply as success, and ignores per-invoice errors inside a batch, tells you it worked while some invoices were refused.

What can I do about it today?

  1. Find the first invoice that is missingNote its number and date, and the last one that did arrive.
  2. Check the Xero organisation's planAsk whoever owns the Xero subscription whether it includes invoicing.
  3. Do not re-create the invoices by hand yetThey may be sent later by a repair and double up, and invoice numbers must stay in order.
  4. Look for an error message in the appTake screenshots of any failed, retry or authorise again notices.
  5. Tell your developer what changedA password change, a user who left Xero, a plan change, new tax rates or a new account code.

When should I bring someone in?

  • The unsent invoices are for customers waiting to pay.
  • Invoice numbering must stay in sequence for filing.
  • The app is custom and no one remembers how it connects to Xero.

How do I handle it?

  1. Read the first failureI read the vendor's current documentation first, and every change is tried on test data before it touches your real books. I follow the logs from the last invoice that arrived to the first that did not, and read Xero's reply for it.
  2. Fix the causeThe login is renewed and stored correctly, calls are grouped and paced against Xero's limits, and refusals are mapped and reported per invoice.
  3. Send what is missing, onceMissing invoices go in a controlled run that keeps your numbering and checks each reference first, so none is created twice.
  4. Show failuresA failed invoice appears on a list you can read, and unusual silence raises a message.

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?

Why does it say success but Xero has no invoice?

Often a batch reply was treated as success while individual invoices inside it were refused. Each one has to be checked.

Can I send all missing invoices at once?

Xero lets many invoices be created in one call, but it limits calls and request size, so large catch-ups are sent in groups.

Is it the Xero plan?

Sometimes. Xero says Cashbook and Ledger plans exclude features like invoicing, so check the plan.

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.