Terug naar index  <<  Terug naar templates

 Template  VZVZ Opvragen Medicatievoorschriften

Template 2.16.840.1.113883.2.4.3.11.60.66.10.11 - opvragenVoorschriftenLijst
Id 2.16.840.1.113883.2.4.3.11.60.66.10.11
Classificatie HL7v2/v3 message level template
Relatie Afgeleide: model QURX_IN990201NL01 (DYNAMISCH)
Context Padnaam /
Versie geldig vanaf 2014‑01‑13 status In ontwikkeling
Open/gesloten Open (ook andere dan gedefinieerde elementen zijn toegestaan)
Omschrijving Opvragen Medicatievoorschriften
Verdere informatie
notice Er zijn open issues met betrekking tot dit item:
  • kz-issue-53: ResponseModality code (Gesloten)
  • kz-issue-54: medicationCode (Open)
  • kz-issue-55: Beschrijving administrationRequestEffectiveTimeInterval @value (Gesloten)
Koppelingen met
Koppelingen met 6 concepten
Id Naam Dataset
kz-dataelement-9501 Patiëntnummer Ketenzorg
kz-dataelement-9502 Beoogde toedieningsperiode Ketenzorg
kz-dataelement-9503 Begindatum toedieningsperiode Ketenzorg
kz-dataelement-9504 Einddatum toedieningsperiode Ketenzorg
kz-dataelement-9511 Medicatiecode Ketenzorg
kz-dataelement-9512 Voorschrift identificatie Ketenzorg
Gebruikt door / Gebruikt
Gebruikt door / Gebruikt 2 templates
Gebruikt Template-id Naam Versie
2.16.840.1.113883.2.4.3.11.60.66.10.9022 AttentionLineContextCode DYNAMISCH
2.16.840.1.113883.2.4.3.11.60.66.10.9023 ControlActOverseerPerson DYNAMISCH
Voorbeeld
<QURX_IN990201NL01>
  <!-- QURX_IN990101NL :: opvragenVoorschriftenLijst -->
  <!-- transmission wrapper -->
  <ControlActProcess moodCode="EVN">
    <!-- control act wrapper -->
    <queryByParameter>
      <templateId root="2.16.840.1.113883.2.4.3.11.60.66.10.11"/>
      <queryId extension="0000616768" root="2.16.528.1.1007.3.3.600862"/>
      <statusCode code="executing"/>
      <responseModalityCode code="R"/>
      <responsePriorityCode code="I"/>
      <executionAndDeliveryTime value="20140704134536"/>
      <administrationRequestEffectiveTimeInterval>
        <value>
          <low value="201403100000"/>
        </value>
      </administrationRequestEffectiveTimeInterval>
      <patientId>
        <value root="2.16.840.1.113883.2.4.6.3" extension="012345672"/>
      </patientId>
    </queryByParameter>
  </ControlActProcess>
