informatiestandaarden - Gebruikersbijdragen [nl]

gz:V3.2 Testscript

2026-07-23T12:26:47Z

Ahsen Yurt:

__NOINDEX__



<div class="noprint" style="background-color:#FAFAFA; position:fixed; bottom:2%; right:0.5%; padding:0; margin:0;">
[[#BackToTop|Back to Top]]
</div>



__NUMBEREDHEADINGS__

{{DISPLAYTITLE:Geboortezorg {{VersieInfo|xstandaardx}}- Test - Echo}}
__TOC__



[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Jeugdgezondheidszorg.svg|75px|75px|link=jgz:Landingspagina_JGZ|Landingspagina Jeugdgezondheidszorg]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Huisartswaarneming.svg|75px|75px|link=Landingspagina_Huisartswaarneming|Huisartswaarneming]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Verpleegkundige Zorg.svg|75px|75px|link=Landingspagina_Verpleegkundige_Zorg|Verpleegkundige overdracht]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Medicatieproces.svg|75px|75px|link=Landingspagina_Medicatieproces|Medicatieproces]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Laboratoria.svg|75px|75px|link=Landingspagina_Labuitwisseling|Laboratoria]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Acute Zorg.svg|75px|75px|link=Landingspagina_Acute_Zorg|Acute zorg]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Geboortezorg.svg|75px|75px|link=Landingspagina_Geboortezorg|Geboortezorg]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Ketenzorg.svg|75px|75px|link=Landingspagina_Ketenzorg|Ketenzorg]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard BgZ.svg|75px|75px|link=Landingspagina_BgZ|BgZ]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|75px|75px|link=imm:Landingspagina_Vaccinatie_Immunisatie|Vaccinatie-Immunisatie]]

[[Bestand:Icoon_Nictiz_Cirkel_Eerstelijnszorg.svg|75px|75px|link=hg:Landingspagina_ELZ|Eerstelijnszorg]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Beeld_en_Verslagen.svg|75px|75px|link=Landingspagina_Beeldbeschikbaarheid|Beeldbeschikbaarheid]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Contra-indicaties en Overgevoeligheden (2).svg|75px|75px|link=Landingspagina Contra-indicaties en Overgevoeligheden|Contra-indicaties en Overgevoeligheden]]


= Inleiding =
== Algemene informatie ==

Dit testscript is opgesteld op naam van Nictiz. De op te vragen onderdelen zijn waar mogelijk gekoppeld aan zorginformatiebouwstenen. Actuele informatie over de informatiestandaard van dit testscript kan je vinden via de {{highlight|hoofdpagina van AANPASSEN: [[link naar IS|naam informatiestandaard]]}}.
Het testen geeft de mogelijkheid om de technische berichten te controleren. Visuele controle van schermafdrukken is geen onderdeel van het testen. Het advies is om alle relevante scenario's te testen. De testmaterialen kunnen worden aangevuld en gewijzigd.

== Doelgroep ==

De doelgroep van dit testscript is de leverancier die zich wil voorbereiden op de kwalificatie voor het uitwisselen van {{highlight|NaamInformatiestandaard}}.
Dit testmateriaal is ontwikkeld voor de systeemrol:

* Sturen/Ontvangen
* Raadplegend/Beschikbaar stellen
* Vastleggen
* Verwerken

Dit document beschrijft het te doorlopen script bij testen voor kwalificatie voor de systeemrol:
* {{highlight| '''''VO'''orschrift '''S'''turend systeem'' (MP-VOS) medicatieafspraak met of zonder verstrekkingsverzoek, lengte, gewicht, nierfunctiewaarde.}}

== Voorwaarden voor testen==
Voor het uitvoeren van deze test gelden de algemene voorwaarden voor testen en kwalificeren bij Nictiz.
Specifiek de onderstaande voorwaarden:
* Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie et cetera.
* Kennis, begrip, en het naleven van de aandachtspunten zoals beschreven in dit document.
* De testdocumentatie bevat de gegevens die de testende partij zelf invoert.
* Kennis en begrip van de Informatiestandaard {{highlight|NaamInformatiestandaard}}

== Begrippenlijst ==
Nictiz maakt gebruik van bepaalde afkortingen en termen. Meer informatie kan gevonden worden in [https://nictiz.nl/standaarden/begrippen/ deze algemene begrippenlijst]. Daarnaast is er een [https://thesauruszorgenwelzijn.multites.net/ thesaurus] waarin begrippen kunnen worden opgezocht.

= Test-informatie =
Nictiz biedt leveranciers de mogelijkheid hun producten en diensten te testen op correcte implementatie van informatiestandaarden ter voorbereiding op de kwalificatie.
Bij het uitvoeren van deze testen is het niet nodig om schermafbeeldingen te maken, maar kunnen behulpzaam zijn in het corrigeren van fouten. Daarnaast maakt het testen van infrastructurele eisen geen onderdeel uit van dit script.
== Testaanpak ==
Houd tijdens het testen de bevindingen bij van de uitgevoerde tests. Analyseer de bevindingen, corrigeer fouten waar nodig en test opnieuw.
==Tools voor testen/kwalificatie==
===ART-DECOR===
Voor meer informatie over het testen met de simulator vanuit ART-DECOR: [https://decor.nictiz.nl/wiki/index.php/Testen_met_ART-DECOR Testen met ART-DECOR].

# Maak het volgens de inhoudelijke gegevens de testpersoon aan.
# Stuur het technisch bericht richting de testsimulator.
# De testsimulator zal het bericht ontvangen en technisch valideren.
# Koppel het bericht aan de bijbehorende testsuite op de ‘Tests’ tab van de simulator.
# De testsimulator zal valideren of het bericht de verwachte inhoud heeft.

===ConformanceLab===
Nictiz stelt het testsysteem Conformancelab beschikbaar voor het testen van systeemrollen met bijbehorende informatiestandaarden als voorbereiding op het kwalificatieproces. (Kandidaat)deelnemers kunnen Conformancelab eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.

Voor het aansluiten op ConformanceLab is [[Kwalificatie:V1.0_Handleiding_Conformancelab|een aparte handleiding beschikbaar]].

-->

= Testscript =
== Uit te voeren stappen ==
-->

Voer – voor ieder scenario – de volgende stappen uit:

'''Beschikbaarstellen'''
# Maak in het XIS de zorgverlener en zorgaanbieder aan, zoals beschreven in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Registreer in het XIS de persoonsgegevens voor de testpersonen zoals beschreven in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Maak in het XIS de {{highlight|"NAAM VAN DE GEGEVENS”}} voor deze personen aan, gebruik hiervoor de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Start het raadplegen van de gegevens op vanaf de testsimulator (ConformanceLab.
# {{font color||yellow|"NAAM VAN DE GEGEVENS”}} beschikbaarstellen [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: zorg dat de gevraagde selectie is toegepast op de gegevens.}}

'''Raadplegen'''
# Raadpleeg {{font color||yellow|"NAAM VAN DE GEGEVENS”}} voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: maak een schermafdruk van de toegepaste selectie.}}
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN SET GEGEVENS”}} beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Ontvang en verwerk (gestructureerd opslaan in database) de {{highlight|"NAAM VAN DE GEGEVENS”}} in het systeem.

'''Ontvangen'''
# Maak in het XIS de zorgverlener en zorgaanbieder aan, zoals beschreven in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Registreer in het XIS de persoonsgegevens voor de testpersoon zoals opgenomen in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Start het sturen van de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]] op vanaf de testsimulator (ConformanceLab).
# Ontvang en verwerk (gestructureerd opslaan in database) de berichten in het XIS.

'''Sturen'''
# Maak de {{highlight|"NAAM VAN DE GEGEVENS”}} voor de testpersoon aan, gebruik hiervoor de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Stuur {{highlight|"NAAM VAN DE GEGEVENS”}} richting de testsimulator (ConformanceLab), [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]].
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN DE GEGEVENS”}} ontvangen en verwerken.

'''Vastleggend'''
# Maak de {{highlight|"NAAM VAN DE GEGEVENS”}} voor de testpersoon aan, gebruik hiervoor de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Stuur {{highlight|"NAAM VAN DE GEGEVENS”}} richting de testsimulator (ConformanceLab), [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]].
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN DE GEGEVENS”}} ontvangen en verwerken.

