Once Healthcode is connected, you can send an invoice to the client's insurer as a claim, follow it until the insurer pays, and record the payment from the insurer's statement. This guide covers that day-to-day work. The numbers in each step match the numbered markers on the screenshot below it.
Before you start: finish the one-off setup in Setting Up Healthcode for Insurance Claims. The client needs an insurance policy and claim identity, the practitioner needs a provider number, and the appointment type needs a service code.
Step 1: Create a claim from an invoice
A claim is always made from an approved invoice. There are two places to start one.
From Billing
Go to Account › Billing & Data › Billing and choose Claims.
Choose Without claims. This lists approved invoices for clients who have an insurance policy and no claim yet. The other views follow a claim through its life (see Step 4).
Click Create claim on the invoice. Create claim again appears where an earlier claim for the invoice was cancelled.
Billing › Claims › Without claims lists the invoices you can claim for.
From the client record
Open the client, choose Billing › Invoices, click ⋯ on an approved invoice and pick Create claim.
If the client has more than one active policy, Rehab Guru asks which insurer the claim is for. The claim then opens, filled in from the invoice, the client's policy, the case and your Healthcode settings.
Step 2: Check the claim and validate it
The claim page shows everything that will be sent, and under each value where it came from, so you know where to correct it.
The insurer and the claim's status are next to the invoice number.
Problems are listed at the top. Rehab Guru first checks that nothing is missing; Healthcode then checks the claim against the insurer's rules. Click Show to jump to the field or line a problem is about, where you will find what to do and Healthcode's own message.
Use On this page to move between Patient & cover, Episode, Invoice and Charge lines.
Click Validate to have Healthcode check the claim. Nothing is sent to the insurer at this point.
When the claim has passed, Submit to Healthcode becomes available.
A claim that Healthcode has checked and found problems with. Fix them, then validate again.
Fixing problems: most fixes are made where the value lives, and the claim links you there: the membership number under the client's Billing › Insurance, the diagnosis on the case, the service code on the appointment type. Diagnosis, authorisation code and a line's service code can also be changed on the claim itself. Validate again after each fix.
Step 3: Submit the claim
Click Submit to Healthcode. Healthcode passes the claim to the insurer and the page updates.
The status changes to Sent.
The message shows when the claim was sent and the Healthcode reference. Quote this reference if you need to ask Healthcode about the claim.
Refresh status asks Healthcode for the latest position.
The ⋯ menu opens the invoice, reloads the claim or cancels it.
A submitted claim, with its Healthcode reference.
Note: when Healthcode is first switched on for your practice you can validate claims but not submit them. Contact our support team when you are ready to start sending claims to insurers.
Step 4: Keep track of your claims
Billing › Claims is your work queue for every claim in the practice. Each view shows a count:
Without claims: invoices you can still claim for.
Needs attention: claims that need something from you.
With the insurer: claims that have been sent and are waiting for the insurer.
Collected: claims the insurer has picked up from Healthcode.
Settled: claims where the insurer's payment has been recorded and nothing is left to decide.
Work through Needs attention regularly:
Choose Needs attention. You can narrow the list by insurer or search by invoice number or client.
The status says what is wrong, with a short explanation under the client's name. Needs fixes means Healthcode found problems when the claim was validated.
Shortfall to decide means the insurer paid less than you claimed. Decide on the statement takes you to the insurer payment (see Step 7).
The ⋯ menu opens the claim or the client's billing.
Needs attention lists the claims waiting on you.
Step 5: See payments from insurers
When an insurer pays, it sends a statement through Healthcode listing each claim it has paid. Rehab Guru collects these for you. For this you need the Healthcode API key from the setup guide, and a Healthcode package that includes insurer payment statements (RemittancesPRO).
In Billing, choose Insurer payments.
Click Refresh to fetch the latest statements from Healthcode.
The status shows where each statement stands: how many claims are recorded, still to record or unmatched.
A count such as 1 needs a decision marks a statement where the insurer paid less than you claimed, or nothing at all.
Each row is one payment from an insurer, covering one or more claims.
Not every insurer sends statements through Healthcode. If a payment arrives in your bank and no statement appears here, record the payment on the invoice in the usual way.
Step 6: Record an insurer payment
Most payments record themselves: with Record insurer payments automatically switched on in your Healthcode settings (it is on by default), every line that matches an open invoice is recorded as soon as the statement is read and shows as Recorded. The steps below are for the lines left over, or for practices that have switched the setting off.
Click a payment to open it. Each line is one claim the insurer has paid.
The heading shows the insurer, the payment date, the insurer's reference and the total paid.
Filter the lines: To record, Unmatched, Recorded, Needs decision or Ignored.
The status shows what has happened to the line. Once recorded, it links to the payment Rehab Guru created on the invoice.
Rehab Guru matches each line to your invoice by invoice number. If a line is unmatched, use Match to invoice… to pick the invoice yourself.
The ⋯ menu records the payment for one line, changes or removes the match, ignores a line that is not yours, or undoes a recording.
Where several lines are matched and waiting, Record all matched records them in one go. Recording adds an insurer payment to each invoice for the amount the insurer paid.
An insurer payment covering three claims.
Step 7: Decide what happens to a shortfall
If the insurer pays less than you claimed, or nothing, the line needs a decision before the claim can settle.
The line shows what the insurer paid and the reason it gave.
Click Decide….
Choose what happens to the unpaid amount.
The insurer paid nothing on this claim, so the whole amount needs a decision.
Write off (credit note): you will not collect the amount. Rehab Guru raises a credit note for it against the invoice. The credit note is not emailed to the patient.
Bill the patient: the amount stays owing on the invoice for the patient to pay, for example an excess. You can email the invoice to the patient in the same step, with a message.
Already covered: the amount has been dealt with elsewhere, such as on another statement.
Hold: park the decision while you query it with the insurer. You can add a note.
Resubmit claim: marks the claim as needing to be corrected and sent to the insurer again. Rehab Guru does not resend it for you from the statement, so nothing is sent at this point.
You can change your mind later with Undo decision in the line's ⋯ menu.
Need help?
If a claim is refused and the message is not clear, contact our support team with the invoice number and the Healthcode reference from the claim page.







