informatiestandaarden - Gebruikersbijdragen [nl]

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-31T20:16:49Z

Thirza Hol: /* Releasenotes alpha publicatie 2.1.0 */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase)

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

Afhankelijk van het domein kunnen er andere woorden gebruikt worden, maar in dit FO gebruiken we generieke termen die Nictiz in haar standaarden hanteert. In dit geval ‘patiënt’, ‘zorgverlener’, ‘(zorg)aanbieder’.

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder A'' en de Beschikbaarstellende ''(Zorg)Aanbieder B'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|thumb|600px||omkaderd|none|Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-121 VI-121]
| style="background-color: white;"| In FO (3.1) en AD tekst aangepast, zodat de toepassing van RegistratieDatumTijd en ToedieningsDatumTijd duidelijk is.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-120 VI-120]
| style="background-color: white;"| De contactgegevens van de zib Zorgaanbieder in de beschikbaarstellen transactie zijn verwijderd.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-119 VI-119]
| style="background-color: white;"| Kardinaliteit Identificatienummer Patiënt aangepast naar 1..*M in de beschikbaarstellen transactie.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-118 VI-118]
| style="background-color: white;"| Tekstuele herziening van de scopeomschrijving naar aanleiding van discussies, ter verbetering van de eenduidigheid in interpretatie.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-117 VI-117]
| style="background-color: white;"| Persoons-, naam- en adresgegevens aangepast naar hoe het gebruikt wordt binnen de MedicatieProces transactie over MedicatieToediening.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-116 VI-116]
| style="background-color: white;"| Tekstuele wijziging op FO, hoofdstuk 3.2, ter verduidelijking dat het om de MedMij gegevensdienst gaat.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-114 VI-114]
| style="background-color: white;"| Link naar het gehele scenario in ART-DECOR toegevoegd aan hoofdstuk 2.3.4.2.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-113 VI-113]
| style="background-color: white;"| De parameters Naamgegevens en Geboortedatum zijn verwijderd uit de Raadplegen transactie, zodat alleen de parameter patient.identifier in de transactie staat. Daarnaast zijn de verwijderde parameters op het TO uit de FHIR Search parameters tabel patient.birthdate en patient.family verwijderd en is patient.identifier in de eerste rij geplaatst.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-112 VI-112]
| style="background-color: white;"| Onder 3.1 in het FO is een tekstuele wijzging doorgevoerd om aan te geven dat BSN nodig is voor uitwisseling.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-111 VI-111]
| style="background-color: white;"| In het FO is een uitleg opgenomen dat afhankelijk van het domein andere termen gebruikt kunnen worden in plaats van zorgverlener/-aanbieder.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-110 VI-110]
| style="background-color: white;"| Tekst toegevoegd aan FO om toe te lichten dat alleen de bron informatie mag uitwisselen.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-109 VI-109]
| style="background-color: white;"| Tekst op FO toegevoegd in informatie elementen tabel bij 3.1 dat bij uitwisseling toedieningsdatum preferent is t.o.v. registratiedatum.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-107 VI-107]
| style="background-color: white;"| Uitleg toevoegen bij hoofdstuk 1.1 over de opbouw van de dataset in ART-DECOR met betrekking tot de groeperingen.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-106 VI-106]
| style="background-color: white;"| Op het FO onder 2.3.2.3 Postproces is de tekst ‘(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.' vervangen door ‘(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.’
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-105 VI-105]
| style="background-color: white;"| Tekst in FO toegevoegd in de informatie-elementen tabel onder 3.1 dat een G-standaard code preferent is aan de SNOMED CT code bij de ProductCode van het FarmaceutischProduct.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-104 VI-104]
| style="background-color: white;"| Op het FO is onder 2.3.2.1 Preproces de eerste bulletpoint met de tekst ‘De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen de betreffende XISsen.' verwijderd en onder 2.3.2.2 Proces bij de derde bulletpoint het stukje tekst 'na controle op verleende toestemming’.
|-
| style="background-color: white;"| 2.1.0 alpha.1
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

De technische releasenotes van deze alpha versie zijn te vinden op [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier].

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-31T20:14:05Z

Thirza Hol: /* Releasenotes alpha publicatie 2.1.0 */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase)

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

Afhankelijk van het domein kunnen er andere woorden gebruikt worden, maar in dit FO gebruiken we generieke termen die Nictiz in haar standaarden hanteert. In dit geval ‘patiënt’, ‘zorgverlener’, ‘(zorg)aanbieder’.

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder A'' en de Beschikbaarstellende ''(Zorg)Aanbieder B'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|thumb|600px||omkaderd|none|Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-121 VI-121]
| style="background-color: white;"| In FO (3.1) en AD tekst aangepast, zodat de toepassing van RegistratieDatumTijd en ToedieningsDatumTijd duidelijk is.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-120 VI-120]
| style="background-color: white;"| De contactgegevens van de zib Zorgaanbieder in de beschikbaarstellen transactie zijn verwijderd.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-119 VI-119]
| style="background-color: white;"| Kardinaliteit Identificatienummer Patiënt aangepast naar 1..*M in de beschikbaarstellen transactie.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-118 VI-118]
| style="background-color: white;"| Tekstuele herziening van de scopeomschrijving naar aanleiding van discussies, ter verbetering van de eenduidigheid in interpretatie.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-117 VI-117]
| style="background-color: white;"| Persoons-, naam- en adresgegevens aangepast naar hoe het gebruikt wordt binnen de MedicatieProces transactie over MedicatieToediening.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-116 VI-116]
| style="background-color: white;"| Tekstuele wijziging op FO, hoofdstuk 3.2, ter verduidelijking dat het om de MedMij gegevensdienst gaat.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-114 VI-114]
| style="background-color: white;"| Link naar het gehele scenario in ART-DECOR toegevoegd aan hoofdstuk 2.3.4.2.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-113 VI-113]
| style="background-color: white;"| De parameters Naamgegevens en Geboortedatum zijn verwijderd uit de Raadplegen transactie, zodat alleen de parameter patient.identifier in de transactie staat. Daarnaast zijn de verwijderde parameters op het TO uit de FHIR Search parameters tabel patient.birthdate en patient.family verwijderd en is patient.identifier in de eerste rij geplaatst.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-112 VI-112]
| style="background-color: white;"| Onder 3.1 in het FO is een tekstuele wijzging doorgevoerd om aan te geven dat BSN nodig is voor uitwisseling.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-111 VI-111]
| style="background-color: white;"| In het FO is een uitleg opgenomen dat afhankelijk van het domein andere termen gebruikt kunnen worden in plaats van zorgverlener/-aanbieder.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-110 VI-110]
| style="background-color: white;"| Tekst toegevoegd aan FO om toe te lichten dat alleen de bron informatie mag uitwisselen.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-109 VI-109]
| style="background-color: white;"| Tekst op FO toegevoegd in informatie elementen tabel bij 3.1 dat bij uitwisseling toedieningsdatum preferent is t.o.v. registratiedatum.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-107 VI-107]
| style="background-color: white;"| Uitleg toevoegen bij hoofdstuk 1.1 over de opbouw van de dataset in ART-DECOR met betrekking tot de groeperingen.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-106 VI-106]
| style="background-color: white;"| Op het FO onder 2.3.2.3 Postproces is de tekst ‘(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.' vervangen door ‘(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.’
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-105 VI-105]
| style="background-color: white;"| Tekst in FO toegevoegd in de informatie-elementen tabel onder 3.1 dat een G-standaard code preferent is aan de SNOMED CT code bij de ProductCode van het FarmaceutischProduct.
|-
| style="background-color: white;"| 2.1.0 alpha.2
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-104 VI-104]
| style="background-color: white;"| Op het FO is onder 2.3.2.1 Preproces de eerste bulletpoint met de tekst ‘De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen de betreffende XISsen.' verwijderd en onder 2.3.2.2 Proces bij de derde bulletpoint het stukje tekst 'na controle op verleende toestemming’.
|-
| style="background-color: white;"| 2.1.0 alpha.1
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

De technische releasenotes van deze alpha versie zijn te vinden op Simplifier.

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Landingspagina Vaccinatie Immunisatie

2026-03-30T21:02:10Z

Thirza Hol: /* Publicaties */

__NUMBEREDHEADINGS__
{{DISPLAYTITLE: Landingspagina Vaccinatie-Immunisatie}}

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|rechts|Vaccinatie-Immunisatie]]

