All Collections
Integrations
Xero
Why an invoice fails to sync with Xero and how to fix it
Why an invoice fails to sync with Xero and how to fix it

Errors that occur will be displayed in the Xero status card in your invoices.

Updated over a week ago

Common Xero error messages include:

  • You have reached the limit of invoices you can approve

  • Xero connection has expired

  • The document date cannot be before the period/end of year lock date

  • The document cannot be edited as it has a payment or credit note allocated to it

  • Invoice number must be unique

  • Account code not valid


You have reached the limit of invoices you can approve

Error

An invoice fails to sync because you have reached the limit of invoices you can approve.

How to fix it

This error occurs when your Xero plan has a limit on invoices. You are able to fix this by upgrading your Xero plan.


Xero connection has expired

Error

An invoice fails because the connection to Xero has expired or your organisation is on Cashbook and Ledger plan.

How to fix it

If your Xero account gets disconnected in Xero or in Splose, you will need to go back to settings. If your organisation is on Cashbook and Ledger plan, please upgrade your plan or contact your accountant or bookkeeper.


The document date cannot be before the period lock date

Error

This means your accounts (in your organisation’s chart of accounts) or system accounts (set by Xero) are locked in Xero.

How to fix it

Accounts are typically set up by your accountant, so it's worth double-checking with them. Otherwise, you can remove the lock dates. Then click Retry on failed invoices.


The document date cannot be before the end of year lock date

Error

The lock date is set before the end of year lock date and Xero will not allow you to add or edit any invoices in Xero earlier than the lock date.

How to fix it

Change or remove the lock date in Xero and then retry syncing your invoices in Splose, or change the invoice date in Splose. Read more on the Xero help site.


This document cannot be edited as it has a payment or credit note allocated to it

Error

This error occurs when an invoice has already been paid or partially paid in Xero, and you then edit the invoice in Splose.

How to fix it

Update the invoice in Xero or delete the invoices in Splose and Xero and record the payment correctly during the first attempt.


Invoice number must be unique

Error

This error occurs when you try to create an invoice where an invoice with the same number already exists in Xero.

How to fix it

Edit the invoice in Xero and change the invoice Reference number and Invoice number to something random and unique, for example, if the invoice is INV-0002, change both the Reference number and Invoice number in Xero to INV-XXX2. Then, delete this invoice in Xero. Go back to Splose, and Retry syncing. This will successfully create the new invoice in Xero.


Account code not valid

Error

This error occurs because the selected account for the service in the invoice is not a valid revenue account.

How to fix it

Update the selected Xero account in your service settings by going to Settings, then Services and click the Actions button (three dots) for the service in the invoice with the Xero error.

After clicking Edit, scroll down to the Xero invoice account field and either update it to a valid revenue account or leave it empty. Leaving it empty will choose the default account for invoice items selected in your Xero Integration settings.


Having trouble finding the invoice number in Xero?

The invoice in Xero may be voided or deleted. To check, go to Business, then Invoices and click the search button.

Select the include deleted & voided checkbox and click search.

You will see any voided and deleted invoices here.


📝 Want to learn more about our Xero integration? Visit our Xero integration page.

Did this answer your question?