Ontwerpen MedMij
1 Inleiding
1.1 Algemeen
Hier vindt u informatie over de inhoud van de informatie die kan worden uitgewisseld in het afsprakenstelsel.
Deze pagina beschrijft allereerst de algemeen geldende en overkoepelende informatie van de functionele ontwerpen voor MedMij en bevat vervolgens verwijzingen naar specifieke functionele ontwerpen en technische specificaties voor die use cases die onderdeel zijn van het afsprakenstelsel.
1.2 Publicaties en versies
Deze publicatie wordt passief beheerd. Zie MedMij:Landingspagina MedMij#Publicaties en versies voor meer informatie.
1.3 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.
1.4 Kaders en uitgangspunten
1.4.1 Richtlijn
1.4.1.1 Zorginformatiebouwstenen en gegevenssets
Het programma '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 relevant is voor artsen, verpleegkundigen, paramedici en patiënten, ieder met hun eigen invalshoek. MedMij-informatiestandaarden gebruiken zo veel als mogelijk bestaande zibs voor hun functionele definitie.
Elk individu heeft recht op inzage van persoonlijke gegevens die door zorgorganisaties zijn vastgelegd. MedMij is gestart met de Basisgegevensset Zorg om de uitwisseling van informatie tussen patiënt en professional op gang te brengen. Soms gebruikt de Basisgegevensset Zorg (BgZ) slechts een deel van een bepaalde zib. MedMij kiest er echter voor om wél altijd de volledige zib te definiëren zodat contextonafhankelijke implementatie mogelijk wordt. Dit zorgt er ook voor dat interoperabiliteit met zorginformatiesystemen mogelijk wordt.
1.4.1.2 Terminologie en vertalingen
Richtinggevend voor de applicaties die MedMij-standaarden implementeren is dat ze Nederlandse termen gebruiken. Dit wordt op de volgende wijze functioneel en technisch ondersteund.
Functioneel
De functionele definities van de MedMij-informatiestandaarden zijn zoveel mogelijk samengesteld uit bestaande zibs. De zibs bevatten veel (eigen) waardelijsten. Bij deze waardelijsten wordt een Nederlandse vertaling gegeven.
Voor het verwerken en tonen van waarden uit bestaande terminologie- en codestelsels (zoals SNOMED CT en LOINC) in een PGO, kan het volgende uitgangspunt gehanteerd worden:
- Indien er een Nederlandse patiëntvertaling beschikbaar is, toon deze aan de PGO-gebruiker.
- Indien een Nederlandse patiëntvertaling ontbreekt, maar er wel een Nederlandse zorgverlenervertaling beschikbaar is, toon deze aan de PGO-gebruiker.
- Indien zowel een Nederlandse patiëntvertaling als een zorgverlenervertaling ontbreken in het terminologie- of codestelsel, volg de dataset, waarin voor uitgewerkte waardelijsten ook Nederlandse termen beschikbaar zijn.
- Indien Nederlandse vertaling geheel ontbreekt, kan de Engelse term getoond worden.
Meer informatie over eventueel benodigde licentie en implementatie van terminologie- en codestelsels is te vinden in het standaarden overzicht van Nictiz
Ook wat betreft de omschrijving van informatie geniet het de voorkeur om ze veel mogelijk gebruik te maken van Nederlandse termen. De (omschrijvingen van de) conceptnamen die in zibs gehanteerd worden, kunnen gebruikt worden, evenals correcte Nederlandse synoniemen daarvan die mogelijk beter aansluiten op het persoonsdomein.
Technisch
Voor de waardelijsten in de zibs zijn FHIR ValueSet-resources gemaakt. Deze bevatten gestructureerd de Nederlandse vertalingen van de zib-concepten en worden dus bij de standaard aangeboden. Leveranciers kunnen bij het weergeven van concepten uit deze ValueSets dan ook kiezen voor de Nederlandse vertaling.
De ValueSets zijn óf direct gekoppeld in de FHIR-profielen, of kunnen, indien dit niet mogelijk is, via een FHIR ConceptMap gerelateerd worden aan de waarden die binnen een profiel gebruikt worden. Zie hiervoor de specificaties in de FHIR-implementatiegids.
1.4.1.3 Referenties
MedMij informatiestandaarden gebruiken zoveel mogelijk bestaande zibs. Deze zibs verwijzen naar elkaar middels referenties. FHIR kent ook het concept van referenties. Via zo'n referentie kan bijvoorbeeld ook het specialisme van een zorgverlener bij een verrichting opgehaald worden. Het uitgangspunt is dat alle references 'resolvable' (opvraagbaar) moeten zijn, niet dat ze resolved worden. Een PGO zou er ook voor kunnen kiezen om een klikbare link te tonen, waarmee een gebruiker (de persoon) desgewenst zelf kan 'resolven', eventueel zelfs in een nieuwe sessie (na de initiële 15 minuten). Meer informatie over het gebruik van FHIR-references binnen MedMij is te vinden in de informatiestandaardoverstijgende principes in de FHIR-implementatiegids.
1.4.2 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 afsprakenstelsel met spelregels die zorgen dat de gegevensuitwisseling veilig is, privacy geborgd is en dat systemen aan juridische eisen voldoen.
1.4.3 Geografische reikwijdte
De geografische scope van alle ontwerpen van MedMij is Nederland.
1.5 Kwalificatie
1.5.1 Introductie
Op deze informatiestandaard is een Nictiz kwalificatie van toepassing. Kwalificatie vindt plaats per systeemrol.
Enkele systeemrollen vallen binnen de 'subsidieregeling voor PGO-leveranciers (dienstverlener persoon)' die in 2018 is opgesteld door de Dienst Uitvoering Subsidie voor Instellingen. Welke systeemrollen dat betreft vindt u in ToelichtingSubsidie.
Voor meer informatie, stuur een mail naar 'kwalificatie@medmij.nl'.
Kwalificatiescripts en meer informatie over de kwalificatie is te vinden via de betreffende paragraaf op de Kwalificatiepagina.
2 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.
3 Ontwerpen
Patient journeys beschrijven de mogelijkheden die MedMij biedt vanuit het perspectief van een fictieve patiënt. Deze paragraaf start met de Patient journeys die MedMij hanteert.
De paragraaf vervolgt met een index in tabelvorm gesplitst naar de use cases van het afsprakenstelsel:
3.1 Haal gegevens op uit XIS
3.1.1 Algemeen
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.
3.1.2 What's new
Een PGO kan na een eerste raadpleging nieuwe of gewijzigde gegevens raadplegen middels een "what's new" uitvraag. Voordeel van deze functionaliteit is dat niet onnodig reeds bekende gegevens opnieuw beschikbaar gesteld hoeven te worden. Denk hierbij aan wederom raadplegen van een volledige gegevensset zoals de BgZ. PGO dient hiervoor de datum van eerdere raadpleging te bewaren, om te gebruiken in een nieuwe raadpleging. XIS dient deze datum te kunnen verwerken. Technische uitwerking staat in de "overarching principles" van het technisch ontwerp.
3.2 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.
| Index sturen / ontvangen | |||||
| Informatiestandaard | Versie | Use case | Functioneel | Technisch | |
 |
