Xero Export & Sync Errors
This article lists common error messages which may be returned when exporting to Xero. You can view these errors on the Accounting Sync History Page via Company Settings > Accounting Sync History.
Note: Bank Debit errors will not indicate the specific transaction within the batch that is causing the error.
Error: Token does not match an expected OAuth token
Reason:
The login token has expired or is invalid.
Solution:
Please re-connect Xero and Abacus to update the Token.
- Login to Abacus and navigate to Account & Settings
- Select the Accounting Sync page
- On the top right side click Reconnect to re-authenticate
- Enter your Xero credentials
Error: The Total for this document must be greater than zero
Reason:
Xero made changes to their system and Abacus was unable to sync negative value/refunds from a corporate card.
Solution:
Abacus updated the settings to meet the requirements for Xero.
Error: Account code XXX is not a valid code for this document
Reason:
This error message is because the 'Show in expense claims' box for the category has not been ticked in your Chart of Accounts in Xero.
Solution:
- Please login to Xero and go into your 'Settings'
- Select 'Chart of Accounts'.
- Click into each category and then tick 'Show in expense claims' box.
- Reload your categories afterward
Error: Refresh Token is out of date and must be manually reconnected
Reason:
Refresh tokens expire after 30 days if not used. Your app will need to do a refresh at least every 30 days to keep the offline connection alive.
Solution:
Please re-connect Xero and Abacus to update the Token.
- Login to Abacus and navigate to Account & Settings
- Select the Accounting Sync page
- On the top right side click Reconnect to re-authenticate
- Enter your Xero credentials