Using the Xero Online Accounting Integration

Learn how to use the Xero integration and view frequently asked questions.

Are you new to Xero Online Accounting?  Start by reading the first article in this series for an introduction to the Xero integration.

Accessing the features mentioned in this article

Where can I find this feature using the top menu?

• Manage > Integrations > Accounting > Xero
   

What more do I need to use this feature?

• Admin permissions to Manage your account and Integrations.
• Your account must have access to items (Inventory > Items), a key feature of Checkfront's classic item version. 
   

Enable Two Factor Authentication Xero requires all Checkfront & Xero users to set up Two-Factor Authentication (2FA) to bring Checkfront into compliance with mandated security protocols. To continue using the Xero integration, you must enable 2FA on your Checkfront accounts by February 14, 2023, or you will be prompted to set it up upon your next log-in.  Instructions for enabling 2FA can be found here. Questions? We're here to help. Contact us.

Which Checkfront version supports this feature - classic items, classic products, or both?

Your account must have access to classic items (Inventory > Items), a key feature of our classic items version of Checkfront. 

This feature is not available for use with classic products (Inventory > Products), a key feature of our classic products version of Checkfront. → Learn more about products

Once the Xero integration is successfully activated and linked to your Checkfront account, it should pretty much take care of itself. If you create an invoice or update a payment in Checkfront, the changes automatically update in Xero.

Once a partial or full payment is applied, the Xero invoice can no longer be edited. For example, if an item/product is added to an invoice in Checkfront, the edit does not sync with Xero, as the Xero invoice is locked. If a partial payment is applied, the status in Xero changes to 'Awaiting Payment'. Once the booking is fully paid, the invoice changes to 'Paid'.

Refunds applied to payments Xero doesn't currently support refunds to applied payments on invoices. You need to log in to Xero and cancel the payment. Once payments are canceled (or if no payments are applied), you can VOID or CANCEL the booking in Checkfront, and it VOIDs or DELETEs the invoice in Xero.

Filling in name and email fields The Customer must enter a Name or Email in the system Booking Form for the booking to sync to Xero successfully. If that information is missing, Staff need to manually add the information for the booking to sync.

Overriding the default account code in Xero (Items only)

Override settings not supported Xero override settings on a per-product basis are not currently supported.

If you don't use the same revenue account for all your items, you can override the default setting on a per-item basis.

To do this, open the item's Attributes tab (Inventory > Items). You see a field for the Xero Account Code just above the Advanced Options, and you can make the new account selection here.

Adding tax items A tax item can be added in Xero to sync with multiple taxes set up in Checkfront. Note that Xero only supports one tax item. However, as long as any taxes/fees are expressed as percentages (%) in Checkfront, there can be multiple components to the tax item in Xero to match what is in Checkfront. Find out more about adding, editing, or deleting tax rates in Xero here: Add, edit or delete tax rates in Xero

• I've activated the integration, but I'm not seeing any information in Xero?

  Please check your Account Activity log (Reports > Account Activity) for errors or via the Log tab while viewing a booking.
   

• Do my Customers get two invoices, one from Checkfront and one from Xero?

  Xero does not automatically email invoices or receipts. You have to do this manually from within Xero if needed.
   

• What happens if a contact already exists in Xero for a new booking?

  Checkfront looks up an existing contact by email address and uses it first before creating a new one.
   

• Can we supply different Xero account codes based on the items booked?

  Yes. See the Attributes tab in the item setup to supply a different account code for that item.
   

• When a Customer uses a Gift Certificate to make a payment, does that get synchronized with Xero?

  Currently, payments with Gift Certificates are not synced to the Xero invoice. This is because the payment for the Gift Certificate has already been accounted for, and we want to let you decide how best to handle and track payments made with them.
   

• We are transitioning to Xero Online Accounting, can we sync past Checkfront bookings with Xero automatically?

  No, you cannot automatically sync past bookings with Xero. Find more information about importing Customer Invoices within Xero's online Support Center.
   

• How is data transferred to Xero?

  When a booking is made, the price, item/product names, and dates are sent to Xero, and an invoice is created.

  The price Checkfront sends to Xero does not include taxes. Instead, Xero automatically calculates taxes based on the tax settings for that Sales account.

  An invoice code is then sent back to Checkfront, and we tie it to the booking. Afterward, if a supported adjustment is made to the booking, that information, along with the code, is sent to Xero, and the invoice is updated to reflect the change.
   

• Can I connect multiple Checkfront accounts to the same Xero account?

  Yes, you can log in to your existing Xero account from multiple Checkfront accounts using the standard setup with no additional steps.

   

• Where can I find records of any connection or invoice issues with our Xero integration?

  You can find invoice creation and connection logs within the Booking Invoice > Logs tab for each booking.
   

• What should I do if I see the following message within our account?

  "Your Xero connection is no longer valid. Reconnect the Xero integration to resume syncing."

  If you see this error message, please follow these steps to reconnect your integration.

  1. Go to Manage > Integrations.
  2. Find and click the Xero listing to open the Add-on Setup.
  3. Click Update to reconnect to Xero by logging in to your Xero account.

  4. Go to the related booking invoices and click the retry sync link at the bottom of each invoice.

     
      

< Setting up Xero Online Accounting