HL7 v2 to FHIR Integration: A Robust Mapping Design
HL7 v2 β FHIR Integration - Rucel Tsafack
Summary
This article details a robust integration design for mapping HL7 v2 messages to FHIR R4 resources. The system addresses the fragility of point-to-point feeds by separating transport, parsing, and mapping, ensuring data integrity and traceability.
Details
This paper details a technical approach to solving the inherent fragility of point-to-point healthcare feeds, which suffer from implicit mappings and inconsistent error handling. The proposed reference design separates transport, parsing, mapping, and persistence, assigning an immutable trace ID to every message. The mapping process utilizes a typed intermediate event model rather than direct string transformation. Key technical decisions include keeping message validation errors distinct from recoverable mapping warnings and requiring local FHIR references to resolve before bundle emission. Security measures, such as terminating transport encryption before the integration boundary and redacting payloads from logs, are also incorporated. Testing using ADT^A01 and ORU^R01 demonstrated the stable generation of FHIR resources (e.g., Patient, Observation) with clear field lineage. The authors conclude that robust mapping relies on explicit contracts, replay safety, terminology boundaries, and observable failure modes, rather than complex conversion code.
Original content copyright by respective publishers