Important: Xero Connector (API) is an optional paid add-on.
For further information, please contact [email protected]
Once you click the Synchronise button, the Export Results section will display all data transmitted from Zedonk to Xero and the corresponding response from Xero.
Upon successful creation of invoices or credit notes in Xero, you will notice the following message in the logs when an invoice (in this example, IN-10000) has been created:
[01/01/2025 19:05:21] (Message) Invoice:IN-10000
[01/01/2025 19:05:22] (Message) - not found
[01/01/2025 19:05:22] (Message) - create
Invoice and credit notes can also be updated, if no payments or credit notes allocated to the document. You will notice the following message in the logs when an invoice (in this example, CN-10000) has been updated:
[07/03/2025 08:53:24] (Message) CreditNote:CN-10000
[07/03/2025 08:53:24] (Message) - found
[07/03/2025 08:53:24] (Message) - updated
Errors
If you encounter an error related to a Customer Record, invoices/credit notes for this Customer will not be exported but invoices/credit notes for other Customers will be exported.
If you encounter an error related to an Invoice/Credit Note, no invoices/credit notes will be exported. You will need to rectify the error and then sync again.
Tip: You can search for the word (Error) in the log to identify the message.
Mac - Command+F > type (Error)
PC - Control+F > type (Error)
(Error) Email is invalid
Xero allows for only one, correctly formatted, email address in the Contact Details email field. Update the Contact details for the Customer record to include only one email address.
(Error) System.Exception: Error fetching xero contacts. HTTP Status: BadRequest, response: SearchTerm has a maximum length of 50 characters
Xero allows up to 50 characters for the Customer name. Amend the Customer name in Zedonk.
(Message) This document cannot be edited as it has a payment or a credit note allocated to it
Xero does not allow a document to be updated/edited if a payment or credit note has been allocated to it. Update the Xero Connector Export Settings to exclude the document from your export.
The find the related invoice, document, search for <InvoiceNumber>, as per the example below:
(2) - The error message.
(3) - The Invoice number the error refers to (in this example, IN-01316)
(Message) The document date cannot be before the end of year lock date
You cannot import documents or modified documents before the end of year lock date. Either update the Xero Connector Export Settings to exclude the document from your export or update your end of year lock date in Xero.
(Error) Error posting tracking option (VerboseErrors = True): Not Found
The tracking options cannot be sent from Zedonk to Xero. Review your Xero Tracking Options and ensure all tracking options exist in Xero.
For example, if you are using the Tracking Option to track season the document is assigned to, when a new season is created in Zedonk, you will need to add the new season name in Xero.
If you are unable to resolve the issue then please send an email to [email protected]
Please attach:
- A copy of the export log in a word/text document.
- A screenshot of your connector export settings.
- A screenshot of your connector configuration settings. Click the Configuration Settings button to reveal your connector configuration settings.