{ "id": "hl7-v2-to-fhir", "url": "/hl7-v2-to-fhir/", "md_url": "/hl7-v2-to-fhir.md", "json_url": "/hl7-v2-to-fhir.json", "claims_url": "/hl7-v2-to-fhir/beweringen/", "type": { "code": "Specification", "label": "Standaard of specificatie" }, "schema_type": "CreativeWork", "lang": "nl", "translation": null, "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": [ { "code": "internationaal", "label": "Internationaal" } ], "themes": [ { "code": "architectuur-en-infrastructuur", "label": "Architectuur en infrastructuur" }, { "code": "standaardisatie-en-governance", "label": "Standaardisatie en governance" } ], "lifecycle": { "code": "trial-use", "label": "trial-use" }, "lifecycle_note_html": "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)", "vendor": null, "sectors": [], "homologations": [], "links": [ { "kind": { "code": "documentatie", "label": "Documentatie" }, "url": "https://hl7.org/fhir/uv/v2mappings/", "label": "HL7 Version 2 to FHIR (STU1)", "host": "hl7.org", "lang": "en" }, { "kind": { "code": "documentatie", "label": "Documentatie" }, "url": "https://hl7.org/fhir/uv/v2mappings/introduction.html", "label": "HL7 Version 2 to FHIR, inleiding en afbakening", "host": "hl7.org", "lang": "en" } ], "summary_text": "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.", "summary_html": "

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.

", "last_verified": "2026-11-12", "verification_outdated": false, "sections": [ { "id": "wat-is-het", "title": "Wat is het?", "kind": "tekst", "html": "

HL7 Version 2 to FHIR is een implementatiegids die mappings beschrijft van HL7 v2-berichten, -segmenten, -datatypes en -vocabularium naar 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 en is gebaseerd op FHIR R4[1].

\n

De eerste focus ligt op veelgebruikte v2-berichtstructuren zoals ADT, orders, resultaten en vaccinaties[2].

" }, { "id": "hoe-is-het-opgebouwd", "title": "Hoe is het opgebouwd?", "kind": "tekst", "html": "

Versie en status

\n

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].

\n

Afbakening

\n

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].

\n

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 beschreven staat, zoals de nationale extensies van IHE PAM.

" }, { "id": "waar-wordt-het-gebruikt", "title": "Waar wordt het gebruikt?", "kind": "tekst", "html": "

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).

" }, { "id": "wat-betekent-het-voor-een-ziekenhuis", "title": "Wat betekent het voor een ziekenhuis?", "kind": "tekst", "html": "

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].

\n

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.