'''Verwerken'''
# Verwerk {{font color||yellow|"NAAM VAN DE GEGEVENS”}} voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: maak een schermafdruk van de toegepaste selectie.}}
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN SET GEGEVENS”}} beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Ontvang en verwerk (gestructureerd opslaan in database) de {{highlight|"NAAM VAN DE GEGEVENS”}} in het systeem.

== Overzicht testscenario's ==


{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || Voorbeeld || Voorbeeld || Voorbeeld || Voorbeeld
|-
| 2 || Voorbeeld || Voorbeeld || Voorbeeld || Voorbeeld
|-
| 3 || Voorbeeld || Voorbeeld || Voorbeeld || Voorbeeld
|}

= Aandachtspunten voor inhoudelijke gegevens =
== Persoonsgegevens ==
Er is een fictief BSN (fBSN) voor testdoeleinden in de persoonsgegevens opgenomen. Dit is alleen bedoeld voor gebruik in het XIS (registratie van de testpersoon).
== Variabele T-datum ==
Test- en kwalificatiescenario's werken vaak met relatieve datums, die ervoor zorgen dat scenario's niet gedateerd raken. Een datum 'volgende week' blijft zodoende altijd in de toekomst. Om dit te vertalen naar concrete datums die gebruikt worden tijdens het testen en kwalificeren wordt gewerkt met de zogenaamde T-datum.

Voor ConformanceLab geldt: De T datum is altijd de maandag van de week waarin je de tests van dit script uitvoert. Als ergens staat T-100 betekent dit dus: 100 dagen eerder dan de huidige maandag.

Voor de kwalificatieserver van ART-DECOR geldt: Als ergens staat T – 10D betekent dit: 10 dagen eerder dan die afgesproken datum/tijd. Het format is yyyy-mm-ddTuu:mm:ss“

= Inhoudelijke gegevens =
<noinclude>
__NUMBEREDHEADINGS__

=Addenda voor inhoudelijke gegevens Integrale zwangerschapskaart 3.2=</noinclude>
==Scenario Echo casus 1==
<section begin= />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="4" | Vrouw
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="3" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Demografische gegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Patient
|style="background-color: white;"|Zie [[#XXX_Osse_Vrouw|Patient: XXX_Osse_Vrouw]]
|}<section end= />
=== Administratief ===
<section begin=administratief_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="6" | Administratief
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="5" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Betaler
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="11"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Verzekeraar
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="9"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verzekering
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BeginDatumTijd
|style="background-color: white;"|T - 119 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EindDatumTijd
|style="background-color: white;"|T + 246 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Verzekeringssoort
|style="background-color: white;"|Basis (code = 'B' in codeSystem 'ZIB Verzekeringssoort')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|IdentificatieNummer
|style="background-color: white;"|1235 (in identificerend systeem: UZOVI)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|OrganisatieNaam
|style="background-color: white;"|NN
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|VerzekerdeNummer
|style="background-color: white;"|123456
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Patient XXX_Osse_Vrouw
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="30"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Naamgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Voornamen
|style="background-color: white;"|Leonie
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Initialen
|style="background-color: white;"|L
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Naamgebruik
|style="background-color: white;"|Eigen geslachtsnaam (code = 'NL1' in codeSystem 'ZIB Naamgebruik')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslachtsnaam
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Achternaam
|style="background-color: white;"|XXX_Osse
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Adresgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Straat
|style="background-color: white;"|Knolweg
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Huisnummer
|style="background-color: white;"|1000
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Postcode
|style="background-color: white;"|9999XA
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Woonplaats
|style="background-color: white;"|STITSWERD
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Land
|style="background-color: white;"|Nederland (code = 'NL' in codeSystem 'ISO 3166-1 (alpha-2)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|AdresSoort
|style="background-color: white;"|Woon-/verblijfadres (code = 'PHYS' in codeSystem 'HL7 AddressUse')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Contactgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="9"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Telefoonnummers
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="3"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Telefoonnummer
|style="background-color: white;"|06-12345678
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|TelecomType
|style="background-color: white;"|Mobiel telefoonnummer (code = 'MC' in codeSystem 'HL7 AddressUse')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|EmailAdressen
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="3"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EmailAdres
|style="background-color: white;"|l.osse@test.nl
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EmailSoort
|style="background-color: white;"|Privé e-mailadres (code = 'HP' in codeSystem 'HL7 AddressUse')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Identificatienummer
|style="background-color: white;"|999901710 (in identificerend systeem: BSN)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geboortedatum
|style="background-color: white;"|13 jun 1998
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslacht (administratief)
|style="background-color: white;"|Vrouw (code = 'F' in codeSystem 'HL7 AdministrativeGender')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Patient XXX_Osse_Kind
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Naamgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslachtsnaam
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Achternaam
|style="background-color: white;"|XXX_Osse
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Foetus
|style="background-color: white;"|Zie [[#XXX_Osse_Foetus|Foetus: XXX_Osse_Foetus]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Zorgaanbieder ZA1_EchopraktijkGroei
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgaanbiederIdentificatienummer
|style="background-color: white;"|90012345 (in identificerend systeem: AGB-Z)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieNaam
|style="background-color: white;"|Echopraktijk Groei
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|AfdelingSpecialisme
|style="background-color: white;"|Echoscopie (code = '9018' in codeSystem 'COD016-VEKT Zorgverlenersspecificatie (subberoepsgroep)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieType
|style="background-color: white;"|Echocentrum (code = 'B2' in codeSystem 'RoleCodeNL - zorgaanbiedertype (organisaties)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Zorgaanbieder ZA2_VerloskundigenPraktijk_VeiligZwanger
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgaanbiederIdentificatienummer
|style="background-color: white;"|87654321 (in identificerend systeem: URA)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieNaam
|style="background-color: white;"|Verloskundigenpraktijk Veilig Zwanger
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|AfdelingSpecialisme
|style="background-color: white;"|Verloskundigen, niet nader gespecificeerd (code = '0800' in codeSystem 'COD016-VEKT Zorgverlenersspecificatie (subberoepsgroep)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieType
|style="background-color: white;"|Verloskundigenpraktijk (code = 'G3' in codeSystem 'RoleCodeNL - zorgaanbiedertype (organisaties)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Zorgverlener ZV1_HelmaGroot
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="12"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgverlenerIdentificatienummer
|style="background-color: white;"|8452962 (in identificerend systeem: UZI Personen)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Naamgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Voornamen
|style="background-color: white;"|Helma
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Initialen
|style="background-color: white;"|H
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Naamgebruik
|style="background-color: white;"|Eigen geslachtsnaam (code = 'NL1' in codeSystem 'ZIB Naamgebruik')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslachtsnaam
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Achternaam
|style="background-color: white;"|XXX_Groot
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Specialisme
|style="background-color: white;"|Verloskundige (code = '03.000' in codeSystem 'RoleCodeNL - zorgverlenertype (personen)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Zorgaanbieder
|style="background-color: white;"|Zie [[#ZA2_VerloskundigenPraktijk_VeiligZwanger|Zorgaanbieder: ZA2_VerloskundigenPraktijk_VeiligZwanger]]
|}<section end=administratief_ />
=== Zorgverlening ===
<section begin=zorgverlening_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="5" | Zorgverlening
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="4" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|ZorgEpisode
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="8"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Identificatienummer
|style="background-color: white;"|2135467 (in identificerend systeem: 2.16.840.1.113883.2.4.3.11.999.60.8)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|BeginDatum
|style="background-color: white;"|T - 705 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|EindDatum
|style="background-color: white;"|T - 509 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgEpisodeVerantwoordelijke
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Zorgverlener
|style="background-color: white;"|Zie [[#ZV1_HelmaGroot|Zorgverlener: ZV1_HelmaGroot]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|StatusZorgepisode
|style="background-color: white;"|Afgesloten (code = 'finished' in codeSystem '2.16.840.1.113883.4.642.1.649')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Verwijsgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verwijzing van/ afkomstig van
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Zorgaanbieder
|style="background-color: white;"|Zie [[#ZA2_VerloskundigenPraktijk_VeiligZwanger|Zorgaanbieder: ZA2_VerloskundigenPraktijk_VeiligZwanger]]
|}<section end=zorgverlening_ />
=== Zwangerschapsgegevens ===
<section begin=zwangerschapsgegevens_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="5" | Zwangerschapsgegevens
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="4" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Zwangerschap
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="9"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Zwangerschapsduur
|style="background-color: white;"|140 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Pariteit
|style="background-color: white;"|0
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Graviditeit
|style="background-color: white;"|1
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ATermeDatumItems
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ATermeDatum
|style="background-color: white;"|T - 509 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BepalingsMethode
|style="background-color: white;"|aterme datum berekend door middel van diagnostische ultrasonografie (code = '31541000146106' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|DatumBepaling
|style="background-color: white;"|T - 649 dagen
|}<section end=zwangerschapsgegevens_ />
=== Foetus ===
<section begin=foetus_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="3" | Foetus
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="2" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Identificator (foetus)
|style="background-color: white;"|baby A
|}<section end=foetus_ />
=== Medisch onderzoek ===
<section begin=medisch_onderzoek_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="7" | Medisch onderzoek
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="6" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="7"|Media Media1
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Beeld
|style="background-color: white;"|JVBERi0xLjMKJcTl8uXrp/Og0MTGCjMgMCBvYmoKPDwgL0ZpbHRlciAvRmxhdGVEZWNvZGUgL0xlbmd0aCAyMTYgPj4Kc3RyZWFtCngBlZBPawIxEMXv+RSvanViu7Obv7t7VXrpTQh4UE+LHgQLdr8/mERj8VhCeJPkzZvwu2KDK1SHKm7Xe3RW4/eILX5Qr0eFYUST1zhEY8Pa3s+piC1eK+41hotYBbi7M0rXt+y9t3CtQ7igDkFDIZywA71JVA0b0KQUUxmTHWiWVAt6zw+qXICKYZ4MFrRIGt+L7qlE7WXpXUp47sXT8/GZ00FFq+yMY1nCsv9Lq3Oc4RbUlNyJFAeEb3yFSCwx+xcdvNBR1mg2JtMRL3QofT+cH1NuLL1PbAplbmRzdHJlYW0KZW5kb2JqCjEgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvUmVzb3VyY2VzIDQgMCBSIC9Db250ZW50cyAzIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXQo+PgplbmRvYmoKNCAwIG9iago8PCAvUHJvY1NldCBbIC9QREYgL1RleHQgXSAvQ29sb3JTcGFjZSA8PCAvQ3MxIDUgMCBSID4+IC9Gb250IDw8IC9UVDIgNyAwIFIKPj4gPj4KZW5kb2JqCjggMCBvYmoKPDwgL04gMyAvQWx0ZXJuYXRlIC9EZXZpY2VSR0IgL0xlbmd0aCAyNjEyIC9GaWx0ZXIgL0ZsYXRlRGVjb2RlID4+CnN0cmVhbQp4AZ2Wd1RT2RaHz703vdASIiAl9Bp6CSDSO0gVBFGJSYBQAoaEJnZEBUYUESlWZFTAAUeHImNFFAuDgmLXCfIQUMbBUURF5d2MawnvrTXz3pr9x1nf2ee319ln733XugBQ/IIEwnRYAYA0oVgU7uvBXBITy8T3AhgQAQ5YAcDhZmYER/hEAtT8vT2ZmahIxrP27i6AZLvbLL9QJnPW/3+RIjdDJAYACkXVNjx+JhflApRTs8UZMv8EyvSVKTKGMTIWoQmirCLjxK9s9qfmK7vJmJcm5KEaWc4ZvDSejLtQ3pol4aOMBKFcmCXgZ6N8B2W9VEmaAOX3KNPT+JxMADAUmV/M5yahbIkyRRQZ7onyAgAIlMQ5vHIOi/k5aJ4AeKZn5IoEiUliphHXmGnl6Mhm+vGzU/liMSuUw03hiHhMz/S0DI4wF4Cvb5ZFASVZbZloke2tHO3tWdbmaPm/2d8eflP9Pch6+1XxJuzPnkGMnlnfbOysL70WAPYkWpsds76VVQC0bQZA5eGsT+8gAPIFALTenPMehmxeksTiDCcLi+zsbHMBn2suK+g3+5+Cb8q/hjn3mcvu+1Y7phc/gSNJFTNlReWmp6ZLRMzMDA6Xz2T99xD/48A5ac3Jwyycn8AX8YXoVVHolAmEiWi7hTyBWJAuZAqEf9Xhfxg2JwcZfp1rFGh1XwB9hTlQuEkHyG89AEMjAyRuP3oCfetbEDEKyL68aK2Rr3OPMnr+5/ofC1yKbuFMQSJT5vYMj2RyJaIsGaPfhGzBAhKQB3SgCjSBLjACLGANHIAzcAPeIACEgEgQA5YDLkgCaUAEskE+2AAKQTHYAXaDanAA1IF60AROgjZwBlwEV8ANcAsMgEdACobBSzAB3oFpCILwEBWiQaqQFqQPmULWEBtaCHlDQVA4FAPFQ4mQEJJA+dAmqBgqg6qhQ1A99CN0GroIXYP6oAfQIDQG/QF9hBGYAtNhDdgAtoDZsDscCEfCy+BEeBWcBxfA2+FKuBY+DrfCF+Eb8AAshV/CkwhAyAgD0UZYCBvxREKQWCQBESFrkSKkAqlFmpAOpBu5jUiRceQDBoehYZgYFsYZ44dZjOFiVmHWYkow1ZhjmFZMF+Y2ZhAzgfmCpWLVsaZYJ6w/dgk2EZuNLcRWYI9gW7CXsQPYYew7HA7HwBniHHB+uBhcMm41rgS3D9eMu4Drww3hJvF4vCreFO+CD8Fz8GJ8Ib4Kfxx/Ht+PH8a/J5AJWgRrgg8hliAkbCRUEBoI5wj9hBHCNFGBqE90IoYQecRcYimxjthBvEkcJk6TFEmGJBdSJCmZtIFUSWoiXSY9Jr0hk8k6ZEdyGFlAXk+uJJ8gXyUPkj9QlCgmFE9KHEVC2U45SrlAeUB5Q6VSDahu1FiqmLqdWk+9RH1KfS9HkzOX85fjya2Tq5FrleuXeyVPlNeXd5dfLp8nXyF/Sv6m/LgCUcFAwVOBo7BWoUbhtMI9hUlFmqKVYohimmKJYoPiNcVRJbySgZK3Ek+pQOmw0iWlIRpC06V50ri0TbQ62mXaMB1HN6T705PpxfQf6L30CWUlZVvlKOUc5Rrls8pSBsIwYPgzUhmljJOMu4yP8zTmuc/jz9s2r2le/7wplfkqbip8lSKVZpUBlY+qTFVv1RTVnaptqk/UMGomamFq2Wr71S6rjc+nz3eez51fNP/k/IfqsLqJerj6avXD6j3qkxqaGr4aGRpVGpc0xjUZmm6ayZrlmuc0x7RoWgu1BFrlWue1XjCVme7MVGYls4s5oa2u7act0T6k3as9rWOos1hno06zzhNdki5bN0G3XLdTd0JPSy9YL1+vUe+hPlGfrZ+kv0e/W3/KwNAg2mCLQZvBqKGKob9hnmGj4WMjqpGr0SqjWqM7xjhjtnGK8T7jWyawiZ1JkkmNyU1T2NTeVGC6z7TPDGvmaCY0qzW7x6Kw3FlZrEbWoDnDPMh8o3mb+SsLPYtYi50W3RZfLO0sUy3rLB9ZKVkFWG206rD6w9rEmmtdY33HhmrjY7POpt3mta2pLd92v+19O5pdsN0Wu067z/YO9iL7JvsxBz2HeIe9DvfYdHYou4R91RHr6OG4zvGM4wcneyex00mn351ZzinODc6jCwwX8BfULRhy0XHhuBxykS5kLoxfeHCh1FXbleNa6/rMTdeN53bEbcTd2D3Z/bj7Kw9LD5FHi8eUp5PnGs8LXoiXr1eRV6+3kvdi72rvpz46Pok+jT4Tvna+q30v+GH9Av12+t3z1/Dn+tf7TwQ4BKwJ6AqkBEYEVgc+CzIJEgV1BMPBAcG7gh8v0l8kXNQWAkL8Q3aFPAk1DF0V+nMYLiw0rCbsebhVeH54dwQtYkVEQ8S7SI/I0shHi40WSxZ3RslHxUXVR01Fe0WXRUuXWCxZs+RGjFqMIKY9Fh8bFXskdnKp99LdS4fj7OIK4+4uM1yWs+zacrXlqcvPrpBfwVlxKh4bHx3fEP+JE8Kp5Uyu9F+5d+UE15O7h/uS58Yr543xXfhl/JEEl4SyhNFEl8RdiWNJrkkVSeMCT0G14HWyX/KB5KmUkJSjKTOp0anNaYS0+LTTQiVhirArXTM9J70vwzSjMEO6ymnV7lUTokDRkUwoc1lmu5iO/kz1SIwkmyWDWQuzarLeZ0dln8pRzBHm9OSa5G7LHcnzyft+NWY1d3Vnvnb+hvzBNe5rDq2F1q5c27lOd13BuuH1vuuPbSBtSNnwy0bLjWUb326K3tRRoFGwvmBos+/mxkK5QlHhvS3OWw5sxWwVbO3dZrOtatuXIl7R9WLL4oriTyXckuvfWX1X+d3M9oTtvaX2pft34HYId9zd6brzWJliWV7Z0K7gXa3lzPKi8re7V+y+VmFbcWAPaY9kj7QyqLK9Sq9qR9Wn6qTqgRqPmua96nu37Z3ax9vXv99tf9MBjQPFBz4eFBy8f8j3UGutQW3FYdzhrMPP66Lqur9nf19/RO1I8ZHPR4VHpcfCj3XVO9TXN6g3lDbCjZLGseNxx2/94PVDexOr6VAzo7n4BDghOfHix/gf754MPNl5in2q6Sf9n/a20FqKWqHW3NaJtqQ2aXtMe9/pgNOdHc4dLT+b/3z0jPaZmrPKZ0vPkc4VnJs5n3d+8kLGhfGLiReHOld0Prq05NKdrrCu3suBl69e8blyqdu9+/xVl6tnrjldO32dfb3thv2N1h67npZf7H5p6bXvbb3pcLP9luOtjr4Ffef6Xfsv3va6feWO/50bA4sG+u4uvnv/Xtw96X3e/dEHqQ9eP8x6OP1o/WPs46InCk8qnqo/rf3V+Ndmqb307KDXYM+ziGePhrhDL/+V+a9PwwXPqc8rRrRG6ketR8+M+YzderH0xfDLjJfT44W/Kf6295XRq59+d/u9Z2LJxPBr0euZP0reqL45+tb2bedk6OTTd2nvpqeK3qu+P/aB/aH7Y/THkensT/hPlZ+NP3d8CfzyeCZtZubf94Tz+wplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKWyAvSUNDQmFzZWQgOCAwIFIgXQplbmRvYmoKMiAwIG9iago8PCAvVHlwZSAvUGFnZXMgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL0NvdW50IDEgL0tpZHMgWyAxIDAgUiBdID4+CmVuZG9iago5IDAgb2JqCjw8IC9UeXBlIC9DYXRhbG9nIC9QYWdlcyAyIDAgUiA+PgplbmRvYmoKNyAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHJ1ZVR5cGUgL0Jhc2VGb250IC9BQUFBQUMrQXB0b3MgL0ZvbnREZXNjcmlwdG9yCjEwIDAgUiAvVG9Vbmljb2RlIDExIDAgUiAvRmlyc3RDaGFyIDMzIC9MYXN0Q2hhciA0OCAvV2lkdGhzIFsgMjYwIDU1MSA1NjEKMjM5IDQ1MiA1NTkgNTI3IDI2MCAyMDMgNDg0IDU2MSA1NTIgMzM0IDMyMyA1NjEgNTMxIF0gPj4KZW5kb2JqCjExIDAgb2JqCjw8IC9MZW5ndGggMzIwIC9GaWx0ZXIgL0ZsYXRlRGVjb2RlID4+CnN0cmVhbQp4AV2Sy2rDMBBF9/oKLdNFsOwkTgPGUFICXvRB3X6ALY2DoJaFrCz8972jpCl0cRZHM1eSR86OzXPjbJTZe5h0S1EO1plA83QJmmRPZ+tEXkhjdbxZWtNj50WGcLvMkcbGDZOsKiFl9oHIHMMiV09m6umB196CoWDdWa6+jm1aaS/ef9NILkol6loaGrDdS+dfu5FklqLrxqBu47JG6q/jc/EkcSMk8uuV9GRo9p2m0LkziUqpujqdakHO/Cvl5TXRD7fWIq8rRqntoRZVUUCBUiWxbqAAumXdQgE0Ne+gQKl9ydUSCqA71j0UoDnpIxRANVcPUKBUoVg7KEB1z9pDAbRg1VAAHVgNFOCgVCUogKZLDlAA5Z03mAWDbJ4m8vvpPBx+xPvQ9SUEzDu9dHoKHrF1dP8Z/OR5pIkfmCWhAQplbmRzdHJlYW0KZW5kb2JqCjEwIDAgb2JqCjw8IC9UeXBlIC9Gb250RGVzY3JpcHRvciAvRm9udE5hbWUgL0FBQUFBQytBcHRvcyAvRmxhZ3MgNCAvRm9udEJCb3ggWy01MDAgLTI3NSAxMTgyIDEwMTBdCi9JdGFsaWNBbmdsZSAwIC9Bc2NlbnQgOTM5IC9EZXNjZW50IC0yODIgL0NhcEhlaWdodCA2NTcgL1N0ZW1WIDAgL1hIZWlnaHQKNDc2IC9BdmdXaWR0aCA1NjEgL01heFdpZHRoIDEyNjkgL0ZvbnRGaWxlMiAxMiAwIFIgPj4KZW5kb2JqCjEyIDAgb2JqCjw8IC9MZW5ndGgxIDcwOTIgL0xlbmd0aCA0NjE1IC9GaWx0ZXIgL0ZsYXRlRGVjb2RlID4+CnN0cmVhbQp4AY1YeXAUV3p/3T2XZkbSjE5gJLpHrRmOkRBISEIC7EGjWxxCB0xLCM1odB8gxuZGWDbWIrfPtVlgbcc2Xhtsk832YHtXuLK+UnYqFcMmf2S3KuWNl3UlW1ubuNhUskm5QJPfe90SmPVuZaaP9x3ve9/9uvvB+MEB4iDTRCBrYxPRScJ+mTdx2xA79KCkw8Iw7h8OTg5N6LBpJSHpp4bGjw7qcNZWQqyNwwPRfh0mt3CvGAZCh7n1uBcOTzx4RIcz/xL32vH9MYOeBXmkcCJ6xFiffA5Y2hedGND5PWcoPBkfMOhcmBA+Xaf9mSsHmpvsJBbGwxMXKQGK47emn2IYSuf5p/9nReo/9KZv+m/isDH0L187+DUd/Hq4tPwWd/taykFbFkAL4RkZEmDtqdsfEGL33+L+9z9BNwiLN3cw2bs2Ke5dlxR7SuLinpLnxO6SpNi1Jikqa66J4aKkuLs4Ke4qviZ2BpJix6pmsX1VUmxbnRR3rr4stq6SxB0r68TtKy+L21Ymxa0rkmKLPyk2+wNiU+GQ2Fh4TWwoTIr1vqRY57ss1spJMVSQFGu818Qt3qQY9F4W75euifdJSXGz9Jy4SSoRNy6Pi9XLk2KVmBQ3iNNiZX5crMhPiuX518T1edfEsrykWJp3WVy3Ni6uKdosFhfFxdWr9oo+rFW4zLN0j1wQFAuEZUv3eJdtFqVNGIjLh8Tlq5bk7MnPTYp5OUnRU760untJRU5197JgKx3n0nH20o05w12ZVRmd7ipXZ4biUlKrnJ3mKr7ThNOppFekdTqq7J3WKktnmmJXLApRUqpsnQKoNoVXXEQIBs3cVe4Z0hFombMm21o0W2u3xs1qvnZ6De7s0iyzGuns6g4nOO4pZebJJ0l+TYv2THv4ikAwVBI8H9oZTpiEp5QaEiCBAE79z4YGHAhwd/0JxvQANxvQWRiw2bix8SKgw5RFx99hA2YJMdfQP8lI/lPyN8K/IytJ8quFc/755H+Yc0mGDpMT5GEygf9h0o8/HR8jk+QQaScD5CAZJ0PgGMP1ATJKfkGipIvESQc4hshxcH+HDGPGIVwPAH6URMh+SDpOtmF+mEmIgnMc1EOQPsUkUf42QCOQfwoyOyGzH1LiqJ3dpAf8B4LN3z9/7uzp78w8euqRh6cfOjl14vixo0cOHzr44APxA5P7902Mj42ODA8NDvTH+qKR3r09e7q7lPDuXZ0d7Ttbd2zftrWluamxoX6l6LKnFHEJhz0khwbsxUUkYXdg6Cgu4jRLSLMypLYjICGoYW9LW7iu1uP1Kh7ZqwU1k6+OntF+NbZAUCACszAXIlra5ZadXWGpTo2wWcB0fAPS6RuoREYzRhof6ghr9QHgGUWHGxgMRh1svIfctECWJY20qmp/ggg+iAl6EhwbmEOPK7BEkbW+gOyVwwMQlbARp7cjEsLIuTDipAasIM25SB/O2G55jjNGXWFNigwqjeAmvE9jR/scKZeP6OOIJsUkSbP45L7WsOrVuIjsMeC2MDzGRT2qV/ZKijKX/CiPcsteyOJJTULmZncmgtxse1f4qgu9dbYjfIXn+FAEpVIIWviqREiQYVE5kRqKpCwSBUgLh8hc4W2M33M1SMg0o5oYgsExWMFwOhNwHInN8TrOxfgSfrZQEH01NmfSKcEFCSbgbDpuWudeaXDbQHFRynuERydmRIX94CUEMmg3B23BlKCTT+URC4q6Asx74E3hyNtOLpXzJCATFgA9x00nUoKeq0ySjnqPmwYnxU1DoMHGE8p2lyCsqBveiZthQWdX+G0ngXx2BUcN/RUX1SX47QH5TlrvDCOAdQlueyCC1G4BKPjqJKS1FmwPU96IBznvVZTa4iKaXVJYHvDISiIrS52sS7hcoRY1hERHrrEES0Qt/khADWs05Wiiya5qpK3ga4rJ9RGwyCgbHE1AxXZJEa0vEsBQctWrIEuxKOUmOQle8CU4k4+7j9wHv1mcml0eqNEccs0i5X5yv06xUIpVrtG4HN3rdXKdtGREjcl9yMBga3jIM6hEIVsLylHNJNd4EiZSg+pawsGkugTZHoBtLcjBHYHWbhQpdYakqrVSImjyR2NRCtd6UfeqQZJra2nRLsyok1QtGI1FwFGnMObiIqig1slRqR/NA+bCc+0y3Ry66CodXWHV2S/3y/BwMKhGYbZHiikeVYkxj0MdqEaKi8x3upPRnHjaA3yxQVzmJNIXkft0BK3Oe3FD9yIGwXU3Tm6my0HZZqo17mqzXNcPDnpG+zUBGeeV+rFj0ZQhraxv/EkmiFhkkhBTJlx1baR5QyHQGQQAh6oNfRMcXgTrQUYymHxr9FzRTH6aeWGvNurRxhWaLzpLVJvuk1TJJVfL9MLyrAHUhohm9jVo07Eo7EBPQu4B0QyEFO5DLkNgfURdyDhMM/kXV9L2IfZ3iURL5TqwNO+jXtCmW6WIIkUiwGJT8HokzYy7NBilyUXbbivWx9GK3o9bVG3HXEILyKNZsQMMRgdkL5o7cArzKwsfVm9GhoQ14lFVWdU4qOirBzPE+zWLv4necEwG5OgAgkjXk6IDbG491GXeofp56mSvAhbeR/1OHYc+10cvMRXZqPWg2sw+t5qhSlUqulYPGq7JH9sVwbYguaR6iYU6ikymTmiikAJBOmMKKpbNhwiqzUQg0WP13cEA6dP2B3RmG5MKzdrCWitdlB5WdmBwIKDxuRtApAHi2tA/0BUQKOo8s68J7g0i9Tx0tqTx2MpY09DnN9GpHgNjTAOGtV26a2Jf0VVw6Prqi1qofM3JjhSfZvMh0JoJOuhkKzVnQSYbQ2l9DlSCuroBGGMpus/RgxkSMQCTD26HPLY1UgNo5INRVH1U9swlP2xFj4wAisiKQpfHgbSjM5hoVRdM3QXJtm91hbGSvrjDpznARU3QEfrV7tNwwCjoTGm647AEUExfuo7hvavJDwkgeI75jbmOThB8p2kgUKRG3Q14tGEl0K8Ls+i3JgkdFZ07tpM9bXSjGmSvFX0MHkBDk7T2ADYRZttpNsOPFKcthGYlVy+TeuSQMSA5RCNyI0cvBKUlN2o8wMWRfIUnnE3eQG8p8oYEz1nR7dGDZVeqE41ejUX6sfVho4aXyQbPJvqoBH8g0DgQ20O0NXWEzR4TrSxUlHZYDynKCn6hDIv0w+iE1Fu6J22Upi4SqSPZZOptlCa7HgrYIO+PZ6m2/99iSAUWTS2FKUK7kd9GFfvTSwl6gJrpAmiuvG5GMzXFDEejplU1FsUTVk8arVCn3w18BmyqgmlVhm3wzQnY3UpXhw4wmIEdYWq+A0nAkscBggt+/EhPbQeILhj+ERqaoffVZJLAgQa37jr4F/JYnhtkVhhUGJ13OKBgVE/PCLjq6WlUksOoUuc9Xd8Qr8c05ZtEeVEY3ejlRYkUSnBOPAybPGas6JdccFc1C50flgBWqxOc1W8wICNdMLNaVR2yvqXItP1fxQMoYQ+XREF3/iZCm0LoVdWW+u0U2738qWwCLX5EOXXxTqUY5WAPaY4QfX5BALUU2ofWIL5Tn9B0Q1awx4m7tkOGoqV49ya5hPoejsYUeHw/a2aUccFvg6ykdXH3YjvCU1iEeuoTOMOlcbib/V56eqjrWM5pqIz9AUV/5JqiufEIK6lHApI0guesEIenLWyUGEvoBuC2+VmTU/HAMxLF1ow+RPuOsgTPUm306RhvALJL4jaRTfprkaxnXDv2AJMvvMlTpeC9Yi752zzar+AaHps8zg5VklxukFQpAy8a2gwtRZNBkxkOu7jFb3BRC2YCqqrz0WdyJ6+2tMMJ9I3NvsFjh06L71/nA3+OjM0p1IF+pfXKR7zUFdou+SgeFkKyJkl70BKBbMhTVBXbqSrTd6pdYf1KSVxRHn0yoE8xBq8nD+9od0AnpsKiueTbefR1aXG14wurxbEaXVZdWE6LfetqNMu4bnplB7MuUUFkfX2T31hU3aN24f3Qq+XThQ09AKbl0a7NNDlPNSHCJ4Tw2UQzBcmoaYpcMJ3AvZKMCr8iddxvyROgnTWNAD+q0/kfkgv8WSKZjpBzwkuEcK8Q+uPwpz8nvmitxt2L72IcSUEjt5J0kkbMxAaMBV8E7eBJxddBnvH34pvBB5i8hZvhl/Cb+C5+lv9YMAmrhF3CjPCa8Bok4Cd8Ym7G3HSSSYpJSXDZ6lxp2QpzocmeNWI3uVxr8gszMzk+TmxxfCwpdX1a6i7DJeDOyK1au+6A2+v2FfjL11eUleZkZ1nMXreX81dUVlSUr/fLBZZseYFitViswifzSwvXri0sLC2d3yLcd+tjbsC0cWN1Rduujt7JVx9+5IXWUGWBydz89Y+/KCksLKHni6aPb/2hbay4qKFi445w69TsibHW/vWBlnLqFw2XfnylEYjz3UUV1657wF3m1t4x13z9PjwxmvxKeFP4giwnK4k36F5mj9tkOZ04s6xxMY84YFRpaaDUXVXlLgusXVdX4KfGFFbeUR+WLeez3fIKi2VFaUVlucmSnZXDvdjxePtrXNHfnegdUF8devdgy2MTwRetoURz/ysV83/4TU9GcGrPqdl1fO1Uz+C+I2dq85pnRm4fPNPSPb238VNh71jTbuh2IfmVKZN+ZSIiyQ+6ltoc1riFxM32eKawoBp8Xsr0WmGVYVcFdTT1NFVGV9Lqzsnhj42fX5vy4qWy1/cf/qvegbkXHp196MTId1evmM1ob1LNNbdvbosc+NWlizfij33wo3c+nGydf6w5anjn8zsapNnjqSS+zGGzxjNdCxrAP3c8Q5fPhR4L7nD7WZjhka/YwlPDz5dceill/Wvbxp4qWjUzMHP6oYz4l5cu/suB7u288+v3n2pQHhto4A63jb3/o3cX4vMZ4rMMeZ0fTPPkkPR0IlIF9PVpbEoyqsoWY2NkmtW7nC9DPMrSeM7LlOArXv77vt6/Ofu3v+b5283cxumRyZPC60L/O/NRPkuYPXrs8YyZf336e19O37yRviql9+XISGzoezt5ZfaZp1E9dfOnhU9NO1BPeaSIbCKNpJVUBfO3l28baW4KhcoLfZs3F+fn5BSlFBeTcks8naTT3AlAu+ulqAl3WQbNIVwCiNcWPY8qK/Wy0GPll2ULTZ7MNTxyrDKXATlllTrvHweW5tmKiorK7AIL918v/bTju+ek4zev/+53bz1e8tDBM7XNJ1N7J9bs6Govv8+n7PAeubRr95vHpi62tb8xHZk6FO2depjrqA08vq/+4PzpxiP1nY96Kh+aefTNo5GG1ZsL3G0Vm7q5KvvGpoJ1u/PWp5fkZ4mZp3rOhXvOd3Wd7+k61x3fN35gYnJi3wT3/v17a4Un89HMyBOouB5zA+sXrp/YTZwlTuy0MVyH0bTuhLuawYVLHSVVVSUl1dXC9VulppnK1asr6YnKPQs5v0feOUnaj80kbmdCSpFmUeoMyMnKKSvL5q4ePrnmYolS3PJkzGS9xXVHZjH3AnrWPwqfkyySG3S6BIs1Di0chgRWLVAklxUKyta9niWH1X3hFUvxG6deefbS8m1NE2eKhetnN4789PLtJ/g9Dfvuj228vZ3aN5q8aSLCDXRDkbh+sgRpaJQBDarRHO4OFC1BWgA0rDn82qc/Gxv77Olnf7Z//8+eHZ/esGF6fOR4RcVx19EbL7z85bFjX778wo2jM72XRsffikbfGh+91EvXvDD/vCkTFWB0gUx3miO+1DCLpFHnshYFBdoX7GINQC7wr3Bzd3eBC6+a178+cYQ2gBPDL5ZwWTOnTx4be27Vytn5583rX97ehxbw+o0H2hvn3dwvP0i8/X586/zs1l7dp/ys8M/I/uygI2VhcRbZuz1alk1thS//wrLq2YNZuU372iTh+sWtg9/3h4pud9CeLMGkbtMPER1PMM2SluZIGbU6LPEMIz6lAVTKQpjl8rLysmwINcL9b4dOlvzgBxdv3ixRRhFy3nn6iy9O377VHT1NJZ9L/l74hXDdiLs9nm6CWPtil9J7lJ47ObQzGF2K+/mbZ99Y3rFj35niNy6YSy6n//Xr/InbL9QMV3dv4q/cKj1bPUal053wJUi3wAN2wUzMi6ld6s7AThflyjh6HJpXE5zEyW/NP4Os/rmw+lYppnKInr5LW5DTZAv9hQJbJh/c/wAh/weDlEy4CmVuZHN0cmVhbQplbmRvYmoKMTMgMCBvYmoKPDwgL1RpdGxlIChJbmRpdmlkdWVlbCBnZWJvb3J0ZXBsYW4pIC9Qcm9kdWNlciAobWFjT1MgVmVyc2llIDE1LjYuMSBcKGJ1aWxkIDI0RzkwXCkgUXVhcnR6IFBERkNvbnRleHQpCi9BdXRob3IgKE5pY3RpeikgL0NyZWF0b3IgKFdvcmQpIC9DcmVhdGlvbkRhdGUgKEQ6MjAyNTEwMjcxMDM4MDlaMDAnMDAnKSAvTW9kRGF0ZQooRDoyMDI1MTAyNzEwMzgwOVowMCcwMCcpID4+CmVuZG9iagp4cmVmCjAgMTQKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMzEwIDAwMDAwIG4gCjAwMDAwMDMyNTggMDAwMDAgbiAKMDAwMDAwMDAyMiAwMDAwMCBuIAowMDAwMDAwNDE0IDAwMDAwIG4gCjAwMDAwMDMyMjMgMDAwMDAgbiAKMDAwMDAwMDAwMCAwMDAwMCBuIAowMDAwMDAzMzkwIDAwMDAwIG4gCjAwMDAwMDA1MTEgMDAwMDAgbiAKMDAwMDAwMzM0MSAwMDAwMCBuIAowMDAwMDA0MDAzIDAwMDAwIG4gCjAwMDAwMDM2MTAgMDAwMDAgbiAKMDAwMDAwNDIzNyAwMDAwMCBuIAowMDAwMDA4OTQwIDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMTQgL1Jvb3QgOSAwIFIgL0luZm8gMTMgMCBSIC9JRCBbIDxkMmE4OTA1N2YxNGUyYjViNWIwZDg0ZmFjMTkyOTBlND4KPGQyYTg5MDU3ZjE0ZTJiNWI1YjBkODRmYWMxOTI5MGU0PiBdID4+CnN0YXJ0eHJlZgo5MTcwCiUlRU9GCg==
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|MediaType
|style="background-color: white;"|ImageMediaType (code = 'image' in codeSystem 'MediaType')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Datum/Tijd
|style="background-color: white;"|T - 500 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="7"|Foetusspecifieke onderzoeksgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="117"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Foetus
|style="background-color: white;"|Zie [[#XXX_Osse_Foetus|Foetus: XXX_Osse_Foetus]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Patient
|style="background-color: white;"|Zie [[#XXX_Osse_Vrouw|Patient: XXX_Osse_Vrouw]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Echoscopie
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="113"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verrichting (Maternaal onderzoek)
|style="background-color: white;"|Zie [[#FoetaleGroeiEcho|Verrichting (Maternaal onderzoek): FoetaleGroeiEcho]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Echografische bevindingen algemeen (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|ConclusieWaarde
|style="background-color: white;"|Verdenking afwijking (code = '2' in codeSystem '2.16.840.1.113883.2.4.4.13.56')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|VerdenkingAfwijkingobvWaarde
|style="background-color: white;"|Verdenking structurele afwijking (code = '1' in codeSystem '2.16.840.1.113883.2.4.3.22.1.2.200')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|AdviesWaarde
|style="background-color: white;"|Verwijzing GUO2 (code = '4' in codeSystem '2.16.840.1.113883.2.4.4.13.57')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Biometrie
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="46"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleBuikomtrek / AC (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ACWaarde
|style="background-color: white;"|151 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ACDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleSchedelomvang
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SchedelomvangMeetmethode
|style="background-color: white;"|Meten van schedelomvang m.b.v. echografisch onderzoek (code = '31561000146107' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SchedelomvangWaarde
|style="background-color: white;"|16.8 cm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SchedelomvangDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleFemurlengte / FL (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|FLWaarde
|style="background-color: white;"|31 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|FLDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleBipariëtaleDiameter / BPD (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BPDWaarde
|style="background-color: white;"|49 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BPDDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaalLongitudinaleBlaasDiameter / LBD (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|LBDWaarde
|style="background-color: white;"|52 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|LBDDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleKruinRompLengte / CRL (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CRLWaarde
|style="background-color: white;"|153 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CRLDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleTranscerebellarDiameter / TCD (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|TCDWaarde
|style="background-color: white;"|21 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|TCDDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleNekplooidikte / NT (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NTWaarde
|style="background-color: white;"|2 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NTDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaalGeschatGewicht / EFW (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EFWWaarde
|style="background-color: white;"|320 g
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EFWDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Bevindingen
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="48"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Beweging foetus (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BewegingFoetusDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BewegingFoetusWaarde
|style="background-color: white;"|foetale bewegingen aanwezig (bevinding) (code = '289431008' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Vruchtwater (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|HoeveelheidVruchtwaterWaarde
|style="background-color: white;"|normaal vruchtwatervolume (bevinding) (code = '278092006' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|VruchtwatercompartimentWaarde
|style="background-color: white;"|niet te bepalen (kwalificatiewaarde) (code = '1156316003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|PlacentaLokalisatie (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|PlacentaLokalisatieDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|PlacentalokalisatieWaarde
|style="background-color: white;"|rechts laterale positie van placenta (bevinding) (code = '7401000146107' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|OstiumWaarde
|style="background-color: white;"|normaal (kwalificatiewaarde) (code = '17621005' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Cervixlengte (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CervixlengteWaarde
|style="background-color: white;"|31 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CervixlengteDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Navelstreng (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NavelstrengDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NavelstrengWaarde
|style="background-color: white;"|normaal (kwalificatiewaarde) (code = '17621005' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NavelstrengVatenWaarde
|style="background-color: white;"|drie bloedvaten in navelstreng (bevinding) (code = '29691000146104' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrgaansysteemFoetus (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|OrgaansysteemFoetusDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieNaam
|style="background-color: white;"|structuur van wervelkolom (lichaamsstructuur)+structuur van medulla spinalis (lichaamsstructuur) (code = '421060004+2748008' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|OrgaansysteemFoetusWaarde
|style="background-color: white;"|Verdenking afwijking (code = '2' in codeSystem '2.16.840.1.113883.2.4.4.13.55')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Probleem (Wervelkolom, ruggenmerg)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="6"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemType
|style="background-color: white;"|klinische bevinding (code = '404684003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemNaam
|style="background-color: white;"|spina bifida occulta (aandoening) (code = '76916001' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemBeginDatum
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemStatus
|style="background-color: white;"|Actueel (code = '55561003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|VerificatieStatus
|style="background-color: white;"|Werk (code = '415684004' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Sonomarkers (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SonomarkerNaam
|style="background-color: white;"|echogeniciteit van foetale darmen bij obstetrische echografie (bevinding) (code = '698598000' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SonomarkerWaarde
|style="background-color: white;"|Geen sonomarker geconstateerd (code = '1' in codeSystem '2.16.840.1.113883.2.4.4.13.54')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|TekstUitslag
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="8"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstUitslagDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verrichting
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Verrichting (Maternaal onderzoek)
|style="background-color: white;"|Zie [[#FoetaleGroeiEcho|Verrichting (Maternaal onderzoek): FoetaleGroeiEcho]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstUitslagStatus
|style="background-color: white;"|Definitief (code = 'final' in codeSystem 'ZIB Laboratoriumuitslag Testuitslag ResultaatStatus')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstResultaat
|style="background-color: white;"|verdenking afwijking spina bifida
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstUitslagType
|style="background-color: white;"|echografie (code = '16310003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="7"|Maternale onderzoeksgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="10"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Patient
|style="background-color: white;"|Zie [[#XXX_Osse_Vrouw|Patient: XXX_Osse_Vrouw]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Verrichting (Maternaal onderzoek) FoetaleGroeiEcho
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|VerrichtingStartDatum
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|VerrichtingEindDatum
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|VerrichtingType
|style="background-color: white;"|echografie voor foetale groei (verrichting) (code = '241493005' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Locatie
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Zorgaanbieder
|style="background-color: white;"|Zie [[#ZA1_EchopraktijkGroei|Zorgaanbieder: ZA1_EchopraktijkGroei]]
|}<section end=medisch_onderzoek_ />

__NOINDEX__

gz:V3.2 Testscript

2026-07-23T12:25:08Z

Ahsen Yurt:

__NOINDEX__



<div class="noprint" style="background-color:#FAFAFA; position:fixed; bottom:2%; right:0.5%; padding:0; margin:0;">
[[#BackToTop|Back to Top]]
</div>



__NUMBEREDHEADINGS__

{{DISPLAYTITLE:Geboortezorg {{VersieInfo|xstandaardx}}- test - Echo}}
__TOC__



[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Jeugdgezondheidszorg.svg|75px|75px|link=jgz:Landingspagina_JGZ|Landingspagina Jeugdgezondheidszorg]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Huisartswaarneming.svg|75px|75px|link=Landingspagina_Huisartswaarneming|Huisartswaarneming]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Verpleegkundige Zorg.svg|75px|75px|link=Landingspagina_Verpleegkundige_Zorg|Verpleegkundige overdracht]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Medicatieproces.svg|75px|75px|link=Landingspagina_Medicatieproces|Medicatieproces]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Laboratoria.svg|75px|75px|link=Landingspagina_Labuitwisseling|Laboratoria]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Acute Zorg.svg|75px|75px|link=Landingspagina_Acute_Zorg|Acute zorg]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard Geboortezorg.svg|75px|75px|link=Landingspagina_Geboortezorg|Geboortezorg]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Ketenzorg.svg|75px|75px|link=Landingspagina_Ketenzorg|Ketenzorg]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard BgZ.svg|75px|75px|link=Landingspagina_BgZ|BgZ]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|75px|75px|link=imm:Landingspagina_Vaccinatie_Immunisatie|Vaccinatie-Immunisatie]]

[[Bestand:Icoon_Nictiz_Cirkel_Eerstelijnszorg.svg|75px|75px|link=hg:Landingspagina_ELZ|Eerstelijnszorg]]

[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Beeld_en_Verslagen.svg|75px|75px|link=Landingspagina_Beeldbeschikbaarheid|Beeldbeschikbaarheid]]

[[Bestand:Icoon Nictiz Cirkel Informatiestandaard Contra-indicaties en Overgevoeligheden (2).svg|75px|75px|link=Landingspagina Contra-indicaties en Overgevoeligheden|Contra-indicaties en Overgevoeligheden]]


= Inleiding =
== Algemene informatie ==

Dit testscript is opgesteld op naam van Nictiz. De op te vragen onderdelen zijn waar mogelijk gekoppeld aan zorginformatiebouwstenen. Actuele informatie over de informatiestandaard van dit testscript kan je vinden via de {{highlight|hoofdpagina van AANPASSEN: [[link naar IS|naam informatiestandaard]]}}.
Het testen geeft de mogelijkheid om de technische berichten te controleren. Visuele controle van schermafdrukken is geen onderdeel van het testen. Het advies is om alle relevante scenario's te testen. De testmaterialen kunnen worden aangevuld en gewijzigd.

== Doelgroep ==

De doelgroep van dit testscript is de leverancier die zich wil voorbereiden op de kwalificatie voor het uitwisselen van {{highlight|NaamInformatiestandaard}}.
Dit testmateriaal is ontwikkeld voor de systeemrol:

* Sturen/Ontvangen
* Raadplegend/Beschikbaar stellen
* Vastleggen
* Verwerken

Dit document beschrijft het te doorlopen script bij testen voor kwalificatie voor de systeemrol:
* {{highlight| '''''VO'''orschrift '''S'''turend systeem'' (MP-VOS) medicatieafspraak met of zonder verstrekkingsverzoek, lengte, gewicht, nierfunctiewaarde.}}

== Voorwaarden voor testen==
Voor het uitvoeren van deze test gelden de algemene voorwaarden voor testen en kwalificeren bij Nictiz.
Specifiek de onderstaande voorwaarden:
* Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie et cetera.
* Kennis, begrip, en het naleven van de aandachtspunten zoals beschreven in dit document.
* De testdocumentatie bevat de gegevens die de testende partij zelf invoert.
* Kennis en begrip van de Informatiestandaard {{highlight|NaamInformatiestandaard}}

== Begrippenlijst ==
Nictiz maakt gebruik van bepaalde afkortingen en termen. Meer informatie kan gevonden worden in [https://nictiz.nl/standaarden/begrippen/ deze algemene begrippenlijst]. Daarnaast is er een [https://thesauruszorgenwelzijn.multites.net/ thesaurus] waarin begrippen kunnen worden opgezocht.

= Test-informatie =
Nictiz biedt leveranciers de mogelijkheid hun producten en diensten te testen op correcte implementatie van informatiestandaarden ter voorbereiding op de kwalificatie.
Bij het uitvoeren van deze testen is het niet nodig om schermafbeeldingen te maken, maar kunnen behulpzaam zijn in het corrigeren van fouten. Daarnaast maakt het testen van infrastructurele eisen geen onderdeel uit van dit script.
== Testaanpak ==
Houd tijdens het testen de bevindingen bij van de uitgevoerde tests. Analyseer de bevindingen, corrigeer fouten waar nodig en test opnieuw.
==Tools voor testen/kwalificatie==
===ART-DECOR===
Voor meer informatie over het testen met de simulator vanuit ART-DECOR: [https://decor.nictiz.nl/wiki/index.php/Testen_met_ART-DECOR Testen met ART-DECOR].

# Maak het volgens de inhoudelijke gegevens de testpersoon aan.
# Stuur het technisch bericht richting de testsimulator.
# De testsimulator zal het bericht ontvangen en technisch valideren.
# Koppel het bericht aan de bijbehorende testsuite op de ‘Tests’ tab van de simulator.
# De testsimulator zal valideren of het bericht de verwachte inhoud heeft.

===ConformanceLab===
Nictiz stelt het testsysteem Conformancelab beschikbaar voor het testen van systeemrollen met bijbehorende informatiestandaarden als voorbereiding op het kwalificatieproces. (Kandidaat)deelnemers kunnen Conformancelab eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.

Voor het aansluiten op ConformanceLab is [[Kwalificatie:V1.0_Handleiding_Conformancelab|een aparte handleiding beschikbaar]].

-->

= Testscript =
== Uit te voeren stappen ==
-->

Voer – voor ieder scenario – de volgende stappen uit:

'''Beschikbaarstellen'''
# Maak in het XIS de zorgverlener en zorgaanbieder aan, zoals beschreven in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Registreer in het XIS de persoonsgegevens voor de testpersonen zoals beschreven in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Maak in het XIS de {{highlight|"NAAM VAN DE GEGEVENS”}} voor deze personen aan, gebruik hiervoor de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Start het raadplegen van de gegevens op vanaf de testsimulator (ConformanceLab.
# {{font color||yellow|"NAAM VAN DE GEGEVENS”}} beschikbaarstellen [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: zorg dat de gevraagde selectie is toegepast op de gegevens.}}

'''Raadplegen'''
# Raadpleeg {{font color||yellow|"NAAM VAN DE GEGEVENS”}} voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: maak een schermafdruk van de toegepaste selectie.}}
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN SET GEGEVENS”}} beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Ontvang en verwerk (gestructureerd opslaan in database) de {{highlight|"NAAM VAN DE GEGEVENS”}} in het systeem.

'''Ontvangen'''
# Maak in het XIS de zorgverlener en zorgaanbieder aan, zoals beschreven in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Registreer in het XIS de persoonsgegevens voor de testpersoon zoals opgenomen in de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Start het sturen van de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]] op vanaf de testsimulator (ConformanceLab).
# Ontvang en verwerk (gestructureerd opslaan in database) de berichten in het XIS.

'''Sturen'''
# Maak de {{highlight|"NAAM VAN DE GEGEVENS”}} voor de testpersoon aan, gebruik hiervoor de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Stuur {{highlight|"NAAM VAN DE GEGEVENS”}} richting de testsimulator (ConformanceLab), [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]].
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN DE GEGEVENS”}} ontvangen en verwerken.

'''Vastleggend'''
# Maak de {{highlight|"NAAM VAN DE GEGEVENS”}} voor de testpersoon aan, gebruik hiervoor de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Stuur {{highlight|"NAAM VAN DE GEGEVENS”}} richting de testsimulator (ConformanceLab), [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]].
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN DE GEGEVENS”}} ontvangen en verwerken.

'''Verwerken'''
# Verwerk {{font color||yellow|"NAAM VAN DE GEGEVENS”}} voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: maak een schermafdruk van de toegepaste selectie.}}
# De testsimulator (ConformanceLab) zal de {{highlight|"NAAM VAN SET GEGEVENS”}} beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Ontvang en verwerk (gestructureerd opslaan in database) de {{highlight|"NAAM VAN DE GEGEVENS”}} in het systeem.

== Overzicht testscenario's ==


{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || Voorbeeld || Voorbeeld || Voorbeeld || Voorbeeld
|-
| 2 || Voorbeeld || Voorbeeld || Voorbeeld || Voorbeeld
|-
| 3 || Voorbeeld || Voorbeeld || Voorbeeld || Voorbeeld
|}

= Aandachtspunten voor inhoudelijke gegevens =
== Persoonsgegevens ==
Er is een fictief BSN (fBSN) voor testdoeleinden in de persoonsgegevens opgenomen. Dit is alleen bedoeld voor gebruik in het XIS (registratie van de testpersoon).
== Variabele T-datum ==
Test- en kwalificatiescenario's werken vaak met relatieve datums, die ervoor zorgen dat scenario's niet gedateerd raken. Een datum 'volgende week' blijft zodoende altijd in de toekomst. Om dit te vertalen naar concrete datums die gebruikt worden tijdens het testen en kwalificeren wordt gewerkt met de zogenaamde T-datum.

Voor ConformanceLab geldt: De T datum is altijd de maandag van de week waarin je de tests van dit script uitvoert. Als ergens staat T-100 betekent dit dus: 100 dagen eerder dan de huidige maandag.

Voor de kwalificatieserver van ART-DECOR geldt: Als ergens staat T – 10D betekent dit: 10 dagen eerder dan die afgesproken datum/tijd. Het format is yyyy-mm-ddTuu:mm:ss“

= Inhoudelijke gegevens =
<noinclude>
{{DISPLAYTITLE:MedMij Integrale zwangerschapskaart - inhoud }}
__NUMBEREDHEADINGS__

=Addenda voor inhoudelijke gegevens Integrale zwangerschapskaart 3.2=</noinclude>
==Scenario Echo casus 1==
<section begin= />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="4" | Vrouw
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="3" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Demografische gegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Patient
|style="background-color: white;"|Zie [[#XXX_Osse_Vrouw|Patient: XXX_Osse_Vrouw]]
|}<section end= />
=== Administratief ===
<section begin=administratief_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="6" | Administratief
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="5" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Betaler
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="11"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Verzekeraar
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="9"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verzekering
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BeginDatumTijd
|style="background-color: white;"|T - 119 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EindDatumTijd
|style="background-color: white;"|T + 246 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Verzekeringssoort
|style="background-color: white;"|Basis (code = 'B' in codeSystem 'ZIB Verzekeringssoort')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|IdentificatieNummer
|style="background-color: white;"|1235 (in identificerend systeem: UZOVI)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|OrganisatieNaam
|style="background-color: white;"|NN
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|VerzekerdeNummer
|style="background-color: white;"|123456
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Patient XXX_Osse_Vrouw
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="30"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Naamgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Voornamen
|style="background-color: white;"|Leonie
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Initialen
|style="background-color: white;"|L
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Naamgebruik
|style="background-color: white;"|Eigen geslachtsnaam (code = 'NL1' in codeSystem 'ZIB Naamgebruik')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslachtsnaam
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Achternaam
|style="background-color: white;"|XXX_Osse
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Adresgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Straat
|style="background-color: white;"|Knolweg
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Huisnummer
|style="background-color: white;"|1000
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Postcode
|style="background-color: white;"|9999XA
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Woonplaats
|style="background-color: white;"|STITSWERD
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Land
|style="background-color: white;"|Nederland (code = 'NL' in codeSystem 'ISO 3166-1 (alpha-2)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|AdresSoort
|style="background-color: white;"|Woon-/verblijfadres (code = 'PHYS' in codeSystem 'HL7 AddressUse')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Contactgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="9"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Telefoonnummers
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="3"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Telefoonnummer
|style="background-color: white;"|06-12345678
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|TelecomType
|style="background-color: white;"|Mobiel telefoonnummer (code = 'MC' in codeSystem 'HL7 AddressUse')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|EmailAdressen
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="3"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EmailAdres
|style="background-color: white;"|l.osse@test.nl
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EmailSoort
|style="background-color: white;"|Privé e-mailadres (code = 'HP' in codeSystem 'HL7 AddressUse')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Identificatienummer
|style="background-color: white;"|999901710 (in identificerend systeem: BSN)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geboortedatum
|style="background-color: white;"|13 jun 1998
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslacht (administratief)
|style="background-color: white;"|Vrouw (code = 'F' in codeSystem 'HL7 AdministrativeGender')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Patient XXX_Osse_Kind
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Naamgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslachtsnaam
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Achternaam
|style="background-color: white;"|XXX_Osse
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Foetus
|style="background-color: white;"|Zie [[#XXX_Osse_Foetus|Foetus: XXX_Osse_Foetus]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Zorgaanbieder ZA1_EchopraktijkGroei
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgaanbiederIdentificatienummer
|style="background-color: white;"|90012345 (in identificerend systeem: AGB-Z)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieNaam
|style="background-color: white;"|Echopraktijk Groei
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|AfdelingSpecialisme
|style="background-color: white;"|Echoscopie (code = '9018' in codeSystem 'COD016-VEKT Zorgverlenersspecificatie (subberoepsgroep)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieType
|style="background-color: white;"|Echocentrum (code = 'B2' in codeSystem 'RoleCodeNL - zorgaanbiedertype (organisaties)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Zorgaanbieder ZA2_VerloskundigenPraktijk_VeiligZwanger
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgaanbiederIdentificatienummer
|style="background-color: white;"|87654321 (in identificerend systeem: URA)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieNaam
|style="background-color: white;"|Verloskundigenpraktijk Veilig Zwanger
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|AfdelingSpecialisme
|style="background-color: white;"|Verloskundigen, niet nader gespecificeerd (code = '0800' in codeSystem 'COD016-VEKT Zorgverlenersspecificatie (subberoepsgroep)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrganisatieType
|style="background-color: white;"|Verloskundigenpraktijk (code = 'G3' in codeSystem 'RoleCodeNL - zorgaanbiedertype (organisaties)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Zorgverlener ZV1_HelmaGroot
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="12"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgverlenerIdentificatienummer
|style="background-color: white;"|8452962 (in identificerend systeem: UZI Personen)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Naamgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Voornamen
|style="background-color: white;"|Helma
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Initialen
|style="background-color: white;"|H
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Naamgebruik
|style="background-color: white;"|Eigen geslachtsnaam (code = 'NL1' in codeSystem 'ZIB Naamgebruik')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Geslachtsnaam
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Achternaam
|style="background-color: white;"|XXX_Groot
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Specialisme
|style="background-color: white;"|Verloskundige (code = '03.000' in codeSystem 'RoleCodeNL - zorgverlenertype (personen)')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Zorgaanbieder
|style="background-color: white;"|Zie [[#ZA2_VerloskundigenPraktijk_VeiligZwanger|Zorgaanbieder: ZA2_VerloskundigenPraktijk_VeiligZwanger]]
|}<section end=administratief_ />
=== Zorgverlening ===
<section begin=zorgverlening_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="5" | Zorgverlening
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="4" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|ZorgEpisode
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="8"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Identificatienummer
|style="background-color: white;"|2135467 (in identificerend systeem: 2.16.840.1.113883.2.4.3.11.999.60.8)
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|BeginDatum
|style="background-color: white;"|T - 705 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|EindDatum
|style="background-color: white;"|T - 509 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ZorgEpisodeVerantwoordelijke
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Zorgverlener
|style="background-color: white;"|Zie [[#ZV1_HelmaGroot|Zorgverlener: ZV1_HelmaGroot]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|StatusZorgepisode
|style="background-color: white;"|Afgesloten (code = 'finished' in codeSystem '2.16.840.1.113883.4.642.1.649')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Verwijsgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verwijzing van/ afkomstig van
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Zorgaanbieder
|style="background-color: white;"|Zie [[#ZA2_VerloskundigenPraktijk_VeiligZwanger|Zorgaanbieder: ZA2_VerloskundigenPraktijk_VeiligZwanger]]
|}<section end=zorgverlening_ />
=== Zwangerschapsgegevens ===
<section begin=zwangerschapsgegevens_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="5" | Zwangerschapsgegevens
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="4" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Zwangerschap
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="9"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Zwangerschapsduur
|style="background-color: white;"|140 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Pariteit
|style="background-color: white;"|0
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Graviditeit
|style="background-color: white;"|1
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|ATermeDatumItems
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ATermeDatum
|style="background-color: white;"|T - 509 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BepalingsMethode
|style="background-color: white;"|aterme datum berekend door middel van diagnostische ultrasonografie (code = '31541000146106' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|DatumBepaling
|style="background-color: white;"|T - 649 dagen
|}<section end=zwangerschapsgegevens_ />
=== Foetus ===
<section begin=foetus_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="3" | Foetus
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="2" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Identificator (foetus)
|style="background-color: white;"|baby A
|}<section end=foetus_ />
=== Medisch onderzoek ===
<section begin=medisch_onderzoek_ />
{| class="wikitable" width="85%"
|style="background-color: #1F497D; color: white; font-weight: bold; text-align:center;" colspan="7" | Medisch onderzoek
|-style="background-color: #1F497D; color: white; text-align:left;"
|colspan="6" width="25%"| Gegevenselement
|| Waarde

|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="7"|Media Media1
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Beeld
|style="background-color: white;"|JVBERi0xLjMKJcTl8uXrp/Og0MTGCjMgMCBvYmoKPDwgL0ZpbHRlciAvRmxhdGVEZWNvZGUgL0xlbmd0aCAyMTYgPj4Kc3RyZWFtCngBlZBPawIxEMXv+RSvanViu7Obv7t7VXrpTQh4UE+LHgQLdr8/mERj8VhCeJPkzZvwu2KDK1SHKm7Xe3RW4/eILX5Qr0eFYUST1zhEY8Pa3s+piC1eK+41hotYBbi7M0rXt+y9t3CtQ7igDkFDIZywA71JVA0b0KQUUxmTHWiWVAt6zw+qXICKYZ4MFrRIGt+L7qlE7WXpXUp47sXT8/GZ00FFq+yMY1nCsv9Lq3Oc4RbUlNyJFAeEb3yFSCwx+xcdvNBR1mg2JtMRL3QofT+cH1NuLL1PbAplbmRzdHJlYW0KZW5kb2JqCjEgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvUmVzb3VyY2VzIDQgMCBSIC9Db250ZW50cyAzIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXQo+PgplbmRvYmoKNCAwIG9iago8PCAvUHJvY1NldCBbIC9QREYgL1RleHQgXSAvQ29sb3JTcGFjZSA8PCAvQ3MxIDUgMCBSID4+IC9Gb250IDw8IC9UVDIgNyAwIFIKPj4gPj4KZW5kb2JqCjggMCBvYmoKPDwgL04gMyAvQWx0ZXJuYXRlIC9EZXZpY2VSR0IgL0xlbmd0aCAyNjEyIC9GaWx0ZXIgL0ZsYXRlRGVjb2RlID4+CnN0cmVhbQp4AZ2Wd1RT2RaHz703vdASIiAl9Bp6CSDSO0gVBFGJSYBQAoaEJnZEBUYUESlWZFTAAUeHImNFFAuDgmLXCfIQUMbBUURF5d2MawnvrTXz3pr9x1nf2ee319ln733XugBQ/IIEwnRYAYA0oVgU7uvBXBITy8T3AhgQAQ5YAcDhZmYER/hEAtT8vT2ZmahIxrP27i6AZLvbLL9QJnPW/3+RIjdDJAYACkXVNjx+JhflApRTs8UZMv8EyvSVKTKGMTIWoQmirCLjxK9s9qfmK7vJmJcm5KEaWc4ZvDSejLtQ3pol4aOMBKFcmCXgZ6N8B2W9VEmaAOX3KNPT+JxMADAUmV/M5yahbIkyRRQZ7onyAgAIlMQ5vHIOi/k5aJ4AeKZn5IoEiUliphHXmGnl6Mhm+vGzU/liMSuUw03hiHhMz/S0DI4wF4Cvb5ZFASVZbZloke2tHO3tWdbmaPm/2d8eflP9Pch6+1XxJuzPnkGMnlnfbOysL70WAPYkWpsds76VVQC0bQZA5eGsT+8gAPIFALTenPMehmxeksTiDCcLi+zsbHMBn2suK+g3+5+Cb8q/hjn3mcvu+1Y7phc/gSNJFTNlReWmp6ZLRMzMDA6Xz2T99xD/48A5ac3Jwyycn8AX8YXoVVHolAmEiWi7hTyBWJAuZAqEf9Xhfxg2JwcZfp1rFGh1XwB9hTlQuEkHyG89AEMjAyRuP3oCfetbEDEKyL68aK2Rr3OPMnr+5/ofC1yKbuFMQSJT5vYMj2RyJaIsGaPfhGzBAhKQB3SgCjSBLjACLGANHIAzcAPeIACEgEgQA5YDLkgCaUAEskE+2AAKQTHYAXaDanAA1IF60AROgjZwBlwEV8ANcAsMgEdACobBSzAB3oFpCILwEBWiQaqQFqQPmULWEBtaCHlDQVA4FAPFQ4mQEJJA+dAmqBgqg6qhQ1A99CN0GroIXYP6oAfQIDQG/QF9hBGYAtNhDdgAtoDZsDscCEfCy+BEeBWcBxfA2+FKuBY+DrfCF+Eb8AAshV/CkwhAyAgD0UZYCBvxREKQWCQBESFrkSKkAqlFmpAOpBu5jUiRceQDBoehYZgYFsYZ44dZjOFiVmHWYkow1ZhjmFZMF+Y2ZhAzgfmCpWLVsaZYJ6w/dgk2EZuNLcRWYI9gW7CXsQPYYew7HA7HwBniHHB+uBhcMm41rgS3D9eMu4Drww3hJvF4vCreFO+CD8Fz8GJ8Ib4Kfxx/Ht+PH8a/J5AJWgRrgg8hliAkbCRUEBoI5wj9hBHCNFGBqE90IoYQecRcYimxjthBvEkcJk6TFEmGJBdSJCmZtIFUSWoiXSY9Jr0hk8k6ZEdyGFlAXk+uJJ8gXyUPkj9QlCgmFE9KHEVC2U45SrlAeUB5Q6VSDahu1FiqmLqdWk+9RH1KfS9HkzOX85fjya2Tq5FrleuXeyVPlNeXd5dfLp8nXyF/Sv6m/LgCUcFAwVOBo7BWoUbhtMI9hUlFmqKVYohimmKJYoPiNcVRJbySgZK3Ek+pQOmw0iWlIRpC06V50ri0TbQ62mXaMB1HN6T705PpxfQf6L30CWUlZVvlKOUc5Rrls8pSBsIwYPgzUhmljJOMu4yP8zTmuc/jz9s2r2le/7wplfkqbip8lSKVZpUBlY+qTFVv1RTVnaptqk/UMGomamFq2Wr71S6rjc+nz3eez51fNP/k/IfqsLqJerj6avXD6j3qkxqaGr4aGRpVGpc0xjUZmm6ayZrlmuc0x7RoWgu1BFrlWue1XjCVme7MVGYls4s5oa2u7act0T6k3as9rWOos1hno06zzhNdki5bN0G3XLdTd0JPSy9YL1+vUe+hPlGfrZ+kv0e/W3/KwNAg2mCLQZvBqKGKob9hnmGj4WMjqpGr0SqjWqM7xjhjtnGK8T7jWyawiZ1JkkmNyU1T2NTeVGC6z7TPDGvmaCY0qzW7x6Kw3FlZrEbWoDnDPMh8o3mb+SsLPYtYi50W3RZfLO0sUy3rLB9ZKVkFWG206rD6w9rEmmtdY33HhmrjY7POpt3mta2pLd92v+19O5pdsN0Wu067z/YO9iL7JvsxBz2HeIe9DvfYdHYou4R91RHr6OG4zvGM4wcneyex00mn351ZzinODc6jCwwX8BfULRhy0XHhuBxykS5kLoxfeHCh1FXbleNa6/rMTdeN53bEbcTd2D3Z/bj7Kw9LD5FHi8eUp5PnGs8LXoiXr1eRV6+3kvdi72rvpz46Pok+jT4Tvna+q30v+GH9Av12+t3z1/Dn+tf7TwQ4BKwJ6AqkBEYEVgc+CzIJEgV1BMPBAcG7gh8v0l8kXNQWAkL8Q3aFPAk1DF0V+nMYLiw0rCbsebhVeH54dwQtYkVEQ8S7SI/I0shHi40WSxZ3RslHxUXVR01Fe0WXRUuXWCxZs+RGjFqMIKY9Fh8bFXskdnKp99LdS4fj7OIK4+4uM1yWs+zacrXlqcvPrpBfwVlxKh4bHx3fEP+JE8Kp5Uyu9F+5d+UE15O7h/uS58Yr543xXfhl/JEEl4SyhNFEl8RdiWNJrkkVSeMCT0G14HWyX/KB5KmUkJSjKTOp0anNaYS0+LTTQiVhirArXTM9J70vwzSjMEO6ymnV7lUTokDRkUwoc1lmu5iO/kz1SIwkmyWDWQuzarLeZ0dln8pRzBHm9OSa5G7LHcnzyft+NWY1d3Vnvnb+hvzBNe5rDq2F1q5c27lOd13BuuH1vuuPbSBtSNnwy0bLjWUb326K3tRRoFGwvmBos+/mxkK5QlHhvS3OWw5sxWwVbO3dZrOtatuXIl7R9WLL4oriTyXckuvfWX1X+d3M9oTtvaX2pft34HYId9zd6brzWJliWV7Z0K7gXa3lzPKi8re7V+y+VmFbcWAPaY9kj7QyqLK9Sq9qR9Wn6qTqgRqPmua96nu37Z3ax9vXv99tf9MBjQPFBz4eFBy8f8j3UGutQW3FYdzhrMPP66Lqur9nf19/RO1I8ZHPR4VHpcfCj3XVO9TXN6g3lDbCjZLGseNxx2/94PVDexOr6VAzo7n4BDghOfHix/gf754MPNl5in2q6Sf9n/a20FqKWqHW3NaJtqQ2aXtMe9/pgNOdHc4dLT+b/3z0jPaZmrPKZ0vPkc4VnJs5n3d+8kLGhfGLiReHOld0Prq05NKdrrCu3suBl69e8blyqdu9+/xVl6tnrjldO32dfb3thv2N1h67npZf7H5p6bXvbb3pcLP9luOtjr4Ffef6Xfsv3va6feWO/50bA4sG+u4uvnv/Xtw96X3e/dEHqQ9eP8x6OP1o/WPs46InCk8qnqo/rf3V+Ndmqb307KDXYM+ziGePhrhDL/+V+a9PwwXPqc8rRrRG6ketR8+M+YzderH0xfDLjJfT44W/Kf6295XRq59+d/u9Z2LJxPBr0euZP0reqL45+tb2bedk6OTTd2nvpqeK3qu+P/aB/aH7Y/THkensT/hPlZ+NP3d8CfzyeCZtZubf94Tz+wplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKWyAvSUNDQmFzZWQgOCAwIFIgXQplbmRvYmoKMiAwIG9iago8PCAvVHlwZSAvUGFnZXMgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL0NvdW50IDEgL0tpZHMgWyAxIDAgUiBdID4+CmVuZG9iago5IDAgb2JqCjw8IC9UeXBlIC9DYXRhbG9nIC9QYWdlcyAyIDAgUiA+PgplbmRvYmoKNyAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHJ1ZVR5cGUgL0Jhc2VGb250IC9BQUFBQUMrQXB0b3MgL0ZvbnREZXNjcmlwdG9yCjEwIDAgUiAvVG9Vbmljb2RlIDExIDAgUiAvRmlyc3RDaGFyIDMzIC9MYXN0Q2hhciA0OCAvV2lkdGhzIFsgMjYwIDU1MSA1NjEKMjM5IDQ1MiA1NTkgNTI3IDI2MCAyMDMgNDg0IDU2MSA1NTIgMzM0IDMyMyA1NjEgNTMxIF0gPj4KZW5kb2JqCjExIDAgb2JqCjw8IC9MZW5ndGggMzIwIC9GaWx0ZXIgL0ZsYXRlRGVjb2RlID4+CnN0cmVhbQp4AV2Sy2rDMBBF9/oKLdNFsOwkTgPGUFICXvRB3X6ALY2DoJaFrCz8972jpCl0cRZHM1eSR86OzXPjbJTZe5h0S1EO1plA83QJmmRPZ+tEXkhjdbxZWtNj50WGcLvMkcbGDZOsKiFl9oHIHMMiV09m6umB196CoWDdWa6+jm1aaS/ef9NILkol6loaGrDdS+dfu5FklqLrxqBu47JG6q/jc/EkcSMk8uuV9GRo9p2m0LkziUqpujqdakHO/Cvl5TXRD7fWIq8rRqntoRZVUUCBUiWxbqAAumXdQgE0Ne+gQKl9ydUSCqA71j0UoDnpIxRANVcPUKBUoVg7KEB1z9pDAbRg1VAAHVgNFOCgVCUogKZLDlAA5Z03mAWDbJ4m8vvpPBx+xPvQ9SUEzDu9dHoKHrF1dP8Z/OR5pIkfmCWhAQplbmRzdHJlYW0KZW5kb2JqCjEwIDAgb2JqCjw8IC9UeXBlIC9Gb250RGVzY3JpcHRvciAvRm9udE5hbWUgL0FBQUFBQytBcHRvcyAvRmxhZ3MgNCAvRm9udEJCb3ggWy01MDAgLTI3NSAxMTgyIDEwMTBdCi9JdGFsaWNBbmdsZSAwIC9Bc2NlbnQgOTM5IC9EZXNjZW50IC0yODIgL0NhcEhlaWdodCA2NTcgL1N0ZW1WIDAgL1hIZWlnaHQKNDc2IC9BdmdXaWR0aCA1NjEgL01heFdpZHRoIDEyNjkgL0ZvbnRGaWxlMiAxMiAwIFIgPj4KZW5kb2JqCjEyIDAgb2JqCjw8IC9MZW5ndGgxIDcwOTIgL0xlbmd0aCA0NjE1IC9GaWx0ZXIgL0ZsYXRlRGVjb2RlID4+CnN0cmVhbQp4AY1YeXAUV3p/3T2XZkbSjE5gJLpHrRmOkRBISEIC7EGjWxxCB0xLCM1odB8gxuZGWDbWIrfPtVlgbcc2Xhtsk832YHtXuLK+UnYqFcMmf2S3KuWNl3UlW1ubuNhUskm5QJPfe90SmPVuZaaP9x3ve9/9uvvB+MEB4iDTRCBrYxPRScJ+mTdx2xA79KCkw8Iw7h8OTg5N6LBpJSHpp4bGjw7qcNZWQqyNwwPRfh0mt3CvGAZCh7n1uBcOTzx4RIcz/xL32vH9MYOeBXmkcCJ6xFiffA5Y2hedGND5PWcoPBkfMOhcmBA+Xaf9mSsHmpvsJBbGwxMXKQGK47emn2IYSuf5p/9nReo/9KZv+m/isDH0L187+DUd/Hq4tPwWd/taykFbFkAL4RkZEmDtqdsfEGL33+L+9z9BNwiLN3cw2bs2Ke5dlxR7SuLinpLnxO6SpNi1Jikqa66J4aKkuLs4Ke4qviZ2BpJix6pmsX1VUmxbnRR3rr4stq6SxB0r68TtKy+L21Ymxa0rkmKLPyk2+wNiU+GQ2Fh4TWwoTIr1vqRY57ss1spJMVSQFGu818Qt3qQY9F4W75euifdJSXGz9Jy4SSoRNy6Pi9XLk2KVmBQ3iNNiZX5crMhPiuX518T1edfEsrykWJp3WVy3Ni6uKdosFhfFxdWr9oo+rFW4zLN0j1wQFAuEZUv3eJdtFqVNGIjLh8Tlq5bk7MnPTYp5OUnRU760untJRU5197JgKx3n0nH20o05w12ZVRmd7ipXZ4biUlKrnJ3mKr7ThNOppFekdTqq7J3WKktnmmJXLApRUqpsnQKoNoVXXEQIBs3cVe4Z0hFombMm21o0W2u3xs1qvnZ6De7s0iyzGuns6g4nOO4pZebJJ0l+TYv2THv4ikAwVBI8H9oZTpiEp5QaEiCBAE79z4YGHAhwd/0JxvQANxvQWRiw2bix8SKgw5RFx99hA2YJMdfQP8lI/lPyN8K/IytJ8quFc/755H+Yc0mGDpMT5GEygf9h0o8/HR8jk+QQaScD5CAZJ0PgGMP1ATJKfkGipIvESQc4hshxcH+HDGPGIVwPAH6URMh+SDpOtmF+mEmIgnMc1EOQPsUkUf42QCOQfwoyOyGzH1LiqJ3dpAf8B4LN3z9/7uzp78w8euqRh6cfOjl14vixo0cOHzr44APxA5P7902Mj42ODA8NDvTH+qKR3r09e7q7lPDuXZ0d7Ttbd2zftrWluamxoX6l6LKnFHEJhz0khwbsxUUkYXdg6Cgu4jRLSLMypLYjICGoYW9LW7iu1uP1Kh7ZqwU1k6+OntF+NbZAUCACszAXIlra5ZadXWGpTo2wWcB0fAPS6RuoREYzRhof6ghr9QHgGUWHGxgMRh1svIfctECWJY20qmp/ggg+iAl6EhwbmEOPK7BEkbW+gOyVwwMQlbARp7cjEsLIuTDipAasIM25SB/O2G55jjNGXWFNigwqjeAmvE9jR/scKZeP6OOIJsUkSbP45L7WsOrVuIjsMeC2MDzGRT2qV/ZKijKX/CiPcsteyOJJTULmZncmgtxse1f4qgu9dbYjfIXn+FAEpVIIWviqREiQYVE5kRqKpCwSBUgLh8hc4W2M33M1SMg0o5oYgsExWMFwOhNwHInN8TrOxfgSfrZQEH01NmfSKcEFCSbgbDpuWudeaXDbQHFRynuERydmRIX94CUEMmg3B23BlKCTT+URC4q6Asx74E3hyNtOLpXzJCATFgA9x00nUoKeq0ySjnqPmwYnxU1DoMHGE8p2lyCsqBveiZthQWdX+G0ngXx2BUcN/RUX1SX47QH5TlrvDCOAdQlueyCC1G4BKPjqJKS1FmwPU96IBznvVZTa4iKaXVJYHvDISiIrS52sS7hcoRY1hERHrrEES0Qt/khADWs05Wiiya5qpK3ga4rJ9RGwyCgbHE1AxXZJEa0vEsBQctWrIEuxKOUmOQle8CU4k4+7j9wHv1mcml0eqNEccs0i5X5yv06xUIpVrtG4HN3rdXKdtGREjcl9yMBga3jIM6hEIVsLylHNJNd4EiZSg+pawsGkugTZHoBtLcjBHYHWbhQpdYakqrVSImjyR2NRCtd6UfeqQZJra2nRLsyok1QtGI1FwFGnMObiIqig1slRqR/NA+bCc+0y3Ry66CodXWHV2S/3y/BwMKhGYbZHiikeVYkxj0MdqEaKi8x3upPRnHjaA3yxQVzmJNIXkft0BK3Oe3FD9yIGwXU3Tm6my0HZZqo17mqzXNcPDnpG+zUBGeeV+rFj0ZQhraxv/EkmiFhkkhBTJlx1baR5QyHQGQQAh6oNfRMcXgTrQUYymHxr9FzRTH6aeWGvNurRxhWaLzpLVJvuk1TJJVfL9MLyrAHUhohm9jVo07Eo7EBPQu4B0QyEFO5DLkNgfURdyDhMM/kXV9L2IfZ3iURL5TqwNO+jXtCmW6WIIkUiwGJT8HokzYy7NBilyUXbbivWx9GK3o9bVG3HXEILyKNZsQMMRgdkL5o7cArzKwsfVm9GhoQ14lFVWdU4qOirBzPE+zWLv4necEwG5OgAgkjXk6IDbG491GXeofp56mSvAhbeR/1OHYc+10cvMRXZqPWg2sw+t5qhSlUqulYPGq7JH9sVwbYguaR6iYU6ikymTmiikAJBOmMKKpbNhwiqzUQg0WP13cEA6dP2B3RmG5MKzdrCWitdlB5WdmBwIKDxuRtApAHi2tA/0BUQKOo8s68J7g0i9Tx0tqTx2MpY09DnN9GpHgNjTAOGtV26a2Jf0VVw6Prqi1qofM3JjhSfZvMh0JoJOuhkKzVnQSYbQ2l9DlSCuroBGGMpus/RgxkSMQCTD26HPLY1UgNo5INRVH1U9swlP2xFj4wAisiKQpfHgbSjM5hoVRdM3QXJtm91hbGSvrjDpznARU3QEfrV7tNwwCjoTGm647AEUExfuo7hvavJDwkgeI75jbmOThB8p2kgUKRG3Q14tGEl0K8Ls+i3JgkdFZ07tpM9bXSjGmSvFX0MHkBDk7T2ADYRZttpNsOPFKcthGYlVy+TeuSQMSA5RCNyI0cvBKUlN2o8wMWRfIUnnE3eQG8p8oYEz1nR7dGDZVeqE41ejUX6sfVho4aXyQbPJvqoBH8g0DgQ20O0NXWEzR4TrSxUlHZYDynKCn6hDIv0w+iE1Fu6J22Upi4SqSPZZOptlCa7HgrYIO+PZ6m2/99iSAUWTS2FKUK7kd9GFfvTSwl6gJrpAmiuvG5GMzXFDEejplU1FsUTVk8arVCn3w18BmyqgmlVhm3wzQnY3UpXhw4wmIEdYWq+A0nAkscBggt+/EhPbQeILhj+ERqaoffVZJLAgQa37jr4F/JYnhtkVhhUGJ13OKBgVE/PCLjq6WlUksOoUuc9Xd8Qr8c05ZtEeVEY3ejlRYkUSnBOPAybPGas6JdccFc1C50flgBWqxOc1W8wICNdMLNaVR2yvqXItP1fxQMoYQ+XREF3/iZCm0LoVdWW+u0U2738qWwCLX5EOXXxTqUY5WAPaY4QfX5BALUU2ofWIL5Tn9B0Q1awx4m7tkOGoqV49ya5hPoejsYUeHw/a2aUccFvg6ykdXH3YjvCU1iEeuoTOMOlcbib/V56eqjrWM5pqIz9AUV/5JqiufEIK6lHApI0guesEIenLWyUGEvoBuC2+VmTU/HAMxLF1ow+RPuOsgTPUm306RhvALJL4jaRTfprkaxnXDv2AJMvvMlTpeC9Yi752zzar+AaHps8zg5VklxukFQpAy8a2gwtRZNBkxkOu7jFb3BRC2YCqqrz0WdyJ6+2tMMJ9I3NvsFjh06L71/nA3+OjM0p1IF+pfXKR7zUFdou+SgeFkKyJkl70BKBbMhTVBXbqSrTd6pdYf1KSVxRHn0yoE8xBq8nD+9od0AnpsKiueTbefR1aXG14wurxbEaXVZdWE6LfetqNMu4bnplB7MuUUFkfX2T31hU3aN24f3Qq+XThQ09AKbl0a7NNDlPNSHCJ4Tw2UQzBcmoaYpcMJ3AvZKMCr8iddxvyROgnTWNAD+q0/kfkgv8WSKZjpBzwkuEcK8Q+uPwpz8nvmitxt2L72IcSUEjt5J0kkbMxAaMBV8E7eBJxddBnvH34pvBB5i8hZvhl/Cb+C5+lv9YMAmrhF3CjPCa8Bok4Cd8Ym7G3HSSSYpJSXDZ6lxp2QpzocmeNWI3uVxr8gszMzk+TmxxfCwpdX1a6i7DJeDOyK1au+6A2+v2FfjL11eUleZkZ1nMXreX81dUVlSUr/fLBZZseYFitViswifzSwvXri0sLC2d3yLcd+tjbsC0cWN1Rduujt7JVx9+5IXWUGWBydz89Y+/KCksLKHni6aPb/2hbay4qKFi445w69TsibHW/vWBlnLqFw2XfnylEYjz3UUV1657wF3m1t4x13z9PjwxmvxKeFP4giwnK4k36F5mj9tkOZ04s6xxMY84YFRpaaDUXVXlLgusXVdX4KfGFFbeUR+WLeez3fIKi2VFaUVlucmSnZXDvdjxePtrXNHfnegdUF8devdgy2MTwRetoURz/ysV83/4TU9GcGrPqdl1fO1Uz+C+I2dq85pnRm4fPNPSPb238VNh71jTbuh2IfmVKZN+ZSIiyQ+6ltoc1riFxM32eKawoBp8Xsr0WmGVYVcFdTT1NFVGV9Lqzsnhj42fX5vy4qWy1/cf/qvegbkXHp196MTId1evmM1ob1LNNbdvbosc+NWlizfij33wo3c+nGydf6w5anjn8zsapNnjqSS+zGGzxjNdCxrAP3c8Q5fPhR4L7nD7WZjhka/YwlPDz5dceill/Wvbxp4qWjUzMHP6oYz4l5cu/suB7u288+v3n2pQHhto4A63jb3/o3cX4vMZ4rMMeZ0fTPPkkPR0IlIF9PVpbEoyqsoWY2NkmtW7nC9DPMrSeM7LlOArXv77vt6/Ofu3v+b5283cxumRyZPC60L/O/NRPkuYPXrs8YyZf336e19O37yRviql9+XISGzoezt5ZfaZp1E9dfOnhU9NO1BPeaSIbCKNpJVUBfO3l28baW4KhcoLfZs3F+fn5BSlFBeTcks8naTT3AlAu+ulqAl3WQbNIVwCiNcWPY8qK/Wy0GPll2ULTZ7MNTxyrDKXATlllTrvHweW5tmKiorK7AIL918v/bTju+ek4zev/+53bz1e8tDBM7XNJ1N7J9bs6Govv8+n7PAeubRr95vHpi62tb8xHZk6FO2depjrqA08vq/+4PzpxiP1nY96Kh+aefTNo5GG1ZsL3G0Vm7q5KvvGpoJ1u/PWp5fkZ4mZp3rOhXvOd3Wd7+k61x3fN35gYnJi3wT3/v17a4Un89HMyBOouB5zA+sXrp/YTZwlTuy0MVyH0bTuhLuawYVLHSVVVSUl1dXC9VulppnK1asr6YnKPQs5v0feOUnaj80kbmdCSpFmUeoMyMnKKSvL5q4ePrnmYolS3PJkzGS9xXVHZjH3AnrWPwqfkyySG3S6BIs1Di0chgRWLVAklxUKyta9niWH1X3hFUvxG6deefbS8m1NE2eKhetnN4789PLtJ/g9Dfvuj228vZ3aN5q8aSLCDXRDkbh+sgRpaJQBDarRHO4OFC1BWgA0rDn82qc/Gxv77Olnf7Z//8+eHZ/esGF6fOR4RcVx19EbL7z85bFjX778wo2jM72XRsffikbfGh+91EvXvDD/vCkTFWB0gUx3miO+1DCLpFHnshYFBdoX7GINQC7wr3Bzd3eBC6+a178+cYQ2gBPDL5ZwWTOnTx4be27Vytn5583rX97ehxbw+o0H2hvn3dwvP0i8/X586/zs1l7dp/ys8M/I/uygI2VhcRbZuz1alk1thS//wrLq2YNZuU372iTh+sWtg9/3h4pud9CeLMGkbtMPER1PMM2SluZIGbU6LPEMIz6lAVTKQpjl8rLysmwINcL9b4dOlvzgBxdv3ixRRhFy3nn6iy9O377VHT1NJZ9L/l74hXDdiLs9nm6CWPtil9J7lJ47ObQzGF2K+/mbZ99Y3rFj35niNy6YSy6n//Xr/InbL9QMV3dv4q/cKj1bPUal053wJUi3wAN2wUzMi6ld6s7AThflyjh6HJpXE5zEyW/NP4Os/rmw+lYppnKInr5LW5DTZAv9hQJbJh/c/wAh/weDlEy4CmVuZHN0cmVhbQplbmRvYmoKMTMgMCBvYmoKPDwgL1RpdGxlIChJbmRpdmlkdWVlbCBnZWJvb3J0ZXBsYW4pIC9Qcm9kdWNlciAobWFjT1MgVmVyc2llIDE1LjYuMSBcKGJ1aWxkIDI0RzkwXCkgUXVhcnR6IFBERkNvbnRleHQpCi9BdXRob3IgKE5pY3RpeikgL0NyZWF0b3IgKFdvcmQpIC9DcmVhdGlvbkRhdGUgKEQ6MjAyNTEwMjcxMDM4MDlaMDAnMDAnKSAvTW9kRGF0ZQooRDoyMDI1MTAyNzEwMzgwOVowMCcwMCcpID4+CmVuZG9iagp4cmVmCjAgMTQKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMzEwIDAwMDAwIG4gCjAwMDAwMDMyNTggMDAwMDAgbiAKMDAwMDAwMDAyMiAwMDAwMCBuIAowMDAwMDAwNDE0IDAwMDAwIG4gCjAwMDAwMDMyMjMgMDAwMDAgbiAKMDAwMDAwMDAwMCAwMDAwMCBuIAowMDAwMDAzMzkwIDAwMDAwIG4gCjAwMDAwMDA1MTEgMDAwMDAgbiAKMDAwMDAwMzM0MSAwMDAwMCBuIAowMDAwMDA0MDAzIDAwMDAwIG4gCjAwMDAwMDM2MTAgMDAwMDAgbiAKMDAwMDAwNDIzNyAwMDAwMCBuIAowMDAwMDA4OTQwIDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMTQgL1Jvb3QgOSAwIFIgL0luZm8gMTMgMCBSIC9JRCBbIDxkMmE4OTA1N2YxNGUyYjViNWIwZDg0ZmFjMTkyOTBlND4KPGQyYTg5MDU3ZjE0ZTJiNWI1YjBkODRmYWMxOTI5MGU0PiBdID4+CnN0YXJ0eHJlZgo5MTcwCiUlRU9GCg==
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|MediaType
|style="background-color: white;"|ImageMediaType (code = 'image' in codeSystem 'MediaType')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Datum/Tijd
|style="background-color: white;"|T - 500 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="7"|Foetusspecifieke onderzoeksgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="117"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Foetus
|style="background-color: white;"|Zie [[#XXX_Osse_Foetus|Foetus: XXX_Osse_Foetus]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Patient
|style="background-color: white;"|Zie [[#XXX_Osse_Vrouw|Patient: XXX_Osse_Vrouw]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Echoscopie
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="113"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verrichting (Maternaal onderzoek)
|style="background-color: white;"|Zie [[#FoetaleGroeiEcho|Verrichting (Maternaal onderzoek): FoetaleGroeiEcho]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Echografische bevindingen algemeen (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|ConclusieWaarde
|style="background-color: white;"|Verdenking afwijking (code = '2' in codeSystem '2.16.840.1.113883.2.4.4.13.56')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|VerdenkingAfwijkingobvWaarde
|style="background-color: white;"|Verdenking structurele afwijking (code = '1' in codeSystem '2.16.840.1.113883.2.4.3.22.1.2.200')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|AdviesWaarde
|style="background-color: white;"|Verwijzing GUO2 (code = '4' in codeSystem '2.16.840.1.113883.2.4.4.13.57')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Biometrie
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="46"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleBuikomtrek / AC (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ACWaarde
|style="background-color: white;"|151 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ACDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleSchedelomvang
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SchedelomvangMeetmethode
|style="background-color: white;"|Meten van schedelomvang m.b.v. echografisch onderzoek (code = '31561000146107' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SchedelomvangWaarde
|style="background-color: white;"|16.8 cm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SchedelomvangDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleFemurlengte / FL (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|FLWaarde
|style="background-color: white;"|31 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|FLDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleBipariëtaleDiameter / BPD (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BPDWaarde
|style="background-color: white;"|49 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BPDDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaalLongitudinaleBlaasDiameter / LBD (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|LBDWaarde
|style="background-color: white;"|52 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|LBDDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleKruinRompLengte / CRL (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CRLWaarde
|style="background-color: white;"|153 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CRLDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleTranscerebellarDiameter / TCD (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|TCDWaarde
|style="background-color: white;"|21 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|TCDDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaleNekplooidikte / NT (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NTWaarde
|style="background-color: white;"|2 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NTDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|FoetaalGeschatGewicht / EFW (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EFWWaarde
|style="background-color: white;"|320 g
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|EFWDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Bevindingen
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="48"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Beweging foetus (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BewegingFoetusDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|BewegingFoetusWaarde
|style="background-color: white;"|foetale bewegingen aanwezig (bevinding) (code = '289431008' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Vruchtwater (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|HoeveelheidVruchtwaterWaarde
|style="background-color: white;"|normaal vruchtwatervolume (bevinding) (code = '278092006' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|VruchtwatercompartimentWaarde
|style="background-color: white;"|niet te bepalen (kwalificatiewaarde) (code = '1156316003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|PlacentaLokalisatie (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|PlacentaLokalisatieDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|PlacentalokalisatieWaarde
|style="background-color: white;"|rechts laterale positie van placenta (bevinding) (code = '7401000146107' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|OstiumWaarde
|style="background-color: white;"|normaal (kwalificatiewaarde) (code = '17621005' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Cervixlengte (Meting)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="4"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CervixlengteWaarde
|style="background-color: white;"|31 mm
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|MeetMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|CervixlengteDatumBeginTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Navelstreng (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NavelstrengDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NavelstrengWaarde
|style="background-color: white;"|normaal (kwalificatiewaarde) (code = '17621005' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|NavelstrengVatenWaarde
|style="background-color: white;"|drie bloedvaten in navelstreng (bevinding) (code = '29691000146104' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|OrgaansysteemFoetus (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|OrgaansysteemFoetusDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieNaam
|style="background-color: white;"|structuur van wervelkolom (lichaamsstructuur)+structuur van medulla spinalis (lichaamsstructuur) (code = '421060004+2748008' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|OrgaansysteemFoetusWaarde
|style="background-color: white;"|Verdenking afwijking (code = '2' in codeSystem '2.16.840.1.113883.2.4.4.13.55')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Probleem (Wervelkolom, ruggenmerg)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="6"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemType
|style="background-color: white;"|klinische bevinding (code = '404684003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemNaam
|style="background-color: white;"|spina bifida occulta (aandoening) (code = '76916001' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemBeginDatum
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ProbleemStatus
|style="background-color: white;"|Actueel (code = '55561003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|VerificatieStatus
|style="background-color: white;"|Werk (code = '415684004' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Sonomarkers (Observatie)
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="5"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SonomarkerNaam
|style="background-color: white;"|echogeniciteit van foetale darmen bij obstetrische echografie (bevinding) (code = '698598000' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|SonomarkerWaarde
|style="background-color: white;"|Geen sonomarker geconstateerd (code = '1' in codeSystem '2.16.840.1.113883.2.4.4.13.54')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|ObservatieMethode
|style="background-color: white;"|echografie (kwalificatiewaarde) (code = '278292003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|TekstUitslag
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="8"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstUitslagDatumTijd
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|Verrichting
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="2"|Verrichting (Maternaal onderzoek)
|style="background-color: white;"|Zie [[#FoetaleGroeiEcho|Verrichting (Maternaal onderzoek): FoetaleGroeiEcho]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstUitslagStatus
|style="background-color: white;"|Definitief (code = 'final' in codeSystem 'ZIB Laboratoriumuitslag Testuitslag ResultaatStatus')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstResultaat
|style="background-color: white;"|verdenking afwijking spina bifida
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|TekstUitslagType
|style="background-color: white;"|echografie (code = '16310003' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="7"|Maternale onderzoeksgegevens
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="10"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Patient
|style="background-color: white;"|Zie [[#XXX_Osse_Vrouw|Patient: XXX_Osse_Vrouw]]
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="6"|Verrichting (Maternaal onderzoek) FoetaleGroeiEcho
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="7"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|VerrichtingStartDatum
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|VerrichtingEindDatum
|style="background-color: white;"|T - 570 dagen
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="4"|VerrichtingType
|style="background-color: white;"|echografie voor foetale groei (verrichting) (code = '241493005' in codeSystem 'SNOMED CT')
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="5"|Locatie
|-style="vertical-align:top; background-color: #E3E3E3;"
|rowspan="2"|
|-style="vertical-align:top; background-color: #E3E3E3;"
|colspan="3"|Zorgaanbieder
|style="background-color: white;"|Zie [[#ZA1_EchopraktijkGroei|Zorgaanbieder: ZA1_EchopraktijkGroei]]
|}<section end=medisch_onderzoek_ />

__NOINDEX__

gz:V3.2 Testscript

2026-07-23T12:22:10Z

Ahsen Yurt: Nieuwe pagina aangemaakt met '{{subst:QA_template_testscripts}}'

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2026-03-27T09:18:42Z

Ahsen Yurt: /* Doelgroep */

{{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.
 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 elke 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-27T09:18:21Z

Ahsen Yurt:

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

==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.
 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 elke 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-26T08:58:45Z

Ahsen Yurt: /* 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].

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.
 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 elke 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-26T08:58:02Z

Ahsen Yurt: /* 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].

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.
 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 elke 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 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-17T10:21:08Z

Ahsen Yurt: /* 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 [[#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.
 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 elke 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}}

imm:V2 Test Vaccinatie-Immunisatie Raadplegen

2026-02-25T11:13:41Z

Ahsen Yurt: /* Uit te voeren stappen */

__NOINDEX__

{{IssueBox|Deze pagina is nog in ontwikkeling.}}



<div class="noprint" style="background-color:#FAFAFA; position:fixed; bottom:2%; right:0.5%; padding:0; margin:0;">
[[#BackToTop|Back to Top]]
</div>



__NUMBEREDHEADINGS__

{{DISPLAYTITLE:Vaccinatie-Immunisatie 2.1.0-Bèta.1 - test Nictiz - Vaccinaties Raadplegen}}
__TOC__
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|75px|75px|link=imm:Landingspagina_Vaccinatie_Immunisatie|Vaccinatie-Immunisatie]]


= Inleiding =
== Algemene informatie ==
Dit testscript is opgesteld op naam van Nictiz. De op te vragen onderdelen zijn waar mogelijk gekoppeld aan zorginformatiebouwstenen. Actuele informatie over de informatiestandaard van dit testscript kan je vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|Landingspagina Vaccinatie-Immunisatie]].
Het testen geeft de mogelijkheid om de technische berichten te controleren. Visuele controle van schermafdrukken is geen onderdeel van het testen. Het advies is om alle relevante scenario's te testen. De testmaterialen kunnen worden aangevuld en gewijzigd.

== Doelgroep ==

De doelgroep van dit testscript is de leverancier die zich wil voorbereiden op de kwalificatie voor het uitwisselen van Vaccinatie-Immunisatie.
Dit testmateriaal is ontwikkeld voor de systeemrol: Raadplegend/Beschikbaar stellen


Dit document beschrijft het te doorlopen script bij testen voor kwalificatie voor de systeemrol:
* Raadplegen vaccinatiegegevens

== Voorwaarden voor testen==
Voor het uitvoeren van deze test gelden de algemene voorwaarden voor testen en kwalificeren bij Nictiz.
Specifiek de onderstaande voorwaarden:
* Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie et cetera.
* Kennis, begrip, en het naleven van de aandachtspunten zoals beschreven in dit document.
* De testdocumentatie bevat de gegevens die de testende partij zelf invoert.
* Kennis en begrip van de Informatiestandaard Vaccinatie-Immunisatie.

<noinclude>
{{highlight|OPTIONEEL: informatie over vereiste kennis om de tests uit te kunnen voeren.|LightGreen}}
Voor deze test gelden daarnaast ook de volgende specifieke voorwaarden:
# (genummerde lijst van specifieke voorwaarden) </noinclude>

== Begrippenlijst ==
Nictiz maakt gebruik van bepaalde afkortingen en termen. Meer informatie kan gevonden worden in [https://nictiz.nl/standaarden/begrippen/ deze algemene begrippenlijst]. Daarnaast is er een [https://thesauruszorgenwelzijn.multites.net/ thesaurus] waarin begrippen kunnen worden opgezocht.
<noinclude>
{{highlight|OPTIONEEL: Aanvullende begrippenlijst in tabelvorm. Kopieer handmatig de tekst en vul de tabel aan.|LightGreen}}
Daarnaast zijn de volgende begrippen relevant in het kader van testen.
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; width: 25%;"
| Begrip || Toelichting
|-style="background-color: #F0F8FF;"
| Zorgnetwerktransactie|| ...
|}
</noinclude>

= Test-informatie =
Nictiz biedt leveranciers de mogelijkheid hun producten en diensten te testen op correcte implementatie van informatiestandaarden ter voorbereiding op de kwalificatie.
Bij het uitvoeren van deze testen is het niet nodig om schermafbeeldingen te maken, maar kunnen behulpzaam zijn in het corrigeren van fouten. Daarnaast maakt het testen van infrastructurele eisen geen onderdeel uit van dit script.
== Testaanpak ==
Houd tijdens het testen de bevindingen bij van de uitgevoerde tests. Analyseer de bevindingen, corrigeer fouten waar nodig en test opnieuw.
==Tools voor testen/kwalificatie==
===ART-DECOR===
Voor meer informatie over het testen met de simulator vanuit ART-DECOR: [https://decor.nictiz.nl/wiki/index.php/Testen_met_ART-DECOR Testen met ART-DECOR].

# Maak volgens de [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Inhoudelijke_gegevens | inhoudelijke gegevens]] de testpersoon aan.
# Stuur het technisch bericht richting de testsimulator.
# De testsimulator zal het bericht ontvangen en technisch valideren.
# Koppel het bericht aan de bijbehorende testsuite op de ‘Tests’ tab van de simulator.
# De testsimulator zal valideren of het bericht de verwachte inhoud heeft.

===ConformanceLab===
Nictiz stelt het testsysteem Conformancelab beschikbaar voor het testen van systeemrollen met bijbehorende informatiestandaarden als voorbereiding op het kwalificatieproces. (Kandidaat)deelnemers kunnen Conformancelab eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.

Voor het aansluiten op ConformanceLab is [[Kwalificatie:V1.0_Handleiding_Conformancelab|een aparte handleiding beschikbaar]].

= Testscript =
== Uit te voeren stappen ==
Voer – voor ieder scenario – de volgende stappen uit:

'''Raadplegen'''

1. Raadpleeg vaccinatiegegevens voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. De query parameters betreffen:
*Patient.Identificatienummer
*Patient.Geboortedatum
*Patient.Naamgegevens.Geslachtsnaam.Achternaam
*Patient.Naamgegevens.GeslachtsnaamPartner.AchternaamPartner

2. De testsimulator (ConformanceLab) zal de vaccinatiegegevens beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].

3. Ontvang en verwerk (gestructureerd opslaan in database) de vaccinatiegegevens in het systeem.

== Overzicht testscenario's ==


{{highlight|Links inhoudelijke gegevens controleren zodra ADA2Wiki op deze pagina is geplaatst.}}
{{highlight|Beschikbaarstellen scenario's}}
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || Huisarts stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden (incl. alleen registratiedatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_minimaal|Beschikbaarstellen Huisarts Minimaal]]
|-
| 2 || Huisarts stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens (excl. registratiedatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_maximaal|Beschikbaarstellen Huisarts Maximaal]]
|-
| 3 || Huisarts stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens (incl registratiedatumtijd en toedieningsdatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_beide_data|Beschikbaarstellen Huisarts incl. Registratiedatum en Toedieningsdatum]]
|-
| 4 || JGZ organisatie stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder ||DDJGZ kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_JGZ_maximaal|Beschikbaarstellen JGZ Minimaal]]
|-
| 5 || JGZ organisatie stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || DDJGZ kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_JGZ_maximaal|Beschikbaarstellen JGZ Maximaal]]
|-
| 6 || Zorgaanbieder/RIVM stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_minimaal|Beschikbaarstellen Algemeen Minimaal]]
|-
| 7 ||Zorgaanbieder/RIVM stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_maximaal|Beschikbaarstellen Algemeen Maximaal]]
|-
| 8 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit de G-standaard beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met een GPK code uit de G-standaard mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_g-standaard|Beschikbaarstellen Algemeen Meerdere Vaccinaties G-standaard]]
|-
| 9 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit SNOMED beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met een SNOMED code mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties SNOMED]]
|-
| 10 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit zowel de G-standaard als SNOMED beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met zowel een SNOMED code als een GPK code uit de G-standaard mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties__g-standaard_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties G-standaard en SNOMED]]
|-
| 11 || Zorgaanbieder/RIVM stelt patiënt- en vaccinatiegegevens beschikbaar zonder achternaam van de patiënt aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin zonder achternaam van de patiënt de gevulde velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_zonder_achternaam|Beschikbaarstellen Algemeen zonder achternaam]]
|-
|}

{{highlight|Raadplegen scenario's}}
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || De zorgaanbieder raadpleegt een minimale set van vaccinatiegegevens bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin op basis van de verplichte velden wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_minimaal|Raadplegen Minimaal]]
|-
| 2 || De zorgaanbieder raadpleegt een maximale set van vaccinatiegegevens bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin op basis van alle velden wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_maximaal|Raadplegen Maximaal]]
|-
| 3 || Zorgaanbieder raadpleegt patiënt- en vaccinatiegegevens zonder achternaam van de patiënt/cliënt bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin zonder achternaam van de patiënt/cliënt wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_zonder_achternaam|Raadplegen zonder achternaam]]
|-
|}

= Aandachtspunten voor inhoudelijke gegevens =
== Persoonsgegevens ==
Er is een fictief BSN (fBSN) voor testdoeleinden in de persoonsgegevens opgenomen. Dit is alleen bedoeld voor gebruik in het XIS (registratie van de testpersoon).
== Variabele T-datum ==
Test- en kwalificatiescenario's werken vaak met relatieve datums, die ervoor zorgen dat scenario's niet gedateerd raken. Een datum 'volgende week' blijft zodoende altijd in de toekomst. Om dit te vertalen naar concrete datums die gebruikt worden tijdens het testen en kwalificeren wordt gewerkt met de zogenaamde T-datum.

Voor ConformanceLab geldt: De T datum is altijd de maandag van de week waarin je de tests van dit script uitvoert. Als ergens staat T-100 betekent dit dus: 100 dagen eerder dan de huidige maandag.

Voor de kwalificatieserver van ART-DECOR geldt: Als ergens staat T – 10D betekent dit: 10 dagen eerder dan die afgesproken datum/tijd. Het format is yyyy-mm-ddTuu:mm:ss“

= Inhoudelijke gegevens =

{{#lst:imm:V2_Test_Vaccinatie-Immunisatie_Inhoudelijkegegevens}}

__NOINDEX__

imm:V2 Test Vaccinatie-Immunisatie Raadplegen

2026-02-25T11:05:38Z

Ahsen Yurt: /* Overzicht testscenario's */

__NOINDEX__

{{IssueBox|Deze pagina is nog in ontwikkeling.}}



<div class="noprint" style="background-color:#FAFAFA; position:fixed; bottom:2%; right:0.5%; padding:0; margin:0;">
[[#BackToTop|Back to Top]]
</div>



__NUMBEREDHEADINGS__

{{DISPLAYTITLE:Vaccinatie-Immunisatie 2.1.0-Bèta.1 - test Nictiz - Vaccinaties Raadplegen}}
__TOC__
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|75px|75px|link=imm:Landingspagina_Vaccinatie_Immunisatie|Vaccinatie-Immunisatie]]


= Inleiding =
== Algemene informatie ==
Dit testscript is opgesteld op naam van Nictiz. De op te vragen onderdelen zijn waar mogelijk gekoppeld aan zorginformatiebouwstenen. Actuele informatie over de informatiestandaard van dit testscript kan je vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|Landingspagina Vaccinatie-Immunisatie]].
Het testen geeft de mogelijkheid om de technische berichten te controleren. Visuele controle van schermafdrukken is geen onderdeel van het testen. Het advies is om alle relevante scenario's te testen. De testmaterialen kunnen worden aangevuld en gewijzigd.

== Doelgroep ==

De doelgroep van dit testscript is de leverancier die zich wil voorbereiden op de kwalificatie voor het uitwisselen van Vaccinatie-Immunisatie.
Dit testmateriaal is ontwikkeld voor de systeemrol: Raadplegend/Beschikbaar stellen


Dit document beschrijft het te doorlopen script bij testen voor kwalificatie voor de systeemrol:
* Raadplegen vaccinatiegegevens

== Voorwaarden voor testen==
Voor het uitvoeren van deze test gelden de algemene voorwaarden voor testen en kwalificeren bij Nictiz.
Specifiek de onderstaande voorwaarden:
* Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie et cetera.
* Kennis, begrip, en het naleven van de aandachtspunten zoals beschreven in dit document.
* De testdocumentatie bevat de gegevens die de testende partij zelf invoert.
* Kennis en begrip van de Informatiestandaard Vaccinatie-Immunisatie.

<noinclude>
{{highlight|OPTIONEEL: informatie over vereiste kennis om de tests uit te kunnen voeren.|LightGreen}}
Voor deze test gelden daarnaast ook de volgende specifieke voorwaarden:
# (genummerde lijst van specifieke voorwaarden) </noinclude>

== Begrippenlijst ==
Nictiz maakt gebruik van bepaalde afkortingen en termen. Meer informatie kan gevonden worden in [https://nictiz.nl/standaarden/begrippen/ deze algemene begrippenlijst]. Daarnaast is er een [https://thesauruszorgenwelzijn.multites.net/ thesaurus] waarin begrippen kunnen worden opgezocht.
<noinclude>
{{highlight|OPTIONEEL: Aanvullende begrippenlijst in tabelvorm. Kopieer handmatig de tekst en vul de tabel aan.|LightGreen}}
Daarnaast zijn de volgende begrippen relevant in het kader van testen.
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; width: 25%;"
| Begrip || Toelichting
|-style="background-color: #F0F8FF;"
| Zorgnetwerktransactie|| ...
|}
</noinclude>

= Test-informatie =
Nictiz biedt leveranciers de mogelijkheid hun producten en diensten te testen op correcte implementatie van informatiestandaarden ter voorbereiding op de kwalificatie.
Bij het uitvoeren van deze testen is het niet nodig om schermafbeeldingen te maken, maar kunnen behulpzaam zijn in het corrigeren van fouten. Daarnaast maakt het testen van infrastructurele eisen geen onderdeel uit van dit script.
== Testaanpak ==
Houd tijdens het testen de bevindingen bij van de uitgevoerde tests. Analyseer de bevindingen, corrigeer fouten waar nodig en test opnieuw.
==Tools voor testen/kwalificatie==
===ART-DECOR===
Voor meer informatie over het testen met de simulator vanuit ART-DECOR: [https://decor.nictiz.nl/wiki/index.php/Testen_met_ART-DECOR Testen met ART-DECOR].

# Maak volgens de [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Inhoudelijke_gegevens | inhoudelijke gegevens]] de testpersoon aan.
# Stuur het technisch bericht richting de testsimulator.
# De testsimulator zal het bericht ontvangen en technisch valideren.
# Koppel het bericht aan de bijbehorende testsuite op de ‘Tests’ tab van de simulator.
# De testsimulator zal valideren of het bericht de verwachte inhoud heeft.

===ConformanceLab===
Nictiz stelt het testsysteem Conformancelab beschikbaar voor het testen van systeemrollen met bijbehorende informatiestandaarden als voorbereiding op het kwalificatieproces. (Kandidaat)deelnemers kunnen Conformancelab eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.

Voor het aansluiten op ConformanceLab is [[Kwalificatie:V1.0_Handleiding_Conformancelab|een aparte handleiding beschikbaar]].

= Testscript =
== Uit te voeren stappen ==
Voer – voor ieder scenario – de volgende stappen uit:

'''Raadplegen'''
# Raadpleeg vaccinatiegegevens voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: maak een schermafdruk van de toegepaste selectie.}}
# De testsimulator (ConformanceLab) zal de vaccinatiegegevens beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Ontvang en verwerk (gestructureerd opslaan in database) de vaccinatiegegevens in het systeem.

== Overzicht testscenario's ==


{{highlight|Links inhoudelijke gegevens controleren zodra ADA2Wiki op deze pagina is geplaatst.}}
{{highlight|Beschikbaarstellen scenario's}}
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || Huisarts stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden (incl. alleen registratiedatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_minimaal|Beschikbaarstellen Huisarts Minimaal]]
|-
| 2 || Huisarts stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens (excl. registratiedatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_maximaal|Beschikbaarstellen Huisarts Maximaal]]
|-
| 3 || Huisarts stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens (incl registratiedatumtijd en toedieningsdatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_beide_data|Beschikbaarstellen Huisarts incl. Registratiedatum en Toedieningsdatum]]
|-
| 4 || JGZ organisatie stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder ||DDJGZ kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_JGZ_maximaal|Beschikbaarstellen JGZ Minimaal]]
|-
| 5 || JGZ organisatie stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || DDJGZ kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_JGZ_maximaal|Beschikbaarstellen JGZ Maximaal]]
|-
| 6 || Zorgaanbieder/RIVM stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_minimaal|Beschikbaarstellen Algemeen Minimaal]]
|-
| 7 ||Zorgaanbieder/RIVM stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_maximaal|Beschikbaarstellen Algemeen Maximaal]]
|-
| 8 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit de G-standaard beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met een GPK code uit de G-standaard mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_g-standaard|Beschikbaarstellen Algemeen Meerdere Vaccinaties G-standaard]]
|-
| 9 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit SNOMED beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met een SNOMED code mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties SNOMED]]
|-
| 10 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit zowel de G-standaard als SNOMED beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met zowel een SNOMED code als een GPK code uit de G-standaard mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties__g-standaard_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties G-standaard en SNOMED]]
|-
| 11 || Zorgaanbieder/RIVM stelt patiënt- en vaccinatiegegevens beschikbaar zonder achternaam van de patiënt aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin zonder achternaam van de patiënt de gevulde velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_zonder_achternaam|Beschikbaarstellen Algemeen zonder achternaam]]
|-
|}

{{highlight|Raadplegen scenario's}}
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || De zorgaanbieder raadpleegt een minimale set van vaccinatiegegevens bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin op basis van de verplichte velden wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_minimaal|Raadplegen Minimaal]]
|-
| 2 || De zorgaanbieder raadpleegt een maximale set van vaccinatiegegevens bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin op basis van alle velden wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_maximaal|Raadplegen Maximaal]]
|-
| 3 || Zorgaanbieder raadpleegt patiënt- en vaccinatiegegevens zonder achternaam van de patiënt/cliënt bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin zonder achternaam van de patiënt/cliënt wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_zonder_achternaam|Raadplegen zonder achternaam]]
|-
|}

= Aandachtspunten voor inhoudelijke gegevens =
== Persoonsgegevens ==
Er is een fictief BSN (fBSN) voor testdoeleinden in de persoonsgegevens opgenomen. Dit is alleen bedoeld voor gebruik in het XIS (registratie van de testpersoon).
== Variabele T-datum ==
Test- en kwalificatiescenario's werken vaak met relatieve datums, die ervoor zorgen dat scenario's niet gedateerd raken. Een datum 'volgende week' blijft zodoende altijd in de toekomst. Om dit te vertalen naar concrete datums die gebruikt worden tijdens het testen en kwalificeren wordt gewerkt met de zogenaamde T-datum.

Voor ConformanceLab geldt: De T datum is altijd de maandag van de week waarin je de tests van dit script uitvoert. Als ergens staat T-100 betekent dit dus: 100 dagen eerder dan de huidige maandag.

Voor de kwalificatieserver van ART-DECOR geldt: Als ergens staat T – 10D betekent dit: 10 dagen eerder dan die afgesproken datum/tijd. Het format is yyyy-mm-ddTuu:mm:ss“

= Inhoudelijke gegevens =

{{#lst:imm:V2_Test_Vaccinatie-Immunisatie_Inhoudelijkegegevens}}

__NOINDEX__

imm:V2 Test Vaccinatie-Immunisatie Raadplegen

2026-02-25T10:58:44Z

Ahsen Yurt: /* Overzicht testscenario's */

__NOINDEX__

{{IssueBox|Deze pagina is nog in ontwikkeling.}}



<div class="noprint" style="background-color:#FAFAFA; position:fixed; bottom:2%; right:0.5%; padding:0; margin:0;">
[[#BackToTop|Back to Top]]
</div>



__NUMBEREDHEADINGS__

{{DISPLAYTITLE:Vaccinatie-Immunisatie 2.1.0-Bèta.1 - test Nictiz - Vaccinaties Raadplegen}}
__TOC__
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|75px|75px|link=imm:Landingspagina_Vaccinatie_Immunisatie|Vaccinatie-Immunisatie]]


= Inleiding =
== Algemene informatie ==
Dit testscript is opgesteld op naam van Nictiz. De op te vragen onderdelen zijn waar mogelijk gekoppeld aan zorginformatiebouwstenen. Actuele informatie over de informatiestandaard van dit testscript kan je vinden via de [[imm:Landingspagina_Vaccinatie_Immunisatie|Landingspagina Vaccinatie-Immunisatie]].
Het testen geeft de mogelijkheid om de technische berichten te controleren. Visuele controle van schermafdrukken is geen onderdeel van het testen. Het advies is om alle relevante scenario's te testen. De testmaterialen kunnen worden aangevuld en gewijzigd.

== Doelgroep ==

De doelgroep van dit testscript is de leverancier die zich wil voorbereiden op de kwalificatie voor het uitwisselen van Vaccinatie-Immunisatie.
Dit testmateriaal is ontwikkeld voor de systeemrol: Raadplegend/Beschikbaar stellen


Dit document beschrijft het te doorlopen script bij testen voor kwalificatie voor de systeemrol:
* Raadplegen vaccinatiegegevens

== Voorwaarden voor testen==
Voor het uitvoeren van deze test gelden de algemene voorwaarden voor testen en kwalificeren bij Nictiz.
Specifiek de onderstaande voorwaarden:
* Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie et cetera.
* Kennis, begrip, en het naleven van de aandachtspunten zoals beschreven in dit document.
* De testdocumentatie bevat de gegevens die de testende partij zelf invoert.
* Kennis en begrip van de Informatiestandaard Vaccinatie-Immunisatie.

<noinclude>
{{highlight|OPTIONEEL: informatie over vereiste kennis om de tests uit te kunnen voeren.|LightGreen}}
Voor deze test gelden daarnaast ook de volgende specifieke voorwaarden:
# (genummerde lijst van specifieke voorwaarden) </noinclude>

== Begrippenlijst ==
Nictiz maakt gebruik van bepaalde afkortingen en termen. Meer informatie kan gevonden worden in [https://nictiz.nl/standaarden/begrippen/ deze algemene begrippenlijst]. Daarnaast is er een [https://thesauruszorgenwelzijn.multites.net/ thesaurus] waarin begrippen kunnen worden opgezocht.
<noinclude>
{{highlight|OPTIONEEL: Aanvullende begrippenlijst in tabelvorm. Kopieer handmatig de tekst en vul de tabel aan.|LightGreen}}
Daarnaast zijn de volgende begrippen relevant in het kader van testen.
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; width: 25%;"
| Begrip || Toelichting
|-style="background-color: #F0F8FF;"
| Zorgnetwerktransactie|| ...
|}
</noinclude>

= Test-informatie =
Nictiz biedt leveranciers de mogelijkheid hun producten en diensten te testen op correcte implementatie van informatiestandaarden ter voorbereiding op de kwalificatie.
Bij het uitvoeren van deze testen is het niet nodig om schermafbeeldingen te maken, maar kunnen behulpzaam zijn in het corrigeren van fouten. Daarnaast maakt het testen van infrastructurele eisen geen onderdeel uit van dit script.
== Testaanpak ==
Houd tijdens het testen de bevindingen bij van de uitgevoerde tests. Analyseer de bevindingen, corrigeer fouten waar nodig en test opnieuw.
==Tools voor testen/kwalificatie==
===ART-DECOR===
Voor meer informatie over het testen met de simulator vanuit ART-DECOR: [https://decor.nictiz.nl/wiki/index.php/Testen_met_ART-DECOR Testen met ART-DECOR].

# Maak volgens de [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Inhoudelijke_gegevens | inhoudelijke gegevens]] de testpersoon aan.
# Stuur het technisch bericht richting de testsimulator.
# De testsimulator zal het bericht ontvangen en technisch valideren.
# Koppel het bericht aan de bijbehorende testsuite op de ‘Tests’ tab van de simulator.
# De testsimulator zal valideren of het bericht de verwachte inhoud heeft.

===ConformanceLab===
Nictiz stelt het testsysteem Conformancelab beschikbaar voor het testen van systeemrollen met bijbehorende informatiestandaarden als voorbereiding op het kwalificatieproces. (Kandidaat)deelnemers kunnen Conformancelab eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.

Voor het aansluiten op ConformanceLab is [[Kwalificatie:V1.0_Handleiding_Conformancelab|een aparte handleiding beschikbaar]].

= Testscript =
== Uit te voeren stappen ==
Voer – voor ieder scenario – de volgende stappen uit:

'''Raadplegen'''
# Raadpleeg vaccinatiegegevens voor de testpersoon [[#Overzicht_scenario.E2.80.99s|zoals beschreven in het scenario]]. {{highlight|OPTIONEEL: Indien er query parameters beschreven zijn in het scenario: maak een schermafdruk van de toegepaste selectie.}}
# De testsimulator (ConformanceLab) zal de vaccinatiegegevens beschikbaarstellen conform de [[#Inhoudelijke_gegevens|inhoudelijke gegevens]].
# Ontvang en verwerk (gestructureerd opslaan in database) de vaccinatiegegevens in het systeem.

== Overzicht testscenario's ==


{{highlight|Links inhoudelijke gegevens controleren zodra ADA2Wiki op deze pagina is geplaatst.}}
{{highlight|Beschikbaarstellen scenario's}}
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || Huisarts stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden (incl. alleen registratiedatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_minimaal|Beschikbaarstellen Huisarts Minimaal]]
|-
| 2 || Huisarts stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens (excl. registratiedatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_Huisarts_maximaal|Beschikbaarstellen Huisarts Maximaal]]
|-
| 3 || Huisarts stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || HIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens (incl registratiedatumtijd en toedieningsdatumtijd) mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_JGZ_minimaal|Beschikbaarstellen JGZ Minimaal]]
|-
| 4 || JGZ organisatie stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder ||DDJGZ kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_JGZ_maximaal|Beschikbaarstellen JGZ Maximaal]]
|-
| 5 || JGZ organisatie stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || DDJGZ kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_minimaal|Beschikbaarstellen Algemeen Minimaal]]
|-
| 6 || Zorgaanbieder/RIVM stelt een minimale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin alleen de verplichte velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_maximaal|Beschikbaarstellen Algemeen Maximaal]]
|-
| 7 ||Zorgaanbieder/RIVM stelt een maximale set van patiënt- en vaccinatiegegevens beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin alle gegevens mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_g-standaard|Beschikbaarstellen Algemeen Meerdere Vaccinaties G-standaard]]
|-
| 8 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit de G-standaard beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met een GPK code uit de G-standaard mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties SNOMED]]
|-
| 9 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit SNOMED beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met een SNOMED code mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_g-standaard_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties G-standaard en SNOMED]]
|-
| 10 || Zorgaanbieder stelt patiënt- en vaccinatiegegevens met meerdere vaccinaties uit zowel de G-standaard als SNOMED beschikbaar aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin meerdere vaccinaties met zowel een SNOMED code als een GPK code uit de G-standaard mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties SNOMED]]
|-
| 11 || Zorgaanbieder/RIVM stelt patiënt- en vaccinatiegegevens beschikbaar zonder achternaam van de patiënt aan een andere zorgaanbieder || XIS kan aantoonbaar een bericht beschikbaarstellen waarin zonder achternaam van de patiënt de gevulde velden mee worden gestuurd. || Het systeem genereert technisch correcte berichten || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Beschikbaarstellen_algemeen_meerderevaccinaties_SNOMED|Beschikbaarstellen Algemeen Meerdere Vaccinaties SNOMED]]
|-
|}

{{highlight|Raadplegen scenario's}}
{| class="wikitable"
|-style="background-color: #1F497D;; color: white; text-align:left; width: 25%;"
| Nr || Scenario || Doel van test || Verwacht resultaat || Inhoudelijke gegevens
|-
| 1 || De zorgaanbieder raadpleegt een minimale set van vaccinatiegegevens bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin op basis van de verplichte velden wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_minimaal|Raadplegen Minimaal]]
|-
| 2 || De zorgaanbieder raadpleegt een maximale set van vaccinatiegegevens bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin op basis van alle velden wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_maximaal|Raadplegen Maximaal]]
|-
| 3 || Zorgaanbieder raadpleegt patiënt- en vaccinatiegegevens zonder achternaam van de patiënt/cliënt bij een andere zorgaanbieder || XIS kan aantoonbaar een bericht raadplegen waarin zonder achternaam van de patiënt/cliënt wordt bevraagd. || Het systeem ontvangt, verwerkt en toont de patiënt- en vaccinatiegegevens || [[imm:V2_Test_Vaccinatie-Immunisatie_Raadplegen#Raadplegen_maximaal|Raadplegen Maximaal]]
|-
|}

= Aandachtspunten voor inhoudelijke gegevens =
== Persoonsgegevens ==
Er is een fictief BSN (fBSN) voor testdoeleinden in de persoonsgegevens opgenomen. Dit is alleen bedoeld voor gebruik in het XIS (registratie van de testpersoon).
== Variabele T-datum ==
Test- en kwalificatiescenario's werken vaak met relatieve datums, die ervoor zorgen dat scenario's niet gedateerd raken. Een datum 'volgende week' blijft zodoende altijd in de toekomst. Om dit te vertalen naar concrete datums die gebruikt worden tijdens het testen en kwalificeren wordt gewerkt met de zogenaamde T-datum.

Voor ConformanceLab geldt: De T datum is altijd de maandag van de week waarin je de tests van dit script uitvoert. Als ergens staat T-100 betekent dit dus: 100 dagen eerder dan de huidige maandag.

Voor de kwalificatieserver van ART-DECOR geldt: Als ergens staat T – 10D betekent dit: 10 dagen eerder dan die afgesproken datum/tijd. Het format is yyyy-mm-ddTuu:mm:ss“

= Inhoudelijke gegevens =

{{#lst:imm:V2_Test_Vaccinatie-Immunisatie_Inhoudelijkegegevens}}

__NOINDEX__

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2025-12-01T10:32:32Z

Ahsen Yurt:

{{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}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2025-12-01T10:32:22Z

Ahsen Yurt:

{{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].}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0 alpha}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 FHIR Vaccination-Immunization alpha

2025-12-01T10:26:14Z

Ahsen Yurt:

{{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}}

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

=Introduction=
This page describes 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| 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.

'''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=
{| class="wikitable"
! 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="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
|-
| 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={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|-
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

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

==Introduction==
The retrieve vaccinations transaction is used by the PHR to retrieve vaccinations from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! 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: white;vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve vaccinations request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request vaccinations from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve vaccinations response
|style="background-color: white;vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves vaccinations to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger events====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message.

====Message semantics====
'''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 Observation 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.

{| class="wikitable"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|-
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|-
| <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:patient</pre>
|-
| <code>location</code>
| This will specify the resource for the location where the Immunization took place.
|
Retrieve the Immunization and Location resource:
<pre>GET [base]/Immunization?_include:location</pre>
|-
| <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:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query. 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}}
}}

=====Expected actions=====
The XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

====Trigger events====
The XIS completed processing of the retrieve vaccinations request message.

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

{{imm:V2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

{| class="wikitable"
! style="font-weight: bold;text-align:left;" | Building block (EN)
! style="font-weight: bold;text-align:left;" | Building block (NL)
! style="font-weight: bold;text-align:left;" | FHIR resource
! style="font-weight: bold;text-align:left;" | FHIR profile
|-
| Vaccination
| Vaccinatie
| Immunization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}}}
|-
| PharmaceuticalProduct
| FarmaceutischProduct
| Medication
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}}}
|-
| Patient
| Patiënt
| 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}}}}
|-
| rowspan="2" | HealthProfessional
| rowspan="2" | Zorgverlener
| 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}}}}
|-
| 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}}}}
|-
| rowspan="2" | HealthcareProvider
| rowspan="2" | Zorgaanbieder
| 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}}}}
|-
| 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}}}}
|-
|}

====Expected actions====
The PHR processes the results according to application-defined rules.

=Release notes=
Release notes can be found on the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie#Release_notes| functional design page]].
{{MedMij:Sjabloon_Support}}

imm:V2 FHIR Vaccination-Immunization alpha

2025-12-01T10:25:22Z

Ahsen Yurt:

{{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 {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}

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

=Introduction=
This page describes 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| 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.

'''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=
{| class="wikitable"
! 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="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
|-
| 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={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|-
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

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

==Introduction==
The retrieve vaccinations transaction is used by the PHR to retrieve vaccinations from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! 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: white;vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve vaccinations request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request vaccinations from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve vaccinations response
|style="background-color: white;vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves vaccinations to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger events====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message.

====Message semantics====
'''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 Observation 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.

{| class="wikitable"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|-
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|-
| <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:patient</pre>
|-
| <code>location</code>
| This will specify the resource for the location where the Immunization took place.
|
Retrieve the Immunization and Location resource:
<pre>GET [base]/Immunization?_include:location</pre>
|-
| <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:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query. 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}}
}}

=====Expected actions=====
The XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

====Trigger events====
The XIS completed processing of the retrieve vaccinations request message.

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

{{imm:V2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

{| class="wikitable"
! style="font-weight: bold;text-align:left;" | Building block (EN)
! style="font-weight: bold;text-align:left;" | Building block (NL)
! style="font-weight: bold;text-align:left;" | FHIR resource
! style="font-weight: bold;text-align:left;" | FHIR profile
|-
| Vaccination
| Vaccinatie
| Immunization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}}}
|-
| PharmaceuticalProduct
| FarmaceutischProduct
| Medication
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}}}
|-
| Patient
| Patiënt
| 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}}}}
|-
| rowspan="2" | HealthProfessional
| rowspan="2" | Zorgverlener
| 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}}}}
|-
| 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}}}}
|-
| rowspan="2" | HealthcareProvider
| rowspan="2" | Zorgaanbieder
| 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}}}}
|-
| 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}}}}
|-
|}

