Functioneel Ontwerp eAfspraak

Uit informatiestandaarden
Ga naar: navigatie, zoeken


eAfspraak
Naar medmij.nl
AfsprakenstelselFunctioneelTecnicalAfspraken-Functioneel-Technisch

1 Inleiding

1.1 Algemeen

Deze pagina beschrijft de use case waarbij een patiënt afspraken kan raadplegen met behulp van een persoonlijke gezondheidsomgeving. Algemene informatie betreffende deze use case kan gevonden worden op deze pagina.

1.2 Doelgroep

De doelgroep voor deze pagina wijkt niet af van de algemene doelgroep van de MedMij functionele ontwerpen, die hier gevonden kan worden.

1.3 Kaders en uitgangspunten

1.3.1 Richtlijn

Conform specificaties genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

Toelichting op de zorginformatiebouwstenen: eAfspraak versie maakt gebruik van zib publicatie 2017.

1.3.2 Infrastructuur

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.3.3 Geografische reikwijdte

Geen nadere specificatie, anders dan genoemd in de algemene inleiding van de MedMij functionele ontwerpen.

1.4 Kwalificatie

1.4.1 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 kwalificatiepagina.

2 Use Cases

Deze sectie vervolgt met de volgende use case:

Buiten scope van deze use case vallen:

  • Abonnementsservice
  • Notificaties

2.1 Use case: Afspraak raadplegen door patiënt

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

2.1.2 Domein

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

2.1.3 Context

Het gaat om het elektronisch en gestructureerd beschikbaar maken van afspraken vanuit een zorgaanbiederssysteem (XIS) naar een 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.

2.1.4 Informatie

De informatie-elementen die van toepassing zijn. Specificaties zijn te vinden in de huidige publicatie van de dataset (status "actief", in ART-DECOR).

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

2.1.4.2 Beschikbaarstellen afspraak

Beschikbaarheid van afspraken wordt verwacht vanaf het moment van implementatie van de gegevensdienst door het XIS. Afspraakhistorie van voor dit moment mag ook beschikbaar worden gesteld. De beschikbaarheidsduur is afhankelijk van het door de zorgverlener bepaalde beleid (zie ook beschikbaarheids- en ontvankelijkheidsvoorwaarde onder architectuur, processen en informatie van het MedMij Afsprakenstelsel).

2.1.5 Bedrijfsrollen

Deze use case kent twee bedrijfsrollen.

Bedrijfsrol Activiteit
Patiënt Wil afspraken raadplegen
Zorgaanbieder Stelt afspraken beschikbaar

Bedrijfsrollen afspraak inzien

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

Activiteitendiagram afspraak raadplegen

Activiteitendiagram afspraak raadplegen

2.1.6 Procesbeschrijving

2.1.6.1 'Patient journey' - Thomas van Beek

Het verhaal van de 'patient journey' van Thomas vindt u hier.

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

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.

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

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

2.1.6.2.2 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.
2.1.6.2.3 Post conditie

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

2.1.7 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 afspraken van zorgaanbieder naar de patiënt.

Systeem Naam systeemrol Systeemrolcode Omschrijving
PGO AfspraakRaadplegend EA--AFR-FHIR Raadplegen afspraak bij zorgaanbieder
XIS AfspraakBeschikbaarstellend EA--AFB-FHIR Beschikbaarstellen afspraak aan de patiënt

Zie ook onderstaande afbeelding.

Componenten diagram afspraak raadplegen

Componenten diagram afspraak raadplegen

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

Transactiegroep Transactie Systeemrolcode Systeem Bedrijfsrol Technisch
Afspraken (PULL) Raadplegen afspraak EA--AFR-FHIR PGO Patiënt eAfspraak in FHIR
Beschikbaarstellen afspraak EA--AFB-FHIR XIS Zorgaanbieder

2.1.9 Use case diagram

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

Use case diagram afspraak raadplegen

Use case diagram afspraak raadplegen

3 Functionaliteit

-

4 Verantwoordelijkheid voor informatie