" }, { "id": "onzekerheden-en-tegenstrijdige-informatie", "title": "Onzekerheden en tegenstrijdige informatie", "kind": "tekst", "html": "" } ], "relation_groups": [ { "type": "ownedBy", "direction": "uit", "label": "valt onder verantwoordelijkheid van", "relations": [ { "direction": "uit", "type": "ownedBy", "label": "valt onder verantwoordelijkheid van", "other": { "id": "hl7-international", "title": "HL7 International", "url": "/hl7-international/" }, "status": "established", "status_label": "vastgesteld", "note_html": "Implementatiegids van HL7 in de internationale (uv) reeks.", "valid_from": null, "valid_to": null, "historical": false, "refs": [ 1, 3 ] } ] }, { "type": "dependsOn", "direction": "uit", "label": "hangt technisch af van", "relations": [ { "direction": "uit", "type": "dependsOn", "label": "hangt technisch af van", "other": { "id": "hl7-v2", "title": "HL7 versie 2", "url": "/hl7-v2/" }, "status": "established", "status_label": "vastgesteld", "note_html": "Bron van de mapping, cumulatief over de v2-versies.", "valid_from": null, "valid_to": null, "historical": false, "refs": [ 1 ] }, { "direction": "uit", "type": "dependsOn", "label": "hangt technisch af van", "other": { "id": "fhir", "title": "HL7 FHIR", "url": "/fhir/" }, "status": "established", "status_label": "vastgesteld", "note_html": "Doel van de mapping is FHIR R4.", "valid_from": null, "valid_to": null, "historical": false, "refs": [ 1 ] } ] } ], "relation_count": 3, "hypothesis_count": 0, "neighbours": [ { "id": "hl7-international", "title": "HL7 International", "url": "/hl7-international/", "type": { "code": "Organization", "label": "Organisatie" }, "status": "established" }, { "id": "hl7-v2", "title": "HL7 versie 2", "url": "/hl7-v2/", "type": { "code": "Specification", "label": "Standaard of specificatie" }, "status": "established" }, { "id": "fhir", "title": "HL7 FHIR", "url": "/fhir/", "type": { "code": "Specification", "label": "Standaard of specificatie" }, "status": "established" } ], "open_questions_html": [ "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?" ], "open_questions": [ { "id": "oq-06f005", "html": "Gebruiken Belgische integratie-engines of FHIR-gateways de STU1-mappings, bijvoorbeeld voor ADT- of laboberichten naar FHIR?", "text": "Gebruiken Belgische integratie-engines of FHIR-gateways de STU1-mappings, bijvoorbeeld voor ADT- of laboberichten naar FHIR?" }, { "id": "oq-939ee3", "html": "Hoe vertaal je de Belgische v2-praktijk (Z-segmenten, lokale codes) bovenop de basismappings, en is daar een gedeelde aanpak voor?", "text": "Hoe vertaal je de Belgische v2-praktijk (Z-segmenten, lokale codes) bovenop de basismappings, en is daar een gedeelde aanpak voor?" } ], "exchanges": [], "sources": [ { "n": 1, "id": "SRC-f3a21c39fb", "title": "HL7 Version 2 to FHIR - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/", "published": null, "first_retrieved": "2026-11-12T20:00:37+00:00", "last_checked": "2026-11-12T20:00:37+00:00", "content_sha256": "6c6dd4bca1f622603c73b314e7d0ce1291c8bb0004eecd280c15faed48caed52", "link_unreachable_since": null }, { "n": 2, "id": "SRC-e36e67809d", "title": "HL7 Version 2 to FHIR - Introduction", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/introduction.html", "published": null, "first_retrieved": "2026-11-12T20:00:38+00:00", "last_checked": "2026-11-12T20:00:38+00:00", "content_sha256": "5b41995254f920d2dbcc4f662dccd303f2640c15307c019bb9cfeee220fbae89", "link_unreachable_since": null }, { "n": 3, "id": "SRC-e3263d4063", "title": "HL7 Version 2 to FHIR - package-list.json (publicatiegeschiedenis)", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/package-list.json", "published": null, "first_retrieved": "2026-11-12T20:00:42+00:00", "last_checked": "2026-11-12T20:00:42+00:00", "content_sha256": "3ce0f639ab67b47475edcb19a01630635c66e9a0d4593b5dce9e0ad4aa2d63de", "link_unreachable_since": null }, { "n": 4, "id": "SRC-f3c6e0ad3c", "title": "HL7 Version 2 to FHIR - Implementation Considerations", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/implementation_considerations.html", "published": null, "first_retrieved": "2026-11-12T20:00:40+00:00", "last_checked": "2026-11-12T20:00:40+00:00", "content_sha256": "6ef4463188d91cd74987b59328af1d1b3b0f629c4f5c4e046da7e4a34075a005", "link_unreachable_since": null }, { "n": 5, "id": "SRC-b98c0fb8ce", "title": "Convert health data with $convert-data in FHIR", "publisher": "Microsoft", "url": "https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/convert-data-overview", "published": null, "first_retrieved": "2026-09-28T13:34:34+00:00", "last_checked": "2026-09-28T13:34:34+00:00", "content_sha256": "04b0cbc7fddba37622d7a6f10039680cccbc7e5c4a4ca17af677899f9e4423bf", "link_unreachable_since": null }, { "n": 6, "id": "SRC-b870d6655c", "title": "InterSystems Health Connect Overview", "publisher": "InterSystems", "url": "https://docs.intersystems.com/healthconnectlatest/csp/docbook/DocBook.UI.Page.cls?KEY=AHXHCOVW", "published": null, "first_retrieved": "2026-09-28T13:34:32+00:00", "last_checked": "2026-09-28T13:34:32+00:00", "content_sha256": "afa5d0ca23c8e198e07f9405b78043c8aa339285856cbc3c579d6bf0434f0dc7", "link_unreachable_since": null } ], "claims": [ { "id": "CLM-d8590f91", "statement": "De gids beschrijft mappings van v2-berichten, -segmenten, -datatypes en -vocabularium naar FHIR R4-bundels, -resources, -datatypes en -codesystemen.", "kind": "fact", "kind_label": "feit", "locator": "inleiding startpagina", "as_of": "2026-11-12", "source": { "id": "SRC-f3a21c39fb", "title": "HL7 Version 2 to FHIR - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-9127076f", "statement": "De HL7 Version 2 to FHIR-implementatiegids v1.0.0 (STU1, op basis van FHIR R4) is de huidige gepubliceerde versie.", "kind": "fact", "kind_label": "feit", "locator": "kop van de startpagina", "as_of": "2026-11-12", "source": { "id": "SRC-f3a21c39fb", "title": "HL7 Version 2 to FHIR - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-98a9eb9a", "statement": "De eerste focus van de mappings ligt op veelgebruikte v2-berichtstructuren zoals ADT, orders, resultaten en vaccinaties.", "kind": "fact", "kind_label": "feit", "locator": "sectie 'Message Structures'", "as_of": "2026-11-12", "source": { "id": "SRC-e36e67809d", "title": "HL7 Version 2 to FHIR - Introduction", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/introduction.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-ed8d4fc7", "statement": "Volgens de publicatielijst is release 1.0.0 (gedateerd 7 oktober 2025) de STU1-publicatie van de gids.", "kind": "fact", "kind_label": "feit", "locator": "lijst, item version 1.0.0 (date 2025-10-07)", "as_of": "2026-11-12", "source": { "id": "SRC-e3263d4063", "title": "HL7 Version 2 to FHIR - package-list.json (publicatiegeschiedenis)", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/package-list.json", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-322218d8", "statement": "Het project mikt uiteindelijk op een normatieve status van de mappings.", "kind": "fact", "kind_label": "feit", "locator": "sectie projectscope", "as_of": "2026-11-12", "source": { "id": "SRC-e36e67809d", "title": "HL7 Version 2 to FHIR - Introduction", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/introduction.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-cf4fabb3", "statement": "De mapping is cumulatief en niet gebonden aan één v2-versie of één implementatiegids; het project startte bij v2.9.", "kind": "fact", "kind_label": "feit", "locator": "inleiding startpagina", "as_of": "2026-11-12", "source": { "id": "SRC-f3a21c39fb", "title": "HL7 Version 2 to FHIR - Home", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-afbc9170", "statement": "De mappings vertrekken van de basisstandaard en houden geen rekening met beperkingen uit specifieke HL7-implementatiegidsen of met lokale varianten die niet conform de basisstandaard zijn.", "kind": "fact", "kind_label": "feit", "locator": "sectie 'Implementation Considerations' in de projectscope", "as_of": "2026-11-12", "source": { "id": "SRC-e36e67809d", "title": "HL7 Version 2 to FHIR - Introduction", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/introduction.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-15945748", "statement": "Z-gegevens (lokale berichten, triggergebeurtenissen, segmenten en datatypes) worden niet in de v2-to-FHIR-mappings opgenomen.", "kind": "fact", "kind_label": "feit", "locator": "slotalinea", "as_of": "2026-11-12", "source": { "id": "SRC-e36e67809d", "title": "HL7 Version 2 to FHIR - Introduction", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/introduction.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-4ce5ff75", "statement": "Volgens de v2-to-FHIR-gids zijn reële v2-implementaties divers en gebruiken ze uiteenlopende codes om betekenis over te brengen.", "kind": "fact", "kind_label": "feit", "locator": "sectie over terminologie", "as_of": "2026-11-12", "source": { "id": "SRC-f3c6e0ad3c", "title": "HL7 Version 2 to FHIR - Implementation Considerations", "publisher": "HL7 International", "url": "https://hl7.org/fhir/uv/v2mappings/implementation_considerations.html", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-edefdfe5", "statement": "Microsoft positioneert de $convert-data-operatie van de Azure FHIR-service als component in een ETL-pijplijn om o.a. HL7v2- en C-CDA-gegevens naar FHIR R4 om te zetten; de orkestratie gebeurt met Azure Logic Apps of Azure Data Factory.", "kind": "fact", "kind_label": "feit", "locator": "sectie 'Use the $convert-data endpoint' (pagina bijgewerkt 2026-08-24)", "as_of": "2026-09-28", "source": { "id": "SRC-b98c0fb8ce", "title": "Convert health data with $convert-data in FHIR", "publisher": "Microsoft", "url": "https://learn.microsoft.com/en-us/azure/healthcare-apis/fhir/convert-data-overview", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true }, { "id": "CLM-dc9fc31d", "statement": "Health Connect bevat FHIR-client- en -servercomponenten, een FHIR-objectmodel en ingebouwde transformaties tussen FHIR en andere standaarden zoals HL7 v2 en C-CDA.", "kind": "fact", "kind_label": "feit", "locator": "sectie 'FHIR Support'", "as_of": "2026-09-28", "source": { "id": "SRC-b870d6655c", "title": "InterSystems Health Connect Overview", "publisher": "InterSystems", "url": "https://docs.intersystems.com/healthconnectlatest/csp/docbook/DocBook.UI.Page.cls?KEY=AHXHCOVW", "published": null }, "citaat": null, "figuur": null, "in_text": true, "on_page": true } ], "diagrams": [], "facets": { "type": [ "Specification" ], "jurisdiction": [ "internationaal" ], "theme": [ "architectuur-en-infrastructuur", "standaardisatie-en-governance" ], "lifecycle": [ "trial-use" ], "section": [ "standaarden", "europa" ] }, "search_terms": [ "HL7 Version 2 to FHIR", "v2-to-FHIR", "V2 to FHIR", "v2mappings", "hl7.fhir.uv.v2mappings" ], "release_id": "2026.11.13-2", "license": "CC BY 4.0" }