Versies en status van de Belgische FHIR-IG's

Deze pagina is de naslag bij Belgische FHIR-implementatiegidsen: welke versie van elke Belgische FHIR-implementatiegids (IG) is actueel, sinds wanneer, en wat betekenen de statuslabels. Versie, releasedatum, FHIR-versie en publicatiereeks per IG komen uit het bestand package-list.json van elke IG, de publicatiehistoriek die bij elke gids op het portaal van het eHealth-platform staat^[1]. De releasedatum is de publicatiedatum, geen ingangsdatum. Hoe een gids tot publicatie komt, staat op Governance en publicatie van de Belgische FHIR-IG's.

Status en reeks

In package-list.json is 'Trial Use' de waarde van het veld sequence (de publicatiereeks), niet van het veld status: voor BE Core is status 'release', sequence 'Trial Use' en fhirversion 4.0.1^[1]. Alleen BE Lab draagt in zijn huidige release zelf de status 'trial-use'^[2]; in de versiehistoriek had ook BE PSS 1.0.0 (14/05/2025) die status, terwijl 1.1.0 'release' kreeg^[3]. Volgens de HL7-documentatie is status de levensfase van een versie en sequence een optionele groepering in een reeks^[4]; 'release' betekent een release zonder bijzondere status^[4], 'trial-use' een specificatie klaar voor gebruik op proef^[4], en sommige statuswaarden hebben enkel betekenis voor HL7 of andere standaardisatieorganisaties^[4]. Bij de Belgische IG's is 'Trial Use' dus de naam van de reeks; het statusveld 'release' zegt niets over formele rijpheid, en een Belgische uitleg daarvan werd niet gevonden^[4].

De FHIR-versie is bij elke gids 4.0.1 (R4). BE Medication vermeldt dat het een R4-IG is die ongewijzigd met R4B-systemen werkt, met R4- en R4B-pakketten^[5]; of dat voor alle IG's geldt, is niet nagegaan. BE Core 2.2.0 hangt ook af van HL7-pakketten, zoals HL7 Terminology (THO), dat elke IG automatisch meekrijgt^[6].

Publicatieniveaus en stand

Gidsen in ontwerp

Drie gidsen bestaan enkel als CI-build. Glucose Monitoring staat het dichtst bij publicatie: de publicatieaanvraag vraagt 1.0.0 aan in de reeks 'Trial Use'^[10], als mijlpaal en als eerste publicatie^[10], met het eHealth-platform als registerautoriteit^[10], en de release-candidate-build van 14 oktober 2026 meldt nul fouten^[9]. De CI-build wordt uitgegeven door het eHealth-platform, gebouwd uit de repository hl7-be/glucose-monitoring^[16]. Patient Monitoring Outcome heeft een CI-build op de branch main, versie 0.1.0 met status 'draft'^[7], uitgegeven door HL7 Belgium^[17]. Details over beide op HL7 Belgium Patient Monitoring Outcome FHIR IG; zie ook Telemonitoring in België.

De Lifestyle-IG (hl7.fhir.be.lifestyle) is een CI-build van versie 0.1.0 met status 'draft', laatst gebouwd op 31 oktober 2026^[8], met het eHealth-platform als uitgever en uitdrukkelijk geen geautoriseerde publicatie^[18]. De gids beschrijft de gestructureerde registratie van het gebruik van tabak, alcohol, drugs en geneesmiddelen door een patiënt^[8]. De configuratie legt de canonical op ehealth.fgov.be/standards/fhir/lifestyle^[19], vermeldt licentie CC0-1.0 en FHIR 4.0.1^[19] en hangt af van BE Core 2.2.0^[19].

Daarnaast bestaat een CI-build van een terminologie-IG (hl7.fhir.be.terminology) die Belgische terminologie als een FHIR-pakket publiceert^[20]. Die build vermeldt het eHealth-platform als uitgever en is uitdrukkelijk geen geautoriseerde publicatie, maar de doorlopende build voor versie 1.0.0^[20]; de IG vermeldt zelf dat de aanvraagroute, de doorlooptijd en de afstemming van releasecycli nog niet gedocumenteerd zijn^[20]. Op de branch release-candidate van hl7-be/terminology ligt een publicatieaanvraag voor hl7.fhir.be.terminology 1.0.0 ('eHealth Terminology package for Belgium') in de reeks Trial Use^[11]. Zie Belgische terminologieserver (FHIR).