</QURX_IN990201NL01>
Item DT Card Conf Omschrijving Label
hl7:QURX_IN990201NL01
1 .. 1 (opvragenVoorschriftenLijst)
Ingevoegd van 2.16.840.1.113883.2.4.3.11.60.66.10.9022 VZVZ AttentionLine ContextCode (DYNAMISCH)
treetree hl7:attentionLine
0 .. * (opvragenVoorschriftenLijst)
treeblank treetree hl7:keyWordText
SC 1 .. 1 (opvragenVoorschriftenLijst)
treeblank treeblank treetree @code
1 .. 1 F CONTEXT
treeblank treeblank treetree @codeSystem
1 .. 1 F 2.16.840.1.113883.2.4.15.1
CONF
elementinhoud moet "ContextCode" zijn
treeblank treetree hl7:value
CV 1 .. 1 (opvragenVoorschriftenLijst)
CONF
De waarde van @code moet komen uit waardelijst 2.16.840.1.113883.2.4.3.11.60.66.11.116 AORTA Context Code (DYNAMISCH)
target Gekoppeld aan concepten:
kz-dataelement-9522 Contextcode
treetree hl7:ControlActProcess
1 .. 1 M (opvragenVoorschriftenLijst)
treeblank treetree @moodCode
1 .. 1 F EVN
Ingevoegd van 2.16.840.1.113883.2.4.3.11.60.66.10.9023 VZVZ ControlAct Overseer Person (DYNAMISCH) 1 .. 1
treeblank treetree hl7:overseer
1 .. 1 Bericht-zender (mandaatverlener). Zorgverlener en zorgaanbieder (opvragenVoorschriftenLijst)
treeblank treeblank treetree @typeCode
0 .. 1 F RESP
Voorbeeld
<overseer typeCode="RESP">
  <assignedEntity>
    <id root="2.16.528.1.1007.3.1" extension="000002222"/>
    <code code="01.016" codeSystem="2.16.840.1.113883.2.4.15.111" displayName="Internist"/>
    <assignedPrincipalChoiceList>
      <assignedPerson>
        <name>
          <given>Anders de</given>
          <family>Ketenpartner 1</family>
        </name>
      </assignedPerson>
    </assignedPrincipalChoiceList>
    <Organization>
      <id root="2.16.528.1.1007.3.3" extension="00002222"/>
      <name>Gezondheidscentrum Amby</name>
      <telecom use="WP" value="+31761235987"/>
      <addr>
        <streetName>Ettensebaan</streetName>
        <houseNumber>100</houseNumber>
        <postalCode>4814NN</postalCode>
        <city>Breda</city>
        <country>Nederland</country>
      </addr>
    </Organization>
  </assignedEntity>
