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
To update the selected Xero account in your service settings, follow these steps:
1. Go to Settings.
2. Click on Services.
3. Locate the service related to the invoice with the Xero error and click the Actions button (the three dots).
4. Click Edit.
5. Scroll down to the Xero invoice account field. You can either update this field with a valid revenue account or leave it empty. If you leave it empty, the default account for invoice items selected in your Xero Integration settings will be used (Settings > Integrations > Xero settings).
6. If you are adding Products, make sure to select a revenue account for each product under the Products tab.
Ensure that all accounts selected are valid to avoid any integration errors.
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.