Troubleshooting and Resolving Xero Integration Issues in OnRent Events provides seamless integration with Xero, enabling efficient management of invoices, purchase orders, and contacts. However, occasional issues with linking contacts, posting transactions, and configuring tax settings may occur. This guide walks you through common problems and their resolutions to ensure a smooth integration experience.
By also maintaining proper data formatting and regularly verifying integration status, many of these issues can be proactively avoided.
The organisation is not mapped to an Xero contact
The organisation set up against this invoice isn’t linked to a contact in Xero.
To resolve, you can just head to the organisation page in People & Organisations and edit it. In the “Linked Xero Contact” field, enter the name of the contact in Xero that you’d like to link this organisation to.
If the contact isn’t created in Xero, head to Xero and create it there. Then edit the organisation in OnRent Events to create the link.
If the 'Linked Xero Contact' field displays a blank box, ensure that the organisation exists in Xero. The field will only display options if there is a matching organisation in Xero.
Revenue Group ‘Rental’ is not mapped to a Xero Account
Additionally, if you encounter an 'Account code is invalid for this transaction' error, ensure that your revenue group and tax mapping settings are accurate. Also, check that the default account code in Xero is mapped to a revenue-specific account.
It sounds like you haven’t mapped a revenue group to an invoice line item and an account in Xero.
To resolve, you can go to System Setup > Integrations > Xero and make sure all of your Revenue Group Mappings are correct. You’ll also want to make sure that your default account code is set.
The save of the Xero Invoice failed with error message(s): Invoice # must be unique. Failed to post the invoice.
When you post an invoice from OnRent Events, Xero will check to make sure the invoice number is unique. An invoice will fail to post if the invoice number has already been used.
Set your invoice numbering sequence in OnRent Events in System Preferences. You might like to add an invoice number prefix to invoices created in OnRent Events to avoid clashes with Xero invoice numbers.
Once you’ve changed your invoice numbering sequence to match the next number in Xero, void the invoice with the overlapping number in OnRent Events by clicking Void Invoice under Actions on the invoice page.
The save of the Xero Invoice failed with error message(s): The TaxType code ‘OUTPUT2’ cannot be used with account code ‘100’.”
Generally speaking, this message appears when you're trying to post tax marked as revenue to an account code that's marked for expenses in Xero.
To resolve:
Check your mappings in OnRent Events by heading to System Setup > Integrations > Xero.
Check your chart of accounts in Xero to ensure all accounts linked to revenue groups have the correct account type.
The save of the Xero Invoice failed with the error message(s): You cannot save this transaction using an inventory account type.
You’ll generally see this error message if you’ve mapped a revenue group to an account in Xero that’s not set up for revenue.
To resolve, either:
You can change your mappings in OnRent Events by heading to System Setup > Integrations > Xero.
Check your chart of accounts in Xero to make sure that all accounts that are linked to revenue groups have the correct account type.
The save of the Xero Invoice failed with the error message: The Invoice includes an item with tax amounts for Tax Rates 'Rate 1, Rate 2' which are mapped to different Xero Tax Rates.
This can occur if you have multiple sales taxes (for example, state and city).
Item lines on Xero invoices can only have one Xero tax rate. To handle multiple sales taxes, Xero tax rates can have multiple tax components (see "Add a tax rate" in the Xero documentation).
To cater for this in OnRent Events, you can create two tax rates, one for the state and one for the city and then map these to your multi-component Xero tax rate. Please see the Tax rate mappings section of Set up the Xero Integration for more details.
The save of the Xero Contact failed with error message(s): The contact name is already assigned to another contact. The contact name must be unique across all active contacts.’
It sounds like you’re creating an organisation in OnRent Events and have the “Create a linked Xero Contact when creating an Organisation?” setting on.
OnRent Events is trying to create a new linked contact, but there’s already a contact in Xero with the same name as this organisation.
To resolve:
On the create organisation screen, enter the contact's name in Xero in the “Linked Xero Contact” field. OnRent Events will suggest from contacts in Xero, just choose one.
Change the name of the organisation in OnRent Events so it doesn’t match the Xero contact. If you need to change the Xero contact linked to an organisation (e.g., the current one no longer exists), navigate to the organisation’s details, edit the 'Linked Xero Contact' section, and select the new Xero contact. By maintaining proper mappings and promptly updating your account configurations, you can prevent common issues in OnRent Events integration.