Brontekst bekijken van mp:V3.0.0-beta.3 Ontwerp medicatieproces 9 voor patient usecases

{{StartUitgefaseerd|28-11-2024|Zie de [[MP:Medicatieoverdracht_Kickstart|kickstart landingspagina Medicatieproces 9]] voor de actuele versie van de informatiestandaard voor de kickstart.|Consult the [[MP:Medicatieoverdracht_Kickstart|kickstart overview page Medicatieproces 9]] for the current versions of the information standard for the kickstart.}}

__NUMBEREDHEADINGS__

{{DISPLAYTITLE:Functioneel Ontwerp Medicatieproces 9 versie 3.0.0-beta.3 {{VersieInfo|mp|release=V9.3}} voor patiënt usecases}}

{{NoteBox|Deze versie zal worden getoetst tijdens de kickstart medicatieoverdracht. De versie is niet geschikt voor gebruik buiten deze beproeving.}}


=Inleiding=
==Algemeen==
Dit is het functioneel ontwerp voor patiënt gerelateerde usecases voor medicatieproces 9 (MP9). De algemene MP9 standaard is functioneel omschreven met [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9 deze specificaties]. Er wordt aangenomen dat de lezer bekend is met de algemene functionele specificaties van MP9, deze zijn namelijk ook van toepassing op de patiënt usecases.

