Brontekst bekijken van imm:Vissue-VI-69 Ontwerp Vaccinatie-Immunisatie

{{IssuePaginaWaarschuwing|VI-69|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. 
<br>Daarnaast is er een voorlopige [[Media:Richtlijn Deduplicatie MedMij gegevensdienst Vaccinaties 2.0.pdf|richtlijn Deduplicatie]] opgesteld. Het doel van deze richtlijn is PGO-leveranciers richting te geven in de wijze waarop zij PGO-gebruikers kunnen attenderen op mogelijk dubbel getoonde vaccinaties.

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
|}
<font size = "1">'''Bedrijfsrollen Vaccinaties'''</font>

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

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

<font size = "1">'''Activiteitendiagram Raadplegen Vaccinaties'''</font>

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

<font size = "1">'''Componenten diagram van systemen en systeemrollen'''</font>

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

Er zijn géén specifieke filtermogelijkheden (queryparameters) gedefinieerd voor het raadplegen van Vaccinaties. Bij het raadplegen van Vaccinaties wordt om alle gegevens behorende bij de persoon gevraagd.

====Beschikbaarstellen Vaccinaties====

Dit betreft de inhoud van de transactie opleveren van Vaccinaties.
Uitgangspunt voor de transactie zijn de concepten en kardinaliteiten van de zibs Vaccinatie en de bijbehorende Patiënt. Met de buiten de zibs gemodelleerde datavelden StatusToediening en VaccinatieIndicatie. 

Informatie-elementen in de usecase staan hieronder. Deze informatie is ook in een 
[https://decor.nictiz.nl/pub/immunisatie/imm-html-20240604T065227/ds-2.16.840.1.113883.2.4.3.11.60.131.1.1-2021-11-18T100634.html nieuw tabblad] te openen.
Bij het beschikbaarstellen van deze usecase worden alle beschikbare gegevens behorende bij de burger die relevant geacht worden beschikbaargesteld.

<html>
<iframe width="100%" height="800" src=
https://decor.nictiz.nl/pub/immunisatie/imm-html-20240729T142005/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]]

<font size = "1">'''Usecase diagram inzien Vaccinaties</font>

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