MedMij:Vprepub-2020.01/Kwalificatie FAQ

Uit informatiestandaarden
Versie door Jeanique Ngadimin (overleg | bijdragen) op 30 jul 2020 om 13:47 (MM-1220 - Overbrengen FAQ kwalificatiepagina)
(wijz) ← Oudere versie | Huidige versie (wijz) | Nieuwere versie → (wijz)
Naar navigatie springen Naar zoeken springen

MedMij:Vprepub/Issuebox

Kwalificatie Proces

Wat is de gemiddelde doorlooptijd van een (pre-)kwalificatie

Wanneer krijg ik terugkoppeling over mijn kwalificatie?

Hoe moet ik de schermprinten van aanleveren?

Wat is het verschil tussen een pre-kwalificatie, kwalificatie, kwalificatie 2 etc.?

Ik heb mijn materiaal hersteld, kan ik het direct aanleveren?

Ik wil graag een (technisch) expert spreken over mijn kwalificatie of Touchstone. Hoe kan ik dat het snelst doen?

Ik kan niet het volledige kwalificatie-script ondersteunen, wat nu?

Ik loop uit en ben bang dat ik mijn acceptatieslot niet ga redden, wat nu?

Ik ben een integrator en kan geen schermprinten aanleveren, wat nu?

Functionele Kwalificatie

Waar vind ik de eisen terug?

Binnen de standaard wordt een oudere ZIB-versie vereist, dan de laatste release van ZIBs. Mag een nieuwere versie van de ZIB worden geïmplementeerd?

Hoe werkt de variabele T?

Hoe stel ik datum T in?

Hoe werken parameters in de request URL's?

Technische Kwalificatie

Het technisch op de juiste manier FHIR berichten genereren, blijkt in de praktijk vaak niet bij de eerste kwalificatie goed te gaan en levert daarmee vertraging op in het kwalificatieproces. Om het kwalificatieproces soepeler te laten verlopen, is een overzicht gemaakt van fouten in de FHIR berichten die het vaakst opduiken tijdens de technische kwalificatie. In het hieronder volgende overzicht wordt duidelijk gemaakt:

  • Welke informatiestandaard wordt geraakt.
  • Wat de fout betreft.
  • Waar de fout doorgaans in het bericht te vinden is.
  • De ernst van de fout (blokkerend betekend dat herkwalificatie nodig is).
  • Uitleg over de fout met waar mogelijk, links naar de relevante informatie met waar mogelijk een stuk voorbeeldcode over wat verwacht wordt in de technische kwalificatie.

Het is sterk aangeraden om zelf voorafgaand aan de kwalificatie met behulp van deze tabel te controleren of FHIR berichten correct worden gegenereerd. Bij verdere vragen kan een ticket worden ingeschoten in Bits op het MedMij project.

Disclaimer: de gegeven voorbeelden zijn in XML, dit kan in de praktijk ook JSON zijn.

Informatiestandaard Veel voorkomende fouten Element Blokkerend Uitleg
Alle Resource.id ontbreekt Resource.id Ja, maar Hier komt een link nar https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_FHIR_IG#When_is_id_expected.3F
Alle Bundle.entry.fullUrl en Resource.id zijn niet consistent Resource.id Ja, maar

Link naar https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_FHIR_IG#Logical_ids.2C_fullUrls_and_references_in_Bundles

Fout

<!-- fullUrl met een foutieve AllergyIntolerance.id -->
<entry>
    <fullUrl value="http://example.org/fhir/AllergyIntolerance/f9125272-8305-11ea-5462-020000000000"/>
    <resource>
        <AllergyIntolerance>
            <id value="allergy-01"/>

--------
<!-- fullUrl met een foutieve Practitioner.id -->
<entry>
    <fullUrl value="urn:oid:2.16.528.1.1007.3.3.2222"/>
    <resource>
        <Practitioner>
            <id value="practitioner-01"/>

Goed

<!--  -->
<entry>
    <fullUrl value="http://example.org/fhir/AllergyIntolerance/f9125272-8305-11ea-5462-020000000000"/>
    <resource>
        <AllergyIntolerance>
            <id value="f9125272-8305-11ea-5462-020000000000"/>

