Template 2.16.840.1.113883.2.4.3.11.60.20.77.10.9044 - ControlActQueryByParameterMPVoorschriften

Template ControlAct Query by Parameter MP MedicatieVoorschrift

Id 2.16.840.1.113883.2.4.3.11.60.20.77.10.9044 Geldigheid geldig vanaf 2015‑07‑15 21:07:53

Status Ontwerp Versielabel

Naam ControlActQueryByParameterMPVoorschriften Weergavenaam ControlAct Query by Parameter MP 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 1 template, Gebruikt 4 templates

Relatie 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

<ControlActProcess moodCode="EVN"> <code code="REPC_TE920000NL" codeSystem="2.16.840.1.113883.1.18"/> <authorOrPerformer typeCode="AUT">  </authorOrPerformer> <overseer typeCode="RESP">  </overseer> <queryByParameter>  </queryByParameter></ControlActProcess>

Item DT Card Conf Omschrijving Label

hl7:ControlActProcess (ControlActQueryByParameterMPVoorschriften)

@moodCode 1 … 1 F EVN

hl7:code CV 0 … 1 R Trigger Event (ControlActQueryByParameterMPVoorschriften)

@codeSystem 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)

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)

@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)

Keuze

1 … 1

Elementen om uit te kiezen:

hl7:AssignedDevice met template 2.16.840.1.113883.2.4.3.11.60.102.10.513 Assigned Device [universal] (2012‑09‑01)
hl7:AssignedPerson met template 2.16.840.1.113883.2.4.3.11.60.102.10.514 Assigned Person [universal] (2012‑09‑01)

hl7:AssignedDevice R Bevat 2.16.840.1.113883.2.4.3.11.60.102.10.513 Assigned Device [universal] (2012‑09‑01) (ControlActQueryByParameterMPVoorschriften)

hl7:AssignedPerson R Bevat 2.16.840.1.113883.2.4.3.11.60.102.10.514 Assigned Person [universal] (2012‑09‑01) (ControlActQueryByParameterMPVoorschriften)

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)

@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)

waar [not(@nullFlavor)]

Inclusie 1 … 1 M van 2.16.840.1.113883.2.4.3.11.60.20.77.10.9045 Query by parameter MP Voorschrift (2015‑07‑15 21:27:42)

hl7:queryByParameter 1 … 1 M Bevat de kenmerken van de vraag (ControlActQueryByParameterMPVoorschriften)

Schematron assert role warning

test not(.//hl7:semanticsText)

Melding Control Act: het element semanticsText onder queryparameters bij voorkeur niet gebruiken

Schematron assert role 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)

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)

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)

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)

CONF

De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.1.11.91 QueryPriority (2011‑07‑26)

hl7:executionAndDeliveryTime

0 … 1

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)

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)

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)

Keuze

1 … 2

Elementen om uit te kiezen:

hl7:low
hl7:high

hl7:low TS 0 … 1 R (ControlActQueryByParameterMPVoorschriften)

Schematron assert role 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)

Schematron assert role 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 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)

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)

Inclusie 1 … 1 van 2.16.840.1.113883.2.4.3.11.60.20.77.10.9031 QueryParam PatientID (2015‑04‑15 15:46:38)

hl7:patientID 1 … 1 Bevat het burgerservicenummer van de patiënt/cliënt van wie de gegevens worden opgevraagd. (ControlActQueryByParameterMPVoorschriften)

hl7:value II.NL.BSN 1 … 1 M (ControlActQueryByParameterMPVoorschriften)

@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 warning

test $interactionVocab

Melding Control Act: <value-of select="$interactionVocabFile"/> niet gevonden. Controles gebaseerd op dit externe configuratiebestand zijn gedeactiveerd.

Schematron assert role 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 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 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 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 error

test not($authorEntity//hl7:id[@root='2.16.840.1.113883.2.4.6.3']) or not($authorEntity/../(hl7:queryByParameter|hl7:subject)//hl7:*[@root='2.16.840.1.113883.2.4.6.3']) or $authorEntity/../../hl7:attentionLine

Melding Patiëntgebonden interacties, verzonden vanuit een patiëntenportaal (GBP), moeten een attentionLine hebben

Schematron assert role error

test not($authorEntity//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 not($authorEntity/../(hl7:queryByParameter|hl7:subject)//hl7:*[@root='2.16.840.1.113883.2.4.6.3']) or $authorEntity/../../hl7:attentionLine

Melding Patiëntgebonden interacties, verzonden vanuit het klantenloket (GBK), moeten een attentionLine hebben

Schematron assert role 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 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 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 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 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 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 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 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 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 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 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 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 error

test not($overseerPerson) or $overseerPerson/hl7:code

Melding Control Act: <value-of select="$overseerPath"/>/code is verplicht

Schematron assert role 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 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 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 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 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 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"/>)

Template ControlAct Query by Parameter MP MedicatieVoorschrift