Terug naar index  <<  Terug naar templates

ref Template  ControlAct Query by Parameter MP VZVZ MedicatieVoorschrift

Id 2.16.840.1.113883.2.4.3.111.3.12.10.20 Geldigheid geldig vanaf 2017‑06‑16 08:44:49
Status draft Ontwerp Versielabel
Naam ControlActQueryByParameterMPVoorschriften-vzvz Weergavenaam ControlAct Query by Parameter MP VZVZ MedicatieVoorschrift
Omschrijving Dit is het template voor een query control act wrapper in een agerend bericht. Voor MP. Voor opvragen voorschriften.
Classificatie HL7v3 Control Act level template
Open/gesloten Open (ook andere dan gedefinieerde elementen zijn toegestaan)
Gebruikt door / Gebruikt
Gebruikt door 0 transacties en 1 template, Gebruikt 4 templates
Gebruikt door als Naam Versie
2.16.840.1.113883.2.4.3.111.3.12.10.1 Inclusie draft VZVZ Opvragen Medicatieafspraken 2016‑11‑21 06:42:17
Gebruikt als Naam Versie
2.16.840.1.113883.2.4.3.11.60.102.10.500 Inclusie draft ControlAct AuthorOrPerformer 2012‑08‑01
2.16.840.1.113883.2.4.3.11.60.102.10.503 Inclusie draft ControlAct Overseer Person (Query) 2012‑08‑01
2.16.840.1.113883.2.4.3.111.3.12.10.21 Inclusie draft QueryByParameter MP VZVZ Voorschrift 2017‑06‑16 08:55:11
2.16.840.1.113883.2.4.3.11.60.102.10.102 Inclusie draft Generic ControlActProcess Checks 2014‑07‑15
Relatie Adaptatie: template 2.16.840.1.113883.2.4.3.11.60.20.77.10.9044 (2015‑07‑15 21:07:53)
Afgeleide: model QUQI_RM021000 (DYNAMISCH)
Afgeleide: model QUQI_MT021001 (DYNAMISCH)
Afgeleide: model QUQI_MT021001_OPT_OV (DYNAMISCH)
Specialisatie: template 2.16.840.1.113883.2.4.3.11.60.102.10.133 (2012‑08‑01)
Voorbeeld
Voorbeeld
<ControlActProcess moodCode="EVN">
  <code code="REPC_TE920000NL" codeSystem="2.16.840.1.113883.1.18"/>  <authorOrPerformer typeCode="AUT">
    <!-- Gemandateerde berichtverzender -->
  </authorOrPerformer>
  <overseer typeCode="RESP">
    <!-- Mandaterende -->
  </overseer>
  <queryByParameter>
    <!-- QueryByParameter -->
  </queryByParameter>
</ControlActProcess>
Item DT Card Conf Omschrijving Label
hl7:ControlActProcess
(ControlActQueryByParameterMPVoorschriften‑vzvz)
@moodCode
cs 1 … 1 F EVN
hl7:code
CV 0 … 1 R Trigger Event (ControlActQueryByParameterMPVoorschriften‑vzvz)
@codeSystem
CONF 1 … 1 F 2.16.840.1.113883.1.18 (TriggerEvent)
hl7:effectiveTime
TS 0 … 1 Datum en tijdstip (NB: geen interval) waarop de gebeurtenis die het bericht heeft doen ontstaan, plaatsvond. Dit tijdstip is mogelijkerwijs anders dan het tijdstip van het versturen van het bericht zoals opgenomen in de Transmission Wrapper. (ControlActQueryByParameterMPVoorschriften‑vzvz)
Inclusie 1 … 1 M van 2.16.840.1.113883.2.4.3.11.60.102.10.500 ControlAct AuthorOrPerformer (2012‑08‑01)
hl7:authorOrPerformer
1 … 1 M Bericht-zender. Systeem of persoon (ControlActQueryByParameterMPVoorschriften‑vzvz)
@typeCode
1 … 1 R
  CONF
