All Collections
ERPs, integrations and accounting
Xero
Common integration errors explained - Xero
Common integration errors explained - Xero

Here we'll run through some of the most common errors our customers encounter with their Xero integration. ​

Mads avatar
Written by Mads
Updated over a week ago

Because both Xero and Corpay One deal with your company's data in customizable ways, you might occasionally come across a data mismatch that results in an integration error message. In this article we'll provide explanations of some syncing issues you might encounter, as well as steps for resolving, so you can get your data syncing smoothly again in no time. 

Experiencing an issue you don't see here? Reach out to let us know, and we'll add it to the list!

Syncing Errors

The following are examples of errors that would appear under the Integrations tab in an individual bill if it's experienced an error.

Error message: "One or more errors occurred."

  • What's going on: This is a general notification that the vendor's invoice wasn't synced correctly. It could be to a number of reasons - i.e. a duplicate in Xero, or another typo / error. 

  • How to fix: Check the integration log and see if there's an error in the invoice itself, and then try to re-sync for either/both the vendor payment or vendor invoice. If there's still error, check in Xero to make sure there's no duplicate of this invoice. 

Error message: "The UnitAmount value '0.0000' is invalid. UnitAmount must not be equal to zero.\nThe Total for this document must be greater than zero."

  • What's going on: Xero cannot accept any bill amount that is $0. 

  • How to fix: Make sure the amount on the bill is greater than 0, otherwise it cannot sync to Xero. Re-sync if it was an entry error.

Error message: "Bank Transaction not of valid status for modification."

  • What's going on: Something about the bill was modified on Xero's end, which mean it cannot be modified from Corpay One anymore (changes have been locked). 

  • How to fix: There are two options here. You can either manually make sure the changes are reflected for the bill in Xero. Alternatively, you can delete the bill from Xero and then re-sync vendor invoice / vendor payment in Corpay One as needed. 

Error message: "A validation exception occurred."

  • What's going on: One of the accounts (or categories) in Corpay One is not aligning with Xero accounts, or the bill is missing an account/category and requires one. Sometimes this occurs when one of the payment accounts in Xero is not enabled for payments. 

  • How to fix: Double check that the bill has a correct Xero category selected and re-sync.  In case of a payment account mismatch (another dropdown menu that imported from Xero), make sure that in Xero, that payment account is enabled for payments. 

Error message: "This document cannot be edited as it has a payment or credit note allocated to it."

  • What's going on: Something about the bill was modified on Xero's end, or a credit note was applied to it, which means it cannot be modified from Corpay One anymore (changes have been locked).

  • How to fix: There are two options here. You can either manually make sure the changes are reflected for the bill in Xero. Alternatively, you can delete the bill from Xero and then re-sync vendor invoice / vendor payment in Corpay One as needed. 

Error message: "The specified bank account details do not match a known bank account."

  • What's going on: The bank account you connected to your Corpay One account was deleted from Xero's end.

  • How to fix: Make sure the account that you're paying with in Corpay One matches to an enabled payment account in Xero. You can check this in your Xero account and make sure to enable the accounts that are linked in Corpay One. 

Error message: "You cannot save this transaction using an inventory account type."

  • What's going on: Incorrect category selected

  • How to fix: Make sure the category you selected is of type expense account in the category section.

Error message: "One or more errors occurred.... does not match an expected token" 

  • What's going on: Authorization for Corpay One to access Xero data has either expired or been revoked. 

  • How to fix: The user should go to the Integrations page in Corpay One and re-run the Xero integration to make sure all permissions are still granted between the two parties. 

Error message: Invoice not of valid status for modification

  • What's going on: The bill in Xero has already been approved in Xero and cannot be modified from Corpay.

  • How to fix: To successfully resync a bill that has been modified from Corpay, navigate to Xero and unapprove the bill. Once the bill is in "unapproved" status or "pending status", go back to Corpay and manually resync the bill. This will bring over any changes made in Corpay.

Did this answer your question?