--------
<!--  -->
<entry>
    <fullUrl value="urn:oid:2.16.528.1.1007.3.3.2222"/>
    <resource>
        <Practitioner>
            <id value="2.16.528.1.1007.3.3.2222"/>
Alle Bundle.entry.fullUrl mag niet een relatieve URL zijn Bundle.entry.fullUrl Ja Indien Bundle.entry.fullUrl URL's zijn, moeten deze absoluut zijn en niet relatief. De references binnen een resource mogen wel relatief te zijn als dit een URL is.

Verwacht in fullUrl is een absolute URL, een UUID of een OID. Zie

<!-- Bijvoorbeeld -->
<entry>
    <fullUrl value="urn:oid:2.16.840.1.113883.2.4.6.6.90000258.4.6.525"/>
Alle FHIR Resources bevatten niet alle in het script gevraagde informatie Ja, maar Voor kwalificatie doeleinden is het verplicht om alle informatie zoals vermeld in het addendum, mee te geven in het FHIR bericht of te tonen in de user interface.

FHIR profielen maken het mogelijk dat bepaalde informatie niet in alle gevallen bekend is en dwingen dus weinig af. Bij kwalificatie echter is de informatie wel bekend via het kwalificatiescript. Uitzonderingen kunnen gemaakt worden, bijvoorbeeld indien een HIS een bepaalde ZIB of data-element niet ondersteund. Per item dient dit voorafgaand kwalificatie te worden besproken en gewogen.

https://informatiestandaarden.nictiz.nl/wiki/MedMij:V2019.01_Kwalificatie#Kwalificatie_scripts

Alle FHIR Resources valideren niet tegen het verwachte profiel Ja Controleer voor elk profiel in simplifier of alle verplichte elementen zijn meegenomen. Deze verplichte elementen hoeven niet altijd onderdeel te zijn van het addendum. De validator in touchstone geeft hier naar alle waarschijnlijkheid een foutmelding over, maar hoeft niet te resulteren in een gefaalde test. Let daarom goed op of de test een 'w' voor warning oplevert. Bij onduidelijkheid omtrent de waarschuwing kan een ticket in bits worden ingestuurd.
Alle Datatype Reference, Coding of CodeableConcept mist display Meerdere elementen per resource mogelijk Ja Bij elke reference en CodeableConcept is een display value verplicht. Zie hiervoor de specificaties van het reference datatype in MedMij:
<generalPractitioner>
    <reference value="Organization/nl-core-organization-01"/>
    <display value="Maatschap Vaste Huisarts"/>
</generalPractitioner>
Alle Extensie code-specification waarin de zib-waarde staat, ontbreekt Meerdere elementen per resource mogelijk Ja, op plaatsen waar de mapping niet 1-op-1 is De extensie code-specification is bedoeld voor het meegeven van de oorspronkelijke zib-waarde als de FHIR Resource dat op die plaats niet direct toelaat. Dat zijn vaak statuscodes waarvoor FHIR zelf verplichte terminologie heeft. Om geen zib-informatie kwijt te raken, bijvoorbeeld omdat de mapping op de FHIR codes niet geheel 1-op-1 is, is meegeven van de zib-waarde dus van belang.