De waarde van @typeCode moet komen uit waardelijst 2.16.840.1.113883.1.11.19080 x_ParticipationAuthorPerformer (2011‑07‑26)
hl7:participant
1 … 1 M (ControlActQueryByParameterMPVoorschriften‑vzvz)
Keuze 1 … 1 Elementen om uit te kiezen:
hl7:AssignedDevice
R Bevat 2.16.840.1.113883.2.4.3.11.60.102.10.513 Assigned Device [universal] (2012‑09‑01) (ControlActQueryByParameterMPVoorschriften‑vzvz)
hl7:AssignedPerson
R Bevat 2.16.840.1.113883.2.4.3.11.60.102.10.514 Assigned Person [universal] (2012‑09‑01) (ControlActQueryByParameterMPVoorschriften‑vzvz)
Inclusie 0 … 1 R van 2.16.840.1.113883.2.4.3.11.60.102.10.503 ControlAct Overseer Person (Query) (2012‑08‑01)
hl7:overseer
0 … 1 R Bericht-zender (mandaatverlener). (ControlActQueryByParameterMPVoorschriften‑vzvz)
@typeCode
1 … 1 F RESP
hl7:assignedEntity
M Mandaterende persoon
Bevat 2.16.840.1.113883.2.4.3.11.60.102.10.514 Assigned Person [universal] (2012‑09‑01)
(ControlActQueryByParameterMPVoorschriften‑vzvz)
treeblank treeblank waar [not(@nullFlavor)]
Inclusie 1 … 1 M van 2.16.840.1.113883.2.4.3.111.3.12.10.21 QueryByParameter MP VZVZ Voorschrift (2017‑06‑16 08:55:11)
hl7:queryByParameter
1 … 1 M Bevat de kenmerken van de vraag (ControlActQueryByParameterMPVoorschriften‑vzvz)
  Schematron assert role orange warning  
  test not(.//hl7:semanticsText)  
  Melding Control Act: het element semanticsText onder queryparameters bij voorkeur niet gebruiken  
  Schematron assert role red error  
  test not(hl7:sortControl)  
  Melding Control Act: queryByParameter/sortControl mag niet gebruikt worden  
hl7:queryId
II 1 … 1 M Bevat de unieke identificatie van de vraag zoals geformuleerd in de vragende applicatie, los van de identificatie van de interactie waarin de vraag wordt aangeboden. De waarde van dit attribuut wordt in het antwoord teruggeleverd, zodat de antwoordberichten kunnen worden gerelateerd aan de vraag. De OID voor het identificatiesysteem kan bijvoorbeeld worden afgeleid van de URA van de zorgaanbieder, het AORTA applicatie-id, maar dit is geen verplichting. Iedere OID die voldoet aan het principe van uniekheid is geldig. (ControlActQueryByParameterMPVoorschriften‑vzvz)
  Constraint Deze identificatie is uniek en kan nooit nogmaals worden uitgedeeld, noch door dezelfde applicatie, noch door een andere applicatie. Het identificatiesysteem waaruit de vraagidentificaties worden gegenereerd wordt geïdentificeerd door een OID in het attribuut @root. Het attribuut @extension moet de gegenereerde identificatie bevatten.
hl7:statusCode
CS 1 … 1 M Bevat de (nieuwe) status van de query. De te gebruiken waarden in dit attribuut zijn gedefinieerd in de valueset QueryStatusCode. (ControlActQueryByParameterMPVoorschriften‑vzvz)
  Constraint @code moet bij initiële vragen de waarde "executing" bevatten.
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.18899 QueryStatusCode (2011‑07‑26)
hl7:responseModalityCode
CS 1 … 1 M Bevat code voor opleverwijze. Verplicht in AORTA met als mogelijkheden "gebundeld" (B - van toepassing bij indirect opvragen via de ZIM waarbij gebundeld moet worden opgeleverd), of "discreet" (R - van toepassing bij direct opvragen bij het bronsysteem, alle vragen van de ZIM bevatten deze opleverwijze.) (ControlActQueryByParameterMPVoorschriften‑vzvz)
  Constraint
  • Indien de interactie van het type indirect opvragen is, en de interactie gaat van een GBx naar de ZIM, dan moet @code de waarde "B" bevatten.
  • Indien de interactie van het type indirect opvragen is, en de interactie gaat van ZIM naar een GBx, dan moet @code de waarde "R" bevatten.
  • Indien de interactie van het type direct opvragen is, dan moet @code de waarde "R" bevatten.
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.394 ResponseModality (2011‑07‑26)
hl7:responsePriorityCode
CS 1 … 1 M Bevat de code voor oplevertiming. De standaardwaarde is "I" (Immediate) voor synchrone, directe beantwoording. Merk op dat ook het tijdstip van beantwoording van de vraag in het vraagbericht zelf kan worden beïnvloed: zie de beschrijving van executionAndDeliveryTime. (ControlActQueryByParameterMPVoorschriften‑vzvz)
  CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.91 QueryPriority (2011‑07‑26)
hl7:executionAndDeliveryTime
TS 0 … 1 C Bevat het tijdstip waarop het antwoord uiterlijk moet zijn opgeleverd aan het vragende systeem. Het tijdstip wordt relatief aan de aanmaaktijd van de interactie. Het verschil tussen de twee tijdstippen moet liggen tussen de configuratieparameter responsetijd-ZIM (zie [Config inst]) en 60 seconden. Bij afwezigheid van het element executionAndDeliveryTime geldt maximale oplevertimeout zoals beschreven in de Programma’s van Eisen.

FAQ: Hoe bepaalt een zender van een ‘Immediate’ vraagbericht een redelijke waarde voor de oplevertimeout?
- De complexiteit of grootte van het verwachte antwoord is van invloed op het op te geven tijdstip. Indien een volledig overzicht van de medicatiehistorie van een patiënt opgevraagd wordt, dan ligt een ruimere timeout voor de hand dan bij het opvragen van één laboratoriumuitslag.

(ControlActQueryByParameterMPVoorschriften‑vzvz)
  Constraint
  • @value moet de maximale timeout bevatten, indien de toepassing voor de betreffende interactie specificeert dat een maximale timeout moet kunnen worden opgegeven, en deze in de zendende applicatie ook werkelijk een waarde heeft.
  • @value moet, indien deze een waarde heeft, tenminste tot op de minuut nauwkeurig worden opgegeven.
  • Het verschil tussen executionAndDeliveryTime/@value en Message/creationTime/@value moet, indien beide een waarde hebben, liggen tussen responsetijd-ZIM en 60 seconden.
hl7:administrationRequestEffectiveTimeInterval
0 … 1 R Beoogde toedieningsperiode(s)
Verdere informatie
(ControlActQueryByParameterMPVoorschriften‑vzvz)
  Voorbeeld
Opvragen van de medicatievoorschriften waarvan de medicatie (voor zover dit is af te leiden uit het voorschrift) op 12 maart 2008 gebruikt werd (interval met breedte 1 dag).
<value>
  <low value="200803120000"/>  <high value="200803122359"/></value>
  Voorbeeld
Opvragen van de medicatievoorschriften waarvan de medicatie (voor zover dit is af te leiden uit het voorschrift) op of na een bepaalde datum gebruikt wordt (indien vandaag: ‘actuele medicatie’)
<value>
  <low value="201011190000"/></value>
hl7:value
IVL_TS 1 … * M (ControlActQueryByParameterMPVoorschriften‑vzvz)
Keuze 1 … 2 Elementen om uit te kiezen:
  • hl7:low
  • hl7:high
hl7:low
TS 0 … 1 R (ControlActQueryByParameterMPVoorschriften‑vzvz)
  Schematron assert role red error  
  test string-length(@value)>11 and substring(@value,9,4)='0000'  
  Melding Het is verplicht om bij de ondergrens de tijd 00:00 mee te geven.  
hl7:high
TS 0 … 1 R (ControlActQueryByParameterMPVoorschriften‑vzvz)
  Schematron assert role red error  
  test string-length(@value)>11 and substring(@value,9,4)='2359'  
  Melding Het is verplicht om bij de bovengrens de tijd 23:59 mee te geven.  
  Schematron assert role red error  
  test not(exists(*[local-name()!='low' and local-name()!='high']))  
  Melding Alleen elementen low en/of high zijn toegestaan  
hl7:medicationCombinedOrderID
0 … 1 R Voorschrift identificatie
Verdere informatie
(ControlActQueryByParameterMPVoorschriften‑vzvz)
  Voorbeeld
Opvragen van een specifiek medicatievoorschrift.
<value root="2.16.840.1.113883.2.4.6.1.6005432.2.8.1" extension="0012462311"/>
hl7:value
II 1 … * M (ControlActQueryByParameterMPVoorschriften‑vzvz)
Inclusie 1 … 1 van 2.16.840.1.113883.2.4.3.11.60.102.10.1014 QueryParam PatientId (2014‑07‑15)
hl7:patientId
1 … 1 Bevat het burgerservicenummer van de patiënt/cliënt van wie de gegevens worden opgevraagd. (ControlActQueryByParameterMPVoorschriften‑vzvz)
hl7:value
II.NL.BSN 1 … 1 M (ControlActQueryByParameterMPVoorschriften‑vzvz)
@root
1 … 1 F 2.16.840.1.113883.2.4.6.3
Inclusie 0 … * van 2.16.840.1.113883.2.4.3.11.60.102.10.102 Generic ControlActProcess Checks (2014‑07‑15)
  Variabele let Naam controlActProcess  
  Waarde .  
  Variabele let Naam authorEntity  
  Waarde $controlActProcess/hl7:authorOrPerformer//hl7:*[lower-case(local-name())=('assigneddevice','assignedperson')][1]  
  Variabele let Naam authorDevice  
  Waarde $authorEntity[lower-case(local-name())='assigneddevice']  
  Variabele let Naam authorPerson  
  Waarde $authorEntity[lower-case(local-name())='assignedperson']  
  Variabele let Naam overseerPerson  
  Waarde $controlActProcess/hl7:overseer//hl7:*[lower-case(local-name())=('assignedentity','assignedperson')][1]  
  Variabele let Naam authorPath  
  Waarde string-join($authorEntity/ancestor-or-self::*/name(),'/')  
  Variabele let Naam overseerPath  
  Waarde string-join($overseerPerson/ancestor-or-self::*/name(),'/')  
  Variabele let Naam senderApplicationId  
  Waarde $controlActProcess/../hl7:sender/hl7:device/hl7:id[@root='2.16.840.1.113883.2.4.6.6']/@extension  
  Variabele let Naam authorApplicationId  
  Waarde $authorDevice/hl7:id[@root='2.16.840.1.113883.2.4.6.6']/@extension  
  Variabele let Naam overseerOrgId  
  Waarde $overseerPerson/hl7:Organization/hl7:id  
  Variabele let Naam authorOrgId  
  Waarde $authorEntity/hl7:Organization/hl7:id  
  Variabele let Naam interactionId  
  Waarde $controlActProcess/../local-name()  
  Variabele let Naam interactionVocabFile  
  Waarde '../vocab/2.16.840.1.113883.1.6.xml'  
  Variabele let Naam interactionVocab  
  Waarde if (doc-available($interactionVocabFile)) then doc($interactionVocabFile) else ()  
  Variabele let Naam interactionTrustLevel  
  Waarde $interactionVocab/*/hl7:code[@code=$interactionId]/hl7:qualifier[@name='Vertrouwensniveau']/@value  
  Variabele let Naam interactionSendType  
  Waarde $interactionVocab/*/hl7:code[@code=$interactionId]/hl7:qualifier[@name='Verzendtype']/@value  
  Variabele let Naam interactionTriggerEventCode  
  Waarde $interactionVocab/*/hl7:code[@code=$interactionId]/hl7:reference/@extension  
  Variabele let Naam messageTriggerEventCode  
  Waarde $controlActProcess/hl7:code/@code  
  Schematron assert role orange warning  
  test $interactionVocab  
  Melding Control Act: <value-of select="$interactionVocabFile"/> niet gevonden. Controles gebaseerd op dit externe configuratiebestand zijn gedeactiveerd.  
  Schematron assert role red error  
  test not($controlActProcess/hl7:queryByParameter) or $controlActProcess[@moodCode='EVN']  
  Melding Control Act: <value-of select="local-name()"/>/@moodCode moet 'EVN' zijn bij queries  
  Schematron assert role red error  
  test not($interactionVocab) or not($messageTriggerEventCode) or $interactionTriggerEventCode=$messageTriggerEventCode  
  Melding Control Act: <value-of select="local-name()"/>/code (Trigger Event) moet bij deze interactie '<value-of select="$interactionTriggerEventCode"/>' zijn, gevonden is echter '<value-of select="$messageTriggerEventCode"/>'  
  Schematron assert role red error  
  test not($interactionVocab) or $authorPerson or not($interactionTrustLevel) or $interactionTrustLevel='Laag'  
  Melding Control Act: <value-of select="local-name()"/>/authorOrPerformer moet een persoon bevatten in berichten met vertrouwensniveau midden of hoog  
  Schematron assert role red error  
  test not($interactionVocab) or $overseerPerson or empty($interactionTrustLevel) or $interactionTrustLevel='Laag'  
  Melding Control Act: <value-of select="local-name()"/>/overseer moet de mandaterende persoon bevatten in berichten met vertrouwensniveau midden of hoog  
  Schematron assert role red error  
  test empty($senderApplicationId) or empty($authorApplicationId) or $senderApplicationId=$authorApplicationId or $senderApplicationId='1'  
  Melding Control Act: <value-of select="$authorPath"/>/id. Applicatie-id <value-of select="$authorApplicationId"/> komt niet overeen met Transmission-wrapper sender <value-of select="$senderApplicationId"/>.  
  Schematron assert role red error  
  test not($authorDevice/hl7:Organization/hl7:id[@root='2.16.528.1.1007.3.3']) or $authorDevice/hl7:id[@root='2.16.528.1.1007.3.2']  
  Melding Control Act: <value-of select="$authorPath"/>/id moet tenminste het UZI-nummer systemen bevatten voor een XIS in een GBZ  
  Schematron assert role red error  
  test not($authorDevice/hl7:id[@root='2.16.528.1.1007.3.2']) or $authorDevice/hl7:Organization/hl7:id[@root='2.16.528.1.1007.3.3' and @extension]  
  Melding Control Act: <value-of select="$authorPath"/>/id moet de zorgaanbieder van het XIS identificeren  
  Schematron assert role orange warning  
  test not($authorDevice) or $authorDevice/hl7:id[@root='2.16.840.1.113883.2.4.6.6'][@extension='1'] or $authorDevice/hl7:id[@root='2.16.528.1.1007.4'] or $authorDevice/hl7:Organization/hl7:id  
  Melding Control Act: <value-of select="$authorPath"/>/ moet een geïdentificeerde organisatie hebben, tenzij het de ZIM of het SBV-Z betreft.  
  Schematron assert role red error  
  test not($authorPerson/hl7:id[@root='2.16.840.1.113883.2.4.6.3']) or $authorPerson/hl7:code[@codeSystem='2.16.840.1.113883.2.4.3.11.8'][@code='P']  
  Melding Control Act: <value-of select="$authorPath"/>/code/@code moet "P" (Patiënt) zijn. Wettelijke vertegenwoordigers moet dit via het Klantenloket doen en kunnen dus niet als auteur optreden  
  Schematron assert role red error  
  test not($authorPerson/hl7:id[@root=('2.16.840.1.113883.2.4.3.11.7.3','2.16.528.1.1003.1.3.5.4.1')]) or $authorPerson/hl7:code[@codeSystem='2.16.840.1.113883.2.4.3.11.8'][@code='KLANTENLOKET']  
  Melding Control Act: <value-of select="$authorPath"/>/code/@code moet "KLANTENLOKET" zijn voor klantenloketmedewerkers  
  Schematron assert role orange warning  
  test not($authorPerson/hl7:id[@root='2.16.528.1.1007.3.1']) or $authorPerson/hl7:code[@codeSystem='2.16.840.1.113883.2.4.15.111']  
  Melding Control Act: <value-of select="$authorPath"/>/code ontbreekt. Dit is alleen toegestaan als de rolcode 00.000 is.  
  Schematron assert role red error  
  test not($authorPerson/hl7:id[@root='2.16.528.1.1007.3.1']) or $authorOrgId[@root='2.16.528.1.1007.3.3' and @extension]  
  Melding Control Act: <value-of select="$authorPath"/>/Organization/id moet de zorgaanbieder van de persoon identificeren  
  Schematron assert role red error  
  test not($authorPerson/hl7:id[@root='2.16.840.1.113883.2.4.6.3']) or $authorOrgId[@root='2.16.840.1.113883.2.4.3.11.25']  
  Melding Control Act: <value-of select="$authorPath"/>/Organization/id/@root moet '2.16.840.1.113883.2.4.3.11.25' bevatten  
  Schematron assert role red error  
  test not($authorPerson/hl7:id[@root=('2.16.840.1.113883.2.4.3.11','2.16.528.1.1003.1.3.5.4.1')]) or $authorOrgId[@root='2.16.840.1.113883.2.4.3.11'][@extension='7']  
  Melding Control Act: <value-of select="$authorPath"/>/Organization/id moet de Nictiz-klantenloket organisatie identificeren  
  Schematron assert role red error  
  test not($overseerPerson/hl7:Organization[not(hl7:name)]/hl7:id[@root='2.16.528.1.1007.3.3'])  
  Melding Control Act: <value-of select="$authorPath"/>/Organization/name moet de zorgaanbieder/organisatienaam bevatten  
  Schematron assert role red error  
  test not($overseerPerson/hl7:Organization[not(hl7:name)]/hl7:id[@root='2.16.840.1.113883.2.4.3.11' and @extension='7'])  
  Melding Control Act: <value-of select="$authorPath"/>/Organization/name moet de Nictiz-klantenloket organisatienaam bevatten  
  Schematron assert role red error  
  test not($overseerPerson) or $overseerPerson/hl7:code  
  Melding Control Act: <value-of select="$overseerPath"/>/code is verplicht  
  Schematron assert role red error  
  test not($overseerPerson/hl7:id[@root='2.16.840.1.113883.2.4.6.3']) or $overseerPerson/hl7:code[@codeSystem='2.16.840.1.113883.2.4.3.11.8'][@code='P'] or $overseerPerson/hl7:code[@codeSystem='2.16.840.1.113883.2.4.3.11.6']  
  Melding Control Act: <value-of select="$overseerPath"/>/code/@code moet "P" (Patiënt) zijn of een geldige waarde uit RoleCodeWettelijkeVertegenwoordigerNL  
  Schematron assert role red error  
  test not($overseerPerson/hl7:id[@root='2.16.528.1.1007.3.1']) or $overseerPerson/hl7:assignedPrincipalChoiceList/hl7:assignedPerson/hl7:name  
  Melding Control Act: <value-of select="$overseerPath"/>/assignedPrincipalChoiceList/assignedPerson/name is verplicht  
  Schematron assert role red error  
  test not($overseerPerson/hl7:id[@root='2.16.528.1.1007.3.1']) or $overseerPerson/hl7:Organization/hl7:id[@root='2.16.528.1.1007.3.3']  
  Melding Control Act: <value-of select="$overseerPath"/>/Organization/id moet de zorgaanbieder van de persoon identificeren  
  Schematron assert role red error  
  test not($overseerPerson/hl7:id[@root='2.16.528.1.1007.3.1']) or $overseerPerson/hl7:Organization/hl7:name  
  Melding Control Act: <value-of select="$overseerPath"/>//Organization/name moet de zorgaanbiedernaam bevatten  
  Schematron assert role red error  
  test not($overseerPerson/hl7:id[@root='2.16.528.1.1007.3.1']) or $overseerPerson/hl7:Organization/hl7:addr/hl7:city  
  Melding Control Act: <value-of select="$overseerPath"/>/Organization/addr moet tennminste de vestigingsplaats bevatten  
  Schematron assert role red error  
  test not($overseerOrgId) or $authorOrgId[@root=$overseerOrgId/@root][@extension=$overseerOrgId/@extension] or $authorEntity[lower-case(local-name())='assigneddevice']  
  Melding Control Act: <value-of select="$overseerPath"/>/Organization/id. Organisatie van de overseer (<value-of select="$overseerOrgId/@root"/>#<value-of select="$overseerOrgId/@extension"/>) moet gelijk zijn aan die van de authorOrPerformer (<value-of select="$authorOrgId/@extension"/>)