See below for a list of error messages you might encounter when attempting to submit a Healthcode invoice, and how to fix them. Error messages appear in the top right-hand corner of the screen when a Healthcode invoice fails to submit.

Note: If the solution includes reaching out to the insurance company, you must directly speak to their Contracts Team about your issue.


Healthcode API: Problem with Setting: Must be I, D or O

The type of Healthcode invoice has not been set correctly.

Solution: You need to set the invoice type to be either:

  • Inpatient (I)

  • Daycase (D)

  • Outpatient (O).


Healthcode API: Problem with RegistrationNo: No matching membership details can be found

The insurance details of a patient may be incorrect.

Solution: Check that the membership number provided by the patient is correct.


Healthcode API: Invalid Username/Password

Your Healthcode credentials may be incorrect.

Solution: Check that you have correctly typed in your Healthcode credentials into Semble. If these are correct, then contact Healthcode to have new credentials generated.


Healthcode API: Problem with ProcCode: Invalid Code

The procedure code for the invoiced product is invalid for the insurance provider.

Solution: Ensure that your procedure has a correct Industry standard code/CCSD code for the addressed insurance provider. You can amend this by going to the Products page and editing your procedure to have the following Healthcode configuration:


Healthcode API: Problem with Diagnosis: Code not Mapped

The primary diagnosis selected is not valid for the addressed insurance provider.

Solution: Select a primary diagnosis that is accepted by the insurance provider. Contact the insurance provider for a list of their accepted diagnoses.


Healthcode API: Problem with Diagnosis: Not Valid for Insurer

The primary diagnosis selected is not valid for the addressed insurance provider.

Solution: Select a primary diagnosis that is accepted by the insurance provider. Contact the insurance provider for a list of their accepted diagnoses.


Healthcode API: Problem with AuthCode: Invalid Format

The authorisation code for the patient's insurance details has been entered incorrectly.

Solution: Edit the patient relationship with the insurance provider and amend the authorisation code so that it is in the correct format:


Healthcode API: Problem with ProviderNo: Invalid Code

There are two causes of this error:

1) The Healthcode identifier inserted into your practitioner's user settings is incorrect.

Solution: Make sure you have inserted the details correctly. This will be the practitioner's GMC number with the number 0 at the front.

2) The entity is not recognised by the insurer being billed.

Solution: Contact Healthcode about your account and ask them to set your account up so that it is recognised by the insurer.


Healthcode API: Problem with payee no: Invalid code

There are two causes of this error:

1) The Healthcode identifier inserted into your practitioner's user settings is incorrect.

Solution: Make sure you have inserted the details correctly. This will be the practitioner's GMC number with the number 0 at the front.

2) The entity is not recognised by the insurer being billed.

Solution: Contact Healthcode about your account and ask them to set your account up so that it is recognised by the insurer.


Healthcode API: Problem with ServiceCode: Code not valid for insurer

The industry standard code for the product is not accepted by the insurance provider.

Solution: Go to the Products page, and edit the product to have a valid industry standard code for the insurance provider. Make the edits in the Healthcode section.


Healthcode API: Problem with ValidToDate: May not be before the latest date of service

This error is related to the invoice issue date being before the date of the appointment.

Solution: Edit the invoice to have the correct date.


Healthcode API: provider not mapped

The payee provider or provider of the service selected is not mapped to your Healthcode account.

Solution: Contact Healthcode to ask them to map the provider to your Healthcode account.


Healthcode API: Problem with FDOS: May not be after Today

The procedure or appointment is in the future.

Solution: Submit the invoice to Healthcode on the day of, or day after, the procedure


Healthcode API: Problem with Insurer: Invalid Insurer

The insurance provider contact does not have a Healthcode identifier.

Solution: Go to the Contacts page, and edit the insurance provider to have the correct Healthcode identifier. Make these edits in the Healthcode section.


Healthcode API: Problem with ServiceCode: The insurer you're billing requires an agreed fee for this service prior to billing

This relates to tariff validation. Some insurers validate the price being charged for services against the contract prices, so they don’t receive invoices that they will have to shortfall.

Solution: Log into your Healthcode ePractice site and set a fee up in there. Contact Healthcode for more information on how to do this.


Healthcode API: Problem with InvoiceNo: Duplicate Invoice

The invoice has already been submitted to Healthcode.

Solution: You do not need to submit this invoice to Healthcode again as it will have already gone through. Check the invoice's status to see if it has been 'Unprocessed'. If it has no status, then contact the Semble Customer Success team, and quote the invoice number so that this can be investigated. For more information on Healthcode statuses see here.


Healthcode API: Invalid Request Format/Processing Error

The invoice you are submitting has incorrect formatting, or may be using invalid characters.

Solution: Check the patient record and integration details in settings for any invalid characters. For example, you can not use apostrophes ( ' ), hyphens ( - ), at sign (@) and ampersands ( & ).


Healthcode API: BadRequestError: Error: getaddrinfo ENOTFOUND

Healthcode is down and there is a problem with the external DNS record for www.services.healthcode.co.uk

Solution: Contact Healthcode for more information.


Healthcode API: Bad-RequestError: Error: Request failed with status code 502

Healthcode is down.

Solution: Contact Healthcode for more information.


Healthcode API: Access denied

There is an issue with Healthcode's login services.

Solution: Contact Healthcode for more information.


Healthcode API: Problem with NetTotal: Net total exceed insurer tariff for service

It appears that the insurer has a price threshold for that type of booking.

Solution: We would recommend contacting the insurer directly to confirm the price threshold. Once you have this information from the insurer, kindly change the price in the 'Products' section and edit your invoice with the updated product.


Healthcode API: BadRequestError: Error: timeout of 10000ms exceeded

It appears Healthcode are failing to respond within 10 seconds of a request we send them.

Solution: We suggest contacting Healthcode

Did this answer your question?