informatiestandaarden - Gebruikersbijdragen [nl]

MedMij:Vdraft PilotIZK

2022-11-03T16:38:54Z

Camiel Reijnders:

{{DISPLAYTITLE:Pilot Integrale Zwangerschapskaart}}
{{NoteBox|1= Voor meer informatie betreffende de pilot integrale zwangerschapskaart met betrekking tot PGO implementaties in regio Noord-Nederland, raadpleegt u de '''[https://gebruikers.babyconnect.org/cms/view/ec551398-495f-400d-b5a4-e92906a91302/pgo speciale website]''' van Babyconnect.}}

MedMij:Vdraft PilotIZK

2022-11-03T16:26:47Z

Camiel Reijnders: Voorstel

{{DISPLAYTITLE:Pilot Integrale Zwangerschapskaart}}
{{NoteBox|1= Voor meer informatie betreffende de pilot integrale zwangerschapskaart met betrekking tot de PGO implementaties in regio Noord-Nederland? Raadpleeg dan de '''[https://gebruikers.babyconnect.org/cms/view/ec551398-495f-400d-b5a4-e92906a91302/pgo speciale website]''' van Babyconnect.}}

MedMij:Vdraft PilotIZK

2022-11-03T16:13:54Z

Camiel Reijnders: Nieuwe pagina aangemaakt met '{{DISPLAYTITLE:Pilot Integrale Zwangerschapskaart}} {{NoteBox|1= Ontwerpen van deze standaarden die voor MedMij geldig zijn, staan in de '''MedMij:Vcurrent_Ontwer...'

{{DISPLAYTITLE:Pilot Integrale Zwangerschapskaart}}
{{NoteBox|1= Ontwerpen van deze standaarden die voor MedMij geldig zijn, staan in de '''[[MedMij:Vcurrent_Ontwerpen|actuele publicatie]]'''. Wil je toch graag de V2019.01-ontwerpen van deze informatiestandaarden inzien? Je vindt ze via de onderstaande links.}}

MedMij:Vprepub-2020.01/Kwalificatie

2021-08-27T10:22:43Z

Camiel Reijnders: MM-2316: De hyperlinks naar de kwalificatiescripts (nu wiki-pagina's) aangepast

{{MedMij:Vprepub-2020.01/Issuebox}}
__NUMBEREDHEADINGS__





=Introductie=
Nictiz beheert voor Stichting MedMij de informatiestandaarden die binnen MedMij gebruikt worden. Om de informatiestandaarden te kunnen toepassen binnen MedMij, zijn gegevensdiensten gedefinieerd die bestaan uit één of meerdere systeemrollen vanuit een informatiestandaard. Stichting MedMij omschrijft de gegevensdiensten en bepaalt vanaf wanneer en tot hoelang de gegevensdienst op het MedMij-netwerk gebruikt kan worden. Dit doet Stichting MedMij in samenspraak met Nictiz als beheerder. Voor een actueel overzicht van gegevensdiensten, met een verwijzing naar kwalificatie-informatie per systeemrol, raadpleeg de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus].

Voor het implementeren van informatiestandaarden en daaruit de gedefinieerde gegevensdiensten voor MedMij, is een Nictiz kwalificatie van toepassing. De kwalificaties worden uitgevoerd door het kwalificatiecentrum van Nictiz en vinden plaats per systeemrolcode. De systeemrolcode vormt de koppeling van een (MedMij) informatiestandaard aan een, in de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus] vermelde, gegevensdienst van het MedMij-netwerk.

