Healthcode is the clearing service most UK private medical insurers use to receive bills. Connecting it to Rehab Guru lets you send insurance claims straight from an invoice, see what Healthcode and the insurer say about each one, and record insurer payments when their statements arrive. This guide takes you through the one-off setup. 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. Healthcode is switched on practice by practice, so if you cannot see it under Integrations, contact our support team.
Step 1: What you need from Healthcode
Healthcode sets up your account and site; Rehab Guru cannot do this for you. Before you start, make sure you have:
Recognition with at least one insurer for the practice or its practitioners.
A Healthcode account and a VEDA practice site, created through Healthcode's registration process.
A Clearing Service subscription for each payee on your site. This is what lets you bill electronically.
Optional: the Standard Practice/Clinic Bundle adds insurer payment statements (RemittancesPRO). The Premium Practice Service Package adds statements and membership checks (Find Member). Ask Healthcode for a quotation.
The details to collect
Site ID and Web services username: both are in the welcome email Healthcode sent when you registered. The Site ID looks like HC followed by five letters or numbers. If you cannot find them, Healthcode can tell you.
Web services credentials: a long key that an Account Manager user generates inside your Healthcode account.
API key (a Key ID and a Key secret): also generated by an Account Manager user. Healthcode's steps are in their authentication guide. You only need this for insurer payment statements and membership checks, and you can add it later.
Tip: tell Healthcode that Rehab Guru is your practice management system. They set your site up with the right defaults for us: regulatory body numbers for practitioners and industry standard service codes.
Step 2: Connect Healthcode in Rehab Guru
Go to Account › Sharing & Integrations › Integration.
Find the Healthcode card under Billing & payments.
Click Connect. Once you are connected this button reads Manage.
Finding Healthcode on the Integrations page
In the dialog that opens:
Set Healthcode site to Live site.
Enter your Site ID.
Enter your Web services username.
Paste your Web services credentials.
If you have one, enter the API key's Key ID and Key secret.
Click Test and connect.
Entering your Healthcode details
Rehab Guru checks the details with Healthcode before saving anything. If Healthcode refuses the Site ID, username or credentials, nothing is saved and you are told which one to check. If only the API key is refused, the claims connection is still saved and you can add the key again later from Update details.
Your first claims are checked, not sent: when you first connect, you can validate claims with Healthcode but Rehab Guru will not submit them. When your first few claims validate cleanly, contact our support team and we will switch submitting on for your practice.
Step 3: Check who Healthcode recognises
Go to Account › Sharing & Integrations › Healthcode and scroll to Healthcode providers. This list comes straight from Healthcode.
Each provider on your site is listed with the insurers that recognise them. A claim to an insurer that does not recognise the provider will be refused, so check this before you bill.
Payee marks a provider insurers can pay.
An amber chip such as Pending means recognition is not complete. Speak to Healthcode or the insurer.
Click Refresh after Healthcode changes anything on your site.
Providers on your Healthcode site and the insurers that recognise them
Step 4: Set your billing identity
At the top of the same page, Billing identity tells insurers who is billing and where treatment happens.
Who insurers pay: choose I am paid directly (solo practitioner) if each practitioner is paid in their own name, or The clinic is paid (payee number) and enter the clinic's payee number.
Treating site code: enter the site code Healthcode gave your clinic, if you have one.
Don't send the site code to: some insurers refuse a site code they have not mapped to your practice. Choose those insurers here and their claims go without it.
Default setting: where treatment usually happens. Most clinics use O · Outpatient. You can override it for a single appointment type in Step 6.
Claim message status: on the live site this is always Live.
Click Save billing identity.
Billing identity on the Healthcode settings page
Two rules sit below these fields:
Require an authorisation code on every claim: off by default. Tick this if you never want a claim to go without one, even for insurers that do not ask.
Record insurer payments automatically when a statement line matches an invoice: on by default. When a payment statement arrives, each claim that matches an open invoice is recorded as the insurer's payment. Claims that need a decision are always left for you. Untick it if you would rather record every payment yourself.
Step 5: Add your practitioners' numbers
Every practitioner who treats insured clients needs the number Healthcode and insurers know them by.
Scroll to Practitioners on the Healthcode page. Each practitioner in your team has a row.
Click Edit on a practitioner.
The Practitioners list
In the practitioner's Healthcode details:
Healthcode provider: choose the practitioner from the people Healthcode lists for your site. This fills in their SP number where they have one.
SP number: Healthcode's specialist number, if the practitioner has one.
Regulatory body number: their registration number exactly as on the register, for example their HCPC number. For most practices this is the number Healthcode maps the practitioner by.
This practitioner is a payee: tick this and enter their payee number if insurers pay this practitioner directly under a number of their own.
Insurer provider numbers: only needed when an insurer has given the practitioner a specific provider number. Click Add an insurer number, choose the insurer and enter it. Where there is no entry for an insurer, the SP number is used, then the regulatory body number.
A practitioner's Healthcode details
Click Save and repeat for each practitioner.
Step 6: Give each appointment type a service code
Insurers are billed by industry standard code (ISC). Each appointment type you bill to insurers needs one.
Scroll to Services. A mapped appointment type shows its code and description.
Click Change code to change it.
Click Map code on an appointment type that shows Not mapped. A claim cannot be validated while one of its lines has no code.
Appointment types and their service codes
Either button opens the appointment type on its Payment tab:
Make sure you are on the Payment tab.
In Insurance service code (ISC), search by code or by words such as "physiotherapy" and pick the code your insurers accept.
Setting: leave it on Practice default, or choose a different setting for this appointment type, for example home visits.
Click Save Changes.
Choosing the service code for an appointment type
Which code? Insurers decide which codes they accept, and it varies between them. If Healthcode answers "Code not valid for insurer" when you validate a claim, you can set a different code for that one line on the claim without changing the appointment type.
Step 7: Add the client's insurance
Do this once for each insured client.
Open the client and go to Billing › Insurance.
Click Add policy.
Under Claim identity, check the client's given name, family name and sex. These must match what the insurer holds, which is not always what is on your client record.
Click Save claim identity.
A client's insurance policies and claim identity
In the Add policy dialog:
Choose the Insurer.
Enter the Membership number as printed on the membership card. Rehab Guru checks it against the insurer's format.
Add the Cover end date and Known excess if you know them. Scheme and group number are only needed where the insurer uses them.
Click Add policy.
Adding an insurance policy
If the client is covered by more than one insurer, add a policy for each. Rehab Guru asks which insurer a claim is for when you create it.
The client record must also have a date of birth and a postal address, as most insurers refuse a claim without them. Add these under Details.
Step 8: Add the diagnosis and authorisation to the case
Claims take their diagnosis and any insurer authorisation from the client's case, so every claim for that course of treatment is consistent.
Open the client's Cases tab and open the case (or click New case). In Diagnosis, search the ICD-9 list by code or words and choose the diagnosis. Several insurers, including Bupa and AXA Health, refuse a claim with no diagnosis.
If the insurer has authorised treatment, click Add under Authorisations and enter the authorisation code, the number of sessions and the dates it covers.
The case holds the diagnosis and insurer authorisations
Appointments linked to the case count against the authorised sessions, so you can see when an authorisation is nearly used up.
You're ready to claim
Setup is complete. To send a claim, issue the client's invoice as usual, then choose Create claim from the invoice's menu. Rehab Guru shows where every value on the claim came from, checks it with Healthcode when you click Validate, and tells you in plain words what to fix. The full process is in Claiming and Getting Paid Through Healthcode.