====Expected actions====
The PHR processes the results according to application-defined rules.

=Release notes=
Release notes can be found on the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie#Release_notes| functional design page]].
{{MedMij:Sjabloon_Support}}

imm:V2 FHIR Vaccination-Immunization alpha

2025-12-01T10:24:57Z

Ahsen Yurt: Nieuwe pagina aangemaakt met '{{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...'

{{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 {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Introduction=
This page describes 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| 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.

'''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=
{| class="wikitable"
! 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="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
|-
| 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={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}|title=CapabilityStatement: Retrieve Serve}}
| rowspan="2" | FHIR client/server requirements
|-
| (Healthcare) provider
| The user of a XIS
| XIS
| (Healthcare) information system
|}

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

==Introduction==
The retrieve vaccinations transaction is used by the PHR to retrieve vaccinations from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! 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: white;vertical-align:top;" rowspan="2"|Retrieve vaccinations(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve vaccinations request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request vaccinations from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve vaccinations response
|style="background-color: white;vertical-align:top;"|(Healthcare) provider (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves vaccinations to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger events====
When the patient (PHR) wants to obtain vaccinations, it issues a retrieve vaccinations request message.

====Message semantics====
'''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 Observation 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.

{| class="wikitable"
! colspan="3" style="font-weight: bold;text-align:left;" | Immunization
|-
| style="font-weight: bold;text-align:left;" | Name
| style="font-weight: bold;text-align:left;" | Description
| style="font-weight: bold;text-align:left;" | Example
|-
| <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:patient</pre>
|-
| <code>location</code>
| This will specify the resource for the location where the Immunization took place.
|
Retrieve the Immunization and Location resource:
<pre>GET [base]/Immunization?_include:location</pre>
|-
| <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:performer</pre>
|}

At this point in time, there are no use cases for filter parameters on the query. 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}}
}}