Kwalificatiescripts en meer informatie over een kwalificatie zijn te vinden via de betreffende paragrafen onder [[MedMij:Vprepub-2020.01/Kwalificatie#Kwalificatiebenodigdheden|kwalificatiebenodigdheden]].<section end=medmij_kwalificatie_introductie />

Voor een optimaal verloop van de kwalificatie is het belangrijk dat via de juiste kanalen wordt gecommuniceerd. Raadpleeg hiervoor het onderstaand communicatiekanalenoverzicht:
* Procedure en planninggerelateerde vragen: [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl]
* Inhoudelijke vragen of opmerkingen over de implementatie van informatiestandaarden en gegevensdiensten: [https://bits.nictiz.nl/projects/MM BITS]
* Algemene vragen MedMij: [mailto:info@medmij.nl info@medmij.nl]

In onze [[MedMij:Vprepub-2020.01/Kwalificatie_FAQ|FAQ]] tref je de veelgestelde vragen tijdens het kwalificatietraject.

Het kwalificatiecentrum biedt ook aanvullende dienstverlening voor Stichting MedMij. Wijzigingen bij DVZA’s of DVP’s die een hoog risico vormen voor de interoperabiliteit en kwaliteit van de gegevensuitwisseling kunnen vrijblijvend worden geherkwalificeerd. Herkwalificatie kan noodzakelijk zijn indien:
* Eén van de bronsystemen wordt vervangen door een andere applicatie;
* Een versie-update aan de kant van het het bronsysteem en/of overige betrokken partijen van toepassing is;
* Er een grote update plaatsvindt aan de kant van de DVZA of DVP.

Voor het inplannen van een herkwalificatie kan contact opgenomen worden met [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl]

== Kwalificatie gebruik van terminologie ==
Op de kwalificatiepagina wordt gesproken over DVP en PGO of DVZA en XIS. <br>
Een DVP dient altijd te kwalificeren met een PGO en een DVZA dient altijd te kwalificeren met achterliggend bronsysteem of bronsystemen (XIS).

{| class="wikitable"
|-
| '''DVP''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert een Persoonlijke gezondheidsomgeving, een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''DVZA''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert Diensten aan de Zorgaanbieder gerelateerd aan de uitwisseling tussen Persoon en Zorgaanbieder en committeert zich hiervoor aan de naleving van de afspraken van het MedMij Afsprakenstelsel.
|-
| '''Persoonsdomein''' || Alle Personen en alle Dienstverleners personen vormen samen het Persoonsdomein.
|-
| '''PGO''' || Een Persoonlijke gezondheidsomgeving is een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''XIS''' || Het systeem of geheel van de systemen waarin de zorgaanbieder het medisch dossier van de persoon bijhoudt.
|-
| '''Zorgaanbiedersdomein''' || Alle Zorgaanbieders en alle Dienstverleners zorgaanbieder vormen samen het Zorgaanbiedersdomein.
|}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [[MedMij:Vprepub-2020.01/Ontwerpen|MedMij informatiestandaard]], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in de [[MedMij:Vprepub-2020.01/Kwalificatie#Kwalificatiescripts|kwalificatiedocumentatie]] als onderdeel van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
Naast de bovengenoemde algemene voorwaarden voor kwalificatie dient een kwalificerende (kandidaat-) deelnemer ook te voldoen aan de procedurele eisen voor kwalificatie. Om het kwalificatietraject niet onnodig te vertragen wordt van een (kandidaat-) deelnemer verwacht dat deze de onderstaande procedurele eisen in acht neemt.

* Indien niet kan worden voldaan aan de functionele en/of technische eisen van een gegevensdienst, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Indien gebruik gemaakt wordt van de vrijheidsgraden die de gegevensdiensten BgGGZ, BgLZ, BgZ en PDF/a bieden, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* De testexecutie dient 100% succesvol geslaagd te zijn voordat gestart kan worden met de kwalificatie. Indien dit niet het geval is dient dit '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Het uitgevoerde certificering-testscript dient niet ouder te zijn dan één week voor de aanlevering van het (pre)kwalificatiemateriaal. Nictiz staat in zijn recht om te bepalen of een test executie is verouderd en daarom af te wijzen.
* Bij het instellen van een variabele T datum door een DVZA, dient de datum gelijk te zijn aan de datum waarop de Touchstone testexecutie is uitgevoerd.
* Voor zowel DVP als DVZA geldt dat de schermafdrukken overeen dienen te komen met de uitgevoerde Touchstone testexecutie die is bijgevoegd in het aanleverformat. Wanneer hier niet aan wordt voldaan leidt dit tot een afwijzing.
* Het kwalificatiemateriaal dient in het juiste formaat aangeleverd te worden. Gebruik voor het aanleveren van het kwalificatiemateriaal altijd het aanleverformat behorende bij de gegevensdienst. In het aanleverformat staat per dia beschreven welke schermafdruk wordt verwacht.
** Voor een DVP geldt dat er schermafdrukken gemaakt dienen te worden van de interface van een PGO.
** Voor een DVZA geldt dat er schermafdrukken gemaakt dienen te worden (van de combinatie) van de achterliggende bronsystemen waarmee men kwalificeert. '''Let op''': Wanneer men voor een nieuwe combinatie van bronsystemen acht te kwalificeren wordt dit behandeld als een nieuwe kwalificatie waarbij ook van die nieuwe combinatie schermafdrukken dienen te worden gemaakt. Schermafdrukken van andere interfaces zoals van een XDS worden afgekeurd.

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
Nictiz stelt het testsysteem Touchstone beschikbaar voor het testen van systeemrollen met bijbehorende MedMij gegevensdiensten als voorbereiding op het kwalificatieproces.
<br>MedMij (kandidaat-) deelnemers kunnen Touchstone eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.
* Documentatie over het aansluiten op Touchstone is te vinden op de pagina Kwalificatie aansluiten in de sectie [[MedMij:Vprepub-2020.01/Kwalificatie_aansluiten#Configureren_simulator|configureren simulator]].
* Voor uitleg over gebruik van de simulator en tokens, zie [[MedMij:Vprepub-2020.01/Qualification | gebruik tokens]]
<section end=medmij_kwalificatie_introductie />
<span id="Kwalificatiescripts"></span><section begin=medmij_kwalificatiescripts />

=Kwalificatiebenodigdheden=
Het kwalificatiemateriaal voor de meest recente versies van de verschillende systeemrollen met bijbehorende MedMij gegevensdiensten is in dit hoofdstuk te vinden.
<br> Voor een actueel overzicht van gegevensdiensten, met een verwijzing naar kwalificatie-informatie per systeemrol, raadpleeg de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus].

=Kwalificatiescripts=
==Basisgegevensset Zorg 3.0==
* [[MedMij:Vprepub-2020.01/BgZ_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ]]
* [[MedMij:Vprepub-2020.01/BgZ_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen BgZ]]
* [[Media: Aanleverformat - Beschikbaarstellen_BgZ_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen_BgZ.zip]]
* [[Media: Aanleverformat - Raadplegen BgZ_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen BgZ.zip]]
* [[Media: Beoordelingsformulier_BasisgegevenssetZorg_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevenssetZorg_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen BgZ.pdf]]

===Uitgebreide gegevensset===
Nota bene: onderstaande kwalificatiescripts bevatten een uitgebreidere gegevens set voor de BgZ. Deze worden '''niet''' gebruikt voor kwalificatie.

* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BGZ extended.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf]]

==Labuitwisseling 2.0==
* [[MedMij:Vprepub-2020.01/Laboratoriumresultaten_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten]]
* [[MedMij:Vprepub-2020.01/Laboratoriumresultaten_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten]]
* [[Media: Aanleverformat_-_Beschikbaarstellen_Laboratoriumresultaten_V2020.01_20210528.pptx.zip |3. Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip]]
* [[Media: Aanleverformat - Raadplegen Laboratoriumresultaten_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen Laboratoriumresultaten.zip]]
* [[Media: Beoordelingsformulier_Laboratoriumresultaten_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Beoordelingsformulier_Laboratoriumresultaten_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen Laboratoriumresultaten.pdf]]

==AllergieIntolerantie 2.0==

===AllergieIntolerantie===
* [[MedMij:Vprepub-2020.01/kw-MM-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens]]
* [[MedMij:Vprepub-2020.01/kw-MM-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantie_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantie_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen AllergieIntolerantie.zip]]
* [[Media: Beoordelingsformulier_AllergieIntolerantie_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen AllergieIntolerantie.pdf]]
* [[Media: Beoordelingsformulier_AllergieIntolerantie_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen AllergieIntolerantie.pdf]]

===AllergieIntolerantieVertaling===
* [[MedMij:Vprepub-2020.01/kw-MM-1.A-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[MedMij:Vprepub-2020.01/kw-MM-1.A-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantieVertaling_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantieVertaling_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Beoordelingsformulier_AllergieIntolerantieVertaling_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.pdf]]
* [[Media: Beoordelingsformulier_AllergieIntolerantieVertaling_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.pdf]]

==eAfspraak 2.0==
* [[MedMij:Vprepub-2020.01/eAfspraak_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen eAfspraak]]
* [[MedMij:Vprepub-2020.01/eAfspraak_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak]]
* [[Media:Aanleverformat - Raadplegen eAfspraak_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen eAfspraak.zip]]
* [[Media:Aanleverformat - Beschikbaarstellen eAfspraak_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen eAfspraak.zip]]

==Zelfmetingen 2.0==
* [[MedMij:Vprepub-2020.01/Zelfmetingen_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen]]
* [[MedMij:Vprepub-2020.01/Zelfmetingen_Ontvangen|1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen]]
* [[MedMij:Vprepub-2020.01/Zelfmetingen_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen]]
* [[MedMij:Vprepub-2020.01/Zelfmetingen_Sturen|1. Kwalificatiescript - MedMij Sturen Zelfmetingen]]
* [[Media: Aanleverformat - Beschikbaarstellen Zelfmetingen_V2020.01_20210324_v2.zip|3. Aanleverformat - Beschikbaarstellen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Ontvangen Zelfmetingen_V2020.01_20210324_v2.zip|3. Aanleverformat - Ontvangen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Raadplegen Zelfmetingen_V2020.01_20210324_v2.zip|3. Aanleverformat - Raadplegen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Sturen Zelfmetingen_V2020.01_20210324_v2.zip|3. Aanleverformat - Sturen Zelfmetingen.zip]]
* [[Media: Beoordelingsformulier_Zelfmetingen_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media: Beoordelingsformulier_Zelfmetingen_Ontvangen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media: Beoordelingsformulier_Zelfmetingen_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media: Beoordelingsformulier_Zelfmetingen_Sturen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Sturen Zelfmetingen.pdf]]

==PDF/A 3.0==
* [[MedMij:Vprepub-2020.01/PDFA_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA]]
* [[MedMij:Vprepub-2020.01/PDFA_Ontvangen|1. Kwalificatiescript - MedMij Ontvangen PDFA]]
* [[MedMij:Vprepub-2020.01/PDFA_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen PDFA]]
* [[MedMij:Vprepub-2020.01/PDFA_Sturen|1. Kwalificatiescript - MedMij Sturen PDFA]]
* [[Media:3._Aanleverformat_-_Beschikbaarstellen_PDFA_20210519_V2020.01.zip|3. Aanleverformat - Beschikbaarstellen PDFA.zip]]
* [[Media:3._Aanleverformat_-_Ontvangen_PDFA_20210519_V2020.01.zip|3. Aanleverformat - Ontvangen PDFA.zip]]
* [[Media:3._Aanleverformat_-_Raadplegen_PDFA_20210519_V2020.01.zip|3. Aanleverformat - Raadplegen PDFA.zip]]
* [[Media:3._Aanleverformat_-_Sturen_PDFA_20210519_V2020.01.zip|3. Aanleverformat - Sturen PDFA.zip]]
* [[Media: Beoordelingsformulier_PDFA_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media: Beoordelingsformulier_PDFA_Ontvangen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Ontvangen PDFA.pdf]]
* [[Media: Beoordelingsformulier_PDFA_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen PDFA.pdf]]
* [[Media: Beoordelingsformulier_PDFA_Sturen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Sturen PDFA.pdf]]
* [[Media: PDFA Example Documents.zip|5. Voorbeelddocumenten PDFA voor use case Beschikbaarstellen]]

==Huisartsgegevens 2.0==
* [[MedMij:Vprepub-2020.01/Huisartsgegevens_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens]]
* [[MedMij:Vprepub-2020.01/Huisartsgegevens_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens]]
* [[Media: Aanleverformat - Beschikbaarstellen huisartsgegevens_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen huisartsgegevens.zip]]
* [[Media: Aanleverformat - Raadplegen huisartsgegevens_v2020.01_20210324.zip|3. Aanleverformat - Raadplegen huisartsgegevens.zip]]
* [[Media: Beoordelingsformulier_Huisartsgegevens_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Huisartsgegevens .pdf]]
* [[Media: Beoordelingsformulier_Huisartsgegevens_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen Huisartsgegevens .pdf]]

==Basisgegevens GGZ 2.0==
* [[MedMij:Vprepub-2020.01/Basisgegevens_GGZ_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ]]
* [[MedMij:Vprepub-2020.01/Basisgegevens_GGZ_Raadplegen |1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ]]
* [[Media: Aanleverformat - Beschikbaarstellen Basisgegevens GGZ_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip]]
* [[Media: Aanleverformat - Raadplegen Basisgegevens GGZ_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen Basisgegevens GGZ.zip]]
{{NoteBox|[[Media: (Verkort) Aanleverformat - Raadplegen Basisgegevens GGZ_V2020.01_20210731.zip| 3. (verkort) Aanleverformat - Raadplegen Basisgegevens GGZ.zip]]
Let op! (Alleen) DVP's die reeds voor de BgGGZ V2019.01 zijn gekwalificeerd, komen in aanmerking voor een versnelde kwalificatie op de 2020.01 versie en kunnen gebruik daarmee maken van dit ingekorte aanleverformaat.}}
* [[Media: Beoordelingsformulier_BasisgegevensGGZ_Beschikbaarstellen_24032021_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Raadplegen_24032021_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens GGZ.pdf]]

==Beelden 2.0==
* [[MedMij:Vprepub-2020.01/Beelden_Ontvangen|1. Kwalificatiescript - MedMij Ontvangen beelden]]
* [[MedMij:Vprepub-2020.01/Beelden_Sturen|1. Kwalificatiescript - MedMij Sturen beelden]]
* [[Media:Aanleverformat - Ontvangen Beelden_V2020.01_20210324.zip|3. Aanleverformat - Ontvangen Beelden.zip]]
* [[Media:Aanleverformat - Sturen Beelden_V2020.01_20210324.zip|3. Aanleverformat - Sturen Beelden.zip]]

==Basisgegevens Langdurige Zorg 2.0==
{{NoteBox|1= Meld je bij het Nictiz kwalificatiecentrum (via [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl]) wanneer je voor de Basisgegevens Langdurige Zorg wilt kwalificeren.}}
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg_V2020.01.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg_V2020.01.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]
* [[MedMij:V2020.01/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.1|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1]]
* [[MedMij:V2020.01/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.2|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2]]
* [[MedMij:V2020.01/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.3|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3]]
* [[MedMij:V2020.01/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.4|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.4]]
* [[Media: Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg_V2020.01_20210324.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.zip]]
* [[Media:3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg_V2020.01_20210324.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.zip]]
* [[Media: Beoordelingsformulier_BasisgegevensLangdurigeZorg_Beschikbaarstellen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevensLangdurigeZorg_Raadplegen_20210324_2020.01.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

==Vragenlijsten 2.0==
* [[MedMij:Vprepub-2020.01/Vragenlijstverwijzing_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Vragenlijsten]]
* [[MedMij:Vprepub-2020.01/Vragenlijsten_Ontvangen|1. Kwalificatiescript - MedMij Ontvangen Vragenlijsten]]
* [[MedMij:Vprepub-2020.01/Vragenlijstverwijzing_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Vragenlijsten]]
* [[MedMij:Vprepub-2020.01/Vragenlijsten_Sturen|1. Kwalificatiescript - MedMij Sturen Vragenlijsten]]
* [[Media:Aanleverformat - Beschikbaarstellen vragenlijsten_V2020.01_20210324_v2.zip|3. Aanleverformat - Beschikbaarstellen vragenlijsten.zip]]
* [[Media:Aanleverformat - Ontvangen vragenlijsten_V2020.01_20210324_v2.zip|3. Aanleverformat - Ontvangen vragenlijsten.zip]]
* [[Media:Aanleverformat - Raadplegen vragenlijsten_V2020.01_20210324_v2.zip|3. Aanleverformat - Raadplegen vragenlijsten.zip]]
* [[Media:Aanleverformat - Sturen vragenlijsten_V2020.01_20210324_v2.zip|3. Aanleverformat - Sturen vragenlijsten.zip]]
* [[Media: Beoordelingsformulier_Vragenlijstverwijzing_Raadplegen_20210223.pdf|4. Beoordelingsformulier - MedMij Raadplegen Vragenlijstverwijzing.pdf]]
* [[Media: Beoordelingsformulier_Vragenlijstantwoorden_Sturen_20210223.pdf|4. Beoordelingsformulier - MedMij Sturen Vragenlijstantwoorden.pdf]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:V2020.01/Kwalificatie

2021-08-27T10:22:43Z

Camiel Reijnders: MM-2316: De hyperlinks naar de kwalificatiescripts (nu wiki-pagina's) aangepast

MedMij:V2020.02/Kwalificatie

2021-08-27T10:11:47Z

Camiel Reijnders: /* Basisgegevens Langdurige Zorg 3.0 */

__NOINDEX__
__NUMBEREDHEADINGS__
{{NoteBox|1= Deze pagina bevat verwijzingen naar kwalificatiematerialen van MedMij publicatie 2020.02, waarin uitsluitend Basisgegevens Langdurige Zorg is opgenomen. Voor de kwalificatiematerialen van de overige gegevensdiensten zie [[MedMij:V2020.01/Kwalificatie|Kwalificatie MedMij publicatie 2020.01]].}}




=Introductie=
{{#lsth:MedMij:V2020.01/Kwalificatie|Introductie}}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [[MedMij:Vprepub-2020.01/Ontwerpen|MedMij informatiestandaard]], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in de [[MedMij:Vprepub-2020.02/Kwalificatie#Kwalificatiescripts|kwalificatiedocumentatie]] als onderdeel van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
{{#lsth:MedMij:V2020.01/Kwalificatie|Procedurele eisen voor kwalificatie}}

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
{{#lsth:MedMij:V2020.01/Kwalificatie|Kwalificatie aansluiten op Touchstone}}

=Kwalificatiebenodigdheden=
{{#lsth:MedMij:V2020.01/Kwalificatie|Kwalificatiebenodigdheden}}

=Kwalificatiescripts=
{{NoteBox|1= Deze pagina bevat verwijzingen naar kwalificatiematerialen van MedMij publicatie 2020.02, waarin uitsluitend Basisgegevens Langdurige Zorg is opgenomen. Voor de kwalificatiematerialen van de overige gegevensdiensten zie [[MedMij:V2020.01/Kwalificatie|Kwalificatie MedMij publicatie 2020.01]].}}
==Basisgegevens Langdurige Zorg 3.0==
* [[MedMij:Vprepub-2020.02/Basisgegevens_Langdurige_Zorg_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg]]
* [[MedMij:Vprepub-2020.02/Basisgegevens_Langdurige_Zorg_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg]]
* [[Media: Aanleverformat_-_Beschikbaarstellen_Basisgegevens_Langdurige_Zorg_2020.02_20210324.pdf.pptx.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg]]
* [[Media: Aanleverformat_-_Raadplegen_Basisgegevens_Langdurige_Zorg_2020.02_20210324.pdf.pptx.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg]]
* [[Media: Beoordelingsformulier_ BasisgegevensLangdurigeZorg_Beschikbaarstellen_20210324_2020.02.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevensLangdurigeZorg_Raadplegen_20210324_2020.02.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:Vprepub-2020.02/Kwalificatie

2021-08-27T10:11:47Z

Camiel Reijnders: /* Basisgegevens Langdurige Zorg 3.0 */

MedMij:V2020.02/Kwalificatie

2021-08-26T10:16:45Z

Camiel Reijnders: MM-2316: De hyperlinks naar de kwalificatiematerialen (nu wiki-pagina's) aangepast

__NOINDEX__
__NUMBEREDHEADINGS__
{{NoteBox|1= Deze pagina bevat verwijzingen naar kwalificatiematerialen van MedMij publicatie 2020.02, waarin uitsluitend Basisgegevens Langdurige Zorg is opgenomen. Voor de kwalificatiematerialen van de overige gegevensdiensten zie [[MedMij:V2020.01/Kwalificatie|Kwalificatie MedMij publicatie 2020.01]].}}




=Introductie=
{{#lsth:MedMij:V2020.01/Kwalificatie|Introductie}}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [[MedMij:Vprepub-2020.01/Ontwerpen|MedMij informatiestandaard]], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in de [[MedMij:Vprepub-2020.02/Kwalificatie#Kwalificatiescripts|kwalificatiedocumentatie]] als onderdeel van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
{{#lsth:MedMij:V2020.01/Kwalificatie|Procedurele eisen voor kwalificatie}}

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
{{#lsth:MedMij:V2020.01/Kwalificatie|Kwalificatie aansluiten op Touchstone}}

=Kwalificatiebenodigdheden=
{{#lsth:MedMij:V2020.01/Kwalificatie|Kwalificatiebenodigdheden}}

=Kwalificatiescripts=
{{NoteBox|1= Deze pagina bevat verwijzingen naar kwalificatiematerialen van MedMij publicatie 2020.02, waarin uitsluitend Basisgegevens Langdurige Zorg is opgenomen. Voor de kwalificatiematerialen van de overige gegevensdiensten zie [[MedMij:V2020.01/Kwalificatie|Kwalificatie MedMij publicatie 2020.01]].}}
==Basisgegevens Langdurige Zorg 3.0==
* [[MedMij:Vissue-MM-2305/Basisgegevens_Langdurige_Zorg_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg]]
* [[MedMij:Vissue-MM-2305/Basisgegevens_Langdurige_Zorg_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg]]
* [[Media: Aanleverformat_-_Beschikbaarstellen_Basisgegevens_Langdurige_Zorg_2020.02_20210324.pdf.pptx.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg]]
* [[Media: Aanleverformat_-_Raadplegen_Basisgegevens_Langdurige_Zorg_2020.02_20210324.pdf.pptx.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg]]
* [[Media: Beoordelingsformulier_ BasisgegevensLangdurigeZorg_Beschikbaarstellen_20210324_2020.02.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevensLangdurigeZorg_Raadplegen_20210324_2020.02.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:Vprepub-2020.02/Kwalificatie

2021-08-26T10:16:45Z

Camiel Reijnders: MM-2316: De hyperlinks naar de kwalificatiematerialen (nu wiki-pagina's) aangepast

__NOINDEX__
__NUMBEREDHEADINGS__
{{NoteBox|1= Deze pagina bevat verwijzingen naar kwalificatiematerialen van MedMij publicatie 2020.02, waarin uitsluitend Basisgegevens Langdurige Zorg is opgenomen. Voor de kwalificatiematerialen van de overige gegevensdiensten zie [[MedMij:V2020.01/Kwalificatie|Kwalificatie MedMij publicatie 2020.01]].}}




=Introductie=
{{#lsth:MedMij:V2020.01/Kwalificatie|Introductie}}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [[MedMij:Vprepub-2020.01/Ontwerpen|MedMij informatiestandaard]], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in de [[MedMij:Vprepub-2020.02/Kwalificatie#Kwalificatiescripts|kwalificatiedocumentatie]] als onderdeel van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
{{#lsth:MedMij:V2020.01/Kwalificatie|Procedurele eisen voor kwalificatie}}

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
{{#lsth:MedMij:V2020.01/Kwalificatie|Kwalificatie aansluiten op Touchstone}}

=Kwalificatiebenodigdheden=
{{#lsth:MedMij:V2020.01/Kwalificatie|Kwalificatiebenodigdheden}}

=Kwalificatiescripts=
{{NoteBox|1= Deze pagina bevat verwijzingen naar kwalificatiematerialen van MedMij publicatie 2020.02, waarin uitsluitend Basisgegevens Langdurige Zorg is opgenomen. Voor de kwalificatiematerialen van de overige gegevensdiensten zie [[MedMij:V2020.01/Kwalificatie|Kwalificatie MedMij publicatie 2020.01]].}}
==Basisgegevens Langdurige Zorg 3.0==
* [[MedMij:Vissue-MM-2305/Basisgegevens_Langdurige_Zorg_Beschikbaarstellen|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg]]
* [[MedMij:Vissue-MM-2305/Basisgegevens_Langdurige_Zorg_Raadplegen|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg]]
* [[Media: Aanleverformat_-_Beschikbaarstellen_Basisgegevens_Langdurige_Zorg_2020.02_20210324.pdf.pptx.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg]]
* [[Media: Aanleverformat_-_Raadplegen_Basisgegevens_Langdurige_Zorg_2020.02_20210324.pdf.pptx.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg]]
* [[Media: Beoordelingsformulier_ BasisgegevensLangdurigeZorg_Beschikbaarstellen_20210324_2020.02.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevensLangdurigeZorg_Raadplegen_20210324_2020.02.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:V2020.02/OntwerpLangdurigeZorg

2021-05-28T14:06:07Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Basisgegevens Langdurige Zorg {{VersieInfo|BgLZ}}}}

[[Bestand:BgLZ-icon.png|link=|links|95px|Use case BgLZ|BgLZ]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub-2020.02/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub-2020.02/FHIR_BGLZ|Technisch]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de uitwisseling van Basisgegevens Langdurige Zorg (BgLZ) op basis van een selectie zorginformatiebouwstenen (zibs) binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:Vprepub-2020.02/Ontwerpen|hier]] gevonden worden.

Binnen het [https://www.dus-i.nl/subsidies/inzicht InZicht programma] (VIPP langdurige zorg) zijn een drietal modules opgenomen.
* Module PGO: de Basisgegevens Langdurige Zorg is bedoeld voor deze module
* Module [https://www.nictiz.nl/standaardisatie/informatiestandaarden/verpleegkundige-overdracht eOverdracht] (gericht op de verpleegkundige overdracht tussen zorgprofessionals)
* Module Medicatieveiligheid: hiervoor wordt verwezen naar het [[MedMij:V2020.01/OntwerpMedicatie| functioneel ontwerp]] voor [https://www.nictiz.nl/programmas/medicatieproces Medicatieproces 9.0].

De Basisgegevens Langdurige Zorg bestaat uit gegevens die relevant zijn voor uitwisseling met patiënten binnen de langdurige zorg via hun [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO). De Basisgegevens Langdurige Zorg vertoont enige overlap met de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/basisgegevensset-zorg-bgz/ Basisgegevensset Zorg (BgZ)] en [https://www.nictiz.nl/standaardisatie/informatiestandaarden/verpleegkundige-overdracht eOverdracht] maar is zeker niet hetzelfde: zie [[MedMij:Vprepub-2020.02/OntwerpLangdurigeZorg#Informatie| Informatie]] voor een nadere toelichting over het samenstellen van de inhoud.

Het doel van deze pagina is om de uitwisseling van de Basisgegevens Langdurige Zorg met de patiënt te omschrijven.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen, die [[MedMij:Vprepub-2020.02/Ontwerpen#Doelgroep| hier]] gevonden kan worden.

==Kaders en uitgangspunten==
===Richtlijn===
Conform specificaties genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: Basisgegevens Langdurige Zorg versie {{VersieInfo|BgLZ}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.02/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.02/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub-2020.02/Ontwerpen|medmij_kwalificatie_introductie}}

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen Langdurige Zorg' en 'Beschikbaarstellen Langdurige Zorg' is te vinden in [[MedMij:Vprepub-2020.02/ToelichtingKwalificatieLangdurigeZorg| Toelichting Kwalificatie BgLZ]].

=Use Cases=
==Use case 1: Raadplegen Basisgegevens Langdurige Zorg in persoonlijke gezondheidsomgeving==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de Basisgegevens Langdurige Zorg die over henzelf gaan.

=== Domein ===
Basisgegevens Langdurige Zorg in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de Basisgegevens Langdurige Zorg vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie,
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De Basisgegevens Langdurige Zorg bestaat uit een selectie van 14 zibs zoals te vinden in dit [[MedMij:Vprepub-2020.02/InhoudLangdurigeZorg|overzicht]]. Deze zibs vormen samen een verzameling van gegevens die patiënten binnen de langdurige zorg zelf relevant vinden om via hun PGO in te zien, zoals bepaald tijdens een aantal veldverkenningen met zowel patiënten als zorgprofessionals. De Basisgegevens Langdurige Zorg komt voor een deel overeen met de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/basisgegevensset-zorg-bgz/ Basisgegevensset Zorg (BgZ)] en [https://www.nictiz.nl/standaardisatie/informatiestandaarden/verpleegkundige-overdracht/ eOverdracht], maar voor een deel ook niet: het gaat om drie aparte sets. Zie het [[MedMij:Vprepub-2020.02/InhoudLangdurigeZorg|overzicht van de inhoud]] voor een nadere toelichting.

Medicatiegegevens vallen buiten de Basisgegevens Langdurige Zorg, omdat hiervoor gebruik wordt gemaakt van het reeds bestaande [https://www.nictiz.nl/programmas/medicatieproces Medicatieproces 9.0] (zie [[MedMij:V2020.01/OntwerpMedicatie|uitwisseling medicatiegegevens]] in PGO).

In de MedMij FHIR implementatiegids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2020.02/FHIR_BGLZ#List_of_StructureDefinitions overzicht] is te zien welk FHIR profiel bij welke zib hoort.

=== Bedrijfsrollen ===
Deze use case onderscheidt twee bedrijfsrollen, namelijk de ''Patiënt'' en de ''Zorgaanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10" width="100%"
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Bedrijfsrol'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil de eigen Basisgegevens Langdurige Zorg raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt de Basisgegevens Langdurige Zorg beschikbaar
|}
<font size = "1">'''Bedrijfsrollen Basisgegevens Langdurige Zorg'''</font>

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

[[Image:InzienLZ_activity.PNG|Activiteitendiagram Raadplegen Langdurige Zorg]]

<font size = "1">'''Activiteitendiagram Raadplegen Langdurige Zorg'''</font>

=== Procesbeschrijving ===
==== Patient journey - Kenneth van Someren ====
De 'patient journey' van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Kenneth_van_Someren_MedMij.pdf Kenneth van Someren] beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar Basisgegevens Langdurige Zorg.

<blockquote>Op aanraden van zijn dochter heeft Kenneth nu ook een PGO, waarop hij kan zien wanneer de wijkverpleegkundige komt of de huishoudelijke hulp. Als het nodig is kan hij via zijn PGO doorgeven dat hij niet mee eet omdat hij bij een van zijn kinderen eet. De vrijwilligers van de bezorgdienst krijgen dit automatisch doorgegeven.</blockquote>

<blockquote>Hij krijgt een EVV-er (eerst verantwoordelijke verpleegkundige) toegewezen, die samen met Kenneth een zorgleefplan gaat opstellen. Zodra het zorgleefplan compleet is, komt dit beschikbaar in zijn PGO. Daarmee kan Kenneth goed zien welke afspraken er met de instelling zijn gemaakt.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case om gaat is:
* Het systeem van een zorgaanbieder (XIS) stelt de Basisgegevens Langdurige Zorg van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de Basisgegevens Langdurige Zorg tussen het betreffende XIS en het eigen PGO.

De Basisgegevens Langdurige Zorg, of een gedeelte van de Basisgegevens Langdurige Zorg, welke de persoon wil inzien, bestaat en de zorgaanbieder wil deze beschikbaarstellen.
:Soms zijn er valide redenen om de Basisgegevens Langdurige Zorg, of gedeeltes daarvan, tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om de Basisgegevens Langdurige Zorg op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

===== Processtappen =====
* Het systeem van de patiënt (PGO) raadpleegt het systeem van de zorgaanbieder (XIS) voor de Basisgegevens Langdurige Zorg van de patiënt.
* Het systeem van de zorgaanbieder (XIS) maakt (een deel van) de Basisgegevens Langdurige Zorg beschikbaar voor de patiënt.
* De patiënt gebruikt de persoonlijke gezondheidsomgeving om de Basisgegevens Langdurige Zorg in te zien.

===== Postconditie =====
De persoon kan de Basisgegevens Langdurige Zorg inzien via een persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de Basisgegevens Langdurige Zorg van zorgaanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Systeem
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Naam systeemrol
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Systeemrolcode
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| LZRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|BgLZ}}-LZR-FHIR
| style="background-color: white;"| Raadplegen Basisgegevens Langdurige Zorg bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| LZBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|BgLZ}}-LZB-FHIR
| style="background-color: white;"| Beschikbaarstellen Basisgegevens Langdurige Zorg aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:InzienLZ_component.PNG|Componenten diagram]]

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

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

{| class="wikitable" "cellpadding="10"
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Transactiegroep'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Transactie'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Systeemrolcode'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Systeem'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Bedrijfsrol'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|Basisgegevens Langdurige Zorg (PULL)
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/decor/services/RetrieveTransaction?id=2.16.840.1.113883.2.4.3.11.60.58.4.2&effectiveDate=2019-04-09T16:33:35&language=nl-NL&ui=nl-NL&version=2020-10-12T11:53:32&format=html&hidecolumns=34567 Raadplegen Basisgegevens Langdurige Zorg]
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgLZ}}-LZR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub-2020.02/FHIR_BGLZ|Basisgegevens Langdurige Zorg in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/decor/services/RetrieveTransaction?id=2.16.840.1.113883.2.4.3.11.60.58.4.3&effectiveDate=2019-04-09T16:33:35&language=nl-NL&ui=nl-NL&version=2020-10-12T11:53:32&format=html&hidecolumns=34567 Beschikbaarstellen Basisgegevens Langdurige Zorg]
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgLZ}}-LZB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:InzienLZ_usecase.PNG|Use case diagram raadplegen Basisgegevens Langdurige Zorg]]

<font size = "1">'''Use case diagram raadplegen Basisgegevens Langdurige Zorg</font>

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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. Zie de [[MedMij:V2020.01/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
{{ReleaseNotes|package=2020.02 - Maart 2021|release=3.0.3|issues=2|MM-1905|MM-1902}}
{{ReleaseNotes|package=2020.02 - Februari 2021|release=3.0.2|issues=1|MM-1828}}
{{ReleaseNotes|package=2020.02 - November 2020|release=3.0.0|issues=2|MM-1432|MM-1522}}
{{ReleaseNotes|package=2020.01 - September 2020|release=2.0.1|issues=6|MM-1459|MM-1456|MM-1285|MM-1260|MM-1259|MM-1011}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|release=2.0.0|issues=3|MM-972|MM-898|MM-319}}
{{ReleaseNotes|package=2019.01 - April|release=1.0.9|issues=3|MM-1059|MM-1025|MM-939}}
{{ReleaseNotes|package=2019.01 - Maart|release=1.0.7|issues=3|MM-997|MM-953|MM-931}}
|-
| style="background-color: white; | 2019.01 - November
| style="background-color: white; | 1.0.4
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-806 MM-806]
| style="background-color: white;"| Fixed MM-430: adjusted incorrect FHIRPath constraints, moved extension to Consent.extension and moved mappings in extension from extension.value[x].reference to extension.value[x] in zib-TreatmentDirective profile.
|-
| style="background-color: white; | 2019.01 - Oktober
| style="background-color: white; | 1.0.2
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-599 MM-599]
| style="background-color: white;"| URL value on detailCodeableConcept.coding.system in HCIM TreatmentObjective example was incorrect, changed to the correct value.
|-
| style="background-color: white; | 2019.01 - September
| style="background-color: white; | 1.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-358 MM-358]
| style="background-color: white;"| Tekstcorrectie op de kwalificatiepagina's van BgZ, GGZ en BgLZ.
|}

MedMij:Vprepub-2020.02/OntwerpLangdurigeZorg

2021-05-28T14:06:07Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

MedMij:Vprepub-2020.01/OntwerpLangdurigeZorg

2021-05-28T14:05:23Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Basisgegevens Langdurige Zorg {{VersieInfo|BgLZ}}}}
{{MedMij:Vprepub-2020.01/Issuebox}}
{{NoteBox|1= Wil je (een onderdeel van) de Basisgegevens Langdurige Zorg implementeren, meld je dan bij [mailto:standaarden@medmij.nl standaarden@medmij.nl].}}
[[Bestand:BgLZ-icon.png|link=|links|95px|Use case BgLZ|BgLZ]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub-2020.01/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub-2020.01/FHIR_BGLZ|Technisch]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de uitwisseling van Basisgegevens Langdurige Zorg (BgLZ) op basis van een selectie zorginformatiebouwstenen (zibs) binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:Vprepub-2020.01/Ontwerpen|hier]] gevonden worden.

Binnen het [https://www.dus-i.nl/subsidies/inzicht InZicht programma] (VIPP langdurige zorg) zijn een drietal modules opgenomen.
* Module PGO: de Basisgegevens Langdurige Zorg is bedoeld voor deze module
* Module [https://www.nictiz.nl/standaardisatie/informatiestandaarden/verpleegkundige-overdracht eOverdracht] (gericht op de verpleegkundige overdracht tussen zorgprofessionals)
* Module Medicatieveiligheid: hiervoor wordt verwezen naar het [[MedMij:Vprepub-2020.01/OntwerpMedicatie| functioneel ontwerp]] voor [https://www.nictiz.nl/programmas/medicatieproces Medicatieproces 9.0].

De Basisgegevens Langdurige Zorg bestaat uit gegevens die relevant zijn voor uitwisseling met patiënten binnen de langdurige zorg via hun [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO). De Basisgegevens Langdurige Zorg vertoont enige overlap met de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/basisgegevensset-zorg-bgz/ Basisgegevensset Zorg (BgZ)] en [https://www.nictiz.nl/standaardisatie/informatiestandaarden/verpleegkundige-overdracht eOverdracht] maar is zeker niet hetzelfde: zie [[MedMij:Vprepub-2020.01/OntwerpLangdurigeZorg#Informatie| Informatie]] voor een nadere toelichting over het samenstellen van de inhoud.

Het doel van deze pagina is om de uitwisseling van de Basisgegevens Langdurige Zorg met de patiënt te omschrijven.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen, die [[MedMij:Vprepub-2020.01/Ontwerpen#Doelgroep| hier]] gevonden kan worden.

==Kaders en uitgangspunten==
===Richtlijn===
Conform specificaties genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: Basisgegevens Langdurige Zorg versie {{VersieInfo|BgLZ}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub-2020.01/Ontwerpen|medmij_kwalificatie_introductie}}

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen Langdurige Zorg' en 'Beschikbaarstellen Langdurige Zorg' is te vinden in [[MedMij:Vprepub-2020.01/ToelichtingKwalificatieLangdurigeZorg| Toelichting Kwalificatie BgLZ]].

=Use Cases=
==Use case 1: Raadplegen Basisgegevens Langdurige Zorg in persoonlijke gezondheidsomgeving==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de Basisgegevens Langdurige Zorg die over henzelf gaan.

=== Domein ===
Basisgegevens Langdurige Zorg in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de Basisgegevens Langdurige Zorg vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie,
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De Basisgegevens Langdurige Zorg bestaat uit een selectie van 14 zibs zoals te vinden in dit [[MedMij:Vprepub-2020.01/InhoudLangdurigeZorg|overzicht]]. Deze zibs vormen samen een verzameling van gegevens die patiënten binnen de langdurige zorg zelf relevant vinden om via hun PGO in te zien, zoals bepaald tijdens een aantal veldverkenningen met zowel patiënten als zorgprofessionals. De Basisgegevens Langdurige Zorg komt voor een deel overeen met de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/basisgegevensset-zorg-bgz/ Basisgegevensset Zorg (BgZ)] en [https://www.nictiz.nl/standaardisatie/informatiestandaarden/verpleegkundige-overdracht/ eOverdracht], maar voor een deel ook niet: het gaat om drie aparte sets. Zie het [[MedMij:Vprepub-2020.01/InhoudLangdurigeZorg|overzicht van de inhoud]] voor een nadere toelichting.

Medicatiegegevens vallen buiten de Basisgegevens Langdurige Zorg, omdat hiervoor gebruik wordt gemaakt van het reeds bestaande [https://www.nictiz.nl/programmas/medicatieproces Medicatieproces 9.0] (zie [[MedMij:Vprepub-2020.01/OntwerpMedicatie|uitwisseling medicatiegegevens]] in PGO).

In de MedMij FHIR implementatiegids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:Vprepub-2020.01/FHIR_BGLZ#List_of_StructureDefinitions|overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

=== Bedrijfsrollen ===
Deze use case onderscheidt twee bedrijfsrollen, namelijk de ''Patiënt'' en de ''Zorgaanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10" width="100%"
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Bedrijfsrol'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil de eigen Basisgegevens Langdurige Zorg raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt de Basisgegevens Langdurige Zorg beschikbaar
|}
<font size = "1">'''Bedrijfsrollen Basisgegevens Langdurige Zorg'''</font>

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

[[Image:InzienLZ_activity.PNG|Activiteitendiagram Raadplegen Langdurige Zorg]]

<font size = "1">'''Activiteitendiagram Raadplegen Langdurige Zorg'''</font>

=== Procesbeschrijving ===
==== Patient journey - Kenneth van Someren ====
De 'patient journey' van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Kenneth_van_Someren_MedMij.pdf Kenneth van Someren] beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar Basisgegevens Langdurige Zorg.

<blockquote>Op aanraden van zijn dochter heeft Kenneth nu ook een PGO, waarop hij kan zien wanneer de wijkverpleegkundige komt of de huishoudelijke hulp. Als het nodig is kan hij via zijn PGO doorgeven dat hij niet mee eet omdat hij bij een van zijn kinderen eet. De vrijwilligers van de bezorgdienst krijgen dit automatisch doorgegeven.</blockquote>

<blockquote>Hij krijgt een EVV-er (eerst verantwoordelijke verpleegkundige) toegewezen, die samen met Kenneth een zorgleefplan gaat opstellen. Zodra het zorgleefplan compleet is, komt dit beschikbaar in zijn PGO. Daarmee kan Kenneth goed zien welke afspraken er met de instelling zijn gemaakt.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case om gaat is:
* Het systeem van een zorgaanbieder (XIS) stelt de Basisgegevens Langdurige Zorg van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de Basisgegevens Langdurige Zorg tussen het betreffende XIS en het eigen PGO.

De Basisgegevens Langdurige Zorg, of een gedeelte van de Basisgegevens Langdurige Zorg, welke de persoon wil inzien, bestaat en de zorgaanbieder wil deze beschikbaarstellen.
:Soms zijn er valide redenen om de Basisgegevens Langdurige Zorg, of gedeeltes daarvan, tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om de Basisgegevens Langdurige Zorg op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

===== Processtappen =====
* Het systeem van de patiënt (PGO) raadpleegt het systeem van de zorgaanbieder (XIS) voor de Basisgegevens Langdurige Zorg van de patiënt.
* Het systeem van de zorgaanbieder (XIS) maakt (een deel van) de Basisgegevens Langdurige Zorg beschikbaar voor de patiënt.
* De patiënt gebruikt de persoonlijke gezondheidsomgeving om de Basisgegevens Langdurige Zorg in te zien.

===== Postconditie =====
De persoon kan de Basisgegevens Langdurige Zorg inzien via een persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de Basisgegevens Langdurige Zorg van zorgaanbieder naar de persoon.

{| class="wikitable" "cellpadding="10"
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Systeem
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Naam systeemrol
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Systeemrolcode
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| LZRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|BgLZ}}-LZR-FHIR
| style="background-color: white;"| Raadplegen Basisgegevens Langdurige Zorg bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| LZBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|BgLZ}}-LZB-FHIR
| style="background-color: white;"| Beschikbaarstellen Basisgegevens Langdurige Zorg aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:InzienLZ_component.PNG|Componenten diagram]]

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

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

{| class="wikitable" "cellpadding="10"
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Transactiegroep'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Transactie'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Systeemrolcode'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Systeem'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Bedrijfsrol'''
!style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:left; border: 1px solid black;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|Basisgegevens Langdurige Zorg (PULL)
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/decor/services/RetrieveTransaction?id=2.16.840.1.113883.2.4.3.11.60.58.4.2&effectiveDate=2019-04-09T16:33:35&language=*&ui=nl-NL&version=2019-09-04T10:21:41&format=html&hidecolumns=34567 Raadplegen Basisgegevens Langdurige Zorg]
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgLZ}}-LZR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub-2020.01/FHIR_BGLZ|Basisgegevens Langdurige Zorg in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|[https://decor.nictiz.nl/decor/services/RetrieveTransaction?id=2.16.840.1.113883.2.4.3.11.60.58.4.3&effectiveDate=2019-04-09T16:33:35&language=*&ui=nl-NL&version=2019-09-04T10:21:41&format=html&hidecolumns=34567 Beschikbaarstellen Basisgegevens Langdurige Zorg]
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgLZ}}-LZB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:InzienLZ_usecase.PNG|Use case diagram raadplegen Basisgegevens Langdurige Zorg]]

<font size = "1">'''Use case diagram raadplegen Basisgegevens Langdurige Zorg</font>

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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. Zie de [[MedMij:Vprepub-2020.01/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving

{{ReleaseNotes|package=2020.01 - November 2020|release=2.0.2|issues=2|MM-1432|MM-1382}}
{{ReleaseNotes|package=2020.01 - September 2020|release=2.0.1|issues=6|MM-1459|MM-1456|MM-1285|MM-1260|MM-1259|MM-1011}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|release=2.0.0|issues=3|MM-972|MM-898|MM-319}}
{{ReleaseNotes|package=2019.01 - April|release=1.0.9|issues=3|MM-1059|MM-1025|MM-939}}
{{ReleaseNotes|package=2019.01 - Maart|release=1.0.7|issues=3|MM-997|MM-953|MM-931}}
|-
| style="background-color: white; | 2019.01 - November
| style="background-color: white; | 1.0.4
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-806 MM-806]
| style="background-color: white;"| Fixed MM-430: adjusted incorrect FHIRPath constraints, moved extension to Consent.extension and moved mappings in extension from extension.value[x].reference to extension.value[x] in zib-TreatmentDirective profile.
|-
| style="background-color: white; | 2019.01 - Oktober
| style="background-color: white; | 1.0.2
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-599 MM-599]
| style="background-color: white;"| URL value on detailCodeableConcept.coding.system in HCIM TreatmentObjective example was incorrect, changed to the correct value.
|-
| style="background-color: white; | 2019.01 - September
| style="background-color: white; | 1.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-358 MM-358]
| style="background-color: white;"| Tekstcorrectie op de kwalificatiepagina's van BgZ, GGZ en BgLZ.
|}

MedMij:V2020.01/OntwerpLangdurigeZorg

2021-05-28T14:05:23Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

MedMij:Vprepub-2020.01/OntwerpAllergieIntolerantie

2021-05-28T14:02:22Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp AllergieIntolerantie {{VersieInfo|AllergieIntolerantie}}}}
{{MedMij:Vprepub-2020.01/Issuebox}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png |link=|links |87px|Medicatie Proces]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub-2020.01/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub-2020.01/FHIR_AllergyIntolerance|Technisch]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Dit functioneel ontwerp beschrijft het verzamelen van allergie- en intolerantiegegevens door een patiënt. Tevens beschrijft dit functioneel ontwerp hoe deze allergie- en intolerantiegegevens ingezien kunnen worden door middel van een PGO. Daarnaast betreft deze inleiding een specifieke aanvulling op de overkoepelende inleiding van de [[MedMij:Vprepub-2020.01/Ontwerpen|MedMij functionele ontwerpen]].

Voor uitwisseling van allergie- en intolerantiegegevens worden de volgende zibs gebruikt:

* Patiënt;
* Zorgaanbieder;
* Zorgverlener;
* Contactpersoon;
* AllergieIntolerantie.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de [[MedMij:Vprepub-2020.01/Ontwerpen#Doelgroep| MedMij functionele ontwerpen]].

==Kaders en uitgangspunten==

===Richtlijn===
Conform specificaties genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: AllergieIntolerantie versie {{VersieInfo|AllergieIntolerantie}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub-2020.01/Ontwerpen|medmij_kwalificatie_introductie}}

=Use Cases=
==Use case 1: Raadplegen allergie- en intolerantiegegevens door patiënt==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de geregistreerde allergieën en intoleranties die over henzelf gaan.

=== Domein ===
Allergie- en intolerantiegegevens in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het electronisch en gestructureerd beschikbaar maken van de allergie- en intolerantiegegevens vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*Informatie;
*Bedrijfsrollen (actoren);
*Proces;
*Systemen;
*Systeemrollen;
*Transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuuronafhankelijk.

=== Informatie ===

De informatie-elementen die van toepassing zijn, zijn gedefinieerd in ART-DECOR.

====Raadplegen AllergieIntolerantie-gegevens====

Er zijn géén specifieke filtermogelijkheden (query parameters) gedefinieerd voor het raadplegen van allergie- en intolerantiegegevens. Bij het raadplegen van allergie- en intolerantiegegevens wordt om alle gegevens behorende bij de patiënt gevraagd.

====Beschikbaarstellen AllergieIntolerantie-gegevens====

Informatie elementen in allergie- en intolerantiegegevens staan hieronder. Deze informatie is ook in een [https://decor.nictiz.nl/pub/cio/cio-html-20200226T140246/tr-2.16.840.1.113883.2.4.3.11.60.26.4.9-2019-11-05T130708.html nieuw tabblad] te openen.

Dit betreft de inhoud van de transactie opleveren van allergie- en intolerantiegegevens.
Uitgangspunt voor de transactie zijn de concepten en kardinaliteiten van de zibs AllergieIntolerantie en de bijbehorende Patiënt, Zorgverlener, Zorgaanbieder, Contactpersoon.

<html>
<iframe width="100%" height="450" src=https://decor.nictiz.nl/pub/cio/cio-html-20200226T140246/tr-2.16.840.1.113883.2.4.3.11.60.26.4.9-2019-11-05T130708.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case onderscheidt twee bedrijfsrollen, namelijk de ''Patiënt'' en de ''Zorgaanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10" width="100%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil zijn AllergieIntolerantie-gegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt AllergieIntolerantie-gegevens beschikbaar
|}
<font size = "1">'''Bedrijfsrollen AllergieIntolerantie'''</font>

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

[[Image:Activity_Diagram_-_AllergieIntolerantiegegevens_.png|Activiteitendiagram Raadplegen AllergieIntolerantie-gegevens]]

<font size = "1">'''Activiteitendiagram Raadplegen AllergieIntolerantie-gegevens'''</font>

=== Procesbeschrijving ===
==== Patient journey - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situaties waarbij het raadplegen van een haar allergie- en intolerantiegegevens een rol speelt.

<blockquote>Doordat Roos de huisarts toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld iets in de medicatie wordt gewijzigd, dan ziet Roos dit in haar persoonlijke
gezondheidsomgeving terug. Maar ook oudere opgeslagen informatie kan Roos raadplegen en opslaan in de PGO, zoals bijvoorbeeld haar bloeduitslagen en bekende allergieën.</blockquote>

<blockquote>Aangezien Roos alles netjes heeft bijgehouden in haar persoonlijke gezondheidsomgeving kan zij het ziekenhuis haar medicatiegegevens laten zien en laten uploaden naar het ziekenhuisinformatiesysteem. Hierdoor heeft de internist een snel en accuraat overzicht van de huidige medicatie van Roos. Ook heeft de internist inzicht in de hoeveelheid insuline die ze extra heeft gespoten toen haar bloedsuikers te hoog waren de afgelopen week. Roos autoriseert het ziekenhuis ook om haar laboratoriumwaarden in te zien, zo kunnen ze zien welke bloedwaarden ze de afgelopen tijd had. De internist merkt op dat Roos lichte verhoging heeft, en na onderzoek concludeert hij dat ze een blaasontsteking heeft. De internist ziet in het medicatieoverzicht dat Roos allergisch is voor de antibiotica die meestal bij blaasontstekingen worden gebruikt, waarna hij een ander middel voorschrijft. Doordat Roos eerder de allergie- en intolerantiegegevens van haar bij haar huisarts heeft geraadpleegd was de internist op de hoogte van haar antibiotica-allergie.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case om gaat is:
* Het systeem van een zorgaanbieder (XIS) stelt AllergieIntolerantie-gegevens van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, processtappen, en postcondities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de AllergieIntolerantie-gegevens tussen het betreffende XIS en het eigen PGO.

De patiënt wil allergie- en intolerantiegegevens inzien en de zorgaanbieder stelt deze ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de AllergieIntolerantie-gegevens op te halen, maar het is ook mogelijk dat de PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

===== Proces stappen =====
* Het systeem van de persoon (PGO) raadpleegt de beschikbare AllergieIntolerantie-gegevens.
* Het systeem van de zorgaanbieder (XIS) stelt de AllergieIntolerantie-gegevens beschikbaar voor de persoon.
* De persoon gebruikt de PGO om zijn AllergieIntolerantie-gegevens in te zien.

===== Post conditie =====
De persoon kan zijn AllergieIntolerantie-gegevens inzien via de PGO.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de allergie- en intolerantiegegevens van zorgaanbieder naar de patiënt.

{| 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;"| AllergyIntolerantiegegevensRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|AllergieIntolerantie1}}-AIR-FHIR
| style="background-color: white;"| Raadplegen AllergieIntolerantie bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AllergyIntolerantiegegevensBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|AllergieIntolerantie1}}-AIB-FHIR
| style="background-color: white;"| Beschikbaarstellen AllergieIntolerantie aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

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

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

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

{| 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"|AllergieIntolerantie-gegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen AllergieIntolerantie-gegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|AllergieIntolerantie1}}-AIR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub-2020.01/FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen AllergieIntolerantie gegevens
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|AllergieIntolerantie1}}-AIB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:Use_Case_Diagram_-_AllergieIntolerantiegegevens_.png|Use case diagram inzien AllergieIntolerantie-gegevens]]

<font size = "1">'''Use case diagram inzien AllergieIntolerantie-gegevens</font>

==Use case 2: Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling door patiënt==
Dit is een alternatief voor use case 1 dat zich beperkt tot het ontsluiten van medicatiegerelateerde allergie- en intolerantiegegevens die afkomstig zijn uit de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid/ informatiestandaard Medicatieproces 6.12].

===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medicatiegerelateerde allergie- en intolerantiegegevens die over henzelf gaan. De medicatiegerelateerde allergie- en intolerantiegegevens van ICA (Intolerantie, Contra-indicaties en Allergieën) versie 6.12 betreffen een [http://decor.nictiz.nl/medicatieproces/mp-html-20181220T121121/tmp-2.16.840.1.113883.2.4.3.11.60.20.77.10.12-2013-08-19T000000.html HL7v3-messaging standaard]. Deze use case gaat uit van conversie van deze HL7v3-gegevens naar FHIR-resources.

===Domein===
Medicatiegerelateerde allergie- en intolerantiegegevens.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van medicatiegerelateerde allergie- en intolerantiegegevens vanuit een zorgaanbiederssysteem (XIS) - met behulp van een vertaling naar FHIR - naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO): we noemen dit medicatiegerelateerde allergie- en intolerantiegegevensvertaling.
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
De informatie-elementen die van toepassing zijn, zijn gedefinieerd in ICA 6.12 en [[Mappingarchitectuur#Contraindicaties_en_overgevoeligheden_.28CIO.29|de bijbehorende vertaling]] naar het CIO-datamodel (Contra-indicaties en overgevoeligheden). De medicatiegerelateerde allergie- en intolerantiegegevens in ICA-6.12 zijn vertaald naar het CIO-datamodel voor het onderdeel AllergieIntolerantie. Eventuele negatieve (ontkennende) overgevoeligheden maken hier géén onderdeel van uit. Deze mogen ook officieel niet uitgewisseld worden volgens 6.12, maar als dit tóch gebeurt, worden deze uitgefilterd via de mapping.

====Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling====
Er zijn géén specifieke filtermogelijkheden (query parameters) gedefinieerd voor het raadplegen van medicatiegerelateerde allergie- en intolerantiegegevensvertaling. Bij het raadplegen van medicatiegerelateerde allergie- en intolerantiegegevensvertaling wordt om alle gegevens behorende bij de patiënt gevraagd.

====Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling====
Informatie elementen in medicatiegerelateerde allergie- en intolerantiegegevensvertaling staan hieronder. Deze informatie is ook in een [https://decor.nictiz.nl/pub/cio/cio-html-20200226T140246/tr-2.16.840.1.113883.2.4.3.11.60.26.4.6-2019-08-28T133341.html nieuw tabblad] te openen.

Dit betreft de inhoud van de transactie met medicatiegerelateerde allergie- en intolerantiegegevensvertaling.
Uitgangspunt voor de transactie zijn de concepten en kardinaliteiten van de zibs AllergieIntolerantie en de bijbehorende Patiënt, Zorgverlener, Zorgaanbieder, Contactpersoon. Afwijkingen hiervan zijn gedocumenteerd in [https://bits.nictiz.nl/browse/CIO-5 CIO-5].

<html>
<iframe width="100%" height="450" src=https://decor.nictiz.nl/pub/cio/cio-html-20200226T140246/tr-2.16.840.1.113883.2.4.3.11.60.26.4.6-2019-08-28T133341.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil medicatiegerelateerde allergie- en intolerantiegegevensvertaling raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medicatiegerelateerde allergie- en intolerantiegegevensvertaling beschikbaar
|}
<font size = "1">'''Bedrijfsrollen medicatiegerelateerde allergie- en intolerantiegegevensvertaling '''</font>

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_diagram_Raadplegen_medicatiegerelateerde_allergie-_en_intolerantiegegevensvertaling.png|Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]

<font size = "1">'''Activiteitendiagram Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling'''</font>

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos Dalstra vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het raadplegen van een medicatiegerelateerde allergie- en intolerantiegegevensvertaling een rol speelt.

<blockquote>De internist merkt op dat Roos lichte verhoging heeft, en na onderzoek concludeert hij dat ze een blaasontsteking heeft. Roos toont de internist het medicatieoverzicht in de PGO en hij ziet dat zij allergisch is voor de antibiotica die meestal bij blaasontstekingen wordt gebruikt, waarna hij een ander middel voorschrijft. Doordat Roos eerder haar medicatiegerelateerde allergie- en intolerantiegegevens bij de apotheek heeft geraadpleegd was de internist op de hoogte van haar antibiotica allergie.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een zorgaanbieder (XIS) stelt medicatiegerelateerde allergie- en intolerantiegegevensvertaling beschikbaar aan het systeem van een patiënt (PGO).
*Een PGO heeft de mogelijkheid om deze medicatiegerelateerde allergie- en intolerantiegegevens op te vragen en dit te presenteren.
Deze paragraaf vervolgt met een beschrijving van precondities, processtappen, en postcondities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van allergie- en intolerantiegegevensvertaling tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil allergie- en intolerantiegegevensvertaling inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een gegevens op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de beschrijving van deze use case geen verschil.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare medicatiegerelateerde allergie- en intolerantiegegevensvertaling bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert medicatiegerelateerde allergie- en intolerantiegegevensvertaling op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om medicatiegerelateerde allergie- en intolerantiegegevensvertaling in te zien.

=====Post conditie=====
De patiënt kan medicatiegerelateerde allergie- en intolerantiegegevensvertaling inzien via de persoonlijke gezondheidsomgeving.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de medicatiegerelateerde allergie- en intolerantiegegevensvertaling van zorgaanbieder naar de patiënt.

{| 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;"| AllergieIntolerantieVertalingRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|AllergieIntolerantieVertaling}}-AIR-FHIR
| style="background-color: white;"| Raadplegen AllergieIntolerantieVertaling bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AllergieIntolerantieVertalingBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|AllergieIntolerantieVertaling}}-AIB-FHIR
| style="background-color: white;"| Beschikbaarstellen AllergieIntolerantieVertaling aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Medicatiegerelateerde allergie- en intolerantiegegevensvertaling.png|Componenten diagram]]

<font size = "1">'''Componenten diagram'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
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 use case.

{| 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;"| '''Link naar technische specificatie'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Medicatiegerelateerde allergie- en intolerantiegegevensvertaling (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|AllergieIntolerantieVertaling}}-AIR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub-2020.01/FHIR_AllergyIntolerance#Use_case:_Retrieve_AllergyIntolerance612ToFHIRConversion|Medicatiegerelateerde allergie- en intolerantiegegevensvertaling in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|AllergieIntolerantieVertaling}}-AIB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:Use_case_diagram_raadplegen_Medicatiegerelateerde_allergie-_en_intolerantiegegevensvertaling.png|Use case diagram raadplegen Medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]

<font size = "1">'''Use case diagram</font>

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
<font size = "1">'''Referenties</font>

=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vprepub-2020.01/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving

{{ReleaseNotes|release=3.0.7|package=2020.01 - April 2021|issues=1|MM-1901}}
{{ReleaseNotes|release=3.0.5|package=2020.01 - Februari 2021|issues=3|MM-1797|MM-1731|MM-1571}}
{{ReleaseNotes|release=3.0.1|package=2020.01 - Oktober 2020|issues=1|MM-1390}}
{{ReleaseNotes|release=3.0.0|package=2020.01 - Zomerrelease 2020|issues=5|MM-733|MM-722|MM-717|MM-616|MM-614}}
{{ReleaseNotes|release=2.0.4|package=2019.01 - Maart 2020|packageIssues=1|issues=1|MM-926}}
|-
| rowspan = 1; style="background-color: white;"| 2019.01 - Januari 2020
| rowspan = 1; style="background-color: white;"| 2.0.3
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-492 MM-492]
| style="background-color: white;"| Added comment to AllergyIntolerance.comment in the HCIM Allergyintolerance FHIR profile to explain the mapping for ValueSet AllergieStatusCodelijst to AllergyIntolerance.clinicalStatus and AllergyIntolerance.verificationStatus. Added dataAbsentReason extension to AllergyIntolerance.verificationStatus.
|-
| rowspan = 2; style="background-color: white;"| 2019.01 - November
| rowspan = 2; style="background-color: white;"| 2.0.2
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-610 MM-610]
| style="background-color: white;"|
Added missing profiles for practitionerrole, organization and related-person. Removed the word 'medication' in favor of 'allergy intolerance'. In the [[MedMij:Vprepub-2020.01/FHIR_AllergyIntolerance|technical specification]].
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-498 MM-498]
| style="background-color: white;"| Added conceptmap for AllergyIntolerance.category to aid in mapping from HCIM AllergyIntolerance value set AllergieCategorieCodelijst to FHIR STU3 AllergyIntoleranceCategory.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 2.0.0
| style="background-color: white;"| -
| style="background-color: white;"|
Use case toegevoegd: Raadplegen/beschikbaarstellen medicatiegerelateerde allergieIntolerantieVertaling.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.0.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-52 MM-52]
| style="background-color: white;"| AllergyIntolerantie filter op medicatieproces conditie geldigheidstermijn niet nodig
|}

MedMij:V2020.01/OntwerpAllergieIntolerantie

2021-05-28T14:02:22Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

MedMij:Vprepub-2020.01/OntwerpLabresult

2021-05-28T14:01:34Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Laboratoriumresultaten {{VersieInfo|Laboratoriumresultaten}}}}
{{MedMij:Vprepub-2020.01/Issuebox}}

[[Bestand:Labresultaten_icoon.png |link=|links |87px|MedMij_|Laboratoriumresultaten]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub-2020.01/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub-2020.01/FHIR_LaboratoryResults|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Deze pagina beschrijft use cases voor de patiënt met relatie tot de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria informatiestandaard labuitwisseling] (LAB).

Door IHE / Antilope is ook al werk gedaan voor beschrijving use cases voor uitwisseling van laboratoriumgegevens, deze zijn [https://usecase-repository.ihe-europe.net/use-cases?field_domain_value=LAB&field_scale_value=All&field_source_value=All hier] gepubliceerd. Op het moment van schrijven van deze documentatie heeft IHE twee verschillende use cases beschreven:
* Uitwisseling voor een laboratorium binnen een ziekenhuis: [https://usecase-repository.ihe-europe.net/content/request-and-results-distribution-workflow-laboratory-within-hospital Request and results distribution workflow for laboratory within a hospital]
* Nationale / regionale uitwisseling tussen zorgaanbieders / laboratoria: [https://usecase-repository.ihe-europe.net/content/request-and-results-sharing-workflow-laboratory-nationalregional-scale Request and results sharing workflow for laboratory on a National/regional scale]

Bovenstaande standaarden beschrijven de uitwisseling met de patiënt nog niet expliciet. Het doel van deze pagina is om de verschillende uitwisselingsscenario's van laboratoriumgegevens met de patiënt toe te voegen.

Het is het streven van het MedMij-programma om deze beschrijvingen toe te voegen aan de bestaande informatiestandaard Labuitwisseling.

Zoals [[MedMij:Vprepub-2020.01/Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende zibs als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende zibs:
*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*LaboratoriumUitslag.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen, die [[MedMij:Vprepub-2020.01/Ontwerpen#Doelgroep| hier]] gevonden kan worden.

==Kaders en uitgangspunten==
===Richtlijn===
Conform specificaties genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: Laboratoriumresultaten versie {{VersieInfo|Laboratoriumresultaten}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub-2020.01/Ontwerpen|medmij_kwalificatie_introductie}}

=Use Cases=

==Use case: Raadplegen laboratoriumresultaten in persoonlijke gezondheidsomgeving==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in laboratoriumresultaten die over henzelf gaan.
===Domein===
Laboratoriumgegevens in het domein van zorgaanbieders, laboratoria en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van laboratoriumresultaten vanuit zorgaanbieder / laboratorium naar een patiënt. De zorgaanbieder / laboratorium is dus de bron van de gegevens.

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
====Raadplegen laboratoriumresultaten====
Informatie-elementen in de vraag om laboratoriumresultaten zijn:
*periode (startdatum - einddatum) waarop het laboratoriumresultaat uitgevoerd was.

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om laboratoriumresultaten.

====Beschikbaarstellen laboratoriumresultaat====
De volgende zorginformatiebouwstenen definiëren de informatie-elementen die van toepassing zijn:
*Patiënt
*Zorgverlener
*Zorgaanbieder
*LaboratoriumUitslag v4.1

Informatie elementen in LaboratoriumUitslag staan [https://zibs.nl/wiki/LaboratoriumUitslag-v4.1(2017NL) hier].

Dit betreft de inhoud van ieder laboratoriumresultaat.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil laboratoriumresultaten raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder / Laboratorium
|style="background-color: white;vertical-align:top;"|Stelt laboratoriumresultaten beschikbaar
|}
<font size = "1">'''Bedrijfsrollen Laboratoriumresultaten'''</font>

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_LaboratoriumResultaten.jpg|Activiteitendiagram Raadplegen laboratoriumresultaten ]]

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

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van laboratoriumresultaten een rol speelt.

<blockquote>Eens per drie maanden heeft Thomas een controle in het ziekenhuis. Hij heeft dan een afspraak met afwisselend de internist of de diabetesverpleegkundige. Thomas moet een half uur voor zijn afspraak al aanwezig zijn in het ziekenhuis om bloed te laten prikken. Een waarde die onder andere bepaald wordt is de HbA1c waarde, hieraan is te zien wat de gemiddelde glucosewaarde over de afgelopen 3 maanden geweest is. De uitslag is binnen een half uur binnen. De zorgverlener vertelt Thomas de laboratoriumresultaten en wat die betekenen tijdens de afspraak. Het ziekenhuis informatiesysteem maakt de laboratoriumresultaten ook beschikbaar voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan de resultaten dan ook later nog eens nakijken als hij dat wil. Dit geeft hem meer grip op zijn gezondheidssituatie.</blockquote>

<blockquote>In april is het tijd voor de jaarlijkse, uitgebreide controle in het ziekenhuis in verband met diabetes. De controle zélf zal plaatsvinden op 12 april. Thomas moet een week daarvoor, op 5 april, bloed prikken en urine afgeven in het ziekenhuis. De resultaten van de laboratoriumonderzoeken moeten beschikbaar zijn vóór 12 april. Het ziekenhuis informatiesysteem heeft de resultaten beschikbaar gemaakt voor Thomas op 10 april. Thomas wil zich goed op zijn afspraak voorbereiden en raadpleegt op 11 april, via zijn PGO, deze laboratoriumresultaten. Hij krijgt zo vooraf al meer inzicht in zijn situatie. Zijn nierwaarden lijken hem afwijkend. Hij vraagt zich daarom af of de instelling van de medicatie misschien aangepast moet worden. Voor de zekerheid noteert hij deze vraag voor zijn internist. Zo kan hij goed voorbereid naar het ziekenhuis op 12 april.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het uitwisselen van laboratoriumresultaten tussen zorgaanbieder / laboratorium en patiënt.
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van laboratoriumresultaten tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

Er is een laboratoriumresultaat dat de patiënt wil raadplegen en dat de zorgaanbiederzorgaanbieder / laboratorium beschikbaar stelt.
:Soms zijn er valide redenen om bepaalde laboratoriumresultaten tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om laboratoriumresultaten op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

=====Proces stappen=====
*De patiënt vraagt om laboratoriumresultaten bij een zorgaanbieder / laboratorium.
*De zorgaanbieder / laboratorium levert laboratoriumresultaten op voor de patiënt.
*Patiënt ziet de laboratoriumresultaten in.

=====Post conditie=====
De patiënt heeft laboratoriumresultaten gezien.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de laboratoriumresultaten van zorgaanbieder naar de patiënt.

{| 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;"| LaboratoriumresultaatRaadplegend
| style="background-color: white;"| LAB-{{VersieInfo|Laboratoriumresultaten}}-LRR-FHIR
| style="background-color: white;"| Raadplegen Laboratoriumresultaat bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| LaboratoriumresultaatBeschikbaarstellend
| style="background-color: white;"| LAB-{{VersieInfo|Laboratoriumresultaten}}-LRB-FHIR
| style="background-color: white;"| Beschikbaarstellen Laboratoriumresultaat aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_LaboratoriumResultaten_(Totaal).jpg|Componenten diagram]]

<font size = "1">'''Componenten diagram'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
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 use case.

{| 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"|Laboratoriumresultaten (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-{{VersieInfo|Laboratoriumresultaten}}-LRR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub-2020.01/FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-{{VersieInfo|Laboratoriumresultaten}}-LRB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (laboratorium)
|}

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

[[Bestand:Use_Case_Diagram_-_LaboratoriumResultaten.jpg|Use case diagram raadplegen laboratoriumresultaten]]

<font size = "1">'''Use case diagram</font>

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
<font size = "1">'''Referenties</font>

=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vprepub-2020.01/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
{{ReleaseNotes|package=2020.01 - April 2021|release=2.0.7|issues=1|MM-2008}}
{{ReleaseNotes|package=2020.01 - Oktober 2020|release=2.0.2|issues=2|MM-989|MM-988}}
{{ReleaseNotes|package=2020.01 - September 2020|release=2.0.1|issues=2|MM-1319|MM-517}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|release=2.0.0|issues=4|MM-941|MM-898|MM-767|MM-511}}
|-
| rowspan = 2; style="background-color: white; | 2019.01 - September
| rowspan = 2; style="background-color: white; | 1.1.4
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-436 MM-436]
| style="background-color: white;"| Aanpassen ConceptMap InterpretatieVlaggenCodelijst-to-observation-interpretation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-422 MM-422]
| style="background-color: white;"| Aanpassen conceptnaam ResultaatVlaggen naar InterpretatieVlaggen in FHIR profiel voor LaboratoryResults.
|-
|rowspan = 9; style="background-color: white;"| 2019.01
|rowspan = 3; style="background-color: white;"| 1.1.3
|style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-294 MM-294]
|style="background-color: white;"| Naam mapping binnen div. FHIR profielen aangepast conform zib: HCIM LaboratoryTestResult-v4.1(2017EN).
|-
|style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-247 MM-247]
|style="background-color: white;"| LastN operation niet nodig binnen use case LaboratoryResults
|-
|style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-205 MM-205]
|style="background-color: white;"| Verwijderen link naar Specimen in het technisch ontwerp van LaboratoryResults.
|-
| style="background-color: white;"| 1.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 5; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-112 MM-112]
| style="background-color: white;"| Verwijzing in §2.4.1.2 naar zib OverdrachtLaboratoriumuitslag v1.2.2 (release 2015) gewijzigd in zib Laboratoriumuitslag v4.1 (release 2017). In het technisch ontwerp en FHIR-profielen werd deze al toegepast.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-108 MM-108]
| style="background-color: white;"| use-case Collect (from XIS to PGO).
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|}

MedMij:V2020.01/OntwerpLabresult

2021-05-28T14:01:34Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

MedMij:Vprepub-2020.01/OntwerpBGZ 2017

2021-05-28T14:00:41Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp BgZ {{VersieInfo|BgZ}}}}
{{MedMij:Vprepub-2020.01/Issuebox}}

[[Bestand:BGZ_icoon.png |link=|links |87px|Use case BgZ|Patient Summary (BgZ)]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub-2020.01/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub-2020.01/FHIR_BGZ_2017|Technisch]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de Basisgegevensset Zorg binnen MedMij.

De [https://www.registratieaandebron.nl/wat-is-registreren-aan-de-bron/de-kern-van-registreren-aan-de-bron/basisgegevensset/ Basisgegevensset Zorg], ofwel BgZ, is de minimale set van patiëntgegevens die specialisme, ziektebeeld en beroepsgroep overstijgend relevant is en die van belang is voor de continuïteit van zorg en is in Nederland door [https://www.registratieaandebron.nl 'Registratie aan de Bron'] gedefinieerd. Deze set aan patiëntgegevens wordt door alle zorgverleners hetzelfde vastgelegd. Hierdoor wordt uitwisseling van deze gegevens mogelijk gemaakt. De BgZ is gespiegeld aan de Europese Patient Summary.

De bekende use cases voor het uitwisselen van de BgZ zijn gericht op uitwisseling tussen zorgverleners voor spoedeisende hulp of ongeplande zorg. Tot op heden is uitwisseling vanuit het perspectief van de patiënt niet beschreven. Het doel van deze pagina is om de uitwisseling van de BgZ met de patiënt toe te voegen.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de [[MedMij:Vprepub-2020.01/Ontwerpen#Doelgroep| MedMij functionele ontwerpen]].

==Kaders en uitgangspunten==
===Richtlijn===
Conform specificaties genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: BgZ versie {{VersieInfo|BgZ}} maakt gebruik van [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zib publicatie 2017].

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub-2020.01/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub-2020.01/Ontwerpen|medmij_kwalificatie_introductie}}

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen BgZ' en 'Beschikbaarstellen BgZ' is te vinden in [[MedMij:Vprepub-2020.01/ToelichtingKwalificatieBgZ|Toelichting Kwalificatie BgZ]].

=Use Cases=
==Use case 1: Raadplegen Basisgegevensset Zorg in persoonlijke gezondheidsomgeving==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in gegevens uit de Basisgegevensset Zorg (BgZ) die over henzelf gaan.

=== Domein ===
Basisgegevensset Zorg in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de BgZ vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie,
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.1.pdf BgZ op basis van zibs release 2017] bestaat uit een selectie van 28 [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zibs]. Deze zibs vormen samen een verzameling van patiëntgegevens die minimaal nodig is om patiënten continuïteit van zorg te kunnen bieden.

Deze use case gebruikt de structuur van 18 secties die is aangebracht in BgZ 2017. Hierin zijn de onderdelen gegroepeerd waaruit de BgZ is opgebouwd. Deze secties komen sterk overeen met de secties van [https://www.nictiz.nl/wp-content/uploads/2012/09/Alles-wat-je-wilt-weten-over-CCR-CCD-v1-0.pdf CCR/CCD] en maken het o.a. mogelijk om in de technische implementatie (bv FHIR) structuur aan te brengen. In de [[MedMij:Vprepub-2020.01/FHIR_IG | MedMij FHIR implementatie gids]] staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:Vprepub-2020.01/FHIR_BGZ_2017#List_of_StructureDefinitions | overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

Voor het gebruik van codestelsel geldt de [[MedMij:Vprepub-2020.01/Ontwerpen#Richtlijn|algemene richtlijn]].

====Raadplegen BgZ====
Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de BgZ. Bij het raadplegen van de BgZ wordt om alle gegevens behorende bij de patiënt gevraagd.

====Beschikbaarstellen BgZ====
Informatie-elementen in de BgZ staan hieronder. Deze informatie is ook in een [https://decor.nictiz.nl/pub/bgz2017/bgz2017-html-20190313T152910/tr-2.16.840.1.113883.2.4.3.11.60.42.4.37-2018-08-30T093049.html nieuw tabblad] te openen. Bij het beschikbaarstellen van de BgZ worden alle beschikbare gegevens behorende bij de patiënt beschikbaargesteld.

<html>
<iframe width="100%" height="800" src=https://decor.nictiz.nl/pub/bgz2017/bgz2017-html-20190313T152910/tr-2.16.840.1.113883.2.4.3.11.60.42.4.37-2018-08-30T093049.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case onderscheidt twee bedrijfsrollen, namelijk de ''Patiënt'' en de ''Zorgaanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10" width="100%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt (PGO)
|style="background-color: white;vertical-align:top;"|Wil de eigen BgZ raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (XIS)
|style="background-color: white;vertical-align:top;"|Stelt de BgZ beschikbaar
|}


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

[[Bestand:InzienBGZ activity.PNG|Activiteitendiagram Raadplegen BgZ]]


=== Procesbeschrijving ===
==== Patient journey - Thomas van Beek ====
De 'patient journey' van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf Thomas van Beek] beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar BgZ.

<blockquote>Voor zijn afstuderen verhuist Thomas 9 maanden naar Groningen. Hij gaat daar bij een heel leuk bedrijf stagelopen. Om het voor hem makkelijk te maken en omdat hij een arts dicht in de buurt wil hebben, schrijft hij zich in bij het ziekenhuis in Groningen. Hiervoor moet het ziekenhuis in Amsterdam alle gegevens van Thomas overdragen aan het ziekenhuis in Groningen. Zo weet de nieuwe arts van Thomas precies wat het verloop van de diabetes is. Thomas is zelf eigenlijk wel nieuwsgierig naar zijn medische gegevens die verstuurd worden. In zijn PGO vindt hij de belangrijkste gegevens die over hem bekend zijn.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case omgaat is:
* Het systeem van een zorgaanbieder (XIS) stelt de BgZ van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de BgZ tussen het betreffende XIS en het eigen PGO.

De BgZ, of een gedeelte van de BgZ, welke de persoon wil inzien, bestaat en de zorgaanbieder (XIS) wil deze beschikbaarstellen.
:Soms zijn er valide redenen om de BgZ, of gedeeltes daarvan, tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om de BgZ op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

===== Proces stappen =====
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| Het systeem van de patiënt (PGO) raadpleegt het systeem van de zorgaanbieder (XIS) voor de BgZ van de patiënt.
|-
| style="background-color: white;"| 02
| style="background-color: white;"| Het systeem van de zorgaanbieder (XIS) maakt (een deel van) de BgZ beschikbaar voor de patiënt.
|-
| style="background-color: white;"| 03
| style="background-color: white;"| De patiënt gebruikt de persoonlijke gezondheidsomgeving (PGO) om de BgZ in te zien.
|}

===== Post conditie =====
De persoon kan de Basisgegevensset Zorg inzien via een persoonlijke gezondheidsomgeving (PGO).

=== Systemen & Systeemrollen ===
Zowel patiënt als zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de BgZ van zorgaanbieder naar de patiënt.

{| 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;"| BGZRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|BgZ}}-BZR-FHIR
| style="background-color: white;"| Raadplegen BgZ bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| BGZBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|BgZ}}-BZB-FHIR
| style="background-color: white;"| Beschikbaarstellen BgZ aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:InzienBGZ_componenten.PNG|Componenten diagram]]


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

{| 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:middle;" rowspan="2"|BgZ (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen BgZ
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgZ}}-BZR-FHIR]]
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub-2020.01/FHIR_BGZ_2017|BgZ in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen BgZ
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgZ}}-BZB-FHIR]]
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:InzienBGZ_useCase.PNG|Use case diagram inzien BgZ]]


=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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;"| Basisgegevensset Zorg
| style="background-color: white;"| -
| style="background-color: white;"| 12-08-2019
| style="background-color: white;"| [https://www.registratieaandebron.nl/alles-over-de-bgz/de-basisgegevensset-zorg Alles over de BgZ]
| style="background-color: white;"| Registratie aan de bron (RadB)
|-
| style="background-color: white;"| -
| style="background-color: white;"| BgZ - specificatie gebaseerd op zibs release 2017
| style="background-color: white;"| 1.1
| style="background-color: white;"| 19-04-2018
| style="background-color: white;"| [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.1.pdf BgZ - specificatie gebaseerd op zibs release 2017]
| style="background-color: white;"| Registratie aan de bron (RadB)
|-
| style="background-color: white;"| Albert-Jan Spruyt & Jan A. Hazelzet
| style="background-color: white;"| Alles wat je wilt (moet) weten over CCR/CCD
| style="background-color: white;"| 1.0
| style="background-color: white;"| 13-09-2012
| style="background-color: white;"| [https://www.nictiz.nl/wp-content/uploads/2012/09/Alles-wat-je-wilt-weten-over-CCR-CCD-v1-0.pdf Alles wat je wilt (moet) weten over CCR/CCD]
| style="background-color: white;"| Nictiz
|}


=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vprepub-2020.01/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
{{ReleaseNotes|package=2020.01 - Januari 2021|release=3.0.7|issues=2|MM-1944|MM-1881}}
{{ReleaseNotes|package=2020.01 - Januari 2021|release=3.0.4|issues=2|MM-1624|MM-1589}}
{{ReleaseNotes|package=2020.01 - November 2020|release=3.0.3|issues=2|MM-1408|MM-1382}}
{{ReleaseNotes|package=2020.01 - Oktober 2020|release=3.0.2|issues=3|MM-1455|MM-1444|MM-1420}}
{{ReleaseNotes|package=2020.01 - September 2020|release=3.0.1|issues=4|MM-1285|MM-1283|MM-1011|MM-517}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|release=3.0.0|issues=10|MM-1204|MM-972|MM-898|MM-767|MM-616|MM-614|MM-507|MM-419|MM-404|MM-319}}
{{ReleaseNotes|package=2019.01 - Mei 2020|release=2.1.14|issues=1|MM-1094}}
{{ReleaseNotes|package=2019.01 - April 2020|release=2.1.13|issues=3|MM-1025|MM-1003|MM-939}}
{{ReleaseNotes|package=2019.01 - Maart 2020|release=2.1.10|issues=4|MM-997|MM-953|MM-926|MM-657}}
{{ReleaseNotes|package=2019.01 - Februari 2020|release=2.1.9|issues=5|MM-901|MM-900|MM-852|MM-440|MM-414}}
{{ReleaseNotes|package=2019.01 - Januari 2020|release=2.1.8|issues=2|MM-492|MM-467}}
{{ReleaseNotes|package=2019.01 - November|packageIssues=3|release=2.1.7|MM-806}}
{{ReleaseNotes|release=2.1.6|issues=2|MM-729|MM-430}}
{{ReleaseNotes|package=2019.01 - Oktober|release=2.1.5|issues=2|MM-597|MM-594}}
{{ReleaseNotes|package=2019.01 - September|release=2.1.4|issues=5|MM-436|MM-425|MM-422|MM-359|MM-358}}
{{ReleaseNotes|package=2019.01|packageIssues=28|release=2.1.3|issues=6|MM-348|MM-346|MM-307|MM-294|MM-258|MM-248}}
{{ReleaseNotes|release=2.1.2|MM-219}}
{{ReleaseNotes|release=2.1.1|issues=2|MM-210|MM-206}}
{{ReleaseNotes|release=2.1.0|issues=19|MM-174|MM-161|MM-145|MM-144|MM-143|MM-142|MM-141|MM-134|MM-127|MM-125|MM-118|MM-115|MM-100|MM-99|MM-98|MM-94|MM-50|MM-42|MM-41}}
{{ReleaseNotes|package=2018.06|release=2.0.1|issues=6|MM-174|MM-128|MM-66|MM-55|MM-54|MM-23}}
|}

MedMij:V2020.01/OntwerpBGZ 2017

2021-05-28T14:00:41Z

Camiel Reijnders: MM-2057: Verwijzing naar gebruik 'zib 2017 publicatie' in paragraaf 1.3.1 Richtlijn

MedMij:V2020.02/Ontwerpen

2021-05-28T13:58:47Z

Camiel Reijnders: MM-2057: Bij BgZ vermelding zib2017 uit tabel verwijderen

__NOINDEX__
__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Ontwerpen MedMij|Functioneel Ontwerpen}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub-2020.02/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub-2020.02/FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
{{#lsth:MedMij:V2020.01/Ontwerpen|Algemeen}}
==Doelgroep==
{{#lsth:MedMij:V2020.01/Ontwerpen|Doelgroep}}
==Kaders en uitgangspunten==
===Richtlijn===
====Zorginformatiebouwstenen en gegevenssets====
{{#lsth:MedMij:V2020.01/Ontwerpen|Zorginformatiebouwstenen en gegevenssets}}
====Terminologie en vertalingen====
Richtinggevend voor de applicaties die MedMij-standaarden implementeren is dat ze Nederlandse termen gebruiken. Dit wordt op de volgende wijze functioneel en technisch ondersteund.

'''Functioneel'''

De functionele definities van de MedMij-informatiestandaarden zijn zoveel mogelijk samengesteld uit bestaande zibs. De zibs bevatten veel (eigen) waardelijsten. Bij deze waardelijsten wordt een Nederlandse vertaling gegeven.

Voor het verwerken en tonen van waarden uit bestaande terminologie- en codestelsels (zoals SNOMED CT en LOINC) in een PGO, kan het volgende uitgangspunt gehanteerd worden:

*Indien er een Nederlandse patiëntvertaling beschikbaar is, toon deze aan de PGO-gebruiker.
*Indien een Nederlandse patiëntvertaling ontbreekt, maar er wel een Nederlandse zorgverlenervertaling beschikbaar is, toon deze aan de PGO-gebruiker.
*Indien zowel een Nederlandse patiëntvertaling als een zorgverlenervertaling ontbreken in het terminologie- of codestelsel, volg de dataset, waarin voor uitgewerkte waardelijsten ook Nederlandse termen beschikbaar zijn.
*Indien Nederlandse vertaling geheel ontbreekt, kan de Engelse term getoond worden.

Meer informatie over eventueel benodigde licentie en implementatie van terminologie- en codestelsels is te vinden in het [https://www.nictiz.nl/overzicht-standaarden/ standaarden overzicht van Nictiz]

Ook wat betreft de omschrijving van informatie geniet het de voorkeur om ze veel mogelijk gebruik te maken van Nederlandse termen. De (omschrijvingen van de) conceptnamen die in zibs gehanteerd worden, kunnen gebruikt worden, evenals correcte Nederlandse synoniemen daarvan die mogelijk beter aansluiten op het persoonsdomein.

'''Technisch'''

Voor de waardelijsten in de zibs zijn FHIR ValueSet-resources gemaakt. Deze bevatten gestructureerd de Nederlandse vertalingen van de zib-concepten en worden dus bij de standaard aangeboden. Leveranciers kunnen bij het weergeven van concepten uit deze ValueSets dan ook kiezen voor de Nederlandse vertaling.

De ValueSets zijn óf direct gekoppeld in de FHIR-profielen, of kunnen, indien dit niet mogelijk is, via een FHIR ConceptMap gerelateerd worden aan de waarden die binnen een profiel gebruikt worden. Zie hiervoor de specificaties in de [[MedMij:Vprepub-2020.02/FHIR_IG#Use_of_coded_concepts|FHIR-implementatiegids]].
====Referenties====
MedMij informatiestandaarden gebruiken zoveel mogelijk bestaande zibs. Deze zibs verwijzen naar elkaar middels referenties. FHIR kent ook het concept van referenties. Via zo'n referentie kan bijvoorbeeld ook het specialisme van een zorgverlener bij een verrichting opgehaald worden. Het uitgangspunt is dat alle references 'resolvable' (opvraagbaar) moeten zijn, niet dat ze resolved worden. Een PGO zou er ook voor kunnen kiezen om een klikbare link te tonen, waarmee een gebruiker (de persoon) desgewenst zelf kan 'resolven', eventueel zelfs in een nieuwe sessie (na de initiële 15 minuten). Meer informatie over het gebruik van FHIR-references binnen MedMij is te vinden in de informatiestandaardoverstijgende principes in de [[MedMij:Vprepub-2020.02/FHIR_IG#Use_of_the_reference_datatype |FHIR-implementatiegids]].

===Infrastructuur===
{{#lsth:MedMij:V2020.01/Ontwerpen|Infrastructuur}}
===Geografische reikwijdte===
{{#lsth:MedMij:V2020.01/Ontwerpen|Geografische reikwijdte}}
==Kwalificatie==
===Introductie===
<section begin=medmij_kwalificatie_introductie />
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.

Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via de betreffende paragraaf op de [[MedMij:Vprepub-2020.02/Kwalificatie|kwalificatiepagina]].<section end=medmij_kwalificatie_introductie /><section end=medmij_kwalificatie_introductie />

=Wiki structuuroverzicht=
Onderstaande afbeelding geeft een overzicht van de MedMij wiki pagina structuur. Het afsprakenstelsel verwijst naar de MedMij landingspagina die op zijn beurt verwijst naar de functionele en technische ontwerpen. Vanaf deze pagina, de hoofdpagina van de functionele ontwerpen, wordt verwezen naar de onderliggende functionele ontwerp pagina's middels de onderstaande 'patient journeys' en tabel overzicht. De functionele ontwerp beschrijvingen hebben een technische wiki pagina als tegenhanger. Vanuit de leeswijzer afbeelding, bestaande uit drie iconen, bovenaan de pagina is het mogelijk makkelijk door te linken naar de technische pagina's.

<imagemap>Bestand:MedMij_wiki_structuur_overzicht.png||650px|alt=MedMij Wiki structuur overzicht
circle 344 894 333 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
rect 1017 1260 1517 1407 [[Landingspagina_MedMij#Mappings|Mappings]]
rect 2123 3 2740 847 [[MedMij:Vprepub-2020.02/Ontwerpen|Functioneel]]
rect 2123 945 2740 1789 [[MedMij:Vprepub-2020.02/FHIR_IG|Technisch]]
desc none
</imagemap>

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]

==Haal gegevens op uit XIS==
===Algemeen===
Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden in publicatie 2020.02 die van toepassing zijn voor het raadplegen van informatie.
{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|[[Bestand:BgLZ-icon.png|link=MedMij:V2020.01/OntwerpLangdurigeZorg|49px|Basisgegevens Langdurige Zorg]]||Basisgegevens Langdurige Zorg||||Basisgegevens Langdurige Zorg raadplegen|| [[MedMij:Vprepub-2020.02/OntwerpLangdurigeZorg|BgLZ ]] ||[[MedMij:Vprepub-2020.02/FHIR_BGLZ|BgLZ in FHIR]]
|-style="background-color: white;"
|}
Onderstaande tabel geeft een overzicht van de use cases uit de overige informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.
{{NoteBox|1= De informatiestandaarden in onderstaande tabel maken geen deel uit van publicatie 2020.02. De links verwijzen naar de meest recente publicatie.}}
{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|49px]]||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||[[MedMij:V2020.01/OntwerpBGZ_2017#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2020.01/FHIR_BGZ_2017|BgZ in FHIR]]
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|49px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]||||Laboratoriumresultaten ||[[MedMij:V2020.01/OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2020.01/FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="background-color: white;"
|rowspan="3"|[[Bestand:Medicatie.png|link=https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx|49px]]
|rowspan="3"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="3"|
||Medicatieoverzicht
||[[MedMij:V2020.01/OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving|Medicatieoverzicht]]
||[[MedMij:V2020.01/FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="background-color: white;"
||Medicatiegegevens ||[[MedMij:V2020.01/OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt|Medicatiegegevens]]
||[[MedMij:V2020.01/FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-style="background-color: white;"
||Verstrekkingenvertaling||[[MedMij:V2020.01/OntwerpMedicatie#Use_case:_Raadplegen_verstrekkingenvertaling_.28medicatieverstrekkingen_van_het_LSP.29_door_pati.C3.ABnt|Verstrekkingenvertaling]]
||[[MedMij:V2020.01/FHIR_MedicationProcess#Use_case:_retrieve_medication_information|Verstrekkingenvertaling in FHIR]]
|-
|rowspan="2"|[[Bestand:Allergie.png|link=MedMij:V2020.01/OntwerpAllergieIntolerantie| AllergieIntolerantie|49px]]
|rowspan="2"|[[MedMij:V2020.01/OntwerpAllergieIntolerantie | AllergieIntolerantie]]
|rowspan="2"|
||Allergie/intolerantie ||[[MedMij:V2020.01/OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2020.01/FHIR_AllergyIntolerance#Use_case:_Retrieve_AllergyIntolerance_information|AllergieIntolerantie in FHIR]]
|-
||Allergie/intolerantie vertaling ||[[MedMij:V2020.01/OntwerpAllergieIntolerantie#Use_case_2:_Raadplegen_medicatiegerelateerde_allergie-_en_intolerantiegegevensvertaling_door_pati.C3.ABnt| AllergieIntolerantieVertaling]] ||[[MedMij:V2020.01/FHIR_AllergyIntolerance#Use_case:_Retrieve_AllergyIntolerance612ToFHIRConversion|AllergieIntolerantieVertaling in FHIR]]
|-style="background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2020.01/OntwerpeAfspraak|49px]]
||eAfspraak
||||Afspraken raadplegen
||[[MedMij:V2020.01/OntwerpeAfspraak#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraak]]
|| [[MedMij:V2020.01/FHIR_eAfspraak| eAfspraak in FHIR]]
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=MedMij:V2020.01/OntwerpZelfmetingen|49px]]
||Zelfmetingen
||||Zelfmetingen raadplegen||[[MedMij:V2020.01/OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2020.01/FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|49px]]
||PDF/A
||||PDF/A raadplegen ||[[MedMij:V2020.01/OntwerpPDFA| PDF/A]] ||[[MedMij:V2020.01/FHIR_PDFA|PDF/A in FHIR]]
|-
|[[Bestand:Huisartsgegevens-zonder-tekst-dun.png|link=MedMij:V2020.01/OntwerpHuisartsgegevens|49px|Huisartsgegevens]]||Huisartsgegevens|||| Huisartsgegevens || [[MedMij:V2020.01/OntwerpHuisartsgegevens|Huisartsgegevens]] ||[[MedMij:V2020.01/FHIR_GP_Data|GP data in FHIR]]
|-style="background-color: white;"
|[[Bestand:GGZ-59.-zondertekst.png|49px|GGZ]]
||Basisgegevens GGZ|||| Basisgegevens GGZ|| [[MedMij:V2020.01/OntwerpGGZ|Basisgegevens GGZ]] ||[[MedMij:V2020.01/FHIR_GGZ|GGZ data in FHIR]]
|-
|[[Bestand:vragenlijstenIcoon.png|link=MedMij:V2020.01/OntwerpVragenlijsten|49px|Vragenlijsten]]
||Vragenlijsten||||Vragenlijsten||[[MedMij:V2020.01/OntwerpVragenlijsten|Vragenlijsten]] ||[[MedMij:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Vragenlijsten in FHIR]]
|}

===What's new===
Een PGO kan na een eerste raadpleging nieuwe of gewijzigde gegevens raadplegen middels een "what's new" uitvraag. Voordeel van deze functionaliteit is dat niet onnodig reeds bekende gegevens opnieuw beschikbaar gesteld hoeven te worden. Denk hierbij aan wederom raadplegen van een volledige gegevensset zoals de BgZ. PGO dient hiervoor de datum van eerdere raadpleging te bewaren, om te gebruiken in een nieuwe raadpleging. XIS dient deze datum te kunnen verwerken. Technische uitwerking staat in de [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2020.01/FHIR_IG#Use_case_overarching_principles "overarching principles" van het technisch ontwerp].

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.
{{NoteBox|1= De informatiestandaarden in onderstaande tabel maken geen deel uit van publicatie 2020.02. De links verwijzen naar de meest recente publicatie.}}
{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-

|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px|Zelfmetingen]]||Zelfmetingen||||Zelfmetingen sturen||[[MedMij:V2020.01/OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||[[MedMij:V2020.01/FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|-style="background-color: white;"
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|50px|PDF/A]]||PDF/A||||PDF/A|||[[MedMij:V2020.01/OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||[[MedMij:V2020.01/FHIR_PDFA|PDF/A in FHIR]]
|-
|[[Bestand:Beelden.png|link=|50px|Beelden]]||Beelden||||Beelden sturen|||[[MedMij:V2020.01/OntwerpBeelden|Beelden]] || [[MedMij:V2020.01/FHIR_Images|Beelden in FHIR]]
|-style="background-color: white;"
|[[Bestand:vragenlijstenIcoon.png|link=MedMij:V2020.01/OntwerpVragenlijsten|50px|Vragenlijsten]]
||Vragenlijsten||||Vragenlijsten|| [[MedMij:V2020.01/OntwerpVragenlijsten|Vragenlijsten]] ||[[MedMij:V2020.01/FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Vragenlijsten in FHIR]]
|}

==Patient journeys==
{{#lsth:MedMij:V2020.01/Ontwerpen|Patient journeys}}
=Systeemrollen=
{{#lsth:MedMij:V2020.01/Ontwerpen|Systeemrollen}}
=Release notes=
{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
{{ReleaseNotes|package=2020.02 - April 2021|issues=1|MM-1976}}
{{ReleaseNotes|package=2020.02 - Maart 2021|issues=9|MM-1911|MM-1906|MM-1899|MM-1861|MM-1846|MM-1752|MM-1750|MM-1122|MM-1091}}
{{ReleaseNotes|package=2020.02 - Februari 2021|issues=10|MM-1828|MM-1787|MM-1758|MM-1722|MM-1703|MM-1662|MM-1650|MM-1578|MM-1462|MM-836}}
{{ReleaseNotes|package=2020.02 - Januari 2021|issues=8|MM-1675|MM-1651|MM-1593|MM-1592|MM-1566|MM-1465|MM-1385|MM-1292}}
{{ReleaseNotes|package=2020.02 - November 2020|issues=4|MM-1557|MM-1542|MM-1522|MM-1517}}
{{ReleaseNotes|package=2020.01 - Oktober 2020|issues=8|MM-1457|MM-1454|MM-1446|MM-1441|MM-1418|MM-1386|MM-1248|MM-791}}
{{ReleaseNotes|package=2020.01 - September 2020|issues=8|MM-1406|MM-1374|MM-1358|MM-1261|MM-1256|MM-1207|MM-1116|MM-267}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|issues=12|MM-1220|MM-1177|MM-1165|MM-1119|MM-1118|MM-1090|MM-1050|MM-1036|MM-854|MM-437|MM-433|MM-221|}}
{{ReleaseNotes|package=2019.01 - Mei 2020|issues=8|MM-1175|MM-1169|MM-1167|MM-1155|MM-1095|MM-1083|MM-1081|MM-1054|}}
{{ReleaseNotes|package=2019.01 - April 2020|issues=7|MM-1053|MM-1015|MM-1002|MM-929|MM-770|MM-672|MM-513}}
{{ReleaseNotes|package=2019.01 - Maart 2020|issues=10|MM-969|MM-947|MM-943|MM-942|MM-938|MM-930|MM-894|MM-888|MM-815|MM-751}}
{{ReleaseNotes|package=2019.01 - Februari 2020|issues=4|MM-913|MM-857|MM-831|MM-827}}
|-
| rowspan = 10; style="background-color: white;"| 2019.01 - Januari 2020
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-800 MM-800]
| style="background-color: white;"| The contact info of the ValueSets included the invalid url "<nowiki>https://www.zibs.nl</nowiki>". This has been changed to the valid url "<nowiki>https://zibs.nl</nowiki>".
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-780 MM-780]
| style="background-color: white;"| Changed equivalence type from specializes to subsumes for 2 concept mappings in ConceptMap TelecomSoortCodelijst-to-ContactPointSystem.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-778 MM-778]
| style="background-color: white;"| Added bi-directional extension to each ConceptMap and set to true if bidirectional or false if not bidirectional. Secondly added the code.specification extension to the FHIR-profiles where the extension was not added yet: zib-AllergyIntolerance, zib-Encounter, zib-Problem, nl-core-contactpoint.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-738 MM-738]
| style="background-color: white;"| Changed required binding for extensible on Patient.maritalStatus ValueSet reference in nl-core-patient FHIR-profile.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-659 MM-659]
| style="background-color: white;"| Improved searchInclude element in all CapabilityStatements based on [resource]:[search param].
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-636 MM-636]
| style="background-color: white;"| Changed the mandatory nature of the display element in coded concepts from SHALL to SHOULD.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-632 MM-632]
| style="background-color: white;"| Restructured, renamed and optimized FHIR-examples.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-619 MM-619]
| style="background-color: white;"| In the LanguageProficiency extension for nl-core-patient:
* Added description on how to use the extension in the nl-core-patient profile in relation to HCIM LanguageProficiency
* Swapped type and level
* Changed display values to more descriptive terms
* Restricted cardinality of both type and level to 1..1
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-563 MM-563]
| style="background-color: white;"| Removed unnecessary constraint on Humanname.extension:humannameassemblyOrder extension in nl-core-humanname FHIR profile.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-296 MM-296]
| style="background-color: white;"| Added explanation for the use of ConceptMaps and mappings to the FHIR IG.
|-
| rowspan = 1; style="background-color: white;"| 2019.01 - November
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-734 MM-734]
| style="background-color: white;"| Remove old ValueSet files that still lingered in the package after they were re-exported under a different file name.
|-
| rowspan = 2; style="background-color: white;"| 2019.01 - Oktober
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-580 MM-580]
| style="background-color: white;"| Some ValueSet files used a notation that is not used anymore in newer exports from ART-DECOR. The ValueSet files in the repository and package are re-exported from ART-DECOR. ValueSet files that are not used anymore are removed from the repository and package.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-229 MM-229]
| style="background-color: white;"| Added base profile nl-core-observation to FHIR profiles based on core resource Observation.
|-
| rowspan = 6; style="background-color: white;"| 2019.01 - September
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-570 MM-570]
| style="background-color: white;"|
Removed duplicate files on Simplifier with the following id's:
* MediaContentTypeCodelijst
* careplan-activity-goal
* careplan-medicaldevice
Adjusted duplicate id's in examples.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-461 MM-461]
| style="background-color: white;"| De Richtlijn paragraaf was toegespitst op BgZ. Tekst is generiek herschreven met minder nadruk op BgZ.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-441 MM-441]
| style="background-color: white;"| Verbeteren richtlijn omtrent gebruik Nederlandse vertalingen.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-438 MM-438]
| style="background-color: white;"| Toevoegen nl-core-contactpoint.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-409 MM-409]
| style="background-color: white;"| Toevoegen ontbrekende ConceptMaps en zib FHIR ValueSets.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-401 MM-401]
| style="background-color: white;"| Nadere toelichting ten aanzien van gebruik Nederlandse termen bij omschrijving van informatie (labels) in PGO.
|-
| rowspan = 3; style="background-color: white;"| 2019.01 - April
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-222 MM-222]
| style="background-color: white;"| Update verouderde tekst van richtlijn paragraaf op FO Ontwerp pagina.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-220 MM-220]
| style="background-color: white;"| Nadere toelichting ten aanzien van FHIR references.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-219 MM-219]
| style="background-color: white;"| MedicationUse niet compleet na een resave in Forge.
|-
| rowspan = 3; style="background-color: white;"| 2019.01 - Maart
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-200 MM-200]
| style="background-color: white;"| Verloren wijzigingen d.m.v. foutieve commit goed zetten.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-198 MM-198]
| style="background-color: white;"| PractitionerRole extensie ontbreekt bij Patient.generalPractitioner.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-189 MM-189]
| style="background-color: white;"| Concept PractitionerRole wijkt af van FHIR core.
|-
| rowspan = 9; style="background-color: white;"| 2019.01
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-180 MM-180]
| style="background-color: white;"| Toelichting functionele definitie via zibs, inclusief Nederlandse termen zorggegevens.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-149 MM-149]
| style="background-color: white;"| Patient.gender mist ConceptMap voor GeslachtCodelijst.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-139 MM-139]<br/>[https://bits.nictiz.nl/browse/MM-133 MM-133]
| style="background-color: white;"| PractitionerRole reference extensie toegevoegd aan elementen die naar Practitioner verwijzen.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-122 MM-122]
| style="background-color: white;"| ConceptMaps benoemen + aanmaken.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-89 MM-89]
| style="background-color: white;"| Consistentie referenties naar (zib) profielen of base resources voor niet-zib concepten.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-88 MM-88]
| style="background-color: white;"| Mapping BasisElementen ontbreekt.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-72 MM-72]
| style="background-color: white;"| Added concept name to all profile mappings from HCIMs or datasets.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-70 MM-70]
| style="background-color: white;"| Updated links in technical design pages for profiles so they have less maintenance.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-65 MM-65]
| style="background-color: white;"| Generic guidance on references added.
|-
| rowspan = 6; style="background-color: white;"| 2018.06
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-136 MM-136]
| style="background-color: white;"| Payer.PayerPerson.PayerName is a String but simplifier says it is a nl-core-humanname.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-83 MM-83]
| style="background-color: white;"| Tegenstellende definities van land tussen de Nictiz zib wiki en de FHIR standaarden.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-81 MM-81]
| style="background-color: white;"| Gebruik van AddressType in AddresInformation zib.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-77 MM-77]
| style="background-color: white;"| Ambiguïteit bij HouseNumberAddition/HouseNumberLetter.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-76 MM-76]
| style="background-color: white;"| Wat hoort er thuis in het FirstNames veld in de NameInformation zib?
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-47 MM-47]
| style="background-color: white;"| Suggestion: require display or text on codes.
|}

=Releases=
{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2020.01/Ontwerpen|2020.01]] || 2020-08-11 || Zomerrelease met wijzigingen voor MedMij-standaarden
|-
| [[MedMij:V2019.01_Ontwerpen|2019.01]] || 2019-10-18 || Use case medicatiegerelateerde allergie- en intolerantiegegevensvertaling toegevoegd
|-
| [[MedMij:V2019.01_Ontwerpen|2019.01]] || 2019-10-02 || Use case PDF/A Sturen toegevoegd
|-
| [[MedMij:V2019.01_Ontwerpen|2019.01]] || 2019-03-11 || Alle MedMij-standaarden
|-
| [[MedMij:V2018.06_Ontwerpen|2018.06]] || 2018-10-29 || Basisgegevens GGZ
|-
| [[MedMij:V2018.05_Ontwerpen|2018.05]] || 2018-09-24 || Basisgegevens GGZ voor openbare consultatie
|-
| [[MedMij:V2018.04_Ontwerpen|2018.04]] || 2018-09-02 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_Ontwerpen|2018.03]] || 2018-05-07 || BgZ 2017 en Huisartsgegevens
|-
| [[MedMij:V2018.02_Ontwerpen|2018.02]] || 2018-03-29 || BgZ 2017 voor openbare consultatie
|-
| [[MedMij:V2018.01_Ontwerpen|2018.01]] || 2018-02-21 || Huisartsgegevens voor openbare consultatie
|-
| [[MedMij:V2017.04_Ontwerpen|2017.04]] || 2017-12-18 || Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:Vprepub-2020.02/Ontwerpen

2021-05-28T13:58:47Z

Camiel Reijnders: MM-2057: Bij BgZ vermelding zib2017 uit tabel verwijderen

Bestand:2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:41:31Z

Camiel Reijnders:

Bestand:2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:41:20Z

Camiel Reijnders:

Bestand:2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:41:11Z

Camiel Reijnders:

Bestand:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen V2020.01 21330.pdf

2021-03-18T16:40:54Z

Camiel Reijnders:

Bestand:1. Kwalificatiescript - MedMij Sturen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:40:44Z

Camiel Reijnders:

Bestand:1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:40:36Z

Camiel Reijnders:

Bestand:1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:40:25Z

Camiel Reijnders:

Bestand:1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen V2020.01 20210330.pdf

2021-03-18T16:39:50Z

Camiel Reijnders:

Bestand:Journey-02 V2020.01 20210126.png

2021-01-15T08:41:58Z

Camiel Reijnders:

MedMij:V2019.01 Kwalificatie

2020-11-24T10:52:16Z

Camiel Reijnders: MM-1512: De personalia van de AllergieIntolerantie addenda zijn gewijzigd naar de personalia conform de gegevens van het SBV-Z, zodat deze opvraagbaar en verifieerbaar zijn.

{{MedMij:V2019.01_Issuebox}}
__NUMBEREDHEADINGS__





=Introductie=
<section begin=medmij_kwalificatie_introductie />
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.

Enkele systeemrollen vallen binnen de 'subsidieregeling voor PGO-leveranciers (dienstverlener persoon)' die in 2018 is opgesteld door de Dienst Uitvoering Subsidie voor Instellingen. Welke systeemrollen dat betreft vindt u in [[MedMij:V2019.01_ToelichtingSubsidie| ToelichtingSubsidie]].

Voor meer informatie, stuur een mail naar 'kwalificatie@medmij.nl'.

Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via de betreffende paragraaf op de [[MedMij:V2019.01_Kwalificatie#Kwalificatie_scripts|Kwalificatiepagina]].<section end=medmij_kwalificatie_introductie />

=Algemene voorwaarden voor kwalificatie=
Een leverancier kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van MedMij afsprakenstelsel.
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende MedMij informatiestandaard, zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten en andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in het document '''2. Addenda - Kwalificaties''' als bijlage bij de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De leverancier levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het [[MedMij:V2019.01_Ontwerpen#Algemeen_2 | functioneel ontwerp]] van de informatiestandaard.

==Systeemrol 'Raadplegen' (PGO)==
Hieronder volgt het generieke uitgangspunt voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitganspunten_Systeemrol_Raadplegen />
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.<section end=Uitganspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (XIS)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitganspunten_Systeemrol_Beschikbaarstellen />
* XIS geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt het XIS conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze moet ingebouwd worden door het XIS. Hierop wordt het XIS ook gekwalificeerd.<section end=Uitganspunten_Systeemrol_Beschikbaarstellen />

=Kwalificatie aansluiten op de kwalificatieomgeving=
MedMij biedt leveranciers de mogelijkheid hun producten en diensten te laten testen op correcte implementatie van informatiestandaarden.
Documentatie over hoe aan te sluiten is te vinden op: [[MedMij:V2019.01_Kwalificatie_aansluiten]]

=Gebruik van de simulator=

==Authorization tokens==
Voor uitleg over gebruik van de simulator en tokens, zie [[MedMij:V2019.01_Qualification]]<section end=medmij_kwalificatie_introductie />
<span id="Kwalificatiescripts"></span><section begin=medmij_kwalificatiescripts />

==Variable T datum==
Voor veel, straks alle, kwalificaties wordt er gebruik gemaakt van een variabele datum. Dit is de zogenoemde T datum welke is opgenomen in de functionele testscripts, met name in de addenda, en in de technische testscripts op Touchstone. Deze variabele datum wordt gebruikt om zo dicht mogelijk tegen een productiewaardig scenario te testen en te kwalificeren. Middels de variabele datum kunnen de testgegevens actueel blijven. Deze T datum komt op twee plekken terug, namelijk in de datumvelden van de testgegevens en in de datumparameters in de search URL's. In de volgende twee paragrafen wordt dit toegelicht.

===Kwalificatie test gegevens===
De functionele testscripts beschrijven in de addenda testgegevens waarin datum velden staan op basis van een T datum. Als ergens staat T – 100D betekent dit: 100 dagen eerder dan de datum die voor T geldt. Deze testgegevens uit de addenda worden vervolgens gebruikt om ofwel de Nictiz WildFHIR server te vullen of door kandidaat deelnemers om de testgegevens in het systeem te registreren.

Het vullen van de Nictiz WildFHIR server kon in het verleden door kandidaatdeelnemers gebeuren door het draaien van het 'load script' op basis van een op te geven variable T. Dit is nu in beheer genomen door het kwalificatie team.

'''Elke maandag wordt de Nictiz WildFHIR server geschoond en opnieuw gevuld met een testgegevens op basis van een T datum gelijk aan de datum van die maandag.'''

Bijvoorbeeld in 2019 is T datum in week 46 gelijk aan 11 november 2019.

===Parameters in de request URL's===
Bij sommige testscenario's wordt een datumfilter gebruikt. Deze datumfilters zijn ook op basis van de variabele T datum. Bij het uitvoeren van het testscript in Touchstone is het mogelijk om bij de setupfase de variabele T datum te geven. Deze T datum staat in relatie tot de testgegevens die op de Nictiz WildFHIR server of het eigen bronsysteem staan. De T datum die hier gebruikt dient te worden, is gelijk aan de datum van de maandag (waarop de gegevens geladen zijn).

Wanneer een andere T datum wordt gebruikt kan het voorkomen dat er geen of te weinig testgegevens terugkomen op de uitgevoerde test. Dit kan er toe leiden dat de test niet slaagt.

===Tijdnotatie===
Het meegeven van de tijd is bij de gestructureerde einddatum/tijd (dus niet de Resource.text, maar de velden met alleen de datum/tijd) verplicht in de standaard om eventuele verwarring tussen de precieze betekenis van "tot" en "tot en met" te voorkomen.

In de FHIR datatypes ''dateTime'' (indien uren en minuten worden gebruikt) en ''instant'' is de tijdzone verplicht. De tijdzone kan daarom niet worden weglaten uit de testgegevens.

Touchstone heeft helaas een beperking dat de Nederlandse tijdzone niet berekend kan worden bij een variabele datum. De tijdzone die nu in onze testgegevens staat, was een Nederlandse tijdzone bij de eerste keer invullen van dit scenario met concrete datums. Dit komt niet per definitie overeen met de geldende tijdzone in Nederland voor de (in een test-executie gebruikte, uiteindelijke) datum. In productie moet gerekend worden op een juiste tijdzone en het is dan ook juist om deze tijdzone gewoon te interpreteren, dit betekent dat de gegevens mogelijk soms een uur later of vroeger zijn dan in het addendum staat. Dit is geen reden voor afkeuren in kwalificatie.

=Kwalificatiescripts=
==Basisgegevensset Zorg 2.1==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BgZ.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen_BgZ.zip|3. Aanleverformat - Beschikbaarstellen_BgZ.zip]]
* [[Media: Aanleverformat - Raadplegen BgZ.zip|3. Aanleverformat - Raadplegen BgZ.zip]]

===Uitgebreide gegevensset===
Nota bene: onderstaande kwalificatiescripts bevatten een uitgebreidere gegevens set voor de BgZ. Deze worden nu '''niet''' gebruikt voor kwalificatie. Op termijn zullen deze kwalificatiescripts de huidige vervangen.

* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BGZ extended.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf|2.Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf]]

==Labuitwisseling 1.1==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten.pdf|1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten.pdf|2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten.pdf|2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip|3. Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip]]
* [[Media: Aanleverformat - Raadplegen Laboratoriumresultaten.zip|3. Aanleverformat - Raadplegen Laboratoriumresultaten.zip]]

==Medicatieproces 9.0 ==
:Een uitleg van medicatieproces voor PGO's die kwalificeren voor MedMij is beschikbaar in de vorm van:
::*[[Media:PGOsessie OpnameOnline.mp4 |Bestand (met mp4 opname) van uitleg Medicatieproces]] met bijbehorende
::*[[Media:PGOsessiesMedicatieproces_BijlageBijOnlineSessie.pdf|PowerPoint (in PDF)]].

:Diverse medicatieproces kwalificatiescripts zijn van toepassing voor zowel zorgverlener-patiënt (MedMij) als zorgverlener-zorgverlener gegevensuitwisseling. Deze kwalificatiescripts worden op één plek onderhouden en gepubliceerd. Via deze MedMij pagina wordt direct naar het betreffende kwalificatiescript verwezen (via de link).

===Medicatiegegevens===
:* [[Media:1.1 Kwalificatiescript Raadplegen medicatieafspraak907 v3.pdf|1.1. Kwalificatiescript - Raadplegen medicatieafspraak907.pdf]]
:* [[mp:V9.0.7_kwalificatie_medicatiegegevens_beschikbaarstellen_MA|1.1. Kwalificatiescript & Addenda - Beschikbaarstellen medicatieafspraak907]]
:* [[Media:1.2 Kwalificatiescript Raadplegen toedieningsafspraak907 v3.pdf|1.2. Kwalificatiescript - Raadplegen toedieningsafspraak907.pdf]]
:* [[Media:1.3 Kwalificatiescript Raadplegen medicatiegebruik907 v3.pdf|1.3. Kwalificatiescript - Raadplegen medicatiegebruik907.pdf]]
:* [[Media:1.4 Kwalificatiescript Raadplegen verstrekkingsverzoek907 v3.pdf|1.4. Kwalificatiescript - Raadplegen verstrekkingsverzoek907.pdf]]
:* [[mp:V9.0.7_kwalificatie_medicatiegegevens_beschikbaarstellen_VV|1.4. Kwalificatiescript & Addenda - Beschikbaarstellen verstrekkingsverzoek907]]
:* [[Media:1.5 Kwalificatiescript Raadplegen medicatieverstrekking907 v3.pdf|1.5. Kwalificatiescript - Raadplegen medicatieverstrekking907.pdf]]
:* [[Media:1.6 Kwalificatiescript Raadplegen medicatiegegevens AlleBouwstenen907 v3.pdf|1.6. Kwalificatiescript - Raadplegen medicatiegegevens AlleBouwstenen907.pdf]]
:* [[MedMij:V1.0_MP9.0.7-KwalificatieAddendumMedicatieafspraken|2.1. Addenda - Raadplegen medicatieafspraak907]]
:* [[MedMij:V1.0_MP9.0.7-KwalificatieAddendumToedieningsafspraken|2.2. Addenda - Raadplegen toedieningsafspraak907]]
:* [[MedMij:V1.0_MP9.0.7-KwalificatieAddendumMedicatiegebruik|2.3. Addenda - Raadplegen medicatiegebruik907]]
:* [[MedMij:V1.0_MP9.0.7-KwalificatieAddendumVerstrekkingsverzoeken|2.4. Addenda - Raadplegen verstrekkingsverzoek907]]
:* [[MedMij:V1.0_MP9.0.7KwalificatieAddendumVerstrekkingen|2.5. Addenda - Raadplegen medicatieverstrekking907]]
:* [[MedMij:V1.0_MP9.0.7-KwalificatieAddendumAlleBouwstenen|2.6. Addenda - Raadplegen medicatiegegevens AlleBouwstenen907]]
:* [[Media:Aanleverformat_-_Raadplegen_Medicatieafspraak.zip|3.1. Aanleverformat - Raadplegen medicatieafspraak907.zip]]
:* [[Media:Aanleverformat_-_Beschikbaarstellen_Medicatieafspraak.zip|3.1. Aanleverformat - Beschikbaarstellen medicatieafspraak907.zip]]
:* [[Media:Aanleverformat_-_Raadplegen_Toedieningsafspraak.zip|3.2. Aanleverformat - Raadplegen toedieningsafspraak907.zip]]
:* [[Media:Aanleverformat_-_Raadplegen_Medicatiegebruik.zip|3.3. Aanleverformat - Raadplegen medicatiegebruik907.zip]]
:* [[Media:Aanleverformat_-_Raadplegen_Verstrekkingsverzoek.zip|3.4. Aanleverformat - Raadplegen verstrekkingsverzoek907.zip]]
:* [[Media:Aanleverformat_-_Beschikbaarstellen_Verstrekkingsverzoek.zip|3.4. Aanleverformat - Beschikbaarstellen verstrekkingsverzoek907.zip]]
:* [[Media:Aanleverformat_-_Raadplegen_Medicatieverstrekking.zip|3.5. Aanleverformat - Raadplegen medicatieverstrekking907.zip]]
:* [[Media:Aanleverformat_-_Raadplegen_Medicatiegegevens.zip|3.6. Aanleverformat - Raadplegen medicatiegegevens AlleBouwstenen907.zip]]

===Medicatieoverzicht===
:* [[Media:Kwalificatiescript_Raadplegen_medicatieoverzicht907_v2.1.pdf|1. Kwalificatiescript - Raadplegen medicatieoverzicht907.pdf]]
:* [[mp:V9.0.7_kwalificatie_medicatieoverzicht_beschikbaarstellen_MA_BEPERKT|1. Kwalificatiescript & Addenda - Beschikbaarstellen medicatieoverzicht907 BEPERKT (alléén voor VIPP GGZ)]]
:* [[MedMij:V1.0_MP9.0.7-KwalificatieAddendumMedicatieoverzicht|2. Addenda - Raadplegen medicatieoverzicht907]]
:* [[Media:Aanleverformat_-_Raadplegen_Medicatieoverzicht.zip|3. Aanleverformat - Raadplegen medicatieoverzicht907.zip]]
:* [[Media:Aanleverformat_-_Beschikbaarstellen_Medicatieoverzicht.zip|3. Aanleverformat - Beschikbaarstellen medicatieoverzicht907 BEPERKT (alléén voor VIPP GGZ).zip]]

===Verstrekkingenvertaling===
:* [[Media:Kwalificatiescript_Raadplegen_verstrekkingenvertaling907_v1.2.pdf|1. Kwalificatiescript - Raadplegen verstrekkingenvertaling907.pdf]]
:* [[Media:Kwalificatiescript_Beschikbaarstellen_verstrekkingenvertaling907_v1.2.pdf|1. Kwalificatiescript - Beschikbaarstellen verstrekkingenvertaling907.pdf]]
:* [[MedMij:V1.0_MP9.A.0-AddendaInhoudelijkeGegevens|2. Addenda - Verstrekkingenvertaling907]]
:* [[Media:Aanleverformat_-_Raadplegen_Verstrekkingenvertaling.zip |3. Aanleverformat - Raadplegen Verstrekkingenvertaling907.zip]]
:* [[Media:Aanleverformat_-_Beschikbaarstellen_Verstrekkingenvertaling.zip |3. Aanleverformat - Beschikbaarstellen Verstrekkingenvertaling907.zip]]

==AllergieIntolerantie 2.0==

===AllergieIntolerantie===
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens.pdf|1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens.pdf]]
* [[Media:2. Addenda - MedMij Beschikbaarstellen AllergieIntolerantie gegevens_20201124.pdf|2. Addenda - MedMij Beschikbaarstellen AllergieIntolerantie gegevens.pdf]]
* [[Media:2. Addenda - MedMij Raadplegen AllergieIntolerantie gegevens_20201124.pdf|2. Addenda - MedMij Raadplegen AllergieIntolerantie gegevens.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip|3. Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantie.zip|3. Aanleverformat - Raadplegen AllergieIntolerantie.zip]]

===AllergieIntolerantieVertaling===
* [[MedMij:V2019.01_kw-MM-1.A-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[MedMij:V2019.01_kw-MM-1.A-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantieVertaling.zip|3. Aanleverformat - Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantieVertaling.zip|3. Aanleverformat - Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]

==eAfspraak 1.1==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf|1. Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:Aanleverformat - Raadplegen eAfspraak.zip|3. Aanleverformat - Raadplegen eAfspraak.zip]]
* [[Media:Aanleverformat - Beschikbaarstellen eAfspraak.zip|3. Aanleverformat - Beschikbaarstellen eAfspraak.zip]]

==Zelfmetingen 1.2==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Zelfmetingen.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen en Sturen Zelfmetingen.pdf|1. Kwalificatiescript - MedMij Raadplegen en Sturen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Zelfmetingen.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Zelfmetingen.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Zelfmetingen.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen en Ontvangen Zelfmetingen.zip|3. Aanleverformat - Beschikbaarstellen en Ontvangen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Raadplegen en Sturen Zelfmetingen.zip|3. Aanleverformat - Raadplegen en Sturen Zelfmetingen.zip]]

==PDF/A 2.0==
* [[Media:1._Kwalificatiescript_-_MedMij_Beschikbaarstellen_en_Ontvangen_PDFA.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen PDFA.pdf]]
* [[Media:1._Kwalificatiescript_-_MedMij_Raadplegen_en_Sturen_PDFA.pdf|1. Kwalificatiescript - MedMij Raadplegen en Sturen PDFA.pdf]]
* [[Media:2._Addenda_-_Kwalificatiescript_-_MedMij_Beschikbaarstellen_en_Ontvangen_PDFA.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen PDFA.pdf]]
* [[Media:2._Addenda_-_Kwalificatiescript_-_MedMij_Raadplegen_en_Sturen_PDFA.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen PDFA.pdf]]
* [[Media: Aanleverformat_-_Beschikbaarstellen_en_Ontvangen_PDFA.zip|3. Aanleverformat - Beschikbaarstellen en Ontvangen PDFA.zip]]
* [[Media: Aanleverformat_-_Raadplegen_en_Sturen_PDFA.zip|3. Aanleverformat - Raadplegen en Sturen PDFA.zip]]

==Huisartsgegevens 1.1==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf|1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen huisartsgegevens.zip|3. Aanleverformat - Beschikbaarstellen huisartsgegevens.zip]]
* [[Media: Aanleverformat - Raadplegen huisartsgegevens.zip|3. Aanleverformat - Raadplegen huisartsgegevens.zip]]

==Basisgegevens GGZ 1.1==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip]]
* [[Media: Aanleverformat - Raadplegen Basisgegevens GGZ.zip|3. Aanleverformat - Raadplegen Basisgegevens GGZ.zip]]

==Beelden 1.0==
* [[Media:1. Kwalificatiescript - MedMij Ontvangen beelden.pdf|1. Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen beelden.pdf|1. Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen beelden.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:Aanleverformat - Ontvangen Beelden.zip|3. Aanleverformat - Ontvangen Beelden.zip]]
* [[Media:Aanleverformat - Sturen Beelden.zip|3. Aanleverformat - Sturen Beelden.zip]]

==Basisgegevens Langdurige Zorg 1.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]
* [[MedMij:V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.1|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1]]
* [[MedMij:V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.2|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2]]
* [[MedMij:V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.3|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3]]
* [[Media:3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.pptx.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.zip]]
* [[Media:3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.pptx.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.zip]]

==Vragenlijsten 1.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf|1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]

<section end=medmij_kwalificatiescripts />

[[Categorie:Kwalificatie]]

MedMij:Vprepub-2019.01 Kwalificatie

2020-11-24T10:52:16Z

Camiel Reijnders: MM-1512: De personalia van de AllergieIntolerantie addenda zijn gewijzigd naar de personalia conform de gegevens van het SBV-Z, zodat deze opvraagbaar en verifieerbaar zijn.

MedMij:Vprepub-2020.01/OntwerpBGZ 2017

2020-11-19T13:31:14Z

Camiel Reijnders: MM-1542: Verwijzingen naar het Register van Informatiestandaarden aangepast naar de MedMij Catalogus

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp BgZ {{VersieInfo|BgZ|release=Vprepub}} (op basis van zibs release 2017)}}
{{MedMij:Vprepub/Issuebox}}

[[Bestand:BGZ_icoon.png |link=|links |87px|Use case BgZ|Patient Summary (BgZ)]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub/FHIR_BGZ_2017|Technisch]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de Basisgegevensset Zorg binnen MedMij.

De [https://www.registratieaandebron.nl/wat-is-registreren-aan-de-bron/de-kern-van-registreren-aan-de-bron/basisgegevensset/ Basisgegevensset Zorg], ofwel BgZ, is de minimale set van patiëntgegevens die specialisme, ziektebeeld en beroepsgroep overstijgend relevant is en die van belang is voor de continuïteit van zorg en is in Nederland door [https://www.registratieaandebron.nl 'Registratie aan de Bron'] gedefinieerd. Deze set aan patiëntgegevens wordt door alle zorgverleners hetzelfde vastgelegd. Hierdoor wordt uitwisseling van deze gegevens mogelijk gemaakt. De BgZ is gespiegeld aan de Europese Patient Summary.

De bekende use cases voor het uitwisselen van de BgZ zijn gericht op uitwisseling tussen zorgverleners voor spoedeisende hulp of ongeplande zorg. Tot op heden is uitwisseling vanuit het perspectief van de patiënt niet beschreven. Het doel van deze pagina is om de uitwisseling van de BgZ met de patiënt toe te voegen.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de [[MedMij:Vprepub/Ontwerpen#Doelgroep| MedMij functionele ontwerpen]].

==Kaders en uitgangspunten==
===Richtlijn===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub/Ontwerpen|medmij_kwalificatie_introductie}}

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen BgZ' en 'Beschikbaarstellen BgZ' is te vinden in [[MedMij:Vprepub/ToelichtingKwalificatieBgZ|Toelichting Kwalificatie BgZ]].

=Use Cases=
==Use case 1: Raadplegen Basisgegevensset Zorg in persoonlijke gezondheidsomgeving==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in gegevens uit de Basisgegevensset Zorg (BgZ) die over henzelf gaan.

=== Domein ===
Basisgegevensset Zorg in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de BgZ vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie,
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.1.pdf BgZ op basis van zibs release 2017] bestaat uit een selectie van 28 [https://zibs.nl/wiki/ZIB_Publicatie_2017(NL) zibs]. Deze zibs vormen samen een verzameling van patiëntgegevens die minimaal nodig is om patiënten continuïteit van zorg te kunnen bieden.

Deze use case gebruikt de structuur van 18 secties die is aangebracht in BgZ 2017. Hierin zijn de onderdelen gegroepeerd waaruit de BgZ is opgebouwd. Deze secties komen sterk overeen met de secties van [https://www.nictiz.nl/wp-content/uploads/2012/09/Alles-wat-je-wilt-weten-over-CCR-CCD-v1-0.pdf CCR/CCD] en maken het o.a. mogelijk om in de technische implementatie (bv FHIR) structuur aan te brengen. In de [[MedMij:Vprepub/FHIR_IG | MedMij FHIR implementatie gids]] staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:Vprepub/FHIR_BGZ_2017#List_of_StructureDefinitions | overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

Voor het gebruik van codestelsel geldt de [[MedMij:Vprepub/Ontwerpen#Richtlijn|algemene richtlijn]].

====Raadplegen BgZ====
Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de BgZ. Bij het raadplegen van de BgZ wordt om alle gegevens behorende bij de patiënt gevraagd.

====Beschikbaarstellen BgZ====
Informatie-elementen in de BgZ staan hieronder. Deze informatie is ook in een [https://decor.nictiz.nl/pub/bgz2017/bgz2017-html-20190313T152910/tr-2.16.840.1.113883.2.4.3.11.60.42.4.37-2018-08-30T093049.html nieuw tabblad] te openen. Bij het beschikbaarstellen van de BgZ worden alle beschikbare gegevens behorende bij de patiënt beschikbaargesteld.

<html>
<iframe width="100%" height="800" src=https://decor.nictiz.nl/pub/bgz2017/bgz2017-html-20190313T152910/tr-2.16.840.1.113883.2.4.3.11.60.42.4.37-2018-08-30T093049.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Deze use case onderscheidt twee bedrijfsrollen, namelijk de ''Patiënt'' en de ''Zorgaanbieder'' zoals te zien in onderstaande tabel.

{| class="wikitable" "cellpadding="10" width="100%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt (PGO)
|style="background-color: white;vertical-align:top;"|Wil de eigen BgZ raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (XIS)
|style="background-color: white;vertical-align:top;"|Stelt de BgZ beschikbaar
|}


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

[[Bestand:InzienBGZ activity.PNG|Activiteitendiagram Raadplegen BgZ]]


=== Procesbeschrijving ===
==== Patient journey - Thomas van Beek ====
De 'patient journey' van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf Thomas van Beek] beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar BgZ.

<blockquote>Voor zijn afstuderen verhuist Thomas 9 maanden naar Groningen. Hij gaat daar bij een heel leuk bedrijf stagelopen. Om het voor hem makkelijk te maken en omdat hij een arts dicht in de buurt wil hebben, schrijft hij zich in bij het ziekenhuis in Groningen. Hiervoor moet het ziekenhuis in Amsterdam alle gegevens van Thomas overdragen aan het ziekenhuis in Groningen. Zo weet de nieuwe arts van Thomas precies wat het verloop van de diabetes is. Thomas is zelf eigenlijk wel nieuwsgierig naar zijn medische gegevens die verstuurd worden. In zijn PGO vindt hij de belangrijkste gegevens die over hem bekend zijn.</blockquote>

==== Proces ====
Het stuk van het proces waar het in deze use case omgaat is:
* Het systeem van een zorgaanbieder (XIS) stelt de BgZ van de patiënt beschikbaar aan het systeem van een patiënt (PGO).

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van de BgZ tussen het betreffende XIS en het eigen PGO.

De BgZ, of een gedeelte van de BgZ, welke de persoon wil inzien, bestaat en de zorgaanbieder (XIS) wil deze beschikbaarstellen.
:Soms zijn er valide redenen om de BgZ, of gedeeltes daarvan, tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om de BgZ op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

===== Proces stappen =====
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| Het systeem van de patiënt (PGO) raadpleegt het systeem van de zorgaanbieder (XIS) voor de BgZ van de patiënt.
|-
| style="background-color: white;"| 02
| style="background-color: white;"| Het systeem van de zorgaanbieder (XIS) maakt (een deel van) de BgZ beschikbaar voor de patiënt.
|-
| style="background-color: white;"| 03
| style="background-color: white;"| De patiënt gebruikt de persoonlijke gezondheidsomgeving (PGO) om de BgZ in te zien.
|}

===== Post conditie =====
De persoon kan de Basisgegevensset Zorg inzien via een persoonlijke gezondheidsomgeving (PGO).

=== Systemen & Systeemrollen ===
Zowel patiënt als zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de BgZ van zorgaanbieder naar de patiënt.

{| 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;"| BGZRaadplegend
| style="background-color: white;"| MM-{{VersieInfo|BgZ|release=Vprepub}}-BZR-FHIR
| style="background-color: white;"| Raadplegen BgZ bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| BGZBeschikbaarstellend
| style="background-color: white;"| MM-{{VersieInfo|BgZ|release=Vprepub}}-BZB-FHIR
| style="background-color: white;"| Beschikbaarstellen BgZ aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:InzienBGZ_componenten.PNG|Componenten diagram]]


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

{| 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:middle;" rowspan="2"|BgZ (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen BgZ
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgZ|release=Vprepub}}-BZR-FHIR]]
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub/FHIR_BGZ_2017|BgZ in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen BgZ
|style="background-color: white;vertical-align:top;"|MM-{{VersieInfo|BgZ|release=Vprepub}}-BZB-FHIR]]
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:InzienBGZ_useCase.PNG|Use case diagram inzien BgZ]]


=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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;"| Basisgegevensset Zorg
| style="background-color: white;"| -
| style="background-color: white;"| 12-08-2019
| style="background-color: white;"| [https://www.registratieaandebron.nl/alles-over-de-bgz/de-basisgegevensset-zorg Alles over de BgZ]
| style="background-color: white;"| Registratie aan de bron (RadB)
|-
| style="background-color: white;"| -
| style="background-color: white;"| BgZ - specificatie gebaseerd op zibs release 2017
| style="background-color: white;"| 1.1
| style="background-color: white;"| 19-04-2018
| style="background-color: white;"| [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.1.pdf BgZ - specificatie gebaseerd op zibs release 2017]
| style="background-color: white;"| Registratie aan de bron (RadB)
|-
| style="background-color: white;"| Albert-Jan Spruyt & Jan A. Hazelzet
| style="background-color: white;"| Alles wat je wilt (moet) weten over CCR/CCD
| style="background-color: white;"| 1.0
| style="background-color: white;"| 13-09-2012
| style="background-color: white;"| [https://www.nictiz.nl/wp-content/uploads/2012/09/Alles-wat-je-wilt-weten-over-CCR-CCD-v1-0.pdf Alles wat je wilt (moet) weten over CCR/CCD]
| style="background-color: white;"| Nictiz
|}


=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vprepub/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
{{ReleaseNotes|package=2020.01 - Oktober 2020|release=3.0.2|issues=3|MM-1455|MM-1444|MM-1420}}
{{ReleaseNotes|package=2020.01 - September 2020|release=3.0.1|issues=4|MM-1285|MM-1283|MM-1011|MM-517}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|release=3.0.0|issues=10|MM-1204|MM-972|MM-898|MM-767|MM-616|MM-614|MM-507|MM-419|MM-404|MM-319}}
{{ReleaseNotes|package=2019.01 - Mei 2020|release=2.1.14|issues=1|MM-1094}}
{{ReleaseNotes|package=2019.01 - April 2020|release=2.1.13|issues=3|MM-1025|MM-1003|MM-939}}
{{ReleaseNotes|package=2019.01 - Maart 2020|release=2.1.10|issues=4|MM-997|MM-953|MM-926|MM-657}}
{{ReleaseNotes|package=2019.01 - Februari 2020|release=2.1.9|issues=5|MM-901|MM-900|MM-852|MM-440|MM-414}}
{{ReleaseNotes|package=2019.01 - Januari 2020|release=2.1.8|issues=2|MM-492|MM-467}}
{{ReleaseNotes|package=2019.01 - November|packageIssues=3|release=2.1.7|MM-806}}
{{ReleaseNotes|release=2.1.6|issues=2|MM-729|MM-430}}
{{ReleaseNotes|package=2019.01 - Oktober|release=2.1.5|issues=2|MM-597|MM-594}}
{{ReleaseNotes|package=2019.01 - September|release=2.1.4|issues=5|MM-436|MM-425|MM-422|MM-359|MM-358}}
{{ReleaseNotes|package=2019.01|packageIssues=28|release=2.1.3|issues=6|MM-348|MM-346|MM-307|MM-294|MM-258|MM-248}}
{{ReleaseNotes|release=2.1.2|MM-219}}
{{ReleaseNotes|release=2.1.1|issues=2|MM-210|MM-206}}
{{ReleaseNotes|release=2.1.0|issues=19|MM-174|MM-161|MM-145|MM-144|MM-143|MM-142|MM-141|MM-134|MM-127|MM-125|MM-118|MM-115|MM-100|MM-99|MM-98|MM-94|MM-50|MM-42|MM-41}}
{{ReleaseNotes|package=2018.06|release=2.0.1|issues=6|MM-174|MM-128|MM-66|MM-55|MM-54|MM-23}}
|}

MedMij:V2020.01/OntwerpBGZ 2017

2020-11-19T13:31:14Z

Camiel Reijnders: MM-1542: Verwijzingen naar het Register van Informatiestandaarden aangepast naar de MedMij Catalogus

MedMij:Vprepub-2020.01/Kwalificatie FAQ

2020-11-19T13:27:20Z

Camiel Reijnders: MM-1542: Verwijzingen naar het Register van Informatiestandaarden aangepast naar de MedMij Catalogus

{{MedMij:Vprepub/Issuebox}}
=Kwalificatie Proces=
'''Wat is de gemiddelde doorlooptijd van een (pre-)kwalificatie'''
<div class="mw-collapsible mw-collapsed">
Een kwalificatieslot start altijd op maandag.
De gemiddelde doorlooptijd voor een DVP kwalificatie bedraagt één werkweek en voor een DVZA twee werkweken.</div>

'''Wanneer krijg ik terugkoppeling over mijn kwalificatie?'''
<div class="mw-collapsible mw-collapsed">
* Een DVP kwalificatie beslaat één werkweek en start altijd op maandag.
** Indien het materiaal niet volledig is of er blokkerende punten zijn op technisch vlak (geen 100% score op de Touchstone testexecutie), wordt dat op maandag al teruggekoppeld.
** Indien het materiaal volledig is en er geen blokkerende punten worden gevonden op technisch vlak, wordt het materiaal functioneel beoordeeld en vindt er uiterlijk vrijdag finale terugkoppeling plaats.
* Een DVZA kwalificatie beslaat twee werkweken en start altijd op maandag.
** In de eerste week wordt het materiaal technisch beoordeeld en indien deze positief is bevonden, vindt de functionele beoordeling plaats in week twee.
** Indien het materiaal niet volledig is, wordt dat op maandag in de eerste week al teruggekoppeld. Er vindt geen technische en functionele beoordeling plaats.
** Indien er op technisch vlak blokkerende punten zijn wordt dit op vrijdag in de eerste week teruggekoppeld. Er vindt geen functionele beoordeling plaats.
** Indien er op technisch vlak geen blokkerende punten zijn wordt de functionele beoordeling uitgevoerd en vindt terugkoppeling plaats op vrijdag in de tweede week.
</div>

'''Hoe moet ik de schermprinten aanleveren?'''
<div class="mw-collapsible mw-collapsed">
Op de kwalificatiepagina tref je de aanleverformaten onder het kopje [[MedMij:Vprepub/Kwalificatie#Kwalificatiebenodigdheden|kwalificatiebenodigdheden]]. In het aanleverformat wordt aangegeven of de screenshots per scenario of per sectie uit een scenario aangeleverd dienen te worden. </div>

'''Wat is het verschil tussen een pre-kwalificatie, kwalificatie, kwalificatie 2 etc.?'''
<div class="mw-collapsible mw-collapsed">
De termen pre-kwalificatie, kwalificatie, kwalificatie 2, etc. zijn arbitrair. De pre-kwalificatie is het eerste toetsmoment en de kwalificatie het tweede toetsmoment. Indien je positief door de pre-kwalificatie heen komt, is er geen vervolg meer nodig voor dezelfde gegevensdienst. De pre-kwalificatie is dus gelijk aan de kwalificatie en dient niet gebruikt te worden als “oefenmoment” om het systeem functioneel of technisch te testen.
Normaliter spreken we een herstelperiode van één week af tussen de pre-kwalificatie en kwalificatie om alle fouten te herstellen. Mocht er behoefte zijn aan meer tijd om de blokkerende punten te herstellen, dan kan dat ingepland worden. Indien tijdens de kwalificatie niet alle blokkerende punten zijn opgelost dient er een nieuw kwalificatieslot aangevraagd te worden. We spreken dan over kwalificatie 2, 3 enzovoorts. </div>

'''Ik heb mijn materiaal hersteld, kan ik het direct aanleveren?'''
<div class="mw-collapsible mw-collapsed"> Nee, dat kan niet. Om er zeker van te zijn dat we het materiaal kunnen ontvangen en volgens de procedurele afspraken kunnen beoordelen, kan het materiaal alleen worden aangeleverd indien er een kwalificatieslot gepland staat. Afwijken hiervan kan alleen in overleg met en na akkoord van het kwalificatiecentrum. </div>

'''Ik wil graag een (technisch) expert spreken over mijn kwalificatie of Touchstone. Hoe kan ik dat het snelst doen?'''
<div class="mw-collapsible mw-collapsed"> Het snelste kun je hen bereiken door een issue te loggen in BITS, onder het project voor de MedMij-standaarden. Hier komt het direct bij de juiste experts terecht. </div>

'''Ik kan niet het volledige kwalificatiescript ondersteunen, wat nu?'''
<div class="mw-collapsible mw-collapsed"> Om veilige gegevensuitwisseling te kunnen garanderen is het van belang dat het volledige kwalificatiescript wordt ondersteund. Kun je hier niet aan voldoen, is het van belang dit ruim voorafgaand aan je kwalificatie te loggen via BITS, onder het project voor de MedMij-standaarden t.a.v. de informatiestandaard die je wil kwalificeren. Kaart je dit pas aan tijdens kwalificatie of wordt dit tijdens kwalificatie door de (technische) kwalificatiespecialist geconstateerd, zal dit leiden tot vertraging in het kwalificatieproces. Zie ook de [[MedMij:Vprepub/Kwalificatie#Procedurele_eisen_voor_kwalificatie|procedurele eisen]] op de kwalificatiepagina. </div>

'''Ik loop uit en ben bang dat ik mijn acceptatieslot niet ga redden, wat nu?'''
<div class="mw-collapsible mw-collapsed"> Kwalificatie is een voorwaarde voor Acceptatie. Zodra er vermoeden is van uitloop, wordt het aangeraden contact op te nemen met Acceptatie om de mogelijkheden te bespreken. </div>

'''Ik ben een integrator en kan geen schermprinten aanleveren, wat nu?'''
<div class="mw-collapsible mw-collapsed"> Het doel van kwalificatie is: een betekenisvol oordeel vellen of een systeem de systeemrol conform de in de informatiestandaard gestelde eisen op juiste wijze
ondersteunt. Zie ook onze [https://www.medmij.nl/wp-content/uploads/2020/04/Factsheet-DVZA-kwalificatie.pdf factsheet voor DVZA kwalificaties]. </div>

=Functionele Kwalificatie=
'''Waar vind ik de eisen terug?'''
<div class="mw-collapsible mw-collapsed"> Het is belangrijk alle functionele en technische eisen goed door te nemen en geïmplementeerd te hebben voorafgaand aan de kwalificatiepogingen. De eisen die gesteld worden, verschillen per gegevensdienst.
* Op de [[MedMij:Vprepub/Kwalificatie|kwalificatiepagina]] staan de uitgangspunten en procedurele eisen voor kwalificatie. Hier vind je eveneens de addenda en de kwalificatiescripts.
* Voor een actueel overzicht van gegevensdiensten, met een verwijzing naar kwalificatie-informatie per systeemrol, raadpleeg de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus]. Via de catalogus kan doorgeklikt worden naar het functioneel ontwerp en technisch ontwerp per systeemrol. </div>

'''Binnen de standaard wordt een oudere zibversie vereist, dan de laatste release van zibs. Mag een nieuwere versie van de zib worden geïmplementeerd?'''
<div class="mw-collapsible mw-collapsed">
* De standaarden voor MedMij zijn inderdaad gebaseerd op de zibversie 2017 release. Binnen MedMij wordt niet op zibs maar op informatiestandaarden gekwalificeerd. Daarom zijn de zibs die in een standaard worden gebruikt leidend.
* Het advies is om zibs versie 2017 in te bouwen, omdat deze momenteel ondersteund worden in het MedMij-afsprakenstelsel. Wanneer een (kandidaat-)deelnemer ervoor kiest om een nieuwere versie van de zibs te implementeren moet er rekening mee worden gehouden dat deze niet compatibel zijn met oudere versies die vereist zijn voor uitwisseling binnen het afsprakenstelsel. </div>

'''Hoe werkt de variabele T?'''
<div class="mw-collapsible mw-collapsed">
<br /> Voor veel kwalificaties wordt er gebruik gemaakt van een variabele datum. Dit is de zogenoemde T datum welke is opgenomen in de functionele testscripts, met name in de addenda, en in de technische testscripts op Touchstone. Deze variabele datum wordt gebruikt om zo dicht mogelijk tegen een productiewaardig scenario te testen en te kwalificeren. Middels de variabele datum kunnen de testgegevens actueel blijven. Deze T datum komt op twee plekken terug, namelijk in de datumvelden van de testgegevens en in de datumparameters in de search URL's. In de volgende twee paragrafen wordt dit toegelicht.
<br /> De functionele testscripts beschrijven in de addenda testgegevens waarin datumvelden staan op basis van een T datum. Als ergens staat T – 100D betekent dit: 100 dagen eerder dan de datum die voor T geldt. Deze testgegevens uit de addenda worden vervolgens gebruikt om ofwel de Nictiz WildFHIR-server te vullen of door kandidaat deelnemers om de testgegevens in het systeem te registreren. </div>

'''Hoe stel ik datum T in?'''
<div class="mw-collapsible mw-collapsed">
<br /> Het vullen van de Nictiz WildFHIR-server kon in het verleden door kandidaatdeelnemers gebeuren door het draaien van het 'load script' op basis van een op te geven variable T. Dit is nu in beheer genomen door het kwalificatie team. Elke maandag wordt de Nictiz WildFHIR-server geschoond en opnieuw gevuld met een testgegevens op basis van een T datum gelijk aan de datum van die maandag. Bijvoorbeeld in 2019 is T datum in week 46 gelijk aan 11 november 2019. </div>

''' Hoe werken parameters in de request URL's? '''
<div class="mw-collapsible mw-collapsed">
<br /> Bij sommige testscenario's wordt een datumfilter gebruikt. Deze datumfilters zijn ook op basis van de variabele T datum. De T datum die hier gebruikt dient te worden, is gelijk aan de datum van de maandag (waarop de gegevens geladen zijn). Wanneer een andere T datum wordt gebruikt kan het voorkomen dat er geen of te weinig testgegevens terugkomen op de uitgevoerde test. Dit kan er toe leiden dat de test niet slaagt. </div>

=Technische Kwalificatie=
Het technisch op de juiste manier FHIR-berichten genereren, blijkt in de praktijk vaak niet bij de eerste kwalificatie goed te gaan en levert daarmee vertraging op in het kwalificatieproces. Om het kwalificatieproces soepeler te laten verlopen, is een overzicht gemaakt van fouten in de FHIR-berichten die het vaakst opduiken tijdens de technische kwalificatie.
In het hieronder volgende overzicht wordt duidelijk gemaakt:
* Welke informatiestandaard wordt geraakt.
* Wat de fout betreft.
* Waar de fout doorgaans in het bericht te vinden is.
* De ernst van de fout (blokkerend betekent dat herkwalificatie nodig is).
* Uitleg over de fout met, waar mogelijk, links naar de relevante informatie en/of een stuk voorbeeldcode over wat verwacht wordt in de technische kwalificatie.
Het is sterk aan te raden om zelf voorafgaand aan de kwalificatie met behulp van deze tabel te controleren of FHIR-berichten correct worden gegenereerd. Bij verdere vragen kan een ticket worden ingeschoten in BITS op het MedMij-project.

Disclaimer: de gegeven voorbeelden zijn in XML, dit kan in de praktijk ook JSON zijn.

{| class="wikitable sortable mw-collapsible"
! Informatiestandaard !! Veelvoorkomende fouten !! Element !! Blokkerend !! Uitleg
|-
| Alle || Resource.id ontbreekt || Resource.id || Ja, maar || Zie [[MedMij:Vprepub/FHIR_IG#When_is_id_expected.3F|FHIR IG: when is id expected?]]
|-
| Alle || Bundle.entry.fullUrl en Resource.id zijn niet consistent || Resource.id || Ja, maar ||
Zie [[MedMij:Vprepub/FHIR_IG#Logical_ids.2C_fullUrls_and_references_in_Bundles|FHIR IG: fullUrls and references in Bundles]]

Fout
<syntaxhighlight lang="xml">

<entry>
<fullUrl value="http://example.org/fhir/AllergyIntolerance/f9125272-8305-11ea-5462-020000000000"/>
<resource>
<AllergyIntolerance>
<id value="allergy-01"/>

--------

<entry>
<fullUrl value="urn:oid:2.16.528.1.1007.3.3.2222"/>
<resource>
<Practitioner>
<id value="practitioner-01"/>
</syntaxhighlight>

Goed

<syntaxhighlight lang="xml">

<entry>
<fullUrl value="http://example.org/fhir/AllergyIntolerance/f9125272-8305-11ea-5462-020000000000"/>
<resource>
<AllergyIntolerance>
<id value="f9125272-8305-11ea-5462-020000000000"/>

--------

<entry>
<fullUrl value="urn:oid:2.16.528.1.1007.3.3.2222"/>
<resource>
<Practitioner>
<id value="2.16.528.1.1007.3.3.2222"/>

</syntaxhighlight>
|-
| Alle || Bundle.entry.fullUrl mag niet een relatieve URL zijn || Bundle.entry.fullUrl || Ja || Indien Bundle.entry.fullUrl URL's zijn, moeten deze absoluut zijn en niet relatief. De references binnen een resource mogen wel relatief te zijn als dit een URL is.

Verwacht in fullUrl is een absolute URL, een UUID of een OID. Zie

*https://www.hl7.org/fhir/STU3/bundle-definitions.html#Bundle.entry.fullUrl

*https://www.hl7.org/fhir/STU3/bundle.html#bundle-unique

*https://www.hl7.org/fhir/STU3/bundle.html#references"
<syntaxhighlight lang="xml">

<entry>
<fullUrl value="urn:oid:2.16.840.1.113883.2.4.6.6.90000258.4.6.525"/>
</syntaxhighlight>
|-
| Alle || FHIR-resources bevatten niet alle in het script gevraagde informatie || || Ja, maar || Voor kwalificatie doeleinden is het verplicht om alle informatie zoals vermeld in het addendum, mee te geven in het FHIR-bericht of te tonen in de user interface.
FHIR-profielen maken het mogelijk dat bepaalde informatie niet in alle gevallen bekend is en dwingen dus weinig af. Bij kwalificatie echter is de informatie wel bekend via het kwalificatiescript. Uitzonderingen kunnen gemaakt worden, bijvoorbeeld indien een XIS een bepaalde zib of data-element niet ondersteund. Per item dient dit voorafgaand kwalificatie te worden besproken en gewogen.

https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_Kwalificatie#Kwalificatie_scripts

|-
| Alle || FHIR-resources valideren niet tegen het verwachte profiel || || Ja || Controleer voor elk profiel in Simplifier of alle verplichte elementen zijn meegenomen. Deze verplichte elementen hoeven niet altijd onderdeel te zijn van het addendum. De validator in Touchstone geeft hier naar alle waarschijnlijkheid een foutmelding over, maar hoeft niet te resulteren in een gefaalde test. Let daarom goed op of de test een 'w' voor warning oplevert. Bij onduidelijkheid omtrent de waarschuwing kan een ticket in BITS worden aangemaakt.

|-
| Alle || Datatype Reference, Coding of CodeableConcept mist display || Meerdere elementen per resource mogelijk || Ja || Bij elke reference en CodeableConcept is een display value verplicht. Zie hiervoor de specificaties van het reference datatype in MedMij:
* https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_FHIR_IG#Use_of_the_reference_datatype
* https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_FHIR_IG#Use_of_coded_concepts
<syntaxhighlight lang="xml">
<generalPractitioner>
<reference value="Organization/nl-core-organization-01"/>
<display value="Maatschap Vaste Huisarts"/>
</generalPractitioner>
</syntaxhighlight>
|-
| Alle || Extensie code-specification waarin de zibwaarde staat, ontbreekt || Meerdere elementen per resource mogelijk || Ja, op plaatsen waar de mapping niet 1-op-1 is || De extensie code-specification is bedoeld voor het meegeven van de oorspronkelijke zibwaarde als de FHIR-resource dat op die plaats niet direct toelaat. Dat zijn vaak statuscodes waarvoor FHIR zelf verplichte terminologie heeft. Om geen zibinformatie kwijt te raken, bijvoorbeeld omdat de mapping op de FHIR codes niet geheel 1-op-1 is, is meegeven van de zibwaarde dus van belang.

Bijvoorbeeld: gender (https://zibs.nl/wiki/Patient-v3.1(2017NL)), adres (soort, landcode, nummergebruik https://zibs.nl/wiki/Adresgegevens-v1.0(2017NL), naam (use, https://zibs.nl/wiki/Naamgegevens-v1.0.1(2017NL)) en eventueel andere.
<syntaxhighlight lang="xml">
<gender value="male">
<extension url="http://nictiz.nl/fhir/StructureDefinition/code-specification">
<valueCodeableConcept>
<coding>
<system value="http://hl7.org/fhir/v3/AdministrativeGender"/>
<code value="M"/>
<display value="Man"/>
</coding>
</valueCodeableConcept>
</extension>
</gender>
</syntaxhighlight>
|-
| Alle || Burgerservicenummer mag niet worden gebruikt in query en/of resources || || Ja || Het MedMij-afsprakenstelsel definieert op basis van vigerende wetgeving dat burgerservicenummers niet mogen worden uitgewisseld. Uitzondering vormen plaats waar het onredelijk of onmogelijk is om te eisen dat deze worden verwijderd, zoals in een PDF-document.

Gebruik in query-parameters zoals patient of subject, in een Bundle.link, als Patient.id, Patient.identifier en andere gestructureerde locaties op basis van BSN is niet toegestaan.
|-
| Alle || Resource.text ontbreekt. Ook bekend als Narrative || Resource.text || Ja, maar || Resource.text is SHOULD en moet dan een klinisch relevante/veilige samenvatting bieden van hetgeen in de resource staat. Om discussie te voorkomen over wat wel of niet klinisch relevant is, wordt geadviseerd om alle elementen uit het bericht, toe te voegen aan de narrative. Een ontvanger MAG deze gebruiken om te tonen. Slechts in een enkel geval zoals bij conformance resources (StructureDefinition, ValueSet etc.) een text element met status empty te gebruiken. Uitzondering op dit alles is de contained resource. Deze MAG GEEN text hebben. Zie

* https://www.hl7.org/fhir/STU3/domainresource-definitions.html#DomainResource.text

* https://www.hl7.org/fhir/STU3/narrative.html
|-
| Alle || FHIR server heeft geen CapabilityStatement, of kan deze niet opleveren met de verwachte minimale inhoud bij de informatiestandaard || || Ja || Geen CapabilityStatement beschikbaar op het /metadata endpoint. Dit is een SHALL vanuit de FHIR spec: https://www.hl7.org/fhir/stu3/http.html#2.21.0
|-
| Alle || Bundle van type searchset moet Bundle.link bevatten || Bundle.link || Ja || Bundle.link heeft een SHALL in de FHIR spec, zie voor meer informatie:
* http://hl7.org/fhir/STU3/bundle-definitions.html#Bundle.link
* https://www.hl7.org/fhir/stu3/search.html#conformance
<syntaxhighlight lang="xml">
<link>
<relation value="self"/>
<url value="http://nictiz.wildfhir.org/fhir3-i2/AllergyIntolerance?"/>
</link>
</syntaxhighlight>
|-
| Alle || HumanName mist extensies voor het identificeren van de verschillende naamdelen || HumanName.family || Ja || Bij HumanName.family wordt een extensie verwacht die extra informatie geeft over de naamdelen, zoals voorgeschreven door de zib. https://zibs.nl/wiki/Naamgegevens-v1.0.1(2017NL) https://simplifier.net/NictizSTU3-Zib2017/nl-core-humanname
<syntaxhighlight lang="xml">
<family value="Jongeneel-de Haas">
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
<valueString value="Jongeneel"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix">
<valueString value="de "/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/humanname-partner-name">
<valueString value="Haas"/>
</extension>
</family>

<given value="Irma">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
<valueCode value="CL"/>
</extension>
</given>
<given value="I.">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
<valueCode value="IN"/>
</extension>
</given>
</syntaxhighlight>
|-
| Alle || Address mist extensies voor het identificeren van de verschillende adresdelen || Address.line || Ja || Bij Address.line wordt een extensie verwacht die gebruikt wordt om elk specifiek onderdeel van het Address de kunnen onderscheiden, zoals voorgeschreven door de zib.
* https://zibs.nl/wiki/Adresgegevens-v1.0(2017NL)
* https://simplifier.net/NictizSTU3-Zib2017/nl-core-address
<syntaxhighlight lang="xml">
<address>
<extension url="http://fhir.nl/fhir/StructureDefinition/nl-core-address-official">
<valueBoolean value="true"/>
</extension>
<use value="home"/>
<type value="both"/>
<line value="Straatweg 12bII">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
<valueString value="Straatweg"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
<valueString value="12"/>
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix">
<valueString value="bII"/>
</extension>
</line>
</syntaxhighlight>
|-
| PDF/A || Onjuist gebruik of afwezigheid identifier en/of masteridentifier || resource.masterIdentifier of resource.Identifier || Ja || De DocumentManifest.masterIdentifier en DocumentReference.masterIdentifier dienen door het XIS zelf te worden gegeneerd, met een eigen system. De .masterIdentifier is de versie specifieke identifier waar de .identifier een versie onafhankelijke identifier kan zijn (https://www.hl7.org/fhir/stu3/documentmanifest-definitions.html#DocumentManifest.masterIdentifier)
|}

MedMij:V2020.01/Kwalificatie FAQ

2020-11-19T13:27:20Z

Camiel Reijnders: MM-1542: Verwijzingen naar het Register van Informatiestandaarden aangepast naar de MedMij Catalogus

MedMij:Vprepub-2020.01/Kwalificatie

2020-11-19T13:22:23Z

Camiel Reijnders: MM-1542: Verwijzingen naar het Register van Informatiestandaarden aangepast naar de MedMij Catalogus

{{MedMij:Vprepub/Issuebox}}
__NUMBEREDHEADINGS__





=Introductie=
Nictiz beheert voor Stichting MedMij de informatiestandaarden die binnen MedMij gebruikt worden. Om de informatiestandaarden te kunnen toepassen binnen MedMij, zijn gegevensdiensten gedefinieerd die bestaan uit één of meerdere systeemrollen vanuit een informatiestandaard. Stichting MedMij omschrijft de gegevensdiensten en bepaalt vanaf wanneer en tot hoelang de gegevensdienst op het MedMij-netwerk gebruikt kan worden. Dit doet Stichting MedMij in samenspraak met Nictiz als beheerder. Voor een actueel overzicht van gegevensdiensten, met een verwijzing naar kwalificatie-informatie per systeemrol, raadpleeg de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus].

Voor het implementeren van informatiestandaarden en daaruit de gedefinieerde gegevensdiensten voor MedMij, is een Nictiz kwalificatie van toepassing. De kwalificaties worden uitgevoerd door het kwalificatiecentrum van Nictiz en vinden plaats per systeemrolcode. De systeemrolcode vormt de koppeling van een (MedMij) informatiestandaard aan een, in de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus] vermelde, gegevensdienst van het MedMij-netwerk.

Kwalificatiescripts en meer informatie over een kwalificatie zijn te vinden via de betreffende paragrafen onder [[MedMij:Vprepub/Kwalificatie#Kwalificatiebenodigdheden|kwalificatiebenodigdheden]].<section end=medmij_kwalificatie_introductie />

Voor een optimaal verloop van de kwalificatie is het belangrijk dat via de juiste kanalen wordt gecommuniceerd. Raadpleeg hiervoor het onderstaand communicatiekanalenoverzicht:
* Procedure en planninggerelateerde vragen: [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl]
* Inhoudelijke vragen of opmerkingen over de implementatie van informatiestandaarden en gegevensdiensten: [https://bits.nictiz.nl/projects/MM BITS]
* Algemene vragen MedMij: [mailto:info@medmij.nl info@medmij.nl]

In onze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vprepub/Kwalificatie_FAQ FAQ] tref je de veelgestelde vragen tijdens het kwalificatietraject.

== Kwalificatie gebruik van terminologie ==
Op de kwalificatiepagina wordt gesproken over DVP en PGO of DVZA en XIS. <br>
Een DVP dient altijd te kwalificeren met een PGO en een DVZA dient altijd te kwalificeren met achterliggend bronsysteem of bronsystemen (XIS).

{| class="wikitable"
|-
| '''DVP''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert een Persoonlijke gezondheidsomgeving, een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''DVZA''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert Diensten aan de Zorgaanbieder gerelateerd aan de uitwisseling tussen Persoon en Zorgaanbieder en committeert zich hiervoor aan de naleving van de afspraken van het MedMij Afsprakenstelsel.
|-
| '''Persoonsdomein''' || Alle Personen en alle Dienstverleners personen vormen samen het Persoonsdomein.
|-
| '''PGO''' || Een Persoonlijke gezondheidsomgeving is een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''XIS''' || Het systeem of geheel van de systemen waarin de zorgaanbieder het medisch dossier van de persoon bijhoudt.
|-
| '''Zorgaanbiedersdomein''' || Alle Zorgaanbieders en alle Dienstverleners zorgaanbieder vormen samen het Zorgaanbiedersdomein.
|}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vprepub/Ontwerpen MedMij informatiestandaard], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in het document '''2. Addenda - Kwalificaties''' als bijlage van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
Naast de bovengenoemde algemene voorwaarden voor kwalificatie dient een kwalificerende (kandidaat-) deelnemer ook te voldoen aan de procedurele eisen voor kwalificatie. Om het kwalificatietraject niet onnodig te vertragen wordt van een (kandidaat-) deelnemer verwacht dat deze de onderstaande procedurele eisen in acht neemt.

* Indien niet kan worden voldaan aan de functionele en/of technische eisen van een gegevensdienst, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Indien gebruik gemaakt wordt van de vrijheidsgraden die de gegevensdiensten BgGGZ, BgLZ, BgZ en PDF/a bieden, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* De testexecutie dient 100% succesvol geslaagd te zijn voordat gestart kan worden met de kwalificatie. Indien dit niet het geval is dient dit '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Het uitgevoerde certificering-testscript dient niet ouder te zijn dan één week voor de aanlevering van het (pre)kwalificatiemateriaal. Nictiz staat in zijn recht om te bepalen of een test executie is verouderd en daarom af te wijzen.
* Bij het instellen van een variabele T datum door een DVZA, dient de datum gelijk te zijn aan de datum waarop de Touchstone testexecutie is uitgevoerd.
* Voor zowel DVP als DVZA geldt dat de schermafdrukken overeen dienen te komen met de uitgevoerde Touchstone testexecutie die is bijgevoegd in het aanleverformat. Wanneer hier niet aan wordt voldaan leidt dit tot een afwijzing.
* Het kwalificatiemateriaal dient in het juiste formaat aangeleverd te worden. Gebruik voor het aanleveren van het kwalificatiemateriaal altijd het aanleverformat behorende bij de gegevensdienst. In het aanleverformat staat per dia beschreven welke schermafdruk wordt verwacht.
** Voor een DVP geldt dat er schermafdrukken gemaakt dienen te worden van de interface van een PGO.
** Voor een DVZA geldt dat er schermafdrukken gemaakt dienen te worden (van de combinatie) van de achterliggende bronsystemen waarmee men kwalificeert. '''Let op''': Wanneer men voor een nieuwe combinatie van bronsystemen acht te kwalificeren wordt dit behandeld als een nieuwe kwalificatie waarbij ook van die nieuwe combinatie schermafdrukken dienen te worden gemaakt. Schermafdrukken van andere interfaces zoals van een XDS worden afgekeurd.

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
Nictiz stelt het testsysteem Touchstone beschikbaar voor het testen van systeemrollen met bijbehorende MedMij gegevensdiensten als voorbereiding op het kwalificatieproces.
<br>MedMij (kandidaat-) deelnemers kunnen Touchstone eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.
* Documentatie over het aansluiten op Touchstone is te vinden op de pagina Kwalificatie aansluiten in de sectie [[MedMij:Vprepub/Kwalificatie_aansluiten#Configureren_simulator|configureren simulator]].
* Voor uitleg over gebruik van de simulator en tokens, zie [[MedMij:Vprepub/Qualification | gebruik tokens]]
<section end=medmij_kwalificatie_introductie />
<span id="Kwalificatiescripts"></span><section begin=medmij_kwalificatiescripts />

=Kwalificatiebenodigdheden=
Het kwalificatiemateriaal voor de meest recente versies van de verschillende systeemrollen met bijbehorende MedMij gegevensdiensten is in dit hoofdstuk te vinden.
<br> Voor een actueel overzicht van gegevensdiensten, met een verwijzing naar kwalificatie-informatie per systeemrol, raadpleeg de [https://afsprakenstelsel.medmij.nl/display/MMCatalogus/Actuele+gegevensdiensten MedMij Catalogus].

=Kwalificatiescripts=
==Basisgegevensset Zorg 3.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BgZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen_BgZ_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen_BgZ.zip]]
* [[Media: Aanleverformat - Raadplegen BgZ_Vprepub.zip|3. Aanleverformat - Raadplegen BgZ.zip]]
* [[Media: Beoordelingsformulier BasisgegevenssetZorg Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevenssetZorg_Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen BgZ.pdf]]

===Uitgebreide gegevensset===
Nota bene: onderstaande kwalificatiescripts bevatten een uitgebreidere gegevens set voor de BgZ. Deze worden '''niet''' gebruikt voor kwalificatie.

* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BGZ extended.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf|2.Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf]]

==Labuitwisseling 2.0==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten_V2020.01_20201027.pdf|1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten_Vprepub.pdf|2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten_Vprepub.pdf|2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Laboratoriumresultaten_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip]]
* [[Media: Aanleverformat - Raadplegen Laboratoriumresultaten_Vprepub.zip|3. Aanleverformat - Raadplegen Laboratoriumresultaten.zip]]
* [[Media: Beoordelingsformulier Laboratoriumresultaten Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Beoordelingsformulier Laboratoriumresultaten Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Laboratoriumresultaten.pdf]]

==AllergieIntolerantie 2.0==

===AllergieIntolerantie===
* [[MedMij:Vprepub/kw-MM-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens]]
* [[MedMij:Vprepub/kw-MM-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantie_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantie_Vprepub.zip|3. Aanleverformat - Raadplegen AllergieIntolerantie.zip]]
* [[Media: Beoordelingsformulier AllergieIntolerantie Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen AllergieIntolerantie.pdf]]

===AllergieIntolerantieVertaling===
* [[MedMij:Vprepub/kw-MM-1.A-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[MedMij:Vprepub/kw-MM-1.A-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantieVertaling_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantieVertaling_Vprepub.zip|3. Aanleverformat - Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Beoordelingsformulier AllergieIntolerantieVertaling Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.pdf]]

==eAfspraak 2.0==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen eAfspraak_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:Aanleverformat - Raadplegen eAfspraak_Vprepub.zip|3. Aanleverformat - Raadplegen eAfspraak.zip]]
* [[Media:Aanleverformat - Beschikbaarstellen eAfspraak_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen eAfspraak.zip]]

==Zelfmetingen 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Ontvangen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Ontvangen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Raadplegen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Raadplegen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Sturen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Sturen Zelfmetingen.zip]]
* [[Media: Beoordelingsformulier Meetwaardenvitalefuncties Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media: Beoordelingsformulier_zelfmetingenvanvitalefuncties_Sturen.pdf|4. Beoordelingsformulier - MedMij Sturen Zelfmetingen.pdf]]

==PDF/A 3.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Ontvangen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen PDFA.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen PDFA_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen PDFA.zip]]
* [[Media: Aanleverformat - Ontvangen PDFA_Vprepub.zip|3. Aanleverformat - Ontvangen PDFA.zip]]
* [[Media: Aanleverformat - Raadplegen PDFA_Vprepub.zip|3. Aanleverformat - Raadplegen PDFA.zip]]
* [[Media: Aanleverformat - Sturen PDFA_Vprepub.zip|3. Aanleverformat - Sturen PDFA.zip]]
* [[Media: Beoordelingsformulier PDFA Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Sturen.pdf|4. Beoordelingsformulier - MedMij Sturen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Ontvangen.pdf|4. Beoordelingsformulier - MedMij Ontvangen PDFA.pdf]]
* [[Media: PDFA Example Documents.zip|5. Voorbeelddocumenten PDFA voor use case Beschikbaarstellen]]

==Huisartsgegevens 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen huisartsgegevens_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen huisartsgegevens.zip]]
* [[Media: Aanleverformat - Raadplegen huisartsgegevens_Vprepub.zip|3. Aanleverformat - Raadplegen huisartsgegevens.zip]]
* [[Media: Beoordelingsformulier Huisartsgegevens Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Huisartsgegevens .pdf]]
* [[Media: Beoordelingsformulier Huisartsgegevens Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Huisartsgegevens .pdf]]

==Basisgegevens GGZ 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Basisgegevens GGZ_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip]]
* [[Media: Aanleverformat - Raadplegen Basisgegevens GGZ_Vprepub.zip|3. Aanleverformat - Raadplegen Basisgegevens GGZ.zip]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens GGZ.pdf]]

==Beelden 2.0==
* [[Media:1. Kwalificatiescript - MedMij Ontvangen beelden_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen beelden_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen beelden_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:Aanleverformat - Ontvangen Beelden_Vprepub.zip|3. Aanleverformat - Ontvangen Beelden.zip]]
* [[Media:Aanleverformat - Sturen Beelden_Vprepub.zip|3. Aanleverformat - Sturen Beelden.zip]]

==Basisgegevens Langdurige Zorg 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.1|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.2|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.3|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.4|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.4]]
* [[Media:3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.zip]]
* [[Media:3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg_Vprepub.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.zip]]
* [[Media: Beoordelingsformulier BasisgegevensLangdurigeZorg Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensLangdurigeZorg Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

==Vragenlijsten 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten_V2020.01_20201124.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen en Ontvangen vragenlijsten_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen en Ontvangen vragenlijsten.zip]]
* [[Media: Aanleverformat - Raadplegen en sturen vragenlijsten_Vprepub.zip|3. Aanleverformat - Raadplegen en sturen vragenlijsten.zip]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:V2020.01/Kwalificatie

2020-11-19T13:22:23Z

Camiel Reijnders: MM-1542: Verwijzingen naar het Register van Informatiestandaarden aangepast naar de MedMij Catalogus

Bestand:2. Addenda - MedMij Raadplegen AllergieIntolerantie gegevens 20201124.pdf

2020-11-13T14:38:30Z

Camiel Reijnders:

Bestand:2. Addenda - MedMij Beschikbaarstellen AllergieIntolerantie gegevens 20201124.pdf

2020-11-13T14:38:13Z

Camiel Reijnders:

MedMij:Vprepub-2020.01/Kwalificatie

2020-10-16T13:47:36Z

Camiel Reijnders: MM-989: In kwalificatiescript "MedMij Raadplegen Laboratoriumresultaten" verwijzingen naar verkeerd addendum hersteld

{{MedMij:Vprepub/Issuebox}}
__NUMBEREDHEADINGS__





=Introductie=
Nictiz beheert voor Stichting MedMij het [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Register_van_informatiestandaarden Register van Informatiestandaarden] met daarin de informatiestandaarden die binnen MedMij gebruikt worden. Om de informatiestandaarden te kunnen toepassen binnen MedMij, zijn gegevensdiensten gedefinieerd die bestaan uit één of meerdere systeemrollen vanuit een informatiestandaard. Stichting MedMij omschrijft de gegevensdiensten en bepaalt vanaf wanneer en tot hoelang de gegevensdienst op het MedMij-netwerk gebruikt kan worden. Dit doet Stichting MedMij in samenspraak met Nictiz als beheerder van het register van Informatiestandaarden.

Voor het implementeren van informatiestandaarden en daaruit de gedefinieerde gegevensdiensten voor MedMij, is een Nictiz kwalificatie van toepassing. De kwalificaties worden uitgevoerd door het kwalificatiecentrum van Nictiz en vinden plaats per systeemrolcode. De systeemrolcode vormt de koppeling van een (MedMij) informatiestandaard aan een, in de [https://afsprakenstelsel.medmij.nl/display/MedMijAfsprakenstelsel112/Catalogus catalogus] vermelde, gegevensdienst van het MedMij-netwerk.

Kwalificatiescripts en meer informatie over een kwalificatie zijn te vinden via de betreffende paragrafen onder [[MedMij:Vprepub/Kwalificatie#Kwalificatiebenodigdheden|kwalificatiebenodigdheden]].<section end=medmij_kwalificatie_introductie />

Voor een optimaal verloop van de kwalificatie is het belangrijk dat via de juiste kanalen wordt gecommuniceerd. Raadpleeg hiervoor het onderstaand communicatiekanalenoverzicht:
* Procedure en planninggerelateerde vragen: [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl]
* Inhoudelijke vragen of opmerkingen over de implementatie van informatiestandaarden en gegevensdiensten: [https://bits.nictiz.nl/projects/MM BITS]
* Algemene vragen MedMij: [mailto:info@medmij.nl info@medmij.nl]

In onze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vprepub/Kwalificatie_FAQ FAQ] tref je de veelgestelde vragen tijdens het kwalificatietraject.

== Kwalificatie gebruik van terminologie ==
Op de kwalificatiepagina wordt gesproken over DVP en PGO of DVZA en XIS. <br>
Een DVP dient altijd te kwalificeren met een PGO en een DVZA dient altijd te kwalificeren met achterliggend bronsysteem of bronsystemen (XIS).

{| class="wikitable"
|-
| '''DVP''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert een Persoonlijke gezondheidsomgeving, een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''DVZA''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert Diensten aan de Zorgaanbieder gerelateerd aan de uitwisseling tussen Persoon en Zorgaanbieder en committeert zich hiervoor aan de naleving van de afspraken van het MedMij Afsprakenstelsel.
|-
| '''Persoonsdomein''' || Alle Personen en alle Dienstverleners personen vormen samen het Persoonsdomein.
|-
| '''PGO''' || Een Persoonlijke gezondheidsomgeving is een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''XIS''' || Het systeem of geheel van de systemen waarin de zorgaanbieder het medisch dossier van de persoon bijhoudt.
|-
| '''Zorgaanbiedersdomein''' || Alle Zorgaanbieders en alle Dienstverleners zorgaanbieder vormen samen het Zorgaanbiedersdomein.
|}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vprepub/Ontwerpen MedMij informatiestandaard], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in het document '''2. Addenda - Kwalificaties''' als bijlage van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
Naast de bovengenoemde algemene voorwaarden voor kwalificatie dient een kwalificerende (kandidaat-) deelnemer ook te voldoen aan de procedurele eisen voor kwalificatie. Om het kwalificatietraject niet onnodig te vertragen wordt van een (kandidaat-) deelnemer verwacht dat deze de onderstaande procedurele eisen in acht neemt.

* Indien niet kan worden voldaan aan de functionele en/of technische eisen van een gegevensdienst, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Indien gebruik gemaakt wordt van de vrijheidsgraden die de gegevensdiensten BgGGZ, BgLZ, BgZ en PDF/a bieden, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* De testexecutie dient 100% succesvol geslaagd te zijn voordat gestart kan worden met de kwalificatie. Indien dit niet het geval is dient dit '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Het uitgevoerde certificering-testscript dient niet ouder te zijn dan één week voor de aanlevering van het (pre)kwalificatiemateriaal. Nictiz staat in zijn recht om te bepalen of een test executie is verouderd en daarom af te wijzen.
* Bij het instellen van een variabele T datum door een DVZA, dient de datum gelijk te zijn aan de datum waarop de Touchstone testexecutie is uitgevoerd.
* Voor zowel DVP als DVZA geldt dat de schermafdrukken overeen dienen te komen met de uitgevoerde Touchstone testexecutie die is bijgevoegd in het aanleverformat. Wanneer hier niet aan wordt voldaan leidt dit tot een afwijzing.
* Het kwalificatiemateriaal dient in het juiste formaat aangeleverd te worden. Gebruik voor het aanleveren van het kwalificatiemateriaal altijd het aanleverformat behorende bij de gegevensdienst. In het aanleverformat staat per dia beschreven welke schermafdruk wordt verwacht.
** Voor een DVP geldt dat er schermafdrukken gemaakt dienen te worden van de interface van een PGO.
** Voor een DVZA geldt dat er schermafdrukken gemaakt dienen te worden (van de combinatie) van de achterliggende bronsystemen waarmee men kwalificeert. '''Let op''': Wanneer men voor een nieuwe combinatie van bronsystemen acht te kwalificeren wordt dit behandeld als een nieuwe kwalificatie waarbij ook van die nieuwe combinatie schermafdrukken dienen te worden gemaakt. Schermafdrukken van andere interfaces zoals van een XDS worden afgekeurd.

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
Nictiz stelt het testsysteem Touchstone beschikbaar voor het testen van systeemrollen met bijbehorende MedMij gegevensdiensten als voorbereiding op het kwalificatieproces.
<br>MedMij (kandidaat-) deelnemers kunnen Touchstone eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.
* Documentatie over het aansluiten op Touchstone is te vinden op de pagina Kwalificatie aansluiten in de sectie [[MedMij:Vprepub/Kwalificatie_aansluiten#Configureren_simulator|configureren simulator]].
* Voor uitleg over gebruik van de simulator en tokens, zie [[MedMij:Vprepub/Qualification | gebruik tokens]]
<section end=medmij_kwalificatie_introductie />
<span id="Kwalificatiescripts"></span><section begin=medmij_kwalificatiescripts />

=Kwalificatiebenodigdheden=
Het kwalificatiemateriaal voor de meest recente versies van de verschillende systeemrollen met bijbehorende MedMij gegevensdiensten is in dit hoofdstuk te vinden.
<br> Voor een actueel overzicht van de binnen MedMij toegelaten informatiestandaarden raadpleeg het [[MedMij:Register_van_informatiestandaarden| Register van informatiestandaarden]].

=Kwalificatiescripts=
==Basisgegevensset Zorg 3.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BgZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen_BgZ_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen_BgZ.zip]]
* [[Media: Aanleverformat - Raadplegen BgZ_Vprepub.zip|3. Aanleverformat - Raadplegen BgZ.zip]]
* [[Media: Beoordelingsformulier BasisgegevenssetZorg Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevenssetZorg_Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen BgZ.pdf]]

===Uitgebreide gegevensset===
Nota bene: onderstaande kwalificatiescripts bevatten een uitgebreidere gegevens set voor de BgZ. Deze worden '''niet''' gebruikt voor kwalificatie.

* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BGZ extended.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf|2.Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf]]

==Labuitwisseling 2.0==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten_V2020.01_20201027.pdf|1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten_Vprepub.pdf|2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten_Vprepub.pdf|2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Laboratoriumresultaten_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip]]
* [[Media: Aanleverformat - Raadplegen Laboratoriumresultaten_Vprepub.zip|3. Aanleverformat - Raadplegen Laboratoriumresultaten.zip]]
* [[Media: Beoordelingsformulier Laboratoriumresultaten Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Beoordelingsformulier Laboratoriumresultaten Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Laboratoriumresultaten.pdf]]

==AllergieIntolerantie 2.0==

===AllergieIntolerantie===
* [[MedMij:Vprepub/kw-MM-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens]]
* [[MedMij:Vprepub/kw-MM-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantie_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantie_Vprepub.zip|3. Aanleverformat - Raadplegen AllergieIntolerantie.zip]]
* [[Media: Beoordelingsformulier AllergieIntolerantie Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen AllergieIntolerantie.pdf]]

===AllergieIntolerantieVertaling===
* [[MedMij:Vprepub/kw-MM-1.A-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[MedMij:Vprepub/kw-MM-1.A-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantieVertaling_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantieVertaling_Vprepub.zip|3. Aanleverformat - Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Beoordelingsformulier AllergieIntolerantieVertaling Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.pdf]]

==eAfspraak 2.0==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen eAfspraak_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:Aanleverformat - Raadplegen eAfspraak_Vprepub.zip|3. Aanleverformat - Raadplegen eAfspraak.zip]]
* [[Media:Aanleverformat - Beschikbaarstellen eAfspraak_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen eAfspraak.zip]]

==Zelfmetingen 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Ontvangen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Ontvangen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Raadplegen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Raadplegen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Sturen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Sturen Zelfmetingen.zip]]
* [[Media: Beoordelingsformulier Meetwaardenvitalefuncties Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media: Beoordelingsformulier_zelfmetingenvanvitalefuncties_Sturen.pdf|4. Beoordelingsformulier - MedMij Sturen Zelfmetingen.pdf]]

==PDF/A 3.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Ontvangen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen PDFA.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen PDFA_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen PDFA.zip]]
* [[Media: Aanleverformat - Ontvangen PDFA_Vprepub.zip|3. Aanleverformat - Ontvangen PDFA.zip]]
* [[Media: Aanleverformat - Raadplegen PDFA_Vprepub.zip|3. Aanleverformat - Raadplegen PDFA.zip]]
* [[Media: Aanleverformat - Sturen PDFA_Vprepub.zip|3. Aanleverformat - Sturen PDFA.zip]]
* [[Media: Beoordelingsformulier PDFA Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Sturen.pdf|4. Beoordelingsformulier - MedMij Sturen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Ontvangen.pdf|4. Beoordelingsformulier - MedMij Ontvangen PDFA.pdf]]
* [[Media: PDFA Example Documents.zib|5. Voorbeelddocumenten PDFA voor use case Beschikbaarstellen]]

