MedMij:Vsuperdraft Kwalificatie
1 Introductie
Op MedMij informatiestandaarden met bijbehorende gegevensdiensten zijn Nictiz kwalificaties van toepassing. Kwalificaties vinden plaats per systeemrol. Een systeemrol(code) is gebaseerd op de informatiestandaard inclusief versie, de transactie en uitwisselingsstandaard.
Kwalificatiescripts en meer informatie over een kwalificatie is te vinden via de betreffende paragrafen op de kwalificatiepagina.
2 Algemene voorwaarden voor kwalificatie
Een leverancier kan starten met een kwalificatie, als hij voldoet aan onderstaande voorwaarden:
- Kennis en begrip van MedMij afsprakenstelsel.
- Kennis over de te gebruiken infrastructuur of het netwerk waarover uitgewisseld wordt en de toegang daartoe, inclusief authenticatie/autorisatie etc.
- Kennis en begrip van de betreffende MedMij informatiestandaard, zoals beschreven op de informatiestandaarden wiki van Nictiz.
- Kennis en begrip en het kunnen toepassen van de verschillende tabellen, waardenlijsten en andere referenties die de informatiestandaard gebruikt.
- Kennis en begrip en het naleven van de aandachtspunten zoals beschreven in het document 2. Addenda - Kwalificaties als bijlage bij de betreffende informatiestandaard.
- Alle gegevens die de kwalificerende partij zelf moet invoeren zijn te vinden in de kwalificatiedocumentatie. Onjuist ingevoerde gegevens (ook tijd/datum etc.) zullen leiden tot vertraging van en kunnen blokkerend zijn voor het kwalificatieproces.
- Inhoudelijke informatie, beschreven in de informatiestandaard, moet altijd toegankelijk zijn voor de eindgebruiker. De leverancier levert voor deze informatie schermafdrukken op voor controle.
- Deze kwalificatie toetst geen infrastructurele eisen.
3 Uitgangspunten voor kwalificatie
In dit hoofdstuk worden de generieke uitgangspunten voor de kwalificatie per systeemrol uiteengezet. Per informatiestandaard kan het voorkomen dat er nog 'specifieke' uitgangspunten op van toepassing zijn, in dat geval, zijn deze opgenomen in een aparte paragraaf onder het hoofdstuk 'Kwalificatie' van het functioneel ontwerp van de informatiestandaard.
3.1 Systeemrol 'Raadplegen' (PGO)
Hieronder volgt het generieke uitgangspunt voor de kwalificatie van de systeemrol 'Raadplegen':
- Een PGO biedt de persoon inzicht in de ontvangen respons. Als er géén gegevens beschikbaar gesteld worden, kan dat zijn omdat er geen informatie beschikbaar is in het XIS of vanwege een technische foutmelding. Er volgt bijvoorbeeld een foutmelding indien de resource, een specifieke zib, niet wordt ondersteund in het XIS. Het is een belangrijk inzicht voor de persoon dat gegevens technisch niet beschikbaar gesteld kan worden.
3.2 Systeemrol 'Beschikbaarstellen' (XIS)
Hieronder volgen de generieke uitgangspunten voor de kwalificatie van de systeemrol 'Beschikbaarstellen':
- XIS geeft technisch correct antwoord op alle searches ongeacht of de gegevens in XIS beschikbaar zijn. XIS stelt alle gegevens beschikbaar voor zover aanwezig.
- Mochten gegevens niet beschikbaar gesteld kunnen worden, dan is uit de respons voor de persoon te herleiden waardoor dit veroorzaakt wordt:
- veroorzaakt door het ontbreken van de informatie
- veroorzaakt doordat het XIS dit technisch niet kan leveren.
- In het geval dat een vraag om gegevens goed wordt verwerkt door het XIS, volgt een respons met daarin 0 tot * FHIR resources die matchen aan de vraag. Als er dus 0 resources in zitten mag de persoon ervan uitgaan dat het XIS deze gegevens niet heeft, maar de vraag wel goed begrepen heeft.
- Als er technisch iets niet goed gaat, stuurt het XIS conform de specificaties een foutcode terug samen met een OperationOutcome, waarin de oorzaak wordt getoond. Bijvoorbeeld dat de resource, een specifieke zib, niet wordt ondersteund in het XIS. Deze moet ingebouwd worden door het XIS. Hierop wordt het XIS ook gekwalificeerd.
4 Kwalificatie aansluiten op de kwalificatieomgeving
MedMij biedt leveranciers de mogelijkheid hun producten en diensten te laten testen op correcte implementatie van informatiestandaarden. Documentatie over hoe aan te sluiten is te vinden op: MedMij:V2019.01_Kwalificatie_aansluiten
5 Gebruik van de simulator
5.1 Authorization tokens
Voor uitleg over gebruik van de simulator en tokens, zie MedMij:V2019.01_Qualification
5.2 Variable T datum
Voor veel, straks alle, kwalificaties wordt er gebruik gemaakt van een variabele datum. Dit is de zogenoemde T datum welke is opgenomen in de functionele testscripts, met name in de addenda, en in de technische testscripts op Touchstone. Deze variabele datum wordt gebruikt om zo dicht mogelijk tegen een productiewaardig scenario te testen en te kwalificeren. Middels de variabele datum kunnen de testgegevens actueel blijven. Deze T datum komt op twee plekken terug, namelijk in de datumvelden van de testgegevens en in de datumparameters in de search URL's. In de volgende twee paragrafen wordt dit toegelicht.
5.2.1 Kwalificatie test gegevens
De functionele testscripts beschrijven in de addenda testgegevens waarin datum velden staan op basis van een T datum. Als ergens staat T – 100D betekent dit: 100 dagen eerder dan de datum die voor T geldt. Deze testgegevens uit de addenda worden vervolgens gebruikt om ofwel de Nictiz WildFHIR server te vullen of door kandidaat deelnemers om de testgegevens in het systeem te registreren.
Het vullen van de Nictiz WildFHIR server kon in het verleden door kandidaatdeelnemers gebeuren door het draaien van het 'load script' op basis van een op te geven variable T. Dit is nu in beheer genomen door het kwalificatie team.
Elke maandag wordt de Nictiz WildFHIR server geschoond en opnieuw gevuld met een testgegevens op basis van een T datum gelijk aan de datum van die maandag.
Bijvoorbeeld in 2019 is T datum in week 46 gelijk aan 11 november 2019.
5.2.2 Parameters in de request URL's
Bij sommige testscenario's wordt een datumfilter gebruikt. Deze datumfilters zijn ook op basis van de variabele T datum. Bij het uitvoeren van het testscript in Touchstone is het mogelijk om bij de setupfase de variabele T datum te geven. Deze T datum staat in relatie tot de testgegevens die op de Nictiz WildFHIR server of het eigen bronsysteem staan. De T datum die hier gebruikt dient te worden, is gelijk aan de datum van de maandag (waarop de gegevens geladen zijn).
Wanneer een andere T datum wordt gebruikt kan het voorkomen dat er geen of te weinig testgegevens terugkomen op de uitgevoerde test. Dit kan er toe leiden dat de test niet slaagt.
5.2.3 Tijdnotatie
Het meegeven van de tijd is bij de gestructureerde einddatum/tijd (dus niet de Resource.text, maar de velden met alleen de datum/tijd) verplicht in de standaard om eventuele verwarring tussen de precieze betekenis van "tot" en "tot en met" te voorkomen.
In de FHIR datatypes dateTime (indien uren en minuten worden gebruikt) en instant is de tijdzone verplicht. De tijdzone kan daarom niet worden weglaten uit de testgegevens.
Touchstone heeft helaas een beperking dat de Nederlandse tijdzone niet berekend kan worden bij een variabele datum. De tijdzone die nu in onze testgegevens staat, was een Nederlandse tijdzone bij de eerste keer invullen van dit scenario met concrete datums. Dit komt niet per definitie overeen met de geldende tijdzone in Nederland voor de (in een test-executie gebruikte, uiteindelijke) datum. In productie moet gerekend worden op een juiste tijdzone en het is dan ook juist om deze tijdzone gewoon te interpreteren, dit betekent dat de gegevens mogelijk soms een uur later of vroeger zijn dan in het addendum staat. Dit is geen reden voor afkeuren in kwalificatie.
6 Kwalificatiebenodigdheden
6.1 Basisgegevensset Zorg 2.1
6.1.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen BgZ.pdf
- 2. Addenda - Kwalificatiescript - MedMij Raadplegen BgZ.pdf
- 3. Aanleverformat - Raadplegen BgZ.zip
6.1.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf
- 2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen BgZ.pdf
- 3. Aanleverformat - Beschikbaarstellen_BgZ.zip
6.2 Labuitwisseling 1.1
6.2.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen Laboratoriumresultaten.pdf
- 2. Addenda - Kwalificatiescript – MedMij Raadplegen Laboratoriumresultaten.pdf
- 3. Aanleverformat - Raadplegen Laboratoriumresultaten.zip
6.2.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen Laboratoriumresultaten.pdf
- 2. Addenda - Kwalificatiescript – MedMij Beschikbaarstellen Laboratoriumresultaten.pdf
- 3. Aanleverformat - Beschikbaarstellen Laboratoriumresultaten.zip
6.3 Medicatieproces 9.0
- Een uitleg van medicatieproces voor PGO's die kwalificeren voor MedMij is beschikbaar in de vorm van:
- Bestand (met mp4 opname) van uitleg Medicatieproces met bijbehorende
- PowerPoint (in PDF).
6.3.1 Medicatiegegevens
6.3.1.1 DVP
Use-case: raadplegen
- 1.1. Kwalificatiescript - Raadplegen medicatieafspraak907.pdf
- 1.2. Kwalificatiescript - Raadplegen toedieningsafspraak907.pdf
- 1.3. Kwalificatiescript - Raadplegen medicatiegebruik907.pdf
- 1.4. Kwalificatiescript - Raadplegen verstrekkingsverzoek907.pdf
- 1.5. Kwalificatiescript - Raadplegen medicatieverstrekking907.pdf
- 1.6. Kwalificatiescript - Raadplegen medicatiegegevens AlleBouwstenen907.pdf
- 2.1. Addenda - Raadplegen medicatieafspraak907
- 2.2. Addenda - Raadplegen toedieningsafspraak907
- 2.3. Addenda - Raadplegen medicatiegebruik907
- 2.4. Addenda - Raadplegen verstrekkingsverzoek907
- 2.5. Addenda - Raadplegen medicatieverstrekking907
- 2.6. Addenda - Raadplegen medicatiegegevens AlleBouwstenen907
- 3.1. Aanleverformat - Raadplegen medicatieafspraak907.zip
- 3.2. Aanleverformat - Raadplegen toedieningsafspraak907.zip
- 3.3. Aanleverformat - Raadplegen medicatiegebruik907.zip
- 3.4. Aanleverformat - Raadplegen verstrekkingsverzoek907.zip
- 3.5. Aanleverformat - Raadplegen medicatieverstrekking907.zip
- 3.6. Aanleverformat - Raadplegen medicatiegegevens AlleBouwstenen907.zip
6.3.2 Medicatieoverzicht
6.3.2.1 DVP
Use-case: raadplegen
6.3.3 Verstrekkingenvertaling
6.3.3.1 DVP
Use-case: raadplegen
6.3.3.2 DVZA
Use-case: beschikbaarstellen
6.4 AllergieIntolerantie 2.0
6.4.1 AllergieIntolerantie
6.4.1.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen AllergieIntolerantie gegevens.pdf
- 2. Addenda - MedMij Raadplegen AllergieIntolerantie gegevens.pdf
- 3. Aanleverformat - Raadplegen AllergieIntolerantie.zip
6.4.1.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen AllergieIntolerantie gegevens.pdf
- 2. Addenda - MedMij Beschikbaarstellen AllergieIntolerantie gegevens.pdf
- 3. Aanleverformat - Beschikbaarstellen AllergieIntolerantie.zip
6.4.2 AllergieIntolerantieVertaling
6.4.2.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling
- 3. Aanleverformat - Raadplegen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip
6.4.2.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling
- 3. Aanleverformat - Beschikbaarstellen medicatiegerelateerde allergie- en intolerantiegegevensvertaling.zip
6.5 eAfspraak 1.1
6.5.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf
- 2. Addenda - Kwalificatiescript - MedMij Raadplegen eAfspraak.pdf
- 3. Aanleverformat - Raadplegen eAfspraak.zip
6.5.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf
- 2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen eAfspraak.pdf
- 3. Aanleverformat - Beschikbaarstellen eAfspraak.zip
6.6 Zelfmetingen 1.2
6.6.1 DVP
Use-case: raadplegen & use-case: sturen
- 1. Kwalificatiescript - MedMij Raadplegen en Sturen Zelfmetingen.pdf
- 2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen Zelfmetingen.pdf
- 3. Aanleverformat - Raadplegen en Sturen Zelfmetingen.zip
6.6.2 DVZA
Use-case: beschikbaarstellen & use-case: ontvangen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Zelfmetingen.pdf
- 2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen Zelfmetingen.pdf
- 3. Aanleverformat - Beschikbaarstellen en Ontvangen Zelfmetingen.zip
6.7 PDF/A 2.0
6.7.1 DVP
Use-case: raadplegen & use-case: sturen
- 1. Kwalificatiescript - MedMij Raadplegen en Sturen PDFA.pdf
- 2. Addenda - Kwalificatiescript - MedMij Raadplegen en Sturen PDFA.pdf
- 3. Aanleverformat - Raadplegen en Sturen PDFA.zip
6.7.2 DVZA
Use-case: beschikbaarstellen & use-case ontvangen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen PDFA.pdf
- 2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen en Ontvangen PDFA.pdf
- 3. Aanleverformat - Beschikbaarstellen en Ontvangen PDFA.zip
6.8 Huisartsgegevens 1.1
6.8.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf
- 2. Addenda - Kwalificatiescript - MedMij Raadplegen Huisartsgegevens.pdf
- 3. Aanleverformat - Raadplegen huisartsgegevens.zip
6.8.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf
- 2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Huisartsgegevens.pdf
- 3. Aanleverformat - Beschikbaarstellen huisartsgegevens.zip
6.9 Basisgegevens GGZ 1.1
6.9.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf
- 2. Addenda - Kwalificatiescript - MedMij Raadplegen Basisgegevens GGZ.pdf
- 3. Aanleverformat - Raadplegen Basisgegevens GGZ.zip
6.9.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf
- 2. Addenda - Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens GGZ.pdf
- 3. Aanleverformat - Beschikbaarstellen Basisgegevens GGZ.zip
6.10 Beelden 1.0
6.10.1 DVP
Use-case: sturen
- 1. Kwalificatiescript - MedMij Sturen beelden.pdf
- 2. Addenda - Kwalificatiescript - MedMij Sturen beelden.pdf
- 3. Aanleverformat - Sturen Beelden.zip
6.10.2 DVZA
Use-case: ontvangen
- 1. Kwalificatiescript - MedMij Ontvangen beelden.pdf
- 2. Addenda - Kwalificatiescript - MedMij Ontvangen beelden.pdf
- 3. Aanleverformat - Ontvangen Beelden.zip
6.11 Basisgegevens Langdurige Zorg 1.0
6.11.1 DVP
Use-case: raadplegen
- 1. Kwalificatiescript - MedMij Raadplegen Basisgegevens Langdurige Zorg.pdf
- 2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1
- 2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2
- 2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3
- 3. Aanleverformat - Raadplegen Basisgegevens Langdurige Zorg.zip
6.11.2 DVZA
Use-case: beschikbaarstellen
- 1. Kwalificatiescript - MedMij Beschikbaarstellen Basisgegevens Langdurige Zorg.pdf
- 2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.1
- 2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.2
- 2. Addenda voor inhoudelijke gegevens Beschikbaarstellen/Raadplegen Basisgegevens Langdurige Zorg - scenario 1.3
- 3. Aanleverformat - Beschikbaarstellen Basisgegevens Langdurige Zorg.zip