Brontekst bekijken van MedMij:V2018.06 OntwerpeAfspraak

{{#customtitle:Functioneel Ontwerp eAfspraak 1.0.0}}

[[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 02 white.png|center|400px|alt=Afspraken-Functioneel-Technisch   
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]                
circle 1013 224 212 [[MedMij:V2018.06_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.06_FHIR_eAfspraak|Tecnical]]                 
desc none                    
</imagemap>

<div class="toclimit-{{{2|{{{limit|3}}}}}}">__TOC__</div>

=Inleiding=

==Algemeen==
Deze pagina beschrijft use cases waarbij een patiënt afspraken kan raadplegen, maken, annuleren of wijzigen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_Ontwerpen wiki pagina].

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

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

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

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

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

Voor meer informatie, stuur een mail naar [mailto:kwalificatie@medmij.nl kwalificatie@medmij.nl].

Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via [[MedMij:V2018.06_Kwalificatie|Kwalificatie scripts]].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
*[[#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt|Afspraak raadplegen]]
*[[#Use_case:_Afspraak_maken_door_pati.C3.ABnt|Afspraak maken]]
*[[#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt|Afspraak annuleren]]
*[[#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt|Afspraak wijzigen]]
==Use case: Afspraak raadplegen door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken 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===

====Raadplegen afspraak ====
Het raadplegen van een afspraak gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Verdere informatie-elementen in de vraag om afspraken zijn:
*periode (startdatum - einddatum) waarin de afspraak plaats heeft gehad / heeft / zal hebben
Dit betreft dus de filtermogelijkheden (query parameters) in de vraag om afspraken.

====Beschikbaarstellen afspraak ====
De informatie-elementen voor beschikbaarstellen afspraak staan in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak]

=== 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 afspraken raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt afspraken beschikbaar
|}
<font size = "1">'''Bedrijfsrollen afspraak inzien'''</font>

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

[[Bestand:Activity Diagram - Afspraak raadplegen.png|Activiteitendiagram afspraak raadplegen]]

<font size = "1">'''Activiteitendiagram afspraak raadplegen'''</font>

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas 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 afspraken een rol speelt.

<blockquote>Thomas heeft iedere drie maanden een controle in het ziekenhuis in verband met zijn Diabetes aandoening. De eerstkomende afspraak is op vrijdag 6 oktober 2017 om 10:30u met internist Janssen bij het Antonius Ziekenhuis in Rotterdam en duurt een uur. Het ziekenhuisinformatiesysteem heeft deze afspraak beschikbaar gemaakt voor de persoonlijke gezondheidsomgeving van Thomas. Thomas kan deze afspraak dan ook inzien via zijn persoonlijke gezondheidsomgeving.
----
Op 6 september belt de afdelingssecretaresse van het ziekenhuis. Zij heeft het verzoek aan Thomas of de afspraak verzet kan worden naar dinsdag 3 oktober om 16:00 uur. Dat komt hem prima uit, dus hij gaat akkoord. Het ziekenhuisinformatiesysteem maakt deze nieuwe afspraakinformatie beschikbaar voor de persoonlijke gezondheidsomgeving. Wanneer Thomas later die dag kijkt, ziet hij ook de bijgewerkte afspraakinformatie in zijn persoonlijke gezondheidsomgeving. Wel zo makkelijk, want hij was het eerder die dag vergeten op te schrijven.
</blockquote>

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

De patiënt wil afspraken inzien en de zorgaanbieder stelt dit ook beschikbaar.
Een patiënt neemt steeds zelf het initiatief om zijn afspraken te raadplegen.

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

=====Post conditie=====
De patiënt heeft afspraken geraadpleegd via de persoonlijke gezondheidsomgeving.

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

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om afspraken van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| PGO
| style="background-color: white;"| AfspraakRaadplegend 
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend 
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak raadplegen (Totaal).png |Componenten diagram afspraak raadplegen]]

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

=== 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;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-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:V2018.06_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-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 - Afspraak raadplegen.png|Use case diagram afspraak raadplegen]]

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

==Use case: Afspraak maken door patiënt==
===Doel en relevantie===
Het maken van afspraken via een persoonlijke gezondheidsomgeving biedt patiënten gebruiksgemak. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het elektronisch en gestructureerd afspraken kunnen maken vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een 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 die van toepassing zijn, zijn vastgelegd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== 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;"|Raadplegen afspraak slots

Sturen afspraakverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots

Ontvangen afspraak verzoek
|}
<font size = "1">'''Bedrijfsrollen Afspraak inzien'''</font>

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

[[Bestand:Activity Diagram - Afspraak maken.png|Activiteitendiagram afspraak maken]]

<font size = "1">'''Activiteitendiagram maken afspraak'''</font>

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

Hieronder een voor Thomas relevante situatie waarbij het maken van afspraken een rol speelt.

<blockquote>De persoonlijke gezondheidsomgeving van Thomas en het ziekenhuisinformatiesysteem (ZIS) van het Noorderziekenhuis in Groningen zijn verbonden vanwege een eerder bezoek van Thomas in het ziekenhuis. 

Thomas wil een afspraak maken voor de driemaandelijkse controle met een diabetesverpleegkundige. Hij wil dit ergens in de tweede week van januari. Zijn persoonlijke gezondheidsomgeving haalt de beschikbare tijden voor deze afspraak op uit het Groningse ziekenhuisinformatiesysteem. Thomas kiest voor woensdag 10 januari van 14:00 – 15:00 uur. Dit verzoek gaat via zijn persoonlijke gezondheidsomgeving naar het ziekenhuisinformatiesysteem, dat de ontvangst van dit verzoek bevestigt. De afspraak is door Thomas te raadplegen via zijn persoonlijke gezondheidsomgeving.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het maken van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraakverzoek wel/niet in behandeling nemen en stuurt daarvan een bevestiging.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch maken van afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde typen afspraken maken en de zorgaanbieder ondersteunt het maken van deze afspraken.

=====Proces stappen=====
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Het systeem van de patiënt (PGO) stuurt een verzoek om een bepaald type afspraak te maken in een bepaalde slot.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraakverzoek en geeft een technisch antwoord. Het antwoord geeft aan of het verzoek wel of niet in behandeling genomen kan worden. 

Indien een verzoek in behandeling genomen kan worden door XIS, dan kan verwerking enige tijd vergen. Het verzoek wordt niet altijd direct afgehandeld.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraakverzoek.

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

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakverzoekSturend
| style="background-color: white;"| EA-1.0.0-AVS-FHIR
| style="background-color: white;"| Sturen afspraakverzoek naar zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AVO-FHIR
| style="background-color: white;"| Ontvangen afspraakverzoek van de patient
|-
|}
Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak maken (Totaal).png|Componenten diagram afspraak maken]]

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

