Healthcode Error Messages

Troubleshooting error messages when submitting invoices to Healthcode

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.

---

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

• Cause: 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).

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

• Cause: The insurance details of a patient may be incorrect.
• Solution: Check that the membership number provided by the patient is correct.

3. Healthcode API: Invalid Username/Password

• Cause: 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.

4. Healthcode API: Problem with ProcCode: Invalid Code

• Cause: The procedure code for the invoiced product is invalid or missing for the insurance provider.
• Solution:
  • Ensure that you have inserted an 'Industry Standard Code'.
  • Check that the procedure has a correct Industry standard code/CCSD code for the addressed insurance provider.
  • Verify that the code(s) in question was/were active code(s) for the Date of Service in question.
  • To verify the above, check the insurer’s online fee schedule or contact them directly if the CCSD is missing.
  • If the code is valid, email Healthcode's Coding team with:
    • The CCSD code
    • The procedure description
    • The name of the insurer being billed and the fact that you found the code on their fee schedule.

5. Healthcode API: Problem with Diagnosis: Code not Mapped

• Cause: 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.

6. Healthcode API: Problem with Diagnosis: Not Valid for Insurer

• Cause: 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.

7. Healthcode API: Problem with AuthCode: Invalid Format

• Cause: The authorization code for the patient's insurance details has been entered incorrectly.
• Solution: Edit the patient relationship with the insurance provider and amend the authorization code so that it is in the correct format.

8. Healthcode API: Problem with ProviderNo: Invalid Code

• Cause: There are two possible reasons:
  • 1) The Healthcode identifier inserted into your practitioner's user settings is incorrect.
  • 2) The entity is not recognized by the insurer being billed.
• Solution:
  • 1) Make sure you have inserted the practitioner's GMC number with a leading zero.
  • 2) Contact Healthcode about your account and ask them to set your account up so that it is recognized by the insurer.

9. Healthcode API: Problem with Payee No: Invalid Code

• Cause: There are two possible reasons:
  • 1) The Healthcode identifier inserted into your practitioner's user settings is incorrect.
  • 2) The entity is not recognized by the insurer being billed.
• Solution:
  • 1) Make sure you have inserted the practitioner's GMC number with a leading zero.
  • 2) Contact Healthcode about your account and ask them to set your account up so that it is recognized by the insurer.

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

• Cause: 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.

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

• Cause: This error occurs when the invoice issue date is before the date of the appointment.
• Solution: Edit the invoice to have the correct date.

12. Healthcode API: Provider not mapped

• Cause: 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.

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

• Cause: The procedure or appointment is in the future.
• Solution: Submit the invoice to Healthcode on the day of, or day after, the procedure.

14. Healthcode API: Problem with Insurer: Invalid Insurer

• Cause: 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.

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

• Cause: This relates to tariff validation where insurers validate the price being charged against contract prices.
• Solution: Log into your Healthcode ePractice site and set a fee up. Contact Healthcode for more information on how to do this.

16. Healthcode API: Problem with InvoiceNo: Duplicate Invoice

• Cause: The invoice has already been submitted to Healthcode.
• Solution: You do not need to submit this invoice to Healthcode again. Check the invoice's status to see if it has been 'Unprocessed'. If it has no status, contact the Semble Customer Success team and quote the invoice number for investigation.

17. Healthcode API: Invalid Request Format/Processing Error

• Cause: 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. Examples: apostrophes ( ' ), hyphens ( - ), at sign (@), and ampersands ( & ).

18. Healthcode API: BadRequestError: Error: getaddrinfo ENOTFOUND

• Cause: 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.

19. Healthcode API: BadRequestError: Error: Request failed with status code 502

• Cause: Healthcode is down.
• Solution: Contact Healthcode for more information.

20. Healthcode API: Access denied

• Cause: There is an issue with Healthcode's login services.
• Solution: Contact Healthcode for more information.

21. Healthcode API: Problem with NetTotal: Net total exceeds insurer tariff for service

• Cause: The insurer has a price threshold for that type of booking.
• Solution: We 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.

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

• Cause: Healthcode is failing to respond within 10 seconds of a request we send them.
• Solution: We suggest contacting Healthcode.

23. Healthcode API: Invalid SiteID

• Cause: Your site ID is not recognized or your password is incorrect.
• Solution: We suggest contacting Healthcode to verify your site ID and/or password.

24. The specified practitioner is not configured to Healthcode

• Cause: The practitioner identifier code (which relates to the person you put on the Semble invoice as the Controlling Specialist) isn’t mapped on the Healthcode system or they’re mapped but not recognized by the insurer.
• Solution:
  • The practitioner’s name
  • Their regulatory/professional body code (e.g., GMC number)
  • The practitioner identifier (the code listed in the Controlling Spec. field)
  • The name of the insurer being invoiced.If the practitioner isn’t mapped: Please contact the Healthcode Customer Services team – they’ll need the following details:

25. Healthcode Error: Result Element is Missing or Not a Number

• Cause: This occurs when the Healthcode identifier is missing for the insurer you're trying to invoice.
• Solution: Go to the insurer’s contact details, add the correct Healthcode identifier, and retry submitting the invoice.

26. Healthcode API: Membership No: Patient demographics do not match registration number

• Cause: The patient’s details (name and date of birth) do not match the insurer’s database.
• Solution: Double-check the spelling of names and the date of birth. Verify with the patient or insurer that all information is correct, including any missing details (e.g., middle name).

27. Error: Specialist: Invalid Code

• Cause: This error could be due to a recognition issue with the insurer or if you haven’t been added to the list of allowed billers.
• Solution: If you have a PPR profile, check your recognition status with the insurer. If you're not recognized or "pending," contact the insurer directly. If you don’t have a PPR profile, contact Customer Services to request mapping to the insurer.

28. Error: Bill: Latest service date on bill exceeds maximum invoice age

• Cause: The invoice was not submitted within the insurer’s required timeframe.
• Solution: Contact the insurer directly for their exact timeframe.