Skip to main content

Connecting Xero to Rehab Guru

Connect your Xero organisation to Rehab Guru and choose the accounts, tax rates and start date so invoices and payments post to Xero automatically.

Written by Simon Taylor

Xero is the accounting software many practices and their bookkeepers use. When you connect it, the invoices, payments and credit notes you record in Rehab Guru post to your Xero organisation within a few minutes, and payments recorded in Xero against those invoices come back to Rehab Guru. This guide takes you through the one-off setup: connecting, choosing where things go in Xero, and sending invoices you have already issued. The numbers in each step match the numbered markers on the screenshot below it.

Who can do this: you need to be an account administrator (or a sole practitioner) in Rehab Guru, on a plan that includes integrations, and you need to connect from the web app rather than the mobile app. In Xero, sign in as a user who can approve invoices and record payments. For most organisations that is a Standard or Adviser user.

Xero is in beta: check your invoices, payments and credit notes in Xero after they sync, and contact our support team if anything doesn't match.

Before you start: check these in Xero

A few minutes in Xero first makes the setup quick. It is worth doing this with your bookkeeper or accountant.

  • Currency: your Xero organisation must work in the currency you invoice in. Rehab Guru sends Xero only invoices in the organisation's own currency, and it does not stop you connecting an organisation in a different currency, so check this first.

  • One organisation: a practice connects to one Xero organisation at a time.

  • A sales account: the revenue account your treatment income goes to, for example 200 · Sales. It needs an account code.

  • Tax rates: for each tax rate switched on in Rehab Guru, Xero needs a tax rate at the same percentage. You also choose a 0% Xero rate for invoice lines with no tax. Ask your accountant which 0% rate is right for you, for example Exempt Income or No VAT.

  • Somewhere for payments to go: each payment method switched on in Rehab Guru is matched to a Xero account, whether or not you use it often. This can be a bank account in the organisation's currency, or any account with Enable payments to this account ticked.

  • Invoice numbers: an invoice has the same number in Xero as in Rehab Guru. If Xero already holds invoices that could share a number with yours, set a preface in Rehab Guru first under Account › Billing & Data › Billing › Settings › Invoice numbering. If the numbering shows Locked, contact our support team.

  • Lock dates: Xero refuses anything dated on or before a lock date. Note your lock date so you can choose a later start date in Step 2.

Using a clearing account for card payments

Many practices post card and Stripe payments to a clearing account rather than straight to the bank. Rehab Guru sends Xero the full amount the client paid and does not send Stripe's fees, so a clearing account lets your bookkeeper match the payout and the fee when the money reaches the bank. To make an account available for payments in Xero:

  1. In Xero, go to Accounting › Chart of accounts and click Add Account (or open an existing account). Choose the account type, for example Current Asset, and give it a code and a name.

  2. Tick Enable payments to this account, then click Save.

Making a Xero account available for payments

Step 1: Connect to Xero

  1. In Rehab Guru, go to Account › Sharing & Integrations › Integration.

  2. Find the Xero card under Billing & payments.

  3. Click Connect to Xero.

Finding Xero on the Integrations page

Xero opens and asks you to sign in if you are not already signed in.

  1. Check the organisation is the one you want Rehab Guru to use. If your Xero login has more than one organisation, choose the right one.

  2. Click Allow access.

Xero asks you to allow access

Rehab Guru asks to view and manage contacts, invoices and payments, and to view your organisation settings so it can read your accounts and tax rates. You can remove this access at any time, from Rehab Guru or from Connected apps in Xero.

You are returned to Rehab Guru to confirm the organisation:

  1. The organisation you allowed is listed.

  2. Click Use this organisation.

Choosing the Xero organisation

If Rehab Guru cannot use the organisation, it lists the reasons, for example its country, a currency Rehab Guru does not invoice in, a Xero Cashbook or Ledger plan, or a Xero user who cannot approve invoices and record payments. Choose another organisation, or change it in Xero and try again.

  1. Xero connected confirms which organisation you are connected to.

  2. Click Open Xero settings to carry on to the mapping.

Xero is connected

From now on there is a Xero page in the menu under Account › Sharing & Integrations.

Step 2: Choose where things go in Xero

The Mapping card on Account › Sharing & Integrations › Xero tells Rehab Guru which Xero accounts and tax rates to use. It shows Incomplete until everything is chosen, and nothing is sent to Xero until then. The lists come from your Xero organisation: click Refresh if you have just changed something in Xero.

  1. Sales income account: the Xero revenue account invoice lines are posted to.

  2. Different account for some appointment types: optional. Click it, then Add appointment type, to send particular appointment types to a different revenue account, for example classes or product sales. Every other line uses the sales income account.

  3. Tax rates: there is a row for each tax rate switched on in Rehab Guru and a No tax row for lines without tax. Choose the matching Xero rate for each. Rehab Guru tells you if the Xero rate is a different percentage.

  4. Payment accounts: there is a row for each of your payment methods, including Stripe if you take card payments through Rehab Guru. Choose where the money goes in Xero for each.

  5. Sync invoices from: invoices dated from this day go to Xero as they are issued. Most practices choose today or the first day of the current accounting period. Choose a date after your Xero lock date.

  6. Invoice theme: optional. Xero's default theme is used unless you choose another.

  7. Click Save mapping.

The completed mapping

You can save part-way and come back later. Rows still to fill are marked Needed before invoices can sync. When the mapping is complete you see Xero mapping saved. Invoices and payments will sync.

  1. The Connection card shows Connected, with the organisation, its country and its currency.

  2. The Mapping card shows Syncing.

Connected and syncing

Keep the mapping up to date: if you later add a tax rate or a payment method in Rehab Guru, come back and choose its Xero rate or account. Until you do, invoices and payments that use it show Failed or Needs review with the reason. Once the mapping is saved, retry them.

Step 3: Send invoices you have already issued

This step is optional. From now on, each invoice goes to Xero automatically when you issue it. Invoices you issued before the mapping was saved are not sent until you ask, even when they are dated on or after your start date.

  1. Check the Sync invoices from date. Only invoices dated from this day are offered.

  2. Once the mapping is complete and saved, Rehab Guru tells you below it how many invoices dated since then are not in Xero yet. Click Send them now.

  3. You can do the same later with Send earlier invoices on the Activity card.

Invoices issued before you connected

  1. Confirm with the button that shows how many will go, here Send 11 invoices. They go oldest first, with their payments. Anything Xero refuses shows in Activity with the reason.

Confirming the invoices to send

Only open and paid invoices are sent. Drafts, void invoices and invoices marked uncollectible are left out. A large number is sent in batches: Rehab Guru tells you how many are left, and you send again.

Avoid double counting: if income for a period is already in Xero another way, for example from a spreadsheet import or a previous system, do not send that period's invoices as well. Set Sync invoices from to the day after.

You're connected

Setup is complete. To see what happens to each invoice and payment from here, with worked examples in both directions, read How Rehab Guru and Xero Stay in Sync. If something shows Failed or Needs review, see Checking Xero Activity and Fixing Sync Problems.

Related articles

Did this answer your question?