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 this week

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, them, 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 due to several 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 or both the vendor payment or vendor invoice. If there's still an 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 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 the 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 is 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 the 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 within 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.

Error message: Oops! Payment creation for expenses hit a snag. Possible reasons include your account being in trial mode, a hiccup in vendor creation, or incorrect bill fields.

  • What's going on:

    • Trial Account Limitation: Your account is currently in trial mode, and as a result, you are unable to approve any additional expenses. To proceed, consider upgrading your account or contact support for further assistance.

    • Vendor Creation Conflict: There is an issue creating the vendor for the bill. It appears that the vendor's name is already in use in Xero as a customer. Please ensure that the vendor's name is unique or check existing customer records to prevent conflicts.

    • Field Validation Error: The approval process has encountered errors due to incorrect fields on the bill, please double-check all fields on the bill and ensure they are accurate and not populated with data from any previous ERP integration.

  • How to fix: Find the scenario corresponding to the error message, resolve the issue, and synchronize the bill to Xero again.

Did this answer your question?