Dit ontwerp is alleen bedoelt voor partijen die zijn aangesloten bij de kickstart. Het technisch ontwerp voor patiënt usecases voor deelnemende partijen aan de kickstart is [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0_MedicationProcess9_FHIR_for_patient_use_cases hier] te vinden. Verdere documentatie voor kickstart deelnemers is beschikbaar op de [https://informatiestandaarden.nictiz.nl/wiki/mp:Medicatieoverdracht_Kickstart landingspagina kickstart]. 

Deze pagina beschrijft usecases voor de patiënt in relatie tot de informatiestandaard Medicatieproces 9. Deze usecases zijn gebaseerd op MP9 versie 3.0.0-beta.3. Het doel van de pagina is om de verschillende uitwisselingsscenario's van medicatiegegevens met de patiënt weer te geven. Dit als aanvulling op de uitgebreide functionele specificatie van de informatiestandaard.
Deze pagina is gedurende de kickstart geen onderdeel van MedMij maar maakt wel gebruik van de MedMij termen en stukken voor leesbaarheid en aanvullende informatie.

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

==Kaders en uitgangspunten==
De kaders en uitgangspunten zoals beschreven in de [https://informatiestandaarden.nictiz.nl/wiki/MedMij:FO:V1/FunctioneelOntwerp#Kaders_.26_Uitgangspunten functionele overkoepelende hoofdpagina van MedMij] zijn van toepassing op deze pagina. Voor de richtlijn, infrastructuur en geografische reikwijdte gelden geen nadere specificaties, anders dan in de [https://informatiestandaarden.nictiz.nl/wiki/MedMij:FO:V1/FunctioneelOntwerp algemene inleiding] van de MedMij functionele ontwerpen.

==Kwalificatie==

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 [https://informatiestandaarden.nictiz.nl/wiki/mp:Medicatieoverdracht_Kickstart#TEST-_EN_VALIDATIEMATERIAAL kwalificatie paragraaf] op de medicatieproces landingspagina.

=Use Cases=


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

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een medicatiegegevens 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 die van toepassing zijn, zijn gedefinieerd in de [https://decor.nictiz.nl/pub/medicatieproces/ informatiestandaard voor Medicatieproces].
====Raadplegen medicatiegegevens====
Informatie-elementen in de vraag om medicatiegegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/pub/medicatieproces/mp-html-20240229T110214/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.373-2022-06-30T000000.html hier].

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

<html>
<iframe width="100%" height="400" src=https://decor.nictiz.nl/pub/medicatieproces/mp-html-20240229T110214/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.373-2022-06-30T000000.html frameborder="0" align="middle"></iframe>
</html>

====Beschikbaarstellen medicatiegegevens====
Informatie-elementen in medicatiegegevens staan hieronder. Om deze informatie in een nieuwe tab te openen, klik [https://decor.nictiz.nl/pub/medicatieproces/mp-html-20240229T110214/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.374-2022-06-30T000000.html hier].

Dit betreft de inhoud van de transactie met medicatiegegevens.

<html>
<iframe width="100%" height="400" src=https://decor.nictiz.nl/pub/medicatieproces/mp-html-20240229T110214/tr-2.16.840.1.113883.2.4.3.11.60.20.77.4.374-2022-06-30T000000.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 medicatiegegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medicatiegegevens beschikbaar
|}
<font size = "1">'''Bedrijfsrollen Medicatiegegevens'''</font>

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

[[Bestand:Activity Diagram - Medicatiegegevens.png|Activiteitendiagram Raadplegen Medicatiegegevens]]

<font size = "1">'''Activiteitendiagram Raadplegen Medicatiegegevens'''</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 medicatiegegevens een rol speelt.

<blockquote>Roos heeft de afgelopen tijd in verband met haar hartfalen en diabetes diverse wijzigingen in haar medicatie gehad. Dit is soms gedaan door de specialist en soms door de huisarts. De apotheker paste dan daarna ook soms de doseerinstructies aan, omdat er een ander product geleverd moest worden dan voorgeschreven was. Eigenlijk is Roos het overzicht een beetje kwijtgeraakt. Gelukkig heeft haar PGO wel de mogelijkheid om bij al haar zorgverleners medicatiegegevens op te vragen. Haar PGO kan dit aan haar presenteren in een overzichtelijk geheel. Roos kan nu controleren of ze al haar medicatie inneemt conform de laatste afspraken die hierover zijn gemaakt. Dit is voor Roos heel geruststellend.</blockquote>

====Proces====
Het stuk van het proces waar het in deze use case om gaat is: 
*Het systeem van een zorgaanbieder (XIS) stelt medicatiegegevens 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 medicatiegegevens tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

De patiënt wil medicatiegegevens inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om medicatiegegevens 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 medicatiegegevens bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert medicatiegegevens op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om medicatiegegevens in te zien.

=====Post conditie=====
De patiënt kan medicatiegegevens 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 medicatiegegevens 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;"| MedicatiegegevensRaadplegend
| style="background-color: white;"| MP{{VersieInfo|Medicatieproces|release=V3.0.0}}-MGR-3.0.0-FHIR
| style="background-color: white;"| Raadplegen medicatiegegevens bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| MedicatiegegevensBeschikbaarstellend
| style="background-color: white;"| MP{{VersieInfo|Medicatieproces|release=V3.0.0}}-MGB-3.0.0-FHIR
| style="background-color: white;"| Beschikbaarstellen medicatiegegevens aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Medicatiegegevens (Totaal).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"|Medicatiegegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen medicatiegegevens
|style="background-color: white;vertical-align:top;"|MP{{VersieInfo|Medicatieproces|release=V3.0.0}}-MGR-3.0.0-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"|[[mp:V3.0.0_MedicationProcess9_FHIR_for_patient_use_cases#Medication_data_.28Retrieve.2FServe.29|Medicatiegegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen medicatiegegevens
|style="background-color: white;vertical-align:top;"|MP{{VersieInfo|Medicatieproces|release=V3.0.0}}-MGB-3.0.0-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

=Aanvullende informatie=
Dit hoofdstuk wordt gebruikt om aanvullende informatie te geven over overige relevante informatie voor het gebruik van MP9.

==Generieke werking MP9==
De informatiestandaard MP9 werkt met een basis set aan gegevens die kunnen worden uitgewisseld en geraadpleegd. Deze basis set aan gegevens zijn onderverdeeld in zogenaamde [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9#Therapeutische_en_logistieke_bouwstenen bouwstenen] en worden per stap in het algehele [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9#Medicatieproces medicatieproces] aangemaakt en beschikbaar gesteld. De samenhang tussen deze bouwstenen wordt aangebracht door het concept ‘[https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9#Medicamenteuze_behandeling medicamenteuze behandeling]’ wat verder wordt uitgelegd in de algemene functionele specificaties van MP9. Nadat de bouwsteen door het bronsysteem is beschikbaar gesteld, kan de patiënt deze opvragen en inzien d.m.v. het MedMij afsprakenstelsel.

==Medicatieoverzicht==
Het medicatieoverzicht is het leesoverzicht dat elke patiënt kan opvragen en waarop al zijn/haar gegevens uit de basis set medicatiegegevens op leesbare wijze gepresenteerd worden. Op het medicatieoverzicht staan de medicatiegegevens uit de basis set die in de informatiestandaard zijn gespecificeerd.

In [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9#Medicatieoverzicht_en_afleidingsregels hoofdstuk 5]  van het algemene FO van MP9 staat een voorbeeld van een medicatieoverzicht en worden de afleidingsregels omschreven voor het opstellen van het medicatieoverzicht. Deze regels zijn van belang omdat ze ervoor zorgen dat de informatie altijd eenduidig is, zowel voor de patiënt als voor de zorgverlener.

Het medicatieoverzicht kan worden samengesteld door gebruik te maken van de gegevensdienst ‘medicatiegegevens’. Met deze gegevensdienst zijn alle verschillende bouwstenen op te vragen die onderdeel zijn van MP9  waarmee ook het medicatieoverzicht wordt gemaakt. Het medicatieoverzicht bevat echter alleen de meest [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9#Laatste_relevante relevante bouwstenen] per medicamenteuze behandeling. Om deze relevante bouwstenen te bepalen, zijn verschillende regels omtrent het overrulen opgesteld. Dit is verder uitgewerkt in een [https://informatiestandaarden.nictiz.nl/wiki/mp:Implementatiehandleiding_Consolidatie/afleidingsregels overzicht] van stappen die nodig zijn voor het consolideren van de informatie voor het medicatieoverzicht.

==Migratie en hybride==
Aangezien niet alle systemen tegelijkertijd de informatiestandaard MP9 implementeren, is er sprake van een transitiefase. Deze fase loopt vanaf de migratie van het eerste systeem tot het moment waarop uiteindelijk alle systemen over zijn op MP9. Gedurende deze fase worden systemen geconfronteerd met een hybride situatie: ze moeten zowel MP9 als oudere berichtenstromen (MP6.12 en/of EDIFACT) ondersteunen.

Er zijn verschillen tussen deze berichtenstromen, wat betekent dat er afspraken nodig zijn om op basis van deze verschillende toch tot een overzichtelijk medicatiedossier te komen. Deze afspraken zijn aanvullend op de informatiestandaard en zijn [https://informatiestandaarden.nictiz.nl/wiki/mp:Vkickstart_MigratieHybride hier] te vinden.

==Afwijkingen t.o.v. generieke functionele specificaties MP9==
Er zijn een aantal specificaties waarin de patiënt use cases afwijken van de generieke specificaties. Dit zijn de volgende punten:
<ul> 
 <li> In [https://informatiestandaarden.nictiz.nl/wiki/mp:V3.0.0-beta_Ontwerp_medicatieproces_9#Systemen_en_transacties hoofdstuk 7] van de generieke specificaties staan systeemrolcodes omschreven. Deze gelden niet voor de patiënt use cases. De systeemrolcodes voor patiënt use cases zijn [[#Systemen_.26_Systeemrollen| hier]] te vinden.</li>
 <li> De term 'use case' wordt op deze pagina gebruikt in overeenstemming met de [https://nictiz.nl/standaarden/begrippen/ Nictiz brede definities]. De generieke specificaties hanteert zijn eigen definitie.</li>
 <li> De termen 'transactie' en 'gegevensdienst' worden zowel op deze pagina als in de algemene specificaties inwisselbaar gebruikt.</li>
</ul>

=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;"|omschrijving
!style="text-align:left;"|BITS issue
!style="text-align:left;"|Datum
|-
|style="background-color: white;vertical-align:top;"|MP9 3.0.0-beta.2
|style="background-color: white;vertical-align:top;"|Titel van pagina aangepast naar "MP9 3.0.0-beta.2". Verder geen aanpassingen nodig op deze pagina.
|style="background-color: white;vertical-align:top;"|N.v.t.
|style="background-color: white;vertical-align:top;"|01-08-2023
|-
|style="background-color: white;vertical-align:top;"|MP9 3.0.0-beta.3
|style="background-color: white;vertical-align:top;"|Titel van pagina aangepast naar "MP9 3.0.0-beta.3". Verder geen aanpassingen nodig op deze pagina.
|style="background-color: white;vertical-align:top;"|N.v.t.
|style="background-color: white;vertical-align:top;"|01-03-2024
|}