informatiestandaarden - Gebruikersbijdragen [nl]

MedMij:V2019.01 ToelichtingSubsidie

2019-07-30T12:41:34Z

Mischa Tol:

MedMij beantwoordt geen vragen over subsidievereisten. Vragen over de impulsfinanciering voor PGO leveranciers zijn te stellen via de daarvoor bestemde kanalen van het ministerie Volksgezondheid, Welzijn en Sport/DUS-I. Deze kanalen en nadere informatie over deze subsidieregeling zijn te vinden via de volgende link:
https://www.dus-i.nl/subsidies/impulsfinanciering-pgo-leveranciers.

=Bijlage: Documenthistorie=
==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 30 juli 2019
| style="background-color: white;"|
* Vervanging tekst door verwijzing naar website VWS/DUS-I
|-
| style="background-color: white;"| 11 maart 2019
| style="background-color: white;"|
* Nieuwe versies informatiestandaarden inclusief systeemrollen toegevoegd conform voorjaarsrelease 2019.01.
* Patchnummer van systeemrolcodes verwijderd.
* Informatiestandaard Basisgegevens GGZ 1.0 toegevoegd
|-
| style="background-color: white;"| 11 januari 2019
| style="background-color: white;"|
* Documenthistorie toegevoegd
* Medicatiegegevens variant tijdelijke systeemrollen toegevoegd
* Wijziging naam en systeemrollen informatiestandaard AllergieIntolerantie
* Versie systeemrollen PDF/A, Zelfmetingen bijgewerkt
|-
| style="background-color: white;"| 15 februari 2019
| style="background-color: white;"|
* Correctie naamgeving Medicatiegegevens verstrekkingenvariant
|-
|}

MedMij:Vprepub-2019.01 ToelichtingSubsidie

2019-07-30T12:41:34Z

Mischa Tol:

MedMij:V2019.01 ToelichtingSubsidie

2019-07-30T12:41:05Z

Mischa Tol: Tekst vervangen door verwijzing

{{MedMij:Vdraft_Issuebox}}

MedMij beantwoordt geen vragen over subsidievereisten. Vragen over de impulsfinanciering voor PGO leveranciers zijn te stellen via de daarvoor bestemde kanalen van het ministerie Volksgezondheid, Welzijn en Sport/DUS-I. Deze kanalen en nadere informatie over deze subsidieregeling zijn te vinden via de volgende link:
https://www.dus-i.nl/subsidies/impulsfinanciering-pgo-leveranciers.

=Bijlage: Documenthistorie=
==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 30 juli 2019
| style="background-color: white;"|
* Vervanging tekst door verwijzing naar website VWS/DUS-I
|-
| style="background-color: white;"| 11 maart 2019
| style="background-color: white;"|
* Nieuwe versies informatiestandaarden inclusief systeemrollen toegevoegd conform voorjaarsrelease 2019.01.
* Patchnummer van systeemrolcodes verwijderd.
* Informatiestandaard Basisgegevens GGZ 1.0 toegevoegd
|-
| style="background-color: white;"| 11 januari 2019
| style="background-color: white;"|
* Documenthistorie toegevoegd
* Medicatiegegevens variant tijdelijke systeemrollen toegevoegd
* Wijziging naam en systeemrollen informatiestandaard AllergieIntolerantie
* Versie systeemrollen PDF/A, Zelfmetingen bijgewerkt
|-
| style="background-color: white;"| 15 februari 2019
| style="background-color: white;"|
* Correctie naamgeving Medicatiegegevens verstrekkingenvariant
|-
|}

MedMij:Vprepub-2019.01 ToelichtingSubsidie

2019-07-30T12:41:05Z

Mischa Tol: Tekst vervangen door verwijzing

MedMij:V2019.01 OntwerpHuisartsgegevens

2019-05-23T12:58:34Z

Mischa Tol: /* Release notes */

{{#customtitle:Functioneel Ontwerp Huisartsgegevens 1.1.4}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:Huisartsgegevens.png|link=|links|Huisartsgegevens|85px]]
[[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:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR GP Data|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
De basis voor de inhoud van dit ontwerp is de "[[#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]". Op basis van deze richtlijn wordt de patiënt in staat gesteld een samenvatting van zijn huisartsdossier online op te vragen.

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

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

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

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

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

==Use case: Raadplegen Huisartsgegevens door patiënt==
===Doel en relevantie===
Online inzage door de patiënt in het elektronisch patiëntendossier bij de huisarts (H-EPD) heeft als doel om de zorg beter te maken. De patiënt krijgt door online inzage meer overzicht en is beter geïnformeerd. Hierdoor heeft de patiënt meer begrip van en regie over de eigen gezondheid en het stimuleert zelfzorg. Ook kan het de kwaliteit van het dossier helpen verhogen.

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

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een huisartsgegevens 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 gegevens zoals deze door de huisarts worden aangeboden voor online inzage aan de patiënt bestaan uit 10 secties (zie bijlage 1 van de richtlijn). Een aantal daarvan overlappen met de [[MedMij:V2019.01_OntwerpBGZ_2017|Basisgegevensset Zorg]] (BgZ) en een aantal daarvan zijn uniek voor het huisartsdossier. De richtlijn baseert zich op het [[#his-referentiemodel-2016|HIS referentiemodel]]. Die richtlijn heeft geen relatie met de [http://www.zibs.nl Zorginformatiebouwstenen] (zibs). Voor een aantal secties is deze relatie wel te leggen en voor een aantal ook niet (goed). De discrepanties zullen in de toekomst, in het Nictiz/NHG project "Huisartsoverdrachten", nog verder onderzocht en geslecht worden. Dit ontwerp Huisartsgegevens loopt daarop vooruit, omdat alle FHIR-profielen zich baseren op de zibs. Dit ontwerp en de technische uitwerking zal worden bijgewerkt, zodra de geharmoniseerde zorginformatiebouwstenen beschikbaar zijn. Dit zal naar verwachting niet vóór 2019 plaatsvinden.

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

{| class="wikitable collapsible collapsed" cellpadding="10" width="80%"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="4" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="2" | (Voorlopige) mapping naar zibs
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Onderdelen uit het Huisarts‑EPD
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Beschrijving
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Uitleg met voorbeelden
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Zorginformatiebouwsteen
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Opmerking
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"|Huisarts/Huisartsenpraktijk
| style="background-color: white;vertical-align:top;"|De huisarts en/of de huisartsenpraktijk waar de gegevens van afkomstig zijn.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/Zorgverlener-v3.1(2017NL) Zorgverlener v3.1 (2017)] [https://zibs.nl/wiki/Zorgaanbieder-v3.1(2017NL) Zorgaanbieder v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"|Patiënt
| style="vertical-align:top;"|De patiëntgegevens van de patiënt waarvoor de samenvatting is.
| style="vertical-align:top;"|
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient v3.1 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"|Episodes
| style="background-color: white;vertical-align:top;"|Een gezondheidsprobleem zoals een klacht of een aandoening, waarvan de aard in de loop der tijd kan veranderen door voortschrijdend inzicht of door het beloop van de aandoening.
| style="background-color: white;vertical-align:top;"|Ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: blaasontsteking of droge hoest.
| style="background-color: white;" rowspan="3"| [https://zibs.nl/wiki/OverdrachtConcern-v1.2(2015NL) OverdrachtConcern v1.2 (2015)] [https://zibs.nl/wiki/Alert-v3.1(2017EN) Alert v3.1 (2017)]
| style="background-color: white;" rowspan="3"| Na 2015 is nog een versie 3.0 in 2016 uitgebracht die alleen in versie, niet in inhoud veranderd is. De versie van 2017 echter heeft expliciet gebruik voor episodes geschrapt.
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"|Episodes met een attentievlag
| style="vertical-align:top;"|Episodes kunnen een attentievlag hebben om extra aandacht voor de episode te vragen. De attentievlag kan aanwezig blijven als een episode afgesloten wordt/is, wanneer de gebruiker het belangrijk vindt dit probleem in beeld te houden.
| style="vertical-align:top;"|Belangrijke ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: reuma, suikerziekte, kanker, erfelijke ziekten.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"|Open en gesloten episodes
| style="background-color: white;vertical-align:top;"|Episodes kunnen open (actueel) of gesloten (niet langer actueel) zijn.
| style="background-color: white;vertical-align:top;"|Open/actueel: ziekten, aandoeningen, klachten en symptomen waarvoor nog zorg wordt verleend. Gesloten/niet actueel: ziekten, aandoeningen, klachten en symptomen waarvoor in het verleden zorg is verleend.
|-
| style="vertical-align:top;"| 6
| style="vertical-align:top;"|Behandeling
| style="vertical-align:top;"|Handeling aan de patiënt, die invloed heeft op de gezondheidstoestand van de patiënt.
| style="vertical-align:top;"|Operaties en (zware) behandelingen zoals bestraling of chemotherapie.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/Verrichting-v4.0(2017NL) Verrichting v4.0 (2017)]''
| style="vertical-align:top;"| Zib ondersteunt alleen de DHD Verrichtingenthesaurus waarmee het huisartssysteem niet werkt.
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Profylaxe en voorzorg
| style="background-color: white;vertical-align:top;"| In Profylaxe en voorzorg worden voorzorgsmaatregelen vastgelegd die nodig zijn bij of vanwege bepaalde medische aandoeningen.
| style="background-color: white;vertical-align:top;"| Bijvoorbeeld voorzorgen bij ooit doorgemaakte endocarditis (ontsteking van de binnenbekleding van het hart en de hartkleppen) of na een miltverwijdering.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Er is in principe slechts een type uit NHG tabel 56
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"| Actuele medicatie
| style="vertical-align:top;"| Medicatie-afspraak Het voorstel van een voorschrijver tot gebruik van medicatie waarmee de patiënt akkoord is. De afspraak kan zowel starten, herhalen, wijzigen als stoppen van medicatie betreffen.
| style="vertical-align:top;"| '''De actuele medicatie''' is het overzicht van de medicatieafspraken. Het is de lijst van geneesmiddelen die de patiënt nu gebruikt.
| style="vertical-align:top;"| [https://zibs.nl/wiki/Medicatieafspraak-v1.0(2017NL) Medicatieafspraak v1.0 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"| Medicatie-overgevoeligheid
| style="background-color: white;vertical-align:top;"| Een medicatie-overgevoeligheid beschrijft een overgevoeligheid van een patiënt voor een geneesmiddel, een stof of een geneesmiddelengroep, waarmee rekening gehouden moet worden bij het voorschrijven van medicatie.
| style="background-color: white;vertical-align:top;"| Lijst van geneesmiddelen waarop in het verleden een overgevoeligheid of levensbedreigende allergische reactie is opgetreden. Bijvoorbeeld: allergie voor aspirine.
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergieIntolerantie-v3.1(2017NL) AllergieIntolerantie v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"|Correspondentie
| style="vertical-align:top;"|Inkomend: Een binnengekomen brief betreffende een patiënt, die als zodanig is vastgelegd in het medisch dossier van de patiënt. Uitgaand: Een brief die opgesteld is door een praktijkmedewerker en naar een externe zorgverlener verstuurd is.
| style="vertical-align:top;"|Inkomende = brieven uit het ziekenhuis, polikliniek, zorginstelling. Uitgaande = verwijsbrieven.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Correspondentie kan een binair bestand zijn zoals PDF/A, typen in de zib zijn niet toereikend voor alle typen correspondentie
|-
| style="background-color: white;vertical-align:top;"| 11
| style="background-color: white;vertical-align:top;"|Resultaten van bepalingen – ''laatste veertien maanden''
| style="background-color: white;vertical-align:top;"|Een bepaling is een objectiveerbare diagnostische verrichting. Het resultaat is de (uitkomst) van een bepaling.
| style="background-color: white;vertical-align:top;"|Uitslagen van fysieke metingen, zoals bloeddruk, gewicht en laboratoriumtesten, zoals ijzergehalte in het bloed.
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/LaboratoriumUitslag-v4.0(2017NL) LaboratoriumUitslag v4.0 (2017)] 
[https://zibs.nl/wiki/Bloeddruk-v3.1(2017NL) Bloeddruk v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamsgewicht-v3.1(2017NL) Lichaamsgewicht v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamslengte-v3.1(2017NL) Lichaamslengte v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamstemperatuur-v3.1(2017NL) Lichaamstemperatuur v3.1 (2017)] 
[https://zibs.nl/wiki/AlgemeneMeting-v3.0(2017NL) AlgemeneMeting v3.0 (2017)] 
[https://zibs.nl/wiki/Hartfrequentie-v3.1(2017NL) Hartfrequentie v3.1 (2017)] 
[https://zibs.nl/wiki/O2Saturatie-v3.1(2017NL) O2Saturatie v3.1(2017)] 
[https://zibs.nl/wiki/Polsfrequentie-v3.1(2017NL) Polsfrequentie v3.1(2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 12
| style="vertical-align:top;"|E- en P-regels van de SOEP- structuur - ''vastgelegd na invoering van online inzage''
| style="vertical-align:top;"|Informatie uit een deelcontact dat in vrije tekst wordt geregistreerd volgens de SOEP-structuur. Het acroniem SOEP staat voor Subjectief, Objectief, Evaluatie en Plan.
| style="vertical-align:top;"|In de E(valuatie)-regel staat de conclusie van het consult. In de P(lan)-regel staan de afgesproken zaken en eventuele vervolgstappen.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Journaalregeltype en ICPC-codering, extra t.o.v. in zib
|}

====Raadplegen huisartsgegevens ====
De vraag wordt gesteld aan de huisarts of huisartsenpraktijk. Er zijn geen verdere parameters bekend. Zie de [[#richtlijn-huisarts-patient|richtlijn]] voor de verdere context van de vraag naar de huisartsgegevens.

Dit betreft de filtermogelijkheden (parameters) in de vraag om huisartsgegevens.

====Beschikbaarstellen huisartsgegevens====
Zie voor de Informatie-elementen in huisartsgegevens de [[#richtlijn-huisarts-patient|richtlijn]].

Dit betreft de inhoud van de transactie met huisartsgegevens.

=== 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 huisartsgegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt huisartsgegevens beschikbaar
|}
'''Bedrijfsrollen huisartsgegevens'''

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

[[Bestand:Activity_Diagram_-_Huisartspatientsamenvatting.jpg|Activiteitendiagram Raadplegen huisartsgegevens]]

'''Activiteitendiagram Raadplegen huisartsgegevens'''

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

Hieronder een voor Roos relevante situatie waarbij het raadplegen van de huisartsgegevens een rol speelt.

<blockquote></blockquote>

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

De patiënt wil de huisartsgegevens inzien en de zorgaanbieder stelt deze ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een huisartsgegevens 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.

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

=====Postconditie=====
De patiënt kan de huisartsgegevens inzien 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 de gegevens van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* HuisartsPatiëntsamenvattingRaadplegend Systeem [MM-1.1.2-HGR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* HuisartsPatiëntsamenvattingBeschikbaarstellend Systeem in FHIR [MM-1.1.2-HGB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Huisartspatientsamenvatting_(Totaal).jpg|Componentendiagram]]

'''Componentendiagram'''

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;"| '''Systeemrol'''
! 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"|Huisartsgegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.2-HGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR GP Data|Huisartsgegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.2-HGB-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_-_Huisartspatientsamenvatting.jpg|Use case diagram raadplegen Huisartsgegevens]]

'''Use case diagram

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| Richtlijn Online inzage in het H-EPD door patiënt
| style="background-color: white;"|
| style="background-color: white;"| 2017
| style="background-color: white;"| https://www.nhg.org/themas/publicaties/richtlijn-online-inzage-het-h-epd-door-patient of de [https://www.nhg.org/sites/default/files/content/nhg_org/images/richtlijn_online_inzage_in_het_h-epd_door_patient_web_2017.pdf directe link (PDF)]
| style="background-color: white;"| NHG / Patiëntenfederatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| HIS referentiemodel Publieksversie (Utrecht 2016)
| style="background-color: white;"|
| style="background-color: white;"| 2016
| style="background-color: white;"| https://referentiemodel.nhg.org/inhoud/themas/publieksversie/published
| style="background-color: white;"| NHG
|}

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="11"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 7; style="background-color: white;"| 2019.01
| style="background-color: white;"|
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-308 MM-308]
| style="background-color: white;"| List of StructureDefinitions has been updated to reflect profiles that are currently implementable. As not the whole guideline is implementable at this point in time as reflected in the List of Invocations, this makes the List of StructureDefinitions smaller than it was. The Corresponce section is thus no longer present and this solves the dead link.
|-
| style="background-color: white;"| 1.1.4
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-269 MM-269]
| style="background-color: white;"| Huisartsgegevens: Discrepantie Technisch ontwerp en Kwalificatie
|-
| style="background-color: white;"| 1.1.3
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-251 MM-251]
| style="background-color: white;"| Fout in voorbeeld sectie Treatment van Huisartsgegevens
|-
| style="background-color: white;"| 1.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 3; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-144 MM-144]
| style="background-color: white;"| Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| rowspan = 3; style="background-color: white;"| 2018.06
| rowspan = 3; style="background-color: white;"| 1.0.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-64 MM-64]
| style="background-color: white;"| Koppelen van meetinstrument aan relevante profielen.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-51 MM-51]
| style="background-color: white;"| Extend query for AllergyIntolerance with parameter <code>code</code>. This parameter allows querying specifically medication intolerances.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 28-03-2019
| style="background-color: white;"|
* Plaatsen release notes behorende bij patch 1.
* Versienummer systeemrol codes ophogen met 1 patch nummer.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpHuisartsgegevens

2019-05-23T12:58:34Z

Mischa Tol: /* Release notes */

MedMij:V2019.01 OntwerpZelfmetingen

2019-05-21T14:37:59Z

Mischa Tol:

{{#customtitle:Functioneel Ontwerp Zelfmetingen 1.2.2 }}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:Self-Measuements_zonder_tekst.png |link=|links |85px|Zelfmetingen]]
[[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:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_VitalSigns|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Deze pagina beschrijft use cases voor de patiënt in relatie tot zelfmetingen van vitale functies die een patiënt kan verzamelen en delen door middel van een PGO. De vitale functies van de mens zijn de lichaamsfuncties die de persoon vitaal of ook wel in leven houden, voorbeelden zijn ademhaling en circulatie (hartslag en bloeddruk).

Momenteel bestaat er geen standaard voor zelfmeet gegevens van de vitale functies. Het doel van deze pagina is om verschillende uitwisseling scenario's van zelfmeet gegevens met de patiënt te beschrijven voor gebruik in MedMij.

Zoals [[MedMij:V2019.01_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij zorginformatiebouwstenen (ZIB's) als leidraad voor de inhoud van informatie uitwisseling. Voor uitwisseling van zelfmeet gegevens gaat het om de volgende ZIB's:

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Polsfrequentie

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

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

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

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

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

=Use Cases=
==Use case: Raadplegen metingen betreffende de vitale functies door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in de vitale functie meetwaarden die over henzelf gaan.
===Domein===
Metingen betreffende vitale functies in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de meetwaarden van vitale functies 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.

====Raadplegen meetwaarden ====
Informatie elementen in de vraag om meetwaarden van vitale functies.

* Patient identificatienummer
* Periode (startdatum - einddatum)
* Type (soort meetwaarden, bijvoorbeeld bloeddruk)

Dit betreft de filtermogelijkheden (query paramaters) in de vraag om meetwaarden van de vitale functies.

====Beschikbaarstellen meetwaarden meetwaarden====
Informatie elementen in meetwaarden van vitale functies staan hieronder. Het betreffen de Zorginformatiebouwstenen die te vinden zijn op https://zibs.nl/wiki/ZIB_Hoofdpagina.

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Polsfrequentie

=== 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 meetwaarden van vitale functies raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt meetwaarden van vitale functies beschikbaar
|}
'''Bedrijfsrollen Medicatieoverzicht'''

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

[[Bestand:Activity_Diagram_-_MVF_raadplegen.jpg|Activiteitendiagram Raadplegen Meetwaarden vitale functies]]

'''Activiteitendiagram Raadplegen meetwaarden vitale functies'''

===Procesbeschrijving===
===='Patient journey' - Thomas van Beek ====
Het verhaal van de 'patient journey' van Thomas van Beek vindt u [https://www.nictiz.nl/wp-content/uploads/2018/05/Casus_Thomas_van_Beek_MedMij.pdf hier]. Hieronder een voor Thomas relevante situatie waarbij het raadplegen van meetwaarden betreffende de vitale functie een rol speelt.

<blockquote>Voordat Thomas zijn consult bij de internist heeft om de resultaten door te spreken worden er een aantal andere waarden getest. Zijn gewicht en zijn bloeddruk worden opgemeten. De laboratoriumwaarden zijn al bekend voordat de internist ze aan Thomas mee kan delen. Alhoewel Thomas zoals gezegd zo min mogelijk met zijn ziekte bezig wil zijn, vindt hij de jaarlijkse controle heel belangrijk. Hij vindt het dan ook heel erg handig om de resultaten van de onderzoeken een dag van tevoren al in te zien in zijn PGO. Hij kan zich zo goed voorbereiden en zal niet meer verrast zijn over de resultaten als zijn internist deze voorlegt.</blockquote>

===='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 meetwaarden betreffende de vitale functie een rol speelt.

<blockquote>Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten</blockquote>

Roos kan na haar opname haar vitale waarden gemeten in ziekenhuis raadplegen. Zo beschikt zij over deze informatie die ze als referentiewaarden kan gebruiken.

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

De patiënt wil de meetwaarden van de vitale functies inzien en de zorgaanbieder stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de meetwaarden 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) stuurt meetwaarden van de vitale functies naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt meetwaarden van de vitale functies op voor de patiënt.
*De zorgverlener gebruikt zijn systeem om de meetwaarden van de vitale functies in te zien.

=====Post conditie=====
De patiënt heeft de meetwaarden vitale functies 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 medicatieoverzichten van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* MeetwaardenVitaleFunctiesRaadplegend Systeem in FHIR [MM-1.2.2-MVR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* MeetwaardenVitaleFunctiesBeschikbaarstellend Systeem in FHIR [MM-1.2.2-MVB-FHIR]

Zie ook onderstaande afbeelding.

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

'''Componenten diagram'''

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;"| '''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"|Meetwaarden Vitale Functies(PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen meetwaarden vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.2.2-MVR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_VitalSigns|Meetwaarden vitale functies in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen meetwaarden vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.2.2-MVB-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_-_MVF_raadplegen.jpg|Use case diagram raadplegen meetwaarden vitale functies]]

'''Use case diagram

==Use case: Sturen zelfmetingen van de vitale functies door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door het kunnen delen van hun zelfmeet gegevens met de zorgverlener.
===Domein===
Zelfmetingen betreffende vitale functies in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van de zelfmeetwaarden van vitale functies 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
====Sturen zelfmetingen====
Informatie elementen in zelfmetingen betreffende vitale functies staan hieronder. Het betreffen Zorginformatiebouwstenen die te vinden zijn op https://zibs.nl/wiki/ZIB_Hoofdpagina.

*Patiënt
*Ademhaling
*Bloeddruk
*Hartfrequentie
*Lichaamsgewicht
*Lichaamslengte
*Lichaamstemperatuur
*O2Saturatie
*Polsfrequentie

====Ontvangen zelfmetingen====
Het ontvangende systeem stuurt een ontvangstbevestiging van de zelfmetingen.

=== 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 zelfmetingen van vitale functies sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Ontvangt zelfmetingen van vitale functies
|}
'''Bedrijfsrollen Medicatieoverzicht'''

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

[[Bestand:Activity_Diagram_-_MVF_sturen.jpg|Activiteitendiagram Raadplegen Meetwaarden vitale functies]]

'''Activiteitendiagram sturen zelfmetingen vitale functies'''

===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 sturen van zelfmetingen betreffende de vitale functie een rol speelt.

<blockquote>Sinds een aantal maanden maakt Roos gebruik van een online persoonlijke gezondheidsomgeving. Daarin houdt ze onder andere haar bloedglucosewaarden bij. Daarnaast moet ze zich dagelijks wegen in verband met haar hartfalen. Bij hartfalen is de pompfunctie van het hart verminderd. Het hart pompt niet genoeg bloed rond, hierdoor kun je vocht vasthouden. Om dit te monitoren weegt Roos zich dagelijks, en houdt ze haar gewicht bij in haar persoonlijke gezondheidsomgeving. Wanneer haar gewicht toeneemt, dan krijgt ze een signaal vanuit haar PGO, omdat dit zou kunnen duiden op het vasthouden van vocht. Doordat Roos de huisarts toestemming heeft gegeven om haar gegevens te delen kan informatie worden uitgewisseld. Als er bijvoorbeeld iets in de medicatie wordt gewijzigd, dan ziet Roos dit in haar persoonlijke gezondheidsomgeving terug. De huisarts kan op zijn beurt de gegevens die Roos heeft ingevoerd bekijken, bijvoorbeeld met een handige grafiek die haar bloedsuikers over de afgelopen periode laat zien</blockquote>

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

De zorgaanbieder wil de zelfmetingen van de vitale functies inzien en de patiënt stelt dit ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om de meetwaarden te sturen, 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) stuurt zelfmetingen van de vitale functies naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt en verwerkt de zelfmetingen van de patiënt.
*De zorgaanbieder gebruikt de het XIS om de zelfmetingen van de vitale functies in te zien.

=====Post conditie=====
De patiënt heeft zelfmetingen gestuurd 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 medicatieoverzichten van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* ZelfmetingenVitaleFunctiesSturend Systeem in FHIR [MM-1.2.2-ZVS-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* ZelfmetingenVitaleFunctiesOntvangend Systeem in FHIR [MM-1.2.2-ZVO-FHIR]

Zie ook onderstaande afbeelding.

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

'''Componenten diagram'''

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;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
|-
|style="background-color: white;vertical-align:top;" rowspan="2"|Zelfmetingen Vitale Functies(PUSH)
|style="background-color: white;vertical-align:top;"|Sturen zelfmetingen van vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.2.2-ZVS-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 zelfmetingen vitale functies
|style="background-color: white;vertical-align:top;"|MM-1.2.2-ZVO-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_-_MVF_sturen.jpg|Use case diagram sturen zelfmetingen vitale functies]]

'''Use case diagram

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

=Bijlage: Documenthistorie=
==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:1500px; text-align:left;"|Omschrijving
|-
| rowspan = 6; style="background-color: white;"| 2019.01
| style="background-color: white;"| 1.2.1
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-185 MM-185]
| style="background-color: white;"| Verkeerde fixed value voor Observation.code.coding:postBreakfastGlucoseNhgtable45.code
|-
| rowspan = 5; style="background-color: white;"| 1.2.0
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-175 MM-175]
| style="background-color: white;"| Mapping concept Positie van Zib Lichaamslengte niet duidelijk.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-314 MM-314]
| style="background-color: white;"| Zelfmeting pijnscore FHIR.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-147 MM-147]
| style="background-color: white;"| Mappen PulseRegularity binnen PulseRate.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-141 MM-141]
| style="background-color: white;"| Vital Signs profielen inconsistent m.b.t. baseDefinition.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-95 MM-95]
| style="background-color: white;"| Added support for the lastn operation for retrieving the latest available measurement.
|-
| rowspan = 4; style="background-color: white;"| 2018.06
| rowspan = 4; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-87 MM-87]
| style="background-color: white;"| The links in the table for FHIR profiles have been updated. The BloodGlucose profile in the Retrieve Vital Signs use case and all profiles under the Send Vital Signs use case linked to a deprecated version.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-80 MM-80]
| style="background-color: white;"| The profile mapping for HCIM element NL-CM:12.6.2 TemperatuurType has been updated Observation.method from Observation.bodySite based on feedback received from the ZIB Centrum that even though the definition appears to point to a body site, that the focus of TemperatureType is a method that includes body site. The profile version was updated to 2.0.1
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-64 MM-64]
| style="background-color: white;"| Koppelen van meetinstrument aan relevante profielen.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 28-03-2019
| style="background-color: white;"|
* Plaatsen release notes behorende bij patch 1.
* Versienummer systeemrolcodes ophogen met 1 patch nummer.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
* Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
* Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"| Pijnscore verwijderd uit lijst van toegepaste Zibs voor deze use case. Voor Pijnscore is nog geen FHIR documentatie beschikbaar.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 10-01-2019
| style="background-color: white;"|
* Aanpassing versienummer naar 1.1.0.
* Wijzigingen doorgevoerd betreffende BITS issue MM-80 en MM-87.
* Kwalificatieparagraaf aangevuld.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpZelfmetingen

2019-05-21T14:37:59Z

Mischa Tol:

MedMij:Register van informatiestandaarden

2019-05-10T09:35:31Z

Mischa Tol:

=Inleiding=
==Algemeen==
Het Register van Informatiestandaarden bevat de binnen het MedMij-afsprakenstelsel toegelaten informatiestandaarden.
Om in het Register te kunnen komen moet een informatiestandaard voldoen aan een set van eisen.
Nadere informatie over deze eisen en het proces van toetreding, vindt u op: https://www.medmij.nl/dien-een-standaard-in/

De informatiestandaard kent altijd een formele beschrijving met ten minste de volgende metagegevens:
De informatiestandaard (met een informatiestandaardnaam) bestaat uit een of meer transacties (met per transactie een transactienaam), met voor elk van de transacties een aanduiding van de bijbehorende systeemrollen en de bijbehorende bedrijfsrol (Patiëntbedrijfsrol of Zorgaanbiedersbedrijfsrol).
Op basis van de systeemrol wordt door de MedMij autorisatieraad, het bestuur van Stichting MedMij, een systeemrolcode toegekend. Deze identificeert 1 versie van 1 systeemrol. Een versie van een systeemrol wordt geïdentificeerd door 1 Systeemrol-code.
Deze metagegevens zijn van belang voor de definitie van de gegevensdiensten binnen het MedMij afsprakenstelsel. Nadere informatie over gegevensdiensten, zoals de geldigheidsperiode, vindt u in de Catalogus van het MedMij Afsprakenstelsel: https://afsprakenstelsel.medmij.nl/display/PUBLIC/Catalogus

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

=Register van Informatiestandaarden=
==Actueel overzicht==
In het onderstaande overzicht staan de actuele versies van alle in MedMij toegelaten informatiestandaarden met een aantal essentiële metagegevens. Onder actuele versies wordt verstaan dat de geldigheidsperiode, zoals bepaald in de Catalogus van het MedMij Afsprakenstelsel, nog loopt. Er kunnen dientengevolge meerdere versies van een informatiestandaard actueel zijn.

Extra toelichting bij het overzicht:

*De iconen in het overzicht verwijzen naar de actuele specificaties met kwalificatie-informatie van de patiënt use case van de informatiestandaard.

*De systeemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie (exclusief patchnummer) - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt. De actuele specificaties -waarnaar via de iconen wordt verwezen- zijn inclusief eventueel doorgevoerde patches, en het daarbij behorende patchnummer.

*De kolom 'MedMij-release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is getoetst en vervolgens is opgenomen.

*De kolom 'MMVN' geeft een indicatie van de volwassenheid van de standaarden, conform verschillende MedMij VolwassenheidsNiveaus (MMVN) die binnen het afsprakenstelsel worden onderscheiden. Standaarden krijgen een MedMij niveau als ze ook daadwerkelijk toegepast kunnen worden binnen MedMij Afsprakenstelsel. Voor informatiestandaarden met een innovatief karakter en een relatief laag volwassenheidsniveau kunnen meer updates noodzakelijk blijken dan bij een standaard met een hoog volwassenheidsniveau. Nadere toelichting ten aanzien van MedMij VolwassenheidNiveaus vindt u in [http://www.medmij.nl/wp-content/uploads/2017/11/Co%C3%B6rdinatie-standaarden-MedMij-Governance.pdf het document Coördinatie standaarden MedMij – Governance].

Nadere informatie over systeemrollen vindt u op [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen MedMij Ontwerpen]

{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Bedrijfsrol
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MedMij-release
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Publicatiedatum
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpBGZ_2017|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
(patiënt use case)
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| Patiënt
| PGO
| MM-2.1-BZR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen BgZ
| Zorgaanbieder
| XIS
| MM-2.1-BZB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="6" | [[Bestand:Medicatie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpMedicatie|Medicatieproces|50px]]
| rowspan="6" | Medicatieproces
(patiënt use case)
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| Patiënt
| PGO
| MP-9.0.7-MOR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen medicatieoverzicht
| Zorgaanbieder
| XIS
| MP-9.0.7-MOB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| Patiënt
| PGO
| MP-9.0.7-MGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen medicatiegegevens
| Zorgaanbieder
| XIS
| MP-9.0.7-MGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | Verstrekkingenvertaling (PULL)
| Raadplegen verstrekkingenvertaling
| Patiënt
| PGO
| MP-9.A.1-MGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaarstellen verstrekkingenvertaling
| Zorgaanbieder
| XIS
| MP-9.A.1-MGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpLabresult|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
(patiënt use case)
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| Patiënt
| PGO
| LAB-1.1-LRR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen laboratoriumresultaten
| Zorgaanbieder
| XIS
| LAB-1.1-LRB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpZelfmetingen|Zelfmetingen|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| Patiënt
| PGO
| MM-1.2-MVR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaarstellen meetwaarden vitale functies
| Zorgaanbieder
| XIS
| MM-1.2-MVB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| Patiënt
| PGO
| MM-1.2-ZVS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen zelfmetingen vitale functies
| Zorgaanbieder
| XIS
| MM-1.2-ZVO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpPDFA|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| Patiënt
| PGO
| MM-1.2-PLR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen PDF/A metadata lijst
| Zorgaanbieder
| XIS
| MM-1.2-PLB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| Patiënt
| PGO
| MM-1.2-PDR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen PDF/A
| Zorgaanbieder
| XIS
| MM-1.2-PDB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| Patiënt
| PGO
| MM-1.2-PDS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen PDF/A
| Zorgaanbieder
| XIS
| MM-1.2-PDO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpAllergieIntolerantie| AllergieIntolerantie|50px]]
| rowspan="2" | AllergieIntolerantie
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| Patiënt
| PGO
| MM-1.1-AIR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| Zorgaanbieder
| XIS
| MM-1.1-AIB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2019.01_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| Patiënt
| PGO
| EA-1.1-AFR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen afspraak
| Zorgaanbieder
| XIS
| EA-1.1-AFB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| Patiënt
| PGO
| EA-1.1-ASR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen afspraak slots
| Zorgaanbieder
| XIS
| EA-1.1-ASB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| Patiënt
| PGO
| EA-1.1-ATR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen afspraak typen
| Zorgaanbieder
| XIS
| EA-1.1-ATB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| Patiënt
| PGO
| EA-1.1-AVS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen afspraakverzoek
| Zorgaanbieder
| XIS
| EA-1.1-AVO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| Patiënt
| PGO
| EA-1.1-AAS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen afspraak annulering
| Zorgaanbieder
| XIS
| EA-1.1-AAO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| Patiënt
| PGO
| EA-1.1-AWS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen afspraak wijzigingsverzoek
| Zorgaanbieder
| XIS
| EA-1.1-AWO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2019.01_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
(patiënt use case)
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| Patiënt
| PGO
| MM-1.1-HGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen Huisartsgegevens
| Zorgaanbieder
| XIS
| MM-1.1-HGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:MedMij-GGZ-63.png |link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpGGZ|50px|Use case GGZ|GGZ]]
| rowspan="2" | Basisgegevens GGZ
| rowspan="2" | GGZ (PULL)
| Raadplegen GGZ
| Patiënt
| PGO
| MM-1.1-GGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaarstellen GGZ
| Zorgaanbieder
| XIS
| MM-1.1-GGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpBGZ_2017|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
(patiënt use case)
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| Patiënt
| PGO
| MM-2.0-BZR-FHIR
| R1.0
| 3
| 15-05-18
|-
| Beschikbaar stellen BgZ
| Zorgaanbieder
| XIS
| MM-2.0-BZB-FHIR
| R1.0
| 3
| 15-05-18
|-
| rowspan="6" | [[Bestand:Medicatie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpMedicatie|Medicatieproces|50px]]
| rowspan="6" | Medicatieproces
(patiënt use case)
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| Patiënt
| PGO
| MP-9.0-MOR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen medicatieoverzicht
| Zorgaanbieder
| XIS
| MP-9.0-MOB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| Patiënt
| PGO
| MP-9.0-MGR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen medicatiegegevens
| Zorgaanbieder
| XIS
| MP-9.0-MGB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | Verstrekkingenvertaling (PULL)
| Raadplegen verstrekkingenvertaling
| Patiënt
| PGO
| MP-9.A-MGR-FHIR
| R1.1
| 3
| 01-02-19
|-
| Beschikbaarstellen verstrekkingenvertaling
| Zorgaanbieder
| XIS
| MP-9.A-MGB-FHIR
| R1.1
| 3
| 01-02-19
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpLabresult|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
(patiënt use case)
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| Patiënt
| PGO
| LAB-1.0-LRR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen laboratoriumresultaten
| Zorgaanbieder
| XIS
| LAB-1.0-LRB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpZelfmetingen|Zelfmetingen|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| Patiënt
| PGO
| MM-1.1-MVR-FHIR
| R1.1
| 3
| 01-01-19
|-
| Beschikbaarstellen meetwaarden vitale functies
| Zorgaanbieder
| XIS
| MM-1.1-MVB-FHIR
| R1.1
| 3
| 01-01-19
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| Patiënt
| PGO
| MM-1.1-ZVS-FHIR
| R1.1
| 3
| 01-01-19
|-
| Ontvangen zelfmetingen vitale functies
| Zorgaanbieder
| XIS
| MM-1.1-ZVO-FHIR
| R1.1
| 3
| 01-02-19
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpPDFA|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| Patiënt
| PGO
| MM-1.1-PLR-FHIR
| R1.0
| 3
| 01-11-18
|-
| Beschikbaar stellen PDF/A metadata lijst
| Zorgaanbieder
| XIS
| MM-1.1-PLB-FHIR
| R1.0
| 3
| 01-11-18
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| Patiënt
| PGO
| MM-1.1-PDR-FHIR
| R1.0
| 3
| 01-11-18
|-
| Beschikbaar stellen PDF/A
| Zorgaanbieder
| XIS
| MM-1.1-PDB-FHIR
| R1.0
| 3
| 01-11-18
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| Patiënt
| PGO
| MM-1.1-PDS-FHIR
| R1.1
| 3
| 01-11-18
|-
| Ontvangen PDF/A
| Zorgaanbieder
| XIS
| MM-1.1-PDO-FHIR
| R1.1
| 3
| 01-11-18
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpAllergieIntolerantie| AllergieIntolerantie|50px]]
| rowspan="2" | AllergieIntolerantie
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| Patiënt
| PGO
| MM-1.0-AIR-FHIR
| R1.1
| 3
| 01-01-19
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| Zorgaanbieder
| XIS
| MM-1.0-AIB-FHIR
| R1.1
| 3
| 01-01-19
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.06_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| Patiënt
| PGO
| EA-1.0-AFR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen afspraak
| Zorgaanbieder
| XIS
| EA-1.0-AFB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| Patiënt
| PGO
| EA-1.0-ASR-FHIR
| R1.1
| 3
| 01-06-18
|-
| Beschikbaar stellen afspraak slots
| Zorgaanbieder
| XIS
| EA-1.0-ASB-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| Patiënt
| PGO
| EA-1.0-ATR-FHIR
| R1.1
| 3
| 01-06-18
|-
| Beschikbaar stellen afspraak typen
| Zorgaanbieder
| XIS
| EA-1.0-ATB-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| Patiënt
| PGO
| EA-1.0-AVS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen afspraakverzoek
| Zorgaanbieder
| XIS
| EA-1.0-AVO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| Patiënt
| PGO
| EA-1.0-AAS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen afspraak annulering
| Zorgaanbieder
| XIS
| EA-1.0-AAO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| Patiënt
| PGO
| EA-1.0-AWS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen afspraak wijzigingsverzoek
| Zorgaanbieder
| XIS
| EA-1.0-AWO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2018.06_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
(patiënt use case)
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| Patiënt
| PGO
| MM-1.0-HGR-FHIR
| R1.1
| 3
| 01-06-18
|-
| Beschikbaar stellen Huisartsgegevens
| Zorgaanbieder
| XIS
| MM-1.0-HGB-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | [[Bestand:MedMij-GGZ-63.png |link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpGGZ|50px|Use case GGZ|GGZ]]
| rowspan="2" | Basisgegevens GGZ
| rowspan="2" | GGZ (PULL)
| Raadplegen GGZ
| Patiënt
| PGO
| MM-1.0-GGR-FHIR
| R1.1
| 3
| 01-11-18
|-
| Beschikbaarstellen GGZ
| Zorgaanbieder
| XIS
| MM-1.0-GGB-FHIR
| R1.1
| 3
| 01-11-18
|}