==Huisartsgegevens 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen huisartsgegevens_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen huisartsgegevens.zip]]
* [[Media: Aanleverformat - Raadplegen huisartsgegevens_Vprepub.zip|3. Aanleverformat - Raadplegen huisartsgegevens.zip]]
* [[Media: Beoordelingsformulier Huisartsgegevens Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Huisartsgegevens .pdf]]
* [[Media: Beoordelingsformulier Huisartsgegevens Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Huisartsgegevens .pdf]]

==Basisgegevens GGZ 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Basisgegevens GGZ_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip]]
* [[Media: Aanleverformat - Raadplegen Basisgegevens GGZ_Vprepub.zip|3. Aanleverformat - Raadplegen Basisgegevens GGZ.zip]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens GGZ.pdf]]

==Beelden 2.0==
* [[Media:1. Kwalificatiescript - MedMij Ontvangen beelden_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen beelden_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen beelden_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:Aanleverformat - Ontvangen Beelden_Vprepub.zip|3. Aanleverformat - Ontvangen Beelden.zip]]
* [[Media:Aanleverformat - Sturen Beelden_Vprepub.zip|3. Aanleverformat - Sturen Beelden.zip]]

==Basisgegevens Langdurige Zorg 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.1|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.2|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.3|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.4|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.4]]
* [[Media:3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.zip]]
* [[Media:3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg_Vprepub.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.zip]]
* [[Media: Beoordelingsformulier BasisgegevensLangdurigeZorg Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensLangdurigeZorg Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

==Vragenlijsten 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen en Ontvangen vragenlijsten_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen en Ontvangen vragenlijsten.zip]]
* [[Media: Aanleverformat - Raadplegen en sturen vragenlijsten_Vprepub.zip|3. Aanleverformat - Raadplegen en sturen vragenlijsten.zip]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:V2020.01/Kwalificatie

2020-10-16T13:47:36Z

Camiel Reijnders: MM-989: In kwalificatiescript "MedMij Raadplegen Laboratoriumresultaten" verwijzingen naar verkeerd addendum hersteld

{{MedMij:Vprepub/Issuebox}}
__NUMBEREDHEADINGS__





=Introductie=
Nictiz beheert voor Stichting MedMij het [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Register_van_informatiestandaarden Register van Informatiestandaarden] met daarin de informatiestandaarden die binnen MedMij gebruikt worden. Om de informatiestandaarden te kunnen toepassen binnen MedMij, zijn gegevensdiensten gedefinieerd die bestaan uit één of meerdere systeemrollen vanuit een informatiestandaard. Stichting MedMij omschrijft de gegevensdiensten en bepaalt vanaf wanneer en tot hoelang de gegevensdienst op het MedMij-netwerk gebruikt kan worden. Dit doet Stichting MedMij in samenspraak met Nictiz als beheerder van het register van Informatiestandaarden.

Voor het implementeren van informatiestandaarden en daaruit de gedefinieerde gegevensdiensten voor MedMij, is een Nictiz kwalificatie van toepassing. De kwalificaties worden uitgevoerd door het kwalificatiecentrum van Nictiz en vinden plaats per systeemrolcode. De systeemrolcode vormt de koppeling van een (MedMij) informatiestandaard aan een, in de [https://afsprakenstelsel.medmij.nl/display/MedMijAfsprakenstelsel112/Catalogus catalogus] vermelde, gegevensdienst van het MedMij-netwerk.

Kwalificatiescripts en meer informatie over een kwalificatie zijn te vinden via de betreffende paragrafen onder [[MedMij:Vprepub/Kwalificatie#Kwalificatiebenodigdheden|kwalificatiebenodigdheden]].<section end=medmij_kwalificatie_introductie />

Voor een optimaal verloop van de kwalificatie is het belangrijk dat via de juiste kanalen wordt gecommuniceerd. Raadpleeg hiervoor het onderstaand communicatiekanalenoverzicht:
* Procedure en planninggerelateerde vragen: [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl]
* Inhoudelijke vragen of opmerkingen over de implementatie van informatiestandaarden en gegevensdiensten: [https://bits.nictiz.nl/projects/MM BITS]
* Algemene vragen MedMij: [mailto:info@medmij.nl info@medmij.nl]

In onze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vprepub/Kwalificatie_FAQ FAQ] tref je de veelgestelde vragen tijdens het kwalificatietraject.

== Kwalificatie gebruik van terminologie ==
Op de kwalificatiepagina wordt gesproken over DVP en PGO of DVZA en XIS. <br>
Een DVP dient altijd te kwalificeren met een PGO en een DVZA dient altijd te kwalificeren met achterliggend bronsysteem of bronsystemen (XIS).

{| class="wikitable"
|-
| '''DVP''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert een Persoonlijke gezondheidsomgeving, een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''DVZA''' || Dit betreft een rol in het MedMij Afsprakenstelsel. <br>
Levert Diensten aan de Zorgaanbieder gerelateerd aan de uitwisseling tussen Persoon en Zorgaanbieder en committeert zich hiervoor aan de naleving van de afspraken van het MedMij Afsprakenstelsel.
|-
| '''Persoonsdomein''' || Alle Personen en alle Dienstverleners personen vormen samen het Persoonsdomein.
|-
| '''PGO''' || Een Persoonlijke gezondheidsomgeving is een dienst aan de Persoon voor de regie op zijn gezondheid die minimaal gegevensuitwisseling met de Zorgaanbieder mogelijk maakt middels het MedMij Afsprakenstelsel.
|-
| '''XIS''' || Het systeem of geheel van de systemen waarin de zorgaanbieder het medisch dossier van de persoon bijhoudt.
|-
| '''Zorgaanbiedersdomein''' || Alle Zorgaanbieders en alle Dienstverleners zorgaanbieder vormen samen het Zorgaanbiedersdomein.
|}

=Algemene voorwaarden voor kwalificatie=
Een (kandidaat-) deelnemer kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
# Kennis en begrip van [https://www.medmij.nl/afsprakenstelsel/ MedMij Afsprakenstelsel].
# Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
# Kennis en begrip van de betreffende [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vprepub/Ontwerpen MedMij informatiestandaard], zoals beschreven op de informatiestandaarden wiki van Nictiz.
# Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten andere referenties die de informatiestandaard gebruikt.
# Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in het document '''2. Addenda - Kwalificaties''' als bijlage van de betreffende informatiestandaard.
# Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
# '''Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De (kandidaat-) deelnemer levert voor deze informatie schermafdrukken op voor controle.'''
# Deze kwalificatie toetst geen infrastructurele eisen.

=Procedurele eisen voor kwalificatie=
Naast de bovengenoemde algemene voorwaarden voor kwalificatie dient een kwalificerende (kandidaat-) deelnemer ook te voldoen aan de procedurele eisen voor kwalificatie. Om het kwalificatietraject niet onnodig te vertragen wordt van een (kandidaat-) deelnemer verwacht dat deze de onderstaande procedurele eisen in acht neemt.

* Indien niet kan worden voldaan aan de functionele en/of technische eisen van een gegevensdienst, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Indien gebruik gemaakt wordt van de vrijheidsgraden die de gegevensdiensten BgGGZ, BgLZ, BgZ en PDF/a bieden, dient dit minimaal 2 weken '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* De testexecutie dient 100% succesvol geslaagd te zijn voordat gestart kan worden met de kwalificatie. Indien dit niet het geval is dient dit '''voorafgaand aan de kwalificatie''' aangegeven te worden.
* Het uitgevoerde certificering-testscript dient niet ouder te zijn dan één week voor de aanlevering van het (pre)kwalificatiemateriaal. Nictiz staat in zijn recht om te bepalen of een test executie is verouderd en daarom af te wijzen.
* Bij het instellen van een variabele T datum door een DVZA, dient de datum gelijk te zijn aan de datum waarop de Touchstone testexecutie is uitgevoerd.
* Voor zowel DVP als DVZA geldt dat de schermafdrukken overeen dienen te komen met de uitgevoerde Touchstone testexecutie die is bijgevoegd in het aanleverformat. Wanneer hier niet aan wordt voldaan leidt dit tot een afwijzing.
* Het kwalificatiemateriaal dient in het juiste formaat aangeleverd te worden. Gebruik voor het aanleveren van het kwalificatiemateriaal altijd het aanleverformat behorende bij de gegevensdienst. In het aanleverformat staat per dia beschreven welke schermafdruk wordt verwacht.
** Voor een DVP geldt dat er schermafdrukken gemaakt dienen te worden van de interface van een PGO.
** Voor een DVZA geldt dat er schermafdrukken gemaakt dienen te worden (van de combinatie) van de achterliggende bronsystemen waarmee men kwalificeert. '''Let op''': Wanneer men voor een nieuwe combinatie van bronsystemen acht te kwalificeren wordt dit behandeld als een nieuwe kwalificatie waarbij ook van die nieuwe combinatie schermafdrukken dienen te worden gemaakt. Schermafdrukken van andere interfaces zoals van een XDS worden afgekeurd.

=Uitgangspunten voor kwalificatie=
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.

==Systeemrol 'Raadplegen' (Persoonsdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Raadplegen':
<section begin=Uitgangspunten_Systeemrol_Raadplegen />
* De set van de gegevensdienst is bewust als één geheel vastgesteld. Daarvoor kwalificeer je wel/niet binnen de MedMij context.
* Een PGO dient alle functionele data-elementen conform de dataset van de informatiestandaard te tonen aan de gebruiker. De uitzonderingen per gegevensdienst zijn beschreven in de bijbehorende functionele ontwerpen.
* Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon als gegevens technisch niet beschikbaar gesteld kunnen worden.
* Een PGO biedt de persoon inzicht in herkomst van de verzamelde gegevens, en wanneer deze gegevens verzameld zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door de PGO bij ontvangst van de geraadpleegde gegevens.<section end=Uitgangspunten_Systeemrol_Raadplegen />

==Systeemrol 'Beschikbaarstellen' (Zorgaanbiedersdomein)==
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
<section begin=Uitgangspunten_Systeemrol_Beschikbaarstellen />
* Een DVZA dient de gehele gegevensdienst te ondersteunen. Uitzonderingen worden toegelicht in de bijbehorende functionele ontwerpen en kwalificatiescripts.
* Een DVZA geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.

* Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
**veroorzaakt door het ontbreken van de informatie
**veroorzaakt doordat het XIS dit technisch niet kan leveren.

* In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.

* Als er technisch iets niet goed gaat, stuurt de DVZA conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze foutcode moet ingebouwd worden door het XIS. Hierop wordt de DVZA ook gekwalificeerd.<section end=Uitgangspunten_Systeemrol_Beschikbaarstellen />

==Systeemrol 'Ontvangen' (Zorgaanbiedersdomein)==
Hieronder volgt een generiek uitgangspunt voor de kwalificatie van de systeemrol 'Ontvangen':
* Een XIS biedt inzicht in herkomst van de ontvangen gegevens, en wanneer deze gegevens ontvangen zijn. Dit betreft concepten die meer technisch van aard zijn, maar voor de eenduidigheid en herleidbaarheid van de gegevens noodzakelijk zijn. Dit betreffen de metagegevens zoals gelogd door het XIS bij ontvangst van de gestuurde gegevens.

=Kwalificatie aansluiten op Touchstone=
Nictiz stelt het testsysteem Touchstone beschikbaar voor het testen van systeemrollen met bijbehorende MedMij gegevensdiensten als voorbereiding op het kwalificatieproces.
<br>MedMij (kandidaat-) deelnemers kunnen Touchstone eveneens gebruiken in de ontwikkel- en testfase voor het vroegtijdig testen en/of valideren van de FHIR berichten.
* Documentatie over het aansluiten op Touchstone is te vinden op de pagina Kwalificatie aansluiten in de sectie [[MedMij:Vprepub/Kwalificatie_aansluiten#Configureren_simulator|configureren simulator]].
* Voor uitleg over gebruik van de simulator en tokens, zie [[MedMij:Vprepub/Qualification | gebruik tokens]]
<section end=medmij_kwalificatie_introductie />
<span id="Kwalificatiescripts"></span><section begin=medmij_kwalificatiescripts />

=Kwalificatiebenodigdheden=
Het kwalificatiemateriaal voor de meest recente versies van de verschillende systeemrollen met bijbehorende MedMij gegevensdiensten is in dit hoofdstuk te vinden.
<br> Voor een actueel overzicht van de binnen MedMij toegelaten informatiestandaarden raadpleeg het [[MedMij:Register_van_informatiestandaarden| Register van informatiestandaarden]].

=Kwalificatiescripts=
==Basisgegevensset Zorg 3.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BgZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen_BgZ_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen_BgZ.zip]]
* [[Media: Aanleverformat - Raadplegen BgZ_Vprepub.zip|3. Aanleverformat - Raadplegen BgZ.zip]]
* [[Media: Beoordelingsformulier BasisgegevenssetZorg Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen BgZ.pdf]]
* [[Media: Beoordelingsformulier_BasisgegevenssetZorg_Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen BgZ.pdf]]

===Uitgebreide gegevensset===
Nota bene: onderstaande kwalificatiescripts bevatten een uitgebreidere gegevens set voor de BgZ. Deze worden '''niet''' gebruikt voor kwalificatie.

* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ extended.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen BGZ extended.pdf|1. Kwalificatiescript - MedMij Raadplegen BgZ extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf|2.Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ Extended.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ Extended.pdf]]

==Labuitwisseling 2.0==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten_V2020.01_20201027.pdf|1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten_Vprepub.pdf|2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten_Vprepub.pdf|2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Laboratoriumresultaten_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip]]
* [[Media: Aanleverformat - Raadplegen Laboratoriumresultaten_Vprepub.zip|3. Aanleverformat - Raadplegen Laboratoriumresultaten.zip]]
* [[Media: Beoordelingsformulier Laboratoriumresultaten Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf]]
* [[Media: Beoordelingsformulier Laboratoriumresultaten Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Laboratoriumresultaten.pdf]]

==AllergieIntolerantie 2.0==

===AllergieIntolerantie===
* [[MedMij:Vprepub/kw-MM-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens]]
* [[MedMij:Vprepub/kw-MM-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantie_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantie_Vprepub.zip|3. Aanleverformat - Raadplegen AllergieIntolerantie.zip]]
* [[Media: Beoordelingsformulier AllergieIntolerantie Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen AllergieIntolerantie.pdf]]

===AllergieIntolerantieVertaling===
* [[MedMij:Vprepub/kw-MM-1.A-AIB-FHIR|1. Kwalificatiescript - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[MedMij:Vprepub/kw-MM-1.A-AIR-FHIR|1. Kwalificatiescript - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling]]
* [[Media: Aanleverformat - Beschikbaarstellen AllergieIntolerantieVertaling_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Aanleverformat - Raadplegen AllergieIntolerantieVertaling_Vprepub.zip|3. Aanleverformat - Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip]]
* [[Media: Beoordelingsformulier AllergieIntolerantieVertaling Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.pdf]]

==eAfspraak 2.0==
* [[Media:1. Kwalificatiescript - MedMij Raadplegen eAfspraak_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf]]
* [[Media:Aanleverformat - Raadplegen eAfspraak_Vprepub.zip|3. Aanleverformat - Raadplegen eAfspraak.zip]]
* [[Media:Aanleverformat - Beschikbaarstellen eAfspraak_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen eAfspraak.zip]]

==Zelfmetingen 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen Zelfmetingen_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen Zelfmetingen.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Ontvangen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Ontvangen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Raadplegen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Raadplegen Zelfmetingen.zip]]
* [[Media: Aanleverformat - Sturen Zelfmetingen_Vprepub.zip|3. Aanleverformat - Sturen Zelfmetingen.zip]]
* [[Media: Beoordelingsformulier Meetwaardenvitalefuncties Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Zelfmetingen.pdf]]
* [[Media: Beoordelingsformulier_zelfmetingenvanvitalefuncties_Sturen.pdf|4. Beoordelingsformulier - MedMij Sturen Zelfmetingen.pdf]]

==PDF/A 3.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Ontvangen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen PDFA.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen PDFA_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen PDFA.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen PDFA_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen PDFA.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen PDFA_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen PDFA.zip]]
* [[Media: Aanleverformat - Ontvangen PDFA_Vprepub.zip|3. Aanleverformat - Ontvangen PDFA.zip]]
* [[Media: Aanleverformat - Raadplegen PDFA_Vprepub.zip|3. Aanleverformat - Raadplegen PDFA.zip]]
* [[Media: Aanleverformat - Sturen PDFA_Vprepub.zip|3. Aanleverformat - Sturen PDFA.zip]]
* [[Media: Beoordelingsformulier PDFA Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Sturen.pdf|4. Beoordelingsformulier - MedMij Sturen PDFA.pdf]]
* [[Media: Beoordelingsformulier PDFA Ontvangen.pdf|4. Beoordelingsformulier - MedMij Ontvangen PDFA.pdf]]
* [[Media: PDFA Example Documents.zib|5. Voorbeelddocumenten PDFA voor use case Beschikbaarstellen]]

==Huisartsgegevens 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen huisartsgegevens_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen huisartsgegevens.zip]]
* [[Media: Aanleverformat - Raadplegen huisartsgegevens_Vprepub.zip|3. Aanleverformat - Raadplegen huisartsgegevens.zip]]
* [[Media: Beoordelingsformulier Huisartsgegevens Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Huisartsgegevens .pdf]]
* [[Media: Beoordelingsformulier Huisartsgegevens Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Huisartsgegevens .pdf]]

==Basisgegevens GGZ 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen Basisgegevens GGZ_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip]]
* [[Media: Aanleverformat - Raadplegen Basisgegevens GGZ_Vprepub.zip|3. Aanleverformat - Raadplegen Basisgegevens GGZ.zip]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensGGZ Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens GGZ.pdf]]

==Beelden 2.0==
* [[Media:1. Kwalificatiescript - MedMij Ontvangen beelden_Vprepub.pdf|1. Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Sturen beelden_Vprepub.pdf|1. Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Sturen beelden_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Sturen beelden.pdf]]
* [[Media:Aanleverformat - Ontvangen Beelden_Vprepub.zip|3. Aanleverformat - Ontvangen Beelden.zip]]
* [[Media:Aanleverformat - Sturen Beelden_Vprepub.zip|3. Aanleverformat - Sturen Beelden.zip]]

==Basisgegevens Langdurige Zorg 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.1|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.2|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.3|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3]]
* [[MedMij:Vprepub/V1.0_BgLZ1.0.0-KwalificatieAddendumScenario1.4|2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.4]]
* [[Media:3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.zip]]
* [[Media:3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg_Vprepub.zip|3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.zip]]
* [[Media: Beoordelingsformulier BasisgegevensLangdurigeZorg Beschikbaarstellen.pdf|4. Beoordelingsformulier - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf]]
* [[Media: Beoordelingsformulier BasisgegevensLangdurigeZorg Raadplegen.pdf|4. Beoordelingsformulier - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf]]

==Vragenlijsten 2.0==
* [[Media:1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten_Vprepub.pdf|1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten_Vprepub.pdf|1. Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Vragenlijsten.pdf]]
* [[Media:2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten_Vprepub.pdf|2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Vragenlijsten.pdf]]
* [[Media: Aanleverformat - Beschikbaarstellen en Ontvangen vragenlijsten_Vprepub.zip|3. Aanleverformat - Beschikbaarstellen en Ontvangen vragenlijsten.zip]]
* [[Media: Aanleverformat - Raadplegen en sturen vragenlijsten_Vprepub.zip|3. Aanleverformat - Raadplegen en sturen vragenlijsten.zip]]

<section end=medmij_kwalificatiescripts />
[[Categorie:Kwalificatie]]

MedMij:Vprepub-2020.01/OntwerpLabresult

2020-10-16T13:41:01Z

Camiel Reijnders: MM-988: In de inleiding de naamgeving van de zib LaboratoriumUitslag gecorrigeerd

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Laboratoriumresultaten {{VersieInfo|Laboratoriumresultaten|release=Vprepub}}}}
{{MedMij:Vprepub/Issuebox}}

[[Bestand:Labresultaten_icoon.png |link=|links |87px|MedMij_|Laboratoriumresultaten]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:Vprepub/Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:Vprepub/FHIR_LaboratoryResults|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Deze pagina beschrijft use cases voor de patiënt met relatie tot de [https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria informatiestandaard labuitwisseling] (LAB).

Door IHE / Antilope is ook al werk gedaan voor beschrijving use cases voor uitwisseling van laboratoriumgegevens, deze zijn [https://usecase-repository.ihe-europe.net/use-cases?field_domain_value=LAB&field_scale_value=All&field_source_value=All hier] gepubliceerd. Op het moment van schrijven van deze documentatie heeft IHE twee verschillende use cases beschreven:
* Uitwisseling voor een laboratorium binnen een ziekenhuis: [https://usecase-repository.ihe-europe.net/content/request-and-results-distribution-workflow-laboratory-within-hospital Request and results distribution workflow for laboratory within a hospital]
* Nationale / regionale uitwisseling tussen zorgaanbieders / laboratoria: [https://usecase-repository.ihe-europe.net/content/request-and-results-sharing-workflow-laboratory-nationalregional-scale Request and results sharing workflow for laboratory on a National/regional scale]

Bovenstaande standaarden beschrijven de uitwisseling met de patiënt nog niet expliciet. Het doel van deze pagina is om de verschillende uitwisselingsscenario's van laboratoriumgegevens met de patiënt toe te voegen.

Het is het streven van het MedMij-programma om deze beschrijvingen toe te voegen aan de bestaande informatiestandaard Labuitwisseling.

Zoals [[MedMij:Vprepub/Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende zibs als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende zibs:
*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*LaboratoriumUitslag.

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen, die [[MedMij:Vprepub/Ontwerpen#Doelgroep| hier]] gevonden kan worden.

==Kaders en uitgangspunten==
===Richtlijn===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub/Ontwerpen#Richtlijn| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub/Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:Vprepub/Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:Vprepub/Ontwerpen|medmij_kwalificatie_introductie}}

=Use Cases=

==Use case: Raadplegen laboratoriumresultaten in persoonlijke gezondheidsomgeving==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in laboratoriumresultaten die over henzelf gaan.
===Domein===
Laboratoriumgegevens in het domein van zorgaanbieders, laboratoria en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van laboratoriumresultaten vanuit zorgaanbieder / laboratorium naar een patiënt. De zorgaanbieder / laboratorium is dus de bron van de gegevens.

Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

===Informatie===
====Raadplegen laboratoriumresultaten====
Informatie-elementen in de vraag om laboratoriumresultaten zijn:
*periode (startdatum - einddatum) waarop het laboratoriumresultaat uitgevoerd was.

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om laboratoriumresultaten.

====Beschikbaarstellen laboratoriumresultaat====
De volgende zorginformatiebouwstenen definiëren de informatie-elementen die van toepassing zijn:
*Patiënt
*Zorgverlener
*Zorgaanbieder
*LaboratoriumUitslag v4.1

Informatie elementen in LaboratoriumUitslag staan [https://zibs.nl/wiki/LaboratoriumUitslag-v4.1(2017NL) hier].

Dit betreft de inhoud van ieder laboratoriumresultaat.

=== Bedrijfsrollen ===
Deze use case kent twee bedrijfsrollen.

{| class="wikitable" "cellpadding="10" width="50%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil laboratoriumresultaten raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder / Laboratorium
|style="background-color: white;vertical-align:top;"|Stelt laboratoriumresultaten beschikbaar
|}
<font size = "1">'''Bedrijfsrollen Laboratoriumresultaten'''</font>

Onderstaande afbeelding toont de bedrijfsrollen en de activiteiten die zij uitvoeren.

[[Bestand:Activity_Diagram_-_LaboratoriumResultaten.jpg|Activiteitendiagram Raadplegen laboratoriumresultaten ]]

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

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier].

Hieronder een aantal voor Thomas relevante situaties waarbij het raadplegen van laboratoriumresultaten een rol speelt.

<blockquote>Eens per drie maanden heeft Thomas een controle in het ziekenhuis. Hij heeft dan een afspraak met afwisselend de internist of de diabetesverpleegkundige. Thomas moet een half uur voor zijn afspraak al aanwezig zijn in het ziekenhuis om bloed te laten prikken. Een waarde die onder andere bepaald wordt is de HbA1c waarde, hieraan is te zien wat de gemiddelde glucosewaarde over de afgelopen 3 maanden geweest is. De uitslag is binnen een half uur binnen. De zorgverlener vertelt Thomas de laboratoriumresultaten en wat die betekenen tijdens de afspraak. Het ziekenhuis informatiesysteem maakt de laboratoriumresultaten ook beschikbaar voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan de resultaten dan ook later nog eens nakijken als hij dat wil. Dit geeft hem meer grip op zijn gezondheidssituatie.</blockquote>

<blockquote>In april is het tijd voor de jaarlijkse, uitgebreide controle in het ziekenhuis in verband met diabetes. De controle zélf zal plaatsvinden op 12 april. Thomas moet een week daarvoor, op 5 april, bloed prikken en urine afgeven in het ziekenhuis. De resultaten van de laboratoriumonderzoeken moeten beschikbaar zijn vóór 12 april. Het ziekenhuis informatiesysteem heeft de resultaten beschikbaar gemaakt voor Thomas op 10 april. Thomas wil zich goed op zijn afspraak voorbereiden en raadpleegt op 11 april, via zijn PGO, deze laboratoriumresultaten. Hij krijgt zo vooraf al meer inzicht in zijn situatie. Zijn nierwaarden lijken hem afwijkend. Hij vraagt zich daarom af of de instelling van de medicatie misschien aangepast moet worden. Voor de zekerheid noteert hij deze vraag voor zijn internist. Zo kan hij goed voorbereid naar het ziekenhuis op 12 april.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het uitwisselen van laboratoriumresultaten tussen zorgaanbieder / laboratorium en patiënt.
Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.
=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van laboratoriumresultaten tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

Er is een laboratoriumresultaat dat de patiënt wil raadplegen en dat de zorgaanbiederzorgaanbieder / laboratorium beschikbaar stelt.
:Soms zijn er valide redenen om bepaalde laboratoriumresultaten tijdelijk nog niet beschikbaar te stellen aan de patiënt. Bijvoorbeeld omdat de zorgverlener deze eerst zelf wil interpreteren en/of er eerst met de patiënt over wil spreken.
:Een patiënt kan steeds zelf het initiatief nemen om laboratoriumresultaten op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

=====Proces stappen=====
*De patiënt vraagt om laboratoriumresultaten bij een zorgaanbieder / laboratorium.
*De zorgaanbieder / laboratorium levert laboratoriumresultaten op voor de patiënt.
*Patiënt ziet de laboratoriumresultaten in.

=====Post conditie=====
De patiënt heeft laboratoriumresultaten gezien.

=== Systemen & Systeemrollen ===
Zowel zorgaanbieder als patiënt maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de laboratoriumresultaten van zorgaanbieder naar de patiënt.

{| 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;"| LaboratoriumresultaatRaadplegend
| style="background-color: white;"| LAB-{{VersieInfo|Laboratoriumresultaten|release=Vprepub}}-LRR-FHIR
| style="background-color: white;"| Raadplegen Laboratoriumresultaat bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| LaboratoriumresultaatBeschikbaarstellend
| style="background-color: white;"| LAB-{{VersieInfo|Laboratoriumresultaten|release=Vprepub}}-LRB-FHIR
| style="background-color: white;"| Beschikbaarstellen Laboratoriumresultaat aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_LaboratoriumResultaten_(Totaal).jpg|Componenten diagram]]

<font size = "1">'''Componenten diagram'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties, Transactiegroepen en systeemrollen===
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 use case.

{| 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"|Laboratoriumresultaten (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-{{VersieInfo|Laboratoriumresultaten|release=Vprepub}}-LRR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:Vprepub/FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-{{VersieInfo|Laboratoriumresultaten|release=Vprepub}}-LRB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (laboratorium)
|}

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

[[Bestand:Use_Case_Diagram_-_LaboratoriumResultaten.jpg|Use case diagram raadplegen laboratoriumresultaten]]

<font size = "1">'''Use case diagram</font>

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
<font size = "1">'''Referenties</font>

=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vprepub/Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.

{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
{{ReleaseNotes|package=2020.01 - September 2020|release=2.0.1|issues=2|MM-1319|MM-517}}
{{ReleaseNotes|package=2020.01 - Zomerrelease 2020|release=2.0.0|issues=4|MM-941|MM-898|MM-767|MM-511}}
|-
| rowspan = 2; style="background-color: white; | 2019.01 - September
| rowspan = 2; style="background-color: white; | 1.1.4
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-436 MM-436]
| style="background-color: white;"| Aanpassen ConceptMap InterpretatieVlaggenCodelijst-to-observation-interpretation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-422 MM-422]
| style="background-color: white;"| Aanpassen conceptnaam ResultaatVlaggen naar InterpretatieVlaggen in FHIR profiel voor LaboratoryResults.
|-
|rowspan = 9; style="background-color: white;"| 2019.01
|rowspan = 3; style="background-color: white;"| 1.1.3
|style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-294 MM-294]
|style="background-color: white;"| Naam mapping binnen div. FHIR profielen aangepast conform zib: HCIM LaboratoryTestResult-v4.1(2017EN).
|-
|style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-247 MM-247]
|style="background-color: white;"| LastN operation niet nodig binnen use case LaboratoryResults
|-
|style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-205 MM-205]
|style="background-color: white;"| Verwijderen link naar Specimen in het technisch ontwerp van LaboratoryResults.
|-
| style="background-color: white;"| 1.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 5; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-112 MM-112]
| style="background-color: white;"| Verwijzing in §2.4.1.2 naar zib OverdrachtLaboratoriumuitslag v1.2.2 (release 2015) gewijzigd in zib Laboratoriumuitslag v4.1 (release 2017). In het technisch ontwerp en FHIR-profielen werd deze al toegepast.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-108 MM-108]
| style="background-color: white;"| use-case Collect (from XIS to PGO).
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|}