=====Expected actions=====
The XIS SHALL process the query to retrieve patient's Immunization resources and the referenced resources.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching information.

====Trigger events====
The XIS completed processing of the retrieve vaccinations request message.

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

{{imm:V2_NoteBoxPackage|p1=nictiz.fhir.nl.r4.immunization|v1={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}|p2=nictiz.fhir.nl.r4.nl-core|v2={{VersieInfo|nictiz.fhir.nl.r4.nl-core|release=V2|namespace=imm}}}}

{| class="wikitable"
! style="font-weight: bold;text-align:left;" | Building block (EN)
! style="font-weight: bold;text-align:left;" | Building block (NL)
! style="font-weight: bold;text-align:left;" | FHIR resource
! style="font-weight: bold;text-align:left;" | FHIR profile
|-
| Vaccination
| Vaccinatie
| Immunization
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-Vaccination-event|nictiz.fhir.nl.r4.immunization|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}}}
|-
| PharmaceuticalProduct
| FarmaceutischProduct
| Medication
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/imm-PharmaceuticalProduct|nictiz.fhir.nl.r4.immunization|pkgVersion={{VersieInfo|nictiz.fhir.nl.r4.immunization|release=V2|namespace=imm}}}}
|-
| Patient
| Patiënt
| 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}}}}
|-
| rowspan="2" | HealthProfessional
| rowspan="2" | Zorgverlener
| 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}}}}
|-
| 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}}}}
|-
| rowspan="2" | HealthcareProvider
| rowspan="2" | Zorgaanbieder
| 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}}}}
|-
| 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}}}}
|-
|}