==Historische versies informatiestandaarden en systeemrolcodes==
In onderstaande overzicht worden de historische versies van informatiestandaarden en onderliggende systeemrollen getoond. Er ontstaat een historische versie als de geldigheidsperiode, zoals is bepaald in de Catalogus van het MedMij Afsprakenstelsel, is verlopen.
{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Bedrijfsrol
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MedMij
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Publicatiedatum
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpZelfmetingen|Zelfmetingen|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| Patiënt
| PGO
| MM-1.0.0-MVR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen meetwaarden vitale functies
| Zorgaanbieder
| XIS
| MM-1.0.0-MVB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| Patiënt
| PGO
| MM-1.0.0-ZVS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen zelfmetingen vitale functies
| Zorgaanbieder
| XIS
| MM-1.0.0-ZVO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.05_OntwerpAllergieIntolerantie| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
(patiënt use case)
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| Patiënt
| PGO
| MP-6.12.6-AIR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| Zorgaanbieder
| XIS
| MP-6.12.6-AIB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.05_OntwerpPDFA|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| Patiënt
| PGO
| MM-1.0.0-PLR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen PDF/A metadata lijst
| Zorgaanbieder
| XIS
| MM-1.0.0-PLB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| Patiënt
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen PDF/A
| Zorgaanbieder
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| Patiënt
| PGO
| MM-1.0.0-PDS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen PDF/A
| Zorgaanbieder
| XIS
| MM-1.0.0-PDO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" |
| rowspan="2" |
| rowspan="2" |
|
|
|
|
|
|
|
|-
|
|
|
|
|
|
|
|-
|}
=Bijlage: Documenthistorie=

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
* Nieuwe versies informatiestandaarden van de MedMij voorjaarsrelease 2019 opgenomen:
** Basisgegevensset Zorg 2.1 toegevoegd
** Medicatieproces 9.0.7 toegevoegd.
** Labuitwisseling 1.1 toegevoegd.
** Zelfmetingen 1.2 toegevoegd.
** PDF/A 1.2 toegevoegd.
** AllergieIntolerantie 1.0 toegevoegd.
** eAfspraak 1.1 toegevoegd.
** Huisartsgegevens 1.1 toegevoegd.
** Basisgegevens GGZ 1.1 toegevoegd.
* Patchnummer in versienummering bij Medicatieproces weer toegevoegd, kolom systeemrolcode
|-
| style="background-color: white;"| 08-01-2019
| style="background-color: white;"|
* AllergieIntolerantie 1.0 toegevoegd.
* Medicatieveiligheid 6.12.6 als historische versie verwerkt.
* Zelfmetingen 1.1 toegevoegd.
* Zelfmetingen 1.0.0 als historische versie verwerkt.
* Medicatieproces, variant transactiegroep Medicatiegegevens toegevoegd.
* Patchnummer in versienummering verwijderd, kolom systeemrolcode
|-
| style="background-color: white;"| 29-10-2018
| style="background-color: white;"|
* Basisgegevens GGZ toegevoegd.
* PDF/A versie 1.1.0 toegevoegd.
* PDF/A versie 1.0.0 als historische versie verwerkt.
|-
| style="background-color: white;"| 16-10-2018
| style="background-color: white;"|
* Documenthistorie toegevoegd.
* Correctie Volwassenheidsniveau eAfspraak en Huisartsgegevens.
|-

|}

MedMij:Register van informatiestandaarden

2019-05-10T09:22:21Z

Mischa Tol: /* Actueel overzicht */ aanpassing link labresultaten

=Inleiding=
==Algemeen==
Het Register van Informatiestandaarden bevat de binnen het MedMij-afsprakenstelsel toegelaten informatiestandaarden.
Om in het Register te kunnen komen moet een informatiestandaard voldoen aan een set van eisen.
Nadere informatie over deze eisen en het proces van toetreding, vindt u op: https://www.medmij.nl/dien-een-standaard-in/

De informatiestandaard kent altijd een formele beschrijving met ten minste de volgende metagegevens:
De informatiestandaard (met een informatiestandaardnaam) bestaat uit een of meer transacties (met per transactie een transactienaam), met voor elk van de transacties een aanduiding van de bijbehorende systeemrollen en de bijbehorende bedrijfsrol (Patiëntbedrijfsrol of Zorgaanbiedersbedrijfsrol).
Op basis van de systeemrol wordt door de MedMij autorisatieraad, het bestuur van Stichting MedMij, een systeemrolcode toegekend. Deze identificeert 1 versie van 1 systeemrol. Een versie van een systeemrol wordt geïdentificeerd door 1 Systeemrol-code.
Deze metagegevens zijn van belang voor de definitie van de gegevensdiensten binnen het MedMij afsprakenstelsel. Nadere informatie over gegevensdiensten, zoals de geldigheidsperiode, vindt u in de Catalogus van het MedMij Afsprakenstelsel: https://afsprakenstelsel.medmij.nl/display/PUBLIC/Catalogus

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

=Register van Informatiestandaarden=
==Actueel overzicht==
In het onderstaande overzicht staan de actuele versies van alle in MedMij toegelaten informatiestandaarden met een aantal essentiële metagegevens. Onder actuele versies wordt verstaan dat de geldigheidsperiode, zoals bepaald in de Catalogus van het MedMij Afsprakenstelsel, nog loopt. Er kunnen dientengevolge meerdere versies van een informatiestandaard actueel zijn.

Extra toelichting bij het overzicht:

*De iconen in het overzicht verwijzen naar de actuele specificaties met kwalificatie-informatie van de patiënt use case van de informatiestandaard.

*De systeemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie (exclusief patchnummer) - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt. De actuele specificaties -waarnaar via de iconen wordt verwezen- zijn inclusief eventueel doorgevoerde patches, en het daarbij behorende patchnummer.

*De kolom 'MedMij-release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is getoetst en vervolgens is opgenomen.

*De kolom 'MMVN' geeft een indicatie van de volwassenheid van de standaarden, conform verschillende MedMij VolwassenheidsNiveaus (MMVN) die binnen het afsprakenstelsel worden onderscheiden. Standaarden krijgen een MedMij niveau als ze ook daadwerkelijk toegepast kunnen worden binnen MedMij Afsprakenstelsel. Voor informatiestandaarden met een innovatief karakter en een relatief laag volwassenheidsniveau kunnen meer updates noodzakelijk blijken dan bij een standaard met een hoog volwassenheidsniveau. Nadere toelichting ten aanzien van MedMij VolwassenheidNiveaus vindt u in [http://www.medmij.nl/wp-content/uploads/2017/11/Co%C3%B6rdinatie-standaarden-MedMij-Governance.pdf het document Coördinatie standaarden MedMij – Governance].

Nadere informatie over systeemrollen vindt u op [https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen MedMij Ontwerpen]

{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Bedrijfsrol
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MedMij-release
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Publicatiedatum
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpBGZ_2017|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
(patiënt use case)
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| Patiënt
| PGO
| MM-2.1-BZR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen BgZ
| Zorgaanbieder
| XIS
| MM-2.1-BZB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="6" | [[Bestand:Medicatie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpMedicatie|Medicatieproces|50px]]
| rowspan="6" | Medicatieproces
(patiënt use case)
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| Patiënt
| PGO
| MP-9.0.7-MOR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen medicatieoverzicht
| Zorgaanbieder
| XIS
| MP-9.0.7-MOB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| Patiënt
| PGO
| MP-9.0.7-MGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen medicatiegegevens
| Zorgaanbieder
| XIS
| MP-9.0.7-MGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | Verstrekkingenvertaling (PULL)
| Raadplegen verstrekkingenvertaling
| Patiënt
| PGO
| MP-9.A.1-MGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaarstellen verstrekkingenvertaling
| Zorgaanbieder
| XIS
| MP-9.A.1-MGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpLabresult|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
(patiënt use case)
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| Patiënt
| PGO
| LAB-1.1-LRR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen laboratoriumresultaten
| Zorgaanbieder
| XIS
| LAB-1.1-LRB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpZelfmetingen|Zelfmetingen|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| Patiënt
| PGO
| MM-1.2-MVR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaarstellen meetwaarden vitale functies
| Zorgaanbieder
| XIS
| MM-1.2-MVB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| Patiënt
| PGO
| MM-1.2-ZVS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen zelfmetingen vitale functies
| Zorgaanbieder
| XIS
| MM-1.2-ZVO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpPDFA|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| Patiënt
| PGO
| MM-1.2-PLR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen PDF/A metadata lijst
| Zorgaanbieder
| XIS
| MM-1.2-PLB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| Patiënt
| PGO
| MM-1.2-PDR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen PDF/A
| Zorgaanbieder
| XIS
| MM-1.2-PDB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| Patiënt
| PGO
| MM-1.2-PDS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen PDF/A
| Zorgaanbieder
| XIS
| MM-1.2-PDO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpAllergieIntolerantie| AllergieIntolerantie|50px]]
| rowspan="2" | AllergieIntolerantie
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| Patiënt
| PGO
| MM-1.1-AIR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| Zorgaanbieder
| XIS
| MM-1.1-AIB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2019.01_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| Patiënt
| PGO
| EA-1.1-AFR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen afspraak
| Zorgaanbieder
| XIS
| EA-1.1-AFB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| Patiënt
| PGO
| EA-1.1-ASR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen afspraak slots
| Zorgaanbieder
| XIS
| EA-1.1-ASB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| Patiënt
| PGO
| EA-1.1-ATR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen afspraak typen
| Zorgaanbieder
| XIS
| EA-1.1-ATB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| Patiënt
| PGO
| EA-1.1-AVS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen afspraakverzoek
| Zorgaanbieder
| XIS
| EA-1.1-AVO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| Patiënt
| PGO
| EA-1.1-AAS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen afspraak annulering
| Zorgaanbieder
| XIS
| EA-1.1-AAO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| Patiënt
| PGO
| EA-1.1-AWS-FHIR
| R1.1
| 3
| 11-03-19
|-
| Ontvangen afspraak wijzigingsverzoek
| Zorgaanbieder
| XIS
| EA-1.1-AWO-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2019.01_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
(patiënt use case)
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| Patiënt
| PGO
| MM-1.1-HGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaar stellen Huisartsgegevens
| Zorgaanbieder
| XIS
| MM-1.1-HGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:MedMij-GGZ-63.png |link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpGGZ|50px|Use case GGZ|GGZ]]
| rowspan="2" | Basisgegevens GGZ
| rowspan="2" | GGZ (PULL)
| Raadplegen GGZ
| Patiënt
| PGO
| MM-1.1-GGR-FHIR
| R1.1
| 3
| 11-03-19
|-
| Beschikbaarstellen GGZ
| Zorgaanbieder
| XIS
| MM-1.1-GGB-FHIR
| R1.1
| 3
| 11-03-19
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpBGZ_2017|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
(patiënt use case)
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| Patiënt
| PGO
| MM-2.0-BZR-FHIR
| R1.0
| 3
| 15-05-18
|-
| Beschikbaar stellen BgZ
| Zorgaanbieder
| XIS
| MM-2.0-BZB-FHIR
| R1.0
| 3
| 15-05-18
|-
| rowspan="6" | [[Bestand:Medicatie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpMedicatie|Medicatieproces|50px]]
| rowspan="6" | Medicatieproces
(patiënt use case)
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| Patiënt
| PGO
| MP-9.0-MOR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen medicatieoverzicht
| Zorgaanbieder
| XIS
| MP-9.0-MOB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| Patiënt
| PGO
| MP-9.0-MGR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen medicatiegegevens
| Zorgaanbieder
| XIS
| MP-9.0-MGB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | Verstrekkingenvertaling (PULL)
| Raadplegen verstrekkingenvertaling
| Patiënt
| PGO
| MP-9.A-MGR-FHIR
| R1.1
| 3
| 01-02-19
|-
| Beschikbaarstellen verstrekkingenvertaling
| Zorgaanbieder
| XIS
| MP-9.A-MGB-FHIR
| R1.1
| 3
| 01-02-19
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpHuisartsgegevens|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
(patiënt use case)
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| Patiënt
| PGO
| LAB-1.0-LRR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen laboratoriumresultaten
| Zorgaanbieder
| XIS
| LAB-1.0-LRB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpZelfmetingen|Zelfmetingen|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| Patiënt
| PGO
| MM-1.1-MVR-FHIR
| R1.1
| 3
| 01-01-19
|-
| Beschikbaarstellen meetwaarden vitale functies
| Zorgaanbieder
| XIS
| MM-1.1-MVB-FHIR
| R1.1
| 3
| 01-01-19
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| Patiënt
| PGO
| MM-1.1-ZVS-FHIR
| R1.1
| 3
| 01-01-19
|-
| Ontvangen zelfmetingen vitale functies
| Zorgaanbieder
| XIS
| MM-1.1-ZVO-FHIR
| R1.1
| 3
| 01-02-19
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpPDFA|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| Patiënt
| PGO
| MM-1.1-PLR-FHIR
| R1.0
| 3
| 01-11-18
|-
| Beschikbaar stellen PDF/A metadata lijst
| Zorgaanbieder
| XIS
| MM-1.1-PLB-FHIR
| R1.0
| 3
| 01-11-18
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| Patiënt
| PGO
| MM-1.1-PDR-FHIR
| R1.0
| 3
| 01-11-18
|-
| Beschikbaar stellen PDF/A
| Zorgaanbieder
| XIS
| MM-1.1-PDB-FHIR
| R1.0
| 3
| 01-11-18
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| Patiënt
| PGO
| MM-1.1-PDS-FHIR
| R1.1
| 3
| 01-11-18
|-
| Ontvangen PDF/A
| Zorgaanbieder
| XIS
| MM-1.1-PDO-FHIR
| R1.1
| 3
| 01-11-18
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpAllergieIntolerantie| AllergieIntolerantie|50px]]
| rowspan="2" | AllergieIntolerantie
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| Patiënt
| PGO
| MM-1.0-AIR-FHIR
| R1.1
| 3
| 01-01-19
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| Zorgaanbieder
| XIS
| MM-1.0-AIB-FHIR
| R1.1
| 3
| 01-01-19
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2018.06_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| Patiënt
| PGO
| EA-1.0-AFR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen afspraak
| Zorgaanbieder
| XIS
| EA-1.0-AFB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| Patiënt
| PGO
| EA-1.0-ASR-FHIR
| R1.1
| 3
| 01-06-18
|-
| Beschikbaar stellen afspraak slots
| Zorgaanbieder
| XIS
| EA-1.0-ASB-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| Patiënt
| PGO
| EA-1.0-ATR-FHIR
| R1.1
| 3
| 01-06-18
|-
| Beschikbaar stellen afspraak typen
| Zorgaanbieder
| XIS
| EA-1.0-ATB-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| Patiënt
| PGO
| EA-1.0-AVS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen afspraakverzoek
| Zorgaanbieder
| XIS
| EA-1.0-AVO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| Patiënt
| PGO
| EA-1.0-AAS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen afspraak annulering
| Zorgaanbieder
| XIS
| EA-1.0-AAO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| Patiënt
| PGO
| EA-1.0-AWS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen afspraak wijzigingsverzoek
| Zorgaanbieder
| XIS
| EA-1.0-AWO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | [[Bestand:Huisartsgegevens.png|link=MedMij:V2018.06_OntwerpHuisartsgegevens|Huisartsgegevens|50px]]
| rowspan="2" | Huisartsgegevens
(patiënt use case)
| rowspan="2" | Huisartsgegevens (PULL)
| Raadplegen Huisartsgegevens
| Patiënt
| PGO
| MM-1.0-HGR-FHIR
| R1.1
| 3
| 01-06-18
|-
| Beschikbaar stellen Huisartsgegevens
| Zorgaanbieder
| XIS
| MM-1.0-HGB-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | [[Bestand:MedMij-GGZ-63.png |link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpGGZ|50px|Use case GGZ|GGZ]]
| rowspan="2" | Basisgegevens GGZ
| rowspan="2" | GGZ (PULL)
| Raadplegen GGZ
| Patiënt
| PGO
| MM-1.0-GGR-FHIR
| R1.1
| 3
| 01-11-18
|-
| Beschikbaarstellen GGZ
| Zorgaanbieder
| XIS
| MM-1.0-GGB-FHIR
| R1.1
| 3
| 01-11-18
|}