</overseer>
treeblank treeblank treetree hl7:assignedEntity
1 .. 1 M (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree hl7:id
II.NL.UZI 1 .. 1 M Zorgverlener-id (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treetree @root
1 .. 1 F 2.16.528.1.1007.3.1
treeblank treeblank treeblank treetree hl7:code
CV 1 .. 1 M Zorgverlener-code (opvragenVoorschriftenLijst)
Schematron assert role red error
test @codeSystem='2.16.840.1.113883.2.4.15.111' and not(@code='00.000')
Melding Control Act: / moet een UZI-register rolcode bevatten en deze mag niet 00.000 zijn
treeblank treeblank treeblank treetree hl7:assignedPrincipalChoiceList
1 .. 1 M (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treetree hl7:assignedPerson
1 .. 1 M Persoonsgegevens (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treeblank treetree hl7:name
PN 1 .. 1 M Zorgverlener-naam (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree hl7:Organization
1 .. 1 M Organisatiegegevens (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treetree hl7:id
II 1 .. 1 M Organisatie-id (opvragenVoorschriftenLijst)
Schematron assert role red error
test @root='2.16.528.1.1007.3.3' and @extension
Melding Control Act: / moet een URA bevatten
treeblank treeblank treeblank treeblank treetree hl7:code
CV 0 .. 1 R Organisatietype. Geldige waarden komen uit RoleCodeNL - zorgaanbiedertype (2.16.840.1.113883.2.4.15.1060) (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treeblank treetree @codeSystem
1 .. 1 F 2.16.840.1.113883.2.4.15.1060
treeblank treeblank treeblank treeblank treetree hl7:name
ON 1 .. 1 M Organisatie-naam (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treetree hl7:addr
AD 1 .. 1 M Organisatie-adres (opvragenVoorschriftenLijst)
Schematron assert role red error
test hl7:city
Melding Control Act: / moet tenminste de vestigingsplaats bevatten
treeblank treetree hl7:queryByParameter
1 .. 1 M (opvragenVoorschriftenLijst)
treeblank treeblank treetree hl7:templateId
II 1 .. 1 (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree @root
1 .. 1 F 2.16.840.1.113883.2.4.3.11.60.66.10.11
treeblank treeblank treetree 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. (opvragenVoorschriftenLijst)
Voorbeeld
<queryId extension="101" root="2.16.528.1.1007.3.3.2222.27"/>
treeblank treeblank treetree hl7:statusCode
CS 1 .. 1 M Bevat de (nieuwe) status van de query. (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree @code
1 .. 1 F executing
Voorbeeld
<statusCode code="executing"/>
treeblank treeblank treetree hl7:responseModalityCode
CS 1 .. 1 M Definieert de timing en groepering van de antwoordberichten. (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree @code
1 .. 1 F R
Voorbeeld
<responseModalityCode code="R"/>
treeblank treeblank treetree hl7:responsePriorityCode
CS 1 .. 1 M Geeft het tijdsframe aan waarbinnen het antwoord wordt verwacht, zoals ‘I’ (Immediate) voor directe beantwoording. (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree @code
1 .. 1 F I
Voorbeeld
<responsePriorityCode code="I"/>
treeblank treeblank treetree hl7:executionAndDeliveryTime
TS 1 .. 1 M Bevat het tijdstip waarop het antwoord uiterlijk moet zijn opgeleverd aan het vragende systeem. (opvragenVoorschriftenLijst)
Voorbeeld
<executionAndDeliveryTime value="20120330121540"/>
treeblank treeblank treetree hl7:administrationRequestEffectiveTimeInterval
0 .. 1 R Beoogde toedieningsperiode(s). Deze parameter kan gebruikt worden om een gebruiksinterval door te geven van de voorgeschreven medicatie. Alle geretourneerde voorschriften hebben betrekking op medicatie die (voor zover dat afleidbaar is uit de voorschriftgegevens) binnen deze periode is gebruikt of zal worden gebruikt. Dit is geen waterdicht criterium.
De beoogde gebruiksperiode van een medicatievoorschrift (zelfs als de verstrekking reeds heeft plaatsgevonden) kent vaak een flinke mate van onzekerheid in de ambulante setting. Zo is vaak niet zeker wanneer de patiënt precies met het gebruik zal beginnen en wordt veel medicatie verstrekt op basis van een ‘zo nodig’ dosering, die betekent dat deze tot aan de maximale houdbaarheidsdatum in gebruik kan zijn.
Het is bij het afhandelen van een Voorschriftquery aan het antwoordende systeem welk algoritme wordt toegepast om de beoogde gebruiksperiode van de opgeslagen voorschriften te bepalen. Als de vrager niet afhankelijk wil zijn van het algoritme dat het antwoordende systeem hiertoe gebruikt (en dat de vrager meestal niet kent), dan wordt deze query parameter bij voorkeur niet gebruikt, maar moet de vrager zelf filteren in de geretourneerde voorschriftgegevens.
Als dit criterium gebruikt wordt om te filteren welke voorschriften relevant zijn in het kader van de medicatiebewaking, dan is niet alleen de beoogde gebruiksperiode, maar ook de zogenaamde ‘interactierelevantieperiode’ van belang. De interactierelevantieperiode geeft aan hoe lang na het beëindigen van de toediening de medicatie nog interacties kan hebben met andere medicatie of bepaalde condities. Op basis van de medicatiecode is afleidbaar hoe lang de interactierelevantieperiode is, zodat de ontvanger daar zelf rekening mee kan houden. Het is niet wenselijk dat een antwoordend systeem deze marge reeds incalculeert bij interpretatie van <administrationRequestEffectiveTimeInterval>.
Om misverstanden over de interpretatie van de einddatum (<high>) te voorkomen, is het verplicht om bij onder- en bovengrens tot op de minuut te specficeren. Als de gehele dag wordt bedoeld, zoals meestal het geval is, moet respectievelijk 0000 en 2359 worden toegevogd achter de datum.
(opvragenVoorschriftenLijst)
target Gekoppeld aan concepten:
kz-dataelement-9502 Beoogde toedieningsperiode
treeblank treeblank treeblank treetree hl7:value
IVL_TS 1 .. * M Een tijdsinterval dat betrekking heeft op de periode waarin medicatiegebruik op basis van de gezochte voorschriften zal plaatsvinden of heeft plaatsgevonden. Om misverstanden over de interpretatie van de einddatum (<high>) te voorkomen, is het verplicht om bij onder- en bovengrens respectievelijk de vaste tijden “0000” en “2359” toe te voegen achter de datum (zodat duidelijk is dat ‘tot en met’ wordt bedoeld). (opvragenVoorschriftenLijst)
Constraint Minimaal één van de elementen <low> en <high> moet aanwezig zijn
Constraint Onder- en bovengrens (low, high) is tot op de minuut te specficeren
Constraint Andere attributen en subelementen mogen niet aanwezig zijn.
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 vandaag gebruikt wordt (ofwel: ‘actuele medicatie’)
<value>
  <low value="201011190000"/>
</value>
Schematron assert role red error
test not(hl7:low) or string-length(hl7:low/@value)>=12
Melding Onder- en bovengrens (low, high) is tot op de minuut te specficeren
Schematron assert role red error
test not(hl7:high) or string-length(hl7:high/@value)>=12
Melding Onder- en bovengrens (low, high) is tot op de minuut te specficeren
Keuze min 1 element(en) en max 2 element(en). Elementen om uit te kiezen:
  • hl7:low
  • hl7:high
treeblank treeblank treeblank treeblank treeblank treetree hl7:low
TS 0 .. 1 R (opvragenVoorschriftenLijst)
target Gekoppeld aan concepten:
kz-dataelement-9503 Begindatum toedieningsperiode
treeblank treeblank treeblank treeblank treeblank treetree hl7:high
TS 0 .. 1 R (opvragenVoorschriftenLijst)
target Gekoppeld aan concepten:
kz-dataelement-9504 Einddatum toedieningsperiode
treeblank treeblank treetree hl7:medicationCode
0 .. 1 Medicatie code (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treetree hl7:value
CE 1 .. * M (opvragenVoorschriftenLijst)
target Gekoppeld aan concepten:
kz-dataelement-9511 Medicatiecode
treeblank treeblank treetree hl7:medicationCombinedOrderID
0 .. 1 R Voorschriftnummer. De unieke identifier van een specifiek medicatievoorschrift dat gezocht wordt. (opvragenVoorschriftenLijst)
Voorbeeld
Opvragen van het medicatievoorschrift met nummer ‘0012462311’, zoals toegekend door het EPD-systeem van een bepaald ziekenhuis. Het vragend systeem kan dit nummer uit een andere bron hebben verkregen en zo de detailgegevens van dit voorschrift opvragen.
<value root="2.16.840.1.113883.2.4.6.1.6005432.2.8.1" extension="0012462311"/>
treeblank treeblank treeblank treetree hl7:value
II 1 .. 1 M (opvragenVoorschriftenLijst)
target Gekoppeld aan concepten:
kz-dataelement-9512 Voorschrift identificatie
treeblank treeblank treetree hl7:patientId
1 .. 1 M Patiënt waarop de contactmomenten betrekking hebben (verplicht aanwezig). (opvragenVoorschriftenLijst)
Voorbeeld
Opvragen van contactmomenten van de patiënt met landelijk BSN “562632643”.
<patientId>
  <value root="2.16.840.1.113883.2.4.6.3" extension="562632643"/>
</patientId>
treeblank treeblank treeblank treetree hl7:value
II.NL.BSN 1 .. 1 M Het burgerservicenummer (BSN) dat de gezochte patiënt uniek identificeert. Het is niet mogelijk om via het LSP gegevens op te vragen op basis van lokale patiëntnummers. (opvragenVoorschriftenLijst)
treeblank treeblank treeblank treeblank treetree @root
1 .. 1 F 2.16.840.1.113883.2.4.6.3
treeblank treeblank treeblank treeblank treetree @extension
1 .. 1  
  BSN
target Gekoppeld aan concepten:
kz-dataelement-9501 Patiëntnummer