HL7 v2.x Integration release notes
Summarize
Summary of HL7 v2.x Integration release notes
The ServiceNow® HL7 v2.x Integration application, introduced in the Australia release, enhances healthcare interoperability by enabling seamless reception, parsing, and processing of HL7 v2.x messages from Electronic Health Record (EHR) systems. It works in conjunction with the HL7 v2.x Inbound REST API to provide a standards-compliant endpoint for receiving HL7 messages and returning acknowledgment responses without requiring custom scripting on integration engines.
Show less
Key Features
- HL7 v2.x Inbound REST API: Receives raw HL7 v2.x ADT messages over HTTP using the HAPI HL7-over-HTTP convention, processes pipe-delimited ER7 message bodies, and returns standard acknowledgment (ACK) responses.
- HL7 Message Log: Stores every inbound message with its raw payload, ACK response, metadata (including message type, trigger event, sending application, facility, and control ID), and processing status. Metadata is queryable and usable as trigger conditions in Flow Designer workflows.
- Configurable Parser Profiles: Automatically parses raw HL7 v2.x messages into structured JSON (parseddata) using no-code parser configurations that define which segments and fields to extract and their output paths.
- Demo Parser Configurations: Provides editable, ready-to-use parser configurations for common ADT message types—A01 (Admit), A02 (Transfer), A03 (Discharge), and A08 (Update)—covering key segments like EVN, PID, and PV1 to accelerate hospital workflow automation.
- Easy Activation: Available as a separate application from the ServiceNow Store, enabling customers to request and install it on their instances for immediate use.
Practical Benefits for ServiceNow Customers
- Enables direct receipt and processing of HL7 v2.x messages within ServiceNow without requiring specialized HL7 knowledge or custom scripting on external integration engines.
- Facilitates automation of hospital workflows such as patient admission, transfer, discharge, and updates by converting complex HL7 messages into usable structured data.
- Supports integration with Healthcare Operations applications like bed management, room turnover, equipment coordination, and scheduling by triggering workflows based on parsed HL7 data.
- Extends the Healthcare and Life Sciences Service Management platform by enabling HL7-driven updates to healthcare service records through parsed message data.
The ServiceNow® HL7 v2.x Integration application works alongside the HL7 v2.x Inbound REST API to provide a standards-compliant endpoint for receiving HL7 v2.x messages from integration engines, a configurable parser for converting raw messages into structured workflow data, and out-of-the-box support for common ADT message types. HL7 v2.x Integration is a new application in the Australia release.
HL7 v2.x Integration highlights for the Australia release
- Works alongside the HL7 v2.x Inbound REST API to receive HL7 v2.x messages from EHR systems over HTTP and return standards-compliant acknowledgment responses.
- Receive raw HL7 v2.x messages directly in ServiceNow and automatically return standards-compliant ACK responses — with no custom scripting on the integration engine side.
- Parse raw HL7 v2.x messages into structured JSON on the message log using a configurable, no-code parser, enabling hospital workflow automation without HL7 v2.x expertise.
- Demo parser configurations for ADT A01 (Admit), A02 (Transfer), A03 (Discharge), and A08 (Update) provide ready-to-edit starting points for the most common hospital ADT workflows.
HL7 v2.x Integration features
- HL7 v2.x Inbound REST API
- The HL7 v2.x Inbound REST API receives inbound HL7 v2.x ADT messages from EHR systems over HTTP and returns standard HL7 v2.x acknowledgment responses. It implements the HAPI HL7-over-HTTP convention, accepting raw pipe-delimited ER7 message bodies and processing them against configured parser profiles.
- HL7 message log
- Every inbound HL7 v2.x message is stored with its raw payload, ACK response, message metadata (type, trigger event, sending application and facility, message control ID), and processing status. Metadata fields are queryable and available as Flow Designer trigger conditions.
- Parser configurations
- When a message is received, ServiceNow parses it with the matching parser configuration and writes the extracted values to the message log record's structured JSON (
parsed_data). Parser configurations define which segments and fields to extract and the output path for each value. - Demo parser configurations
- Demo parser configurations for ADT A01, A02, A03, and A08 are available when you load demo data, covering the EVN, PID, and PV1 segments. They are editable, and you can clone them for hospital-specific customization.
Activation information
HL7 v2.x Integration is distributed as a separate application through the ServiceNow Store. Request the application from the ServiceNow Store and install it to activate it on your instance.
Plugin information
- New plugins
-
The following plugins are new in Australia:
HL7 v2.x Integration (
com.sn_hl7_v2): Provides native HL7 v2.x message reception, parsing, and workflow integration capabilities for ServiceNow Healthcare Operations.