Er zijn geen specifieke toevoegingen over verantwoordelijkheden voor informatie.

5 Afschermen van gegevens

Er zijn geen afspraken over het afschermen van gegevens.

6 Infrastructuur

Er zijn geen afspraken over een specifieke infrastructuur waarop de informatie wordt uitgewisseld.

7 Referenties

Auteur(s) Titel Versie Datum Bron Organisatie
AUTEUR(S) TITEL VERSIE DATUM BRON ORGANISATIE

Referenties

8 Release notes

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

Release Versie BITS issue Omschrijving
2020.01 - November 2022 2.0.25 MM-3792 De tabellen met release notes per versie van de informatiestandaarden zijn opnieuw opgesteld zodat ze een completer beeld geven. De tabellen zijn daarnaast afgekapt op de laatste majorversie van de standaard.
2020.01 - Oktober 2022 2.0.24 MM-3700 De uitleg over het gebruik van tokens is als sectie opgenomen in de overkoepelende handleiding van Touchstone, de losse pagina is verwijderd.
2020.01 - September 2022 2.0.23 MM-3595 The outdated contact information in the profiles has been updated.
2020.01 - Augustus 2022 2.0.22 MM-3493 De uitleg over het gebruik van het CCG-formulier is aangepast naar de huidige werkwijze.
MM-3487 In the technical design for eAfspraak, section "Actors involved", references to the CapabilityStatements have been added for both the client and the server. The table has also been expanded with descriptions of the actors.
MM-3475 The incorrect HTTP status code in the error handling example related to a syntactically incorrect request has been fixed. Moreover several typos and inconsistencies have been corrected on the 'Error handling examples' page.
MM-3162 Op Raadplegen kwalificatiescripts AllergieIntolerantie, PDF/A, eAfspraak, Zelfmetingen wordt nu toegelicht dat er in de kwalificatie geen extra raadpleging op patient wordt verwacht, wanneer in een scenario geen inhoudelijke gegevens beschikbaar zijn.
2020.01 - Juli 2022 2.0.21 MM-3367 Spelfouten opgelost en andere kleine aanpassingen doorgevoerd.
MM-3355 Een toelichting dat het BSN niet uitgewisseld mag worden met PGO's is toegevoegd aan het algemeen functioneel ontwerp.
MM-3338 De git-repository's "Nictiz-STU3-testscripts" en "Nictiz-STU3-testscripts-src" zijn samengevoegd en verhuisd naar een nieuw repository met de naam "Nictiz-testscripts".
MM-3337 De TestScript-resources voor test- en kwalificatiedoeleinden op TouchStone zijn gemigreerd naar FHIR R4.
MM-3308 In the FHIR STU3 IG, the link to "paging" the FHIR spec has been corrected.
MM-3300 In the MedMij FHIR IG, the link to "MedMij consultaties" has been corrected.
2020.01 - Juni 2022 2.0.20 MM-3288 Spelfouten opgelost en andere kleine aanpassingen doorgevoerd.
MM-3279 De narratives in de test- en kwalificatiefixtures worden vanaf nu bij elke wijziging opnieuw gegenereerd.
MM-3254 In the general IG an explanation has been added that our FHIR profiles don't use the mustSupport flag.
MM-3233 In het technische kwalificatiemateriaal zijn de Location-resources nu gekoppeld aan de Organization-resource van de hoofdorganisatie en heeft die Organization-resource nu adresgegevens. Missende profieldeclaraties zijn toegevoegd.
MM-3230 Several examples of the zib2017 profiles were missing a reference to PractitionerRole. This reference has been added.
MM-2759 Correct and incorrect examples have been added to the common FHIR IG for referencing resources when the server doesn't support RESTful reads.
2020.01 - Mei 2022 2.0.19 MM-3204 In de Touchstone-handleiding is een waarschuwing geplaatst over het verwijderen van de USER_KEY of ORG_KEY in publieke plekken.
MM-3054 Reference.display is niet langer verplicht in de technische testscripts wanneer de NullFlavor- of data-absent-reason-extensie aanwezig is.
MM-2574 In de eAfspraak dataset (ART-DECOR), is de waardelijst "contactstatus" nu gekoppeld aan HL7 Appointmentstatus (alleen STU3 codes zijn gekoppeld)
2020.01 - April 2022 2.0.18 MM-3096 In the error handling examples on the FHIR IG, 'OperationOutcome.code' has been replaced by 'OperationOutcome.issue.code' in accordance with the FHIR specs.
MM-3045 Aan alle DVZA-testen voor succesvolle search operations op Touchstone is een assert toegevoegd die controleert of de self-link de gebruikte search parameters onderkent.
MM-3032 In de kwalificatiematerialen wordt nu gecontroleerd of FHIR Identifiers zowel een .system (of eventueel een .type) en een .value bevatten.
MM-2972 De Identifier veranderd van URL naar urn:oid in onze technisch kwalificatie materiaal.
MM-2714 In the Implementation Guide from eAppointment, guidance is added on how to link an Organization to the appointment when a Location isn't supported.
2020.01 - Maart 2022 2.0.17 MM-2973 De assert die testte op aanwezigheid van .display of .text in elementen van type CodeableConcept ging er ten onrechte vanuit dat .text alleen aanwezig mag zijn als de gecodeerde waarde afwezig is. Dit is aangepast.
MM-2747 The definition of .participant has been clarified in the profile eAfspraak appointment
MM-2712 The eAppointment profile now supports the NHG-14 code system in ContactType.
2020.01 - Februari 2022 2.0.16 MM-2887 Op de FAQ kwalificatiepagina is de term pre-kwalificatie vervangen door kwalificatie 1. Verder is het kwalificatieproces verduidelijkt.
MM-2886 Added a textual known issue to the ValueSet ProbleemNaamCodelijst that an urn:oid is present where an url is expected.
MM-2882 Op de kwalificatiewikipagina is explicieter aangegeven dat bij afwijkingen van het kwalificatiescript er een argumentatie noodzakelijk is dat vooraf moet worden gecommuniceerd.
MM-2880 In the profiles nl-core-address and nl-core-contactpoint, the Markdown notation for the tables has been changed to an actual table instead of a code block.
MM-2872 Er is een leesvriendelijke tekst aan 2 links toegevoegd in de introductie op het algemene functioneel ontwerp
MM-2858 De PGO-testscripts voeren geen uitgebreide checks meer uit op de FHIR-responses vanuit de testserver.
MM-2846 In een van de technische PDFA-testscripts voor XIS-systemen die test op een JSON-response werd om een XML-response gevraagd. Dit is aangepast.
MM-2844 The patch version number for nl-core-practitioner has been corrected.
MM-2820 In the package manifests for all packages, the incorrect entry "web" has been changed to "url". This change pertains the packages for zib2017, Questionnaires, BgZ, Images and eAfspraak.
MM-2787 In de technische TestScripts wordt gecontroleerd of .system én .code altijd samen aanwezig zijn en of er geen ValueSet-uri gebruikt wordt als .system.
MM-2770 Op de kwalificatiewikipagina's is additionele informatie toegevoegd dat verduidelijkt op welke systeemomgeving gekwalificeerd dient te worden.
MM-2721 De generieke uitgangspunten van de systeemrol 'Sturen' is toegevoegd en de systeemrol 'Ontvangen' is uitgebreider beschreven op de kwalificatiepagina 2020.01.
MM-2663 In de gezamenlijke basis voor de Touchstone-testen zijn de MedMij-asserts uitgesplitst van de niet-MedMij-asserts. Hierdoor is de volgorde van asserts in veel Touchstone-testscripts veranderd.
MM-2659 Een aantal overlappende testen in de technische TestScripts van verschillende standaarden zijn generaliseerd naar een algemene basis. Sommige TestScripts voeren daardoor completere controles uit.
MM-2375 De aansluitpagina voor Touchstone is veralgemeniseerd zodat deze multi-inzetbaar. Op de MedMij-wikipagina staat nu deze algemene informatie samen met MedMij-specifieke informatie.
2020.01 - Januari 2022 2.0.15 MM-2764 In de meest recente beoordelingsformulieren is de volledigheidsbeoordeling uitgebreid met specifiekere technische criteria. Tevens is de achterhaalde term '(pre)' van '(pre)kwalificatie' verwijderd uit de beoordelingsformulieren en wikipagina's.
MM-2734 Er is nu een pagina met informatie over het toepassen van herleidbaarheid in PGO en XIS. Hiernaar wordt naar verwezen vanuit het algemeen functioneel ontwerp en alle kwalificatiescripts voor de rollen raadplegen en ontvangen. 
MM-2655 The references to the FHIR profiles for nl-core-practitionerrole and nl-core-location were missing on the eAfspraak FHIR IG, they have been added to the list of profiles.
MM-2531 De ontbrekende uitleg over het gebruik en invoeren van de variabele T-datum is toegevoegd aan de sectie Configureren simulator op de kwalificatiepagina.
MM-2515 Aan de kwalificatie-eisen is uitleg toegevoegd in welke omstandigheden een Touchstone-uitvoer gefaalde tests mag bevatten.
MM-2461 In the zib2017 FHIR package, the missing terminology bindings in profiles zib-AllergyIntolerance and zib-BodyHeight have been restored.
MM-2324 All LoadResources scripts for the qualification materials are bundled per main folder (MedMij-20XX.0X-Test/Cert), leading to less overhead in the montly update cycle.
2020.01 - November 2021 2.0.14 MM-2432 CapabilityStatements (client/server) are created for eAppointment.
MM-2451 Op de kwalificatiepagina's van eAfspraak en Zelfmetingen is een downloadbaar overzicht geplaatst onder 'specifieke afspraken huisartssystemen'. Het overzicht bevat implementatie-advies vanuit OPEN/Legio en welke afwijkingen op het kwalificatiescenario zijn toegestaan voor DVZA/HIS combinaties.
MM-2555 In the qualification material of eAppointment we have added the ContactType at some resources. At Afspraak 3 we have changed the PatientInstructions to the right instructions of the Addendum.
2020.01 - Oktober 2021 2.0.13 MM-213 The nl-core-location profile lacked mappings on some elements from the eAfspraak dataset, those mappings have been added.
2020.01 - Augustus 2021 2.0.11 MM-2299 De kwalificatiescripts en addenda zijn naar wiki-pagina’s omgezet. Verwijder of archiveer eerder gedownloade (pdf) versies.
2020.01 - Juli 2021 2.0.10 MM-2229 De ART-DECOR publicatie toont, conform de informatiestandaard versie 2.0, nu alleen de transactiegroep "Raadplegen Afspraak". Op het functioneel ontwerp is de nieuwe link naar deze publicatie opgenomen.
2020.01 - Juni 2021 2.0.9 MM-2060 Per informatiestandaard-versie van eAfspraak een eigen publicatie op ART-DECOR gemaakt. Op het functioneel ontwerp (wiki) is een iframe op genomen dat alleen de transactie beschikbaarstellen eAfspraak toont.
2020.01 - Mei 2021 2.0.8 MM-1775 De verwachting dat het XIS afspraken beschikbaar stelt vanaf het moment van implementatie, als toelichting ingevoegd op het functioneel ontwerp van eAfspraak (par. 2.1.4.2).
2020.01 - Maart 2021 2.0.3 MM-1895 De niet van toepassing zijnde basisoperaties 'maken', 'annuleren' en 'wijzigen' verwijderd uit het functioneel ontwerp.
2020.01 - Oktober 2020 2.0.2 MM-1399 In the eAfspraak Appointment profile, the mapping on Appointment.description is corrected. Also clarification has been added to Appointment.indication and Appointment.reason.
2020.01 - September 2020 2.0.1 MM-1383 Verwijderen van niet te gebruiken eAfspraak-scenario's afspraak maken, wijzigen en verwijderen.
MM-1285 In the ValueSet RedenMedicatieAfspraakCodelijst, replaced the custom ART-DECOR code with SNOMED for the .designation.use element.