Skip to main content

Set up the Xero integration

Follow our step-by-step guide to enable the integration

Updated this week

Use our Xero integration to post invoices straight from OnRent Events to Xero and keep your organisation up-to-date between the systems. 

We’ve broken down the setup into eight steps. Depending on how your business works, you might not need to complete all of these steps: 

  1. Authorize 

  2. Xero contact import or export

  3. General settings

  4. Revenue group mappings

  5. Purchase order settings

  6. Tax rate mappings

  7. Payment method mappings

  8. Tracking category mappings

  9. Enable

Before you begin

You’ll need an Xero account to use our Xero integration. Sign up on the Xero website.

Get started

Head to System Setup > Integrations > Xero to start the configuration.

Authorize

Hit the Connect to Xero button, and authorise the connection between the system and your Xero organisation.

A window will open, prompting you to log in to Xero if not already signed in, then choose an organisation on your account to link to. 

Xero contact import or export

Use the Import contacts and Export organisations buttons to bring contacts in from Xero or export organisations to Xero.

  • If you’re an existing Xero user, import your contacts from Xero to create corresponding linked organisations.

  • If you’re an existing user and new to Xero, export your organisations to Xero to create corresponding linked contacts in Xero.

  • If you’ve used both in parallel for a while but haven’t integrated the two, import from Xero to create organisations and export to create contacts in Xero.

We’ve a full guide that runs through importing and exporting in more detail, see: Import and export organisations from Xero.

General settings

Default account code

Products, services, and text items are assigned a revenue group for rental and sale. You can map these revenue groups to Xero account codes, which are used when posting an invoice to Xero.

The default account code is used when posting an invoice to Xero with invoice items that contain an accumulated charge. For example, when an opportunity is invoiced with the grouping option of “opportunity,” the line on the invoice may contain charges from multiple revenue groups.

Invoice status

Choose the status of invoices in Xero when posted:

  • Authorized

  • Submitted for approval

  • Draft

Mark the invoice as sent to the client

When you print, email, or provide a link to an invoice in Xero, it can be marked as “Sent” so you see that you’ve sent your customer a copy at a glance.

Toggle this setting to YES to automatically set invoices posted as “Sent” in Xero – perfect if you’re using discussions to send out invoices.

Post zero-value invoice items?

Set this to NO to prevent zero-value invoice items from being posted from OnRent Events to Xero.

Create a linked Xero contact when creating an Organisation?

When set to YES, when you create an organisation in OnRent Events, a new contact is automatically created in Xero. This organisation is linked to the contact in Xero, so invoices posted are associated with this contact in Xero.

A linked contact won’t be created if you fill in the “Linked Xero contact” field when creating an organisation.

Update a linked Xero contact when editing an Organisation?

Set to YES to keep linked contacts in Xero up-to-date with information in OnRent Events. When you edit an organisation that’s linked to an Xero contact, OnRent Events will update the contact information in Xero.

Revenue group mappings

As mentioned above, products, services, and text items are assigned a revenue group for rental and sale. In this section, you map revenue groups to Xero account codes.

You’ll see a list of your revenue groups on the left and a list of Xero accounts on the right. Map each account here.

If you add a new account in Xero and need to update a list, hit the blue refresh link to the right.

To add new revenue groups, head to System Setup > Revenue groups.

Purchase order settings

You have the option to post purchase orders across to Xero, but this does require you to enable the feature within your integration settings. You'll first need to set your toggle to Yes.

Once this has been enabled, you'll see the option to choose your status along with the option to mark a purchase order as sent to a contact.

We'll also require you to map your cost groups across to the relevant Xero accounts before you can look to post.

Tax rate mappings

In this section, make links between tax rates

These mappings are used when posting to Xero to set the Xero invoice or purchase order line item’s tax rate based on the item’s tax rate.

You’ll see a list of your tax rates on the left and a list of Xero tax rates on the right. Map each tax rate here. You can only map one OnRent Event tax rate to one Xero tax rate, which is something you will need to consider when creating your tax.

Multiple tax components

A tax rate in Xero can consist of multiple tax components (rate percentages) to cater for regions where both state and city taxes are applicable. The state and city tax rate percentages are created as separate tax rates and combined using a tax rule. 

With such a tax configuration, link both OnRent Events tax rates to the same Xero tax rate.

Payment method mapping

This section is optional; it’s only needed if you wish to record payments in Xero from OnRent Events.

If you don’t see anything here, come back to this section later. We’ve got a guide that runs through this, see: Take payments when integrated with Xero

You’ll see a list of your payment methods on the left and a list of Xero accounts on the right. Map each account here.

Tracking category mapping

This section is optional; it’s only needed if you wish to use Xero tracking categories to track revenue for stores. Tracking categories can only be used for stores.

You’ll see a list of your stores on the left and a list of Xero tracking categories on the right. Map each store here.

Enable

Review all of your settings, then when you’re happy, toggle the “Enabled” slider at the top to YES. 

When the slider is set to YES, the Xero options become visible in your system, e.g. you’ll now get the option to Post invoice against an invoice.

Link multiple instances of OnRent Events to one Xero account.

If you have more than one OnRent Events account and wondered if you required a separate Xero account for each instance of OnRent Events, the answer is that you do not need a separate Xero account. You can post invoices from multiple instances of OnRent Events to one Xero account. Log in to the OnRent Events account you wish to connect to Xero, head to System Setup> Integrations> Xero, connect to Xero and enable the integration.

Note

All mappings from OnRent Events to Xero will need to be configured for each instance of OnRent Events.

Next steps


Did this answer your question?