====Expected actions====
The PHR processes the results according to application-defined rules.

=Release notes=
Release notes can be found on the [[imm:V2_Ontwerp_Vaccinatie-Immunisatie#Release_notes| functional design page]].
{{MedMij:Sjabloon_Support}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2025-12-01T09:37:07Z

Ahsen Yurt:

{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie 2.1.0 alpha}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2025-12-01T09:34:25Z

Ahsen Yurt:

{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:V2 Ontwerp Vaccinatie-Immunisatie alpha

2025-12-01T09:33:57Z

Ahsen Yurt: Nieuwe pagina aangemaakt met '{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}} {{underconstruction}} __NOINDEX__ __NUMBEREDHEADINGS__ {{DISPLAYTITLE:Functioneel Ontwerp Va...'

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Functioneel Ontwerp Vaccinatie-Immunisatie 2.0.5 alpha

2025-11-28T09:33:50Z

Ahsen Yurt: New page for issue VI-94

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Functioneel_Ontwerp_Vaccinatie-Immunisatie_2.0.5_alpha}}
__NOINDEX__

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:41:54Z

Ahsen Yurt: /* Systemen & Systeemrollen */

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:41:23Z

Ahsen Yurt: /* Systemen & Systeemrollen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:40:51Z

Ahsen Yurt: /* Systemen & Systeemrollen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:39:06Z

Ahsen Yurt: /* Systemen & Systeemrollen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|500px|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:37:41Z

Ahsen Yurt: /* Transacties & Transactiegroepen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:FO_use_case_diagram_VI_zorgnetwerk.jpg|700px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:36:34Z

Ahsen Yurt: /* Systemen & Systeemrollen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:UsecaseDiagram_Vaccinaties.png|500px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:33:57Z

Ahsen Yurt: Versie 286954 van Ahsen Yurt (overleg) ongedaan gemaakt

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:UsecaseDiagram_Vaccinaties.png|500px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:32:58Z

Ahsen Yurt: /* Usecase diagram */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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:FO_use_case_diagram_VI_zorgnetwerk.jpg|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:UsecaseDiagram_Vaccinaties.png|500px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

Bestand:FO use case diagram VI zorgnetwerk.jpg

2025-11-24T15:32:17Z

Ahsen Yurt:

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:31:49Z

Ahsen Yurt: /* Systemen & Systeemrollen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:FO_componentendiagram_VI_zorgnetwerk.jpg|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:UsecaseDiagram_Vaccinaties.png|500px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

Bestand:FO componentendiagram VI zorgnetwerk.jpg

2025-11-24T15:31:39Z

Ahsen Yurt:

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-24T15:31:15Z

Ahsen Yurt: /* Bedrijfsrollen en UML activity diagram */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
{{underconstruction}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:UML_activity_diagram_VI_zorgnetwerk.jpg|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:UsecaseDiagram_Vaccinaties.png|500px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

Bestand:UML activity diagram VI zorgnetwerk.jpg

2025-11-24T15:31:02Z

Ahsen Yurt:

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-20T11:54:06Z

Ahsen Yurt:

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

Voor uitwisseling van Vaccinatiegegevens worden in de huidige versie/scope in de basis de volgende zibs uit publicatie 2020 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) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de [https://zibs.nl/wiki/Vaccinatie-v6.0.1(2024NL) Vaccinatie Zib 2024] gedaan)

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:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]] TOEVOEGEN JUISTE LINK NAAR TO .

==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.
 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 elke 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 Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt. TOEVOEGEN JUISTE LINK NAAR TO .

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
* De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
* De (zorg)aanbieder wil vaccinaties 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 na controle op verleende toestemming.
* 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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Bestand:ActivityDiagram_Vaccinaties.png|500px|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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 Vaccinaties 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 Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:ComponentDiagram_Vaccinaties.png|500px|Componenten diagram]]

'''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 en tabel is dit schematisch weergegeven:

[[Bestand:UsecaseDiagram_Vaccinaties.png|500px|UsecaseDiagram Vaccinaties]]

'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR TRANSACTIE 

====Samenhang bedrijfsrollen, activiteiten, transacties, systeemrollen en transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! 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:Vprepub-2_FHIR_Vaccination-Immunization|Vaccinaties in FHIR]] TOEVOEGEN JUISTE LINK NAAR TO .
|-
| (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==
Voor nadere informatie wordt verwezen naar paragraaf [[#Richtlijn|1.3.1 Richtlijn]].

==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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-11-05T14:00:05Z

Ahsen Yurt: /* Transacties & Transactiegroepen */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[Bestand:MedMij2.png|link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[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.28s.29|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 de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

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

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Zorgverlener-v3.5(2020NL) Zorgverlener]
* [https://zibs.nl/wiki/(zorg)aanbieder-v3.4(2020NL) (Zorg)Aanbieder]
* [https://zibs.nl/wiki/FarmaceutischProduct-v2.1.2(2020NL) Farmaceutisch Product]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie] (let op: in deze informatiestandaard is een pre-adopt van de zib 2024 gedaan)

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in het hoofdstuk [[#Informatieoverdracht| 2.2.4 Informatieoverdracht]] en [[##Informatieoverdracht| 2.3.4 Informatieoverdracht]] en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden in het [[imm:Vprepub-2_FHIR_Vaccination-Immunization|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.
 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 [https://informatiestandaarden.nictiz.nl/wiki/Immu:V0.1_Ontwerpen informatiestandaard 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 voor de Zorgnetwerk usecase. En voor de MedMij gegevensdienst niet anders dan genoemd 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 elke usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp worden de usecases voor het verzamelen van Vaccinatiegegevens door een persoon (MedMij gegevensdienst) en het uitwisselen van Vaccinatiegegevens tussen (zorg)aanbieders (Zorgnetwerk usecase) beschreven. In de toekomst zullen de usecases verder worden uitgebreid ten behoeve van de uitwisseling tussen (zorg)aanbieders.

==Usecase: Raadplegen Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de (zorg)aanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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 (prepublicatie 2022-1) 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 (zorg)aanbieder 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 (zorg)aanbieder 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 aangeeft wat de status is van een vaccintoediening op moment van vaccinatieregistratie.
|-
| 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 prepublicatie 2022-1: [https://zibs.nl/wiki/Vaccinatie-v5.0(2022NL) Zib Vaccinatie v5.0(2022NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| 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 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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

==Usecase: Raadplegen Vaccinaties 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 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 vaccinaties van een persoon beschikbaar aan het systeem van een andere (zorg)aanbieder (XIS).

=====Preproces=====
De persoon heeft toestemming gegeven voor het elektronisch uitwisselen van de vaccinaties tussen de betreffende XISsen.
De (zorg)aanbieder wil vaccinaties inzien en de andere (zorg)aanbieder stelt deze beschikbaar.

=====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 de (zorg)aanbieder B ontvangt de bevraging met queryparameters.
* Het informatiesysteem stelt de vaccinatiegegevens beschikbaar na controle op verleende toestemming.
* Het informatiesysteem van (zorg)aanbieder A toont de waarneemsamenvatting.

=====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 vaccinaties
|-
| style="background-color: white;"| (Zorg)Aanbieder B
| style="background-color: white;"| Beschikbaarstellen toegediende vaccinaties
|-
|}
'''Bedrijfsrollen Vaccinaties'''

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

UML Activity diagram NOG TOEVOEGEN
[[Image:.png|Activiteitendiagram Raadplegen Vaccinaties]]
'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Beschikbaarstellend systeem
| style="background-color: white;"| IMM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de (zorg)aanbieder
|-
|}

Zie ook onderstaande afbeelding.
 ComponentDiagram NOG TOEVOEGEN
[[Bestand:.png|Componenten diagram]]
'''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 en tabel is dit schematisch weergegeven:
 USECASE DIAGRAM NOG TOEVOEGEN 
'''Usecase diagram Raadplegen toegediende vaccinaties'''

 TOEVOEGEN LINK ART DECOR 