MedMij:V2020.01/OntwerpLabresult

2020-10-16T13:41:01Z

Camiel Reijnders: MM-988: In de inleiding de naamgeving van de zib LaboratoriumUitslag gecorrigeerd

Zandbak/FO-template

2020-10-14T07:48:28Z

Camiel Reijnders: Aanmaak initiële zandbak pagina FO-template (wiki)

{{DISPLAYTITLE:Functioneel Ontwerp NAAM_INFORMATIESTANDAARD vVERSIE_INFORMATIESTANDAARD|Functioneel Ontwerp NAAM_INFORMATIESTANDAARD }}

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de informatiestandaard (NAAM_INFORMATIESTANDAARD (AFKORTING_INFORMATIESTANDAARD).

ALGEMENE BESCHRIJVING

==Doelgroep==
De doelgroep voor deze pagina bestaat uit:
* Productmanagers, architecten, ontwerpers en testers van XIS-leveranciers, regio-organisaties en Nictiz;
* Vertegenwoordigers van zorgverleners.

==Kaders en uitgangspunten==

===Richtlijn===
BESCHRIJVING RICHTLIJN

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol. Voor meer informatie zie [http://www.nictiz.nl/page/Standaarden/Kwalificaties de websitepagina over Nictiz kwalificaties].

=Use Case(s)=

==NAAM USE CASE 1==

=== Procesbeschrijving ===
PROCESBESCHRIJVING

=== Bedrijfsrollen ===
In het NAAM FUNCTIONEEL ONTWERP worden een AANTALtal bedrijfsrollen onderscheiden, namelijk de ''BEDRIJFSROL 1'' en de ''BEDRIJFSROL 2''.

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

[[Image: LINK NAAR GEUPLOADE AFBEELDING IN WIKI|Afbeelding NR: BESCHRIJVING AFBEELDING]]

<font size = "1">'''Afbeelding NR: BESCHRIJVING AFBEELDING'''</font>

...

=== Systemen & Systeemrollen ===
Zowel de ''BEDRIJFROL 1'' als de ''BEDRIJFSROL 2'' maken ieder gebruik van een informatiesysteem, respectievelijk een ''SYSTEEMNAAM'' (AFKORTING SYSTEEM NAAM) en een ''SYSTEEMNAAM'' (AFKORTING SYSTEEM NAAM). Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken.

Het ''AFKORTING SYSTEEM NAAM'' vervult AANTAL SYSTEEMROLLEN systeemrollen, namelijk:
* NAAM_INFORMATIESTANDAARD – BERICHTTYPE SYSTEEMROLTYPE [http://decor.nictiz.nl/art-decor/decor-scenarios--ART-DECORPREFIX-#tab2 (AFKORTING_SYSTEEMROL] systeem.
* NAAM_INFORMATIESTANDAARD – BERICHTTYPE SYSTEEMROLTYPE [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -#tab2 (AFKORTING_SYSTEEMROL)] systeem.

Zie ook onderstaande afbeelding.

[[Image: LINK NAAR GEUPLOADE AFBEELDING IN WIKI|Afbeelding NR: BESCHRIJVING AFBEELDING]]

<font size = "1">'''Afbeelding NR: BESCHRIJVING AFBEELDING '''</font>

Het ''AFKORTING SYSTEEM NAAM'' vervult AANTAL SYSTEEMROLLEN systeemrollen, namelijk:
* NAAM_INFORMATIESTANDAARD – BERICHTTYPE SYSTEEMROLTYPE [http://decor.nictiz.nl/art-decor/decor-scenarios--ART-DECORPREFIX-#tab2 (AFKORTING_SYSTEEMROL] systeem.
* NAAM_INFORMATIESTANDAARD – BERICHTTYPE SYSTEEMROLTYPE [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -#tab2 (AFKORTING_SYSTEEMROL)] systeem.

Zie ook onderstaande afbeelding.

[[Image: LINK NAAR GEUPLOADE AFBEELDING IN WIKI|Afbeelding NR: BESCHRIJVING AFBEELDING]]

<font size = "1">'''Afbeelding NR: BESCHRIJVING AFBEELDING '''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen. In ART-DECOR zijn de [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -#tab2 systeemrollen] nader gedefinieerd.

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties, een verzameling van transacties (bijvoorbeeld een vraag- en antwoordbericht) vormt een zogeheten transactiegroep.

Onderstaande afbeelding toont de samenhang tussen de bedrijfsrollen, bedrijfsprocessen, systeemrollen transacties en transactiegroepen die onderdeel uitmaken van de '' NAAM USE CASE 1''.

[[Image: LINK NAAR GEUPLOADE AFBEELDING IN WIKI|Afbeelding NR: BESCHRIJVING AFBEELDING]]

<font size = "1">'''Afbeelding NR: BESCHRIJVING AFBEELDING '''</font>

Zoals zichtbaar is in bovenstaande afbeelding, hebben sommige bedrijfsactiviteiten een bepaalde transactie tot gevolg. Deze transactie wordt uitgevoerd door een systeemrol, en maakt onderdeel uit van een transactiegroep. De gegevenselementen die als onderdeel van de transacties tussen systeemrollen worden uitgewisseld, zijn gespecificeerd in het [LINK_NAAR_SCENARIO_BEHOREND_BIJ_USE_CASE] in ART-DECOR.

Onderstaande tabel maakt het mogelijk direct de gewenste scenario’s, transactiegroepen en/of transacties te raadplegen in ART-DECOR.

{| style="color: black; background-color: #CCC0D9;" width="100%"
!Scenario
!Transactiegroep
!Transacties
|-
| rowspan="4" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id=SCENARIO_ID NAAM_SCENARIO]
| rowspan="2" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id=LINK_TRANSACTIEGROEP NAAM_TRANSACTIEGROEP]
| rowspan="1" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id= LINK_TRANSACTIE NAAM_TRANSACTIE]
|-
| rowspan="1" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id=2.16.840.1.113883.2.4.3.11.60.70.4.2 Beschikbaarstellen PS]
|-
| rowspan="2" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id= LINK_TRANSACTIEGROEP NAAM_TRANSACTIEGROEP]
| rowspan="1" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id= LINK_TRANSACTIE NAAM_TRANSACTIE]
|-
| rowspan="1" style="background-color: white;"| [http://decor.nictiz.nl/art-decor/decor-scenarios-- ART-DECORPREFIX -?id= LINK_TRANSACTIE NAAM_TRANSACTIE]
|}
<font size = "1">'''Tabel NR: Referenties naar ART-DECOR</font>

=Aanwijzingen / eisen voor functionaliteit van systemen (optioneel)=
BESCHRIJVING AANWIJZINGEN EN EISEN VOOR FUNCTIONALITEIT VAN SYSTEMEN

=Verantwoordelijkheid voor informatie (optioneel)=
BESCHRIJVING VERANTWOORDELIJKHEDEN VOOR INFORMATIE

=Afschermen van gegevens (optioneel)=
BESCHRIJVING AF TE SCHERMEN GEGEVENS

=Infrastructuur (optioneel)=
BESCHRIJVING INFRASTRUCTUUR

=Referenties=

{| style="color: black; background-color: #CCC0D9;" width="100%"
!Auteur(s)
!Titel
!Versie
!Datum
!Bron
!Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
<font size = "1">'''Tabel NR: Referenties</font>

=Paginahistorie=

{| style="color: black; background-color: #CCC0D9;" width="100%"
!Versie
!Datum
!Omschrijving
|-
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| OMSCHRIJVING
|}
<font size = "1">'''Tabel NR: Paginahistorie</font>

Bestand:1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten V2020.01 20201027.pdf

2020-10-02T13:57:36Z

Camiel Reijnders:

MedMij:V2019.01 OntwerpVragenlijsten

2020-09-29T09:47:33Z

Camiel Reijnders: MM-1353: Notebox opgenomen in FO voor Vragenlijsten om duidelijk te maken dat de uitwisseling op dit moment niet via het MedMij Afsprakenstelsel kan plaatsvinden.

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:Functioneel Ontwerp Vragenlijsten {{VersieInfo|Vragenlijsten|release=V2019.01}}}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Vragenlijsten-zonder-tekst-dun.png|link=|87px |links||media|Vragenlijsten]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Op deze pagina wordt het functioneel ontwerp beschreven voor de uitwisseling van vragenlijsten en antwoorden binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan gevonden worden op de pagina [[MedMij:V2019.01_Ontwerpen|Ontwerpen MedMij]].

Het ontwerp richt zich op de uitwisseling van informatie en niet op de gebruikersfunctionaliteiten en/of gebruiksvriendelijkheid van een PGO of het systeem van de zorgaanbieder (XIS).

==Doelgroep==
De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen.

==Kaders en uitgangspunten==
===Richtlijn===
Er zijn geen richtlijnen van het zorgaanbiedersdomein. Bij implementeren van de standaard gelden de volgende uitgangspunten:
* Maak gebruik gemaakt van de bestaande, internationale, FHIR-profielen van [http://hl7.org/fhir/us/sdc/index.html SDC (Structured Data Capture)]
** Bij het overnemen van een profiel, zijn deze in hun geheel toegepast
** Het gaat alleen om die profielen die voor deze use case toegevoegde waarde hebben
* Bij ieder overgenomen profiel is, een voor Nederland specifiek profiel opstellen. Er is bijvoorbeeld minimaal een referentie nodig naar het Nederlandse patiëntprofiel
* De SDC-profielen hebben reeds veel verschillende vraagsoorten & antwoordmogelijkheden gespecificeerd, deze worden overgenomen.

===Infrastructuur===
Geen nadere specificatie, anders dan genoemd in [[MedMij:V2019.01_Ontwerpen#Infrastructuur| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Geografische reikwijdte===
Geen nadere specificatie, anders dan genoemd in [[MedMij:V2019.01_Ontwerpen#Geografische_reikwijdte| de algemene inleiding]] van de MedMij functionele ontwerpen.

===Informatie reikwijdte===
Het ontwerp richt zich op de uitwisseling van informatie en niet op de gebruikersfunctionaliteiten en/of gebruiksvriendelijkheid van een PGO of het systeem van de zorgaanbieder (XIS).
Het ontwerp bevat:
* Een eenvoudige zorgsituatie:

# Een zorgaanbieder maakt, buiten de persoonlijke gezondheidsomgeving om, een afspraak met een patiënt over het invullen van een vragenlijst
# Deze zorgaanbieder maakt de vragenlijst beschikbaar voor de persoonlijke gezondheidsomgeving van de patiënt
# De patiënt gebruikt zijn persoonlijke gezondheidsomgeving om de vragenlijst op te halen
# De patiënt vult de vragenlijst in en stuurt de antwoorden in zijn geheel terug naar het systeem van de zorgaanbieder (XIS).

Expliciet buiten scope van het ontwerp zijn de volgende onderwerpen:
* Workflow-gerelateerde zaken.
** Notificaties, anders dan waarin het afsprakenstelsel van MedMij wordt voorzien.
** Werkafspraken over (tijdigheid van) invullen en terug sturen.
** Aanpak voor multi-channel mogelijkheden (bijvoorbeeld: via PGO in combinatie met portaal en schriftelijk).

* Complexe computergestuurde vragenlijsten (bijvoorbeeld: Computer Adaptive Testing - CAT).
* Interpretatie van antwoorden. Een uitgangspunt is om PGO's nog niet te belasten met het berekenen van scores op basis van ingevulde antwoorden. Het uitwisselen van de definitie van score-berekening is daarom ook buiten scope. Een XIS kan eventueel berekende scores en terugsturen aan een PGO met de use case [[MedMij:V2019.01_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt|PDF/A]].
* Ontwikkeling van nieuwe zibs specifiek voor vragenlijsten.
* Standaardisatie van de inhoud van vragenlijsten (de deliverables van dit project zijn content-agnostisch).
* Toepassing van specifieke coderingen of codestelsels (met uitzondering van administratieve gegevens van patiënt).
* Mogelijke financiële consequenties van het gebruik van vragenlijsten, bijvoorbeeld licentiekosten.

'''Nb.''' Vragenlijsten kunnen gespecificeerde opmaak (bijvoorbeeld vet- of schuingedrukte tekst) hebben die betekenisvol is voor het invullen van een vragenlijst door een PGO-Gebruiker en hiermee relevant is voor een zorgverlener om de uitkomsten te interpreteren. De standaard voorziet in de mogelijkheden om opmaak te specificeren en van gebruikers van deze standaard wordt verwacht dat ze hiermee om kunnen gaan.

==Kwalificatie==
===Introductie===
{{#lst:MedMij:V2019.01_Kwalificatie|medmij_kwalificatie_introductie}}

=Use Cases=
Het raadplegen van de vragenlijstverwijzing, vragenlijst en het sturen van de antwoorden zijn 3 use cases die nadrukkelijk bij elkaar horen. Functioneel kunnen ze zelfs gezien worden als verschillende acties binnen een zelfde use case. Ze zijn echter als separate use case gedefinieerd omdat:
* Het raadplegen van een verwijzing naar een vragenlijst, de vragenlijst en het sturen van de antwoorden asynchroon plaatsvindt
* Het MedMij-afsprakenstelsel voor 'raadplegen en beschikbaarstellen' en voor 'sturen en ontvangen' separate use cases definieert.
Door dit ook in de informatiestandaard gescheiden te houden, kunnen de use cases uit de informatiestandaard goed gemapt worden op de use cases uit het [https://afsprakenstelsel.medmij.nl/display/MedMijAfsprakenstelsel120/MedMij+Afsprakenstelsel+1.2.0 MedMij-afsprakenstelsel]. De splitsing is alleen niet goed voor het totaaloverzicht van de verschillende scenario's.

Er zijn twee bedrijfsrollen, namelijk ''Patiënt'' en ''Zorgaanbieder''. Een zorgaanbieder biedt een verwijzing naar een vragenlijst aan, die gebruikt kan worden door een patiënt om bij de zorgaanbieder zelf of een externe repository een vragenlijst op te halen. De patiënt kan dan de vragenlijst invullen en terugsturen naar de zorgaanbieder. Onderstaande tabel geeft de rollen weer.

{| class="wikitable" "cellpadding="10" width="100%"
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Activiteit'''
|-
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:top;"|Wil vragenlijsten in een persoonlijke gezondheidsomgeving kunnen invullen en de antwoorden terugsturen.
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Wil dat patiënten vragenlijsten invullen en de antwoorden aan de zorgaanbieder sturen.
|}

Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

<font size = "1">'''Activiteitendiagram vragenlijsten'''</font>

==Use case: Raadplegen vragenlijstverwijzing ==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken om in een PGO een vragenlijst te ontvangen en in te vullen.
=== Domein ===
Vragenlijsten in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd aanbieden c.q. beschikbaarstellen van vragenlijsten door zorgaanbieders vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De informatie-elementen voor raadplegen en beschikbaarstellen vragenlijstverwijzing staan in [https://decor.nictiz.nl/pub/vragenlijsten/ ART-DECOR]

==== Raadplegen vragenlijstverwijzing ====
Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de raadplegen vragenlijstverwijzing.

==== Beschikbaarstellen vragenlijstverwijzing ====
Informatie-elementen in Vragenlijsten staan hieronder. Deze informatie is ook in een nieuw tabblad te openen.

<html>
<iframe width="100%" height="400" src=https://decor.nictiz.nl/pub/vragenlijsten/vl-html-20200403T135608/tr-2.16.840.1.113883.2.4.3.11.60.56.4.248-2019-04-11T132707.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

=== Procesbeschrijving ===
==== Patient Journey – Jelmer Postma ====
Een voorbeeldsituatie die de meerwaarde van vragenlijsten met een PGO schetst is de patient journey van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Jelmer_Postma_MedMij.pdf Jelmer Postma].
<blockquote>Jelmer wordt door zijn GZ-psycholoog gevraagd een vragenlijst te vullen over zijn stemmingen gedurende een dag. De psycholoog spreekt met Jelmer af dat hij deze zal invullen voorafgaand aan het volgende consult. Een patiënt als Jelmer Postma kan via zijn PGO een vragenlijst van een zorgverlener ontvangen. Hij vult deze op een later moment in en stuurt de antwoorden volgens afspraak weer terug naar de zorgaanbieder. Bij het volgende consult kan de GZ-psycholoog samen met Jelmer de vragenlijst doornemen.</blockquote>

==== Proces ====
Deze use case ondersteunt geen workflow tussen zorgaanbieder en patiënt. Eventuele procesafspraken zijn dus geen onderdeel van deze use case. Voordat het proces start heeft een medewerker van de zorgaanbieder met een patiënt afgesproken om op of voor een bepaald moment een vragenlijst in te vullen. Het stuk van het proces waar het in deze use case om gaat is:
* Een zorgaanbieder (XIS) stelt de vragenlijstverwijzing beschikbaar.
Het resultaat is dat de patiënt (PGO) de beschikking over een verwijzing waarmee die vervolgens de relevante vragenlijst kan ophalen.

Deze paragraaf vervolgt met een beschrijving van precondities, processtappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van vragenlijsten tussen zijn PGO en het betreffende XIS.
De patiënt en zorgaanbieder hebben onderling procesafspraken gemaakt over het invullen van de vragenlijst.
Het XIS van de zorgaanbieder is in staat vragenlijstverwijzingen specifiek beschikbaar te stellen aan een patiënt en vervolgens de antwoorden weer te ontvangen van de patiënt via zijn PGO.
De XIS is in staat de betreffende vragenlijst beschikbaar te stellen aan raadplegers.

===== Processtappen =====
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| Zorgaanbieder wijst een bepaalde vragenlijst toe aan patiënt (in het XIS)
|-
| style="background-color: white;"| 02
| style="background-color: white;"| PGO bevraagt het XIS om deze toewijzing te ontvangen in de vorm van een verwijzing naar een vragenlijst. Deze verwijzing is een URI waar het PGO de daadwerkelijke vragenlijst kan ophalen.
|}