=Inleiding=
De informatiestandaard Vaccinatie-Immunisatie, ontwikkeld voor gebruik binnen MedMij, betreft de informatie-uitwisseling van uitgevoerde vaccinaties en is bedoeld voor het gestructureerd en eenduidig vast kunnen leggen, beschikbaarstellen, uitwisselen en gebruiken van deze gegevens. Dit is relevant in alle sectoren en voor alle (zorg)processen waar vaccinatiegegevens van belang zijn.

Deze informatiestandaard voorziet in de benodigde gegevens op het uitwisselingsvlak en dient daarmee de interoperabiliteit zodanig, dat eenduidige en kwalitatieve informatie-uitwisseling tussen partijen mogelijk wordt met betrekking tot vaccinatie-informatie.
In de eerste versie van deze informatiestandaard is gekozen voor een zorgbreed toepasbare en schaalbare informatiestandaard voor vaccinatie-immunisatiegegevens die afgestemd is met internationale standaarden.

De eerste usecase is uitgewerkt voor MedMij in de vorm van een patiënt-usecase. Deze dient voor de ontsluiting van gegevens van een vaccinerende partij (zorgverlener) of het RIVM (als houder van vaccinatiegegevens) naar de burger toe in een persoonlijke gezondheidsomgeving (PGO) conform de [https://zoek.officielebekendmakingen.nl/kst-35182-4.html motie Diertens] en op aanvraag van de stichting MedMij en het Ministerie van VWS.

Deze pagina geeft een overzicht van de publicaties van de informatiestandaard Vaccinatie-Immunisatie.

=Definities=
{| class="wikitable"

! Term !! Begrippenkader
|-
| Vaccinatie || Het toedienen van een vaccin met als doel het beschermen tegen één of meerdere specifieke infectieziekten.
|-
| Vaccin || Een farmaceutisch product wat gebruikt wordt om de immuunrespons te stimuleren tegen ziekten. Vaccins worden meestal toegediend middels injecties, maar sommige producten kunnen ook bijvoorbeeld oraal of per neusspray toegediend worden.
|-
| Immunisatie || Het opwekken van immuniteit tegen ziekteverwekkers door middel van vaccinatie (actieve immunisatie), door toediening van immunoglobulinen (passieve immunisatie) en/of door het doormaken van de infectie (natuurlijke immunisatie). Actieve immunisatie duurt langer om op te bouwen dan passieve immunisatie, maar blijft daarentegen meestal veel langer beschermen. Natuurlijke immunisatie kan in sommige gevallen ernstige gezondheidsschade geven afhankelijk van de ziekte en persoonsspecifieke factoren.
|-
| Immuniteit || Het beschermd zijn tegen (ziekte door) een ziekteverwekker. Dit is afhankelijk van diverse persoons-, vaccinatie- en ziektespecifieke factoren die het immuunsysteem beïnvloeden. Bij immuun zijn voor een ziekte kan een individu blootgesteld worden aan een ziekteverwekker maar hier niet door geïnfecteerd worden. Immuniteit is vaak langdurig, en soms levenslang.
|-
| Bescherming || Vaccineren kan ten behoeve van bescherming van het individu zelf (de persoon die de vaccinatie krijgt toegediend), maar ook ten behoeve van derden. Dit kan bijvoorbeeld bij mazelen het geval zijn zodat er geen overdracht kan plaatsvinden op andere mensen, of bij kinkhoest tijdens de zwangerschap zodat het ongeboren kind al beschermende afweer opbouwt gedurende het laatste trimester en het kind zo beschermt vlak na de geboorte. Het laatste wordt maternale vaccinatie genoemd.
|}

=Kaders en uitgangspunten=

De vaccinatiezorg in Nederland bestaat grofweg uit:
*Vaccinaties binnen programma’s zoals het [https://rijksvaccinatieprogramma.nl/ Rijksvaccinatieprogramma] en andere publieke programma’s zoals voor [https://www.rivm.nl/covid-19-vaccinatie COVID-19] en de [https://www.snpg.nl/griepvaccinatieprogramma/ griep].
*Vaccinaties binnen de reguliere, collectief gefinancierde zorg (bijvoorbeeld voor mensen met afweerproblemen).
*Vaccinaties op de vrije markt (bijvoorbeeld [https://www.lcr.nl/Index.htm reizigers]- en [https://www.gezondheidsraad.nl/over-ons/organisatie/vaste-commissies/vaccinaties/subcommissie-vaccinatie-werknemers werknemersvaccinaties]).

De uitgangspunten voor deze informatiestandaard zijn als volgt:
*In de eerste versie een minimaal informatiemodel gericht op door zorgverlener/zorgaanbieder toegediende vaccinaties registreren en beschikbaar stellen aan de vaccinatieketen.
*Feitelijke vastlegging en beschikbaarstelling van statische data (geen veranderlijke informatie). Niet gericht op afgeleide conclusies.
*Vaccinatiedata is gericht op de [https://www.cbg-meb.nl/onderwerpen/medicijninformatie-vaccinaties/overzicht-vaccins 29 in Nederland bekende infectieziekten] waartegen beschermd kan worden middels vaccinaties. Medicatie en behandeling vallen niet in deze scope en volgen de afspraken die daarvoor gelden.
*Toekomstige vaccinaties, mutaties en planning zijn buiten scope, verkenning en uitvoering wel eventueel mogelijk in doorontwikkelingsplannen.

=Publicaties=
[[Bestand:MedMij2.png|link=https://www.medmij.nl/|rechts|Naar medmij.nl]]

===Actuele versie - {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}}===

*[[imm:V2_Ontwerp_Vaccinatie-Immunisatie|Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}}]]
*[[imm:V2_FHIR_Vaccination-Immunization|Technisch Ontwerp (FHIR IG) Vaccination-Immunization {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}}]]
*[[imm:V2_Testscript_Vaccinatie-Immunisatie_Raadplegen|Testscript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}} - Raadplegen]]
*[[imm:V2_Testscript_Vaccinatie-Immunisatie_Beschikbaarstellen|Testscript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}} - Beschikbaarstellen]]
*[[imm:V2_Kwalificatiescript_Vaccinatie-Immunisatie_Raadplegen|Kwalificatiescript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}} - Raadplegen]]
*[[imm:V2_Kwalificatiescript_Vaccinatie-Immunisatie_Beschikbaarstellen|Kwalificatiescript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=imm|release=V2}} - Beschikbaarstellen]]

===Ontwerp in ontwikkeling 2.1.0===
*[[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.2]]
*[[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.2]]

===Eerdere versie - {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}} ===
*[[MedMij:V6/Ontwerp_Vaccinatie-Immunisatie|Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}}]]
*[[MedMij:V6/FHIR_Vaccination-Immunization|Technisch Ontwerp (FHIR IG) Vaccination-Immunization {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}}]]
*[[MedMij:V6/Testscript_Vaccinatie-Immunisatie_Raadplegen|Testscript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}} - Raadplegen]]
*[[MedMij:V6/Testscript_Vaccinatie-Immunisatie_Beschikbaarstellen|Testscript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}} - Beschikbaarstellen]]
*[[MedMij:V6/Kwalificatiescript_Vaccinatie-Immunisatie_Raadplegen|Kwalificatiescript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}} - Raadplegen]]
*[[MedMij:V6/Kwalificatiescript_Vaccinatie-Immunisatie_Beschikbaarstellen|Kwalificatiescript Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|namespace=MedMij|release=V6}} - Beschikbaarstellen]]
{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-27T11:30:20Z

Thirza Hol: /* Transacties & Transactiegroepen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

Afhankelijk van het domein kunnen er andere woorden gebruikt worden, maar in dit FO gebruiken we generieke termen die Nictiz in haar standaarden hanteert. In dit geval ‘patiënt’, ‘zorgverlener’, ‘(zorg)aanbieder’

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder A'' en de Beschikbaarstellende ''(Zorg)Aanbieder B'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|thumb|600px||omkaderd|none|Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-27T11:25:06Z

Thirza Hol: /* Transacties & Transactiegroepen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

Afhankelijk van het domein kunnen er andere woorden gebruikt worden, maar in dit FO gebruiken we generieke termen die Nictiz in haar standaarden hanteert. In dit geval ‘patiënt’, ‘zorgverlener’, ‘(zorg)aanbieder’

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder A'' en de Beschikbaarstellende ''(Zorg)Aanbieder B'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|thumb|600px||omkaderd|none|Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20260327T092535/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-27T10:20:54Z

Thirza Hol: /* HL7 FHIR R4 */

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 66 63 56 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 305 62 51 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].
'''Note:''' the transactions defined in ART-DECOR are normative. For example, while the Patient.identifier element in the nl-core profile has a cardinality of 0..*, the ART-DECOR serve transaction specifies a cardinality of 1..*.

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-27T10:20:14Z