==Historische versies informatiestandaarden en systeemrolcodes==
In onderstaande overzicht worden de historische versies van informatiestandaarden en onderliggende systeemrollen getoond. Er ontstaat een historische versie als de geldigheidsperiode, zoals is bepaald in de Catalogus van het MedMij Afsprakenstelsel, is verlopen.
{| class="wikitable"
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" colspan=2 |Informatiestandaard
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactiegroep
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Transactie
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Bedrijfsrol
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systeem
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Systemrolcode
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MedMij
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |MMVN
!style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;" |Publicatiedatum
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.06_OntwerpZelfmetingen|Zelfmetingen|50px]]
| rowspan="4" | Zelfmetingen
| rowspan="2" | Meetwaarden vitale functies (PULL)
| Raadplegen meetwaarden vitale functies
| Patiënt
| PGO
| MM-1.0.0-MVR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen meetwaarden vitale functies
| Zorgaanbieder
| XIS
| MM-1.0.0-MVB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | Zelfmetingen vitale functies (PUSH)
| Sturen zelfmetingen van vitale functies
| Patiënt
| PGO
| MM-1.0.0-ZVS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen zelfmetingen vitale functies
| Zorgaanbieder
| XIS
| MM-1.0.0-ZVO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.05_OntwerpAllergieIntolerantie| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
(patiënt use case)
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| Patiënt
| PGO
| MP-6.12.6-AIR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen AllergieIntolerantie gegevens
| Zorgaanbieder
| XIS
| MP-6.12.6-AIB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|link=https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2018.05_OntwerpPDFA|PDF/A|50px]]
| rowspan="6" | PDF/A
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| Patiënt
| PGO
| MM-1.0.0-PLR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen PDF/A metadata lijst
| Zorgaanbieder
| XIS
| MM-1.0.0-PLB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| Patiënt
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
| 3
| 01-06-18
|-
| Beschikbaar stellen PDF/A
| Zorgaanbieder
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
| 3
| 01-06-18
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| Patiënt
| PGO
| MM-1.0.0-PDS-FHIR
| R1.1
| 3
| 01-06-18
|-
| Ontvangen PDF/A
| Zorgaanbieder
| XIS
| MM-1.0.0-PDO-FHIR
| R1.1
| 3
| 01-06-18
|-
| rowspan="2" |
| rowspan="2" |
| rowspan="2" |
|
|
|
|
|
|
|
|-
|
|
|
|
|
|
|
|-
|}
=Bijlage: Documenthistorie=

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
* Nieuwe versies informatiestandaarden van de MedMij voorjaarsrelease 2019 opgenomen:
** Basisgegevensset Zorg 2.1 toegevoegd
** Medicatieproces 9.0.7 toegevoegd.
** Labuitwisseling 1.1 toegevoegd.
** Zelfmetingen 1.2 toegevoegd.
** PDF/A 1.2 toegevoegd.
** AllergieIntolerantie 1.0 toegevoegd.
** eAfspraak 1.1 toegevoegd.
** Huisartsgegevens 1.1 toegevoegd.
** Basisgegevens GGZ 1.1 toegevoegd.
* Patchnummer in versienummering bij Medicatieproces weer toegevoegd, kolom systeemrolcode
|-
| style="background-color: white;"| 08-01-2019
| style="background-color: white;"|
* AllergieIntolerantie 1.0 toegevoegd.
* Medicatieveiligheid 6.12.6 als historische versie verwerkt.
* Zelfmetingen 1.1 toegevoegd.
* Zelfmetingen 1.0.0 als historische versie verwerkt.
* Medicatieproces, variant transactiegroep Medicatiegegevens toegevoegd.
* Patchnummer in versienummering verwijderd, kolom systeemrolcode
|-
| style="background-color: white;"| 29-10-2018
| style="background-color: white;"|
* Basisgegevens GGZ toegevoegd.
* PDF/A versie 1.1.0 toegevoegd.
* PDF/A versie 1.0.0 als historische versie verwerkt.
|-
| style="background-color: white;"| 16-10-2018
| style="background-color: white;"|
* Documenthistorie toegevoegd.
* Correctie Volwassenheidsniveau eAfspraak en Huisartsgegevens.
|-

|}

MedMij:V2019.01 OntwerpBGZ 2017

2019-04-24T11:44:46Z

Mischa Tol: /* Release notes */

{{#customtitle:Functioneel Ontwerp BgZ 2.1.2 (op basis van zibs release 2017)}}
{{MedMij:V2019.01_Issuebox}}

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

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de Basisgegevensset Zorg binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2019.01_Ontwerpen| hier]] gevonden worden.

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

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

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

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

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

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

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

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen BgZ' en 'Beschikbaarstellen BgZ' is te vinden in [[MedMij:V2019.01_ToelichtingKwalificatieBgZ| ToelichtingKwalificatieBgZ]].

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

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

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

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.0.pdf BgZ op basis van zibs release 2017] bestaat uit een selectie van 28 zibs. Deze zibs vormen samen een verzameling van patiëntgegevens die minimaal nodig is om patiënten continuïteit van zorg te kunnen bieden. De Basisgegevensset Zorg is gebaseerd op de Europese Patient Summary.

Deze use case gebruikt de structuur die is aangebracht in BgZ 2017 van 18 secties waarin de onderdelen waaruit de BgZ is opgebouwd, gegroepeerd zijn. Deze secties komen sterk overeen met de secties van CCR/CCD en maken het o.a. mogelijk om in de technische implementatie (bv FHIR) structuur aan te brengen. In de MedMij FHIR implementatie gids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:V2019.01_FHIR_BGZ_2017#List_of_StructureDefinitions|overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

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

{| class="wikitable" "cellpadding="10" width="100%"
! style="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 de eigen BgZ raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt de BgZ beschikbaar
|}
'''Bedrijfsrollen Basisgegevensset Zorg'''

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

[[Image:InzienBGZ_activity.png|Activiteitendiagram Raadplegen BgZ]]

'''Activiteitendiagram Raadplegen BgZ'''

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

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

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

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

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

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

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

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

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

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

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

Zie ook onderstaande afbeelding.

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

'''Componenten diagram van systemen en systeemrollen'''

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|BgZ (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen BgZ
|style="background-color: white;vertical-align:top;"|MM-2.1.2-BZR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_BGZ_2017|BgZ in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen BgZ
|style="background-color: white;vertical-align:top;"|MM-2.1.2-BZB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

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

'''Use case diagram inzien BgZ

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
|}
'''Referenties

=Bijlage: Documenthistorie=
==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 22; style="background-color: white;"| 2019.01
| style="background-color: white;"| 2.1.2
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-219 MM-219]
| style="background-color: white;"| MedicationUse niet compleet na een resave in Forge.
|-
| rowspan = 2; style="background-color: white;"| 2.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-210 MM-210]
| style="background-color: white;"| MedMij BgZ is nog gebaseerd op 1.0 i.p.v.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 19; style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-174 MM-174]
| style="background-color: white;"| Corrected search url for PlannedCareActivityForTransfer - DeviceRequest. Added an '&'.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-161 MM-161]
| style="background-color: white;"| CBV codes in ProcedureRequest.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-145 MM-145]
| style="background-color: white;"| ContactPerson verwijzing informatiestandaarden vs patient zib.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-144 MM-144]
| style="background-color: white;"| Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-143 MM-143]
| style="background-color: white;"| Aanpassing modellering Procedure.performer in het profiel voor HCIM Verrichting.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-141 MM-141]
| style="background-color: white;"| Vital Signs profielen inconsistent m.b.t. baseDefinition.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-134 MM-134]
| style="background-color: white;"| MedicationUse StopType found values do not correspond with MedicationUseStopTypeCodeList values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-127 MM-127]
| style="background-color: white;"| TimeOfDay in InstructionsForUse and the Hapi Enumerators.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-115 MM-115]
| style="background-color: white;"| Solved inconsistency in the List of StructureDefinitions. Also we will no longer check PlannedCareActivityForTransfer for MedicationAdministration in section 17 Zorgplan, because we found it was unimplementable as-is. Presumed solution will come from a future HCIM release.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-99 MM-99]
| style="background-color: white;"| Interval heeft Period maar geen PeriodUnit op simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-98 MM-98]
| style="background-color: white;"| InstructionsForUse zib informatie model komt niet overeen met simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-50 MM-50]
| style="background-color: white;"| Contact ondersteunt geen klinische contacten.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-42 MM-42]
| style="background-color: white;"| medicatiegebruik - auteur - zorgverlener: kan niet alle info kwijt.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-41 MM-41]
| style="background-color: white;"| voorschrijver/zorgverlener/zorgaanbieder past niet in medicationUse.
|-
| rowspan = 6; style="background-color: white;"| 2018.06
| rowspan = 6; style="background-color: white;"| 2.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-174 MM-174]
| style="background-color: white;"| URL voor PlannedCareActivity- DeviceRequest mist een '&'.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-128 MM-128]
| style="background-color: white;"| CanceledIndicator possible values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-55 MM-55]
| style="background-color: white;"| Profile for HCIM TobaccoUse was missing a specification for PackYears unit - profile updated to 2.0.1.
|-

| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-54 MM-54]
| style="background-color: white;"| Wrong SNOMED code in search URL for FunctionalOrMentalStatus.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-23 MM-23]
| style="background-color: white;"| Commentaar bij dagdeel codelijst verwijst naar dode URL.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 24-04-2019
| style="background-color: white;"|
* Toevoegen releasenote voor [https://bits.nictiz.nl/browse/MM-219 MM-219]
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 28-03-2019
| style="background-color: white;"|
* Plaatsen release notes behorende bij patch 1.
* Versienummer systeemrolcodes ophogen met 1 patch nummer.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
* Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
* Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 18-10-2018
| style="background-color: white;"|
* Toevoeging releasenotes en ophoging systeemrol versienummer vanwege een technische verbetering in de raadpleging van FunctioneleOfMentale gegevens.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel en documenthistorie.
|-
| style="background-color: white;vertical-align:top;"| 2018.06
| style="background-color: white;vertical-align:top;"| 30-08-2018
| style="background-color: white;"|
* Paragraaf 2.1.4, Verwijzing naar ART-DECOR toegevoegd.
* Bijlage: Documenthistorie toegevoegd.
* Paragraaf 1.4, verwijzing naar nieuwe pagina kwalificatie informatie toegevoegd.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 16-08-2018
| style="background-color: white;"|
* Structuur paragraaf 1.1 t/m 1.4 toegevoegd, ter voorbereiding kwalificatie informatie.
|}

MedMij:Vprepub-2019.01 OntwerpBGZ 2017

2019-04-24T11:44:46Z

Mischa Tol: /* Release notes */

MedMij:V2019.01 OntwerpHuisartsgegevens

2019-03-29T15:12:04Z

Mischa Tol:

