To help resolve common issues quickly and keep your workflow running smoothly, we've complied a list of common validation exceptions (errors) and suggested solutions to help you address them efficiently. If you're still experiencing difficulties, feel free to reach out to our support team for further assistance.
The error message will start with the following wording "A validation exception occurred..." and provide a detailed instructions of the issue and potential resolution, the table below provides more details.
Error message | Section | How to resolve |
Payment amount exceeds the amount outstanding on this document. | Payment | Review the amount of the payment. |
You can only have a maximum of 5 contact persons. | Contacts | Xero allows a maximum of 5 contact persons in any Company. Create a generic (default) finance or AP contact for all invoices to be sent to. |
Additional people cannot be added when the primary person has no email address set. | Invoices, Contacts | Your contact in Xero does not have an email address. Log into your Xero account, find the existing client, make sure the primary contact has an email address and try again. |
The quantity value '-1.0000' is invalid. | Invoice, Estimate | Quantity must not be less than zero. The minus needs to be applied to another column. |
The contact name (###) is already assigned to another contact. | Invoices, Estimate | The contact name must be unique across all active contacts, review contacts and select existing contact. |
The document date cannot be before the end of year lock date, currently set at 30-Jun-20XX. | Invoices, Expenses, Bills | The document cannot be edited as it is dated before the end of year lock date, also known as ledger lock in Xero. |
Purchase / Expense / Invoice currency does not match tenant currency. | Purchase, Expenses, Invoices | Multi-currency not yet supported in your Xero account. Amend currency to match system preferences. |
Email address must be valid. | Sending from Wiplist | Email address is missing details, review address, amend and re-send. |
Payments exceed total amount on invoice. | Invoice | Review payments, apply full amount to the invoice and establish next steps for balance. |
The description field is mandatory for each line item. | Estimates | A description is mandatory for each line item. |
This document cannot be edited as it has a payment or credit note allocated to it. | Invoice | Invoice can not be modified as a payment has been allocated, remove the payment and make changes. |
Invoice has accounting sync error. Re-sync to Xero Accounting. | Invoice | Manually sync the item to Xero. |
Xero Accounting is disconnected, go to integrations to reconnect. | Settings, | Reconnect your Xero accounting integration. |