informatiestandaarden - Gebruikersbijdragen [nl]

MedMij:V2017.04 Ontwerp

2022-06-08T11:11:35Z

Cevin Krooneman: MMTM-304 obsolete melding in NL

{{DISPLAYTITLE:Ontwerpen MedMij, publicatie 2017.04|Functioneel Ontwerpen}}
{{MedMij:V2018.03_Issuebox}}

[[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:V2017.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.04_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]' heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Wiki-structuuroverzicht=
Onderstaande afbeelding geeft een overzicht van de MedMij wiki pagina structuur. Het afsprakenstelsel verwijst naar de MedMij landingspagina die op zijn beurt verwijst naar de functionele en technische ontwerpen. Vanaf deze pagina, de hoofdpagina van de functionele ontwerpen, wordt verwezen naar de onderliggende functionele ontwerp pagina's middels de onderstaande 'patient journeys' en tabel overzicht. De functionele ontwerp beschrijvingen hebben een technische wiki pagina als tegenhanger. Vanuit de leeswijzer afbeelding, bestaande uit drie iconen, bovenaan de pagina is het mogelijk makkelijk door te linken naar de technische pagina's.

[[Bestand:MedMij wiki structuur overzicht.png|link= |650px|MedMij Wiki structuur overzicht]]

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>bestand:Thomas Journey 2017.04.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.04_OntwerpeAfspraken|eAfspraak]]
circle 1941 155 91 [[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1644 1296 91 [[MedMij:V2017.04_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
circle 930 1161 91 [[MedMij:V2017.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
circle 629 1320 91 [[MedMij:V2017.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient_Journey_-_Roos_Dalstra.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px
circle 733 410 90 [[MedMij:V2017.04_OntwerpZelfmetingen|Zelfmetingen]]
circle 1147 237 90 [[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1572 86 88 [[MedMij:V2017.04_OntwerpAllergieIntolerantie|AllergieIntolerantie]]
circle 1852 1222 87 [[MedMij:V2017.04_OntwerpPDFA|PDF/A]]
circle 1490 1306 87 [[MedMij:V2017.04_OntwerpLabresult|Laboratorium resultaten]]
circle 1229 1302 87 [[MedMij:V2017.04_OntwerpMedicatie|Medicatiegegevens]]
circle 883 1032 87 [[MedMij:V2017.04_OntwerpeAfspraken|eAfspraak]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.04_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2017.04_FHIR_BGZ|BgZ in FHIR]]
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]||||Laboratoriumresultaten ||[[MedMij:V2017.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2017.04_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="vertical-align:top; background-color: white;"
|rowspan="2"|[[Bestand:Medicatie.png|50px]]
|rowspan="2"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="2"|
||Medicatieoverzicht
||[[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving| Medicatieoverzicht ]]
||[[MedMij:V2017.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="vertical-align:top; background-color: white;"
||Medicatiegegevens ||[[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt| Medicatiegegevens ]]
||[[MedMij:V2017.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-
|[[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]|||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]
|||Allergie/intolerantie ||[[MedMij:V2017.04_OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2017.04_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-style="vertical-align:top; background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.04_OntwerpeAfspraken|50px]]
||eAfspraak
||||Afspraken
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraak]]
|| [[MedMij:V2017.04_FHIR_eAfspraak| eAfspraak in FHIR]]
|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||||||Zelfmetingen ||[[MedMij:V2017.04_OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2017.04_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]||||||PDF/A ||[[MedMij:V2017.04_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]] ||[[MedMij:V2017.04_FHIR_PDFA|PDF/A in FHIR]]
|-
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie. Het afsprakenstelsel ondersteunt (nog) geen PUSH berichten. De technische uitwerking van onderstaande use cases zal daarom later volgen.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||||||Zelfmetingen ||[[MedMij:V2017.04_OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.04_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2017.04_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||
|}

=Systeemrollen=
In onderstaande tabel zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases. De syteemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt.

De kolom 'Afsprakenstelsel release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is opgenomen. Wanneer een systeemrol geen afsprakenstelsel releasenummer heeft betekent dat deze nog niet is opgenomen.

{| 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;" |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;" |Afsprakenstelsel release
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| PGO
| MM-1.0.0-BZR-FHIR
| R1.0
|-
| Beschikbaarstellen BgZ
| XIS
| MM-1.0.0-BZB-FHIR
| R1.0
|-
| rowspan="4" | [[Bestand:Medicatie.png|https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx| Medicatieproces|50px]]
| rowspan="4" | Medicatieproces
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| PGO
| MP-9.0.4-MOR-FHIR
| R1.0
|-
| Beschikbaarstellen medicatieoverzicht
| XIS
| MP-9.0.4-MOB-FHIR
| R1.0
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| PGO
| MP-9.0.4-MGR-FHIR
| R1.0
|-
| Beschikbaarstellen medicatiegegevens
| XIS
| MP-9.0.4-MGB-FHIR
| R1.0
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| PGO
| LAB-1.0.0-LRR-FHIR
| R1.0
|-
| Beschikbaarstellen laboratoriumresultaten
| XIS
| LAB-1.0.0-LRB-FHIR
| R1.0
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]
| rowspan="4" |
| rowspan="2" | Meetwaarden Vitale Functies (PULL)
| Raadplegen meetwaarden vitale functies
| PGO
| MM-1.0.0-MVR-FHIR
| -
|-
| Beschikbaarstellen meetwaarden vitale functies
| XIS
| MM-1.0.0-MVB-FHIR
| -
|-
| rowspan="2" | Zelfmetingen Vitale Functies (PUSH)
| Sturen zelfmetingen van vitale functies
| PGO
| MM-1.0.0-ZVS-FHIR
| -
|-
| Ontvangen zelfmetingen vitale functies
| XIS
| MM-1.0.0-ZVO-FHIR
| -
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]
| rowspan="6" |
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| PGO
| MM-1.0.0-PLR-FHIR
| R1.0
|-
| Beschikbaarstellen PDF/A metadata lijst
| XIS
| MM-1.0.0-PLB-FHIR
| R1.0
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
|-
| Beschikbaarstellen PDF/A
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| PGO
| MM-1.0.0-PDS-FHIR
| -
|-
| Ontvangen PDF/A
| XIS
| MM-1.0.0-PDO-FHIR
| -
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| PGO
| MP-6.12.6-AIR-FHIR
| -
|-
| Beschikbaarstellen AllergieIntolerantie gegevens
| XIS
| MP-6.12.6-AIB-FHIR
| -
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:Vdraft_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| PGO
| EA-1.0.0-AFR-FHIR
| -
|-
| Beschikbaarstellen afspraak
| XIS
| EA-1.0.0-AFB-FHIR
| -
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| PGO
| EA-1.0.0-ASR-FHIR
| -
|-
| Beschikbaarstellen afspraak slots
| XIS
| EA-1.0.0-ASB-FHIR
| -
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| PGO
| EA-1.0.0-ATR-FHIR
| -
|-
| Beschikbaarstellen afspraak typen
| XIS
| EA-1.0.0-ATB-FHIR
| -
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| PGO
| EA-1.0.0-AVS-FHIR
| -
|-
| Ontvangen afspraakverzoek
| XIS
| EA-1.0.0-AVO-FHIR
| -
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| PGO
| EA-1.0.0-AAS-FHIR
| -
|-
| Ontvangen afspraak annulering
| XIS
| EA-1.0.0-AAO-FHIR
| -
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| PGO
| EA-1.0.0-AWS-FHIR
| -
|-
| Ontvangen afspraak wijzigingsverzoek
| XIS
| EA-1.0.0-AWO-FHIR
| -
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.04_Ontwerpen|2017.04]] || 2017-12-18 || Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.03 Ontwerpen

2022-06-08T11:11:16Z

Cevin Krooneman: MMTM-304 obsolete melding in NL

{{DISPLAYTITLE:Ontwerpen MedMij, voor openbare consultatie PDF/A (publicatie 2017.03)}}
{{MedMij:V2018.03_Issuebox}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|600px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2017.03_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.03_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]', heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>Bestand:Journey-02_-_2017.02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.02_OntwerpeAfspraken|eAfspraak]]
circle 1644 1296 91 [[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient_Journey_-_Roos_Dalstra_-_gray_-_2017.03_publicatie.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px
circle 1852 1222 87 [[MedMij:V2017.03_OntwerpPDFA|PDF/A]]
circle 883 1032 87 [[MedMij:V2017.03_OntwerpeAfspraken|eAfspraak]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.03_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2017.03_FHIR_BGZ|BgZ in FHIR]]
|-
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.03_OntwerpeAfspraken|50px]]
||eAfspraken
||||Afspraken
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraken]]
||
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]||||||PDF/A ||[[MedMij:V2017.03_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]] ||[[MedMij:V2017.03_FHIR_PDFA|PDF/A in FHIR]]
|-
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V1.0_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2017.03_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.02 Gearchiveerd

2022-06-08T11:10:40Z

Cevin Krooneman: typefout verwijderd

{{DISPLAYTITLE:Ontwerpen MedMij, voor openbare consultatie eAfspraken (publicatie 2017.02)}}
{{MedMij:V2018.03_Issuebox}}

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

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Een ander programma, '[https://www.registratieaandebron.nl Registratie aan de bron]', heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BGZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BGZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BGZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BGZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op informatiestandaarden die Nictiz beheert, is een Nictiz-kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journey==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken naar ontwerp specificaties.
<imagemap>Bestand:Journey-02_-_2017.02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.02_OntwerpeAfspraken|eAfspraak]]
circle 1644 1296 91 [[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2" | Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BGZ]]||[[MedMij:V2017.01_FHIR_BGZ|BGZ in FHIR]]
|-"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.02_OntwerpeAfspraken|50px]]
||eAfspraken
||||Afspraken
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraken]]
||

|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.02_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.02 Gearchiveerd

2022-06-08T11:10:05Z

Cevin Krooneman: MMTM-304 obsolete melding in NL

{{DISPLAYTITLE:Ontwerpen MedMij, voor openbare consultatie eAfspraken (publicatie 2017.02)}}
{{MedMij:V2018.03_Issuebox}}

This page is for public consultation.}}
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|600px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2017.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.01_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Een ander programma, '[https://www.registratieaandebron.nl Registratie aan de bron]', heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BGZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BGZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BGZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BGZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op informatiestandaarden die Nictiz beheert, is een Nictiz-kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journey==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken naar ontwerp specificaties.
<imagemap>Bestand:Journey-02_-_2017.02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.02_OntwerpeAfspraken|eAfspraak]]
circle 1644 1296 91 [[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2" | Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BGZ]]||[[MedMij:V2017.01_FHIR_BGZ|BGZ in FHIR]]
|-"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.02_OntwerpeAfspraken|50px]]
||eAfspraken
||||Afspraken
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraken]]
||

|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.02_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.03 Ontwerpen

2022-06-08T10:02:09Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:Ontwerpen MedMij, voor openbare consultatie PDF/A (publicatie 2017.03)}}
{{IssueBox|A newer version is available, see https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}

This page is for public consultation.}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|600px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2017.03_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.03_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]', heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>Bestand:Journey-02_-_2017.02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.02_OntwerpeAfspraken|eAfspraak]]
circle 1644 1296 91 [[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient_Journey_-_Roos_Dalstra_-_gray_-_2017.03_publicatie.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px
circle 1852 1222 87 [[MedMij:V2017.03_OntwerpPDFA|PDF/A]]
circle 883 1032 87 [[MedMij:V2017.03_OntwerpeAfspraken|eAfspraak]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.03_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2017.03_FHIR_BGZ|BgZ in FHIR]]
|-
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.03_OntwerpeAfspraken|50px]]
||eAfspraken
||||Afspraken
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraken]]
||
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]||||||PDF/A ||[[MedMij:V2017.03_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]] ||[[MedMij:V2017.03_FHIR_PDFA|PDF/A in FHIR]]
|-
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V1.0_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.03_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2017.03_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.02 Gearchiveerd

