--- id: be-fhir-pakketindeling type: Rule type_label: Regel of afsprakenkader title: HL7 Belgium-regels voor aparte FHIR-pakketten aliases: - Proposed Rules for creating separate packages - pakketindeling Belgische FHIR-IG's - criteria voor nieuwe FHIR-pakketten names: nl: HL7 Belgium-regels voor aparte FHIR-pakketten fr: Règles de HL7 Belgium pour des packages FHIR séparés en: HL7 Belgium rules for creating separate FHIR packages jurisdiction: - belgie themes: - standaardisatie-en-governance - architectuur-en-infrastructuur lifecycle: voorstel lifecycle_note: Document 'Proposed Rules', versie 1.0 van 11/12/2024, afgeklopt in de HL7 Belgium-werkgroep FHIR WG Core; of de bestaande IG's eraan voldoen, is niet nagegaan. version: 1.0 (11 december 2024) summary: 'Deze HL7 Belgium-regels bepalen wanneer de Belgische FHIR-profielen in een apart technisch pakket (een eigen implementatiegids) terechtkomen. Het hoofdcriterium is functioneel: wat inhoudelijk samenhoort, blijft in één pakket, met technische criteria en use-case-specificiteit als redenen om te splitsen. Het voorstel kent drie lagen: een core-pakket met basisresources, algemene pakketten en use-case-specifieke pakketten, elk met regels over welke verwijzingen toegelaten zijn. Voor softwareleveranciers en ziekenhuizen verklaart het waarom een gespecialiseerd profiel steeds een algemener profiel verfijnt.' last_verified: '2026-11-05' relations: - type: ownedBy direction: uit target: hl7-belgium target_url: https://ehealth-atlas.be/hl7-belgium/ status: established - type: appliesTo direction: uit target: be-fhir-igs target_url: https://ehealth-atlas.be/be-fhir-igs/ status: established release: 2026.11.12-3 url: https://ehealth-atlas.be/be-fhir-pakketindeling/ license: CC BY 4.0 --- # HL7 Belgium-regels voor aparte FHIR-pakketten Deze HL7 Belgium-regels bepalen wanneer de Belgische FHIR-profielen in een apart technisch pakket (een eigen implementatiegids) terechtkomen. Het hoofdcriterium is functioneel: wat inhoudelijk samenhoort, blijft in één pakket, met technische criteria en use-case-specificiteit als redenen om te splitsen. Het voorstel kent drie lagen: een core-pakket met basisresources, algemene pakketten en use-case-specifieke pakketten, elk met regels over welke verwijzingen toegelaten zijn. Voor softwareleveranciers en ziekenhuizen verklaart het waarom een gespecialiseerd profiel steeds een algemener profiel verfijnt. ## Wat is het? Een [Belgische FHIR-implementatiegids](https://ehealth-atlas.be/be-fhir-igs/) (IG) wordt technisch verdeeld als **pakket**: een bundel profielen, extensies, ValueSets en voorbeelden met een eigen pakketnaam (`hl7.fhir.be.*`) en versie. Een document van [HL7 Belgium](https://ehealth-atlas.be/hl7-belgium/) legde op 11 december 2024 in twee pagina's (versie 1.0, afgeklopt in de werkgroep FHIR WG Core) regels vast voor het opsplitsen van Belgische IG's in aparte pakketten[^1]. Het document noemt zich een voorstel van regels; dat de bestaande IG's er al aan voldoen, is niet nagegaan. De HL7 Belgium FHIR Validation Group is verantwoordelijk voor het aanmaken van IG's[^1] en valideert de redenen voor een nieuwe IG tijdens haar vergaderingen[^1]. Elke IG wordt beheerd door precies één HL7 Belgium-werkgroep, terwijl één werkgroep meerdere IG's kan beheren[^1]. ## Wat moet, voor wie, voorwaarden Volgens de voorgestelde regels proberen HL7 Belgium en het [eHealth-platform](https://ehealth-atlas.be/ehealth-platform/) functioneel samenhangende profielen en artefacten in hetzelfde technische pakket te houden[^1]; het hoofdcriterium voor een nieuw pakket is functioneel[^1]. Technische criteria spelen ook mee: cyclische afhankelijkheden kunnen de inhoud van een pakket beïnvloeden[^1] en technische criteria vermijden compilatiefouten[^1]. Een pakket kan worden aangemaakt wanneer de inhoud van de resources te specifiek wordt[^1]; zeer specifieke profielen die te sterk aan één use case gebonden zijn, komen in een nieuwe IG[^1]. Het voorstel kent drie lagen: | Laag | Wat erin hoort | Toegelaten verwijzingen | Voorbeelden | Bron | |---|---|---|---|---| | Core-pakket | alle basisresources | enkel inkomende verwijzingen vanuit andere Belgische pakketten | BePatient, BePractitioner, SSIN-naamsysteem |[^1] | | Algemene pakketten | use-case-onafhankelijke profielen die op Belgisch niveau gelden | in principe enkel uitgaande verwijzingen naar het core-pakket | BeCarePlan, BeObservation, BeGoal |[^1] | | Specifieke pakketten | use-case-specifieke laag die vooral kardinaliteit, waardelijsten, codesystemen en naamsystemen beperkt | — | BeObesityGoal, BeDiabetesCarePlan, BeGlucoseObservation |[^1] | Elke specifieke resource wordt als best practice opgezet als verfijning van een algemene resource[^1]. Daaruit volgt een eis aan de infrastructuur: wie het transport van een BeObservation aankan, moet ook de opslag ervan ondersteunen[^1] en een BeGlucoseObservation aankunnen[^1]. ## In werking sinds, wat volgt | Datum | Gebeurtenis | Bron | |---|---|---| | 11/12/2024 | versie 1.0 afgeklopt in de HL7 Belgium-werkgroep FHIR WG Core |[^1] | Een latere versie of een formele goedkeuring buiten de werkgroep werd niet gevonden. ## Wat betekent het voor een ziekenhuis? - **Opbouw van profielen begrijpen.** Een gespecialiseerd profiel, zoals een glucosemeting, is volgens de regels een verfijning van een algemener profiel[^1]; software die de algemene BeObservation verwerkt, hoort volgens de richtlijn ook de BeGlucoseObservation aan te kunnen[^1]. - **Afhankelijkheden volgen.** Omdat het core-pakket enkel inkomende verwijzingen krijgt[^1], brengt elke nieuwe domein-IG een afhankelijkheid van een bepaalde BE Core-versie mee; zie de tabel 'Overzicht per IG' op [Belgische FHIR-implementatiegidsen](https://ehealth-atlas.be/be-fhir-igs/). - **Aanbeveling**: vraag bij een nieuwe koppeling na tot welke laag (core, algemeen, specifiek) de gebruikte profielen behoren, zodat duidelijk is welke onderliggende pakketten mee geïmplementeerd moeten worden. ## Onzekerheden en tegenstrijdige informatie - **Voorstel of regel?** Het document heet een voorstel, maar versie 1.0 is in de werkgroep afgeklopt[^1]; of het als bindende regel voor nieuwe IG's geldt, is niet bevestigd. - **Toepassing op bestaande IG's**: of de huidige portaal-IG's de drielagenindeling volgen, is niet nagegaan. ## Relaties - valt onder verantwoordelijkheid van: [HL7 Belgium](https://ehealth-atlas.be/hl7-belgium/) (vastgesteld)[^1]. Afgeklopt in de werkgroep FHIR WG Core; de HL7 Belgium FHIR Validation Group is verantwoordelijk voor het aanmaken van IG's en technische pakketten. - is van toepassing op: [Belgische FHIR-implementatiegidsen](https://ehealth-atlas.be/be-fhir-igs/) (vastgesteld)[^1]. Regels voor het opsplitsen van de Belgische IG's in aparte pakketten; geldt als voorstel. ## Open vragen - Voldoen de bestaande portaal-IG's (bv. BE Core, BE Core Clinical en de domein-IG's) aan de drielagenindeling, en volgen nieuwe IG's zoals Glucose Monitoring en Lifestyle ze? - Is er na versie 1.0 van december 2024 een herziene of definitieve versie van de regels? ## Bronnen [^1]: [HL7 Belgium - Proposed Rules for creating separate packages (version 1.0 - 11 December 2024)](https://drive.usercontent.google.com/download?id=1E2tVPRUpgIbseGW1fn3gdi1pK5u_NNbR&export=download). HL7 Belgium, 2024-12-11. Opgehaald 2026-09-26, sha256 de47ec568d0dad62… (SRC-2dceaf67ef)