=== 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;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-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="6"|[[MedMij:V2018.06_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakVerzoek (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraakverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AVO-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 - Afspraak maken.png|Use case diagram afspraak maken]]

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

==Use case: Afspraak annuleren door patiënt==
===Doel en relevantie===
Inzicht in afspraken biedt patiënten overzicht en gebruiksgemak. Dat is een functionaliteit die voorwaardelijk is voor deze use case: 'annuleren van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen annuleren vanuit een persoonlijke gezondheidsomgeving. Dit draagt bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen annuleren van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een 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 die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== 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;"|Raadplegen afspraak
Sturen afspraak annulering
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
Ontvangen afspraak annulering
|}
<font size = "1">'''Bedrijfsrollen afspraken inzien'''</font>

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

[[Bestand:Activity Diagram - Afspraak annuleren.png|Activiteitendiagram afspraak annuleren]]

<font size = "1">'''Activiteitendiagram afspraak annuleren'''</font>

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

Hieronder een voor Thomas relevante situatie waarbij het annuleren van afspraken een rol speelt.

<blockquote>Thomas verhuist halverwege oktober 2017 voor zijn afstuderen naar Groningen. De afspraak voor de driemaandelijkse controle was al gemaakt in Rotterdam voor vrijdag 5 januari 2018. Thomas wil nu die afspraak afzeggen omdat hij die dag bezet is vanwege zijn afstudeerstage. Een nieuwe afspraak maakt hij liever in Groningen, dat is voor hem nu veel handiger. 
Hij gebruikt zijn PGO om een verzoek te doen de afspraak in Rotterdam te annuleren. Een aantal uren later bevestigt de medisch secretaresse deze annulering. Thomas kan de afspraken weer raadplegen via zijn PGO.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Een persoonlijke gezondheidsomgeving kan achterhalen welk afspraken het verbonden XIS heeft voor de patiënt. Dit betreft het raadplegen van afspraken. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan voor een bestaande afspraak een verzoek doen tot annulering. Een XIS ontvangt, behandelt en beantwoordt een dergelijk verzoek.

Een PGO heeft afspraken geraadpleegd en opvolging verzoek beoordeeld. Mocht het verzoek niet verwerkt zijn, kan een patiënt ervoor kiezen het opnieuw te proberen, of op een andere manier de zorgaanbieder te benaderen. Indien het verzoek verwerkt is, stelt XIS bij raadpleging door PGO de afspraak met status ‘geannuleerd’ beschikbaar.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil bepaalde afspraken kunnen annuleren en de zorgaanbieder ondersteunt dit.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te annuleren.
*Het systeem van de zorgaanbieder (XIS) ontvangt de annulering en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor het doorvoeren van de annulering.
*Het systeem van de patiënt (PGO) raadpleegt de beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken (waaronder de geannuleerde afspraak met status 'geannuleerd') op voor de patiënt.

