MedMij:V2020.02/OntwerpLangdurigeZorg

1 Inleiding

1.1 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 hier gevonden worden.

Binnen het InZicht programma (VIPP langdurige zorg) zijn een tweetal modules opgenomen.

• Module PGO: de Basisgegevens Langdurige Zorg is bedoeld voor deze module. Dit betreft activiteiten die nodig zijn om de gegevensdiensten BgLZ of BgGGZ en PDF/A conform het afsprakenstelsel MedMij te kunnen ontsluiten naar een PGO;
• Module eOverdracht (gericht op de verpleegkundige overdracht tussen zorgprofessionals).

De Basisgegevens Langdurige Zorg bestaat uit gegevens die relevant zijn voor uitwisseling met patiënten binnen de langdurige zorg via hun persoonlijke gezondheidsomgeving (PGO). De Basisgegevens Langdurige Zorg vertoont enige overlap met de Basisgegevensset Zorg (BgZ) en eOverdracht maar is zeker niet hetzelfde: zie 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.

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: Basisgegevens Langdurige Zorg versie 3.1.6 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

2.1 Use case 1: Raadplegen Basisgegevens Langdurige Zorg in persoonlijke gezondheidsomgeving

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

2.1.2 Domein

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

2.1.3 Context

Het gaat om het elektronisch en gestructureerd beschikbaar maken van de Basisgegevens Langdurige Zorg 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 Basisgegevens Langdurige Zorg bestaat uit een selectie van 14 zibs zoals te vinden in dit 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 Basisgegevensset Zorg (BgZ) en eOverdracht, maar voor een deel ook niet: het gaat om drie aparte sets. Zie het overzicht van de inhoud voor een nadere toelichting.

Medicatiegegevens vallen buiten de Basisgegevens Langdurige Zorg, omdat hiervoor gebruik wordt gemaakt van het reeds bestaande Medicatieproces 9.0 (zie uitwisseling medicatiegegevens in PGO).

In de MedMij FHIR implementatiegids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit overzicht is te zien welk FHIR profiel bij welke zib hoort.

2.1.5 Bedrijfsrollen

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

Bedrijfsrol	Activiteit
Patiënt	Wil de eigen Basisgegevens Langdurige Zorg raadplegen
Zorgaanbieder	Stelt de Basisgegevens Langdurige Zorg beschikbaar

Bedrijfsrollen Basisgegevens Langdurige Zorg

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

Activiteitendiagram Raadplegen Langdurige Zorg

2.1.6 Procesbeschrijving

2.1.6.1 Patient journey - Kenneth van Someren

De 'patient journey' van Kenneth van Someren beschrijft enkele momenten waarop je als patiënt zijnde inzicht kan of zou willen hebben in zijn/haar Basisgegevens Langdurige Zorg.

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.

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.

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

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

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

2.1.6.2.3 Postconditie

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

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

Systeem	Naam systeemrol	Systeemrolcode	Omschrijving
PGO	LZRaadplegend	MM-3.1.6-LZR-FHIR	Raadplegen Basisgegevens Langdurige Zorg bij zorgaanbieder
XIS	LZBeschikbaarstellend	MM-3.1.6-LZB-FHIR	Beschikbaarstellen Basisgegevens Langdurige Zorg aan de patiënt

Zie ook onderstaande afbeelding.

Componenten diagram van systemen en systeemrollen

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

Transactiegroep	Transactie	Systeemrolcode	Systeem	Bedrijfsrol	Technisch
Basisgegevens Langdurige Zorg (PULL)	Raadplegen Basisgegevens Langdurige Zorg	MM-3.1.6-LZR-FHIR	PGO	Patiënt	Basisgegevens Langdurige Zorg in FHIR
	Beschikbaarstellen Basisgegevens Langdurige Zorg	MM-3.1.6-LZB-FHIR	XIS	Zorgaanbieder

2.1.9 Use case diagram

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

Use case diagram raadplegen Basisgegevens Langdurige Zorg

3 Functionaliteit

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

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

8 Release notes

In onderstaande tabel staan de wijzigingen voor deze informatiestandaard.

