Why am I receiving an error message when trying to copy my documents to Xero?
In order for the Xero integration to work properly, you must have completed the initial setup and ensured your Invoice2go and Xero taxes and currencies match. If these do not match, you may experience an error. Once your accounts have been successfully linked, you should be able to navigate to Settings > Connected Apps in Xero and see Invoice2go listed.
You can manually unlink your Xero account from Invoice2go by navigating to Account & settings > Xero and choosing Unlink Xero from the top right-hand corner. You can manually unlink your Invoice2go account from Xero by navigating to Settings > Connected Apps in Xero and choosing Disconnect App.
Please note: You will receive an email from Invoice2go when your account has been disconnected. You can reconnect your Xero account at any time by completing the steps outlined in this article.
How do I correct these errors?
If you've followed the steps outlined above and you're still experiencing an error message when attempting to copy your invoices to Xero, please reference the chart below, which outlines some of the errors you may be experiencing along with how you can fix it. If you see a different error message than what is listed below, please contact support@invoice2go.com for assistance.
| Error Code | Error Message | Reason For Error | Solution |
| 1001 | Invoice not of valid status for modification | This error occurs when an invoice is already authorized in Xero. Invoice2go only copies unauthorized invoices to Xero |
When an invoice is voided, it can be copied again. Void the invoice in Xero by clicking the Invoice Options button and choosing 'Void.' Then try to manually copy from Invoice2go to Xero again Edit the 'Authorized' invoice in Xero. Please Note: These will not sync back to Invoice2go, so it could potentially create deviations between the invoices |
| 1002 | This document cannot be edited as it has a payment or credit note allocated to it | This error occurs when an invoice has a payment or credit note already allocated in Xero. Invoices must be authorized prior to a payment or credit note being applied |
Void the payment on the invoice in Xero or delete the associated credit note in Xero. Then attempt to copy the invoice again from Invoice2go. Having trouble deleting the payment from the invoice? Please reference the following support article. |
| 1003 | This organization has Construction Industry Scheme enabled. This account code 210 cannot be used in line items via the API | The Xero integration does not currently support creating or updating invoices with the Construction Industry Scheme enabled. | Contact Xero Support for questions regarding when CIS will be supported in the future |
| 1004 | This contact name is already assigned to another contact. The contact name must be unique across all active contacts | This error occurs when a customer is attempting to copy a contact with the same name, but it's not formatted in the same way across Invoice2go and Xero. | Ensure the client name in Invoice2go exactly matches what is shown in Xero |
| 1005 | Account code '***' is not a valid code for this document | Your Xero account code may not accept ACCREC invoices | Make sure the Xero account code can accept ACCREC invoices |
| 1006 | The email address must be valid | An improper email format has been entered | Ensure that the client billing email is valid |
| 1007 | One or more line items must be specified | An item hasn't been added to the document | Ensure that 1 or more items have been added to the invoice before exporting |
| 1008 | The organization is not subscribed to currency XXX | Currencies between Invoice2go and Xero do not match | Navigate to Account & settings>Xero and ensure currencies match (Step 3) |
| 1009 | The TaxType code --- does not exist or cannot be used for this type of transaction | Taxes may not match between Invoice2go and Xero | Navigate to Account & settings>Xero and ensure tax rates match between Invoice2go and Xero (Step 2) |
| 1010 | The TaxType code --- cannot be used with account code '***.' | Taxes may not match between Invoice2go and Xero | Navigate to Account & settings>Xero and ensure tax rates match between Invoice2go and Xero (Step 2) |
| 1011 | The contact with the specified contact details has been archived. | Contact is archived | The contact must be un-archived before creating new invoices or credit notes |
| 1012 | The description field is mandatory for each line item. | The description field is empty. | Fill in the description field. |
| 1013 | The Total for this document must be greater than or equal to zero | The invoice total is negative |
Ensure that the invoice total is a positive number before exporting |
| 1014 | The quantity value of '-1.0000' is invalid. Quantity must not be less than zero. | Xero does not accept negative quantities in invoices. |
Ensure that the quantity is a positive number before exporting |
| 1015 | The discount rate '-100.00' is invalid. Discount must not be less than zero. | Xero does not accept a negative discount rate. |
Ensure that a discount rate is a positive number before exporting |
| 1016 | The line total -220.00 does not match the expected line total -133.00 | Cascading error due to other validation errors. |
Ensure that the invoice totals balance correctly |
| 1017 | Invoice not found error | An existing Invoice with the specified Invoice # could not be found. |
We've fixed the issue on our side, please try to export the same document again |
| 1018 | The line item amount is too large | The line amount is over the max limit |
The maximum line amount is 9,999,999,999.99 |
| 1019 | The account code is no longer valid | ||
| 1020 | The contact name cannot be the same as existing | ||
| 2000 | Unknown general error | - |
Try again, Xero may be in maintenance and experiencing downtime |
| 2001 | Generic Xero error | - |
Try again, Xero may be in maintenance and experiencing downtime |
| 2002 | Generic Invoice2go error, e.g content store, delivery service | - |
Try again, Invoice2go internal services may be experiencing downtime. |
| 2003 | Error where billing name in the invoice is NULL | The invoice is missing a billing name. |
Make sure the billing name/client field is filled out on your invoice |
| 2004 | Error when the invoice is in a pending state | The invoice is pending syncing. |
This is a rare error and it may be a bug; report to our support team |
| 2005 | User is not integrated. | - |
This is a rare error and may be a bug; report to our support team |
| 2006 | Error when matching contact | The client name and email address may not be valid or have a typo |
Make sure contact name and email are valid |
| 2007 | Invoice cannot be exported error | The document has been previously exported, however it has been deleted/voided in Xero |
Please try again to export the same document again |
| 2008 | Generic Xero error | The requested Xero resources cannot be found |
This is likely due to an expired Xero subscription, please visit our Xero settings page and setup Xero integration again |