Runbeam logo
Healthcare Messaging

HL7 v2 Connector

Bridge legacy healthcare messaging systems with modern integration. Parse, transform, and route HL7 v2 messages through secure pipelines.

The Challenge

HL7 v2 remains essential

Legacy Investment

Billions of dollars invested in HL7 v2 infrastructure. Replacing it overnight is neither practical nor cost-effective.

Modernisation Pressure

New applications expect FHIR and REST APIs. Bridging old and new requires transformation infrastructure.

Message Complexity

HL7 v2 messages are pipe-delimited text with complex nesting. Parsing and transforming reliably requires specialised tooling.

The Solution

HL7 v2 as a first-class citizen

Harmony's HL7 connector parses messages into JSON, enabling the same transformation and routing capabilities available for modern protocols.

Message Parsing

Parse HL7 v2 messages into structured JSON for transformation and routing.

Segment Handling

Access and modify individual segments (MSH, PID, OBR, OBX, etc.).

MLLP Support

Native Minimal Lower Layer Protocol for HL7 message transport.

HL7 to FHIR

Transform HL7 v2 messages to FHIR resources using declarative mappings.

# HL7 to FHIR bridge
[pipelines.hl7_to_fhir]
description = "Transform HL7 v2 ADT to FHIR Patient"
networks = ["mllp_net"]
endpoints = ["hl7_listener"]
middleware = ["hl7_parse", "adt_to_fhir"]
backends = ["fhir_api"]
# MLLP endpoint
[endpoints.hl7_listener]
service = "mllp"
peer_ref = "mllp_config"
# Backend
[backends.fhir_api]
service = "fhir"
target_ref = "emr_fhir"
Message Types

Common HL7 v2 message types

Route and transform any HL7 v2 message type through Harmony pipelines.

ADT

Admit, Discharge, Transfer - patient movement events

ORU

Observation Results - lab results, vital signs

ORM/OML

Orders - lab orders, radiology orders

SIU

Scheduling - appointment information

MDM

Medical Document Management - clinical documents

DFT

Detailed Financial Transaction - billing

BAR

Billing Account Record - patient accounts

VXU

Vaccination Update - immunisation records

Capabilities

Enterprise HL7 features

Message Parsing

Parse HL7 v2 messages into structured JSON for transformation and routing.

Segment Handling

Access and modify individual segments (MSH, PID, OBR, OBX, etc.).

MLLP Support

Native Minimal Lower Layer Protocol for HL7 message transport.

HL7 to FHIR

Transform HL7 v2 messages to FHIR resources using declarative mappings.

Message Routing

Route messages based on message type, sending facility, or field values.

ACK Generation

Automatic acknowledgement generation with configurable error handling.

Get Started

Modernise your HL7 infrastructure

Bridge legacy messaging with modern APIs. Request early access to the HL7 v2 connector.