Bijvoorbeeld: gender (https://zibs.nl/wiki/Patient-v3.1(2017NL)), adres (soort, landcode, nummergebruik https://zibs.nl/wiki/Adresgegevens-v1.0(2017NL), naam (use, https://zibs.nl/wiki/Naamgegevens-v1.0.1(2017NL)) en eventueel andere.

    <gender value="male">
        <extension url="http://nictiz.nl/fhir/StructureDefinition/code-specification">
            <valueCodeableConcept>
                <coding>
                    <system value="http://hl7.org/fhir/v3/AdministrativeGender"/>
                    <code value="M"/>
                    <display value="Man"/>
                </coding>
            </valueCodeableConcept>
        </extension>
    </gender>
Alle Burgerservicenummer mag niet worden gebruikt in query en/of resources Ja Het MedMij afsprakenstelsel definieert op basis van vigerende wetgeving dat burgerservicenummers niet mogen worden uitgewisseld. Uitzondering vormen plaats waar het onredelijk of onmogelijk is om te eisen dat deze worden verwijderd, zoals in een PDF-document.

Gebruik in query-parameters zoals patient of subject, in een Bundle.link, als Patient.id, Patient.identifier en andere gestructureerde locaties op basis van BSN is niet toegestaan.

Alle Resource.text ontbreekt. Ook bekend als Narrative Resource.text Ja, maar Resource.text is SHOULD en moet dan een klinisch relevante/veilige samenvatting bieden van hetgeen in de resource staat. Om discussie te voorkomen over wat wel of niet klinisch relevant is, wordt geadviseerd om alle elementen uit het bericht, toe te voegen aan de narrative. Een ontvanger MAG deze gebruiken om te tonen. Slechts in een enkel geval zoals bij conformance resources (StructureDefinition, ValueSet etc.) een text element met status empty te gebruiken. Uitzondering op dit alles is de contained resource. Deze MAG GEEN text hebben. Zie
Alle FHIR server heeft geen CapabilityStatement, of kan deze niet opleveren met de verwachte minimale inhoud bij de informatiestandaard Ja Geen CapabilityStatement beschikbaar op het /metadata endpoint. Dit is een SHALL vanuit de FHIR spec: https://www.hl7.org/fhir/stu3/http.html#2.21.0
Alle Bundle van type searchset moet Bundle.link bevatten Bundle.link Ja Bundle.link heeft een SHALL in de FHIR spec, zie voor meer informatie:
<link>
    <relation value="self"/>
    <url value="http://nictiz.wildfhir.org/fhir3-i2/AllergyIntolerance?"/>
</link>
Alle HumanName mist extensies voor het identificeren van de verschillende naamdelen HumanName.family Ja Bij HumanName.family wordt een extensie verwacht die extra informatie geeft over de naamdelen, zoals voorgeschreven door de zib. https://zibs.nl/wiki/Naamgegevens-v1.0.1(2017NL) https://simplifier.net/NictizSTU3-Zib2017/nl-core-humanname
<family value="Jongeneel-de Haas">
   <extension url="http://hl7.org/fhir/StructureDefinition/humanname-own-name">
       <valueString value="Jongeneel"/>
   </extension>
   <extension url="http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix">
       <valueString value="de "/>
   </extension>
   <extension url="http://hl7.org/fhir/StructureDefinition/humanname-partner-name">
        <valueString value="Haas"/>
   </extension>
</family>

<given value="Irma">
  <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
    <valueCode value="CL"/>
  </extension>
</given>
<given value="I.">
  <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier">
    <valueCode value="IN"/>
  </extension>
</given>
Alle Address mist extensies voor het identificeren van de verschillende adresdelen Address.line Ja Bij Address.line wordt een extensie verwacht die gebruikt wordt om elk specifiek onderdeel van het Address de kunnen onderscheiden, zoals voorgeschreven door de zib.
<address>
        <extension url="http://fhir.nl/fhir/StructureDefinition/nl-core-address-official">
            <valueBoolean value="true"/>
        </extension>
        <use value="home"/>
        <type value="both"/>
        <line value="Straatweg 12bII">
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-streetName">
                <valueString value="Straatweg"/>
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-houseNumber">
                <valueString value="12"/>
            </extension>
            <extension url="http://hl7.org/fhir/StructureDefinition/iso21090-ADXP-buildingNumberSuffix">
                <valueString value="bII"/>
            </extension>
        </line>
PDF/A Onjuist gebruik of afwezigheid identifier en/of masteridentifier resource.masterIdentifier of resource.Identifier Ja De DocumentManifest.masterIdentifier en DocumentReference.masterIdentifier dienen door de XIS zelf te worden gegeneerd, met een eigen system. De .masterIdentifier is de versie specifieke identifier waar de .identifier een versie onafhankelijke identifier kan zijn (https://www.hl7.org/fhir/stu3/documentmanifest-definitions.html#DocumentManifest.masterIdentifier)