====Transacties & Transactiegroepen====
{| class="wikitable" style="width:100%; text-align:left;"
! Use case
! Transactiegroep
! Transactie
! Systeemrol
! Systeem
! Bedrijfsrol
|-
| (Zorg)Aanbieder A raadpleegt vaccinatiegegevens bij (zorg)aanbieder B ((Zorg)aanbieder A → (Zorg)aanbieder B)
| Raadplegen vaccinatiegegevens
| Raadplegen vaccinatiegegevens
| IMM-VAR-FHIR
| XIS
| Zorgverlener
|-
| (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==
Voor meer informatie zie ook [[#Richtlijn en proces|1.2.1 Richtlijn en proces]].

==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 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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-10-31T11:04:28Z

Ahsen Yurt: /* Doelgroep */

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[Bestand:MedMij2.png|link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Dit functioneel ontwerp beschrijft het verzamelen van Vaccinatiegegevens door een persoon. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

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/zorgaanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[##Usecase.28s.29|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://www.nictiz.nl/standaardisatie/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://www.nictiz.nl/standaardisatie/overzichten/begrippen/ begrippenoverzicht op de Nictiz-website].

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

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in de [[#Informatie-elementen|Informatieparagraaf 2.2.4.2]]. en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden op het [[imm:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]].

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van 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.
 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.

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 [https://informatiestandaarden.nictiz.nl/wiki/Immu:V0.1_Ontwerpen informatiestandaard 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.
====Geografische reikwijdte====
Geen nadere specificatie, anders dan genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Geografische_reikwijdte| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz-kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.

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 elke usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp wordt een usecase voor het raadplegen van vaccinaties beschreven. Mochten er in de toekomst andere usecases worden gespecificeerd, dan zullen deze hieronder worden getoond.

==Usecase: Raadplegen Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de zorgaanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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 (prepublicatie 2022-1) 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 Zorgaanbieder als aparte bouwsteen opgenomen.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieAanleiding
| 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 AnatomischeLocatie
| style="background-color: white;vertical-align:top;"| In lijn met de doorontwikkeling van de zib Vaccinatie. Zie prepublicatie 2022-1: [https://zibs.nl/wiki/Vaccinatie-v5.0(2022NL) Zib Vaccinatie v5.0(2022NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| 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 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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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;"|Zorgaanbieder/aanbieder
|}

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

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

=Aanvullende informatie=
==Eisen en wensen==
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.
 Daarnaast is een [[Media:Richtlijn_Deduplicatie_MedMij_gegevensdienst_Vaccinaties.pdf|richtlijn Deduplicatie]] in ontwikkeling. 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.

==Verantwoordelijkheid voor informatie==
Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en zorgaanbieders wanneer de zorggebruiker met de betreffende zorgaanbieder 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 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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-10-31T11:03:58Z

Ahsen Yurt:

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[Bestand:MedMij2.png|link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Dit functioneel ontwerp beschrijft het verzamelen van Vaccinatiegegevens door een persoon. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

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/zorgaanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[##Usecase.28s.29|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://www.nictiz.nl/standaardisatie/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://www.nictiz.nl/standaardisatie/overzichten/begrippen/ begrippenoverzicht op de Nictiz-website].

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

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in de [[#Informatie-elementen|Informatieparagraaf 2.2.4.2]]. en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden op het [[imm:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]].

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van het [[MedMij:FO:V1/FunctioneelOntwerp#Doelgroep|functioneel ontwerp voor MedMij]]. Test tekst.

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

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 [https://informatiestandaarden.nictiz.nl/wiki/Immu:V0.1_Ontwerpen informatiestandaard 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.
====Geografische reikwijdte====
Geen nadere specificatie, anders dan genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Geografische_reikwijdte| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz-kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.

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 elke usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp wordt een usecase voor het raadplegen van vaccinaties beschreven. Mochten er in de toekomst andere usecases worden gespecificeerd, dan zullen deze hieronder worden getoond.

==Usecase: Raadplegen Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de zorgaanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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 (prepublicatie 2022-1) 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 Zorgaanbieder als aparte bouwsteen opgenomen.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieAanleiding
| 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 AnatomischeLocatie
| style="background-color: white;vertical-align:top;"| In lijn met de doorontwikkeling van de zib Vaccinatie. Zie prepublicatie 2022-1: [https://zibs.nl/wiki/Vaccinatie-v5.0(2022NL) Zib Vaccinatie v5.0(2022NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| 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 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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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;"|Zorgaanbieder/aanbieder
|}

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

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

=Aanvullende informatie=
==Eisen en wensen==
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.
 Daarnaast is een [[Media:Richtlijn_Deduplicatie_MedMij_gegevensdienst_Vaccinaties.pdf|richtlijn Deduplicatie]] in ontwikkeling. 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.

==Verantwoordelijkheid voor informatie==
Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en zorgaanbieders wanneer de zorggebruiker met de betreffende zorgaanbieder 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 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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

imm:Vissue-VI-94 Ontwerp Vaccinatie-Immunisatie

2025-10-24T11:48:21Z

Ahsen Yurt: Clone of V2 production page for issue VI-94

{{IssuePaginaWaarschuwing|VI-94|imm:V2_Ontwerp_Vaccinatie-Immunisatie}}
__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vaccinatie-Immunisatie {{VersieInfo|Vaccinatie-Immunisatie|release=V2}}}}
[[Bestand:MedMij2.png|link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Icoon_Nictiz_Cirkel_Informatiestandaard_Vaccinatie.svg|link=|87px|Vaccinatie-Immunisatie]]

=Inleiding=

==Algemeen==
Dit functioneel ontwerp beschrijft het verzamelen van Vaccinatiegegevens door een persoon. Tevens beschrijft dit functioneel ontwerp hoe deze Vaccinatiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van het [[MedMij:FO:V1/FunctioneelOntwerp|functioneel ontwerp voor MedMij]].

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/zorgaanbieders, publieke gezondheidsorganisaties of patiënten/burgers. Daarvoor worden de eisen aangegeven voor het sturen of ontvangen van gegevens. In [[##Usecase.28s.29|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://www.nictiz.nl/standaardisatie/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://www.nictiz.nl/standaardisatie/overzichten/begrippen/ begrippenoverzicht op de Nictiz-website].

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

* [https://zibs.nl/wiki/Patient-v3.2(2020NL) Patiënt]
* [https://zibs.nl/wiki/Vaccinatie-v4.0(2020NL) Vaccinatie]

De functionele specificaties van deze zibs en aanvullende informatie-elementen worden toegelicht in de [[#Informatie-elementen|Informatieparagraaf 2.2.4.2]]. en zijn beschreven in ART-DECOR.

De technische (FHIR-)representatie van deze informatiestandaard is te vinden op het [[imm:Vprepub-2_FHIR_Vaccination-Immunization|technisch ontwerp]].

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van 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.
 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.

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 [https://informatiestandaarden.nictiz.nl/wiki/Immu:V0.1_Ontwerpen informatiestandaard 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.
====Geografische reikwijdte====
Geen nadere specificatie, anders dan genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Geografische_reikwijdte| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:FO:V1/FunctioneelOntwerp#Infrastructuur| de algemene inleiding]] van het functioneel ontwerp voor MedMij.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz-kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.

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 elke usecase geanalyseerd en uitgewerkt.

==Algemeen==
In dit functioneel ontwerp wordt een usecase voor het raadplegen van vaccinaties beschreven. Mochten er in de toekomst andere usecases worden gespecificeerd, dan zullen deze hieronder worden getoond.

==Usecase: Raadplegen Vaccinaties 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 vaccinaties 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 vaccinaties 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 vaccinaties van een persoon beschikbaar aan het systeem van een persoon (PGO).

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

De persoon wil vaccinaties inzien en de (zorg)aanbieder stelt deze ook beschikbaar.
:Een persoon kan steeds zelf het initiatief nemen om de vaccinaties 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 Vaccinaties.
* Het systeem van de zorgaanbieder/aanbieder (XIS) stelt de Vaccinaties beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn Vaccinaties in te zien.

=====Postproces=====
De persoon kan zijn vaccinaties 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 vaccinaties
|-
|style="background-color: white;vertical-align:top;"|(Zorg)Aanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vaccinaties
|}
'''Bedrijfsrollen Vaccinaties'''

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

[[Image:Activity_Diagram_-_Vaccinaties_.png|Activiteitendiagram Raadplegen Vaccinaties]]

'''Activiteitendiagram Raadplegen Vaccinaties'''

===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 vaccinaties 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;"| VaccinatiesRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAR-FHIR
| style="background-color: white;"| Raadplegen Vaccinaties bij (zorg)aanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| VaccinatiesBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|Vaccinatie-Immunisatie|release=V2}}-VAB-FHIR
| style="background-color: white;"| Beschikbaarstellen Vaccinaties aan de persoon
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vaccinaties.png|Componenten diagram]]

'''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 (prepublicatie 2022-1) 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 Zorgaanbieder als aparte bouwsteen opgenomen.
|-
| style="background-color: white;vertical-align:top;"| Toevoegen VaccinatieAanleiding
| 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 AnatomischeLocatie
| style="background-color: white;vertical-align:top;"| In lijn met de doorontwikkeling van de zib Vaccinatie. Zie prepublicatie 2022-1: [https://zibs.nl/wiki/Vaccinatie-v5.0(2022NL) Zib Vaccinatie v5.0(2022NL)]
|-
| style="background-color: white;vertical-align:top;"| Toevoegen StatusToediening
| 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 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:Vprepub-2_FHIR_Vaccination-Immunization#Guidance_on_resource_contents|technisch ontwerp]] wordt beschreven hoe de informatie-elementen in FHIR kunnen worden gebruikt.

====Raadplegen Vaccinaties====

Voor de transactie Raadplegen Vaccinaties 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 Vaccinaties====

De transactie Beschikbaarstellen Vaccinaties 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. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). 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"|Vaccinaties (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen Vaccinaties
|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 Vaccinaties
|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;"|Zorgaanbieder/aanbieder
|}

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

[[Bestand:Use_Case_Diagram_-_Vaccinaties_.png|Use case diagram inzien Vaccinaties]]

'''Usecase diagram inzien Vaccinaties

=Aanvullende informatie=
==Eisen en wensen==
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.
 Daarnaast is een [[Media:Richtlijn_Deduplicatie_MedMij_gegevensdienst_Vaccinaties.pdf|richtlijn Deduplicatie]] in ontwikkeling. 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.

==Verantwoordelijkheid voor informatie==
Het MedMij Afsprakenstelsel ondersteunt op het moment enkel uitwisseling tussen zorggebruikers en zorgaanbieders wanneer de zorggebruiker met de betreffende zorgaanbieder 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 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.
{{#lsth:Tabellen met release notes|Vaccinatie-Immunisatie 2}}

{{MedMij:Sjabloon_Ondersteuning}}

jgz:V0.1 Ontwerp BDSV

2025-10-24T10:59:38Z

Ahsen Yurt: /* Transactie */

{{underconstruction}}

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel ontwerp Basis Dataset Volwassenen JGZ {{VersieInfo|BDSV|release=V0.1}}|noreplace}}

=Inleiding=
==Algemeen==
Deze pagina beschrijft het functioneel ontwerp van de Basis Dataset Volwassenen JGZ (BDS V JGZ). Deze alpha-versie betreft een ontwikkelversie van de usecase BDS V JGZ - Registratie Prenataal Huisbezoek (PHB). Later zal daar ook de usecase BDS V JGZ - Registratie Maternale Vaccinatie (MV) aan worden toegevoegd, evenals de toekomstige usecases voor uitwisseling. In hoofdstuk 2 wordt verder ingegaan op wat de usecase inhoudt.

Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/standaarden/?_gl=1*1sb90or*_up*MQ..*_ga*MTE5NTg3ODUzNy4xNzM5NTUyODY5*_ga_0ZRXV90GXH*MTczOTU1Mjg2OC4xLjAuMTczOTU1Mjg2OC4wLjAuMTQ3MDY2Nzk3OA./ Nictiz webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz website].

===Aanleiding voor een Digitaal Dossier Jeugdgezondheidszorg voor Volwassenen===
Sinds 2019 is de doelgroep van de JGZ uitgebreid van jeugdigen naar zwangeren. Dit betekent dat de JGZ-professional een dossier voor volwassenen nodig heeft, omdat er een behandelrelatie wordt aangegaan met de zwangere. Dit komt voort uit de Wet op de geneeskundige behandelingsovereenkomst (WGBO), waarin staat beschreven dat een zorgprofessional een medisch dossier moet hebben om de werkzaamheden in te registreren. De Wet publieke gezondheid (Wpg) bepaalt dat dit een digitaal medisch dossier moet zijn.
De usecase BDS V JGZ - Registratie PHB bevat een registratiedataset die zorgt voor landelijk uniforme registratie, waarbij het niet uitmaakt van welke dossierapplicatie de JGZ-professional gebruik maakt. Deze uniforme registratie legt de basis voor gestructureerde gegevensuitwisseling. Bijvoorbeeld tussen JGZ-organisaties onderling bij een verhuizing van een cliënt of bij het beschikbaar stellen van Maternale Vaccinaties van de JGZ aan het RIVM. Bij de totstandkoming van de BDS V JGZ wordt gebruik gemaakt van zorginformatiebouwstenen (zibs) en HL7 FHIR om in de toekomst ook uitwisseling met andere domeinen mogelijk te maken.

===Dossierplicht en privacyregels===
Bij de registratie van individuele medische gegevens van cliënten, alsmede het communiceren daarvan, zijn onder andere de Wet op de Geneeskundige Behandelovereenkomst (WGBO) en de Wet Algemene Verordening Gegevensbescherming (AVG) van toepassing. Uit de WGBO blijkt dat de JGZ-professional een dossierplicht heeft en welke informatie hierin geregistreerd dient te worden. In de WGBO en de AVG staan de rechten en plichten van de cliënt beschreven.

===Episodegericht registreren===
Medische gegevens van cliënten worden vastgelegd binnen de context van een contact en/of een specifieke zorgvraag. Voor de herbruikbaarheid van gegevens is het van belang deze context op een later moment te kunnen herleiden. Door gegevens te koppelen aan zorgepisodes en contacten, kunnen gegevens vanuit deze context geraadpleegd worden. De [https://zibs.nl/wiki/ZIB_Publicatie_2020(NL) Zib Publicatie 2020] hanteert de volgende definitie van [https://zibs.nl/wiki/ZorgEpisode-v1.0(2020NL)#Concept zorgepisode]:

''"Een zorgepisode is een periode waarin een gezondheidsprobleem, zoals een klacht of een aandoening, de aandacht heeft van een zorgverlener. In deze periode kan de duiding van het gezondheidsprobleem veranderen door voortschrijdend inzicht en/of het beloop van de aandoening. Een zorgepisode fungeert als context voor alle gegevens die op het gezondheidsprobleem betrekking hebben."''

Binnen de JGZ wordt een ruime definitie van het begrip gezondheidsprobleem gehanteerd vanwege het preventieve karakter van de verleende zorg. Deze is meer gericht op een situatie of levensfase dan op een specifiek gezondheidsprobleem. In het geval van BDS V vallen zowel het Prenataal Huisbezoek als de Maternale Vaccinatie onder de zorgepisode ‘Aanstaand ouderschap’.

Onderstaande afbeelding toont een voorbeeld van een zorgepisode met de zorginhoudelijke gegevens die daarbij worden vastgelegd in episode-items (de gele cirkels in het figuur) en bijbehorende activiteiten (contacten en/of cliëntbesprekingen).

[[Bestand:BDS_V_episodegericht_registreren - alpha.3.png|Episodegericht registreren|900px]]

===BDS V JGZ===
Voor de beschrijving en indeling van het dossier is gebruik gemaakt van episodes, episode-items, contacten en dossierdelen, afgeleid van het [https://referentiemodel.nhg.org/frontpage HIS-Referentiemodel]. Episode-items zijn gebonden aan een episode en onderdeel van de contactregistratie. Een dossierdeel beschrijft de functionaliteit van dat onderdeel in het dossier. Daarbij worden ook de gegevens benoemd, die er worden beheerd.

Binnen de JGZ wordt gesproken over 'Cliënten' in plaats van 'Patiënten'. Een voor de JGZ herkenbaardere term voor 'Contacten' is de term 'Activiteiten'. Onder activiteiten vallen zowel cliëntcontacten als cliëntbesprekingen. In plaats van ‘Episode’ wordt de term ‘Zorgepisode’ gehanteerd, conform de zib 2020.

De volgende afbeelding is een schematische weergave van het BDS V JGZ dossier. Het administratieve gedeelte aan de linkerzijde betreffen de gegevens die niet contact gebonden zijn. Dit zijn dossierdelen zoals Cliëntgegevens, Dossierinformatie en Aanmeldgegevens. Het rechterdeel bevat de dossierdelen met episode-items, zoals Anamnese en Verloop zwangerschap, gekoppeld aan de dossierdelen Activiteiten en Zorgepisodes. Daarnaast is het verloop van de zwangerschap gekoppeld aan de Zwangerschapsgegevens en zijn de Zwangerschapsgegevens gekoppeld aan de Zorgepisode. Het dossierdeel Vaccinatie is grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_dossier_-_alpha.4_-_V1.png|BDS V Dossier|900px]]

==Doelgroep==
De doelgroepen van dit functioneel ontwerp zijn:
*Productmanagers, architecten, ontwerpers en testers van XIS-leveranciers, zorgorganisaties en [https://www.nictiz.nl/ Nictiz];
*Zorgverleners en hun vertegenwoordigers;
*RIVM

==Kaders & Uitgangspunten==
===Richtlijn en proces===
De [https://open.overheid.nl/documenten/ronl-480b98f5-0e57-49f8-a15a-af39fc2988a1/pdf handreiking PHB JGZ] beschrijft de (samenwerkings)kaders voor de uitvoering van het PHB door de JGZ en betrokken partners. In het eerste kwartaal van 2023 is op basis van [https://www.ncj.nl/agenda/informatiestandaard-volwassenen-jgz Pressure Cooker Sessies] met experts uit het veld de registratieset vastgesteld die nodig is voor JGZ professionals om dit proces te kunnen registreren.

===Reikwijdte Functioneel Ontwerp===
De reikwijdte van dit functioneel ontwerp beslaat de functionele beschrijvingen en de dataset voor registratie van het prenataal huisbezoek. In de toekomst zal ook de registratie van de Maternale Vaccinatie en gegevensuitwisselingen binnen één of meerdere zorgprocessen beschreven worden.

===Databeschikbaarheid===
De [https://www.rijksoverheid.nl/documenten/publicaties/2023/03/31/nationale-visie-en-strategie-gezondheidsinformatiestelsel nationale visie op het gezondheidsinformatiestelsel] beschrijft hoe de transitie van gegevensuitwisseling naar databeschikbaarheid bijdraagt aan passende zorg en gezondheid. Databeschikbaarheid verwijst naar de mogelijkheid om gegevens te benaderen en te gebruiken wanneer dat nodig is, onafhankelijk van de context waarbinnen deze is geregistreerd. Randvoorwaarden voor databeschikbaarheid zijn eenheid van taal en eenheid van techniek. Het [https://nictiz.nl/publicaties/implementatiestrategie-snomed/ SNOMED advies] en het [https://www.rijksoverheid.nl/documenten/publicaties/2022/10/21/implementatie-fhir FHIR besluit] vormen hiervoor een belangrijke basis en daarmee ook voor het functioneel ontwerp BDS V JGZ.

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie de registratie en/of uitwisseling 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 de registratie usecase geanalyseerd en uitgewerkt.
==Algemeen==
De Basis Dataset Volwassenen JGZ is ingedeeld in verschillende usecases.
*BDS V JGZ - Registratie Prenataal Huisbezoek (PHB)

En in een later stadium:
*BDS V JGZ - Registratie Maternale Vaccinatie (MV)
*Usecases voor uitwisseling

==Usecase: BDS V JGZ - Registratie PHB==
===Doel en Relevantie===

Met de aanpassing van de Wet Publieke Gezondheid (Wpg) met het ‘Prenataal huisbezoek door de JGZ’ (vanaf nu PHB JGZ) krijgen alle gemeenten de taak om een prenataal huisbezoek door de JGZ aan te bieden aan zwangeren en/of hun gezinnen in een kwetsbare situatie. De huidige scope van de BDS V JGZ betreft nu alleen de zwangere die in aanmerking komt voor een PHB.

Geboortezorg professionals en andere betrokkenen in de zwangerschap hebben een signalerende en toeleidende rol; de JGZ heeft de uitvoerende rol. Samenwerking is dus essentieel. Concreet betekent de wetswijziging dat de jeugdverpleegkundige al vroeg in de zwangerschap, na signalering van een kwetsbare situatie door de geboortezorg (of een andere betrokken professional), hulp en ondersteuning kan bieden aan de zwangere en/of hun gezin in een kwetsbare situatie. Hieronder vallen directe ondersteuning door de JGZ, waaronder advies en voorlichting, maar ook advies voor een passende aanpak buiten de JGZ. De zwangere besluit uiteraard zelf of ze van het prenatale huisbezoek gebruik wil maken. Alleen de JGZ-professional die een behandelrelatie heeft met de cliënt, heeft toegang tot het digitale dossier van deze cliënt. Om dit te waarborgen bevat elk dossier een logboek waarin te zien is wie wanneer toegang heeft gehad tot een dossier en wat die professional heeft gedaan.

(Kwetsbare) ouders kunnen al tijdens de zwangerschap (intensieve) begeleiding vanuit de JGZ krijgen. Dit kan starten met een prenataal huisbezoek. In de usecase BDS V JGZ - Registratie PHB wordt vastgesteld welke informatie er vastgelegd wordt over het prenatale huisbezoek JGZ met als doel een eenduidig dossier te hebben, waarin de gegevens van de zwangere en afspraken worden genoteerd.

Dit heeft meerdere doelen:
*Bevorderen en borgen van de kwaliteit van de zorg (ouder en professional).
*Bevorderen en borgen van de continuïteit van de zorg (ouder en professional).
*Verantwoording van handelen (professional).
*Monitoren van de voortgang zowel individueel als collectief (ouder, professional, organisatie, statistiek).
*Genereren van beleids-, stuur- en spiegelinformatie (organisatie, statistiek).

====Patient Journey====
De volgende patient journey beschrijft een algemene prenatale begeleiding door de JGZ:

Kyana is 15 weken zwanger. Haar verloskundige heeft haar geadviseerd zich aan te melden bij de JGZ voor een prenataal huisbezoek. Kyana is een meisje van 18 jaar dat ongepland zwanger is. Ze zit nog op school en woont sinds kort bij haar vriend en zijn ouders, omdat haar eigen ouders geen contact meer met haar willen. Kyana heeft geen inkomsten en haar vriend werkt vijf dagen per week in de bouw. Samen zijn ze hard op zoek naar een woning. Kyana kijkt uit naar de komst van haar baby, maar heeft nog nauwelijks een idee van wat haar straks te wachten staat. De jeugdverpleegkundige neemt, naar aanleiding van de aanmelding, contact op met Kyana en ze maken een afspraak voor een huisbezoek. Tijdens dit bezoek brengt de jeugdverpleegkundige de situatie van Kyana in kaart en bespreekt haar hulpvraag, wensen en behoeften. Aan de hand van de inventarisatie stelt de jeugdverpleegkundige samen met Kyana een plan van aanpak op. Er wordt besloten dat de jeugdverpleegkundige kortdurende ondersteuning biedt aan Kyana en haar vriend. Er wordt een vervolgafspraak gemaakt. Aan het eind van de kortdurende ondersteuning vindt er een evaluatie plaats over o.a. het plan van aanpak, de uitvoering hiervan en de ervaringen van Kyana en haar vriend over het traject. Zo nodig wordt het plan van aanpak bijgesteld.

===Proces en Context (pre- en postproces)===
Voor het scheppen van context is in de usecase BDS V JGZ - Registratie PHB naast het proces van registratie, ook beschreven wat het pre- en postproces omvatten. De usecase BDS V JGZ - Registratie PHB beperkt zich slechts tot de registratie van gegevens vanaf het moment waarop er een dossier wordt aangelegd.

====Preproces====
*Een professional signaleert een kwetsbare situatie bij een zwangere en bespreekt dit met de zwangere en/of het gezin. Indien de signalerende professional in samenspraak met de cliënt van mening is dat de mogelijkheden van de signalerende professional niet toereikend zijn (tijd, aard van het probleem, kennis) adviseert die een Prenataal Huisbezoek door de Jeugdgezondheidszorg (PHB JGZ) om de situatie nader in kaart te brengen.
*Er wordt een verzoek gedaan tot het uitvoeren van een PHB JGZ. De zwangere meldt zichzelf aan, al dan niet met ondersteuning van de professional.
*De ontvangst van de aanmelding vormt de start van het hulpverleningsproces bij de JGZ.

====Proces====
Het proces van deze usecase is:
*Er wordt een dossier aangelegd waarin de gegevens uit de aanmelding worden overgenomen en er wordt een zorgepisode gestart.
*Eerste contact (telefonisch): Op basis van deze gegevens heeft de jeugdverpleegkundige telefonisch contact met de zwangere.
*Als de zwangere in het gesprek aangeeft toch geen gebruik te willen maken van de begeleiding door de JGZ, wordt het dossier gesloten.
*Als de zwangere gebruik wenst te maken van het PHB, wordt de datum waarop het huisbezoek plaatsvindt vastgelegd.
*Registratie van de activiteiten gebeurt zoveel mogelijk gestructureerd, met -uitsluitend waar nodig- een toelichting.
*Tijdens het eerste huisbezoek vindt de WID-controle van de cliënt plaats.
*Bij het PHB JGZ worden alle gegevens door de JGZ geregistreerd volgens de BDS V JGZ, zowel om de voortgang te kunnen volgen als om de uitvoering te monitoren.

====Postproces====
De gegevens zijn gestructureerd opgeslagen (en beschikbaar in het systeem).

===Bedrijfsrollen en UML activity diagram===
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| Bronsysteem
| style="background-color: white;"| Registreert PHB gegevens.
|-
|}

===Informatieregistratie===
Dit hoofdstuk beschrijft welke informatie omtrent het BDS V JGZ - Registratie PHB in een bronsysteem dient te worden vastgelegd.

====Opbouw transactie====
De transactie is opgebouwd uit een laag met bouwstenen en een presentatielaag om usecase specifieke wensen ten aanzien van de presentatielaag te scheiden van de generieke technische onderlaag. Door deze generieke onderlaag kan de interoperabiliteit tussen domeinen worden gewaarborgd en kunnen in de toekomst vanuit dezelfde dataset meerdere domeinen en usecases worden ondersteund. Hieronder volgt een toelichting per laag van de transactie.

====Bouwstenen====
De bouwstenen laag bestaat uit een set herbruikbare bouwstenen die binnen 1 of meerdere domeinen of usecases hergebruikt kunnen worden in de domein of usecase specifieke presentatielaag. Een bouwsteen kan: 1. een exacte kopie zijn van een bestaande zib, 2. afgeleid zijn van een bestaande zib en verrijkt met domein en usecase specifieke eisen of 3. geen enkele relatie hebben met een bestaande zib. In de meeste gevallen zal gebruik gemaakt worden van bouwstenen die zijn afgeleid van de zib, tenzij de bestaande zib al voor 100% volstaat of er geen bestaande zib beschikbaar is. De transactie geeft aan welke onderdelen van een bouwsteen in de betreffende usecase relevant zijn.

Onderstaande afbeelding geeft een voorbeeld van de bouwsteen Contact. Deze bouwsteen is afgeleid van de zib Contact, waarbij een aantal extra elementen zijn toegevoegd, zoals ContactSoort en ContactVorm.

[[Bestand:JGZ BDSV bouwsteen contact.png|300px]]

====Presentatieset====
De presentatielaag beschrijft de set van gegevens, zoals deze aan de voorkant gepresenteerd zal worden, in dit geval BDS V JGZ.

Onderstaande afbeelding geeft een voorbeeld van een verwijzing naar de bouwsteen Contact vanuit de presentatielaag. Binnen de JGZ worden Contacten en Cliëntbesprekingen gepresenteerd in het dossierdeel Activiteiten. Merk op dat in dit voorbeeld wordt verwezen naar de bouwsteen Patiëntbespreking. Ondanks deze benaming in de transactie, afkomstig uit de zib, zal deze aan de voorkant als cliëntbespreking gepresenteerd worden.

[[Bestand:Dossierdeel_Activiteiten.PNG|Dossierdeel_Activiteiten|300px]]

=====Administratieve deel=====
Onderstaande figuur toont de dossierdelen in het administratieve deel van het dossier inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Dossierinformatie en Aanmeldgegevens.

[[Bestand:BDS-V_Administratief.png|BDS V Administratief|900px]]

=====Episode-items=====
Onderstaande figuur is een weergave van de episode-items inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Anamnese en VerloopZwangerschap. In het figuur zijn de relaties zichtbaar tussen de episode-items en de zorgepisodes, activiteiten, zwangerschapsgegevens en overige bouwstenen. Het dossierdeel Vaccinatie is in het grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_episode-items-alpha.4.jpg|BDS V Episode-Items|900px]]

=====Relaties=====
In de dataset kan vanuit een bouwsteen of dossierdeel een relatie worden gelegd naar een andere bouwsteen. Dit gebeurt door middel van een relatie, zoals bijvoorbeeld ‘RelatieZorgEpisode’. Daarin wordt door middel van een identificatienummer gerefereerd naar een specifieke instantiatie van de bouwsteen ZorgEpisode. Op deze manier kunnen episode-items bijvoorbeeld gerelateerd worden aan zorgepisodes. Dit biedt ook de mogelijkheid om specifieke queries te doen, bijvoorbeeld alle episode-items die aan een specifieke zorgepisode gerelateerd zijn.

BDS V JGZ kent onderstaande relaties:

* RelatieZorgEpisode: gebruikt in alle episode-items, Zwangerschap, Aanmelding
* RelatieContact: gebruikt in alle episode-items
* RelatiePatiëntbespreking (RelatieCliëntbespreking): gebruikt in alle episode-items
* RelatieZwangerschap: gebruikt in VerloopZwangerschap

====Transactie====
Hieronder is de inhoud van de transactie weergegeven. Deze informatie is ook in een [https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20251023T092603/scenarios.html nieuw tabblad] te openen.

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20251023T092603/tr-2.16.840.1.113883.2.4.3.11.60.100.4.60-2024-07-23T000000.html frameborder="0" align="middle"></iframe>
</html>

= Aanvullende informatie =

Voor de eenheid van taal wordt zo veel mogelijk [https://www.nictiz.nl/standaardisatie/terminologiecentrum/snomed-ct/ SNOMED] gebruikt. Aanvullende uitleg over de gebruite codes en waardelijsten is te lezen op het [https://informatiestandaarden.nictiz.nl/wiki/jgz:V0.1_Ontwerp_BDSV/UitlegWaardelijsten overzicht waardelijsten met bijzonderheden].

=Release notes=
In onderstaande tabel staan de wijzigingen voor dit ontwerp:
{{#lsth:Tabellen met release notes|BDS V 0.1}}

jgz:V0.1 Ontwerp BDSV

2025-10-24T10:57:13Z

Ahsen Yurt: /* Transactie */

{{underconstruction}}

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel ontwerp Basis Dataset Volwassenen JGZ {{VersieInfo|BDSV|release=V0.1}}|noreplace}}

=Inleiding=
==Algemeen==
Deze pagina beschrijft het functioneel ontwerp van de Basis Dataset Volwassenen JGZ (BDS V JGZ). Deze alpha-versie betreft een ontwikkelversie van de usecase BDS V JGZ - Registratie Prenataal Huisbezoek (PHB). Later zal daar ook de usecase BDS V JGZ - Registratie Maternale Vaccinatie (MV) aan worden toegevoegd, evenals de toekomstige usecases voor uitwisseling. In hoofdstuk 2 wordt verder ingegaan op wat de usecase inhoudt.

Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/standaarden/?_gl=1*1sb90or*_up*MQ..*_ga*MTE5NTg3ODUzNy4xNzM5NTUyODY5*_ga_0ZRXV90GXH*MTczOTU1Mjg2OC4xLjAuMTczOTU1Mjg2OC4wLjAuMTQ3MDY2Nzk3OA./ Nictiz webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz website].

===Aanleiding voor een Digitaal Dossier Jeugdgezondheidszorg voor Volwassenen===
Sinds 2019 is de doelgroep van de JGZ uitgebreid van jeugdigen naar zwangeren. Dit betekent dat de JGZ-professional een dossier voor volwassenen nodig heeft, omdat er een behandelrelatie wordt aangegaan met de zwangere. Dit komt voort uit de Wet op de geneeskundige behandelingsovereenkomst (WGBO), waarin staat beschreven dat een zorgprofessional een medisch dossier moet hebben om de werkzaamheden in te registreren. De Wet publieke gezondheid (Wpg) bepaalt dat dit een digitaal medisch dossier moet zijn.
De usecase BDS V JGZ - Registratie PHB bevat een registratiedataset die zorgt voor landelijk uniforme registratie, waarbij het niet uitmaakt van welke dossierapplicatie de JGZ-professional gebruik maakt. Deze uniforme registratie legt de basis voor gestructureerde gegevensuitwisseling. Bijvoorbeeld tussen JGZ-organisaties onderling bij een verhuizing van een cliënt of bij het beschikbaar stellen van Maternale Vaccinaties van de JGZ aan het RIVM. Bij de totstandkoming van de BDS V JGZ wordt gebruik gemaakt van zorginformatiebouwstenen (zibs) en HL7 FHIR om in de toekomst ook uitwisseling met andere domeinen mogelijk te maken.

===Dossierplicht en privacyregels===
Bij de registratie van individuele medische gegevens van cliënten, alsmede het communiceren daarvan, zijn onder andere de Wet op de Geneeskundige Behandelovereenkomst (WGBO) en de Wet Algemene Verordening Gegevensbescherming (AVG) van toepassing. Uit de WGBO blijkt dat de JGZ-professional een dossierplicht heeft en welke informatie hierin geregistreerd dient te worden. In de WGBO en de AVG staan de rechten en plichten van de cliënt beschreven.

===Episodegericht registreren===
Medische gegevens van cliënten worden vastgelegd binnen de context van een contact en/of een specifieke zorgvraag. Voor de herbruikbaarheid van gegevens is het van belang deze context op een later moment te kunnen herleiden. Door gegevens te koppelen aan zorgepisodes en contacten, kunnen gegevens vanuit deze context geraadpleegd worden. De [https://zibs.nl/wiki/ZIB_Publicatie_2020(NL) Zib Publicatie 2020] hanteert de volgende definitie van [https://zibs.nl/wiki/ZorgEpisode-v1.0(2020NL)#Concept zorgepisode]:

''"Een zorgepisode is een periode waarin een gezondheidsprobleem, zoals een klacht of een aandoening, de aandacht heeft van een zorgverlener. In deze periode kan de duiding van het gezondheidsprobleem veranderen door voortschrijdend inzicht en/of het beloop van de aandoening. Een zorgepisode fungeert als context voor alle gegevens die op het gezondheidsprobleem betrekking hebben."''

Binnen de JGZ wordt een ruime definitie van het begrip gezondheidsprobleem gehanteerd vanwege het preventieve karakter van de verleende zorg. Deze is meer gericht op een situatie of levensfase dan op een specifiek gezondheidsprobleem. In het geval van BDS V vallen zowel het Prenataal Huisbezoek als de Maternale Vaccinatie onder de zorgepisode ‘Aanstaand ouderschap’.

Onderstaande afbeelding toont een voorbeeld van een zorgepisode met de zorginhoudelijke gegevens die daarbij worden vastgelegd in episode-items (de gele cirkels in het figuur) en bijbehorende activiteiten (contacten en/of cliëntbesprekingen).

[[Bestand:BDS_V_episodegericht_registreren - alpha.3.png|Episodegericht registreren|900px]]

===BDS V JGZ===
Voor de beschrijving en indeling van het dossier is gebruik gemaakt van episodes, episode-items, contacten en dossierdelen, afgeleid van het [https://referentiemodel.nhg.org/frontpage HIS-Referentiemodel]. Episode-items zijn gebonden aan een episode en onderdeel van de contactregistratie. Een dossierdeel beschrijft de functionaliteit van dat onderdeel in het dossier. Daarbij worden ook de gegevens benoemd, die er worden beheerd.

Binnen de JGZ wordt gesproken over 'Cliënten' in plaats van 'Patiënten'. Een voor de JGZ herkenbaardere term voor 'Contacten' is de term 'Activiteiten'. Onder activiteiten vallen zowel cliëntcontacten als cliëntbesprekingen. In plaats van ‘Episode’ wordt de term ‘Zorgepisode’ gehanteerd, conform de zib 2020.

De volgende afbeelding is een schematische weergave van het BDS V JGZ dossier. Het administratieve gedeelte aan de linkerzijde betreffen de gegevens die niet contact gebonden zijn. Dit zijn dossierdelen zoals Cliëntgegevens, Dossierinformatie en Aanmeldgegevens. Het rechterdeel bevat de dossierdelen met episode-items, zoals Anamnese en Verloop zwangerschap, gekoppeld aan de dossierdelen Activiteiten en Zorgepisodes. Daarnaast is het verloop van de zwangerschap gekoppeld aan de Zwangerschapsgegevens en zijn de Zwangerschapsgegevens gekoppeld aan de Zorgepisode. Het dossierdeel Vaccinatie is grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_dossier_-_alpha.4_-_V1.png|BDS V Dossier|900px]]

==Doelgroep==
De doelgroepen van dit functioneel ontwerp zijn:
*Productmanagers, architecten, ontwerpers en testers van XIS-leveranciers, zorgorganisaties en [https://www.nictiz.nl/ Nictiz];
*Zorgverleners en hun vertegenwoordigers;
*RIVM

==Kaders & Uitgangspunten==
===Richtlijn en proces===
De [https://open.overheid.nl/documenten/ronl-480b98f5-0e57-49f8-a15a-af39fc2988a1/pdf handreiking PHB JGZ] beschrijft de (samenwerkings)kaders voor de uitvoering van het PHB door de JGZ en betrokken partners. In het eerste kwartaal van 2023 is op basis van [https://www.ncj.nl/agenda/informatiestandaard-volwassenen-jgz Pressure Cooker Sessies] met experts uit het veld de registratieset vastgesteld die nodig is voor JGZ professionals om dit proces te kunnen registreren.

===Reikwijdte Functioneel Ontwerp===
De reikwijdte van dit functioneel ontwerp beslaat de functionele beschrijvingen en de dataset voor registratie van het prenataal huisbezoek. In de toekomst zal ook de registratie van de Maternale Vaccinatie en gegevensuitwisselingen binnen één of meerdere zorgprocessen beschreven worden.

===Databeschikbaarheid===
De [https://www.rijksoverheid.nl/documenten/publicaties/2023/03/31/nationale-visie-en-strategie-gezondheidsinformatiestelsel nationale visie op het gezondheidsinformatiestelsel] beschrijft hoe de transitie van gegevensuitwisseling naar databeschikbaarheid bijdraagt aan passende zorg en gezondheid. Databeschikbaarheid verwijst naar de mogelijkheid om gegevens te benaderen en te gebruiken wanneer dat nodig is, onafhankelijk van de context waarbinnen deze is geregistreerd. Randvoorwaarden voor databeschikbaarheid zijn eenheid van taal en eenheid van techniek. Het [https://nictiz.nl/publicaties/implementatiestrategie-snomed/ SNOMED advies] en het [https://www.rijksoverheid.nl/documenten/publicaties/2022/10/21/implementatie-fhir FHIR besluit] vormen hiervoor een belangrijke basis en daarmee ook voor het functioneel ontwerp BDS V JGZ.

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie de registratie en/of uitwisseling 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 de registratie usecase geanalyseerd en uitgewerkt.
==Algemeen==
De Basis Dataset Volwassenen JGZ is ingedeeld in verschillende usecases.
*BDS V JGZ - Registratie Prenataal Huisbezoek (PHB)

En in een later stadium:
*BDS V JGZ - Registratie Maternale Vaccinatie (MV)
*Usecases voor uitwisseling

==Usecase: BDS V JGZ - Registratie PHB==
===Doel en Relevantie===

Met de aanpassing van de Wet Publieke Gezondheid (Wpg) met het ‘Prenataal huisbezoek door de JGZ’ (vanaf nu PHB JGZ) krijgen alle gemeenten de taak om een prenataal huisbezoek door de JGZ aan te bieden aan zwangeren en/of hun gezinnen in een kwetsbare situatie. De huidige scope van de BDS V JGZ betreft nu alleen de zwangere die in aanmerking komt voor een PHB.

Geboortezorg professionals en andere betrokkenen in de zwangerschap hebben een signalerende en toeleidende rol; de JGZ heeft de uitvoerende rol. Samenwerking is dus essentieel. Concreet betekent de wetswijziging dat de jeugdverpleegkundige al vroeg in de zwangerschap, na signalering van een kwetsbare situatie door de geboortezorg (of een andere betrokken professional), hulp en ondersteuning kan bieden aan de zwangere en/of hun gezin in een kwetsbare situatie. Hieronder vallen directe ondersteuning door de JGZ, waaronder advies en voorlichting, maar ook advies voor een passende aanpak buiten de JGZ. De zwangere besluit uiteraard zelf of ze van het prenatale huisbezoek gebruik wil maken. Alleen de JGZ-professional die een behandelrelatie heeft met de cliënt, heeft toegang tot het digitale dossier van deze cliënt. Om dit te waarborgen bevat elk dossier een logboek waarin te zien is wie wanneer toegang heeft gehad tot een dossier en wat die professional heeft gedaan.

(Kwetsbare) ouders kunnen al tijdens de zwangerschap (intensieve) begeleiding vanuit de JGZ krijgen. Dit kan starten met een prenataal huisbezoek. In de usecase BDS V JGZ - Registratie PHB wordt vastgesteld welke informatie er vastgelegd wordt over het prenatale huisbezoek JGZ met als doel een eenduidig dossier te hebben, waarin de gegevens van de zwangere en afspraken worden genoteerd.

Dit heeft meerdere doelen:
*Bevorderen en borgen van de kwaliteit van de zorg (ouder en professional).
*Bevorderen en borgen van de continuïteit van de zorg (ouder en professional).
*Verantwoording van handelen (professional).
*Monitoren van de voortgang zowel individueel als collectief (ouder, professional, organisatie, statistiek).
*Genereren van beleids-, stuur- en spiegelinformatie (organisatie, statistiek).

====Patient Journey====
De volgende patient journey beschrijft een algemene prenatale begeleiding door de JGZ:

Kyana is 15 weken zwanger. Haar verloskundige heeft haar geadviseerd zich aan te melden bij de JGZ voor een prenataal huisbezoek. Kyana is een meisje van 18 jaar dat ongepland zwanger is. Ze zit nog op school en woont sinds kort bij haar vriend en zijn ouders, omdat haar eigen ouders geen contact meer met haar willen. Kyana heeft geen inkomsten en haar vriend werkt vijf dagen per week in de bouw. Samen zijn ze hard op zoek naar een woning. Kyana kijkt uit naar de komst van haar baby, maar heeft nog nauwelijks een idee van wat haar straks te wachten staat. De jeugdverpleegkundige neemt, naar aanleiding van de aanmelding, contact op met Kyana en ze maken een afspraak voor een huisbezoek. Tijdens dit bezoek brengt de jeugdverpleegkundige de situatie van Kyana in kaart en bespreekt haar hulpvraag, wensen en behoeften. Aan de hand van de inventarisatie stelt de jeugdverpleegkundige samen met Kyana een plan van aanpak op. Er wordt besloten dat de jeugdverpleegkundige kortdurende ondersteuning biedt aan Kyana en haar vriend. Er wordt een vervolgafspraak gemaakt. Aan het eind van de kortdurende ondersteuning vindt er een evaluatie plaats over o.a. het plan van aanpak, de uitvoering hiervan en de ervaringen van Kyana en haar vriend over het traject. Zo nodig wordt het plan van aanpak bijgesteld.

===Proces en Context (pre- en postproces)===
Voor het scheppen van context is in de usecase BDS V JGZ - Registratie PHB naast het proces van registratie, ook beschreven wat het pre- en postproces omvatten. De usecase BDS V JGZ - Registratie PHB beperkt zich slechts tot de registratie van gegevens vanaf het moment waarop er een dossier wordt aangelegd.

====Preproces====
*Een professional signaleert een kwetsbare situatie bij een zwangere en bespreekt dit met de zwangere en/of het gezin. Indien de signalerende professional in samenspraak met de cliënt van mening is dat de mogelijkheden van de signalerende professional niet toereikend zijn (tijd, aard van het probleem, kennis) adviseert die een Prenataal Huisbezoek door de Jeugdgezondheidszorg (PHB JGZ) om de situatie nader in kaart te brengen.
*Er wordt een verzoek gedaan tot het uitvoeren van een PHB JGZ. De zwangere meldt zichzelf aan, al dan niet met ondersteuning van de professional.
*De ontvangst van de aanmelding vormt de start van het hulpverleningsproces bij de JGZ.

====Proces====
Het proces van deze usecase is:
*Er wordt een dossier aangelegd waarin de gegevens uit de aanmelding worden overgenomen en er wordt een zorgepisode gestart.
*Eerste contact (telefonisch): Op basis van deze gegevens heeft de jeugdverpleegkundige telefonisch contact met de zwangere.
*Als de zwangere in het gesprek aangeeft toch geen gebruik te willen maken van de begeleiding door de JGZ, wordt het dossier gesloten.
*Als de zwangere gebruik wenst te maken van het PHB, wordt de datum waarop het huisbezoek plaatsvindt vastgelegd.
*Registratie van de activiteiten gebeurt zoveel mogelijk gestructureerd, met -uitsluitend waar nodig- een toelichting.
*Tijdens het eerste huisbezoek vindt de WID-controle van de cliënt plaats.
*Bij het PHB JGZ worden alle gegevens door de JGZ geregistreerd volgens de BDS V JGZ, zowel om de voortgang te kunnen volgen als om de uitvoering te monitoren.

====Postproces====
De gegevens zijn gestructureerd opgeslagen (en beschikbaar in het systeem).

===Bedrijfsrollen en UML activity diagram===
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| Bronsysteem
| style="background-color: white;"| Registreert PHB gegevens.
|-
|}

===Informatieregistratie===
Dit hoofdstuk beschrijft welke informatie omtrent het BDS V JGZ - Registratie PHB in een bronsysteem dient te worden vastgelegd.

====Opbouw transactie====
De transactie is opgebouwd uit een laag met bouwstenen en een presentatielaag om usecase specifieke wensen ten aanzien van de presentatielaag te scheiden van de generieke technische onderlaag. Door deze generieke onderlaag kan de interoperabiliteit tussen domeinen worden gewaarborgd en kunnen in de toekomst vanuit dezelfde dataset meerdere domeinen en usecases worden ondersteund. Hieronder volgt een toelichting per laag van de transactie.

====Bouwstenen====
De bouwstenen laag bestaat uit een set herbruikbare bouwstenen die binnen 1 of meerdere domeinen of usecases hergebruikt kunnen worden in de domein of usecase specifieke presentatielaag. Een bouwsteen kan: 1. een exacte kopie zijn van een bestaande zib, 2. afgeleid zijn van een bestaande zib en verrijkt met domein en usecase specifieke eisen of 3. geen enkele relatie hebben met een bestaande zib. In de meeste gevallen zal gebruik gemaakt worden van bouwstenen die zijn afgeleid van de zib, tenzij de bestaande zib al voor 100% volstaat of er geen bestaande zib beschikbaar is. De transactie geeft aan welke onderdelen van een bouwsteen in de betreffende usecase relevant zijn.

Onderstaande afbeelding geeft een voorbeeld van de bouwsteen Contact. Deze bouwsteen is afgeleid van de zib Contact, waarbij een aantal extra elementen zijn toegevoegd, zoals ContactSoort en ContactVorm.

[[Bestand:JGZ BDSV bouwsteen contact.png|300px]]

====Presentatieset====
De presentatielaag beschrijft de set van gegevens, zoals deze aan de voorkant gepresenteerd zal worden, in dit geval BDS V JGZ.

Onderstaande afbeelding geeft een voorbeeld van een verwijzing naar de bouwsteen Contact vanuit de presentatielaag. Binnen de JGZ worden Contacten en Cliëntbesprekingen gepresenteerd in het dossierdeel Activiteiten. Merk op dat in dit voorbeeld wordt verwezen naar de bouwsteen Patiëntbespreking. Ondanks deze benaming in de transactie, afkomstig uit de zib, zal deze aan de voorkant als cliëntbespreking gepresenteerd worden.

[[Bestand:Dossierdeel_Activiteiten.PNG|Dossierdeel_Activiteiten|300px]]

=====Administratieve deel=====
Onderstaande figuur toont de dossierdelen in het administratieve deel van het dossier inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Dossierinformatie en Aanmeldgegevens.

[[Bestand:BDS-V_Administratief.png|BDS V Administratief|900px]]

=====Episode-items=====
Onderstaande figuur is een weergave van de episode-items inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Anamnese en VerloopZwangerschap. In het figuur zijn de relaties zichtbaar tussen de episode-items en de zorgepisodes, activiteiten, zwangerschapsgegevens en overige bouwstenen. Het dossierdeel Vaccinatie is in het grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_episode-items-alpha.4.jpg|BDS V Episode-Items|900px]]

=====Relaties=====
In de dataset kan vanuit een bouwsteen of dossierdeel een relatie worden gelegd naar een andere bouwsteen. Dit gebeurt door middel van een relatie, zoals bijvoorbeeld ‘RelatieZorgEpisode’. Daarin wordt door middel van een identificatienummer gerefereerd naar een specifieke instantiatie van de bouwsteen ZorgEpisode. Op deze manier kunnen episode-items bijvoorbeeld gerelateerd worden aan zorgepisodes. Dit biedt ook de mogelijkheid om specifieke queries te doen, bijvoorbeeld alle episode-items die aan een specifieke zorgepisode gerelateerd zijn.

BDS V JGZ kent onderstaande relaties:

* RelatieZorgEpisode: gebruikt in alle episode-items, Zwangerschap, Aanmelding
* RelatieContact: gebruikt in alle episode-items
* RelatiePatiëntbespreking (RelatieCliëntbespreking): gebruikt in alle episode-items
* RelatieZwangerschap: gebruikt in VerloopZwangerschap

====Transactie====
Hieronder is de inhoud van de transactie weergegeven. Deze informatie is ook in een [https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20251023T092603/scenarios.html nieuw tabblad] te openen.

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20251023T092603/sc-2.16.840.1.113883.2.4.3.11.60.100.3.9-2024-07-23T000000.html frameborder="0" align="middle"></iframe>
</html>

= Aanvullende informatie =

Voor de eenheid van taal wordt zo veel mogelijk [https://www.nictiz.nl/standaardisatie/terminologiecentrum/snomed-ct/ SNOMED] gebruikt. Aanvullende uitleg over de gebruite codes en waardelijsten is te lezen op het [https://informatiestandaarden.nictiz.nl/wiki/jgz:V0.1_Ontwerp_BDSV/UitlegWaardelijsten overzicht waardelijsten met bijzonderheden].

=Release notes=
In onderstaande tabel staan de wijzigingen voor dit ontwerp:
{{#lsth:Tabellen met release notes|BDS V 0.1}}

jgz:V0.1 Ontwerp BDSV

2025-10-24T10:53:38Z

Ahsen Yurt: /* Transactie */

{{underconstruction}}

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel ontwerp Basis Dataset Volwassenen JGZ {{VersieInfo|BDSV|release=V0.1}}|noreplace}}

=Inleiding=
==Algemeen==
Deze pagina beschrijft het functioneel ontwerp van de Basis Dataset Volwassenen JGZ (BDS V JGZ). Deze alpha-versie betreft een ontwikkelversie van de usecase BDS V JGZ - Registratie Prenataal Huisbezoek (PHB). Later zal daar ook de usecase BDS V JGZ - Registratie Maternale Vaccinatie (MV) aan worden toegevoegd, evenals de toekomstige usecases voor uitwisseling. In hoofdstuk 2 wordt verder ingegaan op wat de usecase inhoudt.

Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/standaarden/?_gl=1*1sb90or*_up*MQ..*_ga*MTE5NTg3ODUzNy4xNzM5NTUyODY5*_ga_0ZRXV90GXH*MTczOTU1Mjg2OC4xLjAuMTczOTU1Mjg2OC4wLjAuMTQ3MDY2Nzk3OA./ Nictiz webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz website].

===Aanleiding voor een Digitaal Dossier Jeugdgezondheidszorg voor Volwassenen===
Sinds 2019 is de doelgroep van de JGZ uitgebreid van jeugdigen naar zwangeren. Dit betekent dat de JGZ-professional een dossier voor volwassenen nodig heeft, omdat er een behandelrelatie wordt aangegaan met de zwangere. Dit komt voort uit de Wet op de geneeskundige behandelingsovereenkomst (WGBO), waarin staat beschreven dat een zorgprofessional een medisch dossier moet hebben om de werkzaamheden in te registreren. De Wet publieke gezondheid (Wpg) bepaalt dat dit een digitaal medisch dossier moet zijn.
De usecase BDS V JGZ - Registratie PHB bevat een registratiedataset die zorgt voor landelijk uniforme registratie, waarbij het niet uitmaakt van welke dossierapplicatie de JGZ-professional gebruik maakt. Deze uniforme registratie legt de basis voor gestructureerde gegevensuitwisseling. Bijvoorbeeld tussen JGZ-organisaties onderling bij een verhuizing van een cliënt of bij het beschikbaar stellen van Maternale Vaccinaties van de JGZ aan het RIVM. Bij de totstandkoming van de BDS V JGZ wordt gebruik gemaakt van zorginformatiebouwstenen (zibs) en HL7 FHIR om in de toekomst ook uitwisseling met andere domeinen mogelijk te maken.

===Dossierplicht en privacyregels===
Bij de registratie van individuele medische gegevens van cliënten, alsmede het communiceren daarvan, zijn onder andere de Wet op de Geneeskundige Behandelovereenkomst (WGBO) en de Wet Algemene Verordening Gegevensbescherming (AVG) van toepassing. Uit de WGBO blijkt dat de JGZ-professional een dossierplicht heeft en welke informatie hierin geregistreerd dient te worden. In de WGBO en de AVG staan de rechten en plichten van de cliënt beschreven.

===Episodegericht registreren===
Medische gegevens van cliënten worden vastgelegd binnen de context van een contact en/of een specifieke zorgvraag. Voor de herbruikbaarheid van gegevens is het van belang deze context op een later moment te kunnen herleiden. Door gegevens te koppelen aan zorgepisodes en contacten, kunnen gegevens vanuit deze context geraadpleegd worden. De [https://zibs.nl/wiki/ZIB_Publicatie_2020(NL) Zib Publicatie 2020] hanteert de volgende definitie van [https://zibs.nl/wiki/ZorgEpisode-v1.0(2020NL)#Concept zorgepisode]:

''"Een zorgepisode is een periode waarin een gezondheidsprobleem, zoals een klacht of een aandoening, de aandacht heeft van een zorgverlener. In deze periode kan de duiding van het gezondheidsprobleem veranderen door voortschrijdend inzicht en/of het beloop van de aandoening. Een zorgepisode fungeert als context voor alle gegevens die op het gezondheidsprobleem betrekking hebben."''

Binnen de JGZ wordt een ruime definitie van het begrip gezondheidsprobleem gehanteerd vanwege het preventieve karakter van de verleende zorg. Deze is meer gericht op een situatie of levensfase dan op een specifiek gezondheidsprobleem. In het geval van BDS V vallen zowel het Prenataal Huisbezoek als de Maternale Vaccinatie onder de zorgepisode ‘Aanstaand ouderschap’.

Onderstaande afbeelding toont een voorbeeld van een zorgepisode met de zorginhoudelijke gegevens die daarbij worden vastgelegd in episode-items (de gele cirkels in het figuur) en bijbehorende activiteiten (contacten en/of cliëntbesprekingen).

[[Bestand:BDS_V_episodegericht_registreren - alpha.3.png|Episodegericht registreren|900px]]

===BDS V JGZ===
Voor de beschrijving en indeling van het dossier is gebruik gemaakt van episodes, episode-items, contacten en dossierdelen, afgeleid van het [https://referentiemodel.nhg.org/frontpage HIS-Referentiemodel]. Episode-items zijn gebonden aan een episode en onderdeel van de contactregistratie. Een dossierdeel beschrijft de functionaliteit van dat onderdeel in het dossier. Daarbij worden ook de gegevens benoemd, die er worden beheerd.

Binnen de JGZ wordt gesproken over 'Cliënten' in plaats van 'Patiënten'. Een voor de JGZ herkenbaardere term voor 'Contacten' is de term 'Activiteiten'. Onder activiteiten vallen zowel cliëntcontacten als cliëntbesprekingen. In plaats van ‘Episode’ wordt de term ‘Zorgepisode’ gehanteerd, conform de zib 2020.

De volgende afbeelding is een schematische weergave van het BDS V JGZ dossier. Het administratieve gedeelte aan de linkerzijde betreffen de gegevens die niet contact gebonden zijn. Dit zijn dossierdelen zoals Cliëntgegevens, Dossierinformatie en Aanmeldgegevens. Het rechterdeel bevat de dossierdelen met episode-items, zoals Anamnese en Verloop zwangerschap, gekoppeld aan de dossierdelen Activiteiten en Zorgepisodes. Daarnaast is het verloop van de zwangerschap gekoppeld aan de Zwangerschapsgegevens en zijn de Zwangerschapsgegevens gekoppeld aan de Zorgepisode. Het dossierdeel Vaccinatie is grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_dossier_-_alpha.4_-_V1.png|BDS V Dossier|900px]]

==Doelgroep==
De doelgroepen van dit functioneel ontwerp zijn:
*Productmanagers, architecten, ontwerpers en testers van XIS-leveranciers, zorgorganisaties en [https://www.nictiz.nl/ Nictiz];
*Zorgverleners en hun vertegenwoordigers;
*RIVM

==Kaders & Uitgangspunten==
===Richtlijn en proces===
De [https://open.overheid.nl/documenten/ronl-480b98f5-0e57-49f8-a15a-af39fc2988a1/pdf handreiking PHB JGZ] beschrijft de (samenwerkings)kaders voor de uitvoering van het PHB door de JGZ en betrokken partners. In het eerste kwartaal van 2023 is op basis van [https://www.ncj.nl/agenda/informatiestandaard-volwassenen-jgz Pressure Cooker Sessies] met experts uit het veld de registratieset vastgesteld die nodig is voor JGZ professionals om dit proces te kunnen registreren.

===Reikwijdte Functioneel Ontwerp===
De reikwijdte van dit functioneel ontwerp beslaat de functionele beschrijvingen en de dataset voor registratie van het prenataal huisbezoek. In de toekomst zal ook de registratie van de Maternale Vaccinatie en gegevensuitwisselingen binnen één of meerdere zorgprocessen beschreven worden.

===Databeschikbaarheid===
De [https://www.rijksoverheid.nl/documenten/publicaties/2023/03/31/nationale-visie-en-strategie-gezondheidsinformatiestelsel nationale visie op het gezondheidsinformatiestelsel] beschrijft hoe de transitie van gegevensuitwisseling naar databeschikbaarheid bijdraagt aan passende zorg en gezondheid. Databeschikbaarheid verwijst naar de mogelijkheid om gegevens te benaderen en te gebruiken wanneer dat nodig is, onafhankelijk van de context waarbinnen deze is geregistreerd. Randvoorwaarden voor databeschikbaarheid zijn eenheid van taal en eenheid van techniek. Het [https://nictiz.nl/publicaties/implementatiestrategie-snomed/ SNOMED advies] en het [https://www.rijksoverheid.nl/documenten/publicaties/2022/10/21/implementatie-fhir FHIR besluit] vormen hiervoor een belangrijke basis en daarmee ook voor het functioneel ontwerp BDS V JGZ.

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie de registratie en/of uitwisseling 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 de registratie usecase geanalyseerd en uitgewerkt.
==Algemeen==
De Basis Dataset Volwassenen JGZ is ingedeeld in verschillende usecases.
*BDS V JGZ - Registratie Prenataal Huisbezoek (PHB)

En in een later stadium:
*BDS V JGZ - Registratie Maternale Vaccinatie (MV)
*Usecases voor uitwisseling

==Usecase: BDS V JGZ - Registratie PHB==
===Doel en Relevantie===

Met de aanpassing van de Wet Publieke Gezondheid (Wpg) met het ‘Prenataal huisbezoek door de JGZ’ (vanaf nu PHB JGZ) krijgen alle gemeenten de taak om een prenataal huisbezoek door de JGZ aan te bieden aan zwangeren en/of hun gezinnen in een kwetsbare situatie. De huidige scope van de BDS V JGZ betreft nu alleen de zwangere die in aanmerking komt voor een PHB.

Geboortezorg professionals en andere betrokkenen in de zwangerschap hebben een signalerende en toeleidende rol; de JGZ heeft de uitvoerende rol. Samenwerking is dus essentieel. Concreet betekent de wetswijziging dat de jeugdverpleegkundige al vroeg in de zwangerschap, na signalering van een kwetsbare situatie door de geboortezorg (of een andere betrokken professional), hulp en ondersteuning kan bieden aan de zwangere en/of hun gezin in een kwetsbare situatie. Hieronder vallen directe ondersteuning door de JGZ, waaronder advies en voorlichting, maar ook advies voor een passende aanpak buiten de JGZ. De zwangere besluit uiteraard zelf of ze van het prenatale huisbezoek gebruik wil maken. Alleen de JGZ-professional die een behandelrelatie heeft met de cliënt, heeft toegang tot het digitale dossier van deze cliënt. Om dit te waarborgen bevat elk dossier een logboek waarin te zien is wie wanneer toegang heeft gehad tot een dossier en wat die professional heeft gedaan.

(Kwetsbare) ouders kunnen al tijdens de zwangerschap (intensieve) begeleiding vanuit de JGZ krijgen. Dit kan starten met een prenataal huisbezoek. In de usecase BDS V JGZ - Registratie PHB wordt vastgesteld welke informatie er vastgelegd wordt over het prenatale huisbezoek JGZ met als doel een eenduidig dossier te hebben, waarin de gegevens van de zwangere en afspraken worden genoteerd.

Dit heeft meerdere doelen:
*Bevorderen en borgen van de kwaliteit van de zorg (ouder en professional).
*Bevorderen en borgen van de continuïteit van de zorg (ouder en professional).
*Verantwoording van handelen (professional).
*Monitoren van de voortgang zowel individueel als collectief (ouder, professional, organisatie, statistiek).
*Genereren van beleids-, stuur- en spiegelinformatie (organisatie, statistiek).

====Patient Journey====
De volgende patient journey beschrijft een algemene prenatale begeleiding door de JGZ:

Kyana is 15 weken zwanger. Haar verloskundige heeft haar geadviseerd zich aan te melden bij de JGZ voor een prenataal huisbezoek. Kyana is een meisje van 18 jaar dat ongepland zwanger is. Ze zit nog op school en woont sinds kort bij haar vriend en zijn ouders, omdat haar eigen ouders geen contact meer met haar willen. Kyana heeft geen inkomsten en haar vriend werkt vijf dagen per week in de bouw. Samen zijn ze hard op zoek naar een woning. Kyana kijkt uit naar de komst van haar baby, maar heeft nog nauwelijks een idee van wat haar straks te wachten staat. De jeugdverpleegkundige neemt, naar aanleiding van de aanmelding, contact op met Kyana en ze maken een afspraak voor een huisbezoek. Tijdens dit bezoek brengt de jeugdverpleegkundige de situatie van Kyana in kaart en bespreekt haar hulpvraag, wensen en behoeften. Aan de hand van de inventarisatie stelt de jeugdverpleegkundige samen met Kyana een plan van aanpak op. Er wordt besloten dat de jeugdverpleegkundige kortdurende ondersteuning biedt aan Kyana en haar vriend. Er wordt een vervolgafspraak gemaakt. Aan het eind van de kortdurende ondersteuning vindt er een evaluatie plaats over o.a. het plan van aanpak, de uitvoering hiervan en de ervaringen van Kyana en haar vriend over het traject. Zo nodig wordt het plan van aanpak bijgesteld.

===Proces en Context (pre- en postproces)===
Voor het scheppen van context is in de usecase BDS V JGZ - Registratie PHB naast het proces van registratie, ook beschreven wat het pre- en postproces omvatten. De usecase BDS V JGZ - Registratie PHB beperkt zich slechts tot de registratie van gegevens vanaf het moment waarop er een dossier wordt aangelegd.

====Preproces====
*Een professional signaleert een kwetsbare situatie bij een zwangere en bespreekt dit met de zwangere en/of het gezin. Indien de signalerende professional in samenspraak met de cliënt van mening is dat de mogelijkheden van de signalerende professional niet toereikend zijn (tijd, aard van het probleem, kennis) adviseert die een Prenataal Huisbezoek door de Jeugdgezondheidszorg (PHB JGZ) om de situatie nader in kaart te brengen.
*Er wordt een verzoek gedaan tot het uitvoeren van een PHB JGZ. De zwangere meldt zichzelf aan, al dan niet met ondersteuning van de professional.
*De ontvangst van de aanmelding vormt de start van het hulpverleningsproces bij de JGZ.

====Proces====
Het proces van deze usecase is:
*Er wordt een dossier aangelegd waarin de gegevens uit de aanmelding worden overgenomen en er wordt een zorgepisode gestart.
*Eerste contact (telefonisch): Op basis van deze gegevens heeft de jeugdverpleegkundige telefonisch contact met de zwangere.
*Als de zwangere in het gesprek aangeeft toch geen gebruik te willen maken van de begeleiding door de JGZ, wordt het dossier gesloten.
*Als de zwangere gebruik wenst te maken van het PHB, wordt de datum waarop het huisbezoek plaatsvindt vastgelegd.
*Registratie van de activiteiten gebeurt zoveel mogelijk gestructureerd, met -uitsluitend waar nodig- een toelichting.
*Tijdens het eerste huisbezoek vindt de WID-controle van de cliënt plaats.
*Bij het PHB JGZ worden alle gegevens door de JGZ geregistreerd volgens de BDS V JGZ, zowel om de voortgang te kunnen volgen als om de uitvoering te monitoren.

====Postproces====
De gegevens zijn gestructureerd opgeslagen (en beschikbaar in het systeem).

===Bedrijfsrollen en UML activity diagram===
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| Bronsysteem
| style="background-color: white;"| Registreert PHB gegevens.
|-
|}

===Informatieregistratie===
Dit hoofdstuk beschrijft welke informatie omtrent het BDS V JGZ - Registratie PHB in een bronsysteem dient te worden vastgelegd.

====Opbouw transactie====
De transactie is opgebouwd uit een laag met bouwstenen en een presentatielaag om usecase specifieke wensen ten aanzien van de presentatielaag te scheiden van de generieke technische onderlaag. Door deze generieke onderlaag kan de interoperabiliteit tussen domeinen worden gewaarborgd en kunnen in de toekomst vanuit dezelfde dataset meerdere domeinen en usecases worden ondersteund. Hieronder volgt een toelichting per laag van de transactie.

====Bouwstenen====
De bouwstenen laag bestaat uit een set herbruikbare bouwstenen die binnen 1 of meerdere domeinen of usecases hergebruikt kunnen worden in de domein of usecase specifieke presentatielaag. Een bouwsteen kan: 1. een exacte kopie zijn van een bestaande zib, 2. afgeleid zijn van een bestaande zib en verrijkt met domein en usecase specifieke eisen of 3. geen enkele relatie hebben met een bestaande zib. In de meeste gevallen zal gebruik gemaakt worden van bouwstenen die zijn afgeleid van de zib, tenzij de bestaande zib al voor 100% volstaat of er geen bestaande zib beschikbaar is. De transactie geeft aan welke onderdelen van een bouwsteen in de betreffende usecase relevant zijn.

Onderstaande afbeelding geeft een voorbeeld van de bouwsteen Contact. Deze bouwsteen is afgeleid van de zib Contact, waarbij een aantal extra elementen zijn toegevoegd, zoals ContactSoort en ContactVorm.

[[Bestand:JGZ BDSV bouwsteen contact.png|300px]]

====Presentatieset====
De presentatielaag beschrijft de set van gegevens, zoals deze aan de voorkant gepresenteerd zal worden, in dit geval BDS V JGZ.

Onderstaande afbeelding geeft een voorbeeld van een verwijzing naar de bouwsteen Contact vanuit de presentatielaag. Binnen de JGZ worden Contacten en Cliëntbesprekingen gepresenteerd in het dossierdeel Activiteiten. Merk op dat in dit voorbeeld wordt verwezen naar de bouwsteen Patiëntbespreking. Ondanks deze benaming in de transactie, afkomstig uit de zib, zal deze aan de voorkant als cliëntbespreking gepresenteerd worden.

[[Bestand:Dossierdeel_Activiteiten.PNG|Dossierdeel_Activiteiten|300px]]

=====Administratieve deel=====
Onderstaande figuur toont de dossierdelen in het administratieve deel van het dossier inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Dossierinformatie en Aanmeldgegevens.

[[Bestand:BDS-V_Administratief.png|BDS V Administratief|900px]]

=====Episode-items=====
Onderstaande figuur is een weergave van de episode-items inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Anamnese en VerloopZwangerschap. In het figuur zijn de relaties zichtbaar tussen de episode-items en de zorgepisodes, activiteiten, zwangerschapsgegevens en overige bouwstenen. Het dossierdeel Vaccinatie is in het grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_episode-items-alpha.4.jpg|BDS V Episode-Items|900px]]

=====Relaties=====
In de dataset kan vanuit een bouwsteen of dossierdeel een relatie worden gelegd naar een andere bouwsteen. Dit gebeurt door middel van een relatie, zoals bijvoorbeeld ‘RelatieZorgEpisode’. Daarin wordt door middel van een identificatienummer gerefereerd naar een specifieke instantiatie van de bouwsteen ZorgEpisode. Op deze manier kunnen episode-items bijvoorbeeld gerelateerd worden aan zorgepisodes. Dit biedt ook de mogelijkheid om specifieke queries te doen, bijvoorbeeld alle episode-items die aan een specifieke zorgepisode gerelateerd zijn.

BDS V JGZ kent onderstaande relaties:

* RelatieZorgEpisode: gebruikt in alle episode-items, Zwangerschap, Aanmelding
* RelatieContact: gebruikt in alle episode-items
* RelatiePatiëntbespreking (RelatieCliëntbespreking): gebruikt in alle episode-items
* RelatieZwangerschap: gebruikt in VerloopZwangerschap

====Transactie====
Hieronder is de inhoud van de transactie weergegeven. Deze informatie is ook in een [https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20250604T101158/scenarios.html nieuw tabblad] te openen.

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20251023T092603/sc-2.16.840.1.113883.2.4.3.11.60.100.3.9-2024-07-23T000000.html frameborder="0" align="middle"></iframe>
</html>

= Aanvullende informatie =

Voor de eenheid van taal wordt zo veel mogelijk [https://www.nictiz.nl/standaardisatie/terminologiecentrum/snomed-ct/ SNOMED] gebruikt. Aanvullende uitleg over de gebruite codes en waardelijsten is te lezen op het [https://informatiestandaarden.nictiz.nl/wiki/jgz:V0.1_Ontwerp_BDSV/UitlegWaardelijsten overzicht waardelijsten met bijzonderheden].

=Release notes=
In onderstaande tabel staan de wijzigingen voor dit ontwerp:
{{#lsth:Tabellen met release notes|BDS V 0.1}}

jgz:V0.1 Ontwerp BDSV

2025-10-23T09:53:30Z

Ahsen Yurt: /* Episode-items */ wijziging afbeelding tbv alpha 4

{{underconstruction}}

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel ontwerp Basis Dataset Volwassenen JGZ {{VersieInfo|BDSV|release=V0.1}}|noreplace}}

=Inleiding=
==Algemeen==
Deze pagina beschrijft het functioneel ontwerp van de Basis Dataset Volwassenen JGZ (BDS V JGZ). Deze alpha-versie betreft een ontwikkelversie van de usecase BDS V JGZ - Registratie Prenataal Huisbezoek (PHB). Later zal daar ook de usecase BDS V JGZ - Registratie Maternale Vaccinatie (MV) aan worden toegevoegd, evenals de toekomstige usecases voor uitwisseling. In hoofdstuk 2 wordt verder ingegaan op wat de usecase inhoudt.

Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/standaarden/?_gl=1*1sb90or*_up*MQ..*_ga*MTE5NTg3ODUzNy4xNzM5NTUyODY5*_ga_0ZRXV90GXH*MTczOTU1Mjg2OC4xLjAuMTczOTU1Mjg2OC4wLjAuMTQ3MDY2Nzk3OA./ Nictiz webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz website].

===Aanleiding voor een Digitaal Dossier Jeugdgezondheidszorg voor Volwassenen===
Sinds 2019 is de doelgroep van de JGZ uitgebreid van jeugdigen naar zwangeren. Dit betekent dat de JGZ-professional een dossier voor volwassenen nodig heeft, omdat er een behandelrelatie wordt aangegaan met de zwangere. Dit komt voort uit de Wet op de geneeskundige behandelingsovereenkomst (WGBO), waarin staat beschreven dat een zorgprofessional een medisch dossier moet hebben om de werkzaamheden in te registreren. De Wet publieke gezondheid (Wpg) bepaalt dat dit een digitaal medisch dossier moet zijn.
De usecase BDS V JGZ - Registratie PHB bevat een registratiedataset die zorgt voor landelijk uniforme registratie, waarbij het niet uitmaakt van welke dossierapplicatie de JGZ-professional gebruik maakt. Deze uniforme registratie legt de basis voor gestructureerde gegevensuitwisseling. Bijvoorbeeld tussen JGZ-organisaties onderling bij een verhuizing van een cliënt of bij het beschikbaar stellen van Maternale Vaccinaties van de JGZ aan het RIVM. Bij de totstandkoming van de BDS V JGZ wordt gebruik gemaakt van zorginformatiebouwstenen (zibs) en HL7 FHIR om in de toekomst ook uitwisseling met andere domeinen mogelijk te maken.

===Dossierplicht en privacyregels===
Bij de registratie van individuele medische gegevens van cliënten, alsmede het communiceren daarvan, zijn onder andere de Wet op de Geneeskundige Behandelovereenkomst (WGBO) en de Wet Algemene Verordening Gegevensbescherming (AVG) van toepassing. Uit de WGBO blijkt dat de JGZ-professional een dossierplicht heeft en welke informatie hierin geregistreerd dient te worden. In de WGBO en de AVG staan de rechten en plichten van de cliënt beschreven.

===Episodegericht registreren===
Medische gegevens van cliënten worden vastgelegd binnen de context van een contact en/of een specifieke zorgvraag. Voor de herbruikbaarheid van gegevens is het van belang deze context op een later moment te kunnen herleiden. Door gegevens te koppelen aan zorgepisodes en contacten, kunnen gegevens vanuit deze context geraadpleegd worden. De [https://zibs.nl/wiki/ZIB_Publicatie_2020(NL) Zib Publicatie 2020] hanteert de volgende definitie van [https://zibs.nl/wiki/ZorgEpisode-v1.0(2020NL)#Concept zorgepisode]:

''"Een zorgepisode is een periode waarin een gezondheidsprobleem, zoals een klacht of een aandoening, de aandacht heeft van een zorgverlener. In deze periode kan de duiding van het gezondheidsprobleem veranderen door voortschrijdend inzicht en/of het beloop van de aandoening. Een zorgepisode fungeert als context voor alle gegevens die op het gezondheidsprobleem betrekking hebben."''

Binnen de JGZ wordt een ruime definitie van het begrip gezondheidsprobleem gehanteerd vanwege het preventieve karakter van de verleende zorg. Deze is meer gericht op een situatie of levensfase dan op een specifiek gezondheidsprobleem. In het geval van BDS V vallen zowel het Prenataal Huisbezoek als de Maternale Vaccinatie onder de zorgepisode ‘Aanstaand ouderschap’.

Onderstaande afbeelding toont een voorbeeld van een zorgepisode met de zorginhoudelijke gegevens die daarbij worden vastgelegd in episode-items (de gele cirkels in het figuur) en bijbehorende activiteiten (contacten en/of cliëntbesprekingen).

[[Bestand:BDS_V_episodegericht_registreren - alpha.3.png|Episodegericht registreren|900px]]

===BDS V JGZ===
Voor de beschrijving en indeling van het dossier is gebruik gemaakt van episodes, episode-items, contacten en dossierdelen, afgeleid van het [https://referentiemodel.nhg.org/frontpage HIS-Referentiemodel]. Episode-items zijn gebonden aan een episode en onderdeel van de contactregistratie. Een dossierdeel beschrijft de functionaliteit van dat onderdeel in het dossier. Daarbij worden ook de gegevens benoemd, die er worden beheerd.

Binnen de JGZ wordt gesproken over 'Cliënten' in plaats van 'Patiënten'. Een voor de JGZ herkenbaardere term voor 'Contacten' is de term 'Activiteiten'. Onder activiteiten vallen zowel cliëntcontacten als cliëntbesprekingen. In plaats van ‘Episode’ wordt de term ‘Zorgepisode’ gehanteerd, conform de zib 2020.

De volgende afbeelding is een schematische weergave van het BDS V JGZ dossier. Het administratieve gedeelte aan de linkerzijde betreffen de gegevens die niet contact gebonden zijn. Dit zijn dossierdelen zoals Cliëntgegevens, Dossierinformatie en Aanmeldgegevens. Het rechterdeel bevat de dossierdelen met episode-items, zoals Anamnese en Verloop zwangerschap, gekoppeld aan de dossierdelen Activiteiten en Zorgepisodes. Daarnaast is het verloop van de zwangerschap gekoppeld aan de Zwangerschapsgegevens en zijn de Zwangerschapsgegevens gekoppeld aan de Zorgepisode. Het dossierdeel Vaccinatie is grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_dossier_-_alpha.4_-_V1.png|BDS V Dossier|900px]]

==Doelgroep==
De doelgroepen van dit functioneel ontwerp zijn:
*Productmanagers, architecten, ontwerpers en testers van XIS-leveranciers, zorgorganisaties en [https://www.nictiz.nl/ Nictiz];
*Zorgverleners en hun vertegenwoordigers;
*RIVM

==Kaders & Uitgangspunten==
===Richtlijn en proces===
De [https://open.overheid.nl/documenten/ronl-480b98f5-0e57-49f8-a15a-af39fc2988a1/pdf handreiking PHB JGZ] beschrijft de (samenwerkings)kaders voor de uitvoering van het PHB door de JGZ en betrokken partners. In het eerste kwartaal van 2023 is op basis van [https://www.ncj.nl/agenda/informatiestandaard-volwassenen-jgz Pressure Cooker Sessies] met experts uit het veld de registratieset vastgesteld die nodig is voor JGZ professionals om dit proces te kunnen registreren.

===Reikwijdte Functioneel Ontwerp===
De reikwijdte van dit functioneel ontwerp beslaat de functionele beschrijvingen en de dataset voor registratie van het prenataal huisbezoek. In de toekomst zal ook de registratie van de Maternale Vaccinatie en gegevensuitwisselingen binnen één of meerdere zorgprocessen beschreven worden.

===Databeschikbaarheid===
De [https://www.rijksoverheid.nl/documenten/publicaties/2023/03/31/nationale-visie-en-strategie-gezondheidsinformatiestelsel nationale visie op het gezondheidsinformatiestelsel] beschrijft hoe de transitie van gegevensuitwisseling naar databeschikbaarheid bijdraagt aan passende zorg en gezondheid. Databeschikbaarheid verwijst naar de mogelijkheid om gegevens te benaderen en te gebruiken wanneer dat nodig is, onafhankelijk van de context waarbinnen deze is geregistreerd. Randvoorwaarden voor databeschikbaarheid zijn eenheid van taal en eenheid van techniek. Het [https://nictiz.nl/publicaties/implementatiestrategie-snomed/ SNOMED advies] en het [https://www.rijksoverheid.nl/documenten/publicaties/2022/10/21/implementatie-fhir FHIR besluit] vormen hiervoor een belangrijke basis en daarmee ook voor het functioneel ontwerp BDS V JGZ.

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie de registratie en/of uitwisseling 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 de registratie usecase geanalyseerd en uitgewerkt.
==Algemeen==
De Basis Dataset Volwassenen JGZ is ingedeeld in verschillende usecases.
*BDS V JGZ - Registratie Prenataal Huisbezoek (PHB)

En in een later stadium:
*BDS V JGZ - Registratie Maternale Vaccinatie (MV)
*Usecases voor uitwisseling

==Usecase: BDS V JGZ - Registratie PHB==
===Doel en Relevantie===

Met de aanpassing van de Wet Publieke Gezondheid (Wpg) met het ‘Prenataal huisbezoek door de JGZ’ (vanaf nu PHB JGZ) krijgen alle gemeenten de taak om een prenataal huisbezoek door de JGZ aan te bieden aan zwangeren en/of hun gezinnen in een kwetsbare situatie. De huidige scope van de BDS V JGZ betreft nu alleen de zwangere die in aanmerking komt voor een PHB.

Geboortezorg professionals en andere betrokkenen in de zwangerschap hebben een signalerende en toeleidende rol; de JGZ heeft de uitvoerende rol. Samenwerking is dus essentieel. Concreet betekent de wetswijziging dat de jeugdverpleegkundige al vroeg in de zwangerschap, na signalering van een kwetsbare situatie door de geboortezorg (of een andere betrokken professional), hulp en ondersteuning kan bieden aan de zwangere en/of hun gezin in een kwetsbare situatie. Hieronder vallen directe ondersteuning door de JGZ, waaronder advies en voorlichting, maar ook advies voor een passende aanpak buiten de JGZ. De zwangere besluit uiteraard zelf of ze van het prenatale huisbezoek gebruik wil maken. Alleen de JGZ-professional die een behandelrelatie heeft met de cliënt, heeft toegang tot het digitale dossier van deze cliënt. Om dit te waarborgen bevat elk dossier een logboek waarin te zien is wie wanneer toegang heeft gehad tot een dossier en wat die professional heeft gedaan.

(Kwetsbare) ouders kunnen al tijdens de zwangerschap (intensieve) begeleiding vanuit de JGZ krijgen. Dit kan starten met een prenataal huisbezoek. In de usecase BDS V JGZ - Registratie PHB wordt vastgesteld welke informatie er vastgelegd wordt over het prenatale huisbezoek JGZ met als doel een eenduidig dossier te hebben, waarin de gegevens van de zwangere en afspraken worden genoteerd.

Dit heeft meerdere doelen:
*Bevorderen en borgen van de kwaliteit van de zorg (ouder en professional).
*Bevorderen en borgen van de continuïteit van de zorg (ouder en professional).
*Verantwoording van handelen (professional).
*Monitoren van de voortgang zowel individueel als collectief (ouder, professional, organisatie, statistiek).
*Genereren van beleids-, stuur- en spiegelinformatie (organisatie, statistiek).

====Patient Journey====
De volgende patient journey beschrijft een algemene prenatale begeleiding door de JGZ:

Kyana is 15 weken zwanger. Haar verloskundige heeft haar geadviseerd zich aan te melden bij de JGZ voor een prenataal huisbezoek. Kyana is een meisje van 18 jaar dat ongepland zwanger is. Ze zit nog op school en woont sinds kort bij haar vriend en zijn ouders, omdat haar eigen ouders geen contact meer met haar willen. Kyana heeft geen inkomsten en haar vriend werkt vijf dagen per week in de bouw. Samen zijn ze hard op zoek naar een woning. Kyana kijkt uit naar de komst van haar baby, maar heeft nog nauwelijks een idee van wat haar straks te wachten staat. De jeugdverpleegkundige neemt, naar aanleiding van de aanmelding, contact op met Kyana en ze maken een afspraak voor een huisbezoek. Tijdens dit bezoek brengt de jeugdverpleegkundige de situatie van Kyana in kaart en bespreekt haar hulpvraag, wensen en behoeften. Aan de hand van de inventarisatie stelt de jeugdverpleegkundige samen met Kyana een plan van aanpak op. Er wordt besloten dat de jeugdverpleegkundige kortdurende ondersteuning biedt aan Kyana en haar vriend. Er wordt een vervolgafspraak gemaakt. Aan het eind van de kortdurende ondersteuning vindt er een evaluatie plaats over o.a. het plan van aanpak, de uitvoering hiervan en de ervaringen van Kyana en haar vriend over het traject. Zo nodig wordt het plan van aanpak bijgesteld.

===Proces en Context (pre- en postproces)===
Voor het scheppen van context is in de usecase BDS V JGZ - Registratie PHB naast het proces van registratie, ook beschreven wat het pre- en postproces omvatten. De usecase BDS V JGZ - Registratie PHB beperkt zich slechts tot de registratie van gegevens vanaf het moment waarop er een dossier wordt aangelegd.

====Preproces====
*Een professional signaleert een kwetsbare situatie bij een zwangere en bespreekt dit met de zwangere en/of het gezin. Indien de signalerende professional in samenspraak met de cliënt van mening is dat de mogelijkheden van de signalerende professional niet toereikend zijn (tijd, aard van het probleem, kennis) adviseert die een Prenataal Huisbezoek door de Jeugdgezondheidszorg (PHB JGZ) om de situatie nader in kaart te brengen.
*Er wordt een verzoek gedaan tot het uitvoeren van een PHB JGZ. De zwangere meldt zichzelf aan, al dan niet met ondersteuning van de professional.
*De ontvangst van de aanmelding vormt de start van het hulpverleningsproces bij de JGZ.

====Proces====
Het proces van deze usecase is:
*Er wordt een dossier aangelegd waarin de gegevens uit de aanmelding worden overgenomen en er wordt een zorgepisode gestart.
*Eerste contact (telefonisch): Op basis van deze gegevens heeft de jeugdverpleegkundige telefonisch contact met de zwangere.
*Als de zwangere in het gesprek aangeeft toch geen gebruik te willen maken van de begeleiding door de JGZ, wordt het dossier gesloten.
*Als de zwangere gebruik wenst te maken van het PHB, wordt de datum waarop het huisbezoek plaatsvindt vastgelegd.
*Registratie van de activiteiten gebeurt zoveel mogelijk gestructureerd, met -uitsluitend waar nodig- een toelichting.
*Tijdens het eerste huisbezoek vindt de WID-controle van de cliënt plaats.
*Bij het PHB JGZ worden alle gegevens door de JGZ geregistreerd volgens de BDS V JGZ, zowel om de voortgang te kunnen volgen als om de uitvoering te monitoren.

====Postproces====
De gegevens zijn gestructureerd opgeslagen (en beschikbaar in het systeem).

===Bedrijfsrollen en UML activity diagram===
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| Bronsysteem
| style="background-color: white;"| Registreert PHB gegevens.
|-
|}

===Informatieregistratie===
Dit hoofdstuk beschrijft welke informatie omtrent het BDS V JGZ - Registratie PHB in een bronsysteem dient te worden vastgelegd.

====Opbouw transactie====
De transactie is opgebouwd uit een laag met bouwstenen en een presentatielaag om usecase specifieke wensen ten aanzien van de presentatielaag te scheiden van de generieke technische onderlaag. Door deze generieke onderlaag kan de interoperabiliteit tussen domeinen worden gewaarborgd en kunnen in de toekomst vanuit dezelfde dataset meerdere domeinen en usecases worden ondersteund. Hieronder volgt een toelichting per laag van de transactie.

====Bouwstenen====
De bouwstenen laag bestaat uit een set herbruikbare bouwstenen die binnen 1 of meerdere domeinen of usecases hergebruikt kunnen worden in de domein of usecase specifieke presentatielaag. Een bouwsteen kan: 1. een exacte kopie zijn van een bestaande zib, 2. afgeleid zijn van een bestaande zib en verrijkt met domein en usecase specifieke eisen of 3. geen enkele relatie hebben met een bestaande zib. In de meeste gevallen zal gebruik gemaakt worden van bouwstenen die zijn afgeleid van de zib, tenzij de bestaande zib al voor 100% volstaat of er geen bestaande zib beschikbaar is. De transactie geeft aan welke onderdelen van een bouwsteen in de betreffende usecase relevant zijn.

Onderstaande afbeelding geeft een voorbeeld van de bouwsteen Contact. Deze bouwsteen is afgeleid van de zib Contact, waarbij een aantal extra elementen zijn toegevoegd, zoals ContactSoort en ContactVorm.

[[Bestand:JGZ BDSV bouwsteen contact.png|300px]]

====Presentatieset====
De presentatielaag beschrijft de set van gegevens, zoals deze aan de voorkant gepresenteerd zal worden, in dit geval BDS V JGZ.

Onderstaande afbeelding geeft een voorbeeld van een verwijzing naar de bouwsteen Contact vanuit de presentatielaag. Binnen de JGZ worden Contacten en Cliëntbesprekingen gepresenteerd in het dossierdeel Activiteiten. Merk op dat in dit voorbeeld wordt verwezen naar de bouwsteen Patiëntbespreking. Ondanks deze benaming in de transactie, afkomstig uit de zib, zal deze aan de voorkant als cliëntbespreking gepresenteerd worden.

[[Bestand:Dossierdeel_Activiteiten.PNG|Dossierdeel_Activiteiten|300px]]

=====Administratieve deel=====
Onderstaande figuur toont de dossierdelen in het administratieve deel van het dossier inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Dossierinformatie en Aanmeldgegevens.

[[Bestand:BDS-V_Administratief.png|BDS V Administratief|900px]]

=====Episode-items=====
Onderstaande figuur is een weergave van de episode-items inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Anamnese en VerloopZwangerschap. In het figuur zijn de relaties zichtbaar tussen de episode-items en de zorgepisodes, activiteiten, zwangerschapsgegevens en overige bouwstenen. Het dossierdeel Vaccinatie is in het grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_episode-items-alpha.4.jpg|BDS V Episode-Items|900px]]

=====Relaties=====
In de dataset kan vanuit een bouwsteen of dossierdeel een relatie worden gelegd naar een andere bouwsteen. Dit gebeurt door middel van een relatie, zoals bijvoorbeeld ‘RelatieZorgEpisode’. Daarin wordt door middel van een identificatienummer gerefereerd naar een specifieke instantiatie van de bouwsteen ZorgEpisode. Op deze manier kunnen episode-items bijvoorbeeld gerelateerd worden aan zorgepisodes. Dit biedt ook de mogelijkheid om specifieke queries te doen, bijvoorbeeld alle episode-items die aan een specifieke zorgepisode gerelateerd zijn.

BDS V JGZ kent onderstaande relaties:

* RelatieZorgEpisode: gebruikt in alle episode-items, Zwangerschap, Aanmelding
* RelatieContact: gebruikt in alle episode-items
* RelatiePatiëntbespreking (RelatieCliëntbespreking): gebruikt in alle episode-items
* RelatieZwangerschap: gebruikt in VerloopZwangerschap

====Transactie====
Hieronder is de inhoud van de transactie weergegeven. Deze informatie is ook in een [https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20250604T101158/scenarios.html nieuw tabblad] te openen.

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20250604T101158/tr-2.16.840.1.113883.2.4.3.11.60.100.4.60-2024-07-23T000000.html frameborder="0" align="middle"></iframe>
</html>

= Aanvullende informatie =

Voor de eenheid van taal wordt zo veel mogelijk [https://www.nictiz.nl/standaardisatie/terminologiecentrum/snomed-ct/ SNOMED] gebruikt. Aanvullende uitleg over de gebruite codes en waardelijsten is te lezen op het [https://informatiestandaarden.nictiz.nl/wiki/jgz:V0.1_Ontwerp_BDSV/UitlegWaardelijsten overzicht waardelijsten met bijzonderheden].

=Release notes=
In onderstaande tabel staan de wijzigingen voor dit ontwerp:
{{#lsth:Tabellen met release notes|BDS V 0.1}}

Bestand:BDS V episode-items-alpha.4.jpg

2025-10-23T09:53:13Z

Ahsen Yurt:

Bestand:BDS V episode-items-alpha.4.png

2025-10-23T09:48:52Z

Ahsen Yurt:

Bestand:BDS V episode-items - alpha.4 V1.png

2025-10-23T09:37:31Z

Ahsen Yurt:

jgz:V0.1 Ontwerp BDSV

2025-10-23T09:36:34Z

Ahsen Yurt: /* BDS V JGZ */ wijziging afbeelding tbv alpha 4

{{underconstruction}}

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel ontwerp Basis Dataset Volwassenen JGZ {{VersieInfo|BDSV|release=V0.1}}|noreplace}}

=Inleiding=
==Algemeen==
Deze pagina beschrijft het functioneel ontwerp van de Basis Dataset Volwassenen JGZ (BDS V JGZ). Deze alpha-versie betreft een ontwikkelversie van de usecase BDS V JGZ - Registratie Prenataal Huisbezoek (PHB). Later zal daar ook de usecase BDS V JGZ - Registratie Maternale Vaccinatie (MV) aan worden toegevoegd, evenals de toekomstige usecases voor uitwisseling. In hoofdstuk 2 wordt verder ingegaan op wat de usecase inhoudt.

Voor meer informatie over informatiestandaarden en hoe deze worden ontwikkeld, zie de [https://nictiz.nl/standaarden/?_gl=1*1sb90or*_up*MQ..*_ga*MTE5NTg3ODUzNy4xNzM5NTUyODY5*_ga_0ZRXV90GXH*MTczOTU1Mjg2OC4xLjAuMTczOTU1Mjg2OC4wLjAuMTQ3MDY2Nzk3OA./ Nictiz webpagina voor informatiestandaarden]. Voor de verklaring van de begrippen die voorkomen in het functioneel ontwerp wordt verwezen naar het [https://nictiz.nl/standaarden/begrippen/ begrippenoverzicht op de Nictiz website].

===Aanleiding voor een Digitaal Dossier Jeugdgezondheidszorg voor Volwassenen===
Sinds 2019 is de doelgroep van de JGZ uitgebreid van jeugdigen naar zwangeren. Dit betekent dat de JGZ-professional een dossier voor volwassenen nodig heeft, omdat er een behandelrelatie wordt aangegaan met de zwangere. Dit komt voort uit de Wet op de geneeskundige behandelingsovereenkomst (WGBO), waarin staat beschreven dat een zorgprofessional een medisch dossier moet hebben om de werkzaamheden in te registreren. De Wet publieke gezondheid (Wpg) bepaalt dat dit een digitaal medisch dossier moet zijn.
De usecase BDS V JGZ - Registratie PHB bevat een registratiedataset die zorgt voor landelijk uniforme registratie, waarbij het niet uitmaakt van welke dossierapplicatie de JGZ-professional gebruik maakt. Deze uniforme registratie legt de basis voor gestructureerde gegevensuitwisseling. Bijvoorbeeld tussen JGZ-organisaties onderling bij een verhuizing van een cliënt of bij het beschikbaar stellen van Maternale Vaccinaties van de JGZ aan het RIVM. Bij de totstandkoming van de BDS V JGZ wordt gebruik gemaakt van zorginformatiebouwstenen (zibs) en HL7 FHIR om in de toekomst ook uitwisseling met andere domeinen mogelijk te maken.

===Dossierplicht en privacyregels===
Bij de registratie van individuele medische gegevens van cliënten, alsmede het communiceren daarvan, zijn onder andere de Wet op de Geneeskundige Behandelovereenkomst (WGBO) en de Wet Algemene Verordening Gegevensbescherming (AVG) van toepassing. Uit de WGBO blijkt dat de JGZ-professional een dossierplicht heeft en welke informatie hierin geregistreerd dient te worden. In de WGBO en de AVG staan de rechten en plichten van de cliënt beschreven.

===Episodegericht registreren===
Medische gegevens van cliënten worden vastgelegd binnen de context van een contact en/of een specifieke zorgvraag. Voor de herbruikbaarheid van gegevens is het van belang deze context op een later moment te kunnen herleiden. Door gegevens te koppelen aan zorgepisodes en contacten, kunnen gegevens vanuit deze context geraadpleegd worden. De [https://zibs.nl/wiki/ZIB_Publicatie_2020(NL) Zib Publicatie 2020] hanteert de volgende definitie van [https://zibs.nl/wiki/ZorgEpisode-v1.0(2020NL)#Concept zorgepisode]:

''"Een zorgepisode is een periode waarin een gezondheidsprobleem, zoals een klacht of een aandoening, de aandacht heeft van een zorgverlener. In deze periode kan de duiding van het gezondheidsprobleem veranderen door voortschrijdend inzicht en/of het beloop van de aandoening. Een zorgepisode fungeert als context voor alle gegevens die op het gezondheidsprobleem betrekking hebben."''

Binnen de JGZ wordt een ruime definitie van het begrip gezondheidsprobleem gehanteerd vanwege het preventieve karakter van de verleende zorg. Deze is meer gericht op een situatie of levensfase dan op een specifiek gezondheidsprobleem. In het geval van BDS V vallen zowel het Prenataal Huisbezoek als de Maternale Vaccinatie onder de zorgepisode ‘Aanstaand ouderschap’.

Onderstaande afbeelding toont een voorbeeld van een zorgepisode met de zorginhoudelijke gegevens die daarbij worden vastgelegd in episode-items (de gele cirkels in het figuur) en bijbehorende activiteiten (contacten en/of cliëntbesprekingen).

[[Bestand:BDS_V_episodegericht_registreren - alpha.3.png|Episodegericht registreren|900px]]

===BDS V JGZ===
Voor de beschrijving en indeling van het dossier is gebruik gemaakt van episodes, episode-items, contacten en dossierdelen, afgeleid van het [https://referentiemodel.nhg.org/frontpage HIS-Referentiemodel]. Episode-items zijn gebonden aan een episode en onderdeel van de contactregistratie. Een dossierdeel beschrijft de functionaliteit van dat onderdeel in het dossier. Daarbij worden ook de gegevens benoemd, die er worden beheerd.

Binnen de JGZ wordt gesproken over 'Cliënten' in plaats van 'Patiënten'. Een voor de JGZ herkenbaardere term voor 'Contacten' is de term 'Activiteiten'. Onder activiteiten vallen zowel cliëntcontacten als cliëntbesprekingen. In plaats van ‘Episode’ wordt de term ‘Zorgepisode’ gehanteerd, conform de zib 2020.

De volgende afbeelding is een schematische weergave van het BDS V JGZ dossier. Het administratieve gedeelte aan de linkerzijde betreffen de gegevens die niet contact gebonden zijn. Dit zijn dossierdelen zoals Cliëntgegevens, Dossierinformatie en Aanmeldgegevens. Het rechterdeel bevat de dossierdelen met episode-items, zoals Anamnese en Verloop zwangerschap, gekoppeld aan de dossierdelen Activiteiten en Zorgepisodes. Daarnaast is het verloop van de zwangerschap gekoppeld aan de Zwangerschapsgegevens en zijn de Zwangerschapsgegevens gekoppeld aan de Zorgepisode. Het dossierdeel Vaccinatie is grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS_V_dossier_-_alpha.4_-_V1.png|BDS V Dossier|900px]]

==Doelgroep==
De doelgroepen van dit functioneel ontwerp zijn:
*Productmanagers, architecten, ontwerpers en testers van XIS-leveranciers, zorgorganisaties en [https://www.nictiz.nl/ Nictiz];
*Zorgverleners en hun vertegenwoordigers;
*RIVM

==Kaders & Uitgangspunten==
===Richtlijn en proces===
De [https://open.overheid.nl/documenten/ronl-480b98f5-0e57-49f8-a15a-af39fc2988a1/pdf handreiking PHB JGZ] beschrijft de (samenwerkings)kaders voor de uitvoering van het PHB door de JGZ en betrokken partners. In het eerste kwartaal van 2023 is op basis van [https://www.ncj.nl/agenda/informatiestandaard-volwassenen-jgz Pressure Cooker Sessies] met experts uit het veld de registratieset vastgesteld die nodig is voor JGZ professionals om dit proces te kunnen registreren.

===Reikwijdte Functioneel Ontwerp===
De reikwijdte van dit functioneel ontwerp beslaat de functionele beschrijvingen en de dataset voor registratie van het prenataal huisbezoek. In de toekomst zal ook de registratie van de Maternale Vaccinatie en gegevensuitwisselingen binnen één of meerdere zorgprocessen beschreven worden.

===Databeschikbaarheid===
De [https://www.rijksoverheid.nl/documenten/publicaties/2023/03/31/nationale-visie-en-strategie-gezondheidsinformatiestelsel nationale visie op het gezondheidsinformatiestelsel] beschrijft hoe de transitie van gegevensuitwisseling naar databeschikbaarheid bijdraagt aan passende zorg en gezondheid. Databeschikbaarheid verwijst naar de mogelijkheid om gegevens te benaderen en te gebruiken wanneer dat nodig is, onafhankelijk van de context waarbinnen deze is geregistreerd. Randvoorwaarden voor databeschikbaarheid zijn eenheid van taal en eenheid van techniek. Het [https://nictiz.nl/publicaties/implementatiestrategie-snomed/ SNOMED advies] en het [https://www.rijksoverheid.nl/documenten/publicaties/2022/10/21/implementatie-fhir FHIR besluit] vormen hiervoor een belangrijke basis en daarmee ook voor het functioneel ontwerp BDS V JGZ.

=Usecase(s)=
Een usecase is een specifieke beschrijving van een praktijksituatie in de zorg waarbij voor een concrete situatie de registratie en/of uitwisseling 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 de registratie usecase geanalyseerd en uitgewerkt.
==Algemeen==
De Basis Dataset Volwassenen JGZ is ingedeeld in verschillende usecases.
*BDS V JGZ - Registratie Prenataal Huisbezoek (PHB)

En in een later stadium:
*BDS V JGZ - Registratie Maternale Vaccinatie (MV)
*Usecases voor uitwisseling

==Usecase: BDS V JGZ - Registratie PHB==
===Doel en Relevantie===

Met de aanpassing van de Wet Publieke Gezondheid (Wpg) met het ‘Prenataal huisbezoek door de JGZ’ (vanaf nu PHB JGZ) krijgen alle gemeenten de taak om een prenataal huisbezoek door de JGZ aan te bieden aan zwangeren en/of hun gezinnen in een kwetsbare situatie. De huidige scope van de BDS V JGZ betreft nu alleen de zwangere die in aanmerking komt voor een PHB.

Geboortezorg professionals en andere betrokkenen in de zwangerschap hebben een signalerende en toeleidende rol; de JGZ heeft de uitvoerende rol. Samenwerking is dus essentieel. Concreet betekent de wetswijziging dat de jeugdverpleegkundige al vroeg in de zwangerschap, na signalering van een kwetsbare situatie door de geboortezorg (of een andere betrokken professional), hulp en ondersteuning kan bieden aan de zwangere en/of hun gezin in een kwetsbare situatie. Hieronder vallen directe ondersteuning door de JGZ, waaronder advies en voorlichting, maar ook advies voor een passende aanpak buiten de JGZ. De zwangere besluit uiteraard zelf of ze van het prenatale huisbezoek gebruik wil maken. Alleen de JGZ-professional die een behandelrelatie heeft met de cliënt, heeft toegang tot het digitale dossier van deze cliënt. Om dit te waarborgen bevat elk dossier een logboek waarin te zien is wie wanneer toegang heeft gehad tot een dossier en wat die professional heeft gedaan.

(Kwetsbare) ouders kunnen al tijdens de zwangerschap (intensieve) begeleiding vanuit de JGZ krijgen. Dit kan starten met een prenataal huisbezoek. In de usecase BDS V JGZ - Registratie PHB wordt vastgesteld welke informatie er vastgelegd wordt over het prenatale huisbezoek JGZ met als doel een eenduidig dossier te hebben, waarin de gegevens van de zwangere en afspraken worden genoteerd.

Dit heeft meerdere doelen:
*Bevorderen en borgen van de kwaliteit van de zorg (ouder en professional).
*Bevorderen en borgen van de continuïteit van de zorg (ouder en professional).
*Verantwoording van handelen (professional).
*Monitoren van de voortgang zowel individueel als collectief (ouder, professional, organisatie, statistiek).
*Genereren van beleids-, stuur- en spiegelinformatie (organisatie, statistiek).

====Patient Journey====
De volgende patient journey beschrijft een algemene prenatale begeleiding door de JGZ:

Kyana is 15 weken zwanger. Haar verloskundige heeft haar geadviseerd zich aan te melden bij de JGZ voor een prenataal huisbezoek. Kyana is een meisje van 18 jaar dat ongepland zwanger is. Ze zit nog op school en woont sinds kort bij haar vriend en zijn ouders, omdat haar eigen ouders geen contact meer met haar willen. Kyana heeft geen inkomsten en haar vriend werkt vijf dagen per week in de bouw. Samen zijn ze hard op zoek naar een woning. Kyana kijkt uit naar de komst van haar baby, maar heeft nog nauwelijks een idee van wat haar straks te wachten staat. De jeugdverpleegkundige neemt, naar aanleiding van de aanmelding, contact op met Kyana en ze maken een afspraak voor een huisbezoek. Tijdens dit bezoek brengt de jeugdverpleegkundige de situatie van Kyana in kaart en bespreekt haar hulpvraag, wensen en behoeften. Aan de hand van de inventarisatie stelt de jeugdverpleegkundige samen met Kyana een plan van aanpak op. Er wordt besloten dat de jeugdverpleegkundige kortdurende ondersteuning biedt aan Kyana en haar vriend. Er wordt een vervolgafspraak gemaakt. Aan het eind van de kortdurende ondersteuning vindt er een evaluatie plaats over o.a. het plan van aanpak, de uitvoering hiervan en de ervaringen van Kyana en haar vriend over het traject. Zo nodig wordt het plan van aanpak bijgesteld.

===Proces en Context (pre- en postproces)===
Voor het scheppen van context is in de usecase BDS V JGZ - Registratie PHB naast het proces van registratie, ook beschreven wat het pre- en postproces omvatten. De usecase BDS V JGZ - Registratie PHB beperkt zich slechts tot de registratie van gegevens vanaf het moment waarop er een dossier wordt aangelegd.

====Preproces====
*Een professional signaleert een kwetsbare situatie bij een zwangere en bespreekt dit met de zwangere en/of het gezin. Indien de signalerende professional in samenspraak met de cliënt van mening is dat de mogelijkheden van de signalerende professional niet toereikend zijn (tijd, aard van het probleem, kennis) adviseert die een Prenataal Huisbezoek door de Jeugdgezondheidszorg (PHB JGZ) om de situatie nader in kaart te brengen.
*Er wordt een verzoek gedaan tot het uitvoeren van een PHB JGZ. De zwangere meldt zichzelf aan, al dan niet met ondersteuning van de professional.
*De ontvangst van de aanmelding vormt de start van het hulpverleningsproces bij de JGZ.

====Proces====
Het proces van deze usecase is:
*Er wordt een dossier aangelegd waarin de gegevens uit de aanmelding worden overgenomen en er wordt een zorgepisode gestart.
*Eerste contact (telefonisch): Op basis van deze gegevens heeft de jeugdverpleegkundige telefonisch contact met de zwangere.
*Als de zwangere in het gesprek aangeeft toch geen gebruik te willen maken van de begeleiding door de JGZ, wordt het dossier gesloten.
*Als de zwangere gebruik wenst te maken van het PHB, wordt de datum waarop het huisbezoek plaatsvindt vastgelegd.
*Registratie van de activiteiten gebeurt zoveel mogelijk gestructureerd, met -uitsluitend waar nodig- een toelichting.
*Tijdens het eerste huisbezoek vindt de WID-controle van de cliënt plaats.
*Bij het PHB JGZ worden alle gegevens door de JGZ geregistreerd volgens de BDS V JGZ, zowel om de voortgang te kunnen volgen als om de uitvoering te monitoren.

====Postproces====
De gegevens zijn gestructureerd opgeslagen (en beschikbaar in het systeem).

===Bedrijfsrollen en UML activity diagram===
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Bedrijfsrol (actor)
!style="text-align:left;"|Beschrijving bedrijfsrol
|-
| style="background-color: white;"| Bronsysteem
| style="background-color: white;"| Registreert PHB gegevens.
|-
|}

===Informatieregistratie===
Dit hoofdstuk beschrijft welke informatie omtrent het BDS V JGZ - Registratie PHB in een bronsysteem dient te worden vastgelegd.

====Opbouw transactie====
De transactie is opgebouwd uit een laag met bouwstenen en een presentatielaag om usecase specifieke wensen ten aanzien van de presentatielaag te scheiden van de generieke technische onderlaag. Door deze generieke onderlaag kan de interoperabiliteit tussen domeinen worden gewaarborgd en kunnen in de toekomst vanuit dezelfde dataset meerdere domeinen en usecases worden ondersteund. Hieronder volgt een toelichting per laag van de transactie.

====Bouwstenen====
De bouwstenen laag bestaat uit een set herbruikbare bouwstenen die binnen 1 of meerdere domeinen of usecases hergebruikt kunnen worden in de domein of usecase specifieke presentatielaag. Een bouwsteen kan: 1. een exacte kopie zijn van een bestaande zib, 2. afgeleid zijn van een bestaande zib en verrijkt met domein en usecase specifieke eisen of 3. geen enkele relatie hebben met een bestaande zib. In de meeste gevallen zal gebruik gemaakt worden van bouwstenen die zijn afgeleid van de zib, tenzij de bestaande zib al voor 100% volstaat of er geen bestaande zib beschikbaar is. De transactie geeft aan welke onderdelen van een bouwsteen in de betreffende usecase relevant zijn.

Onderstaande afbeelding geeft een voorbeeld van de bouwsteen Contact. Deze bouwsteen is afgeleid van de zib Contact, waarbij een aantal extra elementen zijn toegevoegd, zoals ContactSoort en ContactVorm.

[[Bestand:JGZ BDSV bouwsteen contact.png|300px]]

====Presentatieset====
De presentatielaag beschrijft de set van gegevens, zoals deze aan de voorkant gepresenteerd zal worden, in dit geval BDS V JGZ.

Onderstaande afbeelding geeft een voorbeeld van een verwijzing naar de bouwsteen Contact vanuit de presentatielaag. Binnen de JGZ worden Contacten en Cliëntbesprekingen gepresenteerd in het dossierdeel Activiteiten. Merk op dat in dit voorbeeld wordt verwezen naar de bouwsteen Patiëntbespreking. Ondanks deze benaming in de transactie, afkomstig uit de zib, zal deze aan de voorkant als cliëntbespreking gepresenteerd worden.

[[Bestand:Dossierdeel_Activiteiten.PNG|Dossierdeel_Activiteiten|300px]]

=====Administratieve deel=====
Onderstaande figuur toont de dossierdelen in het administratieve deel van het dossier inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Dossierinformatie en Aanmeldgegevens.

[[Bestand:BDS-V_Administratief.png|BDS V Administratief|900px]]

=====Episode-items=====
Onderstaande figuur is een weergave van de episode-items inclusief de onderliggende bouwstenen. De legoblokken verwijzen naar de bouwstenen. Daarnaast zijn er setjes gegevens die niet binnen een bouwsteen zijn gemodelleerd, zoals Anamnese en VerloopZwangerschap. In het figuur zijn de relaties zichtbaar tussen de episode-items en de zorgepisodes, activiteiten, zwangerschapsgegevens en overige bouwstenen. Het dossierdeel Vaccinatie is in het grijs weergegeven, omdat deze geen onderdeel is van de huidige publicatie.

[[Bestand:BDS V episode-items - alpha.3.png|BDS V Episode-Items|900px]]

=====Relaties=====
In de dataset kan vanuit een bouwsteen of dossierdeel een relatie worden gelegd naar een andere bouwsteen. Dit gebeurt door middel van een relatie, zoals bijvoorbeeld ‘RelatieZorgEpisode’. Daarin wordt door middel van een identificatienummer gerefereerd naar een specifieke instantiatie van de bouwsteen ZorgEpisode. Op deze manier kunnen episode-items bijvoorbeeld gerelateerd worden aan zorgepisodes. Dit biedt ook de mogelijkheid om specifieke queries te doen, bijvoorbeeld alle episode-items die aan een specifieke zorgepisode gerelateerd zijn.

BDS V JGZ kent onderstaande relaties:

* RelatieZorgEpisode: gebruikt in alle episode-items, Zwangerschap, Aanmelding
* RelatieContact: gebruikt in alle episode-items
* RelatiePatiëntbespreking (RelatieCliëntbespreking): gebruikt in alle episode-items
* RelatieZwangerschap: gebruikt in VerloopZwangerschap

====Transactie====
Hieronder is de inhoud van de transactie weergegeven. Deze informatie is ook in een [https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20250604T101158/scenarios.html nieuw tabblad] te openen.

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/jeugdgezondheidszorg/jgz-html-20250604T101158/tr-2.16.840.1.113883.2.4.3.11.60.100.4.60-2024-07-23T000000.html frameborder="0" align="middle"></iframe>
</html>

= Aanvullende informatie =

Voor de eenheid van taal wordt zo veel mogelijk [https://www.nictiz.nl/standaardisatie/terminologiecentrum/snomed-ct/ SNOMED] gebruikt. Aanvullende uitleg over de gebruite codes en waardelijsten is te lezen op het [https://informatiestandaarden.nictiz.nl/wiki/jgz:V0.1_Ontwerp_BDSV/UitlegWaardelijsten overzicht waardelijsten met bijzonderheden].

=Release notes=
In onderstaande tabel staan de wijzigingen voor dit ontwerp:
{{#lsth:Tabellen met release notes|BDS V 0.1}}

Bestand:BDS V dossier - alpha.4 - V1.png

2025-10-23T09:35:27Z

Ahsen Yurt:

MedMij:Vprepub-2020.01/Geboortezorg 3.2 - kwalificatie MedMij - Raadplegen Integrale Zwangerschapskaart 2.0 Echo

2025-08-26T14:53:10Z

Ahsen Yurt: MM-5635: Op alle GZ/IZK pagina’s is ‘IZK 2.0’ vervangen door een updatend versienummer.

MedMij:V2020.01/Geboortezorg 3.2 - kwalificatie MedMij - Raadplegen Integrale Zwangerschapskaart 2.0 Echo

2025-08-26T14:53:10Z

Ahsen Yurt: MM-5635: Op alle GZ/IZK pagina’s is ‘IZK 2.0’ vervangen door een updatend versienummer.

MedMij:Vprepub-2020.01/Geboortezorg 3.2 - kwalificatie MedMij - Beschikbaarstellen Integrale Zwangerschapskaart 2.0 Echo

2025-08-26T14:52:00Z

Ahsen Yurt: MM-5635: Op alle GZ/IZK pagina’s is ‘IZK 2.0’ vervangen door een updatend versienummer.