Rehab Guru keeps a record of everything it sends to Xero and of its daily checks against Xero. This article shows where to find that record, how to deal with anything marked Failed or Needs review, and how to reconnect or disconnect Xero. The numbers in each step match the numbered markers on the screenshot below it.
Who can do this: account administrators and sole practitioners see Xero activity and can retry. Other team members see the Xero status on invoices and payments, with the reason, and ask an administrator to retry.
See at a glance whether anything needs you
Go to Account › Sharing & Integrations › Integration.
The Xero card tells you when something needs attention. Click the link to go straight to it.
Click Manage for the connection summary.
The Xero card on the Integrations page
Open Xero settings goes to the connection and mapping.
If anything needs attention, Open activity lists it.
Disconnect is covered at the end of this article.
Managing the Xero connection
Read Xero activity
Xero activity is in two places: Account › Billing & Data › Billing › Xero activity, and the Activity card on Account › Sharing & Integrations › Xero.
The Xero activity view.
Four lists, each with a count: Needs attention, Pending, Failed and Done.
The status of each item. Click it for the reason and what to do.
Retry all, on the Needs attention and Failed lists, retries everything in that list once you confirm.
The menu on each item, which can include Open in Xero, Open client billing and Retry.
Xero activity, showing one item that needs attention
Needs attention: the item is in Xero but the two sides no longer match, or something has to be sorted out before it can be sent.
Pending: queued, or waiting on something else, such as a payment waiting for its invoice. Most go within a few minutes; some wait up to an hour.
Failed: Xero did not accept the item, Rehab Guru could not send it as it stands, or Xero could not be reached after several tries.
Done: everything that has gone through.
Each row says what it was, for example a contact, an invoice, a payment, a payment removal, a void, a credit note, or a check against Xero.
The Done list: a contact, four invoices and a payment sent to Xero
Fix an item
Click the Xero status on an invoice, payment or credit note, or on a row in Xero activity. In this example the daily check found that invoice RGA000038 had been voided in Xero:
The status, here Needs review.
What is wrong and what to do. Where Xero gave its own message, it is shown under Xero says.
Open in Xero takes you to the invoice in Xero.
Retry sync, once you have fixed it. On a row in Xero activity the button is Retry.
The reason behind a Needs review status
Xero cannot restore a voided invoice, so the way to make the sides agree is to void the invoice in Rehab Guru as well. If the client still owes the money, raise a new invoice. Then choose Retry sync, or Retry on the item in Xero activity, so Rehab Guru checks the invoice against Xero again. Otherwise it clears at the next daily check.
Retrying
Retry sync (or Retry in Xero activity) queues the item again. You see Queued for Xero. It is sent within a few minutes.
Retry all does the same for the whole Needs attention or Failed list. Fix what Xero says first, or the items come straight back.
A retry never creates a duplicate. Rehab Guru looks the item up in Xero before sending it again.
Common reasons and what to do
These are the usual wordings. The message you see may also name the invoice, the account or the amounts.
Mapping
"Part of this invoice has no matching Xero account or tax rate in Account › Xero." A tax rate on the invoice has not been matched yet. Complete the mapping, save it, then retry.
A payment has no Xero account for its payment method. Choose the account for that method in the mapping, save it, then retry.
"An account or tax rate chosen in Account › Xero can no longer be used in Xero." It was archived or changed in Xero. Click Refresh on the mapping, choose again, save, then retry.
Differences between the two sides
"Xero already has a different invoice with this number." Renumber the other invoice in Xero, then retry. To stop it happening again, set a preface under Account › Billing & Data › Billing › Settings › Invoice numbering.
"This invoice was deleted or voided in Xero." Void it in Rehab Guru as well, then retry. If the client still owes the money, raise a new invoice.
"Xero’s total for this invoice is different from Rehab Guru’s." The invoice was edited in Xero. Correct it in Xero, then retry.
"This invoice changed in Rehab Guru after it was sent to Xero." Update the Xero invoice to match, then retry. If you voided the invoice in Rehab Guru, retrying voids it in Xero.
"Xero and Rehab Guru show different amounts owing on this invoice." A payment is on one side only. If a payment recorded in Rehab Guru is missing from Xero, record it in Xero for the same amount and Rehab Guru pairs the two. If the invoice was set to Paid without a payment, contact our support team.
"Xero has a credit note, prepayment or overpayment applied to this invoice; Rehab Guru does not bring those in." Remove it in Xero, or record the equivalent in Rehab Guru.
"This client’s contact is archived in Xero." Restore the contact in Xero, then retry.
Things Xero will not allow
"Xero refused the change. A reconciled payment has to be unreconciled, or a locked period unlocked, first." This follows a refund, a change to a payment or a void. Unreconcile the payment or move the lock date in Xero, then retry.
"Dated in a locked period in Xero; move the lock date, then Retry."
"Only invoices in your Xero organisation’s currency are sent to Xero." The invoice is in a different currency. Retrying will not help.
Nothing to do
"Xero is limiting requests for your organisation" and "Xero did not answer; Rehab Guru will try again shortly." Rehab Guru keeps trying by itself.
Check Xero for payments without waiting
Payments recorded in Xero normally arrive at the daily check. To look sooner at an invoice that already has a payment in Rehab Guru, for example one that was part paid:
On the Payments view, open the menu on a payment for that invoice and choose Check Xero for payments.
Checking Xero for payments
Rehab Guru checks the invoices that payment is applied to and tells you what it found, for example Brought in a £75.00 payment recorded in Xero. or Checked Xero: nothing new to bring in. This is also the way to check a paid invoice that has not changed in the last 30 days, which the daily check no longer looks at.
Payments removed in Xero
A payment that was recorded in Xero and is then deleted there is taken back in Rehab Guru at the next check. It shows Removed and its invoice is owed again.
If Rehab Guru cannot take it back automatically, because the money has been used since, the payment shows Needs review. If the money was never received, choose Remove from Rehab Guru in the payment's menu.
A payment you recorded in Rehab Guru and then deleted in Xero is not removed from Rehab Guru. It shows Needs review so you can decide which side is right.
Reconnect Xero
The connection shows Needs reconnecting when Xero has ended Rehab Guru's access. This happens when Rehab Guru is removed under Connected apps in Xero, when the connection has not been used for a long time, or when the Xero user who connected no longer has permission to create invoices and payments. Nothing is lost: invoices and payments keep queueing and are sent within about an hour of reconnecting.
Go to Account › Sharing & Integrations › Xero and click Reconnect.
Sign in to Xero, click Allow access, and choose the same organisation.
If you see "No Xero organisation was chosen": click Try again and make sure the organisation is selected in Xero. If the message comes back, open Settings › Connected apps in Xero and disconnect Rehab Guru there, then click Reconnect again and choose the same organisation. Your mapping and everything already synced are kept.
Switching to a different organisation: reconnect, allow the other organisation in Xero, and click Switch to this organisation. The mapping has to be chosen again for the new organisation before anything is sent. Invoices already sent to the old organisation are not sent again and show Not synced.
Disconnect Xero
Click Disconnect on Account › Sharing & Integrations › Xero, or in Manage on the Integrations page, and confirm.
Confirming the disconnection
Rehab Guru stops posting to Xero and removes its access to your organisation. If Xero still lists Rehab Guru under Connected apps afterwards, remove it there.
Nothing already in Xero is changed or removed.
Your mapping is kept. If you connect the same organisation again, syncing carries on from where it stopped.
Nothing is queued while you are disconnected. After reconnecting, use Send earlier invoices for invoices issued in the meantime. Payments recorded in that time on invoices already in Xero are not sent, so record those in Xero. Invoices voided in that time show Needs review: choose Retry sync to void them in Xero. Refunds made in that time have to be entered in Xero.
Changing the mapping later
A change to the mapping applies to invoices, payments and credit notes sent from then on. Nothing already in Xero is moved or changed. Moving Sync invoices from to an earlier date does not send older invoices by itself: use Send earlier invoices afterwards.
Still stuck?
Xero is in beta, and we want to hear about anything that does not match. Contact our support team with the invoice or payment number and the message shown.







