When connecting Xero to MyConstruct you may encounter some issues, to help diagnose issues we have a guide on accessing the Xero Logs here. Once you have accessed your logs, you will find the information and error description to help below.
When there's an issue with your Xero connection you will see a warning prompt on the main MyConstruct homepage (Portal).
Common Error codes for the Xero and how to solve them.
Error |
Reason |
Solution |
Invoice not of valid status for modification This document cannot be edited as it has a payment or credit note allocated to it |
This error appears when you attempt to modify an invoice that has been paid for. |
The only way to solve this is to void/delete the invoices in Xero and retry. Xero does not allow you to edit paid invoices. |
The Total for this document must be greater than or equal to zero. |
It’s either the price/quantity in one of the line items is less than 0. |
Change value to greater than 0 in your MyConstruct Quote / Invoice and it should update. |
Due date cannot be empty. |
Xero require the due date on an order / invoice to the populated. |
Due date cannot be empty. Add a due date to your Invoice or Order (delivery date). |
An existing contact could not be found using the specified contact details. The contact name field is required to create a new contact. |
Most likely that a customer with the same details is archived in Xero. Check that the customer in MyConstruct has a valid first and last name. |
Change the Client Name to be unique in MyConstruct or find the duplicate Xero Client and either use the original or update it. |
Invoice not of valid status for modification (Status is Paid). |
Invoice has been marked as paid in Xero which closes the invoice for editing. |
Mark this invoice as paid if you are comfortable with the state of the invoice in Xero. |
You have reached the limit of invoices you can approve. |
Your Xero account is on a trial or is on the started plan. |
You will need an active plan in Xero to use the integration. If you’re on the ‘starter’ plan, consult the limits on Xero’s pricing page. |
You can only record payments against AR or AP documents. |
The invoice has previously had a payment but then reversed |
Manually apply payment to invoice in Xero, and mark the invoice as paid in MyConstruct. |
The contact name ‘####’ is already assigned to another contact. The contact name must be unique across all contacts. |
A contact in Xero exists with this business name, with a different contact ID. |
Change the business name of the supplier or customer in MyConstruct to something other than what’s already in Xero. |
The specified contact details matched an archived contact. Archived contacts cannot currently be edited via the API. |
The contact has been archived or matches an archived contact in Xero. |
Unarchive the contact in Xero. If you don’t want to continue to use or update the archived contact, change the ID/contact code in Xero once it’s no longer archived. |
OAuth Error: token_rejected. The access token has not been authorized, or has been revoked by the user |
The most likely cause for this error is that the Xero integration is inactive. |
In MyConstruct go to Settings > Business Details > Xero and make the integration is active. Re-connecting can also sort this out. |
Comments
0 comments
Article is closed for comments.