Troubleshooting failed HL7 message imports

Full Health automatically adjusts the interpretation of test results by importing reference ranges specific to each test type in an HL7 message. This dynamic feature ensures accurate interpretation of results based on the individual reference ranges provided.

HL7 messages will fail to import in instances where reference range data for any individual test type is not included or if a result is provided in an unsupported format.

Failed imports will be clearly identified in the message status, informing users of the specific reason for the import failure. Common reasons for failure include:

Pending FHM review

If one or more results in the HL7 message are in an unsupported format, the Pending FHM review status will be triggered. Our team is promptly notified of messages with this status and will review them daily.

Solution: Full Health support team reviews the HL7 message.

If there is any delay in the review of a Pending FHM review message, please reach out to us at support@fullhealthmedical.com for assistance.

Invalid HL7

If the Full Health support team reviews an HL7 message and determines that the result format cannot be processed, it will be marked as Invalid. In this scenario, it will be essential for a healthcare provider to contact the laboratory to rectify any issues with the result format and resend the HL7 message.

Solution: The healthcare provider contacts the lab to correct and resend the HL7 message.

No person match

This situation arises when there is a difference between the client information stored in the system and the details provided in the HL7 message. This difference can be due to errors in the client's name, sex at birth or date of birth.

Open the HL7 Message to review the Message Details. Refer to the Knowledge Base article, How to Access HL7 Messages, if you are unsure how. 

• Client name errors: These most commonly occur if a name contains a space, accent or apostrophe. To correct spelling or format errors in a client name:
  • Solution: Open the HL7 message > correct the error > click Update HL7 message. The lab results will then be imported.

• FH reference: FH reference is a required field. If it is missing or incorrect, the HL7 message cannot match.

  • Solution: Open the HL7 message > correct or input the FH reference > click Update HL7 message. The lab results will then be imported.
• Gender or date of birth: A client’s date of birth and/or sex at birth must match the client details on FHM. If either detail is missing or incorrect, the HL7 message cannot match.
  • Solution: Contact the laboratory to correct any errors and resend the message.

 No Medical Match

 This indicates that the system has found a client matching the criteria, but their medical is not in processing. This can occur if a medical has been cancelled or progressed before lab results are imported.

Open the HL7 Message to review the Message Details. Refer to the Knowledge Base article, How to Access HL7 Messages, if you are unsure how.