Overzicht per IG

De publicatiebanners bevestigen de versies en de FHIR R4-basis^[21][22]. Kolom 'Reeks' is het veld sequence; tenzij anders vermeld is status 'release'.

'…' staat voor https://www.ehealth.fgov.be/standards. Een streepje in de kolom Terminologie betekent dat geen claim een terminologiebinding onderbouwt. Voor de CI-builds is de datum in het manifest een builddatum, geen releasedatum.

Versiegeschiedenis

Oudere releases volgens de publicatiehistoriek van de gidsen, voor zover ze in de Atlas zijn vastgelegd; het overzicht is niet volledig.

De releasenotes van BE MyCareNet 2.2.0 vermelden onder meer het schrappen van de waarde 'partialAgreement' en het codesysteem BeCSPartialAgreementValues en het optioneel maken van preAuthRef^[101]; de releasenota van 2.2.1 noemt een aangepaste kardinaliteit van Practitioner en PractitionerRole en het verwijderen van drie voorbeeldinstanties^[54]. BE Patient Dossier 1.1.0 voegde de CareSet ClinicalReport toe^[88]; de opvolger 1.1.1 past volgens de releasenota enkel status en experimental aan^[87]. BE Core Clinical 1.4.0 voegt Device en DeviceUseStatement toe^[25].

Registercontrole (27 oktober en 5 november 2026). Voor elk van de portaal-IG's is de versie die het FHIR-pakketregister packages2.fhir.org als latest markeert opgevraagd en vergeleken met de tabel hierboven; de versies zijn gelijk, telkens op FHIR 4.0.1^{[14][28][32][36][41][15][49][57][61][65][69][72][78][83][91][95]}. Voor de twee nieuwste releases geeft het register BE MyCareNet 2.2.1 en BE Patient Dossier 1.1.1, beide met registerdatum 30 oktober 2026^[51][85]; het internationale IG-register vermeldt ze in de editie Trial Use^[52]. Ook het oudste pakket, BE Lab 1.0.0 van 8 september 2022, is nog altijd de recentste versie^[15]. Bij twee IG's wijkt de registerdatum af van de package-list-datum; in de tabel blijft de package-list-datum staan (zie onzekerheden).

• Valideer tegen een release. Het portaal vraagt implementatoren de gereleasete pakketten te gebruiken voor de recentste stabiele resources^[102]; een CI-build is geen geautoriseerde publicatie^[20][18].
• Trial Use is geen bevriezing. Het Referral-IG vermeldt ondanks release 1.0.0 dat documentatie en artefacten nog in ontwikkeling zijn en dat ValueSets slechts voorbeelden zijn^[77]; het eHealth-platform noemt het labo-IG work-in-progress^[45].
• Aanbeveling: leg per koppeling vast welke IG-versie de tegenpartij (kluis, MyCareNet) ondersteunt, in plaats van steeds de laatste release te volgen; in augustus, september en oktober 2026 kregen verschillende IG's een nieuwe release. Behandel een publicatieaanvraag als signaal om te plannen, niet als basis voor een productiekoppeling.

Niet gevonden is geen bewijs van afwezigheid.

• Releasedatums: het pakketregister en package-list.json lopen uiteen bij BE Patient Care 1.1.0 (register 26 november 2025^[69] tegenover package-list 10 oktober 2025^[67]) en verschillen één dag bij BE Core Clinical 1.4.0 (register 15/10/2026^[28], package-list 16/10/2026^[24]); vermoedelijk is het registerdatum tegenover releasedatum. Bij BE MyCareNet 2.2.1 en BE Patient Dossier 1.1.1 vallen beide op 30 oktober 2026^{[51][12][85][13]}.
• Terminologie-IG: de doorlopende build van hl7.fhir.be.terminology staat op de branch release-candidate^[20]; hoe ze zich verhoudt tot de publicatieaanvraag met dezelfde package-id^[11], blijft onbeantwoord.
• Referral en DRP: Referral is gepubliceerd als 1.0.0 in de reeks Trial Use^[75] maar volgens de eigen homepage nog in ontwikkeling^[77], en DRP kreeg release 1.1.1 terwijl het portaal DRP als deprecated markeert^[80][82]. Details op Belgische FHIR-IG's voor verwijzing: Referral-IG, DRP-IG en eReferral-IG.