--- id: hl7-v2-to-fhir type: Specification type_label: Standaard of specificatie title: HL7 Version 2 to FHIR aliases: - v2-to-FHIR - V2 to FHIR - v2mappings - hl7.fhir.uv.v2mappings names: nl: HL7 Version 2 to FHIR fr: HL7 Version 2 to FHIR en: HL7 Version 2 to FHIR de: HL7 Version 2 to FHIR jurisdiction: - internationaal themes: - architectuur-en-infrastructuur - standaardisatie-en-governance lifecycle: trial-use lifecycle_note: Versie 1.0.0 (STU1, FHIR R4), gepubliceerd op 7 oktober 2025, is de huidige versie; het project mikt op een latere normatieve status. version: 1.0.0 (STU1, 2025-10-07) summary: HL7 Version 2 to FHIR is een implementatiegids van HL7 International die beschrijft hoe berichten, segmenten, datatypes en codetabellen uit HL7 versie 2 worden omgezet naar FHIR R4. Versie 1.0.0, een STU1-publicatie van oktober 2025, is de huidige versie. De mapping geldt cumulatief over alle v2-versies, vertrekt van de basisstandaard en neemt lokale Z-gegevens en afwijkende varianten niet op. De eerste focus ligt op veelgebruikte stromen zoals ADT, orders, resultaten en vaccinaties. links: - soort: documentatie url: https://hl7.org/fhir/uv/v2mappings/ label: HL7 Version 2 to FHIR (STU1) taal: en - soort: documentatie url: https://hl7.org/fhir/uv/v2mappings/introduction.html label: HL7 Version 2 to FHIR, inleiding en afbakening taal: en last_verified: '2026-11-12' relations: - type: ownedBy direction: uit target: hl7-international target_url: https://ehealth-atlas.be/hl7-international/ status: established - type: dependsOn direction: uit target: hl7-v2 target_url: https://ehealth-atlas.be/hl7-v2/ status: established - type: dependsOn direction: uit target: fhir target_url: https://ehealth-atlas.be/fhir/ status: established release: 2026.11.13-2 url: https://ehealth-atlas.be/hl7-v2-to-fhir/ license: CC BY 4.0 --- # HL7 Version 2 to FHIR HL7 Version 2 to FHIR is een implementatiegids van HL7 International die beschrijft hoe berichten, segmenten, datatypes en codetabellen uit HL7 versie 2 worden omgezet naar FHIR R4. Versie 1.0.0, een STU1-publicatie van oktober 2025, is de huidige versie. De mapping geldt cumulatief over alle v2-versies, vertrekt van de basisstandaard en neemt lokale Z-gegevens en afwijkende varianten niet op. De eerste focus ligt op veelgebruikte stromen zoals ADT, orders, resultaten en vaccinaties. ## Wat is het? HL7 Version 2 to FHIR is een implementatiegids die mappings beschrijft van [HL7 v2](https://ehealth-atlas.be/hl7-v2/)-berichten, -segmenten, -datatypes en -vocabularium naar [FHIR](https://ehealth-atlas.be/fhir/) R4-bundels, -resources, -datatypes en -codesystemen[^1]. Een mapping zegt hier per v2-element welk FHIR-element het wordt; de software die de omzetting uitvoert, staat er niet in. De gids komt van [HL7 International](https://ehealth-atlas.be/hl7-international/) en is gebaseerd op FHIR R4[^1]. De eerste focus ligt op veelgebruikte v2-berichtstructuren zoals ADT, orders, resultaten en vaccinaties[^2]. ## Hoe is het opgebouwd? ### Versie en status Release 1.0.0, gedateerd 7 oktober 2025, is de STU1-publicatie van de gids[^3] en de huidige gepubliceerde versie[^1]. STU (Standard for Trial Use) betekent dat de inhoud nog op ervaring uit gebruik wacht; het project mikt uiteindelijk op een normatieve status van de mappings[^2]. ### Afbakening De mapping is cumulatief en niet gebonden aan één v2-versie of één implementatiegids; het project startte bij v2.9[^1]. Ze vertrekt van de basisstandaard en houdt geen rekening met beperkingen uit specifieke HL7-implementatiegidsen of met lokale varianten die niet conform de basisstandaard zijn[^2]. Z-gegevens, dus lokale berichten, triggerevents, segmenten en datatypes, worden niet opgenomen[^2]. De gids erkent zelf waarom dat ertoe doet: reële v2-implementaties zijn divers en gebruiken uiteenlopende codes om betekenis over te brengen[^4]. Wie een concrete stroom omzet, moet de basismapping dus aanvullen met de lokale profilering die op [HL7 v2: dialecten en conformanceprofielen](https://ehealth-atlas.be/hl7-v2-conformance/) beschreven staat, zoals de nationale extensies van [IHE PAM](https://ehealth-atlas.be/ihe-pam/). ## Waar wordt het gebruikt? Belgisch gebruik van de gids werd in de verwerkte bronnen niet gevonden. Omzetting van v2 naar FHIR gebeurt in de praktijk in integratiesoftware: de $convert-data-operatie van de Azure FHIR-service zet onder meer HL7v2-gegevens naar FHIR R4 om[^5], en InterSystems Health Connect bevat ingebouwde transformaties tussen FHIR en HL7 v2[^6]. Of die producten de mappings van deze gids volgen, staat niet in de verwerkte bronnen; zie [Integratie-engine (interface engine)](https://ehealth-atlas.be/integratie-engine/). ## Wat betekent het voor een ziekenhuis? Een ziekenhuis dat intern v2 gebruikt en extern FHIR moet leveren, vindt hier een gedeelde basis voor de omzetting van ADT-, order- en resultaatberichten[^2]. De gids dekt echter geen Z-segmenten[^2] en geen lokale afwijkingen[^2], en de status is nog trial-use[^3]. **Aanbeveling:** vraag een leverancier van een integratie-engine of FHIR-gateway of de v2-naar-FHIR-omzetting de STU1-mappings volgt, en documenteer de eigen aanvullingen voor Z-segmenten en lokale codes apart. ## Onzekerheden en tegenstrijdige informatie - **Status op termijn.** Normatieve status is een doel van het project, zonder datum[^2]; tot dan kan een volgende STU-versie mappings wijzigen. ## Relaties - valt onder verantwoordelijkheid van: [HL7 International](https://ehealth-atlas.be/hl7-international/) (vastgesteld)[^1][^3]. Implementatiegids van HL7 in de internationale (uv) reeks. - hangt technisch af van: [HL7 versie 2](https://ehealth-atlas.be/hl7-v2/) (vastgesteld)[^1]. Bron van de mapping, cumulatief over de v2-versies. - hangt technisch af van: [HL7 FHIR](https://ehealth-atlas.be/fhir/) (vastgesteld)[^1]. Doel van de mapping is FHIR R4. ## Open vragen - Gebruiken Belgische integratie-engines of FHIR-gateways de STU1-mappings, bijvoorbeeld voor ADT- of laboberichten naar FHIR? - Hoe vertaal je de Belgische v2-praktijk (Z-segmenten, lokale codes) bovenop de basismappings, en is daar een gedeelde aanpak voor? ## Bronnen [^1]: [HL7 Version 2 to FHIR - Home](https://hl7.org/fhir/uv/v2mappings/). HL7 International. Opgehaald 2026-11-12, sha256 6c6dd4bca1f62260… (SRC-f3a21c39fb) [^2]: [HL7 Version 2 to FHIR - Introduction](https://hl7.org/fhir/uv/v2mappings/introduction.html). HL7 International. Opgehaald 2026-11-12, sha256 5b41995254f920d2… (SRC-e36e67809d) [^3]: [HL7 Version 2 to FHIR - package-list.json (publicatiegeschiedenis)](https://hl7.org/fhir/uv/v2mappings/package-list.json). HL7 International. Opgehaald 2026-11-12, sha256 3ce0f639ab67b474… (SRC-e3263d4063) [^4]: [HL7 Version 2 to FHIR - Implementation Considerations](https://hl7.org/fhir/uv/v2mappings/implementation_considerations.html). HL7 International. Opgehaald 2026-11-12, sha256 6ef4463188d91cd7… (SRC-f3c6e0ad3c) [^5]: [Convert health data with $convert-data in FHIR](https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/convert-data-overview). Microsoft. Opgehaald 2026-09-28, sha256 04b0cbc7fddba376… (SRC-b98c0fb8ce) [^6]: [InterSystems Health Connect Overview](https://docs.intersystems.com/healthconnectlatest/csp/docbook/DocBook.UI.Page.cls?KEY=AHXHCOVW). InterSystems. Opgehaald 2026-09-28, sha256 afa5d0ca23c8e198… (SRC-b870d6655c)