Learn how to resolve errors when processing documents to Xero.
Common Integration Errors
In the event you receive an error in the Zudello - Xero integration, your document will be listed under the Unable to Process status.
With each document, you should receive an error message, alerting you to the reason the document failed to integrate. The common error messages and the actions to resolve them are listed below.
In the event your error is not detailed below, please contact support@zudello.com.
Table of Errors and Actions
Error |
Action |
Error: Invoice not in a valid status for modification.
|
The document has already been created in Xero and cannot be modified.
Check Xero for the related document, be sure to check archived bills while searching. If in Xero, archive the document in Zudello.
If the document is not in Xero, amend the document number so it is unique to Xero and choose Save and Approve to re-process it. |
Error: this document cannot be edited as it has a payment or credit note allocated to it.
|
The document has already been created in Xero with payment and cannot be modified.
Search for the document in Xero. Once found, archive the document in Zudello. |
Unknown Error
|
Your Zudello account is disconnected from Xero.
You should see a disconnected Plug icon in the top right corner. |
Error: The document cannot be edited as it is currently dated before the end of the year lock date
|
The document date is older than your lock out date.
Modify the document date in Zudello so it is current and choose Save and Approve to re-process it. |
Error: The contact with the specified contact details has been archived. The contact must be un-archived before creating new invoices or credits.
|
The contact for the document has been archived in Xero.
Unarchive the contact in Xero. In Zudello choose Save and Approve to reprocess the document to Xero. |
Error: The line total 75600.99 does not match the expected line total 75634.98
|
The line total is incorrect. Check the line totals on the document in Zudello.
Amend the line with the issue identified. Make sure the unit price times the quantity equals the document total.
Choose Save and Approve to re-process the document. |
Error: Account code or ID must be specified
|
An account has not been added to a line in Zudello.
Add the code to the line/s. Choose Save and Approve to re-process the document. |
Error: Account must be valid. |
An account has been selected which is not in Xero.
Select the correct code and apply to the lines. Choose Save and Approve to re-process the document. |
Error: Tax rate must be valid. |
A tax rate has been selected which is not in Xero.
Select the correct tax rate to the lines and choose Save and Approve to re-process the document. |
Error: The quantity value '-1.0000' is invalid. Quantity must not be less than zero
|
Xero does not take negative quantities.
If you are processing a credit, ensure the document type is Credit. Change all the values to positive - quantities and prices.
If you are processing a credit line on an expense or invoice, change the quantity to positive and the prices to negative.
Save and approve the document to re-process it to Zudello |
Error: Inventory Item Name must not be more than than 50 characters long.
|
In the event you are creating an Item in Xero from the document, Zudello complies with Xero’s character limit for the item description and code.
An item in Xero can only have 50 characters.
As a result the item you are trying to create is more than 50 characters long and must be shortened.
Find the description of the item in the line, amend the length and choose Save and Approve to reprocess the document to Xero. |
Error: Unable to Evaluate Product Lines |
The document does not have any lines.
Add at least one line item to the document and choose Save and Approve to reprocess it to Xero. |