Zelfmetingen | Zelfmetingen sturen | |||
|
eAfspraak | Afspraak maken | |||
| Afspraak annuleren | |||||
| Afspraak wijzigen | |||||
 |
PDF/A | PDF/A | |||
|
Beelden | Beelden sturen | |||
|
Vragenlijsten | Vragenlijsten | |||
3.3 Patient journeys
3.3.1 Thomas van Beek
De beschrijving van de casus van de fictieve patiënt Thomas van Beek vindt u 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.
3.3.2 Roos Dalstra
De beschrijving van de casus van de fictieve patiënt Roos Dalstra vindt u 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.
4 Systeemrollen
De informatiestandaard kent altijd een formele beschrijving met ten minste de volgende metagegevens: De informatiestandaard (met een informatiestandaardnaam) bestaat uit een of meer transacties (met per transactie een transactienaam), met voor elk van de transacties een aanduiding van de bijbehorende systeemrollen en de bijbehorende bedrijfsrol (Patiëntbedrijfsrol of Zorgaanbiedersbedrijfsrol). Op basis van de systeemrol wordt door de MedMij autorisatieraad, het bestuur van Stichting MedMij, een systeemrolcode toegekend. Deze identificeert 1 versie van 1 systeemrol. Een versie van een systeemrol wordt geïdentificeerd door 1 Systeemrol-code. Deze metagegevens zijn van belang voor de definitie van de gegevensdiensten binnen het MedMij afsprakenstelsel. Nadere informatie over gegevensdiensten, zoals de geldigheidsperiode, vindt u in de Catalogus van het MedMij Afsprakenstelsel.
In het register van informatiestandaarden zijn alle systeemrollen opgenomen die van toepassing zijn in de MedMij use cases.
5 Release notes
| Versie | BITS issue | Omschrijving |
|---|---|---|
| 2019.01 - Mei 2022 | MM-3204 | In de Touchstone-handleiding is een waarschuwing geplaatst over het verwijderen van de USER_KEY of ORG_KEY in publieke plekken. |
| 2019.01 - April 2022 | MM-3195 | The announced deprecation date for the 2019.01 standards has been changed from May 1 to July 1, 2022. |
| 2019.01 - Januari 2022 | MM-2324 | All LoadResources scripts for the qualification materials are bundled per main folder (MedMij-20XX.0X-Test/Cert), leading to less overhead in the montly update cycle. |
| 2019.01 - November 2021 | MM-2494 | The header 'MedMij-Request-ID' in TestScripts is now properly filled with a generated UUID without showing this process to the user. |
| 2019.01 - Juni 2021 | MM-2175 | A "known issue" remark was added to the nl-core-humanname profile to explain that it is not entirely compatible with how names are normally communicated in FHIR – initials and nicknames are added to the same name element rather than additional elements. Guidance has been added on how implementers should deal with this. |
| 2019.01 - Mei 2021 | MM-2093 | Narratives for all TestScript fixtures have been regenerated. |
| 2019.01 - April 2021 | MM-1976 | In de TestScript-resources is de datum (.date-element) vervangen door een "patchlevel"-toevoeging in de versie (.version-element). |
| 2019.01 - Maart 2021 | MM-1925 | Replaced the text on "Use of the reference datatype" in the 2019.01 version of the MedMij FHIR IG with the updated text from the 2020.01 version of the MedMij FHIR IG (FHIR IG 1.0). |
| MM-1911 | We have fixed an incorrect hyperlink in the profiles nl-core-patient & nl-core-person to the ConceptMap of GeslachtsCodeLijst to AdministrativeGender. | |
| MM-1750 | De Nictiz FHIR 3.0.1 en Nictiz Dev testsystemen zijn verwijderd in Touchstone. | |
| 2019.01 - Februari 2021 | MM-1828 | The assert in TestScripts that checks if a BSN identifier is present in a Patient resource is improved. |
| MM-1758 | Url's to the HL7 FHIR wiki pages on MedMij wiki pages pointed to a deprecated version, this has been corrected, the url's now point to the new HL7 Confluence pages. | |
| 2019.01 - Januari 2021 | MM-1385 | In the Simplifier project view, the status badge for profiles has been changed from "active" to "prerelease" as a visual indication that profiles in this view do not align with the released profiles in the package. |
| 2019.01 - Oktober 2020 | MM-1454 | In the FHIR IG, change the requirement for resource.id from SHALL to SHOULD for searchset Bundles, remove the requirement to use the UUID to populate the id field. Add extra guidance on this topic. |
| MM-1446 | Op de MedMij-landingspagina ontbrak de verwijzing naar de kwalificatiepagina voor publicatie 2019.01, deze is toegevoegd. | |
| MM-1386 | Replaced incorrect links to the Simplifier project in the 'Terminology, NamingSystems, Mappings' section of IGs by references to the relevant published packages. | |
| 2019.01 - September 2020 | MM-1116 | Removed FHIR patch level version from file names and descriptions of qualification materials. |
| 2019.01 - Mei 2020 | MM-1175 | Added a comment in the nl-core-address profile at Address.use.extension:AD_use to signal a known issue. |
| MM-1169 | Gezien BITS reeds goede naslag biedt voor wijzigingen in de MedMij-informatiestandaarden, is er voor gekozen om de sectie "Paginahistorie" (in functionele ontwerpen) en "History" (in FHIR IG's) te verwijderen. | |
| MM-1167 | Add a binding strength of "extensible" to maritalStatus in nl-core-patient. | |
| MM-1155 | In nl-core-address, changed the slicing logic to enable support for both GBA and ISO land codes. | |
| MM-1095 | Add guidance about the use of FHIR id's and Bundle fullUrl's in the different circumstances to the 'overarching principles' section of the MedMij IG. | |
| MM-1083 | Added mapping for zib FamilySituation concept MaritialStatus to the profile for nl-core-patient | |
| MM-1081 | Added meta.profile declaration to some examples where it was missing. | |
| MM-1054 | Changed the package dependency of the information standards from the patch level to the minor level, as all patch level packages are interchangable. | |
| 2019.01 - April 2020 | MM-1053 | Changed mapping name in nl-core-organization profile from 'HCIM Patient-v3.1.1(2017EN)' to the correct 'HealthcareProvider-v3.1.1(2017EN)' as it was incorrect and could lead to misunderstanding. |
| MM-1015 | Added a generated narrative to all example instances. | |
| MM-1002 | In extension patient-nationality of the nl-core-patient profile, the binding on NationaleCodelijst has been moved from the root to the code slice. | |
| MM-929 | Added the code-specification extension to all examples where a ConceptMap is involved to clarify its use. | |
| MM-770 | Updated example materials of nl-core-contactpoint profile to include relevant extensions as required by the zib and fixed mistakes in mapping. | |
| MM-672 | Er werden verouderde en verschillende schrijfwijzen gehanteerd van de term zib en zibs (afkorting van zorginformatiebouwstenen), dit is gecorrigeerd in de MedMij standaarden | |
| MM-513 | In the nl-core-organization examples, added Organization.partOf for the aid of interpreting what an organization with multiple locations looks like. | |
| 2019.01 - Maart 2020 | MM-969 | Updated irrelevant value of address.city & address.district in all examples. |
| MM-947 | Extension code-specification is in use under Address.country, but this context was not yet declared as valid in this extension. | |
| MM-943 | Updated coding.display names in extension-comment extension and in example instance (zib-Stoma-01) to match the display name in LOINC. | |
| MM-942 | References to XML Schematron have been removed from example instances. These do not serve any implementation purpose and are not permitted by the Java validator. | |
| MM-938 | For a number of profiles, the StructureDefinition.id in now matches the final part of StructureDefinition.url. This improves predictability of handling the profile set in various reference frameworks. | |
| MM-930 | .description and .id were absent in all ConceptMap recources. These two values have been added, with .id containing the final part of the canonical url. | |
| MM-894 | In zib-FamilySituation, zib-FamilySituationChild and zib-BodyHeight profiles, remove additional reference types from subject element. | |
| MM-888 | Een hoofdstuk toegevoegd aan de kwalificatiepagina met uitgangspunten voor kwalificatie. | |
| MM-815 | Tekstuele harmonisatie en verduidelijking rondom het concept "systeemrolcodes" doorgevoerd en bijbehorende tabellen aangevuld en gecorrigeerd in de MedMij standaarden in paragraaf/paragrafen Systeem & Systeemrollen. | |
| MM-751 | Upped fhirVersion in FHIR profiles from "3.0.1" to "3.0.2.", changed Simplifier package dependency from "Simplifier.Core.STU3 3.0.3" to "hl7.fhir.r3.core 3.0.2". | |
| 2019.01 - Februari 2020 | MM-913 | Verschillende functionele-ontwerppagina's verwezen nog naar een oude versie van het MedMij-afsprakenstel. Deze links zijn aangepast naar de huidige versie. |
| MM-857 | Some FHIR example instances don't contain a narrative. Removed the unnecessary text.status values at these examples. | |
| MM-831 | Add documentation on the BSN format in the Patient.identifier:BSN slice of the nl-core-patient profile. | |
| MM-827 | We have added a small text about the published examples on Simplifier at the IG-pages from every information standards (except Medication). | |
| 2019.01 - Januari 2020 | MM-800 | The contact info of the ValueSets included the invalid url "https://www.zibs.nl". This has been changed to the valid url "https://zibs.nl". |
| MM-780 | Changed equivalence type from specializes to subsumes for 2 concept mappings in ConceptMap TelecomSoortCodelijst-to-ContactPointSystem. | |
| MM-778 | Added bi-directional extension to each ConceptMap and set to true if bidirectional or false if not bidirectional. Secondly added the code.specification extension to the FHIR-profiles where the extension was not added yet: zib-AllergyIntolerance, zib-Encounter, zib-Problem, nl-core-contactpoint. | |
| MM-738 | Changed required binding for extensible on Patient.maritalStatus ValueSet reference in nl-core-patient FHIR-profile. | |
| MM-659 | Improved searchInclude element in all CapabilityStatements based on [resource]:[search param]. | |
| MM-636 | Changed the mandatory nature of the display element in coded concepts from SHALL to SHOULD. | |
| MM-632 | Restructured, renamed and optimized FHIR-examples. | |
| MM-619 | In the LanguageProficiency extension for nl-core-patient:
| |
| MM-563 | Removed unnecessary constraint on Humanname.extension:humannameassemblyOrder extension in nl-core-humanname FHIR profile. | |
| MM-296 | Added explanation for the use of ConceptMaps and mappings to the FHIR IG. | |
| 2019.01 - November | MM-734 | Remove old ValueSet files that still lingered in the package after they were re-exported under a different file name. |
| 2019.01 - Oktober | MM-580 | Some ValueSet files used a notation that is not used anymore in newer exports from ART-DECOR. The ValueSet files in the repository and package are re-exported from ART-DECOR. ValueSet files that are not used anymore are removed from the repository and package. |
| MM-229 | Added base profile nl-core-observation to FHIR profiles based on core resource Observation. | |
| 2019.01 - September | MM-570 |
Removed duplicate files on Simplifier with the following id's:
Adjusted duplicate id's in examples. |
| MM-461 | De Richtlijn paragraaf was toegespitst op BgZ. Tekst is generiek herschreven met minder nadruk op BgZ. | |
| MM-441 | Verbeteren richtlijn omtrent gebruik Nederlandse vertalingen. | |
| MM-438 | Toevoegen nl-core-contactpoint. | |
| MM-409 | Toevoegen ontbrekende ConceptMaps en zib FHIR ValueSets. | |
| MM-401 | Nadere toelichting ten aanzien van gebruik Nederlandse termen bij omschrijving van informatie (labels) in PGO. | |
| 2019.01 - April | MM-222 | Update verouderde tekst van richtlijn paragraaf op FO Ontwerp pagina. |
| MM-220 | Nadere toelichting ten aanzien van FHIR references. | |
| MM-219 | MedicationUse niet compleet na een resave in Forge. | |
| 2019.01 - Maart | MM-200 | Verloren wijzigingen d.m.v. foutieve commit goed zetten. |
| MM-198 | PractitionerRole extensie ontbreekt bij Patient.generalPractitioner. | |
| MM-189 | Concept PractitionerRole wijkt af van FHIR core. | |
| 2019.01 | MM-180 | Toelichting functionele definitie via zibs, inclusief Nederlandse termen zorggegevens. |
| MM-149 | Patient.gender mist ConceptMap voor GeslachtCodelijst. | |
| MM-139 MM-133 |
PractitionerRole reference extensie toegevoegd aan elementen die naar Practitioner verwijzen. | |
| MM-122 | ConceptMaps benoemen + aanmaken. | |
| MM-89 | Consistentie referenties naar (zib) profielen of base resources voor niet-zib concepten. | |
| MM-88 | Mapping BasisElementen ontbreekt. | |
| MM-72 | Added concept name to all profile mappings from HCIMs or datasets. | |
| MM-70 | Updated links in technical design pages for profiles so they have less maintenance. | |
| MM-65 | Generic guidance on references added. | |
| 2018.06 | MM-136 | Payer.PayerPerson.PayerName is a String but simplifier says it is a nl-core-humanname. |
| MM-83 | Tegenstellende definities van land tussen de Nictiz zib wiki en de FHIR standaarden. | |
| MM-81 | Gebruik van AddressType in AddresInformation zib. | |
| MM-77 | Ambiguïteit bij HouseNumberAddition/HouseNumberLetter. | |
| MM-76 | Wat hoort er thuis in het FirstNames veld in de NameInformation zib? | |
| MM-47 | Suggestion: require display or text on codes. |
6 Releases
| Versie | Datum | Omschrijving |
|---|---|---|
| 2019.01 | 2019-10-18 | Use case medicatiegerelateerde allergie- en intolerantiegegevensvertaling toegevoegd |
| 2019.01 | 2019-10-02 | Use case PDF/A Sturen toegevoegd |
| 2019.01 | 2019-03-11 | Alle MedMij-standaarden |
| 2018.06 | 2018-10-29 | Basisgegevens GGZ |
| 2018.05 | 2018-09-24 | Basisgegevens GGZ voor openbare consultatie |
| 2018.04 | 2018-09-02 | eAfspraak fase 2 |
| 2018.03 | 2018-05-07 | BgZ 2017 en Huisartsgegevens |
| 2018.02 | 2018-03-29 | BgZ 2017 voor openbare consultatie |
| 2018.01 | 2018-02-21 | Huisartsgegevens voor openbare consultatie |
| 2017.04 | 2017-12-18 | Medicatie, Laboratoriumresultaten, Allergie/intolerantie, Zelfmetingen |
| 2017.03 | 2017-11-07 | PDF/A |
| 2017.02 | 2017-10-11 | eAfspraak |
| 2017.01 | 2017-10-02 | BgZ 2015 |