Xero Integration Errors

In this guide we will cover:

- Steps to Troubleshoot Xero Errors

Related Guides:

When configuring the Xero integration, you may sometimes see error messages when attempting to import or sync entities. This guide will cover how to troubleshoot the most common ones.

If you have any issues with Xero following this guide, please contact support for further assistance.

Error (A-Z)	Solution
Xero Sync Failed - Account code or ID must be specified.	Set the "Xero Income Account" and "Xero Expense Account" fields on the product, or the "Income Account" field on the invoice line.
Xero Sync Failed - An existing contact could not be found using the specific contact details. The contact name field is required to create a new contact.	Ensure the customer the order/invoice is against has a valid Xero ID set. Attempt to resync the customer from Xero from the integration import.
Xero Sync Failed - Failed to refresh token. Error Code: 1010. Message: Token refresh failed. Details: View logs for further information. Try reconnecting to your Xero tenant in Configuration > Integrations > Xero.	Xero refresh tokens expire after 60 days if not used. Disconnect and reconnect the integration.
Xero Sync Failed - The specified contact details matched an archived contact. Archived contacts cannot currently be edited via the API.	The customer ID in Xero does not match what is set in the "Xero Customer ID (GUID)" field in Halo. This will need to be edited to match the new ID via an API post to the customer profile in Halo.
Xero Sync Failed - The TaxType code 'X' cannot be used with account code 'X'.	Ensure the accounts code set on the item(s) on the order/invoice are compatible with the tax code used. This is set via the "Type" within Xero. For example, "OUTPUT" tax codes should match a sales account code.