Once Xero is connected and the mapping is complete, Rehab Guru keeps your Xero organisation up to date without you doing anything extra. This article explains what moves in each direction and how long it takes, with worked examples for a client called Jordan Ellis. The numbers in each example match the numbered markers on the screenshot below it.
The short version: raise and change invoices in Rehab Guru, and they follow in Xero. Payments can be recorded on either side. Other changes made in Xero are not copied back to Rehab Guru.
What syncs, and when
From Rehab Guru to Xero, within a few minutes:
An invoice, when you issue it with Approve or Approve and send. The client is added to Xero as a contact the first time.
A payment against an invoice that is in Xero, whether you record it yourself or the client pays online.
A refund.
An invoice you void.
A credit note you issue or void.
From Xero to Rehab Guru, at the daily check:
A payment recorded in Xero against an invoice Rehab Guru sent, for example when your bookkeeper reconciles a bank transfer.
The removal of a payment that was recorded in Xero.
Once a day, Rehab Guru checks invoices sent or changed in the last 30 days, and invoices still owing, against Xero. Besides bringing in payments, the check flags anything that no longer matches.
The Xero status on invoices and payments
While Xero is connected, each issued invoice, each payment against an invoice and each credit note shows a Xero status under its own status.
Queued: waiting to be sent. It goes within a few minutes.
Synced: it is in Xero and the two match.
Failed: it could not be sent. Xero refused it, or could not be reached after several tries. Click the status to see why.
Needs review: it is in Xero, but something no longer matches or needs sorting out in Xero.
Not synced: it is not part of the sync, usually because it was issued before invoices started going to Xero, or was sent to a Xero organisation you no longer use.
Removed and Removed in Xero (payments only): the payment has been taken out of Xero, by Rehab Guru after a refund or a change, or by someone in Xero.
A Queued invoice, issued a moment ago.
A Synced invoice.
Open in Xero, in the invoice's menu, takes you straight to it.
Xero statuses on a client's invoices
Example 1: An invoice goes to Xero
You issue invoice RGA000034 to Jordan Ellis: one follow-up session at £60. It shows Queued, then Synced a few minutes later. In Xero:
The invoice arrives approved, as Awaiting payment. There is nothing to approve in Xero.
Jordan Ellis has been added as a contact.
The invoice number is the same as in Rehab Guru. The reference starting rg: is how Rehab Guru recognises its own invoices, so leave it as it is.
The line is posted to the sales account and the tax rate you chose in the mapping.
The invoice as it arrives in Xero
The issue date and due date match the invoice in Rehab Guru, in your practice's time zone. Lines with tax use the Xero rate you matched to that tax rate, and the tax amount is identical on both sides:
A £12 product line taxed at 20% uses 20% (VAT on Income).
The tax is £2.40, as on the Rehab Guru invoice.
A taxed line in Xero
About contacts: Rehab Guru creates its own Xero contact for each client and does not match clients to contacts you already have by name. If a contact with the same name exists, the new one has the client's Rehab Guru reference added to its name. Do not archive the contact Rehab Guru created: later invoices for that client would fail until it is restored.
Example 2: A payment recorded in Rehab Guru
Jordan pays the £60 on your card machine. You record it on the client's Billing › Payments view with Record payment, choosing the Card Machine method and attaching invoice RGA000034. The payment shows Queued, then Synced. In Xero the invoice is now Paid:
The payment is listed against the invoice.
The amount due is 0.00.
The invoice paid in Xero
Click the payment in Xero to see where it went:
It was paid into the Xero account you matched to that payment method, here Card terminal clearing.
The reference is the Rehab Guru payment number.
It is applied to the invoice.
The payment in Xero
Some details worth knowing:
Part payments: Xero shows the rest as still due.
One payment across several invoices: Xero gets one payment for each invoice.
Stripe payments: the full amount the client paid goes to the account you matched to Stripe. The reference is the Rehab Guru payment number followed by Stripe's payment ID. Stripe's fees are not sent.
Account credit: money a client has on account stays in Rehab Guru until it is used on an invoice, and reaches Xero then.
Record a payment rather than changing the status: setting an invoice to Paid with Update status sends nothing to Xero, so Xero still shows it as owing and the daily check flags it as Needs review.
Example 3: A payment recorded in Xero comes back
Jordan pays invoice RGA000035 (£75) and your bookkeeper records it in Xero, either from the invoice or by reconciling the bank line against it:
The account the money was paid into.
A reference.
Record payment.
Recording a payment in Xero
At the next daily check, Rehab Guru brings the payment in and the invoice shows Paid. On the client's Payments view:
The payment is marked Recorded from Xero.
Its Xero status is Synced. It is never sent back to Xero, so nothing is counted twice.
A payment brought in from Xero
Choose Preview from the payment's menu for the detail:
Its origin is System. A payment recorded in Xero cannot be edited in Rehab Guru.
The reference is the one entered in Xero, followed by (Xero).
The payment method is the one you matched to that Xero account in the mapping, here Cash. If no method, or more than one, is matched to the account, the method shows as Xero.
The detail of a payment recorded in Xero
The payment takes the date entered on the payment in Xero. If Rehab Guru already holds a payment of the same amount for that invoice that never reached Xero, the two are matched and no second payment is created.
If that payment is later deleted in Xero, the next check takes it back in Rehab Guru, as long as the money has not been used since: the payment shows Removed and the invoice is owed again.
Example 4: Voiding an invoice
You void invoice RGA000036 in Rehab Guru with Update status › Void. A few minutes later it is voided in Xero too. If the invoice had payments that Rehab Guru sent, they are removed from Xero first.
The Xero invoice is not voided while a payment on it is reconciled, in a batch or in a locked period, or while it has a payment that was recorded in Xero, or a credit note, prepayment or overpayment applied in Xero. The invoice then shows Needs review with the reason. Sort that out in Xero, then choose Retry sync.
Example 5: A credit note
You credit invoice RGA000037 in full with Credit note… from the invoice's menu. In Rehab Guru:
The credited invoice shows Credited, with nothing due.
The voided invoice from Example 4 shows Void. Both are Synced.
A credited invoice and a void invoice, both synced
In Xero:
The credit note has the same number as in Rehab Guru.
It is applied to its invoice.
No credit is left over, and the invoice shows as paid.
The credit note in Xero
Credit notes always go to Xero applied to their own invoice, on the account and tax rate your mapping gives that invoice's lines. If you refunded the client outside Rehab Guru, for example in cash, the refund shows in Xero as a refund on the credit note. Credit notes raised in Xero are not brought into Rehab Guru.
Refunds
When you refund a payment in Rehab Guru, including a Stripe refund, the payment in Xero is replaced with one for the amount you kept, so the Xero invoice shows the refunded amount as owing again. If the original payment has already been reconciled in Xero, Xero refuses the change and the payment shows Needs review: unreconcile it in Xero, then choose Retry sync. A part refund of a payment that was split across several invoices is not sent, and shows Needs review so it can be entered in Xero.
What does not sync
Draft invoices, and invoices dated before your Sync invoices from date.
Changes to an invoice after it has been sent. If its total changes in Rehab Guru, it shows Needs review so the Xero invoice can be corrected.
Status changes without a payment: marking an invoice Paid or Uncollectible with Update status.
Anything raised or changed in Xero other than payments on invoices Rehab Guru sent. Invoices and credit notes created in Xero, edits, voids, prepayments and overpayments are not brought in. Where they make the two sides differ, the daily check shows Needs review.
Later changes to a client's name or email. The Xero contact is created once.
Stripe fees and unused account credit.