Indien het verzoek verwerkt kan worden, stelt XIS de afspraak met status 'geannuleerd' beschikbaar, na raadpleging door patiënt vanuit zijn PGO.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een verzoek tot annulering van een afspraak.

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

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om medicatieoverzichten van zorgaanbieder naar patiënt. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="2"| PGO
| style="background-color: white;"| AfsprakenRaadplegend
| style="background-color: white;"| EA-1.0.0-AFR-FHIR
| style="background-color: white;"| Raadplegen afspraken bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakAnnuleringSturend
| style="background-color: white;"| EA-1.0.0-AAS-FHIR
| style="background-color: white;"| Sturen afspraak annulering naar de zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| AfsprakenBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraken aan de patiënt
|-
| style="background-color: white;"| AfspraakAnnuleringOntvangend
| style="background-color: white;"| EA-1.0.0-AAO-FHIR
| style="background-color: white;"| Ontvangen afspraak annulering van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak annuleren (Totaal).png |Componenten diagram afspraak annuleren]]

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

=== 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;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-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="4"|[[MedMij:V2018.06_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakAnnulering (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak annulering
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AAO-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 - Afspraak annuleren.png |Use case diagram afspraak annuleren]]

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

==Use case: Afspraak wijzigen door patiënt==
===Doel en relevantie===
Inzicht in en het maken van afspraken biedt patiënten overzicht en gebruiksgemak. Dat zijn functionaliteiten die voorwaardelijk zijn voor deze use case: 'wijzigen van afspraken'. Een patiënt is verder geholpen door ook afspraken te kunnen wijzigen vanuit een persoonlijke gezondheidsomgeving. Een wijziging kan ook een annulering betreffen. Dit draagt verder bij aan meer grip op de eigen gezondheidsgegevens en daarmee ook meer regie over de eigen gezondheid.

===Domein===
Afspraken met zorggebruikers (patiënten / cliënten) in het domein van de zorg.

===Context===
Het gaat om het kunnen wijzigen van een afspraak vanuit een [https://www.patientenfederatie.nl/themas/persoonlijke-gezondheidsomgeving/ persoonlijke gezondheidsomgeving] (PGO) naar een 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 die van toepassing zijn, zijn gedefinieerd in [https://decor.nictiz.nl/art-decor/decor-scenarios--eafspraken-?id=2.16.840.1.113883.2.4.3.11.60.61.4.3&effectiveDate=2017-10-10T14%3A19%3A43&datasetId=2.16.840.1.113883.2.4.3.11.60.61.1.1&datasetEffectiveDate=2017-08-01T14%3A56%3A38&conceptId=2.16.840.1.113883.2.4.3.11.60.61.2.1&conceptEffectiveDate=2017-08-01T14%3A56%3A38&language=nl-NL&scenariotree=true ART-DECOR eAfspraak].

=== 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;"|Raadplegen afspraak

Raadplegen afspraak slots

Sturen afspraak wijzigingsverzoek
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak

Beschikbaarstellen afspraak slots

Ontvangen afspraak wijzigingsverzoek
|}
<font size = "1">'''Bedrijfsrollen afspraken inzien'''</font>

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

[[Bestand:Activity Diagram - Afspraak wijzigen.png|Activiteitendiagram afspraak wijzigen]]

<font size = "1">'''Activiteitendiagram afspraak wijzigen'''</font>

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

Hieronder een voor Thomas relevante situatie waarbij het wijzigen van afspraken een rol speelt.

<blockquote>In de loop van december krijgt Thomas een buitenkansje. Een aantal van zijn vrienden gaan met skivakantie van zaterdag 5 t/m 12 januari en er is een plekje vrijgekomen. Voor een zacht prijsje kan hij mee. Daar heeft hij veel zin in!

Thomas zet de skivakantie ‘s avonds laat in zijn agenda en ziet dat dit conflicteert met zijn controle-afspraak in het Noorderziekenhuis op 10 januari. Hij moet die afspraak gaan verzetten. Het is 23:15 en dus te laat om het ziekenhuis hiervoor direct te bellen. 

Via zijn PGO kijkt hij daarom naar beschikbare tijden in de derde week van januari. Er blijkt gelukkig nog een gaatje te zijn op vrijdag 19 januari om 11:30 – 12:30. Het verzoek om te wijzigen gaat via zijn PGO naar het ZIS, dat de ontvangst van het verzoek bevestigt. Bij raadpleging van de afspraken vanuit PGO, stelt XIS de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘ geannuleerd’.
</blockquote>

====Proces====
Het deel van het proces waar het hier om gaat betreft:
*Het systeem van een zorgaanbieder (XIS) stelt afspraken beschikbaar aan het systeem van een patiënt (PGO).
*Een persoonlijke gezondheidsomgeving kan voor een bepaalde periode én een bepaald type afspraak de beschikbare tijden ophalen uit het XIS. Dit betreft het raadplegen van beschikbare afspraak slots. Een XIS stelt deze beschikbaar.
*Een persoonlijke gezondheidsomgeving kan - op basis van beschikbare slots - een verzoek tot het wijzigen van een concrete afspraak doen aan het XIS. Een XIS kan een dergelijk afspraak wijzigingsverzoek behandelen en ontvangst van het verzoek bevestigen.

=====Preconditie=====
De patiënt heeft toestemming gegeven voor het elektronisch uitwisselen van informatie over afspraken tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.
De patiënt wil een afspraak wijzigen en de zorgaanbieder ondersteunt het wijzigen van  afspraken.

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare afspraken bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de afspraken op voor de patiënt.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om afspraken in te zien en er één te selecteren die hij wil wijzigen.
*Het systeem van de patiënt (PGO) vraagt om beschikbare slots voor een bepaald type afspraak in een bepaalde tijdsperiode bij een XIS.
*Het systeem van de zorgaanbieder (XIS) levert de beschikbare afspraak slots op basis van de filter criteria uit de persoonlijke gezondheidsomgeving.
*Patiënt gebruikt de persoonlijke gezondheidsomgeving om beschikbare slots in te zien en er één te selecteren.
*Het systeem van de patiënt (PGO) stuurt een verzoek om de bestaande afspraak te wijzigen.
*Het systeem van de zorgaanbieder (XIS) ontvangt het afspraak wijzigingsverzoek en geeft een technisch antwoord. Het antwoord kan positief of negatief zijn voor de wijziging.

Patiënt raadpleegt opnieuw de afspraken vanuit zijn PGO + XIS stelt de nieuwe afspraak beschikbaar, alsmede de oorspronkelijke afspraak met status ‘geannuleerd’.

=====Post conditie=====
Een persoonlijke gezondheidsomgeving heeft antwoord ontvangen van een XIS over een afspraak wijzigingsverzoek.

Bij een eventueel negatief antwoord van het XIS kan een patiënt ervoor kiezen het opnieuw proberen, bijvoorbeeld met een ander (opnieuw opgevraagd) slot.
Bij een positief antwoord is de afspraak gewijzigd en inzichtelijk in zowel XIS als PGO.

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

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Syteem
!style="text-align:left;"|Naam systeemrol
!style="text-align:left;"|Afkorting
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;" rowspan="4"| PGO
| style="background-color: white;"| AfspraakRaadplegend 
| style="background-color: white;"| EA-1.0.0-AFO-FHIR
| style="background-color: white;"| Raadplegen afspraak bij zorgaanbieder
|-
| style="background-color: white;"| AfspraakSlotsRaadplegend
| style="background-color: white;"| EA-1.0.0-ASR-FHIR
| style="background-color: white;"| Raadplegen afspraak slots bij de zorgaanbieder
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekSturend
| style="background-color: white;"| EA-1.0.0-AWS-FHIR
| style="background-color: white;"| Sturen afspraak wijzigingsverzoek
|-
| style="background-color: white;" rowspan="4"| XIS
| style="background-color: white;"| AfspraakBeschikbaarstellend 
| style="background-color: white;"| EA-1.0.0-AFB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak aan de patiënt
|-
| style="background-color: white;"| AfspraakSlotsBeschikbaarstellend
| style="background-color: white;"| EA-1.0.0-ASB-FHIR
| style="background-color: white;"| Beschikbaar stellen afspraak slots
|-
| style="background-color: white;"| AfspraakWijzigingsverzoekOntvangend
| style="background-color: white;"| EA-1.0.0-AWO-FHIR
| style="background-color: white;"| Ontvangen afspraak wijzigingsverzoek van de patiënt.
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - Afspraak wijzigen (Totaal).png|Componenten diagram afspraak wijzigen]]

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

=== 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;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Afspraken (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFR-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="8"|[[MedMij:V2018.06_FHIR_eAfspraak|eAfspraak in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AFB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakSlots (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen afspraak slots
|style="background-color: white;vertical-align:top;"|EA-1.0.0-ASB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|AfspraakWijziging (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|-
|style="background-color: white;vertical-align:top;"|Ontvangen afspraak wijzigingsverzoek
|style="background-color: white;vertical-align:top;"|EA-1.0.0-AWO-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 - Afspraak wijzigen.png|Use case diagram afspraak wijzigen]]

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

=Functionaliteit=
-

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

=Bijlage: Documenthistorie=

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

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 1.0.0
| style="background-color: white;"| 15 oktober 2018
| style="background-color: white;"| 
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|-
| style="background-color: white;"| 1.0.0
| style="background-color: white;"| 10 januari 2019
| style="background-color: white;"| 
* Aanpassing kwalificatieparagraaf.
|}