Thirza Hol: /* Introduction */

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 66 63 56 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 305 62 51 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha.1|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].
'''Note:''' the transactions defined in ART-DECOR are normative. For example, while the Patient.identifier element in the nl-core profile has a cardinality of 0..*, the ART-DECOR serve transaction specifies a cardinality of 1..*.

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-27T09:37:25Z

Thirza Hol:

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.2}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 66 63 56 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 305 62 51 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha.1|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].
'''Note:''' the transactions defined in ART-DECOR are normative. For example, while the Patient.identifier element in the nl-core profile has a cardinality of 0..*, the ART-DECOR serve transaction specifies a cardinality of 1..*.

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T17:11:07Z

Thirza Hol: /* Bedrijfsrollen en UML activity diagram */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder A'' en de Beschikbaarstellende ''(Zorg)Aanbieder B'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|thumb|600px||omkaderd|none|Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T17:01:35Z

Thirza Hol: /* Bedrijfsrollen en UML activity diagram */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder A'' en de Beschikbaarstellende ''(Zorg)Aanbieder B'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|100px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T17:00:44Z

Thirza Hol: /* Bedrijfsrollen en UML activity diagram */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML activity diagram 26-3-26.jpg|100px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

Bestand:UML activity diagram 26-3-26.jpg

2026-03-26T16:59:18Z

Thirza Hol: 6

== Beschrijving ==
6

Bestand:UML activity diagram VI zorgnetwerk.jpg

2026-03-26T16:48:44Z

Thirza Hol: Thirza Hol heeft een nieuwe versie van Bestand:UML activity diagram VI zorgnetwerk.jpg geüpload

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T16:46:20Z

Thirza Hol: /* Algemeen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het beschikbaarstellen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T16:40:26Z

Thirza Hol: /* Proces */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T16:11:40Z

Thirza Hol: /* Doel en relevantie */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het mogelijk maken om vaccinatiegegevens van patiënten beschikbaar te stellen binnen het zorgnetwerk. De scope richt zich op het raadplegen en beschikbaarstellen van feitelijk succesvol toegediende vaccinaties, zoals beoordeeld door de toedienende zorgverlener.

Binnen scope:
*Vaccinaties die feitelijk zijn toegediend en door de zorgverlener als voldoende of klinisch relevant worden beoordeeld.
*Vaccinaties die niet volledig zijn toegediend, maar wel relevant zijn voor de immunisatiestatus.
*Vaccinaties die feitelijk zijn toegediend, maar die later zijn afgekeurd.

Buiten scope:
*Vaccinaties die primair zijn vastgelegd in een bronsysteem, dat niet ontsloten wordt op basis van deze informatiestandaard (bijvoorbeeld anamnestische vaccinaties).
*Deduceerbare data.
*Immuniteitsstatus, vaccinatieplanning en andere contextuele informatie.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T12:33:48Z

Thirza Hol:

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T12:31:11Z

Thirza Hol:

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt binnen Nictiz.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces
*Positie van het RIVM in de zorgnetwerk uitwisseling}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-26T12:30:49Z

Thirza Hol:

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt binnen Nictiz.
*Infrastructuur voor uitwisseling vaccinatiegegevens binnen het zorgnetwerk
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces}}
*Positie van het RIVM in de zorgnetwerk uitwisseling

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. ToedieningsDatumTijd is preferent boven RegistratieDatumTijd, als beide aanwezig zijn, hoeft alleen de ToedieningsDatumTijd te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgegevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-24T11:06:35Z

Thirza Hol:

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.1}}

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 66 63 56 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 305 62 51 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha.1|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-24T11:06:02Z

Thirza Hol:

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.1}}

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 66 63 56 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 290 62 51 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha.1|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-24T11:05:31Z

Thirza Hol:

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.1}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 66 63 56 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 290 62 51 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha.1|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 FHIR Vaccination-Immunization alpha

2026-03-24T10:54:10Z

Thirza Hol:

{{Vdraft/InformationBox|This FHIR IG is currently under development and can not be considered stable and ready for use. For questions and change requests regarding this IG, please create a ticket in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:FHIR Implementation Guide: Vaccination-Immunization 2.1.0-alpha.1}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink_TO.png|311px|center|alt=Functioneel-Technisch
circle 69 54 65 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 268 54 58 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

==Introduction==
This is the technical design (TO) for the information standard (IS) Vaccination-Immunization. This TO must be used together with the IS functional design [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]]. The data exchange format used in this version is: HL7 FHIR R4.

=== Support ===
For questions, feedback, or change requests, please contact our support team at [https://nictiz.atlassian.net/servicedesk/customer/portal/4 Nictiz Servicemanagement].

=== Boundaries ===
This information standard may overlap with other standards related to identification, roles, and geographic classifications, requiring careful alignment to ensure consistency and avoid duplication. For more information, see [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]].

