Integrating HL7 with Spok Go

Overview

This article describes the process for integrating HL7 with Spok Go to allow the receiving of orders and results messages and routing these messages and their contents to the appropriate users, roles, and workflows.

HL7  Flow Diagram

Before you Begin

• Ensure you followed the HL7 specifications outlined in the interface specifications documents below:
  • HL7 Interface Specifications - ORM General Order Message.pdf
  • HL7 Interface Specifications - ORU Observation Results.pdf
  • HL7 Interface Specifications - ORA Observation Report Alert Acknowledgements.pdf
• Ensure the on-premises gateway is installed and configured. See Installing and Configuring the On-Premises Gateway for more information.

Adding the HL7 Integration to a Gateway

1. In Spok Go, click Administration > Integration > Gateways.

2. Click the Gateway for the HL7 connector and click the Gateway Services tab.

3. Enable HL7 Inbound by sliding the toggle and click Save.

4. If HL7 outbound is needed, enable HL7 Outbound by sliding the toggle and click Save.
5. Enter the following:

   Host	hostname or IP address of the HL7 device that PCD 05 messages will be sent to.  Usually it is the device that originates PCD 04 messages.
   Port	Port number used for outbound HL7 connection.
   Use TLS	Enable if TLS is used for the outbound HL7 connection.
   Include Patient/Visit info in ORA-R41 messages	Enable to include patient or visit info in ORA-R41 messages.

The HL7 integration is now enabled on the gateway, and HL7 messages can now be sent to the gateway using the IP address of your load balancer via TCP on port 18001 and/or via TLS on port 18002.

Related Links

• HL7 Workflow Alert Mapping Guide - This page describes the relationship between the HL7 Interface, Workflows, and the subsequent Alerts.
• HL7 Interface Specifications  - This page describes the currently supported source systems. 
• Key Critical Test Result Alert Field Descriptions - These pages provide examples and descriptions of key fields in Lab / Rad Results alerts as well as the source of the information displayed in these fields based on the platform being used.
  • iOS
  • Android
  • Web