2022-06-08T10:01:49Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:Ontwerpen MedMij, voor openbare consultatie eAfspraken (publicatie 2017.02)}}
{{IssueBox|A newer version is available, see https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}

This page is for public consultation.}}
[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<imagemap>Bestand:Leeswijzer-technisch-banner 02 white.png|center|600px|alt=Afspraken-Functioneel-Technisch
circle 241 216 211 [https://www.medmij.nl/afsprakenstelsel Afsprakenstelsel]
circle 1013 224 212 [[MedMij:V2017.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.01_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Een ander programma, '[https://www.registratieaandebron.nl Registratie aan de bron]', heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BGZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BGZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BGZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BGZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op informatiestandaarden die Nictiz beheert, is een Nictiz-kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journey==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken naar ontwerp specificaties.
<imagemap>Bestand:Journey-02_-_2017.02.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.02_OntwerpeAfspraken|eAfspraak]]
circle 1644 1296 91 [[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2" | Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.01_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BGZ]]||[[MedMij:V2017.01_FHIR_BGZ|BGZ in FHIR]]
|-"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.02_OntwerpeAfspraken|50px]]
||eAfspraken
||||Afspraken
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraken]]
||

|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.02_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.02_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.04 Ontwerp

2022-06-08T10:01:22Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:Ontwerpen MedMij, publicatie 2017.04|Functioneel Ontwerpen}}
{{IssueBox|A newer version is available, see https://informatiestandaarden.nictiz.nl/wiki/MedMij:Vcurrent_Ontwerpen}}

[[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:V2017.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.04_FHIR_IG|Technisch]]
desc none
</imagemap>

=Inleiding=
==Algemeen==
Hier vindt u informatie over de ''inhoud'' van de informatie die kan worden uitgewisseld in het [https://www.medmij.nl/afsprakenstelsel/ MedMij afsprakenstelstel].

Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens [[#Ontwerpen|verwijzingen]] naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.

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

==Kaders en uitgangspunten==

===Richtlijn===
Het programma '[https://www.registratieaandebron.nl Registratie aan de bron]' heeft zorginformatiebouwstenen voor Nederland gedefinieerd. Een zorginformatiebouwsteen (ZIB) beschrijft nauwkeurig wat er over een bepaald onderwerp van het zorgproces van de patiënt moet worden vastgelegd. Zorginformatiebouwstenen zijn opgesteld vanuit de gedachte dat dezelfde informatie zowel voor artsen, verpleegkundigen, paramedici als patiënten relevant zijn, ieder met hun eigen invalshoek.

Naast deze zorginformatiebouwstenen heeft het programma 'Registratie aan de Bron' ook de zogenaamde '[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]' gedefinieerd. De Basisgegevensset Zorg (BgZ) is de minimale set van patiëntgegevens die specialisme-, ziektebeeld- en beroepsgroepoverstijgend relevant is en van belang voor de continuïteit van zorg voor de patiënt. De Basisgegevensset Zorg is gedefinieerd met behulp van de zorginformatiebouwstenen: het is een ingeperkte set van het totaal aan ZIB's.

Iedereen heeft recht op inzage van gegevens die over jou zijn vastgelegd. MedMij gebruikt de BgZ als leidraad om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de BgZ slechts een deel van een bepaalde ZIB. MedMij kiest ervoor om wél altijd de volledige ZIB te definiëren, zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit mogelijk wordt.

Er is een uitzondering gemaakt voor het domein van medicatie. Een programma dat parallel loopt aan MedMij is 'Medicatieproces'. Dit programma heeft de informatiestandaard Medicatieproces versie 9.x opgeleverd en nieuwe zorginformatiebouwstenen gedefinieerd. Deze nieuwe zorginformatiebouwstenen zijn geen onderdeel van BgZ 1.0, maar zijn wél in gebruik voor de functionele definitie voor het uitwisselen van medicatiegegevens in MedMij.

===Infrastructuur===
De berichten beschreven in deze informatiestandaard kunnen over elke willekeurige infrastructuur worden getransporteerd. De specificatie van de infrastructuur en het berichttransport is buiten scope van deze informatiestandaard.

MedMij kent wel een [http://www.medmij.nl/afsprakenstelsel/ afsprakenstelsel] met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.

===Geografische reikwijdte===
De geografische scope van alle ontwerpen van MedMij is Nederland.

==Kwalificatie==
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing.
Kwalificatie vindt plaats per systeemrol.
Voor meer informatie zie [https://www.nictiz.nl/standaardisatie/kwalificaties de websitepagina over Nictiz kwalificaties].

=Wiki-structuuroverzicht=
Onderstaande afbeelding geeft een overzicht van de MedMij wiki pagina structuur. Het afsprakenstelsel verwijst naar de MedMij landingspagina die op zijn beurt verwijst naar de functionele en technische ontwerpen. Vanaf deze pagina, de hoofdpagina van de functionele ontwerpen, wordt verwezen naar de onderliggende functionele ontwerp pagina's middels de onderstaande 'patient journeys' en tabel overzicht. De functionele ontwerp beschrijvingen hebben een technische wiki pagina als tegenhanger. Vanuit de leeswijzer afbeelding, bestaande uit drie iconen, bovenaan de pagina is het mogelijk makkelijk door te linken naar de technische pagina's.

[[Bestand:MedMij wiki structuur overzicht.png|link= |650px|MedMij Wiki structuur overzicht]]

=Ontwerpen=
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de [[#Patient_journeys| Patient journeys]] die MedMij hanteert.

De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
* [[#Haal_gegevens_op_uit_XIS|Haal gegevens op uit XIS]]
* [[#Stuur_gegevens_naar_XIS|Stuur gegevens naar XIS]]
==Patient journeys==
===Thomas van Beek===
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Thomas_van_Beek_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.
<imagemap>bestand:Thomas Journey 2017.04.png|alt=Tijdlijn van Thomas. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px

circle 553 322 90 [[MedMij:V2017.04_OntwerpeAfspraken|eAfspraak]]
circle 1941 155 91 [[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1644 1296 91 [[MedMij:V2017.04_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|Basisgegevensset Zorg]]
circle 930 1161 91 [[MedMij:V2017.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
circle 629 1320 91 [[MedMij:V2017.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]
desc none
</imagemap>

===Roos Dalstra===
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u [https://www.nictiz.nl/SiteCollectionDocuments/Overig/Casus_Roos_Dalstra_MedMij.pdf hier].

Onderstaand een grafische weergave van de tijdlijn van Roos. Het is mogelijk te klikken op de groene PGO-cirkels, deze linken - indien beschikbaar - naar ontwerpspecificaties.

<imagemap>Bestand:Patient_Journey_-_Roos_Dalstra.png|alt=Tijdlijn van Roos Dalstra. Het is mogelijk te klikken op de groene PGO-cirkels. | 1100px
circle 733 410 90 [[MedMij:V2017.04_OntwerpZelfmetingen|Zelfmetingen]]
circle 1147 237 90 [[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_door_pati.C3.ABnt|Medicatieoverzicht]]
circle 1572 86 88 [[MedMij:V2017.04_OntwerpAllergieIntolerantie|AllergieIntolerantie]]
circle 1852 1222 87 [[MedMij:V2017.04_OntwerpPDFA|PDF/A]]
circle 1490 1306 87 [[MedMij:V2017.04_OntwerpLabresult|Laboratorium resultaten]]
circle 1229 1302 87 [[MedMij:V2017.04_OntwerpMedicatie|Medicatiegegevens]]
circle 883 1032 87 [[MedMij:V2017.04_OntwerpeAfspraken|eAfspraak]]
desc none
</imagemap>

==Haal gegevens op uit XIS==

Een persoonlijke gezondheidsomgeving (PGO) haalt gegevens op bij een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het raadplegen van informatie.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index raadplegen / beschikbaarstellen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="vertical-align:top; background-color: white;"
|[[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg]||||[https://www.nictiz.nl/standaarden/basisgegevensset-zorg Basisgegevensset Zorg], versie 1.0 met medicatiebouwstenen uit MP 9||[[MedMij:V2017.04_OntwerpBGZ#Use_case_1:_Raadplegen_Basisgegevensset_Zorg_in_persoonlijke_gezondheidsomgeving|BgZ]]||[[MedMij:V2017.04_FHIR_BGZ|BgZ in FHIR]]
|-
|[[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria Labuitwisseling]||||Laboratoriumresultaten ||[[MedMij:V2017.04_OntwerpLabresult#Use_case:_Raadplegen_laboratoriumresultaten_in_persoonlijke_gezondheidsomgeving|Laboratoriumresultaten]]||[[MedMij:V2017.04_FHIR_LaboratoryResults|Laboratoriumresultaten in FHIR]]
|-style="vertical-align:top; background-color: white;"
|rowspan="2"|[[Bestand:Medicatie.png|50px]]
|rowspan="2"|[https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx Medicatieproces]
|rowspan="2"|
||Medicatieoverzicht
||[[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatieoverzicht_in_persoonlijke_gezondheidsomgeving| Medicatieoverzicht ]]
||[[MedMij:V2017.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_overview |Medicatieoverzicht in FHIR]]
|-style="vertical-align:top; background-color: white;"
||Medicatiegegevens ||[[MedMij:V2017.04_OntwerpMedicatie#Use_case:_Raadplegen_medicatiegegevens_door_pati.C3.ABnt| Medicatiegegevens ]]
||[[MedMij:V2017.04_FHIR_MedicationProcess#Use_case:_retrieve_medication_information |Medicatiegegevens in FHIR]]
|-
|[[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]|||[https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid Medicatieveiligheid]
|||Allergie/intolerantie ||[[MedMij:V2017.04_OntwerpAllergieIntolerantie| AllergieIntolerantie]] ||[[MedMij:V2017.04_FHIR_AllergyIntolerance|AllergieIntolerantie in FHIR]]
|-style="vertical-align:top; background-color: white;"
|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.04_OntwerpeAfspraken|50px]]
||eAfspraak
||||Afspraken
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_raadplegen_door_pati.C3.ABnt| eAfspraak]]
|| [[MedMij:V2017.04_FHIR_eAfspraak| eAfspraak in FHIR]]
|-style="background-color: white;"
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||||||Zelfmetingen ||[[MedMij:V2017.04_OntwerpZelfmetingen|Zelfmetingen]]||[[MedMij:V2017.04_FHIR_VitalSigns|Zelfmetingen in FHIR]]
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]||||||PDF/A ||[[MedMij:V2017.04_OntwerpPDFA#Use_case:_Raadplegen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]] ||[[MedMij:V2017.04_FHIR_PDFA|PDF/A in FHIR]]
|-
|}

==Stuur gegevens naar XIS==
Een persoonlijke gezondheidsomgeving (PGO) stuurt gegevens naar een zorginformatiesystemen (XIS). Onderstaande tabel geeft een overzicht van de use cases uit informatiestandaarden die van toepassing zijn voor het sturen van informatie. Het afsprakenstelsel ondersteunt (nog) geen PUSH berichten. De technische uitwerking van onderstaande use cases zal daarom later volgen.

{| class="wikitable"
| style="background-color: #4AB8A7;; color: white; font-weight: bold; text-align:center; border: 1px solid black;" colspan="6" | Index sturen / ontvangen
|-style="background-color: #4AB8A7;; color: white; text-align:left; border: 1px solid black;"
|style="width:200px; border: 1px solid black;" colspan="2"| Informatiestandaard
|style="width:20px; border: 1px solid black;"| Versie
|style="width:600px; border: 1px solid black;"| Use case
|style="width:200px; border: 1px solid black;"| Functioneel
|style="width:200px; border: 1px solid black;"| Technisch
|-style="background-color: white;"
|-
|[[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]||||||Zelfmetingen ||[[MedMij:V2017.04_OntwerpZelfmetingen#Use_case:_Sturen_zelfmetingen_van_de_vitale_functies_door_pati.C3.ABnt|Zelfmetingen]]||
|-
|rowspan="3"|[[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:V2017.04_OntwerpeAfspraken|50px]]
|rowspan="3"|eAfspraken
|rowspan="3"|
||Afspraak maken
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_maken_door_pati.C3.ABnt| eAfspraak maken]]
||
|-
|Afspraak annuleren
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_annuleren_door_pati.C3.ABnt| eAfspraak annuleren]]
||
|-
|Afspraak wijzigen
||[[MedMij:V2017.04_OntwerpeAfspraken#Use_case:_Afspraak_wijzigen_door_pati.C3.ABnt| eAfspraak wijzigen]]
||
|-
|[[Bestand:PDF-A_icoon_zonder_tekst.png|link=|PDF/A|50px]]||PDF/A||||PDF/A|||[[MedMij:V2017.04_OntwerpPDFA#Use_case:_Sturen_medische_gegevens_in_PDF.2FA_door_pati.C3.ABnt| PDF/A]]||
|}

=Systeemrollen=
In onderstaande tabel zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases. De syteemrolcode is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard. De code is als volgt opgebouwd: afkorting informatiestandaard - versie - afkorting transactie - uitwisselingsstandaard. Wanneer er geen informatiestandaard beschikbaar is, wordt de afkorting MM (MedMij) gebruikt.

De kolom 'Afsprakenstelsel release' geeft informatie over de versie van het afsprakenstelsel waarin de systeemrol is opgenomen. Wanneer een systeemrol geen afsprakenstelsel releasenummer heeft betekent dat deze nog niet is opgenomen.

{| 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;" |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;" |Afsprakenstelsel release
|-
| rowspan="2" | [[Bestand:BGZ_icoon_zonder_tekst.png|link=https://www.nictiz.nl/standaarden/basisgegevensset-zorg|Basissetgegevens Zorg|50px]]
| rowspan="2" | Basisgegevensset Zorg
| rowspan="2" | BgZ (PULL)
| Raadplegen BgZ
| PGO
| MM-1.0.0-BZR-FHIR
| R1.0
|-
| Beschikbaarstellen BgZ
| XIS
| MM-1.0.0-BZB-FHIR
| R1.0
|-
| rowspan="4" | [[Bestand:Medicatie.png|https://www.nictiz.nl/Paginas/Informatiestandaard-Medicatieproces.aspx| Medicatieproces|50px]]
| rowspan="4" | Medicatieproces
| rowspan="2" | Medicatieoverzicht (PULL)
| Raadplegen medicatieoverzicht
| PGO
| MP-9.0.4-MOR-FHIR
| R1.0
|-
| Beschikbaarstellen medicatieoverzicht
| XIS
| MP-9.0.4-MOB-FHIR
| R1.0
|-
| rowspan="2" | Medicatiegegevens (PULL)
| Raadplegen medicatiegegevens
| PGO
| MP-9.0.4-MGR-FHIR
| R1.0
|-
| Beschikbaarstellen medicatiegegevens
| XIS
| MP-9.0.4-MGB-FHIR
| R1.0
|-
| rowspan="2" | [[Bestand:Lab.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/laboratoria|Labuitwisseling|50px]]
| rowspan="2" | Labuitwisseling
| rowspan="2" | Laboratoriumresultaten (PULL)
| Raadplegen laboratoriumresultaten
| PGO
| LAB-1.0.0-LRR-FHIR
| R1.0
|-
| Beschikbaarstellen laboratoriumresultaten
| XIS
| LAB-1.0.0-LRB-FHIR
| R1.0
|-
| rowspan="4" | [[Bestand:Self-Measuements_zonder_tekst.png|link=|50px]]
| rowspan="4" |
| rowspan="2" | Meetwaarden Vitale Functies (PULL)
| Raadplegen meetwaarden vitale functies
| PGO
| MM-1.0.0-MVR-FHIR
| -
|-
| Beschikbaarstellen meetwaarden vitale functies
| XIS
| MM-1.0.0-MVB-FHIR
| -
|-
| rowspan="2" | Zelfmetingen Vitale Functies (PUSH)
| Sturen zelfmetingen van vitale functies
| PGO
| MM-1.0.0-ZVS-FHIR
| -
|-
| Ontvangen zelfmetingen vitale functies
| XIS
| MM-1.0.0-ZVO-FHIR
| -
|-
| rowspan="6" | [[Bestand:PDF-A_icoon_zonder_tekst.png|PDF/A|50px]]
| rowspan="6" |
| rowspan="2" | PDFA metadata lijst (PULL)
| Raadplegen PDF/A metadata lijst
| PGO
| MM-1.0.0-PLR-FHIR
| R1.0
|-
| Beschikbaarstellen PDF/A metadata lijst
| XIS
| MM-1.0.0-PLB-FHIR
| R1.0
|-
| rowspan="2" | PDFA (PULL)
| Raadplegen PDF/A
| PGO
| MM-1.0.0-PDR-FHIR
| R1.0
|-
| Beschikbaarstellen PDF/A
| XIS
| MM-1.0.0-PDB-FHIR
| R1.0
|-
| rowspan="2" | PDFA (PUSH)
| Sturen PDF/A
| PGO
| MM-1.0.0-PDS-FHIR
| -
|-
| Ontvangen PDF/A
| XIS
| MM-1.0.0-PDO-FHIR
| -
|-
| rowspan="2" | [[Bestand:Allergie.png|link=https://www.nictiz.nl/standaardisatie/informatiestandaarden/medicatieveiligheid| Medicatieveiligheid|50px]]
| rowspan="2" | Medicatieveiligheid
| rowspan="2" | AllergieIntolerantie gegevens (PULL)
| Raadplegen AllergieIntolerantie gegevens
| PGO
| MP-6.12.6-AIR-FHIR
| -
|-
| Beschikbaarstellen AllergieIntolerantie gegevens
| XIS
| MP-6.12.6-AIB-FHIR
| -
|-
| rowspan="12" | [[Bestand:EAfspraak_icoon_zonder_tekst.png|link=MedMij:Vdraft_OntwerpeAfspraken|50px]]
| rowspan="12" | eAfspraak
| rowspan="2" | Afspraken (PULL)
| Raadplegen afspraak
| PGO
| EA-1.0.0-AFR-FHIR
| -
|-
| Beschikbaarstellen afspraak
| XIS
| EA-1.0.0-AFB-FHIR
| -
|-
| rowspan="2" | AfspraakSlots (PULL)
| Raadplegen afspraak slots
| PGO
| EA-1.0.0-ASR-FHIR
| -
|-
| Beschikbaarstellen afspraak slots
| XIS
| EA-1.0.0-ASB-FHIR
| -
|-
| rowspan="2" | AfspraakType (PULL)
| Raadplegen afspraak typen
| PGO
| EA-1.0.0-ATR-FHIR
| -
|-
| Beschikbaarstellen afspraak typen
| XIS
| EA-1.0.0-ATB-FHIR
| -
|-
| rowspan="2" | AfspraakVerzoek (PUSH)
| Sturen afspraakverzoek
| PGO
| EA-1.0.0-AVS-FHIR
| -
|-
| Ontvangen afspraakverzoek
| XIS
| EA-1.0.0-AVO-FHIR
| -
|-
| rowspan="2" | AfspraakAnnulering (PUSH)
| Sturen afspraak annulering
| PGO
| EA-1.0.0-AAS-FHIR
| -
|-
| Ontvangen afspraak annulering
| XIS
| EA-1.0.0-AAO-FHIR
| -
|-
| rowspan="2" | AfspraakWijziging (PUSH)
| Sturen afspraak wijzigingsverzoek
| PGO
| EA-1.0.0-AWS-FHIR
| -
|-
| Ontvangen afspraak wijzigingsverzoek
| XIS
| EA-1.0.0-AWO-FHIR
| -
|}

=Release Notes=

{| class="wikitable"
! Versie !! Datum !! Omschrijving
|-
| [[MedMij:V2017.04_Ontwerpen|2017.04]] || 2017-12-18 || Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen
|-
| [[MedMij:V2017.03_Ontwerpen|2017.03]] || 2017-11-07 || PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || eAfspraak
|-
| [[MedMij:V2017.01_Ontwerpen|2017.01]] || 2017-10-02 || BgZ 2015
|}

MedMij:V2017.03 FHIR IG

2022-06-08T09:59:34Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide (publication 2017.03)}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

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

__TOC__

=About the IG=
This is the technical MedMij FHIR implementation guide based on HL7® FHIR® version STU3.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for use of FHIR in personal health environments. Vendors of personal health environments that participate in MedMij conform to a framework of agreements. FHIR plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how FHIR should be implemented in these situations. The FHIR building blocks, or profiles, involved in these use cases are outlined in this guide. Moreover, this guides provides more textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable a particular implementation of Electronic Health Record Systems and Personal Health Environments in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a very broad domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains, but has the vision to elaborate into more domains later. However, MedMij does not do everything at once (“think big, act small”). The subdomains in scope for the current implementation guide of MedMij are:

* Patient Administration Resources
* Patient Summary (BgZ)
* Medication
* Laboratory results
* Self-measurements

The FHIR profiles created based on the Dutch Patient Summary, or BgZ ([[#Background| see background]] for more information), can be used more broadly than only exchanging a patient's summary.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers.
Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme, in order to enable patients to become that true partner.

Information standards have a functional and technical component. The functional part contains definitions of appropriate concepts (dataset) and scenario’s that define when to exchange which of those concepts. MedMij will not create new functional components of information standards. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). MedMij does make it possible to use a new exchange format: FHIR.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined Health and Care Information models (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. Next to these ZIB's, the program ‘Registratie aan de bron’ also made a selection of these ZIB's 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.

MedMij uses the BgZ as the starting point for the functional part of the information standards that are part of MedMij. This means that every MedMij information standard is mapped to ZIB's, which are also in scope of BgZ. The BgZ does not always use the complete ZIB. MedMij information standards, however, will use the full ZIB, so as to enable context-free implementation. This enables interoperability for health information.

The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. MedMij delivers a FHIR representation for each domain in [[#Scope]]. However, as noted before, already implemented standards may be part of MedMij as well. Just like the already implemented standards, FHIR is mapped to the ZIB's.

==Audience==
The target audience of this implementation guide are software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available, however, the English version is and remains leading. The rationale for choosing English is described in this section.

Implementers in healthcare are in many cases foreign, e.g. through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for this target audience we have received overwhelming preference from the MedMij implementer community for English. This saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Use Cases=
Functional explanation of MedMij use cases are described in more detail [[MedMij:V2017.03_Ontwerpen|here (Dutch)]]. This IG will narrow down to the technical FHIR implementation guidance of these use cases. From here you can link to a specific use case.

All use cases are 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.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2017.03_FHIR_BGZ |128px|Use case BgZ|Patient Summary (BgZ)]]
! [[Bestand:Medication-gray.png|link= |128px|Medication process]]
! [[Bestand:Self-Measurements-gray.png |link=|132px |Self-Measurements]]
! [[Bestand:Lab_Results-gray.png |link=|128px|Laboratory results]]
! [[Bestand:PDF-A icoon.png|link=MedMij:V2017.03_FHIR_PDFA |128px |MedMij_|PDF/A - Health Documents]]
|}

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: +31-70 317 3450

'''FHIR Discussions'''

chat.fhir.org

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2017.04 FHIR IG

2022-06-08T09:59:05Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide, publication 2017.04}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<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:V2017.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2017.04_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2017.04_FHIR_BGZ |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2017.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2017.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2017.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2017.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2017.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2017.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for use of FHIR between personal health environments (PHE) and healthcare provider systems (XIS). PHE and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel'. FHIR plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how FHIR should be implemented in these situations. The FHIR building blocks, or profiles, involved in these use cases are outlined in this guide. Moreover, this guides provides more textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHE and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a very broad domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains, but has the vision to elaborate into more domains later. The subdomains in scope for the current implementation guide of MedMij are:

* Patient Administration Resources
* Patient Summary (BgZ)
* Medication
* AllergyIntolerance
* Laboratory results
* Self-measurements
* PDF/A
* eAfspraak (appointments)

Domains that are currently out of scope but on the roadmap:
* General Practitioner data
* iStandaarden
* Nursing data

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme, in order to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of appropriate concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet, that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards are mapped to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. To clarify, these created profiles can be used in a broader context than the described use cases or the MedMij context. This enables interoperability for health information.

==Audience==
The main target audience of this implementation guide are software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. Links to relevant sections of the FHIR specification will be provided. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available, however, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g. through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for this target audience we have received overwhelming preference from the MedMij implementer community for English. This saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The MedMij information standards are referenced from the 'afsprakenstelsel'. The use of these MedMij information standards should be seen in the context of the 'afsprakenstelsel'. This is applicable to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases 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.

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

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found [[MedMij:V2017.04_Ontwerpen|here]]. From this page you can link to the specific use case through the patient journey image or the table index. It is also possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use Cases=
Implementation guidance is provided per use case on separate wiki pages. The following green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2017.04_FHIR_BGZ |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2017.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2017.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2017.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2017.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2017.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2017.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
|}
=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: +31-70 317 3450

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.01 FHIR IG

2022-06-08T09:58:40Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<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:V2018.01_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.01_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.01_FHIR_BGZ_2015 |100px|Patient Summary (BgZ versie 2015)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.01_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.01_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.01_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.01_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.01_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.01_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.01_FHIR_GP_Data |98px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for use of HL7® FHIR® between personal health environments (PHE) and healthcare provider systems (XIS). PHE and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel'. HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how FHIR should be implemented in these situations. The FHIR building blocks, or profiles, involved in these use cases are outlined in this guide. Moreover, this guides provides more textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHE and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a very broad domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains, but has the vision to elaborate into more domains later. In scope domains are first described in the [[MedMij:V2018.01_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme, in order to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of appropriate concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet, that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards are mapped to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. To clarify, these created profiles can be used in a broader context than the described use cases or the MedMij context. This enables interoperability for health information.

==Audience==
The main target audience of this implementation guide are software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. Links to relevant sections of the FHIR specification will be provided. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available, however, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g. through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for this target audience we have received overwhelming preference from the MedMij implementer community for English. This saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The MedMij information standards are referenced from the 'afsprakenstelsel'. The use of these MedMij information standards should be seen in the context of the 'afsprakenstelsel'. This is applicable to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases 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.

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

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found [[MedMij:V2018.01_Ontwerpen|here]]. From this page you can link to the specific use case through the patient journey image or the table index. It is also possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use Cases=
Implementation guidance is provided per use case on separate wiki pages. The following green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.01_FHIR_BGZ_2015 |100px|Patient Summary (BgZ versie 2015)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.01_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.01_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.01_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.01_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.01_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.01_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.01_FHIR_GP_Data |98px |Huisartsgegevens - GP Data]]
|}

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.02 FHIR IG

2022-06-08T09:58:12Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<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:V2018.02_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.02_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.02_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.02_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.02_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.02_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.02_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.02_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.02_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.02_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for use of HL7® FHIR® between personal health environments (PHE) and healthcare provider systems (XIS). PHE and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel'. HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how FHIR should be implemented in these situations. The FHIR building blocks, or profiles, involved in these use cases are outlined in this guide. Moreover, this guides provides more textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHE and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a very broad domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains, but has the vision to elaborate into more domains later. In scope domains are first described in the [[MedMij:V2018.02_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme, in order to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of appropriate concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet, that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards are mapped to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. To clarify, these created profiles can be used in a broader context than the described use cases or the MedMij context. This enables interoperability for health information.

==Audience==
The main target audience of this implementation guide are software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. Links to relevant sections of the FHIR specification will be provided. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available, however, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g. through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for this target audience we have received overwhelming preference from the MedMij implementer community for English. This saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The MedMij information standards are referenced from the 'afsprakenstelsel'. The use of these MedMij information standards should be seen in the context of the 'afsprakenstelsel'. This is applicable to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases 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.

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

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found [[MedMij:V2018.02_Ontwerpen|here]]. From this page you can link to the specific use case through the patient journey image or the table index. It is also possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use Cases=
Implementation guidance is provided per use case on separate wiki pages. The following green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.02_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.02_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.02_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.02_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.02_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.02_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.02_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.02_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.03 FHIR IG

2022-06-08T09:57:50Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<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:V2018.03_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.03_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.03_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.03_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.03_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.03_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.03_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.03_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.03_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.03_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel'. HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how FHIR should be implemented in these situations. The FHIR building blocks, or profiles, involved in these use cases are outlined in this guide. Moreover, this guide provides textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a very broad domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.03_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme, in order to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of appropriate concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet, that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards are mapped to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. To clarify, these created profiles can be used in a broader context than the described use cases or the MedMij context. This enables interoperability for health information.

==Audience==
The main target audience of this implementation guide are software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. Links to relevant sections of the FHIR specification will be provided. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available, however, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g. through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for this target audience we have received overwhelming preference from the MedMij implementer community for English. This saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The MedMij information standards are referenced from the 'afsprakenstelsel'. The use of these MedMij information standards should be seen in the context of the 'afsprakenstelsel'. This is applicable to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases 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.

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

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found [[MedMij:V2018.03_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is also possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use Cases=
Implementation guidance is provided per use case on separate wiki pages. The following green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.03_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.03_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.03_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.03_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.03_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.03_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.03_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.03_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.03_FHIR_IG|2018.03]] || 2018-03-29 || Added BgZ 2017 and GP patient data publication.
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017 for public consultation.
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data for public consultation.
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements.
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.04 FHIR IG

2022-06-08T09:57:15Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<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:V2018.04_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.04_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.04_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.04_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for the use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel.' HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how to implement FHIR in these situations. This guide outlines the FHIR building blocks, or profiles, involved in these use cases. Moreover, this guide provides a textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a vast domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.04_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of relevant concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards contain mappings to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. Therefore, these profiles are applicable in a broader context than the described use cases or the MedMij context. Reuse of these profiles enables interoperability for health information.

==Audience==
The main target audience of this implementation guide is software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. This guide provides links to relevant sections of the FHIR specification. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available. However, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g., through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for the target audience, we have received overwhelming preference from the MedMij implementer community for English. English documentation saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The 'afsprakenstelsel' references the MedMij information standards. In addition, the MedMij information standards are specified in the context of the 'afsprakenstelsel.' This applies to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases 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.

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

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found at [[MedMij:V2018.04_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use cases=
Implementation guidance is provided per use case on separate wiki pages. The next section provides implemenation guidance that apply for all use cases. The green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.04_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.04_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.04_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.04_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.04_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.04_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.04_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.04_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
|}

=Use case overarching principles=
==Content Types and encodings==
MedMij uses the [http://hl7.org/fhir/http.html#mime-type FHIR RESTful framework]. This framework defines at least three content-types to send/retrieve information. Clients may ask servers specifically for information in a given content-type. Servers SHALL support server-driven content negotiation as described in [http://www.w3.org/Protocols/rfc2616/rfc2616-sec12.html#sec12 section 12] of the HTTP specification.

* XML: application/fhir+xml
* JSON: application/fhir+json
* RDF: text/turtle - Not supported in MedMij

Servers in MedMij SHALL support both XML and JSON. Clients MAY negotiate using the HTTP standard which they prefer. If a client does not request a specific content-type, then it is server discretion if they respond using XML or JSON content-type.

FHIR uses UTF-8 for all request and response bodies. Since the HTTP specification (section 3.7.1) defines a default character encoding of ISO-8859-1, requests and responses SHALL explicitly set the character encoding to UTF-8 using the charset parameter of the MIME-type in the Content-Type header. Requests MAY also specify this charset parameter in the Accept header and/or use the Accept-Charset header.

==Retrieve information: what's new==
Retrieving information that was added, changed, deleted relative to a date may be done using the search parameter <code>_lastUpdated</code> available for any resource. Using the parameter <code>_lastUpdated</code> a system may query for data that is ''new'' since the previous query. Any FHIR server is expected to support this parameter <code>_lastUpdated</code>.

The search parameter _lastUpdated can be used to select resources based on the last time they were changed:

GET [base]/Observation?_lastUpdated=gt2018-10-01

This search finds any observations changed since Oct 1, 2018. More information may be found in the section _lastUpdated in the FHIR specification: http://hl7.org/fhir/STU3/search.html#lastUpdated.

An example search request is shown below.

<pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105&_lastUpdated=gt2018-10-01</pre>

This search finds all Consent resources with a category SNOMED code 11291000146105 that have been changed since Oct 1, 2018.

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.04_FHIR_IG|2018.04]] || 2018-08-30 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_FHIR_IG|2018.03]] || 2018-05-07 || Published BgZ 2017 and GP Data
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017 for public consultation
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A.
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR.
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}

MedMij:V2018.05 FHIR IG

2022-06-08T09:54:34Z

Cevin Krooneman: MMTM-304 obsolete melding

{{DISPLAYTITLE:MedMij FHIR Implementation Guide}}
{{MedMij:V2018.06_Issuebox_FHIR_IG}}

[[Bestand:MedMij2.png |link=https://www.medmij.nl/|rechts|Naar medmij.nl]]
<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:V2018.05_Ontwerpen|Functioneel]]
circle 1787 230 212 [[MedMij:V2018.05_FHIR_IG|Technisch]]
desc none
</imagemap>
__TOC__

{{large|Quick links}}
----
{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.05_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.05_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.05_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.05_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.05_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.05_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.05_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.05_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
!   
! [[Bestand:MedMij-GGZ-63.png|link=MedMij:V2018.05_FHIR_GGZ |105px |GGZ]]
|}

=About the IG=
This is the technical MedMij FHIR implementation guide based on '''HL7® FHIR® version STU3'''.

==Purpose==
An implementation guide for making use of FHIR in the Dutch context. This guide is developed specifically for the use of HL7® FHIR® between personal health records(PHR) and healthcare provider systems (XIS). PHR and XIS vendors that participate in MedMij conform to a framework of agreements, in Dutch this is called the 'afsprakenstelsel.' HL7 FHIR, or just 'FHIR', plays an important role among those agreements and is used as a standard to exchange health information between the involved parties. The purpose of this guide is to describe use cases and provide technical guidance on how to implement FHIR in these situations. This guide outlines the FHIR building blocks, or profiles, involved in these use cases. Moreover, this guide provides a textual explanation of these building blocks and describes their relationship and boundaries.

==Scope==
The scope of this guide includes requirements to enable PHR and XIS in the Dutch realm to use standardized structured data in a defined inter-organizational transaction. Health is a vast domain. Therefore, MedMij has made scoping choices for its roadmap. MedMij starts with a limited number of medical subdomains but has the vision to elaborate on more domains later. In scope domains are first described in the [[MedMij:V2018.05_Ontwerpen|functional design]] that underlies this technical design.

==Background==
MedMij aims to stimulate electronic information exchange between patients and caregivers. Caregivers generally have access to software applications to help them support their work in treating patients. Software applications for patients are evolving as we speak, but patients typically are not yet enabled to be regarded as a true partner in the care process. MedMij delivers an agreements scheme to enable patients to become that true partner. The section [[#Afsprakenstelsel]] describes the relation to this implementation guide.

Information standards have a functional and technical component. The functional part contains definitions of relevant concepts (dataset) and scenario’s that define when to exchange which of those concepts. The technical part translates the functional scenario’s in an exchange format (such as HL7v3 or FHIR). The stakeholders in MedMij have chosen to introduce FHIR as a modern standard to exchange information in MedMij. A dutch factsheet that explains why FHIR is chosen is available on the [https://www.medmij.nl/wp-content/uploads/2017/06/Factsheet-MedMij-FHIR.pdf MedMij website]. MedMij delivers a FHIR representation ([http://hl7.org/fhir/STU3/profiling.html profiles]) for each domain in scope.

The program ‘Registratie aan de bron’ (Data capture at the point of Care) has defined [https://zibs.nl/wiki/HCIM_Mainpage| Health and Care Information models] (zorginformatiebouwstenen or ZIB's) for The Netherlands. ZIB's contain definitions of healthcare concepts. MedMij information standards contain mappings to these ZIB's. MedMij creates FHIR profiles based on ZIB's which include mappings to the relevant ZIB concepts. As a result, the created profiles enable context-free implementation. Therefore, these profiles are applicable in a broader context than the described use cases or the MedMij context. Reuse of these profiles enables interoperability for health information.

==Audience==
The main target audience of this implementation guide is software vendors and developers that will implement FHIR as part of electronic information exchange under MedMij. This IG is intended for developers of PHR as well as XIS vendors.
Users of this guide are expected to be familiar with the [http://hl7.org/fhir/stu3 FHIR specification] and resource processing. This guide provides links to relevant sections of the FHIR specification. This implementation guide is not intended to be a tutorial on that subject.

==Language==
This implementation guide is written in English, even though the majority of the documentation in MedMij is in Dutch. A Dutch translation of this document may become available. However, the English version is and remains leading. The rationale for choosing English is as follows. Implementers in healthcare are in many cases foreign, e.g., through outsourcing or because the company is a multinational. But even if they are Dutch native speakers, the educational tracks, their programming language of choice, and the implementer communities they are part of will largely be based on the English language. In creating the documentation for the target audience, we have received overwhelming preference from the MedMij implementer community for English. English documentation saves them investments and risks in getting a translation agency on a per vendor basis for each version of the documentation, while at the same time not alienating the native Dutch speaking audience. As a side effect it also helps Nictiz in the international realm in discussions with relevant initiatives such as Argonaut (US), Patients Know Best (UK), the Finnish PHR, and the HL7/FHIR community at large.

=Afsprakenstelsel=
[[Bestand:Afsprakenstelsel-01.png|link=https://www.medmij.nl/afsprakenstelsel/|rechts |100px|Go to Afsprakenstelsel]]
The 'afsprakenstelsel' references the MedMij information standards. In addition, the MedMij information standards are specified in the context of the 'afsprakenstelsel.' This applies to the implementation guidance of the use cases described in this implementation guide.

For example, all use cases 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.

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

All use cases described in this implementation guide have a functional counterpart. The functional design pages are written in Dutch. The main overarching wiki page of the functional designs can be found at [[MedMij:V2018.05_Ontwerpen|here]]. From this page, you can link to the specific use case through the patient journey image or the table index. It is possible to link to the specific functional design page from the technical use case pages in this wiki by clicking on the functional circle in the top image.

=Use cases=
Implementation guidance is provided per use case on separate wiki pages. The next section provides implemenation guidance that apply for all use cases. The green circles represent the available use cases. Click on the circle to go to the use case page.

{|
! [[Bestand:BGZ_icoon.png |link=MedMij:V2018.05_FHIR_BGZ_2017 |100px|Patient Summary (BgZ)]]
!   
! [[Bestand:Medication_Icoon.png |link=MedMij:V2018.05_FHIR_MedicationProcess|100px |Medication Process]]
!   
! [[Bestand:AllergyIntolerance.png |link=MedMij:V2018.05_FHIR_AllergyIntolerance|106px |Allergy Intolerance]]
!   
! [[Bestand:Self-measurements_Icoon.png |link=MedMij:V2018.05_FHIR_VitalSigns|105px |Self-Measurements]]
!   
! [[Bestand:LabResults@2x.png |link=MedMij:V2018.05_FHIR_LaboratoryResults |100px|Laboratory Results]]
!   
! [[Bestand:PDF-A icoon.png|link=MedMij:V2018.05_FHIR_PDFA |100px |PDF/A - Health Documents]]
!   
! [[Bestand:EAfspraak_-_text.png |link=MedMij:V2018.05_FHIR_eAfspraak |98px |eAfspraak - Appointments]]
!   
! [[Bestand:Huisartsgegevens-met-tekst.png|link=MedMij:V2018.05_FHIR_GP_Data |105px |Huisartsgegevens - GP Data]]
!   
! [[Bestand:MedMij-GGZ-63.png|link=MedMij:V2018.05_FHIR_GGZ |105px |GGZ]]
|}

=Use case overarching principles=
==Content Types and encodings==
MedMij uses the [http://hl7.org/fhir/http.html#mime-type FHIR RESTful framework]. This framework defines at least three content-types to send/retrieve information. Clients may ask servers specifically for information in a given content-type. Servers SHALL support server-driven content negotiation as described in [http://www.w3.org/Protocols/rfc2616/rfc2616-sec12.html#sec12 section 12] of the HTTP specification.

* XML: application/fhir+xml
* JSON: application/fhir+json
* RDF: text/turtle - Not supported in MedMij

Servers in MedMij SHALL support both XML and JSON. Clients MAY negotiate using the HTTP standard which they prefer. If a client does not request a specific content-type, then it is server discretion if they respond using XML or JSON content-type.

FHIR uses UTF-8 for all request and response bodies. Since the HTTP specification (section 3.7.1) defines a default character encoding of ISO-8859-1, requests and responses SHALL explicitly set the character encoding to UTF-8 using the charset parameter of the MIME-type in the Content-Type header. Requests MAY also specify this charset parameter in the Accept header and/or use the Accept-Charset header.

==Retrieve information: what's new==
Retrieving information that was added, changed, deleted relative to a date may be done using the search parameter <code>_lastUpdated</code> available for any resource. Using the parameter <code>_lastUpdated</code> a system may query for data that is ''new'' since the previous query. Any FHIR server is expected to support this parameter <code>_lastUpdated</code>.

The search parameter _lastUpdated can be used to select resources based on the last time they were changed:

GET [base]/Observation?_lastUpdated=gt2018-10-01

This search finds any observations changed since Oct 1, 2018. More information may be found in the section _lastUpdated in the FHIR specification: http://hl7.org/fhir/STU3/search.html#lastUpdated.

An example search request is shown below.

<pre>GET [base]/Consent?category=http://snomed.info/sct|11291000146105&_lastUpdated=gt2018-10-01</pre>

This search finds all Consent resources with a category SNOMED code 11291000146105 that have been changed since Oct 1, 2018.

=Relevant links=
'''HL7 FHIR specification'''
* [http://hl7.org/fhir/STU3/index.html HL7 FHIR STU3]
* [http://wiki.hl7.org/index.php?title=FHIR FHIR wiki]

'''Repository of MedMij FHIR artefacts'''
* [https://simplifier.net/NictizSTU3-Zib2017 Simplifier.net]
** [https://github.com/Nictiz/Nictiz-STU3-Zib2017 GitHub] (similar as Simplifier.net)

'''Test Tools'''
* MedMij FHIR server - https://vonk.test-nictiz.nl
* Windows desktop validator using .NET HL7 FHIR Profile Validation API - [https://github.com/ewoutkramer/Furore.Fhir.ValidationDemo link to download]

=Contact=

'''MedMij'''

W: http://www.medmij.nl

E: standaarden@medmij.nl

'''Nictiz'''

W: https://www.nictiz.nl

T: [tel:+31703173450 +31-70 317 3450]

'''Feedback on content in open consultation'''
* [https://www.medmij.nl/consultatiedocumenten/ Documentation]
* [https://bits.nictiz.nl/secure/BrowseProjects.jspa#all BITS for issues]

'''FHIR Questions and Discussions'''

* [http://chat.fhir.org chat.fhir.org]

=Release Notes=

{| class="wikitable"
! Version !! Date !! Notes
|-
| [[MedMij:V2018.05_FHIR_IG|2018.05]] || 2018-09-24 || Added GGZ for open consultation
|-
| [[MedMij:V2018.04_FHIR_IG|2018.04]] || 2018-08-29 || eAfspraak fase 2
|-
| [[MedMij:V2018.03_FHIR_IG|2018.03]] || 2018-05-07 || Published BgZ 2017 and GP Data
|-
| [[MedMij:V2018.02_FHIR_IG|2018.02]] || 2018-03-29 || Added BgZ 2017
|-
| [[MedMij:V2018.01_FHIR_IG|2018.01]] || 2018-02-21 || Added GP patient data
|-
| [[MedMij:V2017.04_FHIR_IG|2017.04]] || 2017-12-18 || Added Appointments, Medication, Laboratory results, AllergyIntolerance, Self-measurements
|-
| [[MedMij:V2017.03_FHIR_IG|2017.03]] || 2017-11-07 || Added PDF/A
|-
| [[MedMij:V2017.02_Ontwerpen|2017.02]] || 2017-10-11 || Unchanged. No wiki pages created for FHIR
|-
| [[MedMij:V2017.01_FHIR_IG|2017.01]] || 2017-10-02 || Initial version containing Patient Administration Resources, Patient Summary (BgZ),
|}