=== Prerequisite knowledge ===
This TO assumes that the reader is familiar with the following:
* The [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design Vaccination-Immunization 2.1.0-alpha.1]] accompanying this TO.
* This information standard uses the data exchange formats HL7 FHIR R4, which you can find here:
** [[FHIR:V1.0 FHIR IG R4|general FHIR R4 Implementation Guide]]
** [[FHIR:V1.0_FHIR_IG_R4#Overarching_principles|use case overarching principles]]
** [[FHIR:V1.0_FHIR_IG_R4#FHIR_Packages|FHIR packages]].

==Components==
HL7 FHIR R4 is used to accommodate the Dutch Clinical Information Models (zibs) used in the IS.

===HL7 FHIR R4===
{{imm:Vprepub-2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1=2.1.0-alpha.1|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

===Artifacts===
The artifacts of the information standard are presented in the following table:

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| rowspan="2" | Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

===Examples of FHIR instances===
You can find examples of FHIR-instances (filled-in FHIR profiles) in the [https://simplifier.net/packages/nictiz.fhir.nl.r4.immunization/2.1.0-alpha.1 Simplifier Immunization R4 package]

==Transactions==
===Use case: retrieve vaccinations in a personal health environment===

====Introduction====
This use case describes the patient's use case for the retrieval of vaccination results, in a personal health environment (PHR) context. Functional specifications are described at the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha| functional design wiki page]]. This use case consists of enabling a patient to view his own administered vaccinations in a PHR. The technical specification is described here. HL7 FHIR R4 is used for this purpose. Vaccinations are represented by the Immunization resource in FHIR. A transaction will retrieve all administered vaccinations from the XIS.

[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
{{FHIR-IG-Afsprakenstelsel-Note}}

'''Note''': This implementation guide builds on the general guidelines described in the [[MedMij:IG:V1/FHIR_IG#Overarching principles|use case overarching principles]].

====Actors involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="2" style="text-align:left;font-weight: bold;" | Actors
! colspan="2" style="text-align:left;font-weight: bold;" | Systems
! colspan="2" style="text-align:left;font-weight: bold;" | FHIR CapabilityStatements

|- style="color: white; background-color: #eda778;"
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
| style="text-align:left;font-weight: bold;" |Name
| style="text-align:left;font-weight: bold;" |Description
|- style="background-color: #fcf0e9;"
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
| rowspan="2" | {{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|- style="background-color: #fcf0e9;"
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

====Transaction groups involved====
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! style="text-align:left;font-weight: bold;"| '''Transaction group'''
! style="text-align:left;font-weight: bold;"| '''Transaction'''
! style="text-align:left;font-weight: bold;"| '''Actor'''
! style="text-align:left;font-weight: bold;"| '''Role'''
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="vertical-align:top;"|Retrieve vaccinations request
|style="vertical-align:top;"|Patient (using a PHR)
|style="vertical-align:top;"|Request vaccinations from the XIS
|- style="background-color: #fcf0e9;"
|style="vertical-align:top;"|Retrieve vaccinations response
|style="vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="vertical-align:top;"|Serves vaccinations to the PHR
|}

====Invocations====
=====PHR: request message=====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message. The request message represents an HTTP GET parameterized query from the PHR to the XIS.

'''Search'''

The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification against the XIS's Immunization endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Immunization{?[includes]}
</pre>

'''Search Parameters'''

The PHR may supply, and the XIS shall be capable of processing, all inlcudes listed below. These includes are a selection of the defined includes. The includes can also be combined to retrieve multiple resources.

{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|- style="color: white; background-color: #eda778;"
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|- style="background-color: #fcf0e9;"
| <code>patient</code>
| This will specify the resource for the patient that the immunization is performed on.

|
Retrieve the Immunization and Patient resource:
<pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| <code>performer</code>
| This will specify the resource for the healthcareprovider who performed the immunization on the patient.
|
Retrieve the Immunization and Practitioner or Organization resource:
<pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query.

=====XIS: response message=====
The expected action for the XIS is that the XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources. The trigger event is the XIS completed processing of the retrieve vaccinations request message.
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

'''Message semantics'''

The returned data to the PHR should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
| Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthProfessional || PractitionerRole || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Practitioner || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}
|}

The stated query will return a Bundle with all known administered immunizations. Each immunization is conveyed in an Immunization resource. The Immunization resource will contain references to actors such as the patient (Patient resource), the health professional (PractitionerRole and Practitioner resources) and the organization (Organization resource). The client SHALL be able to resolve there referenced resources, as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{{NoteBox|(*) The vaccination location, may or may not be a fully specified address and may or may not be a location of a healthcare provider. It is conceivable that it is as vague as "Germany" when a parent informs the registry of a having received a vaccination "in Germany" without any further info. In these cases it might be unreasonable to assume a full Location resource which is separately accessible. FHIR has a mechanism {{fhir|contained}} for information that only makes sense in the context of some parent resource. The {{fhir|reference}} simply starts with a point sign '#', signalling that the target is internal to the resource. In this case {{fhir|Immunization.contained.Location}}.

It is the prerogative of the source system whether or not {{fhir|Location}} is an independent object. The expectation is that healthcare provider locations are independent {{fhir|Location}} resources. Receiving systems should expect normal FHIR rules for resolving references, which include resolving contained references.

'''Example fragment'''

{{Collapse top|XML Example of Immunization.contained}}
<syntaxhighlight lang="xml">
<Immunization xmlns="http://hl7.org/fhir">
...
<contained>
<Location>
<id value="locatie1"/>
<address>
<country value="Duitsland">
<extension url="http://nictiz.nl/fhir/StructureDefinition/ext-CodeSpecification">
<valueCodeableConcept>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="DE"/>
<display value="Duitsland"/>
</coding>
</valueCodeableConcept>
</extension>
</country>
</address>
</Location>
</contained>
...
<location>
<reference value="#locatie1"/>
<type value="Location"/>
<display value="Adres: Duitsland."/>
</location>
...
</performer>
</Immunization>
</syntaxhighlight>
{{Collapse bottom}}
}}

===Use case: retrieve vaccinations in XIS===
This retrieve vaccinations transaction is used by a XIS (careprovider A) to retrieve vaccinations from another XIS (careprovider B).
====Involved actors====
{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! Transaction group || Transaction || Actor || System role code || FHIR CapabilityStatement

|- style="background-color: #fcf0e9;"
| rowspan="2" | Retrieve vaccinations(PULL)
| Retrieve vaccinations request || XIS careprovider A (Client) || IMM-VAR-FHIR || rowspan="2" |{{Simplifier|http://nictiz.nl/fhir/CapabilityStatement/imm-RetrieveServe|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1|title=CapabilityStatement: Retrieve Serve}}

|- style="background-color: #fcf0e9;"
| Retrieve vaccinations response || XIS careprovider B (Server) || IMM-VAB-FHIR

|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''Abbreviations: IMM-VAR = Immunisatie-vaccinatie raadplegend (systeem), IMM-VAB = Immunisatie-vaccinatie beschikbaarstellend (systeem).''
|}

====Search parameters====
The XIS of careprovider A (Client) shall be able to provide, and the XIS careprovider B (Server) shall be capable of processing, all includes and search parameters listed below. These includes and parameters are a selection of the defined includes and search parameters. The includes can also be combined to retrieve multiple resources.
{| style="text-align: left;" cellpadding=5px;
|- style="color: white; background-color: #e7844b;"
! FHIR Search Parameter !! Description !! FHIR Resource !! Example

|- style="color: white; background-color: #eda778;"
! colspan="4" | Immunization

|- style="background-color: #fcf0e9;"
| patient.identifier|| The client may search on patient identification number. || Immunization || Retrieves all Immunizations resources of a patient with a fake BSN of 111222333. <pre>GET [base]/Immunization?patient.identifier=http://fhir.nl/fhir/NamingSystem/bsn|111222333</pre>

|- style="background-color: #fcf0e9;"
| _include=Immunization:patient || The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the patient that the immunization is performed on. || Immunization || Retrieves all Immunization resources and includes the Patient resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:patient</pre>
|- style="background-color: #fcf0e9;"
| _include=Immunization:performer|| The client may request that the server returns resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This will specify the resource for the performer (organization) by whom the immunization was carried out. || Immunization || Retrieves all Immunization resources and includes the Organization resource in the search results. <pre>GET [base]/Immunization?_include=Immunization:performer</pre>
|+ style="align: bottom; caption-side: bottom; text-align: left;" | ''XIS executes a HTTP GET/POST conform to the FHIR [http://hl7.org/fhir/http.html RESTful] and [http://hl7.org/fhir/search.html search] specification''
|}

====Response Resources====
The returned data to the client XIS (careprovider A) should conform to the profiles listed in the table below. The resources in the response message SHALL conform to the requirements as described in the [[MedMij:IG:V1/FHIR_IG#Profile_use_and_declaration|MedMij FHIR R4 Implementation Guide]].

{| style="text-align: left;" cellpadding=5px;

|- style="color: white; background-color: #e7844b;"
! zib !! FHIR resource !! FHIR profile

|- style="background-color: #fcf0e9;"
|Vaccination || Immunization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event-carenetwork|nictiz.fhir.nl.r4.immunization|pkgVersion=2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| PharmaceuticalProduct || Medication || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion=
2.1.0-alpha.1}}

|- style="background-color: #fcf0e9;"
| Patient || Patient || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| rowspan="2" | HealthcareProvider || Organization || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|- style="background-color: #fcf0e9;"
| Location || {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider|nictiz.fhir.nl.r4.nl-core|pkgVersion=
{{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

|}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-23T22:37:53Z

Thirza Hol:

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt binnen Nictiz.
*Infrastructuur voor uitwisseling vaccinatiegegevens
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap tussen en met MedicatieToediening binnen het MedicatieProces}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum is preferent boven registratiedatum, als beide aanwezig zijn, hoeft alleen de toedieningsdatum te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-23T22:36:20Z

Thirza Hol:

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].

Let op: Bij de release van alpha.2 zijn een aantal hieronder genoemde en reeds bekende issues nog nog niet opgelost. Deze worden richting de alpha.3 verder opgepakt binnen Nictiz.
*Infrastructuur voor uitwisseling vaccinatiegegevens
*Deduplicatierichtlijnen en objectidentificatie
*Verdere afstemming en overlap met MedicatieToediening binnen het MedicatieProces}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum is preferent boven registratiedatum, als beide aanwezig zijn, hoeft alleen de toedieningsdatum te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-23T22:28:02Z

Thirza Hol: /* Eisen en wensen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum is preferent boven registratiedatum, als beide aanwezig zijn, hoeft alleen de toedieningsdatum te worden uitgewisseld.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-23T12:39:06Z

Thirza Hol: /* Eisen en wensen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|De G-standaard code is preferent, SNOMED CT kan worden gebruikt als alternatieve codering. Bij vaccinaties in het verleden vastgelegd kan een G-standaard code ontbreken, het is de aanbeveling deze bij huidige vaccinaties wel vast te leggen.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum is preferent boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een zorgverlener hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-19T08:28:23Z

Thirza Hol:

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|links |87px|Vaccinatie-Immunisatie]]
<imagemap>
Bestand:FO_TO_hyperlink.jpg|311px|center|alt=Functioneel-Technisch
circle 57 53 49 [[imm:V2_Ontwerp_Vaccinatie-Immunisatie_alpha|Functioneel ontwerp]]
circle 252 53 49 [[imm:V2_FHIR_Vaccination-Immunization_alpha|Technisch ontwerp]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor gebruik in het zorgproces.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

Bestand:FO TO hyperlink.jpg

2026-03-19T08:17:05Z

Thirza Hol:

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T10:16:58Z

Thirza Hol: /* Richtlijn */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en de gegevensdienst volgens de specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T10:16:29Z

Thirza Hol: /* Richtlijn */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform de Nictiz werkwijze en specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen specifieke richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T10:04:28Z

Thirza Hol: /* Eisen en wensen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van de informatiestandaard is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T07:11:35Z

Thirza Hol: /* Algemeen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Eisenenwensen| 3.1 Eisen en wensen]] en zijn beschreven in ART-DECOR. Binnen ART-DECOR is een structuur met verschillende groeperingen aangehouden om meer overzicht te bieden in de gebruikte zibs en informatie-elementen. Deze structuur is als volgt opgebouwd:

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| Groepering
! style="background-color: white width:10px"| Uitleg
|-
| style="background-color: white;vertical-align:top;"|Zibs2020
| style="background-color: white;vertical-align:top;"|Deze groepering bevat de zibs uit 2020, zonder aanpassingen. Deze kunnen worden gebruikt binnen de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Bouwstenen
| style="background-color: white;vertical-align:top;"|Deze groepering bevat aangepaste zibs uit de 2020-set. Deze kunnen overeenkomen met de eerdergenoemde zibs, maar zijn aangepast om beter aan te sluiten op de behoeften van de verschillende transacties.
|-
| style="background-color: white;vertical-align:top;"|Vaccinatie
| style="background-color: white;vertical-align:top;"|Deze groepering is gebaseerd op de zib Vaccinatie (2020 en 2024) en bevat alle informatie-elementen die nodig zijn om het uitwisselen van vaccinatiegegevens mogelijk te maken. Daarnaast bevat deze map verwijzingen naar elementen uit Zibs2020 en Bouwstenen.
|-
| style="background-color: white;vertical-align:top;"|QueryParameters
| style="background-color: white;vertical-align:top;"|Deze groepering wordt uitsluitend gebruikt binnen raadpleegtransacties. Hierin zijn de informatie-elementen opgenomen die nodig zijn voor het opstellen van queries.
|}
:''Voorbeeld: De Zorgaanbieder is opgenomen onder ‘Zibs2020’, wat aangeeft dat de zib ongewijzigd wordt hergebruikt. Daarnaast is Zorgaanbieder opgenomen onder Uitvoerder binnen de vaccinatiecontext, waarmee wordt aangegeven dat het de uitvoerende zorgaanbieder betreft.''

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:53:28Z

Thirza Hol: /* Verantwoordelijkheid voor informatie */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
De onderstaande beschrijving is alleen van toepassing op de usecase “Raadplegen van vaccinaties door persoon” (PGO). In dit hoofdstuk kan in de toekomst aanvullende informatie worden opgenomen die betrekking heeft op andere usecases.

Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:51:03Z

Thirza Hol: /* Proces */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan is het proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:48:48Z

Thirza Hol: /* Proces en Context (pre- en postproces) */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

N.B. Het gelijktijdig bevragen van meerdere bronnen wordt momenteel nog niet ondersteund. Hoewel dit wenselijk zou zijn om een compleet overzicht van alle vaccinatiegegevens van een patiënt te kunnen verzamelen en vergelijken, is de scope voor nu beperkt tot het bevragen van één (zorg)aanbieder per keer. Op basis hiervan zijn het onderstaande proces en het bijbehorende activiteitendiagram opgesteld.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:43:31Z

Thirza Hol: /* Transacties & Transactiegroepen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

Hieronder staan de informatie-elementen die in ART-DECOR in de transactie zijn opgenomen. De volledige dataset is te raadplegen in [https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/sc-2.16.840.1.113883.2.4.3.11.60.131.3.2-2025-10-08T000000.html#_2.16.840.1.113883.2.4.3.11.60.131.4.4_20251008000000 ART-DECOR].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:37:26Z

Thirza Hol: /* Proces en Context (pre- en postproces) */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:36:43Z

Thirza Hol: /* Proces en Context (pre- en postproces) */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:35:59Z

Thirza Hol: /* Proces en Context (pre- en postproces) */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:35:32Z

Thirza Hol: /* Proces en Context (pre- en postproces) */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:34:36Z

Thirza Hol: /* Informatieoverdracht */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:33:53Z

Thirza Hol: /* Informatie-elementen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS. Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T06:32:57Z

Thirza Hol: /* Informatieoverdracht */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Informatie-elementen====

De informatie-elementen die van toepassing zijn, worden hier kort toegelicht en zijn verder gedefinieerd in ART-DECOR.

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen
! style="background-color: white width:10px"| Usecasespecifieke aanpassing
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiënt
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient v3.2(2020NL)]
| style="background-color: white;vertical-align:top;"|Geen
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;" rowspan="9"|2
| style="background-color: white;vertical-align:top;" rowspan="9"|Vaccinatie
| style="background-color: white;vertical-align:top;" rowspan="9"|[https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Zib Vaccinatie v4.0(2020NL)]
| style="background-color: white;vertical-align:top;"| Toevoegen Identificatienummer
| style="background-color: white;vertical-align:top;"| Nummer dat de instantiatie van de vaccinatie wereldwijd uniek identificeert.
|-
| style="background-color: white;vertical-align:top;"| Verwijzing naar FarmaceutischProduct in MP9 3.0.0-beta.3
| style="background-color: white;vertical-align:top;"| In de doorontwikkeling van de zib Vaccinatie (publicatie-2024) is een verwijzing naar de zib FarmaceutischProduct opgenomen, met daarin onder andere ProductCode. FarmaceutischProduct wordt toegepast in de informatiestandaard Medicatieproces (MP9 3.0.0-beta.3), bijvoorbeeld bij MedicatieToediening. Om hier in de toekomst zoveel mogelijk mee uit te lijnen, volgt de informatiestandaard Vaccinatie-Immunisatie deze modellering. De kardinaliteit van ProductCode is in deze usecase 1..*, omdat voor iedere vaccinatie minimaal één ProductCode aanwezig dient te zijn.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen SNOMED CT-code aan ProductCode in [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) zib Farmaceutisch Product v2.1.2(2020NL)]
| style="background-color: white;vertical-align:top;"| Conform de [https://nictiz.atlassian.net/browse/ZIB-2214 wijziging] op zib FarmaceutischProduct.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen Contactgegevens en Adresgegevens aan Locatie
| style="background-color: white;vertical-align:top;"| Volgens de zib kan alleen een Zorgaanbieder gemodelleerd worden in Locatie, maar in het geval van bijvoorbeeld groepsvaccinaties kan het zijn dat er op een externe locatie wordt gevaccineerd.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen Zorgaanbieder aan Toediener
| style="background-color: white;vertical-align:top;"| Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. In het geval van bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is (zorg)aanbieder als aparte bouwsteen opgenomen.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"| Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen AnatomischeLocatie
| style="background-color: white;vertical-align:top;"| In lijn met de doorontwikkeling van de zib Vaccinatie. Zie publicatie-2024: [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Zib Vaccinatie v6.0(2024NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| style="background-color: white;vertical-align:top;"| Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"| Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

In het [[imm:V2_FHIR_Vaccination-Immunization_alpha#Message_semantics_2|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS. Het informatiesysteem stelt alleen bouwstenen beschikbaar waar de betreffende zorgaanbieder zelf de auteur van is. Eventueel aanwezige kopieën afkomstig uit een andere bron worden niet beschikbaar gesteld.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-17T05:59:58Z

Thirza Hol: /* Eisen en wensen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Informatie-elementen====

De informatie-elementen die van toepassing zijn, worden hier kort toegelicht en zijn verder gedefinieerd in ART-DECOR.

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen
! style="background-color: white width:10px"| Usecasespecifieke aanpassing
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiënt
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient v3.2(2020NL)]
| style="background-color: white;vertical-align:top;"|Geen
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;" rowspan="9"|2
| style="background-color: white;vertical-align:top;" rowspan="9"|Vaccinatie
| style="background-color: white;vertical-align:top;" rowspan="9"|[https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Zib Vaccinatie v4.0(2020NL)]
| style="background-color: white;vertical-align:top;"| Toevoegen Identificatienummer
| style="background-color: white;vertical-align:top;"| Nummer dat de instantiatie van de vaccinatie wereldwijd uniek identificeert.
|-
| style="background-color: white;vertical-align:top;"| Verwijzing naar FarmaceutischProduct in MP9 3.0.0-beta.3
| style="background-color: white;vertical-align:top;"| In de doorontwikkeling van de zib Vaccinatie (publicatie-2024) is een verwijzing naar de zib FarmaceutischProduct opgenomen, met daarin onder andere ProductCode. FarmaceutischProduct wordt toegepast in de informatiestandaard Medicatieproces (MP9 3.0.0-beta.3), bijvoorbeeld bij MedicatieToediening. Om hier in de toekomst zoveel mogelijk mee uit te lijnen, volgt de informatiestandaard Vaccinatie-Immunisatie deze modellering. De kardinaliteit van ProductCode is in deze usecase 1..*, omdat voor iedere vaccinatie minimaal één ProductCode aanwezig dient te zijn.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen SNOMED CT-code aan ProductCode in [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) zib Farmaceutisch Product v2.1.2(2020NL)]
| style="background-color: white;vertical-align:top;"| Conform de [https://nictiz.atlassian.net/browse/ZIB-2214 wijziging] op zib FarmaceutischProduct.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen Contactgegevens en Adresgegevens aan Locatie
| style="background-color: white;vertical-align:top;"| Volgens de zib kan alleen een Zorgaanbieder gemodelleerd worden in Locatie, maar in het geval van bijvoorbeeld groepsvaccinaties kan het zijn dat er op een externe locatie wordt gevaccineerd.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen Zorgaanbieder aan Toediener
| style="background-color: white;vertical-align:top;"| Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. In het geval van bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is (zorg)aanbieder als aparte bouwsteen opgenomen.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"| Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen AnatomischeLocatie
| style="background-color: white;vertical-align:top;"| In lijn met de doorontwikkeling van de zib Vaccinatie. Zie publicatie-2024: [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Zib Vaccinatie v6.0(2024NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| style="background-color: white;vertical-align:top;"| Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"| Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

In het [[imm:V2_FHIR_Vaccination-Immunization_alpha#Message_semantics_2|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS (European Health Dataspace).

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Raadplegen vaccinatiegegevens door (zorg)aanbieder'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|Binnen deze usecase is uitwisseling van vaccinatiegegevens momenteel alleen mogelijk op basis van het BSN. In de praktijk kan echter ook alleen een vreemdelingennummer of zorgaanbiederspecifiek identificatienummer beschikbaar zijn (bijv. bij vreemdelingen of ongedocumenteerden). In die gevallen moet de uitwisseling op een andere manier plaatsvinden.
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-16T17:43:18Z

Thirza Hol: /* Eisen en wensen */

{{Vdraft/InformationBox|Deze pagina bevindt zich momenteel in uitbreiding of ondergaat een ingrijpende herstructurering en is daarom nog niet gereed voor gebruik. Voor vragen of wijzigingsverzoeken met betrekking tot deze pagina kunt u een ticket maken in [{{VersieInfo|BITS|release=V2|namespace=imm}} BITS].}}

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0-alpha.1}}
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Het functioneel ontwerp beschrijft voor alle uitwisselscenario's (in dit document usecases genoemd) uit de informatiestandaard de transacties, transactiegroepen, de systemen, de systeemrollen en de bedrijfsrollen van zorgverleners/(zorg)aanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[#Usecase(s)|hoofdstuk 2]] wordt verder ingegaan op wat een usecase inhoudt. Per usecase zijn de nadere details beschreven. Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/informatiestandaarden/ Nictiz-webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp buiten de definitietoelichting wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz-website].

Hieronder worden 2 usecases beschreven:
*Het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) (waardoor gegevens ingezien kunnen worden door middel van een PGO)
*Het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 en 2024 gebruikt:

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/Zorgaanbieder-v3.4(2020NL) Zorgaanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[#Informatieoverdracht_2| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:V2_FHIR_Vaccination-Immunization_alpha|technisch ontwerp]].

==Doelgroep==
De doelgroepen van dit functionele ontwerp zijn:

* Productmanagers, architecten, ontwerpers, bouwers en testers van XIS- en PGO-leveranciers, regio-organisaties en Nictiz.
* Vertegenwoordigers van patiënten en zorgverleners/zorgaanbieders.
* RIVM

De doelgroep van MedMij komt overeen met de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]].

==Kaders en uitgangspunten==

===Richtlijn===
Dit functioneel ontwerp is opgesteld conform specificaties genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Richtlijn|de algemene inleiding]] van het functioneel ontwerp voor MedMij.

Voor de MedMij gegevensdienst Vaccinaties is de [https://medmij.atlassian.net/wiki/external/NmZhMGYxMTQ5ZTI3NGRkNGI3YjQ5ZjBlYmZmODE3Njk Weergaverichtlijn Verzamelen vaccinaties] ontwikkeld, met als doel de PGO-gebruikers een patiëntvriendelijke weergave te bieden van hun vaccinatiegegevens in de PGO.
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

Voor de Zorgnetwerk usecase zijn op dit moment nog geen richtlijnen opgesteld.

Een extra toelichting op de gebruikte informatiemodellering: deze usecase is gericht op de scope vaccinaties als onderdeel zijnde van het bredere concept immunisatie geënt op de [[imm:Landingspagina_Vaccinatie_Immunisatie|informatiestandaard van Vaccinatie-Immunisatie]]. Roadmap en versionering van deze usecase zal een relatie hebben en houden met deze informatiestandaard.

===Reikwijdte Informatiestandaard===
De reikwijdte van de informatiestandaard beslaat de functionele beschrijvingen en de dataset voor alle gegevensuitwisselingen binnen één of meerdere zorgprocessen. Voor MedMij wordt verwezen naar [[MedMij:FO:V1/FunctioneelOntwerp| het MedMij functioneel ontwerp]].

===Infrastructuur===
Er is geen nadere specificatie opgesteld voor de Zorgnetwerk-usecase. Voor de MedMij-gegevensdienst geldt geen aanvullende specificatie, anders dan hetgeen is beschreven in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op basis van dit FO en de daarbij behorende dataset wordt een kwalificatiescript opgesteld. Het opstellen van kwalificatiescripts valt buiten de scope van dit FO. Voor meer informatie zie de websitepagina over [https://nictiz.nl/wat-we-doen/activiteiten/kwalificatie/ Nictiz kwalificatie].

Kwalificatiescripts zijn te vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|landingspagina van Vaccinatie-Immunisatie]].

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie het uitwisselen van informatie wordt beschreven aan de hand van actoren (mensen, systemen) en transacties (welke informatie wordt wanneer uitgewisseld). Een usecase is een verbijzondering van een specifiek onderdeel van het zorgproces. Een informatiestandaard kan bestaan uit één of meerdere usecases. Iedere usecase koppelt met een scenario in ART-DECOR. Wanneer verschillende usecases gebruik maken van hetzelfde scenario kan een andere indeling gewenst zijn, bijvoorbeeld op basis van proces. In dit functioneel ontwerp wordt <u>elke</u> usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases beschreven voor het verzamelen van vaccinatiegegevens door een persoon (MedMij-gegevensdienst) en voor het uitwisselen van vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk-usecase). De usecase voor de uitwisseling tussen (zorg)aanbieders betreft momenteel een minimal viable product (MVP) en zal in de toekomst verder worden uitgebreid.

==Usecase: Raadplegen Vaccinatiegegevens door persoon==
===Doel en relevantie===
Het doel van deze MedMij usecase is het voor personen mogelijk maken om regie op hun eigen gezondheid te nemen door inzicht te krijgen in de geregistreerde vaccinatiegegevens die over henzelf gaan. Deze vaccinatiegegevens hebben informatieve waarde voor de burger die deze inziet in een PGO. Er kunnen geen rechten aan worden ontleend.

Deze usecase sluit aan op de functie ‘Verzamelen’ van gezondheidsgegevens van het MedMij Afsprakenstelsel.

====Patient journey - Roos Dalstra====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [[Media:Casus_Roos_Dalstra_MedMij.pdf|hier]].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van vaccinatiegegevens een rol speelt.

<blockquote>Doordat Roos het Rijksinstituut voor Volksgezondheid en Milieu (RIVM) toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld recent een Covid-19 vaccinatie is toegediend bij haar, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug.
Maar ook oudere opgeslagen informatie uit andere bronnen waar zij toestemming aan heeft gegeven kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar hepatitis A vaccinaties voor vakanties naar Turkije of een Tetanusvaccinatie die een paar jaar geleden in het ziekenhuis is gezet na een val op straat.
Zij heeft zo zicht op vaccinaties die zij heeft gekregen op verschillende plekken en momenten in haar leven.</blockquote>

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een persoon (PGO).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinatiegegevens tussen het betreffende XIS en de eigen PGO.

De persoon wil zijn/haar eigen vaccinatiegegevens inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinatiegegevens op te halen en op te slaan, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze usecase beschrijving geen verschil.

=====Proces=====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare vaccinatiegegevens.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de vaccinatiegegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn vaccinatiegegevens in te zien.

=====Postproces=====
De persoon kan zijn vaccinatiegegevens inzien via de PGO.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de ''Persoon'' en de ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel:

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Image:Activity_Diagram_-_Vaccinaties_.png| omkaderd| none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
Zowel de persoon als de (zorg)aanbieder maken ieder gebruik van een informatiesysteem:
* PGO (persoon)
* XIS ((zorg)aanbieder)

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| VaccinatiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png| omkaderd | none | Componenten diagram van systemen en systeemrollen]]

====Informatie-elementen====

De informatie-elementen die van toepassing zijn, worden hier kort toegelicht en zijn verder gedefinieerd in ART-DECOR.

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen
! style="background-color: white width:10px"| Usecasespecifieke aanpassing
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiënt
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient v3.2(2020NL)]
| style="background-color: white;vertical-align:top;"|Geen
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;" rowspan="9"|2
| style="background-color: white;vertical-align:top;" rowspan="9"|Vaccinatie
| style="background-color: white;vertical-align:top;" rowspan="9"|[https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Zib Vaccinatie v4.0(2020NL)]
| style="background-color: white;vertical-align:top;"| Toevoegen Identificatienummer
| style="background-color: white;vertical-align:top;"| Nummer dat de instantiatie van de vaccinatie wereldwijd uniek identificeert.
|-
| style="background-color: white;vertical-align:top;"| Verwijzing naar FarmaceutischProduct in MP9 3.0.0-beta.3
| style="background-color: white;vertical-align:top;"| In de doorontwikkeling van de zib Vaccinatie (publicatie-2024) is een verwijzing naar de zib FarmaceutischProduct opgenomen, met daarin onder andere ProductCode. FarmaceutischProduct wordt toegepast in de informatiestandaard Medicatieproces (MP9 3.0.0-beta.3), bijvoorbeeld bij MedicatieToediening. Om hier in de toekomst zoveel mogelijk mee uit te lijnen, volgt de informatiestandaard Vaccinatie-Immunisatie deze modellering. De kardinaliteit van ProductCode is in deze usecase 1..*, omdat voor iedere vaccinatie minimaal één ProductCode aanwezig dient te zijn.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen SNOMED CT-code aan ProductCode in [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) zib Farmaceutisch Product v2.1.2(2020NL)]
| style="background-color: white;vertical-align:top;"| Conform de [https://nictiz.atlassian.net/browse/ZIB-2214 wijziging] op zib FarmaceutischProduct.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen Contactgegevens en Adresgegevens aan Locatie
| style="background-color: white;vertical-align:top;"| Volgens de zib kan alleen een Zorgaanbieder gemodelleerd worden in Locatie, maar in het geval van bijvoorbeeld groepsvaccinaties kan het zijn dat er op een externe locatie wordt gevaccineerd.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen Zorgaanbieder aan Toediener
| style="background-color: white;vertical-align:top;"| Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. In het geval van bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is (zorg)aanbieder als aparte bouwsteen opgenomen.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"| Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen AnatomischeLocatie
| style="background-color: white;vertical-align:top;"| In lijn met de doorontwikkeling van de zib Vaccinatie. Zie publicatie-2024: [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Zib Vaccinatie v6.0(2024NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| style="background-color: white;vertical-align:top;"| Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"| Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

In het [[imm:V2_FHIR_Vaccination-Immunization_alpha#Message_semantics_2|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen vaccinatiegegevens====

Voor de transactie Raadplegen vaccinatiegegevens zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd. Dit betekent dat bij het opvragen van vaccinatiegegevens alle beschikbare gegevens van de betreffende persoon worden opgevraagd.

====Beschikbaarstellen vaccinatiegegevens====

De transactie Beschikbaarstellen vaccinatiegegevens is gebaseerd op de concepten en kardinaliteiten van de zibs Vaccinatie en Patiënt. Daarnaast omvat deze transactie de extra datavelden StatusToediening en VaccinatieIndicatie, die buiten de zibs zijn gemodelleerd.

In deze transactie worden alle aanwezige en relevante vaccinatiegegevens van de burger beschikbaargesteld. Hieronder staan de informatie-elementen die in de transactie zijn opgenomen. De volledige dataset is te raadplegen via [https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html deze link].

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20250324T130300/tr-2.16.840.1.113883.2.4.3.11.60.131.4.3-2022-02-24T000000.html frameborder="0" align="middle"></iframe>
</html>

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

Onderstaande tabel biedt een overzicht voor deze usecase.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrolcode'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Vaccinatiegegevens(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Persoon
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[imm:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinatiegegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|}

===Usecase diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang.

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png| omkaderd | none| Usecase diagram inzien vaccinatiegegevens]]

==Usecase: Raadplegen vaccinatiegegevens door (zorg)aanbieder==
===Doel en relevantie===
Het doel van deze usecase is het voor zorgverleners mogelijk maken om vaccinatiegegevens van personen uit te wisselen met andere zorgverleners. De scope van deze usecase beperkt zich tot het raadplegen en beschikbaarstellen van feitelijk succesvol volledig toegediende vaccinaties.

Binnen scope:
* Vaccinaties die daadwerkelijk en volledig zijn toegediend, ook als deze later zijn afgekeurd (bijvoorbeeld door een te vroege toediening). 

Buiten scope:
* Interpretaties over toegediende vaccinaties.
* Vaccinaties die niet volledig of niet succesvol zijn toegediend.
* Deduceerbare data.

===Proces en Context (pre- en postproces)===
Het stuk van het proces waar het in deze usecase om gaat is:
* Het systeem van een (zorg)aanbieder (XIS) stelt vaccinatiegegevens van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De (zorg)aanbieder wil vaccinatiegegevens inzien en de andere (zorg)aanbieder kan deze beschikbaar stellen.
* De vaccinatiegegevens van de persoon zijn beschikbaar in het informatiesysteem bij de geraadpleegde (zorg)aanbieder.

=====Proces=====
Het proces van deze usecase is:
* (Zorg)Aanbieder A raadpleegt via het informatiesysteem de vaccinatiegegevens bij (zorg)aanbieder B middels een bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem van (zorg)aanbieder B stelt de vaccinatiegegevens beschikbaar.
* Het informatiesysteem van (zorg)aanbieder A verwerkt de ontvangen vaccinatiegegevens.

=====Postproces=====
(Zorg)Aanbieder A gebruikt de vaccinatiegegevens voor verdere zorgverlening.

===Bedrijfsrollen en UML activity diagram===
Deze usecase onderscheidt twee bedrijfsrollen, namelijk de Raadplegende ''(Zorg)Aanbieder'' en de Beschikbaarstellende ''(Zorg)Aanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| (Zorg)Aanbieder A
| style="background-color: white;"| Raadplegen toegediende vaccinatiegegevens
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinatiegegevens
|-
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd.

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px| omkaderd | none | Activiteitendiagram Raadplegen vaccinatiegegevens]]

===Informatieoverdracht===
(Zorg)Aanbieders maken ieder gebruik van een informatiesysteem, het XIS.

====Systemen & Systeemrollen====
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de vaccinatiegegevens van (zorg)aanbieder naar (zorg)aanbieder.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Systeemrolcode
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Raadplegend systeem
| style="background-color: white;"| IMM-VAR-FHIR
| style="background-color: white;"| Raadplegen vaccinatiegegevens bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen vaccinatiegegevens aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px| Componenten diagram van systemen en systeemrollen]]

====Transacties & Transactiegroepen====
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, waarbij een verzameling van bij elkaar horende transacties een transactiegroep vormt.

Elke usecase bestaat uit de volgende verbanden:
* Een usecase bevat een transactiegroep.
* Een transactiegroep bestaat uit transacties.
* Een transactie wordt uitgevoerd door een bedrijfsrol.
* Bedrijfsrollen maken gebruik van systemen.
* Een systeemrolcode geeft de transactiegroep en de transactie aan waar het systeem voor gebruikt wordt.

In onderstaande afbeelding is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|Usecase Diagram vaccinatiegegevens]]

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20251202T093626/tr-2.16.840.1.113883.2.4.3.11.60.131.4.5-2025-10-08T000000.html frameborder="0" align="middle"></iframe>
</html>

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Usecase
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
! Technisch
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
| rowspan="2"|[[imm:V2_FHIR_Vaccination-Immunization_alpha|Vaccinaties in FHIR]]
|-
| (Zorg)Aanbieder B stelt vaccinatiegegevens beschikbaar aan (zorg)aanbieder B ((Zorg)aanbieder B → (Zorg)aanbieder A)
| Raadplegen vaccinatiegegevens
| Beschikbaarstellen vaccinatiegegevens
| IMM-VAB-FHIR
| XIS
| Zorgverlener
|}

=Aanvullende informatie=
==Eisen en wensen==
Binnen deze informatiestandaard worden de beschikbare informatie-elementen niet in alle usecases op dezelfde wijze toegepast. In onderstaande tabel wordt toegelicht hoe deze elementen binnen de verschillende usecases worden gebruikt en welke usecasespecifieke aanpassingen zijn gemaakt ten opzichte van de onderliggende zibs. De nadere uitwerking van de elementen en de opbouw van de dataset zijn vastgelegd in ART-DECOR.

Bij de ontwikkeling van MedMij gegevensdienst is zoveel mogelijk aangesloten op de ontwikkelingen van MedicatieProces rondom MedicatieToediening. Bij de Zorgnetwerk usecase is er extra rekening gehouden met de internationale ontwikkelingen in het kader van de EHDS.

{| class="wikitable" cellpadding="10" width="70%"
! style="background-color: white width:10px"| #
! style="background-color: white width:10px"| Onderdeel
! style="background-color: white width:10px"| Bouwsteen / Element
! style="background-color: white width:10px"| Zib versie
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Patiënt'
! style="background-color: white width:10px"| Usecasespecifieke aanpassing 'Zorgnetwerk'
! style="background-color: white width:10px"| Toelichting
|-
| style="background-color: white;vertical-align:top;"|1
| style="background-color: white;vertical-align:top;"|Patiëntgegevens volgens de zib [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/Patient-v3.2(2020NL) Zib Patient]
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Geslacht, meerlingindicator, overlijdensindicator en overlijdensdatum niet opgenomen
| style="background-color: white;vertical-align:top;"|Persoons-, adres- en contactgegevens alleen waar verplicht opgenomen
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;" rowspan="17"|2
| style="background-color: white;vertical-align:top;" rowspan="17"|Vaccinatiegegevens volgens de zibs [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie 2020] en [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie 2024]
| style="background-color: white;vertical-align:top;"|Identificatienummer
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Uniek nummer dat een vaccinatie-instantie wereldwijd identificeert.
|-
| style="background-color: white;vertical-align:top;"|FarmaceutischProduct
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|Aansluiting bij MedicatieProces
| style="background-color: white;vertical-align:top;"|In de 2024 zib is een verwijzing naar de zib FarmaceutischProduct opgenomen, met onder andere ProductCode. Deze bouwsteen wordt ook gebruikt in de informatiestandaard Medicatieproces (bijv. bij MedicatieToediening).
|-
| style="background-color: white;vertical-align:top;"|ProductCode (SNOMED CT)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Het gebruik van SNOMED CT codes is alleen voor historische of buitenlandse vaccinaties, de G-standaard blijft preferent.
|-
| style="background-color: white;vertical-align:top;"|Dosis
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door ToegediendeHoeveelheid
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|ToegediendeHoeveelheid (Aantal en Eenheid)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Er is aangesloten bij de uitwerking van MedicatieProces.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieDatum
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Vervangen door Datumgegevens
| style="background-color: white;vertical-align:top;"|VaccinatieDatum duidt minder verschil tussen een registratiedatum of een toedieningsdatum.
|-
| style="background-color: white;vertical-align:top;"|DatumGegevens (RegistratieDatumTijd en ToedieningsDatumTijd)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij MedicatieProces is gekozen voor de term ‘ToedieningsDatumTijd’. Omdat deze niet overal wordt geregistreerd, is ook RegistratieDatumTijd opgenomen. Toedieningsdatum heeft de voorkeur boven registratiedatum.
|-
| style="background-color: white;vertical-align:top;"|Locatie (Contactgevens, Adresgegevens en Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|Contact- en adresgegevens toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan in Locatie alleen een Zorgaanbieder worden gemodelleerd, maar bij bijvoorbeeld groepsvaccinaties kan ook een externe locatie van toepassing zijn.
|-
| style="background-color: white;vertical-align:top;"|Toediener (Zorgaanbieder en Zorgverlener)
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|Zorgaanbieder toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Volgens de zib kan alleen een Zorgverlener worden gemodelleerd. Bij bijvoorbeeld groepsvaccinaties zijn deze gegevens niet altijd beschikbaar. Daarom is Zorgaanbieder als aparte bouwsteen toegevoegd.
|-
| style="background-color: white;vertical-align:top;"|Uitvoerder (Zorgaanbieder)
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|Om aan te sluiten bij nationale en internationale terminologie is in de Zorgnetwerk-usecase gekozen voor Uitvoerder in plaats van Toediener. Hieraan is een Zorgaanbieder gekoppeld, zodat contact mogelijk is zonder dat een persoon hoeft te worden vastgelegd.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieAanleiding
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|Waarde die de aanleiding weergeeft waarom een vaccinatie wordt gegeven.
|-
| style="background-color: white;vertical-align:top;"|ZiekteWaarTegenGevaccineerdWordt
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toedieningsweg
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|AnatomischeLocatie (Locatie en Lateraliteit)
| style="background-color: white;vertical-align:top;"|2024
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|Toelichting
| style="background-color: white;vertical-align:top;"|2020
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Niet aanwezig
| style="background-color: white;vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"|StatusToediening
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| style="background-color: white;vertical-align:top;"|VaccinatieIndicatie
| style="background-color: white;vertical-align:top;"|-
| style="background-color: white;vertical-align:top;"|Toegevoegd
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"|Waarde die de persoonsspecifieke reden beschrijft waarom de vaccinatie bij deze patiënt wordt toegediend.
|}

De zib Vaccinatie vormt het uitgangspunt voor de modellering in beide usecases. De informatiebehoefte voor de zib, de uitwisseling met de patiënt en de uitwisseling tussen (zorg)aanbieders verschilt momenteel nog. Het streven is om deze verschillen in de toekomst zoveel mogelijk te harmoniseren, zodat gegevensuitwisseling tussen patiënt, zorgprofessional en in internationale context eenvoudiger wordt. De in deze tabel beschreven afwijkingen ten opzichte van de zib zijn afgestemd met het zibcentrum van Nictiz.

==Verantwoordelijkheid voor informatie==
PGO usecase: Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en (zorg)aanbieders wanneer de zorggebruiker met de betreffende (zorg)aanbieder een behandelrelatie in de zin van de WGBO heeft (gehad). Er zijn echter ook relevante gezondheidsgegevens over de zorggebruiker beschikbaar in andere domeinen. Een voorbeeld hiervan is het publieke gezondheidsdomein (Wet publieke gezondheid), waar onder meer informatie bekend is over welke vaccinaties zijn gegeven in het kader van het rijksvaccinatieprogramma en Covid-19. Ook bij de uitvoering van de Wet langdurige zorg zijn er relevante gegevens bekend bij bijvoorbeeld het CIZ en bij zorgkantoren.

MedMij heeft een [https://afsprakenstelsel.medmij.nl/asverplicht/mmverplicht/addendum-aanbieder-zonder-behandelrelatie addendum] in het Afsprakenstelsel opgenomen wat het mogelijk maakt om ook deze gezondheidsgegevens te kunnen uitwisselen met het persoonsdomein door Aanbieders zonder behandelrelatie te ondersteunen en beschrijft de wijzigingen in verantwoordelijkheden en implementatie die een DVA moet doorvoeren. Een aanbieder zonder behandelrelatie mag enkel op het MedMij-netwerk diensten aanbieden na uitdrukkelijke toestemming van stichting MedMij.

==Afschermen van gegevens==
Er zijn geen afspraken over het afschermen van gegevens.

==Infrastructuur==
Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

=Referenties=
{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
| style="background-color: white;"| -
|}

=Release notes=
In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

==Releasenotes alpha publicatie 2.1.0==
{| class="wikitable" "cellpadding="10" width="81%"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS-ticket
!style="text-align:left;"|Omschrijving

|-
| style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://nictiz.atlassian.net/browse/VI-94 VI-94]
| style="background-color: white;"| Aanpassingen t.b.v. toevoegen usecase: usecase toegevoegd op pagina Functioneel Ontwerp, tekstuele wijzigingen gedaan ter ondersteuning van de toegevoegde usecase, Transactie toegevoegd in ART-DECOR
|}

==Releasenotes publicatie 2.0.5==
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-16T17:11:07Z

Thirza Hol: /* Algemeen */

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-16T17:03:18Z

Thirza Hol: /* Reikwijdte Informatiestandaard */

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-16T11:48:24Z

Thirza Hol: /* Algemeen */

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-16T11:47:53Z

Thirza Hol: /* Algemeen */