Release	Versie	BITS issue	Omschrijving
2020.02 - November 2022	3.1.6	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.02 - Oktober 2022	3.1.5	MM-3700	De uitleg over het gebruik van tokens is als sectie opgenomen in de overkoepelende handleiding van Touchstone, de losse pagina is verwijderd.
		MM-3641	In een van de CarePlan-fixtures voor de test/kwalificatiematerialen is de PractitionerRole-extensie toegevoegd aan .performer conform het functionele script.
		MM-3296	The custom SearchParameter for references to MedicalDevices from CarePlan has been corrected, so it aligns with the implementation guide.
2020.02 - September 2022	3.1.4	MM-3595	The outdated contact information in the profiles has been updated.
2020.02 - Augustus 2022	3.1.3	MM-3493	De uitleg over het gebruik van het CCG-formulier is aangepast naar de huidige werkwijze.
		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.
2020.02 - Juli 2022	3.1.2	MM-3391	De onterecht verwijderde sectie "inhoudelijke gegevens" voor het scenario van een ongestructureerd zorgplan is teruggeplaatst in het kwalificatiescript Raadplegen Basisgegevens Langdurige Zorg.
		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-3336	In de kwalificatiefixtures voor de Wilsverklaring van de BgLZ is het datumformaat aangepast van YYYY-MM-DD HH:MM naar YYYY-MM-DD.
		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.02 - Juni 2022	3.1.1	MM-3294	In the CapabilityStatements, the resource DeviceUseStatement is deleted and has been added as searchInclude in the resource CarePlan
		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-3266	In het kwalificatiescenario voor het ongestructureerde zorgplan (scenario 1.5) zijn de verpleegkundige problemen als gestructureerde informatie verwijderd uit de sectie Klachten en Diagnoses. Daarnaast is dit scenario toegevoegd op Touchstone.
		MM-3254	In the general IG an explanation has been added that our FHIR profiles don't use the mustSupport flag.
		MM-3232	In the example for the profile zib-FunctionalOrMentalStatus, the display for of the ICF code was wrong. This has been adjusted.
		MM-3230	Several examples of the zib2017 profiles were missing a reference to PractitionerRole. This reference has been added.
		MM-3219	Where possible, the .target element has been added to the SearchParameters.
		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.02 - Mei 2022	3.1.0	MM-3204	In de Touchstone-handleiding is een waarschuwing geplaatst over het verwijderen van de USER_KEY of ORG_KEY in publieke plekken.
		MM-3184	Op de kwalificatiepagina zijn de 'Conformiteitscheck Gegevensdienst'-documenten (CCGs) verwijderd.
		MM-3054	Reference.display is niet langer verplicht in de technische testscripts wanneer de NullFlavor- of data-absent-reason-extensie aanwezig is.
		MM-2961	A spelling mistake in the Fhirpath expression for SearchParameter "Careplan-medicaldevice" has been corrected.
		MM-2800	Guidance on the correct use of TimeInterval has been added to the zib-AdministrationAgreement and zib-MedicationAgreement profiles.
2020.02 - April 2022	3.0.15	MM-3134	In de CCG zijn de concepten binnen de inclusie Contactgegevens aangepast naar rijen.
		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-3034	Er is een correctie uitgevoerd op 4 DVZA beoordelingsformulieren met betrekking tot het criterium van scenario 1.2 over het tonen van een waarschuwing dat er geen zorggegevens voor de patiënt beschikbaar zijn. Dit betrof een criterium voor de DVP/PGO en was onterecht. Deze is middels deze aanpassing verwijderd.
		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.
2020.02 - Maart 2022	3.0.14	MM-3036	De kwalificatiescripts voor BgLZ zijn aangepast op basis van het sjabloon 2022.
		MM-3030	Op de kwalificatiepagina zijn in de subparagrafen "Omschrijving scenario" van de paragraaf "Inhoudelijke gegevens" de teksten (die de PGO betreft) vervangen door een tekst die van toepassing is op het XIS.
		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.