===== Postconditie =====
Patiënt heeft de beschikking over de vragenlijst in zijn PGO en kan de vragen daar gaan invullen.

=== Systemen & Systeemrollen ===
Zowel de patiënt als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om vragenlijsten en antwoorden tussen de persoon en de zorgaanbieder.

{| 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;"| Vragenlijstverwijzing raadplegend systeem
| style="background-color: white;"| VL-1.0.0-QLR-FHIR
| style="background-color: white;"| Raadplegen van verwijzing naar vragenlijst door patiënt
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Vragenlijstverwijzing beschikbaarstellend systeem
| style="background-color: white;"| VL-1.0.0-QLB-FHIR
| style="background-color: white;"| Beschikbaarstellen van verwijzing naar vragenlijst voor PGO
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vragenlijsten_(Raadplegen).png|Componenten diagram Vragenlijstverwijzing en Vragenlijst raadplegen]]

<font size = "1">'''Componenten diagram Vragenlijsten raadplegen'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

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

{| 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:middle;" rowspan="2"|Verwijzing naar vragenlijsten(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen verwijzing naar vragenlijst
|style="background-color: white;vertical-align:top;"|VL-1.0.0-QLR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Questionnaire(response) in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen verwijzing naar vragenlijst
|style="background-color: white;vertical-align:top;"|VL-1.0.0-QLB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:Use_Case_Diagram_-_Vragenlijsten_(Raadplegen).png|Use case diagram Sturen Beelden]]

<font size = "1">'''Use case diagram raadplegen vragenlijstverwijzing en raadplegen vragenlijst</font>