{{#customtitle:Functioneel Ontwerp Huisartsgegevens 1.1.1}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:Huisartsgegevens.png|link=|links|Huisartsgegevens|85px]]
[[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:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR GP Data|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
De basis voor de inhoud van dit ontwerp is de "[[#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]". Op basis van deze richtlijn wordt de patiënt in staat gesteld een samenvatting van zijn huisartsdossier online op te vragen.

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

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

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

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

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

==Use case: Raadplegen Huisartsgegevens door patiënt==
===Doel en relevantie===
Online inzage door de patiënt in het elektronisch patiëntendossier bij de huisarts (H-EPD) heeft als doel om de zorg beter te maken. De patiënt krijgt door online inzage meer overzicht en is beter geïnformeerd. Hierdoor heeft de patiënt meer begrip van en regie over de eigen gezondheid en het stimuleert zelfzorg. Ook kan het de kwaliteit van het dossier helpen verhogen.

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

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een huisartsgegevens 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 gegevens zoals deze door de huisarts worden aangeboden voor online inzage aan de patiënt bestaan uit 10 secties (zie bijlage 1 van de richtlijn). Een aantal daarvan overlappen met de [[MedMij:V2019.01_OntwerpBGZ_2017|Basisgegevensset Zorg]] (BgZ) en een aantal daarvan zijn uniek voor het huisartsdossier. De richtlijn baseert zich op het [[#his-referentiemodel-2016|HIS referentiemodel]]. Die richtlijn heeft geen relatie met de [http://www.zibs.nl Zorginformatiebouwstenen] (zibs). Voor een aantal secties is deze relatie wel te leggen en voor een aantal ook niet (goed). De discrepanties zullen in de toekomst, in het Nictiz/NHG project "Huisartsoverdrachten", nog verder onderzocht en geslecht worden. Dit ontwerp Huisartsgegevens loopt daarop vooruit, omdat alle FHIR-profielen zich baseren op de zibs. Dit ontwerp en de technische uitwerking zal worden bijgewerkt, zodra de geharmoniseerde zorginformatiebouwstenen beschikbaar zijn. Dit zal naar verwachting niet vóór 2019 plaatsvinden.

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

{| class="wikitable collapsible collapsed" cellpadding="10" width="80%"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="4" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="2" | (Voorlopige) mapping naar zibs
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Onderdelen uit het Huisarts‑EPD
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Beschrijving
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Uitleg met voorbeelden
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Zorginformatiebouwsteen
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Opmerking
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"|Huisarts/Huisartsenpraktijk
| style="background-color: white;vertical-align:top;"|De huisarts en/of de huisartsenpraktijk waar de gegevens van afkomstig zijn.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/Zorgverlener-v3.1(2017NL) Zorgverlener v3.1 (2017)] [https://zibs.nl/wiki/Zorgaanbieder-v3.1(2017NL) Zorgaanbieder v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"|Patiënt
| style="vertical-align:top;"|De patiëntgegevens van de patiënt waarvoor de samenvatting is.
| style="vertical-align:top;"|
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient v3.1 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"|Episodes
| style="background-color: white;vertical-align:top;"|Een gezondheidsprobleem zoals een klacht of een aandoening, waarvan de aard in de loop der tijd kan veranderen door voortschrijdend inzicht of door het beloop van de aandoening.
| style="background-color: white;vertical-align:top;"|Ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: blaasontsteking of droge hoest.
| style="background-color: white;" rowspan="3"| [https://zibs.nl/wiki/OverdrachtConcern-v1.2(2015NL) OverdrachtConcern v1.2 (2015)] [https://zibs.nl/wiki/Alert-v3.1(2017EN) Alert v3.1 (2017)]
| style="background-color: white;" rowspan="3"| Na 2015 is nog een versie 3.0 in 2016 uitgebracht die alleen in versie, niet in inhoud veranderd is. De versie van 2017 echter heeft expliciet gebruik voor episodes geschrapt.
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"|Episodes met een attentievlag
| style="vertical-align:top;"|Episodes kunnen een attentievlag hebben om extra aandacht voor de episode te vragen. De attentievlag kan aanwezig blijven als een episode afgesloten wordt/is, wanneer de gebruiker het belangrijk vindt dit probleem in beeld te houden.
| style="vertical-align:top;"|Belangrijke ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: reuma, suikerziekte, kanker, erfelijke ziekten.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"|Open en gesloten episodes
| style="background-color: white;vertical-align:top;"|Episodes kunnen open (actueel) of gesloten (niet langer actueel) zijn.
| style="background-color: white;vertical-align:top;"|Open/actueel: ziekten, aandoeningen, klachten en symptomen waarvoor nog zorg wordt verleend. Gesloten/niet actueel: ziekten, aandoeningen, klachten en symptomen waarvoor in het verleden zorg is verleend.
|-
| style="vertical-align:top;"| 6
| style="vertical-align:top;"|Behandeling
| style="vertical-align:top;"|Handeling aan de patiënt, die invloed heeft op de gezondheidstoestand van de patiënt.
| style="vertical-align:top;"|Operaties en (zware) behandelingen zoals bestraling of chemotherapie.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/Verrichting-v4.0(2017NL) Verrichting v4.0 (2017)]''
| style="vertical-align:top;"| Zib ondersteunt alleen de DHD Verrichtingenthesaurus waarmee het huisartssysteem niet werkt.
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Profylaxe en voorzorg
| style="background-color: white;vertical-align:top;"| In Profylaxe en voorzorg worden voorzorgsmaatregelen vastgelegd die nodig zijn bij of vanwege bepaalde medische aandoeningen.
| style="background-color: white;vertical-align:top;"| Bijvoorbeeld voorzorgen bij ooit doorgemaakte endocarditis (ontsteking van de binnenbekleding van het hart en de hartkleppen) of na een miltverwijdering.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Er is in principe slechts een type uit NHG tabel 56
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"| Actuele medicatie
| style="vertical-align:top;"| Medicatie-afspraak Het voorstel van een voorschrijver tot gebruik van medicatie waarmee de patiënt akkoord is. De afspraak kan zowel starten, herhalen, wijzigen als stoppen van medicatie betreffen.
| style="vertical-align:top;"| '''De actuele medicatie''' is het overzicht van de medicatieafspraken. Het is de lijst van geneesmiddelen die de patiënt nu gebruikt.
| style="vertical-align:top;"| [https://zibs.nl/wiki/Medicatieafspraak-v1.0(2017NL) Medicatieafspraak v1.0 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"| Medicatie-overgevoeligheid
| style="background-color: white;vertical-align:top;"| Een medicatie-overgevoeligheid beschrijft een overgevoeligheid van een patiënt voor een geneesmiddel, een stof of een geneesmiddelengroep, waarmee rekening gehouden moet worden bij het voorschrijven van medicatie.
| style="background-color: white;vertical-align:top;"| Lijst van geneesmiddelen waarop in het verleden een overgevoeligheid of levensbedreigende allergische reactie is opgetreden. Bijvoorbeeld: allergie voor aspirine.
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergieIntolerantie-v3.1(2017NL) AllergieIntolerantie v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"|Correspondentie
| style="vertical-align:top;"|Inkomend: Een binnengekomen brief betreffende een patiënt, die als zodanig is vastgelegd in het medisch dossier van de patiënt. Uitgaand: Een brief die opgesteld is door een praktijkmedewerker en naar een externe zorgverlener verstuurd is.
| style="vertical-align:top;"|Inkomende = brieven uit het ziekenhuis, polikliniek, zorginstelling. Uitgaande = verwijsbrieven.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Correspondentie kan een binair bestand zijn zoals PDF/A, typen in de zib zijn niet toereikend voor alle typen correspondentie
|-
| style="background-color: white;vertical-align:top;"| 11
| style="background-color: white;vertical-align:top;"|Resultaten van bepalingen – ''laatste veertien maanden''
| style="background-color: white;vertical-align:top;"|Een bepaling is een objectiveerbare diagnostische verrichting. Het resultaat is de (uitkomst) van een bepaling.
| style="background-color: white;vertical-align:top;"|Uitslagen van fysieke metingen, zoals bloeddruk, gewicht en laboratoriumtesten, zoals ijzergehalte in het bloed.
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/LaboratoriumUitslag-v4.0(2017NL) LaboratoriumUitslag v4.0 (2017)] 
[https://zibs.nl/wiki/Bloeddruk-v3.1(2017NL) Bloeddruk v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamsgewicht-v3.1(2017NL) Lichaamsgewicht v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamslengte-v3.1(2017NL) Lichaamslengte v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamstemperatuur-v3.1(2017NL) Lichaamstemperatuur v3.1 (2017)] 
[https://zibs.nl/wiki/AlgemeneMeting-v3.0(2017NL) AlgemeneMeting v3.0 (2017)] 
[https://zibs.nl/wiki/Hartfrequentie-v3.1(2017NL) Hartfrequentie v3.1 (2017)] 
[https://zibs.nl/wiki/O2Saturatie-v3.1(2017NL) O2Saturatie v3.1(2017)] 
[https://zibs.nl/wiki/Polsfrequentie-v3.1(2017NL) Polsfrequentie v3.1(2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 12
| style="vertical-align:top;"|E- en P-regels van de SOEP- structuur - ''vastgelegd na invoering van online inzage''
| style="vertical-align:top;"|Informatie uit een deelcontact dat in vrije tekst wordt geregistreerd volgens de SOEP-structuur. Het acroniem SOEP staat voor Subjectief, Objectief, Evaluatie en Plan.
| style="vertical-align:top;"|In de E(valuatie)-regel staat de conclusie van het consult. In de P(lan)-regel staan de afgesproken zaken en eventuele vervolgstappen.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Journaalregeltype en ICPC-codering, extra t.o.v. in zib
|}

====Raadplegen huisartsgegevens ====
De vraag wordt gesteld aan de huisarts of huisartsenpraktijk. Er zijn geen verdere parameters bekend. Zie de [[#richtlijn-huisarts-patient|richtlijn]] voor de verdere context van de vraag naar de huisartsgegevens.

Dit betreft de filtermogelijkheden (parameters) in de vraag om huisartsgegevens.

====Beschikbaarstellen huisartsgegevens====
Zie voor de Informatie-elementen in huisartsgegevens de [[#richtlijn-huisarts-patient|richtlijn]].

Dit betreft de inhoud van de transactie met huisartsgegevens.

=== 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 huisartsgegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt huisartsgegevens beschikbaar
|}
'''Bedrijfsrollen huisartsgegevens'''

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

[[Bestand:Activity_Diagram_-_Huisartspatientsamenvatting.jpg|Activiteitendiagram Raadplegen huisartsgegevens]]

'''Activiteitendiagram Raadplegen huisartsgegevens'''

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

Hieronder een voor Roos relevante situatie waarbij het raadplegen van de huisartsgegevens een rol speelt.

<blockquote></blockquote>

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

De patiënt wil de huisartsgegevens inzien en de zorgaanbieder stelt deze ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een huisartsgegevens 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.

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

=====Postconditie=====
De patiënt kan de huisartsgegevens inzien 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 de gegevens van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* HuisartsPatiëntsamenvattingRaadplegend Systeem [MM-1.1.1-HGR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* HuisartsPatiëntsamenvattingBeschikbaarstellend Systeem in FHIR [MM-1.1.1-HGB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Huisartspatientsamenvatting_(Totaal).jpg|Componentendiagram]]

'''Componentendiagram'''

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;"| '''Systeemrol'''
! 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"|Huisartsgegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.1-HGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR GP Data|Huisartsgegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.1-HGB-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_-_Huisartspatientsamenvatting.jpg|Use case diagram raadplegen Huisartsgegevens]]

'''Use case diagram

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| Richtlijn Online inzage in het H-EPD door patiënt
| style="background-color: white;"|
| style="background-color: white;"| 2017
| style="background-color: white;"| https://www.nhg.org/themas/publicaties/richtlijn-online-inzage-het-h-epd-door-patient of de [https://www.nhg.org/sites/default/files/content/nhg_org/images/richtlijn_online_inzage_in_het_h-epd_door_patient_web_2017.pdf directe link (PDF)]
| style="background-color: white;"| NHG / Patiëntenfederatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| HIS referentiemodel Publieksversie (Utrecht 2016)
| style="background-color: white;"|
| style="background-color: white;"| 2016
| style="background-color: white;"| https://referentiemodel.nhg.org/inhoud/themas/publieksversie/published
| style="background-color: white;"| NHG
|}

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 4; style="background-color: white;"| 2019.01
| style="background-color: white;"| 1.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 3; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-144 MM-144]
| style="background-color: white;"| Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| rowspan = 3; style="background-color: white;"| 2018.06
| rowspan = 3; style="background-color: white;"| 1.0.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-64 MM-64]
| style="background-color: white;"| Koppelen van meetinstrument aan relevante profielen.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-51 MM-51]
| style="background-color: white;"| Extend query for AllergyIntolerance with parameter <code>code</code>. This parameter allows querying specifically medication intolerances.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 28-03-2019
| style="background-color: white;"|
* Plaatsen release notes behorende bij patch 1.
* Versienummer systeemrol codes ophogen met 1 patch nummer.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpHuisartsgegevens

2019-03-29T15:12:04Z

Mischa Tol:

MedMij:V2019.01 OntwerpLabresult

2019-03-29T14:05:17Z

Mischa Tol:

{{#customtitle:Functioneel Ontwerp Laboratoriumresultaten 1.1.1}}
{{MedMij:V2019.01_Issuebox}}

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

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

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

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

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

Zoals [[MedMij:V2019.01_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende ZIB's als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende ZIB's:
*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*OverdrachtLaboratoriumUitslag.

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

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

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

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

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.

=Use Cases=

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

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

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

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

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

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

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

Dit betreft de inhoud van ieder laboratoriumresultaat.

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

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

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

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

'''Activiteitendiagram Raadplegen laboratoriumresultaten'''

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

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

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

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

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

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

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

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

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

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om laboratoriumresultaten van zorgaanbieder / laboratorium naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* LaboratoriumresultaatBeschikbaarstellend Systeem [LAB-1.1.1-LRB-FHIR]

Een PGO vervult de volgende systeemrol:
* LaboratoriumresultaatRaadplegend Systeem [LAB-1.1.1
-LRR-FHIR].

Zie ook onderstaande afbeelding.

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

'''Componenten diagram'''

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;"| '''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"|Laboratoriumresultaten (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.1.1-LRR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.1.1-LRB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (laboratorium)
|}

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

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

'''Use case diagram

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 6; style="background-color: white;"| 2019.01
| style="background-color: white;"| 1.1.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-206 MM-206]
| style="background-color: white;"| Reference vanuit Observation naar Specimen Isolate onjuist.
|-
| rowspan = 5; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-112 MM-112]
| style="background-color: white;"| Verwijzing in §2.4.1.2 naar zib OverdrachtLaboratoriumuitslag v1.2.2 (release 2015) gewijzigd in zib Laboratoriumuitslag v4.1 (release 2017). In het technisch ontwerp en FHIR-profielen werd deze al toegepast.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-108 MM-108]
| style="background-color: white;"| use-case Collect (from XIS to PGO).
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 28-03-2019
| style="background-color: white;"|
* Plaatsen release notes behorende bij patch 1.
* Versienummer systeemrol codes ophogen met 1 patch nummer.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
* Verwijzing in §2.4.1.2 naar zib OverdrachtLaboratoriumuitslag v1.2.2 (release 2015) gewijzigd in zib Laboratoriumuitslag v4.1 (release 2017).
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpLabresult

2019-03-29T14:05:17Z

Mischa Tol:

MedMij:V2019.01 FHIR GGZ

2019-03-15T10:47:16Z

Mischa Tol: /* History */ Correctie pagina historie

{{#customtitle:MedMij FHIR Implementation Guide basic GGZ data 1.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:MedMij-GGZ-63.png |link=|links|80px|Use case GGZ|GGZ]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpGGZ|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
The page describes the FHIR requirements for exchanging GGZ information between the patients and healthcare providers in the context of MedMij. The overarching FHIR requirements, described in the [[MedMij:V2019.01_FHIR_IG|technical IG guide homepage]], are applicable here.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Actors
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/ggz-clientcapabilities CapabilityStatement: Client]
| FHIR Client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/ggz-servercapabilities CapabilityStatement: Server]
| FHIR Server requirements
|}

=Boundaries and Relationships=
The GGZ use case has similarities and differences with other use cases such as the BgZ, Medication Process, Vital Signs, GP Patient Data and Lab Results. These use cases use much of the same HCIM based FHIR profiles for exchanging information. Wherever possible every attempt is made to re-use the profiles as used in the BgZ. The GGZ use case also has unique profiles compared to the aforementioned use cases. In addition, it has a CareTeam profile without an underlying HCIM.
A second thing to note is that while the selection criteria of certain sections like procedure do not match with the BgZ or other use cases, this does not affect the profiles in use. For example, it is irrelevant for the response profile for procedures if you request ' surgical procedures' or 'every procedure'.

=Use case: retrieve GGZ information=
==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the patients GGZ information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system requests the patient's GGZ information using individual search interactions over multiple FHIR resources. The client can use multiple individual search operations based on specified search queries. A search interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The table below shows in the first three columns the HCIM name in Dutch, in English and what HCIM content is requested. The last column shows the FHIR search queries to retrieve this information. The queries are based on the functional GGZ information exchange requirements, which are stated in the [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_OntwerpGGZ| functional overview] and shown in detail in this [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_InhoudGGZ| table]. The queries, and more profoundly the response messages follow the profiles listed in [[#List_of_StructureDefinitions| the list of StructureDefinition]] section. The response content shall conform to these StructureDefinitions.

{{FHIR-IG-Afsprakenstelsel-Note}}

{| class="wikitable" style="horizontal-align: right"

!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Content
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Search URL
|-
| Patient
| Patient
| Identification, birthdate, gender, deceasedindicator, contact details, marital status, legal status, and general practitioner (practitioner or organization)
| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| BurgerlijkeStaat
| MaritalStatus
| Known marital status
| style="font-style:italic;" | see Patient
|-
| Betaler
| Payer
| Insurance information
| <pre>GET [base]/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization</pre>
|-
| BehandelAanwijzing
| TreatmentDirective
| All known treatment directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105</pre>
|-
| Wilsverklaring
| AdvanceDirective
| All known advance directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11341000146107</pre>
|-
| JuridischeStatus
| LegalStatus
| Known legal status
| style="font-style:italic;" | see Patient and FreedomRestrictingMeasures procedure
|-
| VrijheidbeperkendeMaatregelen
| FreedomRestrictingMeasures
| All known freedom restricting measures
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|225317005</pre>
|-
| Contactpersoon
| Contact
| First relation/contact
| style="font-style:italic;" | see Patient.contact
|-
| FunctioneleOfMentaleStatus
| FunctionalOrMentalStatus
| All known functional / mental status
| <pre>GET [base]/Observation?category=http://snomed.info/sct|118228005,http://snomed.info/sct|384821006</pre>
|-
| Probleem
| Problem
| All known problems
| <pre>GET [base]/Condition</pre>
|-
| Druggebruik
| DrugUse
| All known drug use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228366006</pre>
|-
| Alcoholgebruik
| AlcoholUse
| All known alcohol use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228273003</pre>
|-
| Tabakgebruik
| TobaccoUse
| All known tobacco use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365980008</pre>
|-
| Woonsituatie
| LivingSituation
| Last known living situation
| <pre>GET [base]/Observation/$lastn?code=http://snomed.info/sct|365508006</pre>
|-
| Gezinssituatie
| FamilySituation
| All known family situations
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365470003</pre>
|-
| GezinssituatieKind
| FamilySituationChild
| All known family situations of child patient
| <pre>GET [base]/Observation?code=http://snomed.info/sct|55801000146105</pre>
|-
| Taalvaardigheid
| LanguageProficiency
| Known language proficiency
| style="font-style:italic;" | see Patient
|-
| ParticipatieInMaatschappij
| ParticipationInSociety
| All known participation in society status
| <pre>GET [base]/Observation?code=http://snomed.info/sct|314845004</pre>
|-
| HulpVanAnderen
| HelpFromOthers
| All known help from others
| <pre>GET [base]/CarePlan?category=http://snomed.info/sct|243114000</pre>
|-
| LaboratoriumUitslag
| LaboratoryTestResult
| Last known laboratory results per type (incl. medication levels like lithium)
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen</pre>
|-
| AlgemeneMeting
| GeneralMeasurement
| All known questionaire (for example HONOS, OQ-45, CQ index, 4DKL) outcome scores.
| <pre>GET [base]/Observation?category=http://hl7.org/fhir/observation-category|survey</pre>
|-
| Verrichting
| Procedure
| All known GGZ procedures
| <pre>GET [base]/Procedure</pre>
|-
| TekstUitslag
| TextResult
| All known text results of GGZ procedures
| <pre>GET [base]/DiagnosticReport</pre>
|-
| -
| -
| CareTeam: primary healthprofessional and other relevant healthprofessionals including the healthcare provider.
| <pre>GET [base]/CareTeam?_include=CareTeam:participant</pre>
|-
| Zorgverlener
| HealthProfessional
| General Practitioner of the patient
| style="font-style:italic;" | see Patient, CareTeam
|-
| Zorgaanbieder
| HealthProvider
| General Practitioner's organization of the patient
| style="font-style:italic;" | see Patient, CareTeam
|}

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section].

====Response to resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the returned content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The returned content SHALL conform to the StructureDefinition applicable for the specific HCIM request. The list of a StructureDefinitions relevant for this use case is shown in the following paragraph: [[#List_of_StructureDefinitions | List of StructureDefinitions]]

The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self-link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails '''(cannot be executed, not that there are no matches)''', the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the GGZ use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed for this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
** Including modifier 'in'
* [http://hl7.org/fhir/STU3/search.html#reference reference]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM and are applicable in a broader context than the exchange of GGZ information.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:50px" | HCIM NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:50px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:50px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | FHIR Profile
|-
| Patient
| Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Betaler
| Payer
| Coverage
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Payer http://nictiz.nl/fhir/StructureDefinition/zib-Payer]
|-
| BehandelAanwijzing
| TreatmentDirective
| Consent
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective]
|-
| Wilsverklaring
| AdvanceDirective
| Consent
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective]
|-
|-
| JuridischeStatus*
| LegalStatus*
| Extension
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient see Patient] or [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-FreedomRestrictingMeasures see FreedomRestrictingMeasures]
|-
| VrijheidbeperkendeMaatregelen
| FreedomRestrictingMeasures
| Procedure
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-FreedomRestrictingMeasures http://nictiz.nl/fhir/StructureDefinition/zib-FreedomRestrictingMeasures]
|-
| FunctioneleOfMentaleStatus
| FunctionalOrMentalStatus
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus]
|-
| Probleem
| Problem
| Condition
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Problem http://nictiz.nl/fhir/StructureDefinition/zib-Problem]
|-
| Woonsituatie
| LivingSituation
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation]
|-
| Druggebruik
| DrugUse
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse]
|-
| Alcoholgebruik
| AlcoholUse
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse]
|-
| Tabakgebruik
| TobaccoUse
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse]
|-
| Gezinssituatie
| FamilySituation
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-FamilySituation http://nictiz.nl/fhir/StructureDefinition/zib-FamilySituation]
|-
| GezinssituatieKind
| FamilySituationChild
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-FamilySituationChild http://nictiz.nl/fhir/StructureDefinition/zib-FamilySituationChild]
|-
| Taalvaardigheid
| LanguageProficiency
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient see Patient]
|-
| ParticipatieInMaatschappij
| ParticipationInSociety
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-ParticipationInSociety http://nictiz.nl/fhir/StructureDefinition/zib-ParticipationInSociety]
|-
| HulpVanAnderen
| HelpFromOthers
| CarePlan
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-HelpFromOthers http://nictiz.nl/fhir/StructureDefinition/zib-HelpFromOthers]
|-
| LaboratoriumUitslag
| LaboratoryTestResult
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| AlgemeneMeting
| GeneralMeasurement
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-GeneralMeasurement http://nictiz.nl/fhir/StructureDefinition/zib-GeneralMeasurement]
|-
| Verrichting
| Procedure
| Procedure
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| TekstUitslag
| TextResult
| DiagnosticReport
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-TextResult http://nictiz.nl/fhir/StructureDefinition/zib-TextResult]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthProfessional
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| -
| -
| CareTeam
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-careteam http://fhir.nl/fhir/StructureDefinition/nl-core-careteam]
|}
<blockquote>* LegalStatus is a single concept of the HCIM FreedomRestrictingMeasures and does not represent a complete HCIM yet. This concept will become an indepentend HCIM in a future release of the HCIM.</blockquote>

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
Relevant HCIM to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Terminology, NamingSystems, Mappings=

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].

All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpGGZ#Release_notes|functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes.
*Moved release notes to the functional design page.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2018
| style="background-color: white;"| Added section "Terminology, NamingSystems, Mappings".
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 18-10-2018
| style="background-color: white;"| Corrected SNOMED code in search url for FunctionalOrMantalStatus.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history.
|}

[[categorie:MedMij FHIR Use Cases]]

MedMij:Vprepub-2019.01 FHIR GGZ

2019-03-15T10:47:16Z

Mischa Tol: /* History */ Correctie pagina historie

MedMij:V2019.01 OntwerpGGZ

2019-03-15T10:42:03Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

{{#customtitle:Functioneel Ontwerp Basisgegevens GGZ 1.1.0 (op basis van zibs release 2017)}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:MedMij-GGZ-63.png |link=|links|80px|Use case GGZ|GGZ]]
[[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:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_GGZ|Technisch]]
desc none
</imagemap>

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de uitwisseling van Basisgegevens GGZ op basis van een selectie Zorginformatiebouwstenen (Zibs) Zorg binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2019.01_Ontwerpen| hier]] gevonden worden.

Voor het [https://www.vippggz.nl/ VIPP GZZ programma] is een [https://zoek.officielebekendmakingen.nl/stcrt-2018-60877.html#d17e2089 lijst van verplichte zorginformatiebouwstenen (zibs)] vastgesteld die geschikt zijn verklaard voor de GGZ sector, de Basisgegevens GGZ. Deze lijst omvat momenteel alleen de reeds beschikbare zibs (publicatie 2017) met minimale inhoud en structuur als opmaat naar een volwaardige GGZ informatiestandaard (in ontwikkeling door GGZ Nederland en Nictiz). De lijst van zibs en hierop gebaseerd specificaties vertoont enige overlap met de [https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg (BgZ)] maar is zeker niet hetzelfde: zie [[MedMij:V2019.01_OntwerpGGZ#Informatie| Informatie]] voor een nadere toelichting over het samenstellen van de inhoud.

De use cases voor de toekomstige GGZ informatiestandaard zijn nog niet omschreven, echter staat voor het VIPP GGZ programma het perspectief van de patiënt centraal. Het doel van deze pagina is dan ook om de uitwisseling van de Basisgegevens GGZ met de patiënt te omschrijven.

'''Let op:''' Naast deze Basisgegevens GGZ, wordt in de VIPP GGZ ook gebruik gemaakt van de [https://www.nictiz.nl/programmas/medicatieproces/| Medicatieproces 9.0 informatiestandaard]. Het functioneel ontwerp voor de uitwisseling van medicatiegegevens is [[MedMij:V2019.01_OntwerpMedicatie| hier]] te vinden.

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

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

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

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

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

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen GGZ' en 'Beschikbaarstellen GGZ' is [[MedMij:V2019.01_ToelichtingKwalificatieGGZ| hier]] te vinden.

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

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

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

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De Basisgegevens GGZ bestaat uit een selectie van 24 zibs. Deze zibs vormen samen een verzameling van gegevens die binnen de GGZ sector toepasbaar zijn. Hierbij bestaat de selectie voorlopig alleen uit reeds bestaande zibs (publicatie 2017) die voor de GGZ sector geschikt zijn met een minimale inhoud en structuur zoals te vinden in dit [[MedMij:V2019.01_InhoudGGZ|overzicht]]. Bij de ontwikkeling van de volwaardige GGZ informatiestandaard wordt dit nader gespecificeerd, met nadere uitwerking van GGZ-specifieke gegevens die nog niet gedekt worden door bestaande zibs. De Basisgegevens GGZ zal in de toekomst hiermee worden aangevuld. De huidige lijst aan geselecteerde zibs komt voor een deel overeen met de [https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg (BgZ)], maar voor een deel ook niet: het gaat om twee aparte sets. Zie het [[MedMij:V2019.01_InhoudGGZ|overzicht van de inhoud]] voor een nadere toelichting.

Medicatiegegevens vallen buiten de Basisgegevens GGZ, omdat hiervoor gebruik wordt gemaakt van het reeds bestaande [https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx| Medicatieproces 9.0] (zie [[MedMij:V2019.01_OntwerpMedicatie| hier]] voor uitwisseling medicatiegegevens in PGO).

In de bestaande zibs valt de zogenaamde juridische status en vertegenwoordiging binnen de zib VrijheidsbeperkendeMaatregelen. Voor de GGZ sector is het loskoppelen van dit gegeven (als losstaande zib) van groot belang, omdat deze ook relevant is buiten de toepassing van vrijheidsbeperkende maatregelen. In de verdere uitwerking van de Basisgegevens GGZ is het element JuridischeStatus losgekoppeld van de verdere zib VrijheidsbeperkendeMaatregelen. Deze loskoppeling wordt tevens als wijzigingsverzoek behandeld bij de nieuwe publicatie zibs: de huidige uitwerking loopt op deze toekomstige ontwikkeling vooruit.

In de MedMij FHIR implementatie gids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:V2019.01_FHIR_GGZ#List_of_StructureDefinitions|overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

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

{| class="wikitable" "cellpadding="10" width="100%"
! style="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 de eigen Basisgegevens GGZ raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt de Basisgegevens GGZ beschikbaar
|}
'''Bedrijfsrollen Basisgegevens GGZ'''

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

[[Image:InzienGGZ_activity.png|Activiteitendiagram Raadplegen GGZ]]

'''Activiteitendiagram Raadplegen GGZ'''

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

<blockquote>In zijn PGO kan Jelmer doorlezen wat de huisarts voorgeschreven heeft en vindt hij de verwijzing voor een psycholoog. Hij zoekt een psycholoog uit en maakt een afspraak waarbij hij de verwijzing bijvoegt. Bij de apotheek haalt hij zijn medicatie op, deze kan hij terugvinden in het medicatieoverzicht in zijn PGO.</blockquote>

<blockquote>‘Pling’, Jelmer krijgt van zijn PGO een reminder dat hij morgen om 10.00 zijn eerste afspraak heeft bij de psycholoog. Tevens kan hij vanuit zijn PGO een vragenlijst invullen voor de psycholoog over zijn klachten, gezondheid en verwachtingen. Wat zijn huisarts al vermoedde, wordt door de psycholoog bevestigd.</blockquote>

<blockquote>Gedurende de sessie komen er onverwerkte zaken uit zijn jeugd boven. Deze zijn zo heftig dat Jelmer in een acute depressie belandt. Zijn vriendin Karin geeft aan dat Jelmer op het moment niet thuis kan wonen en samen met de huisarts nemen ze het besluit dat Jelmer voor korte duur opgenomen wordt bij een GGZ-instelling in de buurt. Hier wordt een nieuw behandelplan opgesteld waarin groepstherapie een onderdeel gaat worden. Jelmer heeft Karin gemachtigd om in zijn PGO te kijken zodat ze onder andere het behandelplan in kan zien en ze goed betrokken wordt.</blockquote>

<blockquote>De opname in de GGZ-instelling is van korte duur. Vanaf nu wordt Jelmer ambulant behandeld door een reguliere GGZ-instelling. Gelukkig is deze met 5 minuten fietsen van huis lekker dichtbij. De psychiater van de instelling schrijft een overdracht voor zijn nieuwe hoofdbehandelaar. Zowel Karin als Jelmer kunnen via het PGO inzien wat daarin staat. Daarom weten ze nu dat de medicatie is aangepast.</blockquote>

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

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

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

De Basisgegevens GGZ, of een gedeelte van de Basisgegevens GGZ, welke de persoon wil inzien, bestaat en de zorgaanbieder wil deze beschikbaarstellen.
:Soms zijn er valide redenen om de Basisgegevens GGZ, 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 GGZ op te halen, maar het is ook mogelijk dat een PGO geconfigureerd is om dit 'automatisch' te doen. Dit maakt voor de scope van deze use case beschrijving geen verschil.

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

===== Post conditie =====
De persoon kan de Basisgegevens GGZ inzien via een persoonlijke gezondheidsomgeving.

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

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Systeem
!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;"| GGZRaadplegend
| style="background-color: white;"| MM-1.1.0-GGR-FHIR
| style="background-color: white;"| Raadplegen Basisgegevens GGZ bij zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| GGZBeschikbaarstellend
| style="background-color: white;"| MM-1.1.0-GGB-FHIR
| style="background-color: white;"| Beschikbaarstellen Basisgegevens GGZ aan de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:InzienGGZ_componenten.png.PNG|Componenten diagram]]

'''Componenten diagram van systemen en systeemrollen'''

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|GGZ (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen GGZ
|style="background-color: white;vertical-align:top;"|MM-1.1.0-GGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_GGZ |GGZ in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen GGZ
|style="background-color: white;vertical-align:top;"|MM-1.1.0-GGB-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:InzienGGZ_useCase.png|Use case diagram inzien Basisgegevens GGZ]]

'''Use case diagram inzien Basisgegevens GGZ

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
|}
'''Referenties

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 8; style="background-color: white;"| 2019.01
| rowspan = 8; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-143 MM-143]
| style="background-color: white;"| Aanpassing modellering Procedure.performer in het profiel voor HCIM Verrichting.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-99 MM-99]
| style="background-color: white;"| Interval heeft Period maar geen PeriodUnit op simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-98 MM-98]
| style="background-color: white;"| InstructionsForUse zib informatie model komt niet overeen met simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-50 MM-50]
| style="background-color: white;"| Contact ondersteunt geen klinische contacten.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-42 MM-42]
| style="background-color: white;"| medicatiegebruik - auteur - zorgverlener: kan niet alle info kwijt.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-41 MM-41]
| style="background-color: white;"| voorschrijver/zorgverlener/zorgaanbieder past niet in medicationUse.
|-
| rowspan = 4; style="background-color: white;"| 2018.06
| rowspan = 4; style="background-color: white;"| 1.0.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-128 MM-128]
| style="background-color: white;"| CanceledIndicator possible values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-55 MM-55]
| style="background-color: white;"| Profile for HCIM TobaccoUse was missing a specification for PackYears unit - profile updated to 2.0.1.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-54 MM-54]
| style="background-color: white;"| Wrong SNOMED code in search URL for FunctionalOrMentalStatus in BgZ and GGZ.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 01-11-2018
| style="background-color: white;"| Toevoeging verwijzing naar gepubliceerde VIPP GGZ regeling en uitgangspunten voor kwalificatie.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 26-09-2018
| style="background-color: white;"| Toevoeging toelichting over de inhoud m.b.t. overlap en verschillen met de Basisgegevensset Zorg (BgZ).
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 10-09-2018
| style="background-color: white;"| Eerste conceptversie.
|}

MedMij:Vprepub-2019.01 OntwerpGGZ

2019-03-15T10:42:03Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

MedMij:V2019.01 FHIR GP Data

2019-03-15T10:38:06Z

Mischa Tol: /* History */ Correctie pagina historie

{{#customtitle:MedMij FHIR Implementation Guide GP Patient Data 1.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Huisartsgegevens.png |link=|links|90px|Use case GP Patient Data|GP Patient Data]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpHuisartsgegevens|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The input document "[[MedMij:V2019.01_OntwerpHuisartsgegevens#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]" (Dutch) described online access of GP data by patients. The use case evolves around a GP specific Patient Data that consists of 10 sections plus the patient and the healthcare provider (GP). These sections correspond to the "[[MedMij:V2019.01_OntwerpHuisartsgegevens#his-referentiemodel-2016|HIS referentiemodel Publieksversie 2016]]" (Dutch). ''HIS referentiemodel'' is the GP information system reference model (GP-IS-RM).

Some but not all sections in the GP Patient Data correspond to Health and Care Information Models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)). A joint initiative project between [http://www.nictiz.nl Nictiz] and the Dutch GP association [https://www.nhg.org NHG] is underway to analyse the relationship between the GP-IS-RM and the HCIMs and propose updates where needed. This analysis will not yield results before 2019. This specification thus predates the analysis, and will updated accordingly moving forward.

This page will elaborate further on the HL7 FHIR details needed to exchange the GP Patient Data information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/gp-patientdata2017-clientcapabilities CapabilityStatement: Client]
| GP Patient Data client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/gp-patientdata2017-servercapabilities CapabilityStatement: Server]
| GP Patient Data server requirements
|}

==Boundaries and Relationships==
The GP Patient Data use case has similarities and differences with other use cases such as the [[MedMij:Vcurrent_FHIR_IG|BgZ]], Medication Process, Vital Signs and Lab Results. These use cases use much of the same HCIM based FHIR profiles for exchanging information. Wherever possible every attempt is made to re-use the profiles as used in the BgZ. The GP Patient Data also has a few unique profiles compared to the aforementioned use cases. A second thing to note is that while the selection criteria of certain sections like lab do not match, this does not affect the response profiles. For example it is irrelevant for the response profile lab if you request the 'latest lab result' or 'every result since date X'.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the GP Patient Data information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system can request the GP Patient Data using individual search interactions. The search interaction searches the current resources based on some filter criteria. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The table below shows in the first four columns the GP Patient Data sections, the GP-IS-RM sections / HCIMs that constitute those sections and the specific content of the GP Patient Data. The last column shows the FHIR search queries to obtain the GP Patient Data information. These queries are based on StructureDefinitions listed in [[#List_of_StructureDefinitions| this section]]. As noted in the [[#Introduction|introduction]], the associated HCIMs are ahead of a separate joint initiative project that aims to analyse and harmonize this further.

Each query is performed in the context of a specific authenticated patient, for which an OAuth2 token has been retrieved using the Authentication mechanisms described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel']. This token must be passed in each call in the HTTP header named “Authorization”. Each XIS Gateway is required to perform filtering based on the patient associated with the OAuth2 token received for the request, so that only the records associated with the authenticated patient are returned. Therefore, no search parameters should be passed for patient identification.

{| class="wikitable collapsible" cellpadding="10"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| GP Patient Data Section
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| HCIM EN
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Content
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Example search URL
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"| General Practitioner/Practice
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/HealthProfessional-v3.1(2017EN) HealthProfessional v3.1 (2017)] [https://zibs.nl/wiki/HealthcareProvider-v3.1(2017EN) HealthcareProvider v3.1 (2017)]
| style="background-color: white;vertical-align:top;"| The GP or GP practice that originates the patient data.
| style="background-color: white;vertical-align:top;"| ''TODO. Check assumption here that a patient requests the data from his regular GP. If he were to request it from any other GP/practice he might have visited, then the Patient.generalPractitioner does not apply.''<pre style="font-style: italic;">see Patient</pre>
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"| Patient
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017EN) Patient v3.1 (2017)]
| style="vertical-align:top;"| De patient data of the patient the data is for.
| style="vertical-align:top;"| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"| Episodes
| style="background-color: white;" rowspan="3"|
| style="background-color: white;vertical-align:top;"| A health concern like a complaint of illness, that may change in nature as diagnoses are made and/or the illness develops.
| style="background-color: white;" rowspan="3"| <pre>GET [base]/EpisodeOfCare?_revinclude=Flag:detail</pre>
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"| Episodes with alert flag
| style="vertical-align:top;"| Episodes may have an associated alert signaling extra attention to the episode is requested. The alert flag may stay active even if after closing the episode, if the user deems it important to stay aware.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"| Open and closed episodes
| style="background-color: white;vertical-align:top;"| Episodes may be open (currently active) or closed (no longer active).
|- style="vertical-align:top;"
| 6
| Treatment
| ''[https://zibs.nl/wiki/Procedure-v4.0(2017EN) Procedure v4.0 (2017)]''
| Procedure on the patient targeting the patients health situation. E.g. operative and (severe) procedures like radiation or chemotherapy.
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|365508006</pre>
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Prophylaxis en precaution
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Prophylaxis and precaution contain precautionary measures required for or to prevent certain medical conditions. See [https://referentiemodel.nhg.org/tabellen/894/publieksversie/published NHG Tabel 56]
| style="background-color: white;vertical-align:top;"| ''TODO: No HCIM. GP systems do not yet export this info. Unclear if it'll be anything beyond the Table 56 code (id, time, author, text?)'' <pre>GET [base]/Observation?code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-56-profylaxe-en-voorzorg|</pre>
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"|Current medication
| style="vertical-align:top;"|[https://zibs.nl/wiki/MedicationAgreement-v1.0(2017EN) MedicationAgreement v1.0 (2017)]
| style="vertical-align:top;"|MedicationAgreement The prescriber proposed use of medication that the patient agrees with. The agreement may signal starting, repeating, updating or stopping the medication. The list of MedicationAgreements is also known as the list of medication the patient is '''currently''' using
| style="vertical-align:top;"|<pre>GET [base]/MedicationRequest?status=active&category=http://snomed.info/sct|16076005&_include:MedicationRequest:medication</pre>
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"|Medication intolerance
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergyIntolerance-v3.1(2017EN) AllergyIntolerance v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|A medication intolerance concerns the intolerance of a patient for a specific drug, substance or substance group, that needs to be taken into account when prescribing, dispensing or administering medication.
| style="background-color: white;vertical-align:top;"| <pre>GET [base]/AllergyIntolerance?code=http://snomed.info/sct|419511003</pre>
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"| Correspondence
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TextResult-v4.0(2017EN) TextResult v4.0 (2017)]''
| style="vertical-align:top;"|Incoming: an incoming letter about a patient, recorded as such in the patients medical record. Outbound: a letter created by a healthcare professional for a third party healthcare professional.
| style="vertical-align:top;"| ''TODO: HCIM is a poor match. GP systems do not yet export this info. FHIR DocumentReference is a very good match though'' <pre>GET [base]/DocumentReference</pre>
|-
| style="background-color: white;vertical-align:top;" rowspan="9"| 11
| style="background-color: white;vertical-align:top;" rowspan="9"| Lab results
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/LaboratoryTestResult-v4.0(2017EN) LaboratoryTestResult v4.0 (2017)]
| style="background-color: white;vertical-align:top;" rowspan="9"|A lab test is an objectifiable diagnostic procedure. The result is the outcome of the procedure. Lab tests include vital signs like blood pressure, weight and lab results like ferro in blood. Note that GP (lab) results are normally coded using [https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen NHG Tabel 45]. While some of these codes might be convertible to LOINC or SNOMED CT, this is '''not''' expected at present. Bridging code systems between primary and secondary care is part of a larger national discussion Note that the date parameter is optional and needs calculation, e.g. current-date() - 14 months. The business rules in the [[MedMij:V2019.01_OntwerpHuisartsPatientsamenvatting#richtlijn-huisarts-patient|guide lines]] determine the maximum range for the returned results. If the date parameter is omitted, the maximum range is assumed
| style="background-color: white;" rowspan="9"| <pre>GET [base]/Observation?code=https://referentiemodel.nhg.org/tabellen/nhg-tabel-45-diagnostische-bepalingen|&_include=Observation:related-target&_include=Observation:specimen&date=ge2017-01-01</pre>
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BloodPressure-v3.1(2017EN) BloodPressure v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BodyHeight-v3.1(2017EN) BodyHeight v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BodyTemperature-v3.1(2017EN) BodyTemperature v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/BodyWeight-v3.1(2017EN) BodyWeight v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/GeneralMeasurement-v3.0(2017EN) GeneralMeasurement v3.0 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/HeartRate-v3.1(2017EN) HeartRate v3.1 (2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/O2Saturation-v3.1(2017EN) O2Saturation v3.1(2017)]
|-
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/PulseRate-v3.1(2017EN) PulseRate v3.1(2017)]
|- style="vertical-align:top;"
| 12
|E- and P-journal entries of the SOAP (EN) or SOEP (NL) structure - ''recorded after introduction of online access''
| ''[https://zibs.nl/wiki/TextResult-v4.0(2017EN) TextResult v4.0 (2017)]''
| Information from an encounter, recorded in free text using the SOAP structure. The acronym SOAP stands for Subjective, Objective, Assessment and Plan. The E entry contains the consultation conclusion and the P entry contains potential next steps. Note that the profile for SOAP entries is yet to be created and the code system value is preliminary
| ''TODO: LOINC code has status proposal'' <pre>GET [base]/Composition?type=http://loinc.org|67781-5</pre>
|}

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section].

====Response to resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the return content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The returned content should conform to the StructureDefinition applicable for the specific HCIM request. The list of a StructureDefinitions relevant for this use case is shown in the following paragraph: [[#List_of_StructureDefinitions| List of StructureDefinitions]]

The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails '''(cannot be executed, not that there are no matches)''', the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the GP Patient Data use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]
* [http://hl7.org/fhir/STU3/http.html#transaction Batch/Transaction]

===Operations===
There are no operations required to support this use case

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:


Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of GP Patient Data or a MedMij context. An example for reuse of existing profiles are those of the patient administration resources and vital signs.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable collapsible" cellpadding="10"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
|-
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | URL Profile
|-
| style="background-color: white;" rowspan="2"| 1
| style="background-color: white;"| Zorgverlener
| style="background-color: white;"| HealthProfessional
| style="background-color: white;"|
| style="background-color: white;"| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| style="background-color: white;"| Zorgaanbieder
| style="background-color: white;"| HealthcareProvider
| style="background-color: white;"| Organization
| style="background-color: white;"| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| 2
|Patiënt
|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| style="background-color: white;"| 3
| style="background-color: white;" rowspan="3"|
| style="background-color: white;" rowspan="3"|
| style="background-color: white;" rowspan="3"| EpisodeOfCare
| style="background-color: white;" rowspan="3"| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-episodeofcare http://fhir.nl/fhir/StructureDefinition/nl-core-episodeofcare]
|-
| 4
|-
| style="background-color: white;"| 5
|-
| 6
|Procedure
|Verrichting
| Procedure
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| style="background-color: white;"| 7
| style="background-color: white;"| AlgemeneMeting
| style="background-color: white;"| GeneralMeasurement
| style="background-color: white;"|
| style="background-color: white;"|
|-
| 8
| MedicatieAfspraak
| MedicationAgreement
| MedicationRequest
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| style="background-color: white;"| 9
| style="background-color: white;"| AllergieIntolerantie
| style="background-color: white;"| AllergyIntolerance
| style="background-color: white;"| AllergyIntolerance
| style="background-color: white;"| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|-
| 10
| ''Correspondentie''
|
| DocumentReference
| [https://simplifier.net/IHEPatientDemographi/IHEMHDDocumentReference http://ihe.net/fhir/StructureDefinition/IHE.MHD.DocumentReference]
|-
| style="background-color: white;" rowspan="9"| 11
| style="background-color: white;"| LaboratoriumUitslag
| style="background-color: white;"| LaboratoryTestResult
| style="background-color: white;" rowspan="9"| Observation
| style="background-color: white;" rowspan="9"| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/gp-DiagnosticResult http://nictiz.nl/fhir/StructureDefinition/gp-DiagnosticResult] (NHG Table 45 codes of type D) [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/gp-LaboratoryResult http://nictiz.nl/fhir/StructureDefinition/gp-LaboratoryResult] (NHG Table 45 codes of type L)
|-
| style="background-color: white;"| Bloeddruk
| style="background-color: white;"| BloodPressure
|-
| style="background-color: white;"| Lichaamslengte
| style="background-color: white;"| BodyHeight
|-
| style="background-color: white;"| Lichaamstemperatuur
| style="background-color: white;"| BodyTemperature
|-
| style="background-color: white;"| Lichaamsgewicht
| style="background-color: white;"| BodyWeight
|-
| style="background-color: white;"| AlgemeneMeting
| style="background-color: white;"| GeneralMeasurement
|-
| style="background-color: white;"| Harfrequentie
| style="background-color: white;"| HeartRate
|-
| style="background-color: white;"| O2Saturatie
| style="background-color: white;"| O2Saturation
|-
| style="background-color: white;"| Polsfrequentie
| style="background-color: white;"| PulseRate
|-
| 12
| ''E and P entry from SOAP/SOEP''
|
| Composition Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/gp-EncounterReport http://nictiz.nl/fhir/StructureDefinition/gp-EncounterReport] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/gp-JournalEntry http://nictiz.nl/fhir/StructureDefinition/gp-JournalEntry]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
Relevant ZIB to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].
All profiles include HCIM mappings. HCIM concepts are mapped in the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpHuisartsgegevens#Release_notes| functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes.
*Moved release notes to the functional design page.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history.
|}

[[Categorie:MedMij FHIR Use Cases]]

MedMij:Vprepub-2019.01 FHIR GP Data

2019-03-15T10:38:06Z

Mischa Tol: /* History */ Correctie pagina historie

MedMij:V2019.01 OntwerpHuisartsgegevens

2019-03-15T10:36:32Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

{{#customtitle:Functioneel Ontwerp Huisartsgegevens 1.1.0}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:Huisartsgegevens.png|link=|links|Huisartsgegevens|85px]]
[[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:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR GP Data|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
De basis voor de inhoud van dit ontwerp is de "[[#richtlijn-huisarts-patient|Richtlijn online inzage in het H-EPD door patiënt]]". Op basis van deze richtlijn wordt de patiënt in staat gesteld een samenvatting van zijn huisartsdossier online op te vragen.

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

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

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

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

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

==Use case: Raadplegen Huisartsgegevens door patiënt==
===Doel en relevantie===
Online inzage door de patiënt in het elektronisch patiëntendossier bij de huisarts (H-EPD) heeft als doel om de zorg beter te maken. De patiënt krijgt door online inzage meer overzicht en is beter geïnformeerd. Hierdoor heeft de patiënt meer begrip van en regie over de eigen gezondheid en het stimuleert zelfzorg. Ook kan het de kwaliteit van het dossier helpen verhogen.

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

===Context===
Het gaat om het elektronisch en gestructureerd beschikbaar maken van een huisartsgegevens 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 gegevens zoals deze door de huisarts worden aangeboden voor online inzage aan de patiënt bestaan uit 10 secties (zie bijlage 1 van de richtlijn). Een aantal daarvan overlappen met de [[MedMij:V2019.01_OntwerpBGZ_2017|Basisgegevensset Zorg]] (BgZ) en een aantal daarvan zijn uniek voor het huisartsdossier. De richtlijn baseert zich op het [[#his-referentiemodel-2016|HIS referentiemodel]]. Die richtlijn heeft geen relatie met de [http://www.zibs.nl Zorginformatiebouwstenen] (zibs). Voor een aantal secties is deze relatie wel te leggen en voor een aantal ook niet (goed). De discrepanties zullen in de toekomst, in het Nictiz/NHG project "Huisartsoverdrachten", nog verder onderzocht en geslecht worden. Dit ontwerp Huisartsgegevens loopt daarop vooruit, omdat alle FHIR-profielen zich baseren op de zibs. Dit ontwerp en de technische uitwerking zal worden bijgewerkt, zodra de geharmoniseerde zorginformatiebouwstenen beschikbaar zijn. Dit zal naar verwachting niet vóór 2019 plaatsvinden.

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

{| class="wikitable collapsible collapsed" cellpadding="10" width="80%"
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="4" | Bijlage 1 Richtlijn Online inzage in het H-EPD door patiënt
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="2" | (Voorlopige) mapping naar zibs
|-
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| #
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Onderdelen uit het Huisarts‑EPD
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Beschrijving
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Uitleg met voorbeelden
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Zorginformatiebouwsteen
! style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px"| Opmerking
|-
| style="background-color: white;vertical-align:top;"| 1
| style="background-color: white;vertical-align:top;"|Huisarts/Huisartsenpraktijk
| style="background-color: white;vertical-align:top;"|De huisarts en/of de huisartsenpraktijk waar de gegevens van afkomstig zijn.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/Zorgverlener-v3.1(2017NL) Zorgverlener v3.1 (2017)] [https://zibs.nl/wiki/Zorgaanbieder-v3.1(2017NL) Zorgaanbieder v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 2
| style="vertical-align:top;"|Patiënt
| style="vertical-align:top;"|De patiëntgegevens van de patiënt waarvoor de samenvatting is.
| style="vertical-align:top;"|
| style="vertical-align:top;"| [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient v3.1 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 3
| style="background-color: white;vertical-align:top;"|Episodes
| style="background-color: white;vertical-align:top;"|Een gezondheidsprobleem zoals een klacht of een aandoening, waarvan de aard in de loop der tijd kan veranderen door voortschrijdend inzicht of door het beloop van de aandoening.
| style="background-color: white;vertical-align:top;"|Ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: blaasontsteking of droge hoest.
| style="background-color: white;" rowspan="3"| [https://zibs.nl/wiki/OverdrachtConcern-v1.2(2015NL) OverdrachtConcern v1.2 (2015)] [https://zibs.nl/wiki/Alert-v3.1(2017EN) Alert v3.1 (2017)]
| style="background-color: white;" rowspan="3"| Na 2015 is nog een versie 3.0 in 2016 uitgebracht die alleen in versie, niet in inhoud veranderd is. De versie van 2017 echter heeft expliciet gebruik voor episodes geschrapt.
|-
| style="vertical-align:top;"| 4
| style="vertical-align:top;"|Episodes met een attentievlag
| style="vertical-align:top;"|Episodes kunnen een attentievlag hebben om extra aandacht voor de episode te vragen. De attentievlag kan aanwezig blijven als een episode afgesloten wordt/is, wanneer de gebruiker het belangrijk vindt dit probleem in beeld te houden.
| style="vertical-align:top;"|Belangrijke ziekten, aandoeningen, klachten en symptomen. Bijvoorbeeld: reuma, suikerziekte, kanker, erfelijke ziekten.
|-
| style="background-color: white;vertical-align:top;"| 5
| style="background-color: white;vertical-align:top;"|Open en gesloten episodes
| style="background-color: white;vertical-align:top;"|Episodes kunnen open (actueel) of gesloten (niet langer actueel) zijn.
| style="background-color: white;vertical-align:top;"|Open/actueel: ziekten, aandoeningen, klachten en symptomen waarvoor nog zorg wordt verleend. Gesloten/niet actueel: ziekten, aandoeningen, klachten en symptomen waarvoor in het verleden zorg is verleend.
|-
| style="vertical-align:top;"| 6
| style="vertical-align:top;"|Behandeling
| style="vertical-align:top;"|Handeling aan de patiënt, die invloed heeft op de gezondheidstoestand van de patiënt.
| style="vertical-align:top;"|Operaties en (zware) behandelingen zoals bestraling of chemotherapie.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/Verrichting-v4.0(2017NL) Verrichting v4.0 (2017)]''
| style="vertical-align:top;"| Zib ondersteunt alleen de DHD Verrichtingenthesaurus waarmee het huisartssysteem niet werkt.
|-
| style="background-color: white;vertical-align:top;"| 7
| style="background-color: white;vertical-align:top;"| Profylaxe en voorzorg
| style="background-color: white;vertical-align:top;"| In Profylaxe en voorzorg worden voorzorgsmaatregelen vastgelegd die nodig zijn bij of vanwege bepaalde medische aandoeningen.
| style="background-color: white;vertical-align:top;"| Bijvoorbeeld voorzorgen bij ooit doorgemaakte endocarditis (ontsteking van de binnenbekleding van het hart en de hartkleppen) of na een miltverwijdering.
| style="background-color: white;vertical-align:top;"|
| style="background-color: white;vertical-align:top;"| Er is in principe slechts een type uit NHG tabel 56
|-
| style="vertical-align:top;"| 8
| style="vertical-align:top;"| Actuele medicatie
| style="vertical-align:top;"| Medicatie-afspraak Het voorstel van een voorschrijver tot gebruik van medicatie waarmee de patiënt akkoord is. De afspraak kan zowel starten, herhalen, wijzigen als stoppen van medicatie betreffen.
| style="vertical-align:top;"| '''De actuele medicatie''' is het overzicht van de medicatieafspraken. Het is de lijst van geneesmiddelen die de patiënt nu gebruikt.
| style="vertical-align:top;"| [https://zibs.nl/wiki/Medicatieafspraak-v1.0(2017NL) Medicatieafspraak v1.0 (2017)]
| style="vertical-align:top;"|
|-
| style="background-color: white;vertical-align:top;"| 9
| style="background-color: white;vertical-align:top;"| Medicatie-overgevoeligheid
| style="background-color: white;vertical-align:top;"| Een medicatie-overgevoeligheid beschrijft een overgevoeligheid van een patiënt voor een geneesmiddel, een stof of een geneesmiddelengroep, waarmee rekening gehouden moet worden bij het voorschrijven van medicatie.
| style="background-color: white;vertical-align:top;"| Lijst van geneesmiddelen waarop in het verleden een overgevoeligheid of levensbedreigende allergische reactie is opgetreden. Bijvoorbeeld: allergie voor aspirine.
| style="background-color: white;vertical-align:top;"| [https://zibs.nl/wiki/AllergieIntolerantie-v3.1(2017NL) AllergieIntolerantie v3.1 (2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 10
| style="vertical-align:top;"|Correspondentie
| style="vertical-align:top;"|Inkomend: Een binnengekomen brief betreffende een patiënt, die als zodanig is vastgelegd in het medisch dossier van de patiënt. Uitgaand: Een brief die opgesteld is door een praktijkmedewerker en naar een externe zorgverlener verstuurd is.
| style="vertical-align:top;"|Inkomende = brieven uit het ziekenhuis, polikliniek, zorginstelling. Uitgaande = verwijsbrieven.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Correspondentie kan een binair bestand zijn zoals PDF/A, typen in de zib zijn niet toereikend voor alle typen correspondentie
|-
| style="background-color: white;vertical-align:top;"| 11
| style="background-color: white;vertical-align:top;"|Resultaten van bepalingen – ''laatste veertien maanden''
| style="background-color: white;vertical-align:top;"|Een bepaling is een objectiveerbare diagnostische verrichting. Het resultaat is de (uitkomst) van een bepaling.
| style="background-color: white;vertical-align:top;"|Uitslagen van fysieke metingen, zoals bloeddruk, gewicht en laboratoriumtesten, zoals ijzergehalte in het bloed.
| style="background-color: white;vertical-align:top;"|[https://zibs.nl/wiki/LaboratoriumUitslag-v4.0(2017NL) LaboratoriumUitslag v4.0 (2017)] 
[https://zibs.nl/wiki/Bloeddruk-v3.1(2017NL) Bloeddruk v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamsgewicht-v3.1(2017NL) Lichaamsgewicht v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamslengte-v3.1(2017NL) Lichaamslengte v3.1 (2017)] 
[https://zibs.nl/wiki/Lichaamstemperatuur-v3.1(2017NL) Lichaamstemperatuur v3.1 (2017)] 
[https://zibs.nl/wiki/AlgemeneMeting-v3.0(2017NL) AlgemeneMeting v3.0 (2017)] 
[https://zibs.nl/wiki/Hartfrequentie-v3.1(2017NL) Hartfrequentie v3.1 (2017)] 
[https://zibs.nl/wiki/O2Saturatie-v3.1(2017NL) O2Saturatie v3.1(2017)] 
[https://zibs.nl/wiki/Polsfrequentie-v3.1(2017NL) Polsfrequentie v3.1(2017)]
| style="background-color: white;vertical-align:top;"|
|-
| style="vertical-align:top;"| 12
| style="vertical-align:top;"|E- en P-regels van de SOEP- structuur - ''vastgelegd na invoering van online inzage''
| style="vertical-align:top;"|Informatie uit een deelcontact dat in vrije tekst wordt geregistreerd volgens de SOEP-structuur. Het acroniem SOEP staat voor Subjectief, Objectief, Evaluatie en Plan.
| style="vertical-align:top;"|In de E(valuatie)-regel staat de conclusie van het consult. In de P(lan)-regel staan de afgesproken zaken en eventuele vervolgstappen.
| style="vertical-align:top;"| ''[https://zibs.nl/wiki/TekstUitslag-v4.0(2017NL) TekstUitslag v4.0 (2017)]''
| style="vertical-align:top;"| Journaalregeltype en ICPC-codering, extra t.o.v. in zib
|}

====Raadplegen huisartsgegevens ====
De vraag wordt gesteld aan de huisarts of huisartsenpraktijk. Er zijn geen verdere parameters bekend. Zie de [[#richtlijn-huisarts-patient|richtlijn]] voor de verdere context van de vraag naar de huisartsgegevens.

Dit betreft de filtermogelijkheden (parameters) in de vraag om huisartsgegevens.

====Beschikbaarstellen huisartsgegevens====
Zie voor de Informatie-elementen in huisartsgegevens de [[#richtlijn-huisarts-patient|richtlijn]].

Dit betreft de inhoud van de transactie met huisartsgegevens.

=== 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 huisartsgegevens raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt huisartsgegevens beschikbaar
|}
'''Bedrijfsrollen huisartsgegevens'''

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

[[Bestand:Activity_Diagram_-_Huisartspatientsamenvatting.jpg|Activiteitendiagram Raadplegen huisartsgegevens]]

'''Activiteitendiagram Raadplegen huisartsgegevens'''

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

Hieronder een voor Roos relevante situatie waarbij het raadplegen van de huisartsgegevens een rol speelt.

<blockquote></blockquote>

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

De patiënt wil de huisartsgegevens inzien en de zorgaanbieder stelt deze ook beschikbaar.
:Een patiënt kan steeds zelf het initiatief nemen om een huisartsgegevens 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.

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

=====Postconditie=====
De patiënt kan de huisartsgegevens inzien 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 de gegevens van zorgaanbieder naar patiënt.

Een PGO vervult de volgende systeemrol:
* HuisartsPatiëntsamenvattingRaadplegend Systeem [MM-1.1.0-HGR-FHIR].

Een XIS vervult in deze use case de volgende systeemrol:
* HuisartsPatiëntsamenvattingBeschikbaarstellend Systeem in FHIR [MM-1.1.0-HGB-FHIR]

Zie ook onderstaande afbeelding.

[[Bestand:Component_Diagram_-_Huisartspatientsamenvatting_(Totaal).jpg|Componentendiagram]]

'''Componentendiagram'''

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;"| '''Systeemrol'''
! 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"|Huisartsgegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.0-HGR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR GP Data|Huisartsgegevens in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen huisartsgegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.0-HGB-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_-_Huisartspatientsamenvatting.jpg|Use case diagram raadplegen Huisartsgegevens]]

'''Use case diagram

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| Richtlijn Online inzage in het H-EPD door patiënt
| style="background-color: white;"|
| style="background-color: white;"| 2017
| style="background-color: white;"| https://www.nhg.org/themas/publicaties/richtlijn-online-inzage-het-h-epd-door-patient of de [https://www.nhg.org/sites/default/files/content/nhg_org/images/richtlijn_online_inzage_in_het_h-epd_door_patient_web_2017.pdf directe link (PDF)]
| style="background-color: white;"| NHG / Patiëntenfederatie
|-
| style="background-color: white;"| -
| style="background-color: white;"| HIS referentiemodel Publieksversie (Utrecht 2016)
| style="background-color: white;"|
| style="background-color: white;"| 2016
| style="background-color: white;"| https://referentiemodel.nhg.org/inhoud/themas/publieksversie/published
| style="background-color: white;"| NHG
|}

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 3; style="background-color: white;"| 2019.01
| rowspan = 3; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-144 MM-144]
| style="background-color: white;"| Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| rowspan = 3; style="background-color: white;"| 2018.06
| rowspan = 3; style="background-color: white;"| 1.0.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-64 MM-64]
| style="background-color: white;"| Koppelen van meetinstrument aan relevante profielen.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-51 MM-51]
| style="background-color: white;"| Extend query for AllergyIntolerance with parameter <code>code</code>. This parameter allows querying specifically medication intolerances.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpHuisartsgegevens

2019-03-15T10:36:32Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

MedMij:V2019.01 FHIR PDFA

2019-03-15T10:32:15Z

Mischa Tol: /* History */ Correctie pagina historie

{{#customtitle:MedMij FHIR Implementation Guide: PDF/A 1.2.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:PDF-A_icoon.png|link=|87px |links||PDF/A]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpPDFA|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

MedMij specifies the format [http://www.pdfa.org/publication/pdfa-in-a-nutshell-2-0/ PDF/A] for exchanging unstructured documents containing health information. Forum Standaardisatie is a Dutch governmental organization that aims to stimulate the use of open standards. PDF/A is one of the standards that is recommended by Forum Standaardisatie. More information regarding PDF/A can be found here: https://www.forumstandaardisatie.nl/standaard/pdf-a1.

To achieve exchange of PDF/A files, MedMij adopts as much as possible from the Mobile access to Health Documents (MHD) profile from Integrating the Healthcare Enterprise (IHE) that defines a RESTful/HTTP interface to an [http://wiki.ihe.net/index.php/Cross-Enterprise_Document_Sharing XDS] environment using HL7 FHIR STU3 resources. The MHD profile is written to be content agnostic and as such is suitable for much more than PDF/A. For this use case, we have limited the scope to PDF/A.

MedMij includes the IHE MHD profile as a framework to exchange PDF/A documents. The next section summarizes MHD and contains references to this specification. The following section provides an adaptation of the MHD profile to specify exchange of PDF/A documents in a MedMij context. For example, the MHD actors and transactions are put into perspective of the MedMij actors and systems. The essence of the MHD profile is outlined and example transaction messages have been added.

'''Note''': this page is part of the [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_FHIR_IG MedMij FHIR Implementation Guide] and is a technical representation of the functional design published on this [[MedMij:V2019.01_Ontwerpen| wiki page]].

=IHE MHD specification=
Mobile access to Health Documents (MHD) profile defines a simple HTTP interface to an XDS like environment. It describes four transactions:
# submit submission sets, folders, new documents, and document metadata from the mobile device to a document receiver (Provide Document Bundle),
# find submission sets matching query parameters (Find Document Manifest),
# find document entries containing metadata based on query parameters (Find Document Reference),
# retrieve a copy of a specific document (Retrieve Document).
These transactions leverage the document content and format agnostic metadata concepts from XDS but simplify them for access by constrained environments such as mobile devices, or other resource-constrained systems. The MHD profile does not replace XDS. It can be used to allow mobile devices, or other resource-constrained systems, access to an XDS health information exchange.[http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD)]

'''Wiki:'''
[http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) Mobile acces to Health Document (MHD)]

'''Document:'''
[http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_MHD.pdf MHD Supplement] (Rev 2.3 July 24, 2017)

'''Additional Supplement:'''
[http://www.ihe.net/uploadedFiles/Documents/ITI/IHE_ITI_Suppl_Appx-Z.pdf Appendix Z on HL7 FHIR]

'''Underlying Standards:'''
* HL7 FHIR STU3 http://hl7.org/fhir/STU3
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]
** [http://hl7.org/fhir/STU3/list.html List]
** [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome]
** [http://hl7.org/fhir/STU3/patient.html Patient]
** [http://hl7.org/fhir/STU3/practitioner.html Practitioner]
* RFC2616 IETF Hypertext Transfer Protocol – HTTP/1.1
* RFC3986 IETF Uniform Resource Identifier (URI): Generic Syntax
* RFC4627 The application/json Media Type for JavaScript Object Notation (JSON)
* RFC6585 IETF Additional HTTP Status Codes

=Exchanging PDF/A documents=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
This section summarizes the IHE MHD profile to exchange PDF/A documents in a MedMij context.

{{FHIR-IG-Afsprakenstelsel-Note}}

==Actors and transactions involved==
Table 1 shows the relevant actors, systems and FHIR capability statements in a MedMij context. The capability statements demonstrate the minimum requirements to be conformant to the full MHD specifications.
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare environment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/pdfa-clientcapabilities CapabilityStatement: Client]
| PDFA FHIR Client requirements
|-
| Healthcare Provider
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/pdfa-servercapabilities CapabilityStatement: Server]
| PDFA FHIR Server requirements
|}
'''Table 1. Actors, systems and FHIR capability statements'''

Table 2 shows the MHD actors and transactions in perspective of the systems used in a MedMij context.
{| class="wikitable"
! style="font-weight: bold; text-align:left;" | Person
! style="font-weight: bold; text-align:left;" | System
! style="font-weight: bold; text-align:left;" | MHD Actors
! style="font-weight: bold; text-align:left;" | MHD Transactions
|-
| rowspan="5" | Patient
|-
| rowspan="4" | PHR
|-
| rowspan="3" | Document Consumer
| Find Document Manifest
|-
| Find Document Reference
|-
| Retrieve Document
|-
| rowspan="5" | Healthcare provider
|-
| rowspan="4" | XIS
|-
| rowspan="3" | Document Responder
| Find Document Manifest
|-
| Find Document Reference
|-
| Retrieve Document
|}
'''Table 2. MHD actors and transactions in perspective of systems in a MedMij context'''

===Transactions in scope===

* Find Document Manifests – This transaction is used to issue parameterized queries that result in a list of Document Manifest resources.
* Find Document References – This transaction is used to issue parameterized queries that produce a list of Document Reference resources.
* Retrieve Document – This transaction is used to get documents.

Document Consumer shall implement at least one transaction: Find Document Manifests, Find Document References, or Retrieve Document. Document Responder shall implement all transactions.

===Transactions out of scope===
The MHD profile specifies how to send documents from a Document Source to a Document Receiver using the Provide Document Bundle transaction. However, sending PDF/A documents is currently out of scope for the MedMij context. The 'Afsprakenstelsel' first focuses on pulling data from a XIS to a PHR before considering push transactions. In the future, specifications of sending PDF/A documents from a PHR will be added.

==Find and retrieve existing PDF/A document(s)==

===Find PDF/A or PDF/A collection===
Discovery of PDF/A documents is done with the MHD defined transaction 'Find Document Reference' or 'Find Document Manifest.' The Find Document Reference retrieves FHIR DocumentReference Resources that represents a single reference to document per resource, for example, one PDF/A file. The Find Document Manifest retrieves FHIR DocumentManifest Resources. A DocumentManifest Resource gathers a set of DocumentReference Resources into a single package together with metadata that applies to the collection.

The Document Consumer requests DocumentReference or DocumentManifest Resources, matching a set of criteria, from the Document Responder. The Document Responder returns DocumentReference or DocumentManifest Resources that match the search criteria provided by the Document Consumer.

====Request message====
'''Search'''

The Document Consumer executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification. A search query would have the following format.

<pre>
GET [base]DocumentReference?[parameters]{&_format=[mime-type]}
GET [base]DocumentManifest?[parameters]{&_format=[mime-type]}
</pre>

Example query to search for DocumentReferences of type Discharge summary with a current status.
<pre>GET http://example.org/fhir/DocumentReference?type=http://loinc.org|18842-5&status=current</pre>

'''Search Parameters'''
The Document Consumer shall include search parameter status. The Document Consumer may supply, and the Document Responder shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification (search parameters: [http://hl7.org/fhir/STU3/documentreference.html#search DocumentReference], [http://hl7.org/fhir/STU3/documentmanifest.html#search DocumentManifest]). See also the HL7 FHIR STU3 specification for [http://www.hl7.org/fhir/STU3/search.html searching].
{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | DocumentReference
! colspan="3" style="font-weight: bold; text-align:left;" | DocumentManifest
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| indexed
| date
| When this document reference was created
| created
| date
| When this document manifest created
|-
| author (author.given and author.family)
| string
| Who and/or what authored the document
| author (author.given and author.family)
| string
| Who and/or what authored the manifest
|-
| type
| token
| Kind of document (LOINC if possible)
| type
| token
| Kind of document set
|-
| class
| token
| Categorization of document
| source
| uri
| The source system/application/software
|-
| status
| token
| current / superseded
| status
| token
| current / superseded
|-
| setting
| token
| Additional details about where the content was created (e.g. clinical specialty)
|
|
|
|-
| period
| date
| Time of service that is being documented
|
|
|
|-
| facility
| token
| Kind of facility where patient was seen
|
|
|
|-
| event
| token
| Main clinical acts documented
|
|
|
|-
| securitylabel
| token
| Document security-tags
|
|
|
|-
| format
| token
| Format/content rules for the document
|
|
|
|-
| related-id
| token
| Identifier of related objects or events
|
|
|
|}

The PDF/A use cases within MedMij especially use of the search parameters '''indexed''' and '''status''' for DocumentReference and '''created''' and '''status''' for DocumentManifest.

====Response message====
The Document Responder shall process the query to discover the DocumentReference or DocumentManifest entries that match the search parameters given. The Document Responder returns an HTTP Status code appropriate to the processing as well as a Bundle including the matching DocumentReference or DocumentManifest Resources. When the Document Responder needs to report an error or warning, it shall use HTTP error response codes and should include a FHIR [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome] with more details on the failure or warning. If the request message is processed successfully, whether or not any DocumentReference or DocumentManifest Resources are found, the HTTP status code shall be 200.

* The Document Responder shall place into the ''''DocumentReference.content.attachment.url'''' element a full URL that can be used by the Document Consumer to retrieve the document using Retrieve Document transaction.
** The Document Responder shall only include references which are resolved through the Document Responder to maintain control over the authentication and authorization. The Document Responder shall only serve DocumentReference or DocumentManifest resources that contain a reference which the Document Consumer may resolve.
* The Document Responder shall return only PDF/A documents and shall place into the ''''DocumentReference.content.attachment.contentType'''' element the value 'application/pdf'.

'''Example of a response message'''

Example of a Bundle with 11 DocumentReference Resources. Only the first DocumentReference is displayed.

<pre>
<Bundle xmlns="http://hl7.org/fhir">
<id value="c0beb362-efc7-4cb9-b35a-c6cea0742156" />
<meta>
<versionId value="1498fcb4-af9c-404f-b445-e6634619df55" />
<lastUpdated value="2017-10-25T11:25:00.336+00:00" />
</meta>
<type value="searchset" />
<total value="11" />
<link>
<relation value="self" />
<url value="http://vonk.furore.com/DocumentReference?status=current" />
</link>
<entry>
<fullUrl value="http://vonk.furore.com/DocumentReference/c4f22730-bb5a-4f12-b4ef-c7bde0784426" />
<resource>
<DocumentReference xmlns="http://hl7.org/fhir">
<id value="example-pdfa-documentreference2" />
<meta>
<profile value="http://ihe.net/fhir/StructureDefinition/IHE.MHD.Query.Minimal.DocumentReference"/>
</meta>
<contained>
<Practitioner>
<id value="p1"/>
<name>
<family value="Kneder"/>
<given value="B.">
<extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
<valueCode value="IN"/>
</extension>
</given>
</name>
</Practitioner>
</contained>
<masterIdentifier>
<system value="urn:ietf:rfc:3986" />
<value value="urn:oid:1.2.276.0.7230010.3.1.2.1787205428.3024.1522314975.220899" />
</masterIdentifier>
<identifier>
<system value="http://example-xis.org/fhir/NamingSystem/DocumentReferenceID"/>
<value value="963369"/>
</identifier>
<status value="current" />
<type>
<coding>
<system value="http://loinc.org/" />
<code value="34781-5" />
<display value="Infectious disease Consult note" />
</coding>
</type>
<class>
<coding>
<system value="http://loinc.org/" />
<code value="11488-4" />
<display value="Consult Note" />
</coding>
</class>
<subject>
<reference value="Patient/example-pdfa-kwalificatie1" />
</subject>
<indexed value="2017-04-08T15:26:01+01:00" />
<author>
<reference value="#p1" />
</author>
<description value="Infectious disease Consult note" />
<securityLabel>
<coding>
<system value="http://hl7.org/fhir/v3/Confidentiality" />
<code value="V" />
<display value="very restricted" />
</coding>
</securityLabel>
<content>
<attachment>
<contentType value="application/pdf" />
<language value="en" />
<url value="http://example-test-server.org/fhir/Binary/example-pdfa-binary2" />
<title value="Example PDF - Infectious disease Consult note"/>
</attachment>
</content>
</DocumentReference>
</resource>
<search>
<mode value="match" />
</search>
</entry>
.......
</pre>

===Retrieve PDF/A document===
After obtaining the location of the PDF/A document in the DocumentReference.content.attachment.url, the Document Consumer requests the document from the Document Responder. The Document Responder sequentially serves the PDF/A document to the Document Consumer. The context that was established in the initial request shall also apply when retrieving/serving the document contents.

====Request Message====
This message is an HTTP GET request to retrieve the document. See an example below.

<pre>GET http://example:9556/svc/fhir/Binary/1e404af3-077f-4bee-b7a6-a9be97e1ce32</pre>

The Document Consumer may provide an HTTP Accept header, according to the semantics of the HTTP protocols (see RFC2616, Section 14.1). The only MIME type assured to be returned is the
MIME type indicated in the 'DocumentReference.content.attachment.contentType'. Within MedMij this is set to 'application/pdf'. The HTTP If-Unmodified-Since header shall not be included in the GET request

====Response Message====
The Document Responder shall process the request message. The Document Responder returns an HTTP Status code appropriate to the processing as well as the content of the requested PDF/A document in the HTTP message-body.

The document may be placed inside a FHIR [http://hl7.org/fhir/STU3/binary.html Binary] resource if it is useful to handle pure binary content using the same framework as other resources. Binary resources behave slightly differently from all other resources on the RESTful API. Specifically, when a read request is made for the binary resource that doesn't explicitly specify the FHIR content types "application/fhir+xml" or "application/fhir+json", then the content should be returned using the content type stated in the resource. e.g. if the content type in the resource is "application/pdf", then the content should be returned as a PDF directly.[http://hl7.org/fhir/STU3/binary.html#rest]

When the Document Responder needs to report an error or warning, it shall use HTTP error response codes and should include a [http://hl7.org/fhir/STU3/operationoutcome.html OperationOutcome] with more details on the failure or warning. If the Retrieve Document message is processed successfully the HTTP status code shall be 200.

'''Example of a response message'''
<pre><Binary>
<id value="1e404af3-077f-4bee-b7a6-a9be97e1ce32" />
<meta>
<versionId value="948f3653-c9a3-4831-bae5-f629319c194f" />
<lastUpdated value="2017-09-20T17:55:14.098+00:00" />
</meta>
<contentType value="application/pdf" />
<content value="JVBERi0xLjUNJeLjz9MNCjU1I........"/>
</Binary></pre>

==Interactions, operations, search parameters==

===Interactions===
The following logical interactions are needed for this use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]
* [http://hl7.org/fhir/STU3/http.html#read Read]

===Operations===
There are no defined operations for this use case.

===Search parameters===
The following search parameter types need to be supported for this use case. No search result parameters need to be supported.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#reference reference]
* [http://hl7.org/fhir/STU3/search.html#date date]
* [http://hl7.org/fhir/STU3/search.html#uri uri]

==List of StructureDefinitions==
IHE has defined StructureDefinitions and other Conformance resources applicable to this use case. The FHIR Implementation Guide on the '''[http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD)#FHIR_Implementation_Guide IHE MHD wiki]''' lists these StructureDefinitions.

Find and retrieve existing PDF/A document transaction uses the following StructureDefinitions (links are not resolvable!):

* DocumentReference from Query with Minimal Metadata (canonical URL http://ihe.net/fhir/StructureDefinition/IHE.MHD.Query.Minimal.DocumentReference)
* DocumentManifest (canonical URL http://ihe.net/fhir/StructureDefinition/IHE.MHD.DocumentManifest)

* Optionally: DocumentReference from Query with Comprehensive Metadata (canonical URL: http://ihe.net/fhir/StructureDefinition/IHE.MHD.Query.Comprenensive.DocumentReference). This StructureDefinition has more mandatory field compared to Minimal Metadata and is used for XDS environments.

{{IssueBox|The IHE StructureDefinitions restrict the use of the .created element. This is a known issue and will be addressed in the R4 release of the profiles. This issue (CP-ITI-1100) can be found on the [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD)#FHIR_Implementation_Guide IHE MHD wiki]. Therefore the indexed element is used to capture creation time.}}

Next to the IHE MHD StructureDefinitions, MedMij uses the following HCIM StructureDefinitions for the response message.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile|
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|}

=Annex: Document history=

==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpPDFA#Release_notes| functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes
*Moved release notes to the functional design page.
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"| Added StructureDefinitions of HCIMs for administration components which are applicable for this use case.

|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Added document history.
* Added version in title.
* XIS constraint based on BITS issue MSFOC-49.
|}

MedMij:Vprepub-2019.01 FHIR PDFA

2019-03-15T10:32:15Z

Mischa Tol: /* History */ Correctie pagina historie

MedMij:V2019.01 OntwerpPDFA

2019-03-15T10:31:00Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

{{#customtitle:Functioneel Ontwerp PDF/A 1.2.0}}
{{MedMij:V2019.01_Issuebox}}

[[Bestand:PDF-A icoon.png |link=|links |87px|PDF/A]]
[[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:V2019.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_PDFA|Technisch]]
desc none
</imagemap>

=Inleiding=
Deze pagina beschrijft use cases waarbij een patiënt medische gegevens in de vorm van een PDF/A kan raadplegen en versturen met behulp van een persoonlijke gezondheidsomgeving. MedMij heeft het [https://nl.wikipedia.org/wiki/PDF/A PDF/A] formaat gekozen als uitwisselingsformaat voor ongestructureerde gezondheidsgegevens. Algemene informatie betreffende deze use cases kan gevonden worden op deze [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_Ontwerpen wiki pagina].

=Use Cases=
Deze sectie vervolgt met de volgende use cases:
* [[MedMij:V2019.01_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt | Raadplegen medische gegevens in PDF/A]]
* [[MedMij:V2019.01_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| Sturen medische gegevens in PDF/A]]
==Use case: Raadplegen medische gegevens in PDF/A door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door inzicht te geven in medische informatie die over henzelf gaan. Het is niet mogelijk om alle medische informatie direct gestructureerd te kunnen ontsluiten voor de patiënt. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in een PDF/A format.

===Domein===
Documenten en ongestructureerde medische informatie in een PDF/A formaat in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch beschikbaar maken van medische gegevens in PDF/A formaat 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 medische gegevens in PDF/A====
Het raadplegen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

Informatie elementen in de vraag om PDF/A documenten staan hieronder. Dit betreft de filtermogelijkheden (query paramaters) in de vraag om documentgegevens. Deze filtermogelijkheden zijn afgeleid van het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel].

*patient
*periode (startdatum - einddatum)
*auteur
*type document
*categorie
*status
*setting (aanvullende details over waar de content is gemaakt / specialisme)
*medische handelingen (belangrijkste uitgevoerde medische handelingen)

====Beschikbaarstellen medische gegevens in PDF/A ====
De informatie-elementen voor het beschikbaarstellen van een PDF/A worden beschreven in het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel]. Dit betreft de inhoud van de transactie waarbij het om de volgende [http://hl7.org/fhir/STU3 HL7 FHIR STU3] informatie modellen en [https://zibs.nl/wiki/ZIB_Hoofdpagina Zorginformatiebouwstenen] gaat:

*HL7 FHIR
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]

*Zorginformatiebouwstenen
** [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient]
** [https://zibs.nl/wiki/Zorgverlener-v3.2(2017NL) Zorgverlener]

=== 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 medische gegevens in PDF/A formaat raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt medische gegevens in PDF/A formaat beschikbaar
|}
'''Bedrijfsrollen afspraak inzien'''

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

[[Bestand:Activity Diagram - PDFA raadplegen.png|Activiteitendiagram PFD/A raadplegen]]

'''Activiteitendiagram PDF/A raadplegen'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier]. Hieronder een voor Roos relevante situatie waarbij het raadplegen van een PDF/A document rol speelt.

<blockquote> Na het ontslag komt de informatie over de opnameperiode vanuit het ziekenhuis beschikbaar in de PGO, zodat zij een goed beeld heeft van haar opname en haar medicatie. Dit kan zij ook delen met haar naasten.
</blockquote>

Roos zou in haar PGO bijvoorbeeld de ontslagbrief van haar opname kunnen opvragen.

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

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

=====Proces stappen=====
*Het systeem van de patiënt (PGO) vraagt om beschikbare medische gegevens bij een XIS aan de hand van een zoekopdracht.
*Het systeem van de zorgaanbieder (XIS) levert een lijst met metadata over de gevonden PDF/A documenten op voor de patiënt.
*De Patiënt gebruikt de persoonlijke gezondheidsomgeving om de gewenste PDF/A te raadplegen of te downloaden.
*Het systeem van de zorgaanbieder (XIS) levert de PDF/A op voor de patiënt.

=====Post conditie=====
De patiënt heeft zijn medische gegevens geraadpleegd via de persoonlijke gezondheidsomgeving.

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

Deze systemen hebben meerdere 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="2"| PGO
| style="background-color: white;"| PDFAMetadataLijstRaadplegend
| style="background-color: white;"| MM-1.2.0-PLR-FHIR
| style="background-color: white;"| Raadplegen PDF/A metadata lijst bij zorgaanbieder
|-
| style="background-color: white;"| PDFARaadplegend
| style="background-color: white;"| MM-1.2.0-PDR-FHIR
| style="background-color: white;"| Raadplegen PDF/A document bij zorgaanbieder
|-
| style="background-color: white;" rowspan="2"| XIS
| style="background-color: white;"| PDFAMetadataLijstBeschikbaarstellend
| style="background-color: white;"| MM-1.2.0-PLB-FHIR
| style="background-color: white;"| Beschikbaarstellen PDF/A metadata lijst bij patient
|-
| style="background-color: white;"| PDFABeschikbaarstellend
| style="background-color: white;"| MM-1.2.0-PDB-FHIR
| style="background-color: white;"| Beschikbaarstellen PDF/A document bij patient
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - PDFA raadplegen (Totaal).png|Componenten diagram PDF/A raadplegen]]

'''Componenten diagram PDFA raadplegen'''

=== 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"|PDFA metadata lijst (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen PDF/A metadata lijst
|style="background-color: white;vertical-align:top;"|MM-1.2.0-PLR-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:V2019.01_FHIR_PDFA|PDF/A in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen PDF/A metadata lijst
|style="background-color: white;vertical-align:top;"|MM-1.2.0-PLB-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"|PDFA (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.2.0-PDR-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 PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.2.0-PDB-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 - PDFA raadplegen.png|Use case diagram PDF/A raadplegen]]

'''Use case diagram PDF.A 

==Use case: Sturen medische gegevens in PDF/A door patiënt==
===Doel en relevantie===
Het voor patiënten mogelijk maken regie op hun eigen gezondheid te nemen door medische informatie te delen met zorgverleners. Het is niet mogelijk om alle medische informatie direct te kunnen gestructureerd te kunnen versturen. Dit ontwerp beschrijft het uitwisselen van ongestructureerde digitale informatie in PDF/A formaat.

===Domein===
Documenten en ongestructureerde medische informatie in een PDF/A format in het domein van zorgaanbieders en patiënten.

===Context===
Het gaat om het elektronisch 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===

====Sturen van Medische gegevens in PDF/A====
Het sturen van een medische informatie gaat van een specifieke patiënt naar een specifieke organisatie in de zorg (bijvoorbeeld een zorgaanbieder).

De informatie-elementen voor het sturen van een PDF/A worden beschreven in het [http://wiki.ihe.net/index.php/Mobile_access_to_Health_Documents_(MHD) IHE MHD profiel]. Dit betreft de inhoud van de transactie waarbij het om de volgende [http://hl7.org/fhir/STU3 HL7 FHIR STU3] informatie modellen en [https://zibs.nl/wiki/ZIB_Hoofdpagina Zorginformatiebouwstenen] gaat:

*HL7 FHIR
** [http://hl7.org/fhir/STU3/bundle.html Bundle]
** [http://hl7.org/fhir/STU3/documentmanifest.html DocumentManifest]
** [http://hl7.org/fhir/STU3/documentreference.html DocumentReference]
** [http://hl7.org/fhir/STU3/binary.html Binary]

*Zorginformatiebouwstenen
** [https://zibs.nl/wiki/Patient-v3.1(2017NL) Patient]
** [https://zibs.nl/wiki/Zorgverlener-v3.2(2017NL) Zorgverlener]

=== 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 medische gegevens in PDF/A formaat sturen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Ontvangt medische gegevens in PDF/A formaat
|}
'''Bedrijfsrollen afspraak inzien'''

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

[[Bestand:Activity Diagram - Sturen sturen.png|Activiteitendiagram PFD/A sturen]]

'''Activiteitendiagram PDF/A sturen'''

===Procesbeschrijving===
===='Patient journey' - Roos Dalstra ====
Het verhaal van de 'patient journey' van Roos vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Hieronder een voor Roos relevante situatie waarbij het sturen van een PDF/A document rol kan spelen.
<blockquote>De internist in dienst die nacht wil graag weten welke medicatie Roos gebruikt. Aangezien Roos alles netjes heeft bijgehouden in haar persoonlijke
gezondheidsomgeving kan zij het ziekenhuis haar medicatiegegevens laten zien en laten uploaden naar het ziekenhuisinformatiesysteem. Hierdoor heeft de internist
een snel en accuraat overzicht van de huidige medicatie van Roos. </blockquote>

Wanneer een XIS niet in staat is om het medicatieoverzicht gestructureerd te ontvangen, zou het PGO het medicatieoverzicht in een PDF/A kunnen versturen. Zo heeft de arts wel gelijk de beschikking over het medicatieoverzicht.

====Proces====
Het stuk van het proces waar het in deze use case om gaat is:
*Het systeem van een patiënt (PGO) stuurt de PDF/A naar het systeem van een zorgverlener (XIS).
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 medische gegevens in PDF/A tussen het betreffende XIS en de eigen persoonlijke gezondheidsomgeving.

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

=====Proces stappen=====
*Het systeem van de patiënt (PGO) stuurt medische gegevens in PDF/A formaat naar een XIS.
*Het systeem van de zorgaanbieder (XIS) ontvangt een PDF/A van de patiënt.

=====Post conditie=====
De patiënt heeft zijn medische gegevens in PDF/A formaat verstuurd 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;"| PDFASturend
| style="background-color: white;"| MM-1.2.0-PDS-FHIR
| style="background-color: white;"| Sturen PDF/A document naar zorgaanbieder
|-
| style="background-color: white;"| XIS
| style="background-color: white;"| PDFAOntvangend
| style="background-color: white;"| MM-1.2.0-PDO-FHIR
| style="background-color: white;"| Ontvangen PDF/A document van de patiënt
|-
|}

Zie ook onderstaande afbeelding.

[[Bestand:Component Diagram - PDFA sturen (Totaal).png |Componenten diagram PDFA sturen]]

'''Componenten diagram PDF/A Sturen'''

=== 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"|PDFA (PUSH)
|style="background-color: white;vertical-align:top;"|Sturen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.2.0-PDS-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_PDFA|PDF/A in FHIR]]

|-
|style="background-color: white;vertical-align:top;"|Ontvangen PDF/A
|style="background-color: white;vertical-align:top;"|MM-1.2.0-PDO-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 - PDFA sturen.png|Use case diagram PFD/A sturen]]

'''Use case diagram PDF/A sturen

=Functionaliteit=
PGO raadpleegt als eerste bij het XIS, de index met referenties naar documenten. PGO raadpleegt in zijn tweede stap de documenten via deze referenties onder dezelfde condities - met name autorisatie- als de raadpleging van de index. Het XIS is gehouden aan de controle van deze condities. De referenties in de index moeten dus leiden naar een locatie die onder controle staat van het betreffende XIS. Om deze controlemogelijkheid af te dwingen kan het nodig zijn dat het XIS de referentie naar het werkelijke document in opgehaalde indexgegevens vervangt door een alternatieve referentie die onder controle staat bij het XIS. Voor een PGO is een eventuele vervangen referentie transparant: het blijft een referentie die het systeem kan volgen onder dezelfde condities als het indexgegeven zelf.

De transactie "Raadplegen PDF/A" door de PGO volgt de (aangepaste) referentie naar het document. Het raadplegen via het XIS is om context en controle te houden.

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

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/projects/MM/issues/MM-49 MM-49]
| style="background-color: white;"| Beschikbaarstellen van referenties alleen via dezelfde geraadpleegde resourceserver met de benodigde autorisatie.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Functionaliteit toegevoegd voor BITS issue MM-49.
* Systeemrollen versie van 1.0.0. naar 1.1.0.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Documenthistorie toegevoegd.
* Versie toegevoegd in de titel.
|}

MedMij:Vprepub-2019.01 OntwerpPDFA

2019-03-15T10:31:00Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

MedMij:V2019.01 FHIR AllergyIntolerance

2019-03-15T10:13:45Z

Mischa Tol: /* History */

{{#customtitle:MedMij FHIR Implementation Guide AllergyIntolerance 1.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png|link=|87px |links||AllergyIntolerance]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpAllergieIntolerantie|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes a patient's use case, in a personal health record (PHR) context, for exchanging allergy and intolerance data. Functional specification of this use case is described in the [[MedMij:V2019.01_Ontwerpen| functional design wiki pages]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/allergyintolerance-clientcapabilities CapabilityStatement: Client]
| AllergyIntolerance client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/allergyintolerance-servercapabilities CapabilityStatement: Server]
| AllergyIntolerance server requirements
|}

=Use case: Retrieve AllergyIntolerance information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve AllergyIntolerance transaction is used by the PHR to retrieve allergy and intolerance information from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve AllergyIntolerance(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request allergy and intolerance information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves allergy and intolerance information to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain allergy and intolerance information, it issues a retrieve AllergyIntolerance request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's AllergyIntolerance endpoint. This search query has the following format.

<pre>
GET [base]/AllergyIntolerance
</pre>

=====Search Parameters=====
No query parameters are defined for this use case. The PHR searches on all AllergyIntolerance resources available for the patient using a HTTP GET on the AllergyIntolerance endpoint without parameters.

=====Expected Actions=====
The XIS shall process the query to discover AllergyIntolerance resources that match the patient in the context.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the allergy and intolerance medication information.

====Trigger Events====
The XIS completed processing of the Retrieve AllergyIntolerance request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any AllergyIntolerance resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the ZIB AllergyIntolerance profile. The table below shows the relevant ZIBs and their profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|}

====Expected Actions====
The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain AllergyIntolerance information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
No search parameters are defined or needed for this transaction.

=Terminology, NamingSystems, Mappings=

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].

All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpAllergieIntolerantie#Release_notes|functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes.
*Moved release notes to the functional design page. 
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 12-11-2018
| style="background-color: white;"| Added section about Terminology, NamingSystems, Mappings.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history.
|}

[[categorie:MedMij FHIR Use Cases]]

MedMij:Vprepub-2019.01 FHIR AllergyIntolerance

2019-03-15T10:13:45Z

Mischa Tol: /* History */

MedMij:V2019.01 FHIR AllergyIntolerance

2019-03-15T10:12:53Z

Mischa Tol: /* History */ Correctie pagina historie

{{#customtitle:MedMij FHIR Implementation Guide AllergyIntolerance 1.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png|link=|87px |links||AllergyIntolerance]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpAllergieIntolerantie|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes a patient's use case, in a personal health record (PHR) context, for exchanging allergy and intolerance data. Functional specification of this use case is described in the [[MedMij:V2019.01_Ontwerpen| functional design wiki pages]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/allergyintolerance-clientcapabilities CapabilityStatement: Client]
| AllergyIntolerance client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/allergyintolerance-servercapabilities CapabilityStatement: Server]
| AllergyIntolerance server requirements
|}

=Use case: Retrieve AllergyIntolerance information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve AllergyIntolerance transaction is used by the PHR to retrieve allergy and intolerance information from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve AllergyIntolerance(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request allergy and intolerance information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves allergy and intolerance information to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain allergy and intolerance information, it issues a retrieve AllergyIntolerance request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's AllergyIntolerance endpoint. This search query has the following format.

<pre>
GET [base]/AllergyIntolerance
</pre>

=====Search Parameters=====
No query parameters are defined for this use case. The PHR searches on all AllergyIntolerance resources available for the patient using a HTTP GET on the AllergyIntolerance endpoint without parameters.

=====Expected Actions=====
The XIS shall process the query to discover AllergyIntolerance resources that match the patient in the context.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the allergy and intolerance medication information.

====Trigger Events====
The XIS completed processing of the Retrieve AllergyIntolerance request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any AllergyIntolerance resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the ZIB AllergyIntolerance profile. The table below shows the relevant ZIBs and their profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|}

====Expected Actions====
The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain AllergyIntolerance information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
No search parameters are defined or needed for this transaction.

=Terminology, NamingSystems, Mappings=

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].

All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpAllergieIntolerantie#Release_notes|functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes.
*Moved release notes to the functional design page. 
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 12-11-2018
| style="background-color: white;"| Added section about Terminology, NamingSystems, Mappings
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history
|}

[[categorie:MedMij FHIR Use Cases]]

MedMij:Vprepub-2019.01 FHIR AllergyIntolerance

2019-03-15T10:12:53Z

Mischa Tol: /* History */ Correctie pagina historie

{{#customtitle:MedMij FHIR Implementation Guide AllergyIntolerance 1.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:Allergie.png|link=|87px |links||AllergyIntolerance]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpAllergieIntolerantie|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

__TOC__

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes a patient's use case, in a personal health record (PHR) context, for exchanging allergy and intolerance data. Functional specification of this use case is described in the [[MedMij:V2019.01_Ontwerpen| functional design wiki pages]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/allergyintolerance-clientcapabilities CapabilityStatement: Client]
| AllergyIntolerance client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/allergyintolerance-servercapabilities CapabilityStatement: Server]
| AllergyIntolerance server requirements
|}

=Use case: Retrieve AllergyIntolerance information=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve AllergyIntolerance transaction is used by the PHR to retrieve allergy and intolerance information from the XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve AllergyIntolerance(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request allergy and intolerance information from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve AllergyIntolerance response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves allergy and intolerance information to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain allergy and intolerance information, it issues a retrieve AllergyIntolerance request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's AllergyIntolerance endpoint. This search query has the following format.

<pre>
GET [base]/AllergyIntolerance
</pre>

=====Search Parameters=====
No query parameters are defined for this use case. The PHR searches on all AllergyIntolerance resources available for the patient using a HTTP GET on the AllergyIntolerance endpoint without parameters.

=====Expected Actions=====
The XIS shall process the query to discover AllergyIntolerance resources that match the patient in the context.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the allergy and intolerance medication information.

====Trigger Events====
The XIS completed processing of the Retrieve AllergyIntolerance request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any AllergyIntolerance resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the ZIB AllergyIntolerance profile. The table below shows the relevant ZIBs and their profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|}

====Expected Actions====
The PHR processes the results according to application-defined rules. The PHR should be robust as the response may contain AllergyIntolerance information resources as mentioned in the former section.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve medication information transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
No search parameters are defined or needed for this transaction.

=Terminology, NamingSystems, Mappings=

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].

All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpAllergieIntolerantie#Release_notes|functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes.
*Moved release notes to the functional design page. 
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 12-11-2018
| style="background-color: white;"| Added section about Terminology, NamingSystems, Mappings
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history
|}

[[categorie:MedMij FHIR Use Cases]]

MedMij:V2019.01 OntwerpAllergieIntolerantie

2019-03-15T10:11:37Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

{{#customtitle:Functioneel Ontwerp AllergieIntolerantie 1.1.0}}
{{MedMij:V2019.01_Issuebox}}

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

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor het raadplegen van allergie en intolerantie gegevens door een patiënt. De overkoepelende inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2019.01_Ontwerpen| hier]] gevonden worden. Dit functioneel ontwerp is een toevoeging op de informatie standaard [https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]. In [https://informatiestandaarden.nictiz.nl/wiki/mp:V6.12.3_Ontwerp_medicatieproces#Transactie_Condities_opvragen Medicatieproces v6.12.x] wordt beschreven hoe contra-indicaties, allergie en intolerantie gegevens tussen zorgverleners uitgewisseld worden. Dit ontwerp beschrijft hoe de patiënt allergie en intolerantie gegevens in een PGO kan inzien.

Voor uitwisseling van allergie en intolerantie gegevens worden de volgende ZIB's gebruikt:

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

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

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

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

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

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

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

=== Domein ===
Allergie en intolerantie gegevens in het domein van zorgaanbieders en patiënten.

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

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===

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

====Beschikbaarstellen AllergieIntolerantiegegevens====
De volgende zorginformatiebouwstenen definiëren de informatie-elementen die van toepassing zijn:
*Patiënt
*Zorgverlener
*Zorgaanbieder
*AllergieIntolerantie

Dit betreft de inhoud van de transactie opleveren van allergie en intolerantiegegevens.

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

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

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

[[Image:Activity_Diagram_-_AllergieIntolerantiegegevens_.jpg|Activiteitendiagram Raadplegen AllergieIntolerantiegegevens]]

'''Activiteitendiagram Raadplegen AllergieIntolerantiegegevens'''

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

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

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

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

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

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

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

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

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

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

=== Systemen & Systeemrollen ===
Zowel de persoon als de zorgaanbieder maken ieder gebruik van een informatiesysteem:
* XIS (zorgaanbieder)
* PGO (patiënt)
Deze systemen kennen ieder verschillende systeemrollen, die het uitwisselen van gegevens tussen deze systemen mogelijk maken. Hier gaat het om de allergie en intolerantie gegevens van zorgaanbieder naar de persoon. De kwalificatie van informatiesystemen vindt plaats op basis van systeemrollen.

Het PGO van de persoon vervult de volgende systeemrol:
* AllergyIntolerantiegegevensRaadplegend Systeem in FHIR [MM-1.1.0-AIR-FHIR].

Het XIS van de zorgaanbieder vervult in deze use case de volgende systeemrol:
* AllergyIntolerantiegegevensBeschikbaarstellend Systeem in FHIR [MM-1.1.0-AIB-FHIR].

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

'''Componenten diagram van systemen en systeemrollen'''

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''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"|AllergieIntolerantie gegevens (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen AllergieIntolerantie gegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.0-AIR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen AllergieIntolerantie gegevens
|style="background-color: white;vertical-align:top;"|MM-1.1.0-AIB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

[[Bestand:Use_Case_Diagram_-_AllergieIntolerantiegegevens_.jpg|Use case diagram inzien AllergieIntolerantiegegevens]]

'''Use case diagram inzien AllergieIntolerantiegegevens

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.0.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-52 MM-52]
| style="background-color: white;"| AllergyIntolerantie filter op medicatieproces conditie geldigheidstermijn niet nodig
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpAllergieIntolerantie

2019-03-15T10:11:37Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

MedMij:V2019.01 FHIR LaboratoryResults

2019-03-15T10:02:00Z

Mischa Tol: /* History */ Correctie pagina historie

{{#customtitle:MedMij FHIR Implementation Guide LaboratoryResults 1.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
[[Bestand:LabResults@2x.png|87px|links|Use case Medication|Medication process]]
<imagemap>Bestand:Leeswijzer-technisch-banner 03 white.png|center|400px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2019.01_OntwerpLabresult|Functioneel]]
circle 1787 230 212 [[MedMij:V2019.01_FHIR_IG|Technisch]]
desc none
</imagemap>

=Introduction=
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

This page describes patient's use cases for the retrieval of laboratory results, in a personal health environment (PHR) context. Functional specifications are described at the [[MedMij:V2019.01_Ontwerpen| functional design wiki page]]. The technical specification is described here. HL7 FHIR STU3 is used for this purpose.

Many laboratory result observations have important relationships to other observations and need to be grouped together. [http://hl7.org/fhir/observation.html#10.1.4.1 The FHIR specification] defines three structures to do this: DiagnosticReport and DiagnosticReport.result, Observation and Observation.component, and Observation and Observation.related. For the transactions of laboratory results retrieval, the following two grouping structures are relevant.

====Observation====
Individual laboratory results are represented by Observation resources, such as one blood glucose value. The Observation resource can also be used as a structure for a panel or battery observation. Observation.related is used for any supporting result that can be interpreted and used on its own and has one or more different values for method, observation, performer, device, time, and/or error conditions. The top-level observation specifies the grouping code in Observation.code, but typically does not have its own Observation.value, and the set of member observations are listed in the Observation.related element.

====DiagnosticReport====
In contrast to the Observation resource, the DiagnosticReport resource typically includes additional clinical context and some mix of atomic results, images, imaging reports, textual and coded interpretation, and formatted representations. Report conclusions can be expressed as a simple text blob, structured coded data or as an attached fully formatted report such as a PDF. The DiagnosticReport.code names the panel and serves as the grouping element, which is traditionally referred to as a "panel" or "battery" by laboratories. The DiagnosticReport.result element references the individual observations.

Both structures may exist in a XIS. Therefore, two transactions are defined to retrieve a patient's laboratory results. The transaction content either consists of a single and related laboratory results structure or a complete diagnostic report that adds more clinical meaning to the single and related laboratory results. The transactions:

* [[MedMij:V2019.01_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results| Retrieve laboratory results]]
* [[MedMij:V2019.01_FHIR_LaboratoryResults#Use_case:_retrieve_laboratory_results_DiagnosticReport| Retrieve laboratory results DiagnosticReport]]

=Actors involved=
{| class="wikitable"
! colspan="2" style="text-align:left;" | Persons
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/labresults-clientcapabilities CapabilityStatement: Client]
| LaboratoryResults process client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/labresults-servercapabilities CapabilityStatement: Server]
| LaboratoryResults server requirements
|}

=Use case: retrieve laboratory results=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory results transaction is used by the PHR to retrieve laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory results from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory results response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory results to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory results, it issues a retrieve laboratory results request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's Observation endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/Observation?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/observation.html#search Observation].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | Observation
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| Obtained date/time. If the obtained element is a period, a date that falls in the period.
|-
|category
|token
|The classification of the type of observation.
|}

=====Search on fixed category code=====
To distinguish the ZIB LaboratoryTestResults Observations from other Observation resources, such as ZIB DrugUse observations, a fixed category code has been added to the ZIB LaboratoryTestResults profile. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult Observations this category code is SNOMED code '49581000146104' - Laboratory test finding (finding).

=====Including other resources in search results=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or Specimen resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example is shown below.

=====Example search URLs=====

<pre>
1. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104
2. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/Observation?category=http://snomed.info/sct|49581000146104&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/Observation?_include=Observation:specimen&category=http://snomed.info/sct|49581000146104date=ge2010-01-01&date=le2011-12-31</pre>

# Retrieves all ZIB LaboratoryTestResults Observation resources
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResults Observation resources that have an effective date within a 2 year period and includes Specimen information in the search results.

=====Expected Actions=====
The XIS shall process the query to discover Observation resources that match the search parameters given.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching observation information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory results request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any observation resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile|
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain observation and specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed for this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results or vital signs. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter type needs to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
{| class=wikitable
! Parameter !! Type !! Description
|-
| [http://hl7.org/fhir/STU3/search.html#include _include] || || To request inclusion of indicated resources, referenced from the Laboratory Results
|-
| [http://hl7.org/fhir/STU3/observation.html#search date] || [http://hl7.org/fhir/STU3/search.html#date date] || Obtained date/time. If the obtained element is a period, a date that falls in the period
|}

==Examples==

=Use case: retrieve laboratory results DiagnosticReport=
{{FHIR-IG-Afsprakenstelsel-Note}}

==Introduction==
The retrieve laboratory diagnostic report transaction is used by the PHR to retrieve laboratory results from a XIS.

==Actors==
{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transaction group'''
! style="text-align:left;"| '''Transaction'''
! style="text-align:left;"| '''Actor'''
! style="text-align:left;"| '''Role'''
|-
|style="background-color: white;vertical-align:top;" rowspan="3"|Retrieve Laboratory Results(PULL)
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report request
|style="background-color: white;vertical-align:top;"|Patient (using a PHR)
|style="background-color: white;vertical-align:top;"|Request laboratory diagnostic report from the XIS
|-
|style="background-color: white;vertical-align:top;"|Retrieve laboratory diagnostic report response
|style="background-color: white;vertical-align:top;"|Healthcare professional (using a XIS)
|style="background-color: white;vertical-align:top;"|Serves laboratory diagnostic report to the PHR
|}

==Invocations==
===PHR: request message===
The request message represents an HTTP GET parameterized query from the PHR to the XIS.

====Trigger Events====
When the patient(PHR) wants to obtain laboratory diagnostic report, it issues a retrieve laboratory diagnostic report request message.

====Message Semantics====
The PHR executes an HTTP GET conform to the FHIR [http://hl7.org/fhir/http.html RESTfull] and [http://hl7.org/fhir/search.html search] specification against the XIS's DiagnosticReport endpoint. This search query URL is configurable by the PHR and has the following format.

<pre>
GET [base]/DiagnosticReport?[parameters]{&_format=[mime-type]}
</pre>

=====Search Parameters=====
The PHR may supply, and the XIS shall be capable of processing, all query parameters listed below. These search parameters are a selection of the defined search parameters by the HL7 FHIR specification search parameters of [http://hl7.org/fhir/STU3/diagnosticreport.html#search DiagnosticReport].

{| class="wikitable"
! colspan="3" style="font-weight: bold; text-align:left;" | DiagnosticReport
|-
| style="font-weight: bold;" | Name
| style="font-weight: bold;" | Type
| style="font-weight: bold;" | Description
|-
| date
| date
| The clinically relevant time of the report.
|-
| category
| token
| Which diagnostic discipline/department created the report.
|}

=====Search on ZIB LaboratoryTestResult DiagnosticReport=====
A fixed category code has been added to the ZIB LaboratoryTestResults profile to distinguish the ZIB LaboratoryTestResult DiagnosticReports between other DiagnosticReport resources. This fixed category code is solely used for indexing and retrieval of the ZIB building blocks. For LaboratoryTestResult DiagnosticReport this category is SNOMED code '4241000179101' - Laboratory report (record artifact).

=====Including other resources in searchresults=====
The PHR may request that the XIS return resources related to the search results, in order to reduce the overall network delay of repeated retrievals of related resources. This is useful when the PHR is searching on a clinical resource, but for every such resource returned, the client will also need for example the subject (Patient resource) or performer (Organization / Practitioner resource) or the Observation resource that the clinical resource refers to. The client can use the _include parameter to indicate that the subject resources be included in the results. An example is shown below.

=====Example search URLs=====
<pre>
1. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101
2. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01
3. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&date=ge2010-01-01&date=le2011-12-31
4. GET https://vonk.test-nictiz.nl/DiagnosticReport?category=http://snomed.info/sct|4241000179101&include=DiagnosticReport:result&date=ge2010-01-01&date=le2011-12-31 </pre>

# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date greater than 01-01-2010.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period.
# Retrieves all ZIB LaboratoryTestResult DiagnosticReport resources that have an effective date within a 2 year period and include the referenced Observation resources in the search results.

=====Expected Actions=====
The XIS shall process the query to discover DiagnosticReport resources that match the search parameters given.

===XIS: response message===
The XIS returns an HTTP Status code appropriate to the processing as well as a FHIR Bundle including the matching laboratory diagnostic report information.

====Trigger Events====
The XIS completed processing of the retrieve laboratory diagnostic report request message.

====Message Semantics====
Based on the query results, the XIS will either return an error or success. When the XIS needs to report an error, it SHALL use HTTP error response codes and SHOULD include a FHIR OperationOutcome resource with more details on the failure. If the request message is processed successfully, whether or not any DiagnosticReport resources are found, the HTTP status code SHALL be 200.

The response message shall be a Bundle resource of type "searchset" containing zero or more FHIR resources as entries. If the XIS is sending warnings, the Bundle resource SHALL also contain a FHIR OperationOutcome resource that contains those warnings. The FHIR specification describes the relevant sections:
*[http://hl7.org/fhir/STU3/http.html RESTful API framework]
*[http://hl7.org/fhir/STU3/search.html#errors Search errors]
*[http://hl7.org/fhir/STU3/bundle.html Bundle resource]
*[http://hl7.org/fhir/operationoutcome.html OperationOutcome resource]

=====Message resource content=====
The returned data to the PHR should conform to the profiles listed in the table below. This table shows the relevant ZIBs and their related profiles. The resources in the response message SHALL be a valid instance of these profiles. All resources SHALL include their related profile canonical URL in the ''meta.profile'' element in order to show compliance.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" width="1400px"
|-style="background-color: #1F497D; color: white; font-weight: bold; "
|ZIB name NL||ZIB name EN||FHIR Resource||URL profile|
|-style="vertical-align:top; background-color: #E3E3E3;
|-
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| Zorgverlener
| HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| rowspan="3" | LaboratoriumUitslag
| rowspan="3" | LaboratoryTestResult
| DiagnosticReport
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-DiagnosticReport http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-DiagnosticReport]
|-
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|}

====Expected Actions====
The PHR shall process the results according to application-defined rules. The PHR should be robust as the response may contain DiagnosticReport, Observation and Specimen resources that match the query parameters.

==Interactions, operations, search parameters==
===Interactions===
The following logical interactions are needed for the retrieve laboratory results transaction:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
No operations are defined or needed for this transaction.

===Search parameters===
The following search parameter types need to be supported for this transaction.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
* [http://hl7.org/fhir/STU3/search.html#date date]

Search result parameters:
{| class=wikitable
! Parameter !! Type !! Description
|-
| [http://hl7.org/fhir/STU3/search.html#include _include] || || To request inclusion of indicated resources, referenced from the Laboratory Results
|-
| [http://hl7.org/fhir/STU3/diagnosticreport.html#search date] || [http://hl7.org/fhir/STU3/search.html#date date] || The clinically relevant time of the report
|}

=Terminology, NamingSystems, Mappings=

===Terminology===
Relevant ValueSets can be found through the ValueSet bindings in the listed StructureDefinitions. All ValueSets can be found here [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet here] and can be downloaded as a .zip in XML or JSON format.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem here].

===Mappings===
A FHIR ConceptMap resource is provided when a FHIR value set is used instead of a HCIM value set. A ConceptMap maps the values between the two value sets. These ConceptMaps can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap here].

All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpLabresult#Release_notes| functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes
*Moved release notes to functional design page.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 12-11-2018
| style="background-color: white;"| Added section "Terminology, NamingSystems, Mappings".
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history.
|}

[[categorie:MedMij FHIR Use Cases]]

MedMij:Vprepub-2019.01 FHIR LaboratoryResults

2019-03-15T10:02:00Z

Mischa Tol: /* History */ Correctie pagina historie

MedMij:V2019.01 OntwerpLabresult

2019-03-15T10:00:52Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

{{#customtitle:Functioneel Ontwerp Laboratoriumresultaten 1.1.0}}
{{MedMij:V2019.01_Issuebox}}

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

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

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

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

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

Zoals [[MedMij:V2019.01_Ontwerpen|op deze pagina]] aangegeven, gebruikt MedMij de BGZ en de bijbehorende ZIB's als leidraad voor de uitwisseling van informatie. Voor uitwisseling van laboratoriumresultaten gaat het om de volgende ZIB's:
*Patiënt;
*Zorgaanbieder;
*Zorgverlener;
*OverdrachtLaboratoriumUitslag.

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

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

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

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

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.

=Use Cases=

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

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

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

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

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

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

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

Dit betreft de inhoud van ieder laboratoriumresultaat.

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

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

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

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

'''Activiteitendiagram Raadplegen laboratoriumresultaten'''

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

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

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

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

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

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

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

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

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

Deze systemen hebben één of meer systeemrollen. Een systeemrol maakt het uitwisselen van bepaalde gegevens mogelijk. Hier gaat het om laboratoriumresultaten van zorgaanbieder / laboratorium naar patiënt.

Een XIS vervult in deze use case de volgende systeemrol:
* LaboratoriumresultaatBeschikbaarstellend Systeem [LAB-1.1.0-LRB-FHIR]

Een PGO vervult de volgende systeemrol:
* LaboratoriumresultaatRaadplegend Systeem [LAB-1.1.0-LRR-FHIR].

Zie ook onderstaande afbeelding.

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

'''Componenten diagram'''

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;"| '''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"|Laboratoriumresultaten (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.1.0-LRR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen laboratoriumresultaten
|style="background-color: white;vertical-align:top;"|LAB-1.1.0-LRB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder (laboratorium)
|}

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

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

'''Use case diagram

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"| AUTEUR(S)
| style="background-color: white;"| TITEL
| style="background-color: white;"| VERSIE
| style="background-color: white;"| DATUM
| style="background-color: white;"| BRON
| style="background-color: white;"| ORGANISATIE
|}
'''Referenties

=Bijlage: Documenthistorie=

==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 5; style="background-color: white;"| 2019.01
| rowspan = 5; style="background-color: white;"| 1.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-112 MM-112]
| style="background-color: white;"| Verwijzing in §2.4.1.2 naar zib OverdrachtLaboratoriumuitslag v1.2.2 (release 2015) gewijzigd in zib Laboratoriumuitslag v4.1 (release 2017). In het technisch ontwerp en FHIR-profielen werd deze al toegepast.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-108 MM-108]
| style="background-color: white;"| use-case Collect (from XIS to PGO).
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 1.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"| Verwijzing in §2.4.1.2 naar zib OverdrachtLaboratoriumuitslag v1.2.2 (release 2015) gewijzigd in zib Laboratoriumuitslag v4.1 (release 2017).
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
*Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"|
* Aanpassing versienummer in titel.
* Toevoeging documenthistorie.
|}

MedMij:Vprepub-2019.01 OntwerpLabresult

2019-03-15T10:00:52Z

Mischa Tol: /* Paginahistorie */ Correctie pagina historie

MedMij:V2019.01 OntwerpBGZ 2017

2019-03-15T09:31:31Z

Mischa Tol: /* Release notes */

{{#customtitle:Functioneel Ontwerp BgZ 2.1.0 (op basis van zibs release 2017)}}
{{MedMij:V2019.01_Issuebox}}
{{IssueBox|Deze pagina heeft betrekking op de BgZ release 2017. De versie van de BgZ release 2015 kan hier gevonden worden: [[MedMij:V2018.01_OntwerpBGZ_2015]]}}

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

=Inleiding=

==Algemeen==
Deze pagina beschrijft het functioneel ontwerp voor de Basisgegevensset Zorg binnen MedMij. De algemene inleiding van de MedMij functionele ontwerpen kan [[MedMij:V2019.01_Ontwerpen| hier]] gevonden worden.

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

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

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

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

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

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

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

===Specifieke informatie over deze kwalificatie===
Specifieke informatie over de kwalificatie van de transacties 'Raadplegen BgZ' en 'Beschikbaarstellen BgZ' is te vinden in [[MedMij:V2019.01_ToelichtingKwalificatieBgZ| ToelichtingKwalificatieBgZ]].

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

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

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

De beschrijving is infrastructuur-onafhankelijk.

=== Informatie ===
De [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.0.pdf BgZ op basis van zibs release 2017] bestaat uit een selectie van 28 zibs. Deze zibs vormen samen een verzameling van patiëntgegevens die minimaal nodig is om patiënten continuïteit van zorg te kunnen bieden. De Basisgegevensset Zorg is gebaseerd op de Europese Patient Summary.

Deze use case gebruikt de structuur die is aangebracht in BgZ 2017 van 18 secties waarin de onderdelen waaruit de BgZ is opgebouwd, gegroepeerd zijn. Deze secties komen sterk overeen met de secties van CCR/CCD en maken het o.a. mogelijk om in de technische implementatie (bv FHIR) structuur aan te brengen. In de MedMij FHIR implementatie gids staat de technische representatie van de betreffende zibs in zogenaamde FHIR profielen. In dit [[MedMij:V2019.01_FHIR_BGZ_2017#List_of_StructureDefinitions|overzicht]] is te zien welk FHIR profiel bij welke zib hoort.

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

{| class="wikitable" "cellpadding="10" width="100%"
! style="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 de eigen BgZ raadplegen
|-
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|style="background-color: white;vertical-align:top;"|Stelt de BgZ beschikbaar
|}
'''Bedrijfsrollen Basisgegevensset Zorg'''

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

[[Image:InzienBGZ_activity.png|Activiteitendiagram Raadplegen BgZ]]

'''Activiteitendiagram Raadplegen BgZ'''

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

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

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

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

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

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

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

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

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

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

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

Zie ook onderstaande afbeelding.

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

'''Componenten diagram van systemen en systeemrollen'''

=== Transacties & Transactiegroepen ===
Het uitwisselen van gegevens tussen de verschillende systeemrollen gebeurt op basis van transacties. Een transactiegroep is een verzameling van bij elkaar horende transacties (bijvoorbeeld een vraag- en antwoordbericht). Onderstaande tabel biedt een overzicht voor deze use case.

{| class="wikitable" "cellpadding="10"
! style="text-align:left;"| '''Transactiegroep'''
! style="text-align:left;"| '''Transactie'''
! style="text-align:left;"| '''Systeemrol'''
! style="text-align:left;"| '''Systeem'''
! style="text-align:left;"| '''Bedrijfsrol'''
! style="text-align:left;"| '''Technisch'''
|-
|style="background-color: white;vertical-align:middle;" rowspan="2"|BgZ (PULL)
|style="background-color: white;vertical-align:top;"|Raadplegen BgZ
|style="background-color: white;vertical-align:top;"|MM-2.1.0-BZR-FHIR
|style="background-color: white;vertical-align:top;"|PGO
|style="background-color: white;vertical-align:top;"|Patiënt
|style="background-color: white;vertical-align:middle;" rowspan="2"|[[MedMij:V2019.01_FHIR_BGZ_2017|BgZ in FHIR]]
|-
|style="background-color: white;vertical-align:top;"|Beschikbaarstellen BgZ
|style="background-color: white;vertical-align:top;"|MM-2.1.0-BZB-FHIR
|style="background-color: white;vertical-align:top;"|XIS
|style="background-color: white;vertical-align:top;"|Zorgaanbieder
|}

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

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

'''Use case diagram inzien BgZ

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

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

=Afschermen van gegevens=
Er zijn geen afspraken over het afschermen van gegevens.

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

=Referenties=

{| class="wikitable" "cellpadding="10" width="100%"
!style="text-align:left;"|Auteur(s)
!style="text-align:left;"|Titel
!style="text-align:left;"|Versie
!style="text-align:left;"|Datum
!style="text-align:left;"|Bron
!style="text-align:left;"|Organisatie
|-
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
| style="background-color: white;"|
|}
'''Referenties

=Bijlage: Documenthistorie=
==Release notes==

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

{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Versie
!style="text-align:left;"|BITS issue
!style="width:850px; text-align:left;"|Omschrijving
|-
| rowspan = 19; style="background-color: white;"| 2019.01
| rowspan = 19; style="background-color: white;"| 2.1.0
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-174 MM-174]
| style="background-color: white;"| Corrected search url for PlannedCareActivityForTransfer - DeviceRequest. Added an '&'.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-161 MM-161]
| style="background-color: white;"| CBV codes in ProcedureRequest.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-145 MM-145]
| style="background-color: white;"| ContactPerson verwijzing informatiestandaarden vs patient zib.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-144 MM-144]
| style="background-color: white;"| Problem zib ClinicalStatus can take on values which are not defined by the HCIM.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-143 MM-143]
| style="background-color: white;"| Aanpassing modellering Procedure.performer in het profiel voor HCIM Verrichting.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-142 MM-142]
| style="background-color: white;"| Onduidelijkheid in de modellering van de Aanvrager van een LaboratoriumUitslag.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-141 MM-141]
| style="background-color: white;"| Vital Signs profielen inconsistent m.b.t. baseDefinition.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-134 MM-134]
| style="background-color: white;"| MedicationUse StopType found values do not correspond with MedicationUseStopTypeCodeList values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-127 MM-127]
| style="background-color: white;"| TimeOfDay in InstructionsForUse and the Hapi Enumerators.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-125 MM-125]
| style="background-color: white;"| Inconsistentie wiki vs simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-118 MM-118]
| style="background-color: white;"| Profiel naam zib-Product niet passend bij Zib FarmaceutischProduct.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-115 MM-115]
| style="background-color: white;"| Solved inconsistency in the List of StructureDefinitions. Also we will no longer check PlannedCareActivityForTransfer for MedicationAdministration in section 17 Zorgplan, because we found it was unimplementable as-is. Presumed solution will come from a future HCIM release
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-100 MM-100]
| style="background-color: white;"| Mapping CBV naar SNOMED codes.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-99 MM-99]
| style="background-color: white;"| Interval heeft Period maar geen PeriodUnit op simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-98 MM-98]
| style="background-color: white;"| InstructionsForUse zib informatie model komt niet overeen met simplifier.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-94 MM-94]
| style="background-color: white;"| Specimen microorganism en specimenSource mappen naar hetzelfde fhir element.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-50 MM-50]
| style="background-color: white;"| Contact ondersteunt geen klinische contacten.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-42 MM-42]
| style="background-color: white;"| medicatiegebruik - auteur - zorgverlener: kan niet alle info kwijt.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-41 MM-41]
| style="background-color: white;"| voorschrijver/zorgverlener/zorgaanbieder past niet in medicationUse.
|-
| rowspan = 6; style="background-color: white;"| 2018.06
| rowspan = 6; style="background-color: white;"| 2.0.1
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-174 MM-174]
| style="background-color: white;"| URL voor PlannedCareActivity- DeviceRequest mist een '&'.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-128 MM-128]
| style="background-color: white;"| CanceledIndicator possible values.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-66 MM-66]
| style="background-color: white;"| Update mappings LaboratoriumUitslag in DiagnosticReport en Observation.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-55 MM-55]
| style="background-color: white;"| Profile for HCIM TobaccoUse was missing a specification for PackYears unit - profile updated to 2.0.1.
|-

| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-54 MM-54]
| style="background-color: white;"| Wrong SNOMED code in search URL for FunctionalOrMentalStatus.
|-
| style="background-color: white;"| [https://bits.nictiz.nl/browse/MM-23 MM-23]
| style="background-color: white;"| Commentaar bij dagdeel codelijst verwijst naar dode URL.
|}