2020.02 - Februari 2022	3.0.13	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-2844	The patch version number for nl-core-practitioner has been corrected.
		MM-2834	In various CapabilityStatements, searchParams that were present, but that were not shown in their respective TOs, were removed and incorrect searchIncludes have been corrected.
		MM-2824	Aan de kwalificatiepagina BgLZ beschikbaar stellen is toegevoegd dat de kwalificatie voor het opnemen van medische diagnoses optioneel is en wat dit betekent voor de inhoudelijke gegevens.
		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-2742	Het FO vermeldde ten onrechte dat het VIPP InZicht programma ook de module Medicatieoverdracht bevat. Dit is gecorrigeerd.
		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.02 - Januari 2022	3.0.12	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-2711	De 'conformiteitscheck gegevensdienst'-documenten (CCG) zijn toegevoegd op de kwalificatiepagina voor alle gegevensdiensten waarvoor deze beschikbaar zijn.
		MM-2677	De onterechte waarschuwing dat dit een werkpagina zou zijn is verwijderd op de kwalificatiepagina van BgLZ.
		MM-2598	Voor DVZA's is de kwalificatie voor MeerlingIndicator en de voornamen van de zorgverlener optioneel, dit is toegevoegd aan de kwalificatiepagina van BgLZ.
		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.02 - November 2021	3.0.11	MM-2463	Link in paragraaf Richtlijn van het functioneel ontwerp BgLZ is verbeterd (was V2020.01, is nu V2020.02).
2020.02 - Oktober 2021	3.0.10	MM-2335	De tekst uit de Toelichting kwalificaties BgLZ is toegevoegd aan "Specifieke voorwaarden voor kwalificatie" in de Kwalificatiescripts raadplegen en beschikbaarstellen om voortaan daar onderhouden te worden.
2020.02 - September 2021	3.0.9	MM-2383	The comment on the root of AllergyIntolerance, the comment on .verificationStatus and verificationStatus.extension have been removed because the proposed solution was illegal but does not cause backwards incompatability problems.
		MM-2328	Datum T toegevoegd aan de fixtures voor GGZ en BgLZ waar nog een vaste datum stond, zodat alle datumvelden uit de fixtures nu overeenkomen met het addendum.
2020.02 - Augustus 2021	3.0.8	MM-2305	De kwalificatiescripts en addenda zijn naar wiki-pagina’s omgezet. Verwijder of archiveer eerder gedownloade (pdf) versies.
2020.02 - Mei 2021	3.0.5	MM-2080	Changed HTML to Markdown in the definition field for .clinicalStatus in the profile zib-Problem.
		MM-2077	Fixed Markdown formatting in the AllergyIntolerance profile.
		MM-2058	In Addenda voor scenario's 1.1 en 1.5 is een aandachtspunt toegevoegd dat DVPs Zorgaanbieder.Organisatie.Naam en .Organisatie.Locatie niet in aparte velden kunnen en hoeven tonen.
		MM-2051	The missing mapping to the root concept of zib OutcomeOfCare has been added to the corresponding profile.
		MM-2047	In the BgLZ FHIR IG, the extra "t" has been removed from searchInclude Observation:related-targett.
2020.02 - Maart 2021	3.0.3	MM-1905	Dode links op BgLZ-KwalificatieAddendumScenario1.2 en BgLZ-KwalificatieAddendumScenario1.3 gerepareerd.
		MM-1902	Op wiki-pagina V2020.02 Toelichting Kwalificatie Langdurige Zorg zijn de transcludes van de V2020.01 versie vervangen door een kopie zodat deze pagina zelf getranscludeerd kan worden in het Ontwerp Langdurige Zorg.
2020.02 - Februari 2021	3.0.2	MM-1828	The assert in TestScripts that checks if a BSN identifier is present in a Patient resource is improved.
2020.02 - November 2020	3.0.0	MM-1432	Publicatie van de BgLZ 3.0 waarin de mogelijkheid is opgenomen om het Verpleegkundig Zorgplan in de vorm van opgemaakte tekst op te nemen, in publicatieversie 2020.02. In verband met deze publicatie is op pagina's van publicatieversies 2019.01 en 2020.01 die verwijzen naar eerdere versies van de BgLZ een NoteBox toegevoegd: partijen die overwegen zich voor de BgLZ te kwalificeren, wordt gevraagd zich te melden bij MedMij of MedMij Kwalificatiecentrum.
		MM-1522	All references to terminology resources and examples scattered throughout the FHIR IGs are focused around the references to the relevant packages and in the overarching FHIR IG.