==Use case: Raadplegen vragenlijst ==
{{NoteBox|Deze uitwisseling kan op dit moment niet via het MedMij Afsprakenstelsel / het MedMij-netwerk plaatsvinden.}}
=== Doel en relevantie ===
Het voor patiënten mogelijk maken om in een PGO een vragenlijst te ontvangen en in te vullen. Het vervolgens weer terugsturen van de antwoorden staat beschreven in een aparte use case: [[MedMij:V2019.01_OntwerpVragenlijsten#Use_case:_Sturen_vragenlijstantwoorden|sturen vragenlijstantwoorden]].

=== Domein ===
Vragenlijsten in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd aanbieden c.q. beschikbaarstellen van vragenlijsten door zorgaanbieders vanuit een zorgaanbiederssysteem (XIS) naar een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO).
Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De informatie-elementen voor raadplegen en beschikbaarstellen vragenlijst staan in [https://decor.nictiz.nl/pub/vragenlijsten/ ART-DECOR]

Deze informatie-elementen ondersteunen de volgende aspecten:
* Het al dan niet tonen van bepaalde vragen in de vragenlijst afhankelijk van de antwoorden:
** Hierbij gaat het er om dat sommige vragen overgeslagen worden op basis van een antwoord op een andere vraag (sprongvragen). De dataset kent hiervoor het element 'enableWhen'
* Specificeren van verschillende type vragen:
** Het gaat dan om bijvoorbeeld keuzelijst met één of meerdere selecties, vrije tekst, combinaties hiervan, schalen, et cetera
* Vragenlijsten kunnen ook bepaalde eisen aan de weergave van vragen/antwoordopties definiëren, welke dan verplicht zijn om te volgen. Het verschillend weergegeven van vragenlijsten compromitteren de validiteit en/of vergelijkbaarheid van de vragenlijst. Denk hierbij aan:
** volgorde van antwoordopties of
** het in één keer tonen van alle antwoordopties of
** het recht onder elkaar staan van antwoordopties
** specifieke opmaak zoals '''vet'''- of ''schuin''gedrukte tekst

==== Raadplegen vragenlijst ====
Er zijn geen specifieke filtermogelijkheden (query parameters) gedefinieerd voor de raadplegen vragenlijst.

==== Beschikbaarstellen vragenlijst ====
Informatie-elementen in Vragenlijsten staan hieronder. Deze informatie is ook in een nieuw tabblad te openen.

<html>
<iframe width="100%" height="400" src=https://decor.nictiz.nl/pub/vragenlijsten/vl-html-20200403T135608/tr-2.16.840.1.113883.2.4.3.11.60.56.4.255-2019-04-11T140121.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

=== Procesbeschrijving ===
==== Patient Journey – Jelmer Postma ====
Een voorbeeldsituatie die de meerwaarde van vragenlijsten met een PGO schetst is de patient journey van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Jelmer_Postma_MedMij.pdf Jelmer Postma].
<blockquote>Jelmer wordt door zijn GZ-psycholoog gevraagd een vragenlijst te vullen over zijn stemmingen gedurende een dag. De psycholoog spreekt met Jelmer af dat hij deze zal invullen voorafgaand aan het volgende consult. Een patiënt als Jelmer Postma kan via zijn PGO een vragenlijst van een zorgverlener ontvangen. Hij vult deze op een later moment in en stuurt de antwoorden volgens afspraak weer terug naar de zorgaanbieder. Bij het volgende consult kan de GZ-psycholoog samen met Jelmer de vragenlijst doornemen.</blockquote>

==== Proces ====
Deze use case ondersteunt geen workflow tussen zorgaanbieder en patiënt. Eventuele procesafspraken zijn dus geen onderdeel van deze use case.
Voordat het proces start heeft een medewerker van de zorgaanbieder met een patiënt afgesproken om op of voor een bepaald moment een vragenlijst in te vullen.

Het stuk van het proces waar het in deze use case om gaat is:
* Een zorgaanbieder stelt de vragenlijst beschikbaar (bijvoorbeeld via een vragenlijst-repository waarbij het niet relevant is of de zorgaanbieder deze repository zelf aanbiedt of gebruik maakt van een externe partij).
* De zorgaanbieder koppelt een vragenlijst aan de patiënt.
* De patiënt haalt vervolgens de relevante vragenlijst op.
Het resultaat is dat de patiënt de beschikking heeft over de vragenlijst in zijn PGO en de vragen kan gaan beantwoorden.

Deze paragraaf vervolgt met een beschrijving van precondities, processtappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van vragenlijsten tussen zijn PGO en het betreffende XIS.
De patiënt en zorgaanbieder hebben onderling procesafspraken gemaakt over het invullen van de vragenlijst.
Het XIS van de zorgaanbieder is in staat vragenlijstverwijzingen specifiek beschikbaar te stellen aan een patiënt en vervolgens de antwoorden weer te ontvangen van de patiënt via zijn PGO.
XIS is in staat de betreffende vragenlijst beschikbaar te stellen aan raadplegers.

===== Processtappen =====
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| PGO heeft vanuit het XIS een verwijzing naar een vragenlijst ontvangen. Zie use case [[MedMij:V2019.01_OntwerpVragenlijsten#Use_case:_Raadplegen_vragenlijstverwijzing|Raadplegen vragenlijstverwijzing]]
|-
| style="background-color: white;"| 02
| style="background-color: white;"| PGO haalt vervolgens de vragenlijst op (Nb. Ophalen kán plaatsvinden buiten het MedMij-Afsprakenstelsel. Als dit buiten het MedMij-afsprakenstelsel plaatsvindt, wordt dit 'niet op de persoon herleidbaar' gedaan.).
|}

===== Postconditie =====
Patiënt heeft de beschikking over de vragenlijst in zijn PGO en kan de vragen daar gaan invullen.

=== Systemen & Systeemrollen ===
{{NoteBox|Deze uitwisseling kan op dit moment niet via het MedMij Afsprakenstelsel / het MedMij-netwerk plaatsvinden.}}
Zowel de patiënt als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om vragenlijsten en antwoorden tussen de persoon en de zorgaanbieder.

{| 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;"| Vragenlijst raadplegend systeem
| style="background-color: white;"| VL-1.0.0-QER-FHIR
| style="background-color: white;"| Raadplegen van vragenlijst door PGO (zonder dat het herleidbaar is op de persoon)
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Vragenlijst beschikbaarstellend systeem
| style="background-color: white;"| VL-1.0.0-QEB-FHIR
| style="background-color: white;"| Beschikbaarstellen van vragenlijst voor PGO (zonder dat het herleidbaar is op de persoon)
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vragenlijsten_(Raadplegen).png|Componenten diagram Vragenlijstverwijzing en Vragenlijst raadplegen]]

<font size = "1">'''Componenten diagram Vragenlijsten raadplegen'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

=== Transacties & Transactiegroepen ===
{{NoteBox|Deze uitwisseling kan op dit moment niet via het MedMij Afsprakenstelsel / het MedMij-netwerk plaatsvinden.}}
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 use case.

{| 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:middle;" rowspan="2"|Vragenlijsten(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen vragenlijst
|style="background-color: white;vertical-align:top;"|VL-1.0.0-QER-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Questionnaire(response) in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen vragenlijst
|style="background-color: white;vertical-align:top;"|VL-1.0.0-QEB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder

|}

===Use case diagram===
[[Bestand:Use_Case_Diagram_-_Vragenlijsten_(Raadplegen).png|Use case diagram Sturen Beelden]]

<font size = "1">'''Use case diagram raadplegen vragenlijstverwijzing en raadplegen vragenlijst</font>

==Use case: Sturen vragenlijstantwoorden ==
=== Doel en relevantie ===
Het voor patiënten mogelijk maken om vanuit een PGO de antwoorden op een vragenlijst terug te sturen naar de zorgaanbieder.

=== Domein ===
Antwoorden op vragenlijsten in het domein van zorgaanbieders en patiënten.

=== Context ===
Het gaat om het elektronisch en gestructureerd sturen van antwoorden op vragenlijsten door PGO-gebruiker aan zorgaanbieders vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar zorgaanbiederssysteem (XIS). Deze pagina bevat (verwijzingen naar) beschrijvingen van:
*informatie
*bedrijfsrollen (actoren),
*proces,
*systemen,
*systeemrollen,
*transactiegroepen en transacties, inclusief de inhoud van deze transacties.
De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De informatie-elementen voor sturen en ontvangen vragenlijstantwoorden staan in [https://decor.nictiz.nl/pub/vragenlijsten/ ART-DECOR]

Informatie-elementen in Vragenlijstantwoorden staan hieronder. Deze informatie is ook in een nieuw tabblad te openen.

<html>
<iframe width="100%" height="500" src=https://decor.nictiz.nl/pub/vragenlijsten/vl-html-20200403T135608/tr-2.16.840.1.113883.2.4.3.11.60.56.4.263-2020-04-01T135355.html frameborder="0" align="middle"></iframe>
</html>

=== Bedrijfsrollen ===
Onderstaande afbeelding toont de verschillende activiteiten uit de procesbeschrijving die door de bedrijfsrollen worden uitgevoerd in samenhang met de hieronder beschreven use cases.

[[Image:Activity_Diagram_-_Vragenlijsten.png|Activiteitendiagram vragenlijsten]]

=== Procesbeschrijving ===
==== Patient Journey – Jelmer Postma ====
Een voorbeeldsituatie die de meerwaarde van vragenlijsten met een PGO schetst is de patient journey van [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Jelmer_Postma_MedMij.pdf Jelmer Postma].
<blockquote>Jelmer wordt door zijn GZ-psycholoog gevraagd een vragenlijst te vullen over zijn stemmingen gedurende een dag. De psycholoog spreekt met Jelmer af dat hij deze zal invullen voorafgaand aan het volgende consult. Een patiënt als Jelmer Postma kan via zijn PGO een vragenlijst van een zorgverlener ontvangen. Hij vult deze op een later moment in en stuurt de antwoorden volgens afspraak weer terug naar de zorgaanbieder. Bij het volgende consult kan de GZ-psycholoog samen met Jelmer de vragenlijst doornemen.</blockquote>

==== Proces ====
Deze use case ondersteunt geen workflow tussen zorgaanbieder en patiënt. Eventuele procesafspraken zijn dus geen onderdeel van deze use case.
Voordat het proces start heeft een medewerker van de zorgaanbieder met een patiënt afgesproken om op of voor een bepaald moment een vragenlijst in te vullen. Ook heeft de patiënt de vragenlijst opgehaald zoals beschreven in [[MedMij:V2019.01_OntwerpVragenlijsten#Use_case_1:_Raadplegen_vragenlijst|de use case raadplegen vragenlijst]].

Het stuk van het proces waar het in deze use case om gaat is:
* De patiënt beantwoordt de vragenlijst in zijn PGO en stuurt de antwoorden terug naar de zorgaanbieder.

Afhankelijk van het doel van de vragenlijst kan een medewerker van de zorgaanbieder de vragenlijst met de patiënt op een later moment bespreken.

Deze paragraaf vervolgt met een beschrijving van precondities, proces stappen, en post condities.

===== Preconditie =====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van (antwoorden op) vragenlijsten tussen zijn PGO en het betreffende XIS.
De patiënt en zorgaanbieder hebben onderling procesafspraken gemaakt over het invullen van de vragenlijst. Het PGO heeft een vragenlijst opgehaald.

===== Proces stappen =====
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Stap
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 01
| style="background-color: white;"| PGO stelt de patiënt in staat de vragenlijsten in te vullen
|-
| style="background-color: white;"| 02
| style="background-color: white;"| Patiënt beantwoordt de vult de vragenlijsten in
|-
| style="background-color: white;"| 03
| style="background-color: white;"| Patiënt bepaalt wanneer het invullen gereed is
|-
| style="background-color: white;"| 04
| style="background-color: white;"| PGO stuurt de antwoorden terug naar het XIS
|}

===== Postconditie =====
De zorgaanbieder kan de vragenlijst met antwoorden inzien in het XIS.
De patiënt en zorgaanbieder kunnen hierover in overleg.

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken gebruik van een informatiesysteem:
* PGO (patiënt)
* XIS (zorgaanbieder)

Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om vragenlijsten en antwoorden tussen de persoon en de zorgaanbieder.

{| 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;"| Antwoorden op vragenlijst sturend systeem
| style="background-color: white;"| VL-1.0.0-QRS-FHIR
| style="background-color: white;"| Sturen van antwoorden op de vragenlijst aan zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| Antwoorden op vragenlijst ontvangend systeem
| style="background-color: white;"| VL-1.0.0-QRO-FHIR
| style="background-color: white;"| Ontvangen van antwoorden op de vragenlijst van de patiënt
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Vragenlijsten_(Sturen).png|Componenten diagram Vragenlijstverwijzing en Vragenlijst sturen]]

<font size = "1">'''Componenten diagram Vragenlijsten sturen'''</font>

De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

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

{| 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:middle;" rowspan="2"|Antwoorden op vragenlijst (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen antwoorden op vragenlijst
|style="background-color: white;vertical-align:top;"|VL-1.0.0-QRS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_Questionnaire_and_Questionnaire_Response_(Vragenlijsten)|Questionnaire(response) in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Ontvangen antwoorden op vragenlijst
|style="background-color: white;vertical-align:top;"|VL-1.0.0-QRO-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

===Use case diagram===
Onderstaande afbeelding toont bedrijfsrollen, activiteiten, systeemrollen, transacties en transactiegroep in samenhang met [[MedMij:V2019.01_OntwerpVragenlijsten#Use_case_1:_Raadplegen_vragenlijst|de use case raadplegen vragenlijsten]].

[[Bestand:Use_Case_Diagram_-_Vragenlijsten_(Sturen).png|Use case diagram Sturen Vragenlijsten]]

<font size = "1">'''Use case diagram Vragenlijsten</font>

=Functionaliteit=
Er zijn geen aanwijzingen/eisen voor functionaliteit van de systemen.

=Verantwoordelijkheid voor informatie=
Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

=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;"| <span id="sdc">-</span>
| style="background-color: white;"| Structured Data Capture (SDC)
| style="background-color: white;"| 2.0 (STU2)
| style="background-color: white;"| 2017-04-21
| style="background-color: white;"| https://hl7.org/fhir/us/sdc/STU2/
| style="background-color: white;"| U.S. Office of the National Coordinator (ONC)'s Standards and Infrastructure (S & I) Framework
|}
<font size = "1">'''Referenties</font>

=Release notes=

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard. Zie de [[MedMij:Vdraft_Ontwerpen#Release_Notes|Ontwerpen landingspagina]] voor wijzigingen die op alle informatiestandaarden van toepassing zijn.
{| class="wikitable" "cellpadding="10" style="background-color: white;"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
{{ReleaseNotes|package=2019.01 - September 2020|release=1.0.5|issues=1|MM-1353}}
{{ReleaseNotes|package=2019.01 - Mei 2020|release=1.0.4|issues=2|MM-1085|MM-1084}}

MedMij:Vprepub-2019.01 OntwerpVragenlijsten

2020-09-29T09:47:33Z

Camiel Reijnders: MM-1353: Notebox opgenomen in FO voor Vragenlijsten om duidelijk te maken dat de uitwisseling op dit moment niet via het MedMij Afsprakenstelsel kan plaatsvinden.

MedMij:V2019.01 FHIR eAfspraak

2020-09-29T09:37:40Z

Camiel Reijnders: MM-1383: Explanation in eAfspraak for the use cases book, cancel and reschedule an appointment, that they cannot longer be implemented within the MedMij context.

__NUMBEREDHEADINGS__
{{DISPLAYTITLE:MedMij FHIR Implementation Guide - eAfspraak {{VersieInfo|eAfspraak|release=V2019.01}}}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:EAfspraak_icoon_zonder_tekst.png |link=|links |87px|eAfspraak]]
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpeAfspraken|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
This page describes how a patient can manage his health care related appointments in a MedMij context using the HL7 FHIR Standard. Initially, this guide will contain information on how to request existing appointment information. Guidance on how to create, update, or cancel appointments will be available here as well at a later stage.
The functional requirements for this use case can be found in the [[MedMij:V2019.01_Ontwerpen|functional design]].

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

==Introduction==
The goal of this use case is to give patients an overview of their appointments with all healthcare providers. The appointment information that is shared with the patient will contain start and end date/time, location, type of appointment, patient instructions, health care professionals present. Below is described how a PHR can retrieve this information and how a XIS should make this information available.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request appointments from the XIS
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves appointments to the PHR
|}

==Invocations==
===Client - PHR===

====Search for appointments ====
The PHR system can request the appointments using individual search interactions. The search interaction searches for appointments based on '''start''' date/time. The interaction can be performed by an HTTP GET as shown:

<code>GET [base]/Appointment/?date=[date]</code>

for more information on how to query on dates using FHIR see [http://hl7.org/fhir/stu3/search.html#date| the FHIR search specification]

'''examples:'''

retrieve appointments with a start date/time from 01-01-2018 onwards:

<code>GET [base]/Appointment/?date=gt2017-12-31</code>

retrieve appointments with a start date/time from 01-01-2018 until 01-03-2018

<code>GET [base]/Appointment/?date=ge2018-01-01&date=lt2018-03-01</code>

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section].

====Response on search request====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the returned content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails (cannot be executed, not that there are no matches), the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. Note: An empty search result is not a failure.

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Appointment?patient=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Appointment?appointment-type=83280</code>, where the 83280 is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Appointment?date=le1995</code>, where the system only has data going back to 2001
* A date/time parameter may have incorrect format e.g. <code>GET [base]/Appointment?date=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve appointment information:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===<span id="Operations1"></span>Operations===
No operations are defined or needed for this transaction.

===Search parameters===
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name||Type||Description||Expression
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| date
| [http://hl7.org/fhir/stu3/search.html#date date]
| Appointment date/time.
| Appointment.start
|-
|}

==Profiles==

{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.3.x|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #Zib Patient|Patient
| Patient
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
| Afspraak
| Appointment
| Appointment
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
|}

==Examples==
{{Sjabloon:Voorbeelden}}

=Use case: book an appointment=

{{NoteBox|This uses case can no longer be implemented within the MedMij-context.}}

==Introduction==
The goal of this use case is to allow patients to book an appointment at a certain selected health care provider. Below is described how a PHR can send an appointment request and how a XIS should handle this.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Book appointment
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Handles appointment request
|}

==Invocations==
===Client - PHR===

====Search for available slots ====
The PHR system can request available slots using the [[#Operations2|<code>$prefetch</code> operation]] with optional input parameters on the Slot endpoint. This operation is a request for the XIS to calculate available slots, and return a Bundle with available slots. The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Slot/$prefetch</code>

The optional input parameters can be put in the request body using the Parameters resource. The full specification of the <code>$prefetch</code> operation is described here:
[[#Operations2|$prefetch operation]]

Below is an example of an operation that requests Slots with a start date/time between July 15th 8PM and July 17th 8PM:

'''example body'''

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "start",
"valueDateTime" : "2017-07-15T20:00:00Z"
},
{
"name": "end",
"valueDateTime" : "2017-07-17T20:00:00Z"
}
]
}
</pre>

A Bundle containing the available Slot resources and an optional [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome] resource can be expected as return.

For more information on how operations work using FHIR see [http://hl7.org/fhir/stu3/operations.html the FHIR search specification]

====Book appointment====

After fetching open Slots, an Appointment resource is created by the Client Application and is exchanged with the EHR. This Appointment will be the parameter for the [[#Operations2|$book operation]].
The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Appointment/$book</code>

The full specification of the $book operation is described here:
[[#Operations2|$book operation]]

The proposed Appointment has to be put in the request body using the Parameters resource.

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "appointment",
"resource": {
"resourceType": "Appointment",
--snip--
}
},
]
}
</pre>

A Bundle containing an required Appointment resource with status "booked" or "cancelled" and an optional [http://hl7.org/fhir/stu3/operationoutcome OperationOutcome] resource can be expected as return.

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] and the [http://hl7.org/fhir/STU3/operations.html operations section].

====Serve available slots ====
A Client can fetch available slots using the <code>$prefetch</code> operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the available Slots based on the clients' input parameters, and/or an optional OperationOutcome resource.

====Handle appointment booking request ====
A Client can propose an appointment to be booked using the <code>$book</code> operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the proposed appointment with either a "booked" or "cancelled" status based on the XIS internal logic. The server can also send an optional OperationOutcome resource, containing a "success" or "error" explaining the result.

====Response on operation request====
If an operation succeeds, an HTTP Status success code is returned. This will usually be a 2xx code, though it may also be a 303 See Other. Other kinds of 3xx codes should be understood to indicate that the operation did not proceed, and the client will need to re-issue the operation if it can perform the redirection (e.g. may get redirected to an authentication step). User agents should note that servers may issue redirects, etc. to authenticate the client in response to an operation request. An HTTP status code of 4xx or 5xx indicates an error, and an OperationOutcome SHOULD be returned with details.

In general, an operation response uses the [http://hl7.org/fhir/parameters.html Parameters] format regardless of whether there is only one or there are multiple named out parameters.
However, the defined <code>$prefetch</code> operation only has one out parameters named "return". This means the parameters resource doesn't have to be used and the response is simply the resource itself. Which in this case is a [http://hl7.org/fhir/bundle.html Bundle] resource of type "search-response", containing the requested resources.

The resources that are returned by the operation may be retained and made available in the resource repository on the operation server. In that case, the server will provide the identity of the resource in the returned resources. When resources that are not persisted are returned in the response, they will have no id property.

Link to the relevant FHIR specification: http://hl7.org/fhir/stu3/operations.html

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve avaialable slots information:
* [http://hl7.org/fhir/STU3/http.html#operations Operations]

===<span id="Operations2"></span>Operations===
* '''$prefetch''' (Fetch available Slots): {{Simplifier|http://nictiz.nl/fhir/OperationDefinition/eAfspraak-slot-prefetch|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
* '''$book''' (Book Appointment): {{Simplifier|http://nictiz.nl/fhir/OperationDefinition/eAfspraak-appointment-book|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}

==Profiles==

{{NoteBoxPackage|https://simplifier.net/NictizSTU3-Zib2017/~packages|1.3.x|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #Zib Patient|Patient
| Patient
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-patient|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| {{Simplifier|http://fhir.nl/fhir/StructureDefinition/nl-core-organization|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
| Afspraak
| Appointment
| Appointment
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
|-
| Slot
| Slot
| Slot
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Slot|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
|}

==Examples==
{{Sjabloon:Voorbeelden}}

=Use case: cancel/reschedule an appointment=

{{NoteBox|This uses case can no longer be implemented within the MedMij context.}}

==Introduction==
The goal of this use case is to allow patients to cancel a specific appointment. Below is described how a PHR can send a cancellation request and how a XIS should handle this.

'''Rescheduling is a combination of cancelling and re-booking an appointment. For booking an appointment, see the use case above.'''

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Cancel appointment
|-
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Handles cancellation request
|}

==Invocations==
===Client - PHR===

====Search for available slots ====
The PHR system can request the cancellation of a specific appointment using the [[#Operations3|$cancel operation]] with the appointment as input parameter on the Appointment endpoint. This operation is a request for the XIS to handle the request, and provide a Bundle resource with the Appointment resource (canceled or not) and an optional OperationOutcome slots as return. The operation can be performed by an HTTP POST as shown:

<code>POST [base]/Appointment/$cancel</code>

The optional input parameters can be put in the request body using the Parameters resource. The full specification of the $cancel operation is described here:
[[#Operations3|<code>$prefetch</code> operation]]

'''example body'''

<pre>
{
"resourceType": "Parameters",
"parameter": [
{
"name": "appointment",
"resource": {
"resourceType": "Appointment",
--snip--
}
},
]
}
</pre>

A Bundle containing the Appointment resources and an optional [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome] resource can be expected as return.
If the appointment was indeed cancelled, the returned Appointment resource will have a status of "cancelled". If not, the Appointment will be returned as is, and a explanation will be returned in an OperationOutcome resource, with an explanation.

For more information on how operations work using FHIR see [http://hl7.org/fhir/stu3/operations.html the FHIR search specification]

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] and the [http://hl7.org/fhir/STU3/operations.html operations section].

====Handle appointment cancellation request ====
A Client can propose an appointment to be booked using the $cancel operation. (See client section above for details). A server is expected to answer this operation with a Bundle containing the proposed appointment either unchanged (if the request was denied) or with a "cancelled" status (if the request was approved) based on the XIS's internal logic. The server can also send an optional OperationOutcome resource, containing a "success" or "error" explaining the result.

====Response on operation request====
If an operation succeeds, a HTTP Status success code is returned. This will usually be a 2xx code, though it may also be a 303 See Other. Other kinds of 3xx codes should be understood to indicate that the operation did not proceed, and the client will need to re-issue the operation if it can perform the redirection (e.g. may get redirected to an authentication step). User agents should note that servers may issue redirects, etc. to authenticate the client in response to an operation request. An HTTP status code of 4xx or 5xx indicates an error, and an OperationOutcome SHOULD be returned with details.

In general, an operation response uses the [http://hl7.org/fhir/parameters.html Parameters] format whether there is only one or there are multiple named out parameters.
However, the defined <code>$cancel</code> operation only has one out parameters named "return". This means the parameters don't have to be used and the response is simply the resource itself. Which in this case is a [http://hl7.org/fhir/bundle.html Bundle] resource of type "search-response", containing the requested resources.

The resources that are returned by the operation may be retained and made available in the resource repository on the operation server. In that case, the server will provide the identity of the resource in the returned resources. When resources that are not persisted are returned in the response, they will have no id property.

Link to the relevant FHIR specification: http://hl7.org/fhir/stu3/operations.html

==Interactions, operations, search parameters==
===Interactions===
The following FHIR interactions are needed to retrieve avaialable slots information:
* [http://hl7.org/fhir/STU3/http.html#operations Operations]

===<span id="Operations3"></span>Operations===
* '''$cancel''' (Cancel Appointment): {{Simplifier|http://nictiz.nl/fhir/OperationDefinition/eAfspraak-appointment-cancel|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}

==Profiles==
{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|Name NL||Name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Afspraak
| Appointment
| Appointment
| {{Simplifier|http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment|nictiz.fhir.nl.stu3.zib2017|pkgVersion=1.3.10}}
|-
|}

==Examples==
{{Sjabloon:Voorbeelden}}

=Terminology, NamingSystems, Mappings=

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].

An explanation about mappings can be found at [[MedMij:V2019.01_FHIR_IG#Mapping_of_coded_concepts|Mapping of coded concepts]].

=Release notes=
Release notes can be found on the [[MedMij:V2019.01_OntwerpeAfspraak#Release_notes| functional design page]].

MedMij:Vprepub-2019.01 FHIR eAfspraak

2020-09-29T09:37:40Z

Camiel Reijnders: MM-1383: Explanation in eAfspraak for the use cases book, cancel and reschedule an appointment, that they cannot longer be implemented within the MedMij context.