==Paginahistorie==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Datum
!style="text-align:left;"|Omschrijving
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
* Wijzigingen gepubliceerd in versie 2019.01, zie release notes.
* Verplaatsing release notes naar functionele pagina.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 18-10-2018
| style="background-color: white;"| Toevoeging releasenotes en ophoging systeemrol versienummer vanwege een technische verbetering in de raadpleging van FunctioneleOfMentale gegevens.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Aanpassing versienummer in titel en documenthistorie.
|-
| style="background-color: white;vertical-align:top;"| 2018.06
| style="background-color: white;vertical-align:top;"| 30-08-2018
| style="background-color: white;"|
* Paragraaf 2.1.4, Verwijzing naar ART-DECOR toegevoegd.
* Bijlage: Documenthistorie toegevoegd.
* Paragraaf 1.4, verwijzing naar nieuwe pagina kwalificatie informatie toegevoegd.
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 16-08-2018
| style="background-color: white;"| Structuur paragraaf 1.1 t/m 1.4 toegevoegd, ter voorbereiding kwalificatie informatie.
|}

MedMij:Vprepub-2019.01 OntwerpBGZ 2017

2019-03-15T09:31:31Z

Mischa Tol: /* Release notes */

MedMij:V2019.01 FHIR BGZ 2017

