Creating a QRY-ADR HL7 Interface with Mirth Connect

Creating a QRY-ADR HL7 Interface with Mirth Connect

In healthcare interoperability, certain HL7 message types play crucial roles in querying and responding to patient information. This article will guide you through understanding and implementing a QRY-ADR HL7 interface using Mirth Connect. We'll cover what QRY and ADR messages are, the objective of this interface, and provide a step-by-step example using Mirth Connect to handle a scenario where a healthcare system queries patient records in an EMPI (Enterprise Master Patient Index) system like Rhapsody.

What is a QRY and ADR HL7 Message?

• QRY (Query) Message: An HL7 message used to request specific information from another system. For example, a healthcare system may send a QRY message to find out if a particular patient exists in another system's database.

• ADR (Query Response) Message: An HL7 message sent in response to a QRY message, providing the requested information. For example, it could confirm whether the patient exists and return relevant patient details if available.

Objective of the Interface

The primary objective of a QRY-ADR HL7 interface is to facilitate patient lookup operations. The source system queries the destination system to check if a patient exists, and the destination system responds with an ADR message indicating the presence or absence of the patient. This interface is particularly useful for maintaining an accurate and up-to-date patient index across multiple systems.

Example Scenario: Handling QRY-ADR with Mirth Connect

Imagine a scenario where a healthcare system needs to check patient records in an EMPI system like Rhapsody. The interface will use a TCP Receiver to accept QRY messages and a TCP Sender to send these messages to the EMPI system. Upon receiving the QRY message, the EMPI system will return an ADR message, which must be sent back to the original source system.

Here's how to achieve this in Mirth Connect:

Step 1: Set Up the Channel

1. Create a New Channel: In Mirth Connect, create a new channel and name it appropriately, e.g., "QRY-ADR Interface".

2. Source Connector: Configure the source connector as a TCP Listener.

   • Connector Type: TCP Listener

   • Data Type: HL7 v2.x

   • Port: (Specify the port number to listen for incoming QRY messages)

3. Destination Connector: Configure the destination connector as a TCP Sender.

   • Connector Type: TCP Sender

   • Data Type: HL7 v2.x

   • Address: (Specify the address of the EMPI system)

   • Port: (Specify the port number to send QRY messages to the EMPI system)

Step 2: Handle the QRY Message

1. Transformer: Use the transformer to process the incoming QRY message if any modifications or validations are required before sending it to the destination system.

Step 3: Configure the Postprocessor

1. Postprocessor Script: To handle the ADR response, use the Postprocessor feature in Mirth Connect. This script will capture the ADR response from the destination system and send it back to the source system.

// Postprocessor Script

var responseADR = responseMap.get('key');

return responseADR;

2. Response Configuration: Configure the source connector to use the Postprocessor script in the Response settings.

Step 4: Test the Interface

1. Deploy the Channel: Deploy the newly created channel.

2. Send Test QRY Message: Send a test QRY message from the source system.

3. Verify ADR Response: Verify that the ADR response from the EMPI system is correctly received and sent back to the source system.

Sample QRY and ADR Messages

QRY Message Example:

MSH|^~\&|SourceSystem|SendingFacility|EMPI|ReceivingFacility|202412080930||QRY^A19^QRY_A19|123456|P|2.5 QRY|202412080930|R|I|123456|||RES||^SNE^SENSORIA^|DEM

ADR Message Example:

MSH|^~\&|EMPI|ReceivingFacility|SourceSystem|SendingFacility|202412080932||ADR^A19^ADR_A19|123456|P|2.5 MSA|AA|123456 QRY|202412080930|R|I|123456|||RES||^SNE^SENSORIA^|DEM PID|1||123456^^^EMPI^MR||Doe^John^^^Mr.||19800101|M|||123 Main St^^Somecity^CA^12345^USA||555-555-5555|||M||123456||987654321

By following these steps, you can effectively set up a QRY-ADR HL7 interface using Mirth Connect. This interface enables seamless patient lookup operations, ensuring that patient information is accurately queried and retrieved across different healthcare systems.

If you want the channel export for this interface, please drop an email to contact@synfinisolutions.com. Reach out to us to plan your seamless integration that is robust, secure, and effective.

For more information and services related to healthcare IT interoperability, visit Synfini Solutions.

#HL7 #HealthcareIT #Interoperability #MirthConnect #PatientLookup #QRYADR #HealthcareIntegration #SynfiniSolutions