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:

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. 

Solution: Revert the medical back to Processing > open the HL7 message > click Update HL7 message.  Lab results will then import.

Partially imported

If one or more results in an HL7 message are in an unsupported format, those results will be marked as Pending FHM review. Our team is alerted to results requiring review and assesses them daily.  This status does not prevent the HL7 message from importing; however, individual results in an unsupported format will not import, while results in a supported format will import as normal.

Solution: Full Health support team reviews the HL7 message and informs providers if action is required on their part.

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.