Netherlands - Zorginzage Implementation Guide
1.0.1 - release Netherlands flag

Netherlands - Zorginzage Implementation Guide - Local Development build (v1.0.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Volume 1

Inleiding

Deze implementatiegids Zorginzage bevat de generieke afspraken en specificaties die nodig zijn voor toepassingen die gebruikmaken van de communicatiepatronen 'Gericht bevragen' en 'Geïndexeerd bevragen'. Het doel van deze implementatiegids is het versnellen van de realisatie van toepassingen. Deze implementatiegids draagt hieraan bij door het hergebruik van afspraken en specificaties te vereenvoudigen.

Procesbeschrijving

Met deze bolt ondersteunen we het proces van Zorginzage. Dat proces bestaat enerzijds uit het vindbaar (findable), toegankelijk (accesible), interoperabel (interoperable) en herbruikbaar (reusable) maken (FAIR) van dossiergegevens door een datahouder en anderzijds uit het daadwerkelijk inzien van dossiergegevens door een datagebruiker. Door Zorginzage zijn zorgverleners in staat het voor hen relevante deel van het zorgtraject van de betrokkene te volgen dat zich bij andere zorgaanbieders afspeelt.

Voorbeelden:

  • Een thuiszorgdossier dat wordt bijgehouden door de thuiszorgorganisatie en wordt ingezien door de huisarts. Observaties en metingen worden verricht door verplegend en verzorgend personeel van de thuiszorgorganisatie en deze kunnen specifiek en gericht worden ingezien door de betrokken huisarts.
  • De integrale geboortezorg waarbij verschillende zorgaanbieders (eerstelijns verloskundepraktijken, ziekenhuizen, echoscopiepraktijken, kraamzorgorganisaties, jeugdgezondheidszorgorganisaties) in onderlinge samenwerking de juiste zorg voor de betrokkene en diens omgeving leveren. Alle betrokken zorgverleners dienen (wanneer dat voor hen relevant is en wanneer daarvoor een grondslag is) inzage te hebben in de observaties, metingen en andere zorggegevens die zijn geregistreerd door personeel van andere betrokken zorgaanbieders.
  • Het opvragen van de Basisgegevensset Zorg (BgZ) binnen de medisch-specialistische zorg . Zorgverleners dienen (wanneer dat voor hen relevant is en wanneer daarvoor een grondslag is) inzage te hebben in de Basisgegevensset Zorg die is geregistreerd door een eerdere behandelaar.
  • Het actueel medicatieoverzicht (AMO). Zorgverleners dienen (wanneer dat voor hen relevant is en wanneer daarvoor een grondslag is) inzage te hebben in de medicatie-informatie die is ingevoerd door andere zorgaanbieders.

Principes

  1. Deze specificatie heeft als scope het door een datagebruiker inzien van data die bij andere zorgorganisaties is opgeslagen en het hiervoor benodigde door een datahouder beschikbaar stellen van data aan andere zorgorganisaties.
  2. Deze specificatie bevat alleen afhankelijkheden van afspraken, specificaties en systemen die beschikbaar zijn in productie-omgevingen.
  3. Deze specificatie ontwikkelt incrementeel en iteratief door.
  4. Deze specificatie adopteert incrementeel en iteratief de door het Ministerie van VWS beheerde landelijke afspraken en specificaties voor generieke functies en de andere elementen van de doelarchitectuur voor het Gezondheidsinformatiestelsel (GIS). Deze landelijke afspraken en specificaties vervangen incrementeel en iteratief alle Zorginzage-specifieke afspraken en specificaties zodra de eigenaar en de deelnemers van de Zorginzage-specificatie beoordelen dat deze implementatieklaar zijn.
  5. Van deze specificatie zullen maximaal twee release per jaar uitkomen die invloed hebben op de functionaliteit.
  6. Wederkerigheid. Deelnemers aan Zorginzage stellen alleen data beschikbaar aan partijen die ook conform deze specificatie data beschikbaar stellen.

Toepassingen

Deze specificatie vormt de basis voor een aantal verschillende toepassingen. Afspraken over welke versies van deze specificatie deelnemers implementeren en wanneer, worden per toepassing gemaakt, in de specificatie of het implementatieplan van die toepassing.

Toepassing Specificatie Opmerking
360-graden cliëntbeeld link De specificatie van deze toepassing maakt gebruik van Zorginzage 2026
Geboortezorg link De specificatie van deze toepassing maakt nog geen gebruik van Zorginzage 2026
Huisartsinzage link De specificatie van deze toepassing maakt nog geen gebruik van Zorginzage 2026
PZP link De specificatie van deze toepassing maakt nog geen gebruik van Zorginzage 2026

Wederkerigheid

Deelnemers aan Zorginzage stellen alleen data beschikbaar aan partijen die ook conform deze specificatie data beschikbaar stellen. Om dit te bereiken dienen deelnemers aan Zorginzage naast de rol datagebruiker (data user) ook de rol datahouder (data holder) te implementeren.

Rollen en verantwoordelijkheden

Eigenaar van de specificatie

  • opstellen en publiceren releases van de specificatie
  • in samenwerking met deelnemers bepalen inhoud en planning releases
  • informeren deelnemers en andere stakeholders over inhoud en planning releases
  • vaststellen inhoud en planning releases
  • faciliteren van tests van de specificaties
  • uitdragen van de specificatie
  • vergroten adoptie van de specificatie

Deelnemer

  • technische implementatie van de specificatie
  • leveren input voor inhoud en planning releases

Eigenaar Discovery Service

  • verzorgen productiewaardige Discovery Service voor een use case

De Zorginzage-specificatie is een generiek bouwblok waarop meerdere toepassingen (use cases) kunnen worden gebouwd. De eigenaar van de Discovery Service wordt daarom per use case bepaald en is niet noodzakelijkerwijs dezelfde partij als de eigenaar van de specificatie.

Rollen en uitvoerders

Rol Uitvoerder
Eigenaar van de specificatie ActiZ
Deelnemer XIS-leverancier
Eigenaar Discovery Service per use case bepaald

Roadmap

Voor de doorontwikkeling van deze Zorginzage-specificatie wordt de volgende roadmap gehanteerd.

Release Zorginzage-specificatie juni 2026 (versie 1.x) najaar 2026 voorjaar 2027 najaar 2027
adressering Zorginzage-specifiek generieke functie adressering (trial-use) generieke functie adressering generieke functie adressering
lokalisatie geen onderdeel van Zorginzage-specificatie generieke functie lokalisatie (trial-use) generieke functie lokalisatie generieke functie lokalisatie
authenticatie van organisaties Zorginzage-specifiek Zorginzage-specifiek generieke functie authenticatie (trial-use) generieke functie authenticatie
toestemming Zorginzage-specifiek Zorginzage-specifiek generieke functie toestemming (trial-use) generieke functie toestemming
authenticatie van personen Zorginzage-specifiek Zorginzage-specifiek dezi dezi
autorisatie Zorginzage-specifiek Zorginzage-specifiek generieke functie autorisatie (trial-use) generieke functie autorisatie
netwerkbeveiliging Zorginzage-specifiek landelijke specificaties Veilig Netwerk (trial-use) landelijke specificaties Veilig Netwerk landelijke specificaties Veilig Netwerk

De roadmap wordt bepaald op basis van input van de eigenaar en de deelnemers van de Zorginzage-specificatie. De roadmap is afhankelijk van externe factoren waarop de eigenaar en de deelnemers van de Zorginzage-specificatie slechts in beperkte mate invloed hebben. De roadmap kan per release van de Zorginzage-specificatie worden aangepast.

De roadmap beschrijft wanneer releases van de Zorginzage-specificatie verschijnen en wat ze bevatten. Wanneer deelnemers een release implementeren, wordt per toepassing afgesproken, zie de paragraaf Toepassingen.

Releasebeleid

De Zorginzage-specificatie zal zich de komende jaren doorontwikkelen. Ontwikkelingen binnen en rondom Zorginzage, zoals de ontwikkelingen aangaande generieke functies en de doelarchitectuur voor het Gezondheidsinformatiestelsel (GIS), kunnen aanleiding geven om afspraken en specificaties te wijzigen. De eigenaar van de specificatie spant zich ervoor in om te borgen dat ontwikkelingen zo goed mogelijk worden verwerkt in de Zorginzage-specificatie door middel van het uitbrengen van nieuwe releases.

Releasecriteria

Releases van de specificatie worden als volgt aangeduid:

  • Major: Wijzigingen die invloed hebben op de functionaliteit en niet backwards compatible zijn.
  • Minor: Wijzigingen die invloed hebben op de functionaliteit en backwards compatible zijn.
  • Patch: Wijzigingen die geen invloed hebben op de functionaliteit en backwards compatible zijn.

Releasefrequentie

  • De eigenaar van de specificatie publiceert maximaal tweemaal (2) per jaar een nieuwe release met impact voor de Deelnemers (major of minor release) volgens een vooraf aangekondigde planning.
  • De eigenaar van de specificatie kan op ieder moment patch releases uitbrengen als dat nodig is, zoals voor het herstellen van fouten.

Geldigheid

De actuele release is altijd geldig. Voor de voorlaatste release (ook wel n-1 release genoemd) geldt:

  • Na een major release blijft de n-1 release nog zes (6) maanden na publicatie van de actuele release geldig. Deelnemers gebruiken deze periode om over te stappen. Na afloop is de n-1 release niet langer geldig.
  • Na een minor release is de n-1 release per definitie compatibel met de actuele release. Deelnemers kunnen op n-1 blijven en dienen uiterlijk bij de eerstvolgende major release te zijn overgestapt.
  • Een patch release verandert de geldigheidstermijn van n-1 niet.

Deelnemers die op een release ouder dan n-1 zitten, voldoen niet aan de specificatie. De eigenaar van de specificatie kan in overleg met deelnemers afwijkende afspraken maken wanneer een specifieke major release aantoonbaar meer migratietijd vraagt.

Pilot en definitieve elementen

Een release kan twee soorten elementen bevatten:

  • Definitieve elementen: afspraken en specificaties die productiewaardig zijn vastgesteld en die zonder voorbehoud door deelnemers worden geïmplementeerd.
  • Pilot-elementen: nieuwe of gewijzigde afspraken en specificaties die zijn opgenomen om in productie te beproeven, maar nog niet definitief zijn vastgesteld.

Voor pilot-elementen geldt:

  • Pilot-elementen zijn als zodanig herkenbaar in de specificatie via een expliciete status-aanduiding bij het betreffende element. Het betreft de aanduiding 'trial-use'.
  • Pilot-elementen mogen door deelnemers in productie worden geïmplementeerd; daarmee dragen zij bij aan de beproeving.
  • Een pilot-element wordt in een volgende release definitief gemaakt wanneer ten minste één implementatie als datagebruiker en één implementatie als datahouder in productie succesvol gegevens met elkaar uitwisselen en de eigenaar van de specificatie en de deelnemers geen blokkerende bezwaren hebben.
  • Een pilot-element kan op basis van bevindingen uit de pilot worden gewijzigd of ingetrokken. Wijzigingen aan een pilot-element gelden niet als breaking change voor de versienummering van de specificatie als geheel.

Versiebeheer

De eigenaar van de specificatie hanteert de Semantic Versioning-specificatie voor het versiebeheer, zie https://semver.org. Dit betekent dat het versienummer wordt weergegeven door 3 nummers die met een punt zijn gescheiden (x.y.z waarbij x de majorrelease is, y de minor en z de patch).

Verwijzen naar een versie

Elke release van de Zorginzage-specificatie wordt gepubliceerd onder een eigen, vaste URL. Daarnaast zijn er URL's die meebewegen met nieuwe releases:

URL Inhoud
https://nuts-foundation.github.io/nl-zorginzage-ig/1.0.0/ Precies release 1.0.0. Deze inhoud verandert niet meer.
https://nuts-foundation.github.io/nl-zorginzage-ig/1/ De laatste release binnen majorversie 1.
https://nuts-foundation.github.io/nl-zorginzage-ig/ De laatste release.
https://nuts-foundation.github.io/nl-zorginzage-ig/current/ De versie die in ontwikkeling is. Dit is geen release.

Een overzicht van alle gepubliceerde releases staat in de historie.

Een toepassing die gebruikmaakt van deze specificatie verwijst naar een majorversie of naar een specifieke release:

  • Een toepassing die naar een majorversie verwijst, bijvoorbeeld /1/, groeit mee met de minor- en patchreleases binnen die majorversie. Deze releases zijn backwards compatible (zie Releasecriteria). Bij de overstap naar een nieuwe majorversie past de toepassing haar verwijzing aan.
  • Een toepassing die naar een specifieke release verwijst, bijvoorbeeld /1.0.0/, verwijst naar inhoud die niet meer verandert. Bij de overstap naar een nieuwere release past de toepassing haar verwijzing aan.
  • Een toepassing verwijst niet naar de laatste release of naar de versie in ontwikkeling, omdat de inhoud daarvan kan veranderen zonder dat de toepassing haar verwijzing aanpast.

Welke release of majorversie een toepassing gebruikt en wanneer zij overstapt, wordt per toepassing afgesproken.

Verwijzen naar andere specificaties

Voor verwijzingen vanuit deze specificatie naar andere specificaties geldt:

  • Normatieve verwijzingen, zoals naar de generieke functies van VWS, Nuts RFC's, IHE-profielen, Mitz en het afsprakenstelsel van Twiin, verwijzen naar een vaste versie en noemen het versienummer. Publiceert de bron versies onder een eigen URL, zoals de generieke functies van VWS op https://fhir.generiekefuncties.nl, dan verwijst deze specificatie naar die URL.
  • Publiceert de bron geen vaste versie, zoals bij een wiki, dan vermeldt de verwijzing de datum van raadpleging.
  • Informatieve verwijzingen, zoals naar Wikipedia, begrippenlijsten of tools, mogen naar de actuele versie verwijzen.
  • Verwijzingen binnen deze specificatie zijn relatief, zodat elke gepubliceerde versie naar haar eigen onderdelen verwijst.
  • De eigenaar van de specificatie controleert de uitgaande verwijzingen bij elke release.

Besluitvorming

De eigenaar van de specificatie besluit na overleg met de deelnemers aan Zorginzage over het vaststellen van een nieuwe release en over de ‘Release roadmap’ met de onderwerpen voor een eerstvolgende release.