2019-03-15T09:30:12Z

Mischa Tol:

{{#customtitle:MedMij FHIR Implementation Guide: BgZ 2.1.0}}
{{MedMij:V2019.01_Issuebox_FHIR_IG}}

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

__TOC__

==Introduction==
[[Bestand:Functioneel-02.png|link=MedMij:V2019.01_Ontwerpen |100px|rechts|Functional design|Go to functional design]]

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined Health and Care Information models ([https://zibs.nl/wiki/HCIM_Mainpage HCIMs] (English) or [https://zibs.nl/wiki/ZIB_Hoofdpagina ZIBs] (Dutch)) for The Netherlands. Next to these HCIMs, the program ‘Registratie aan de bron’ also made a selection of these HCIMs into the so-called ‘Basisgegevensset Zorg’ (Common Clinical Dataset, a Dutch version of a ‘patient summary’, further referred to as ‘BgZ’). The BgZ serves as a minimal healthcare dataset that is always appropriate for caregivers in order to provide continuity of care for a patient and can be seen as a representation of a patient summary.

A subselection of the published [https://zibs.nl/wiki/HCIM_Release_2017(EN) HCIMs release 2017] constitute the [https://www.registratieaandebron.nl/pdf/BgZ_specificatie_obv_zibs_2017_v1.0.pdf BgZ 2017]. The BgZ makes a subselection of the information concepts within the HCIMs or restricts the HCIMs to a certain category. For example, only include the general practitioner of the patient or only the last known value of 'X'. MedMij created FHIR profiles that represent these HCIMs completely if no existing and usable profiles were available. The profiles represent their entire respective HCIM, to make them applicable in a broader context than a patient summary or even the MedMij context. An overview of the profiles can be found at the [[MedMij:V2019.01_FHIR_BGZ_2017#List_of_StructureDefinitions|list of StructureDefinitions]].

The patient journey of [https://www.nictiz.nl/ehealth/MedMij Thomas van Beek], provides a patients context for exchanging a patient summary from a healthcare provider's system (XIS) to a personal health record (PHR). MedMij created a [https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_Ontwerpen functional design] of the BgZ use case. This use case consists of enabling a patient to view his own BgZ in a PHR. This page will elaborate further on the HL7 FHIR details needed to exchange the BgZ information using FHIR.

==Actors involved==
{| class="wikitable"
! colspan="2" style="text-align:left;" | Actors
! colspan="2" style="text-align:left;" | Systems
! colspan="2" style="text-align:left;" | FHIR Capability Statements
|-
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
! style="text-align:left;" |Name
! style="text-align:left;" |Description
|-
| Patient
| The user of a personal healthcare enviorment.
| PHR
| Personal health record
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/bgz2017-clientcapabilities CapabilityStatement: Client]
| FHIR Client requirements
|-
| Healthcare professional
| The user of a XIS
| XIS
| Healthcare information system
|[[Bestand: Verwijzing.png| 20px]] [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/CapabilityStatement/bgz2017-servercapabilities CapabilityStatement: Server]
| FHIR Server requirements
|}

==Boundaries and Relationships==
The BgZ 2017 use case follows the BgZ 1.0 use case. The difference between the two is the underlying HCIMs, which have been upgraded from release 2015 to release 2017.

Release notes can be found here:https://github.com/Nictiz/Nictiz-STU3-Zib2017/raw/master/ReleaseNotes%20FHIR%20profielen%20ZIB2017.pdf

The BgZ use case has similarities and differences with other use cases such as Medication Process, Vital Signs and Lab Results. These use cases use the same HCIM based FHIR profiles for exchanging information. The BgZ use case covers practically all profiles included in the other use cases. However, the BgZ differs in the scope of the actual health information content that should be exchanged. For example, the BgZ conveys only the last known lab result of each type while the Lab Results use case may cover all known information.

==List of invocations==
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]

This FHIR implementation guide assumes that the PHR system is able to make a connection to the XIS that contains the patients BgZ information. It does not provide information on finding the right XIS nor does it provide information about security. These infrastructure and interface specifications are described in the [https://www.medmij.nl/afsprakenstelsel/ 'Afsprakenstelsel'].

===Client - PHR===
The PHR system requests the BgZ using individual search interactions. The BgZ consists of multiple FHIR resources with certain constraints. To obtain the patient's BgZ, the client can use multiple individual search operations based on specified search queries. The interaction can be performed by an HTTP GET or command as shown:

<code>GET [base]/[type]/{?[parameters]{&_format=[mime-type]}}</code>

The table below shows in the first four columns the BgZ sections, the HCIMs that constitute those sections and the specific content of the BgZ. The last column shows the FHIR search queries to obtain the BgZ information. These queries are based on StructureDefinitions listed in [[#List_of_StructureDefinitions| this section]].

{{FHIR-IG-Afsprakenstelsel-Note}}

{| class="wikitable collapsible" width="100%" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | #
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | BgZ Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Content
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Example Search URL
|-
| 1
| Patient information
| Patient
| Identification, birthdate, gender, deceasedindicator, contact details, marital status, and general practitioner (practitioner or organization)
| <pre>GET [base]/Patient?_include=Patient:general-practitioner</pre>
|-
| 2
| Payment details
| Payer
| Insurance information
| <pre>GET [base]/Coverage?_include=Coverage:payor:Patient&_include=Coverage:payor:Organization</pre>
|-
| rowspan="2" | 3
| rowspan="2" | Treatment Directives
| TreatmentDirective
| Known treatment directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105</pre>
|-
| AdvanceDirective
| Known advance directives
| <pre>GET [base]/Consent?category=http://snomed.info/sct|11341000146107</pre>
|-
| 4
| Contactperson
| ContactPerson
| First relation/contact
| <pre style="font-style: italic;">see Patient</pre>
|-
| 5
| Functional status
| FunctionalOrMentalStatus
| Last known functional / mental status
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|118228005,http://snomed.info/sct|384821006</pre>
|-
| 6
| Problems
| Concern
| All known problems
| <pre>GET [base]/Condition</pre>
|-
| rowspan="5" | 7
| rowspan="5" | Social history
| LivingSituation
| Current living situation
| <pre>GET [base]/Observation/$lastn?code=http://snomed.info/sct|365508006</pre>
|-
| DrugUse
| All known drug use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228366006</pre>
|-
| AlcoholUse
| All known alcohol use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|228273003</pre>
|-
| TobaccoUse
| All known tobacco use
| <pre>GET [base]/Observation?code=http://snomed.info/sct|365980008</pre>
|-
| NutritionAdvice
| All known current dietary recommendations
| <pre>GET [base]/NutritionOrder?status=active</pre>
|-
| 8
| Alerts
| Alert
| All known alerts
| <pre>GET [base]/Flag</pre>
|-
| 9
| Allergies
| AllergyIntolerance
| All known information regarding allergies
| <pre>GET [base]/AllergyIntolerance</pre>
|-
| rowspan="3" | 10
| rowspan="3" | Medication
| MedicationUse
| Known medication use
| <pre>GET [base]/MedicationStatement?category=urn:oid:2.16.840.1.113883.2.4.3.11.60.20.77.5.3|6&_include=MedicationStatement:medication</pre>
|-
| MedicationAgreement
| Known medication agreements
| <pre>GET [base]/MedicationRequest?category=http://snomed.info/sct|16076005&_include=MedicationRequest:medication</pre>
|-
| AdministrationAgreement
| Known administration agreements
| <pre>GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&_include=MedicationDispense:medication</pre>
|-
| 11
| Medical aids
| MedicalAid
| All known medical aids
| <pre>GET [base]/DeviceUseStatement?_include=DeviceUseStatement:device</pre>
|-
| 12
| Vaccinations
| Vaccination
| All known vaccinations
| <pre>GET [base]/Immunization?status=completed</pre>
|-
| rowspan="3" | 13
| rowspan="3" | Vital signs
| BloodPressure
| Last known blood pressure
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|85354-9</pre>
|-
| BodyWeight
| Last known body weight
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|29463-7</pre>
|-
| BodyHeight
| Last known body height
| <pre>GET [base]/Observation/$lastn?code=http://loinc.org|8302-2,http://loinc.org|8306-3,http://loinc.org|8308-9</pre>
|-
| 14
| Results
| LaboratoryTestResult
| Last known laboratory results per type
| <pre>GET [base]/Observation/$lastn?category=http://snomed.info/sct|275711006&_include=Observation:related-target&_include=Observation:specimen</pre>
|-
| 15
| Procedures
| Procedure
| All surgical procedures
| <pre>GET [base]/Procedure?category=http://snomed.info/sct|387713003</pre>
|-
| 16
| Encounters
| Contact
| All hospital admissions (no outpatient contacts)
| <pre>GET [base]/Encounter?class=http://hl7.org/fhir/v3/ActCode|IMP,http://hl7.org/fhir/v3/ActCode|ACUTE,http://hl7.org/fhir/v3/ActCode|NONAC</pre>
|-
| rowspan="5" | 17
| rowspan="5" | Planned care
| rowspan="5" | PlannedCareActivity
| rowspan="5" | All known planned care activities <nowiki>[</nowiki> [[#MM-115|*]] <nowiki>]</nowiki>
| <pre>GET [base]/ProcedureRequest?status=active</pre>
|-
| <pre>GET [base]/ImmunizationRecommendation</pre>
|-
| <pre style="text-decoration: line-through;">GET [base]/MedicationDispense?category=http://snomed.info/sct|422037009&status=in-progress,preparation&_include=MedicationDispense:medication</pre>
|-
| <pre>GET [base]/DeviceRequest?status=active&_include=DeviceRequest:device</pre>
|-
| <pre>GET [base]/Appointment?status=booked,pending,proposed</pre>
|-
| 18
| General practitioner
| HealthProfessional
| General Practitioner of the patient
| <pre style="font-style: italic;">see Patient</pre>
|}

===Server - XIS===
Important sections of the FHIR specification for a server in this use case are the [http://hl7.org/fhir/STU3/http.html#2.21.0 RESTful API section] the [http://hl7.org/fhir/STU3/search.html search section] and [http://hl7.org/fhir/STU3/operations.html operation section] (for the nlast operation).

====Response to resource requests====
If the search succeeds, the server SHALL return a 200 OK HTTP status code and the returned content SHALL be a Bundle with type = searchset containing the results of the search as a collection of zero or more resources in a defined order. The returned content SHALL conform to the StructureDefinition applicable for the specific HCIM request. The list of a StructureDefinitions relevant for this use case is shown in the following paragraph: [[#List_of_StructureDefinitions | List of StructureDefinitions]]

The result collection can be long, so servers may use paging. If they do, they SHALL use the method described below (adapted from RFC 5005 (Feed Paging and Archiving ) for breaking the collection into pages if appropriate. The server MAY also return an [http://hl7.org/fhir/stu3/operationoutcome.html OperationOutcome resource] within the searchset Bundle entries that contains additional information about the search; if one is sent it SHALL NOT include any issues with a fatal or error severity, and it SHALL be marked with a Bundle.entry.search.mode of outcome.

In order to allow the client to be confident about what search parameters were used as criteria by the server, the server SHALL return the parameters that were actually used to process the search. Applications processing search results SHALL check these returned values where necessary. For example, if the server did not support some of the filters specified in the search, a client might manually apply those filters to the retrieved result set, display a warning message to the user or take some other action.

In the case of a RESTful search, these parameters are encoded in the self-link in the bundle that is returned:
<pre>
<link>
<relation value="self"/>
<url value="http://example.org/Patient?identifier=[Patient-ID]/>
</link>
</pre>

Link to the relevant FHIR specification: http://hl7.org/fhir/STU3/http.html#search

====Handling errors====
If the search fails '''(cannot be executed, not that there are no matches)''', the return value is a status code 4xx or 5xx with an OperationOutcome. An HTTP status code of 403 signifies that the server refused to perform the search, while other 4xx and 5xx codes signify that some sort of error has occurred. The HTTP status code 404 is returned if a XIS did not implement an endpoint used in a request by a PHR. When the search fails, a server SHOULD return an OperationOutcome detailing the cause of the failure. For example, in case of a not implemented FHIR endpoint, the OperationOutcome would state that the resource type is not supported. Note: an empty search result is not a failure.

Common HTTP Status codes returned on FHIR-related errors (in addition to normal HTTP errors related to security, header and content type negotiation issues):

* 400 Bad Request - search could not be processed or failed basic FHIR validation rules
* 401 Not Authorized - authorization is required for the interaction that was attempted
* 404 Not Found - resource type not supported, or not a FHIR end-point

In some cases, parameters may cause an error. For instance:

* A parameter may refer to a non-existent resource e.g. <code>GET [base]/Observation?subject=101</code>, where "101" does not exist
* A parameter may refer to an unknown code e.g. <code>GET [base]/Observation?code=loinc|1234-1</code>, where the LOINC code "1234-1" is not known to the server
* A parameter may refer to a time that is out of scope e.g. <code>GET [base]/Condition?onset=le1995</code>, where the system only has data going back to 2001
* A parameter may use an illegal or unacceptable modifier e.g. <code>GET [base]/Condition?onset:text=1995</code>, where the modifier cannot be processed by the server
* A data time parameter may have incorrect format e.g. <code>GET [base]/Condition?onset=23%20May%202009</code>
* A parameter may be unknown or unsupported
Where the content of the parameter is syntactically incorrect, servers SHOULD return an error. However, where the issue is a logical condition (e.g. unknown subject or code), the server SHOULD process the search, including processing the parameter - with the result of returning an empty search set, since the parameter cannot be satisfied.

In such cases, the search process MAY include an OperationOutcome in the search set that contains additional hints and warnings about the search process. This is included in the search results as an entry with search mode = outcome. Clients can use this information to improve future searches.

Link to relevant FHIR specification: http://hl7.org/fhir/STU3/search.html#errors

==Interactions, operations, search parameters==

===Interactions===

The following logical interactions are needed for the BgZ use case:
* [http://hl7.org/fhir/STU3/http.html#search Search]

===Operations===
The following [http://hl7.org/fhir/STU3/operations.html operation] is needed for this use case.
* [http://hl7.org/fhir/STU3/observation-operations.html#lastn Last N Observations Query]

The lastn query meets the common need for searching for the most recent or last n=number of observations for a subject. For example, retrieving the last 5 temperatures for a patient to view trends or fetching the most recent laboratory results or vital signs. The link will provide more detailed information and examples regarding this operation.

===Search parameters===
The following search parameter types and search result parameters need to be supported for this use case.

Search parameter types:
* [http://hl7.org/fhir/STU3/search.html#token token]
** Including modifier 'in'
* [http://hl7.org/fhir/STU3/search.html#reference reference]

Search result parameters:
* [http://hl7.org/fhir/STU3/search.html#include _include]
* [http://hl7.org/fhir/STU3/search.html#include _revinclude]

==List of StructureDefinitions==
The profiles represent their entire respective HCIM, to make them applicable in a broader context than the exchange of BgZ or a MedMij context. An example of reuse of existing profiles are those of the patient administration resources and vital signs.

{{NoteBoxPackage|https://simplifier.net/packages/nictiz.fhir.nl.stu3.zib2017/1.1.0|1.1.0|MedMij:V2019.01_FHIR_IG}}

{| class="wikitable" style="horizontal-align: right"
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:10px" | Section
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | ZIB NL
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | HCIM EN
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:100px" | FHIR Resource
!style="background-color: #4AB8A7; color: white; font-weight: bold; text-align:left; background-color: #E3E3E3 width:400px" | FHIR Profile
|-
| 01
| Patient
| #ZIB Patient|Patient
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="3" |02
| rowspan="3" | Betaler
| rowspan="3" | Payer
| Coverage
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Payer http://nictiz.nl/fhir/StructureDefinition/zib-Payer]
|-
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|-
| Patient
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| rowspan="2" |03
| BehandelAanwijzing
| TreatmentDirective
| Consent
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective http://nictiz.nl/fhir/StructureDefinition/zib-TreatmentDirective]
|-
| Wilsverklaring
| AdvanceDirective
| Consent
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective http://nictiz.nl/fhir/StructureDefinition/zib-AdvanceDirective]
|-
| 04
| Contactpersoon
| ContactPerson
| Patient.contact
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-patient http://fhir.nl/fhir/StructureDefinition/nl-core-patient]
|-
| 05
| Funct. OfMentaleStatus
| FunctionalOrMentalStatus
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus http://nictiz.nl/fhir/StructureDefinition/zib-FunctionalOrMentalStatus]
|-
| 06
| Probleem
| Problem
| Condition
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Problem http://nictiz.nl/fhir/StructureDefinition/zib-Problem]
|-
| rowspan="5" | 07
| Woonsituatie
| LivingSituation
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation http://nictiz.nl/fhir/StructureDefinition/zib-LivingSituation]
|-
| DrugsGebruik
| DrugUse
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse http://nictiz.nl/fhir/StructureDefinition/zib-DrugUse]
|-
| AlcoholGebruik
| AlcoholUse
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse http://nictiz.nl/fhir/StructureDefinition/zib-AlcoholUse]
|-
| TabakGebruik
| TobaccoUse
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse http://nictiz.nl/fhir/StructureDefinition/zib-TobaccoUse]
|-
| Voedingsadvies
| NutritionAdvice
| NutritionOrder
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-NutritionAdvice http://nictiz.nl/fhir/StructureDefinition/zib-NutritionAdvice]
|-
| 08
| Alert
| Alert
| Flag
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Alert http://nictiz.nl/fhir/StructureDefinition/zib-Alert]
|-
| 09
| AllergieIntolerantie
| AllergyIntolerance
| AllergyIntolerance
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance http://nictiz.nl/fhir/StructureDefinition/zib-AllergyIntolerance]
|-
| rowspan="3" | 10
| rowspan="3" | MedicatieGebruik
| MedicationUse
| MedicationStatement
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse http://nictiz.nl/fhir/StructureDefinition/zib-MedicationUse]
|-
| MedicationAgreement
| MedicationRequest
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-MedicationAgreement]
|-
| AdministrationAgreement
| MedicationDispense
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| rowspan="2" | 11
| rowspan="2" | MedischHulpmiddel
| rowspan="2" | MedicalDevice
| Device
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceProduct]
|-
| DeviceUseStatement
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDevice http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDevice]
|-
| rowspan="2" | 12
| rowspan="2" | Vaccinatie
| rowspan="2" | Vaccination
| Immunization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination http://nictiz.nl/fhir/StructureDefinition/zib-Vaccination]
|-
| ImmunizationRecommendation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| rowspan="3" | 13
| Bloeddruk
| BloodPressure
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure http://nictiz.nl/fhir/StructureDefinition/zib-BloodPressure]
|-
| LichaamsGewicht
| BodyWeight
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyWeight]
|-
| LichaamsLengte
| BodyHeight
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight http://nictiz.nl/fhir/StructureDefinition/zib-BodyHeight]
|-
| rowspan="2" | 14
| rowspan="2" | LaboratoriumUitslag
| rowspan="2" | LaboratoryTestResult
| Observation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Observation]
|-
| Specimen
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen http://nictiz.nl/fhir/StructureDefinition/zib-LaboratoryTestResult-Specimen]
|-
| 15
| Verrichting
| Procedure
| Procedure
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Procedure http://nictiz.nl/fhir/StructureDefinition/zib-Procedure]
|-
| 16
| Contact
| Encounter
| Encounter
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-Encounter http://nictiz.nl/fhir/StructureDefinition/zib-Encounter]
|-
| rowspan="5" | 17
| rowspan="5" | GeplandeZorgActiviteit
| rowspan="5" | PlannedCareActivity
| ProcedureRequest
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest http://nictiz.nl/fhir/StructureDefinition/zib-ProcedureRequest]
|-
| MedicationDispense <nowiki>[</nowiki> [[#MM-115|*]] <nowiki>]</nowiki>
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement http://nictiz.nl/fhir/StructureDefinition/zib-AdministrationAgreement]
|-
| ImmunizationRecommendation
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation http://nictiz.nl/fhir/StructureDefinition/zib-VaccinationRecommendation]
|-
| DeviceRequest
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceRequest http://nictiz.nl/fhir/StructureDefinition/zib-MedicalDeviceRequest]
|-
| Appointment
| [https://simplifier.net/resolve?target=simplifier&canonical=http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment http://nictiz.nl/fhir/StructureDefinition/eAfspraak-Appointment]
|-
| rowspan="3" | 18
| rowspan="2" | Zorgverlener
| rowspan="2" | HealthProfessional
| Practitioner
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner http://fhir.nl/fhir/StructureDefinition/nl-core-practitioner]
|-
| PractitionerRole
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole http://fhir.nl/fhir/StructureDefinition/nl-core-practitionerrole]
|-
| Zorgaanbieder
| HealthcareProvider
| Organization
| [https://simplifier.net/resolve?target=simplifier&canonical=http://fhir.nl/fhir/StructureDefinition/nl-core-organization http://fhir.nl/fhir/StructureDefinition/nl-core-organization]
|}

==Terminology, NamingSystems, Mappings==

===Terminology===
Relevant value sets can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ValueSet using the ValueSet category]. All resources can be downloaded in a .zip in XML or JSON format. In the .zip, the value sets are stored in the directory 'value sets'.

===NamingSystems===
Relevant NamingSystems can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=NamingSystem using the NamingSystem category].

===Mappings===
Relevant HCIM to FHIR value set mappings can be found [https://simplifier.net/NictizSTU3-Zib2017/~resources?category=ConceptMap using the ConceptMap category].
All profiles include HCIM mappings. HCIM concepts are mapped to the corresponding FHIR elements using the HCIMs concept id. The top of the StructureDefinition contains meta information regarding the HCIM mapping, such as the name and uri of the HCIM. In the StructureDefinition elements, the corresponding HCIM ID is given including the mapping meta information id. This is illustrated in the following example.

<pre>
<StructureDefinition>
<id value="nl-core-patient" />
.....
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<uri value="https://zibs.nl/wiki/Patient-v3.1(2017EN)"/>
<name value="HCIM Patient-v3.1(2017EN)"/>
</mapping>
.....
<element id="Patient.name">
<path value="Patient.name" />
<short value="NameInformation" />
<alias value="Naamgegevens" />
<type>
<code value="HumanName" />
<profile value="http://fhir.nl/fhir/StructureDefinition/nl-core-humanname" />
</type>
<mapping>
<identity value="hcim-patient-v3.1-2017EN"/>
<map value="NL-CM:0.1.6"/>
</mapping>
</element>
.....
</StructureDefinition>
</pre>

=Annex: Document history=
==Release notes==
Release notes can be found on the [[MedMij:V2019.01_OntwerpBGZ_2017#Release_notes|functional design page]].

==History==
{| class="wikitable" "cellpadding="10"
!style="text-align:left;"|Release
!style="text-align:left;"|Date
!style="text-align:left;"|Description
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"| '''*''' [https://bits.nictiz.nl/browse/MM-115 MM-115] Solved inconsistency in the List of StructureDefinitions. Also we will no longer check PlannedCareActivityForTransfer for MedicationAdministration in section 17 Zorgplan, because we found it was unimplementable as-is. Presumed solution will come from a future HCIM release
|-
| style="background-color: white;"| 2019.01
| style="background-color: white;"| 11-03-2019
| style="background-color: white;"|
*Publication of changes in version 2019.01, conform release notes
*Moved release notes to functional design page
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 18-10-2018
| style="background-color: white;"| Corrected SNOMED code in search url for FunctionalOrMantalStatus
|-
| style="background-color: white;"| 2018.06
| style="background-color: white;"| 15-10-2018
| style="background-color: white;"| Added version in title, and document history
|}
[[categorie:MedMij FHIR Use Cases]]

MedMij:Vprepub-2019.01 FHIR BGZ 2017

2019-03-15T09:30:12Z

Mischa Tol: