7phcy:V6.12 medicationDispenseEvent.quantity: verschil tussen versies

Uit informatiestandaarden
Ga naar: navigatie, zoeken
(medicationDispenseEvent.quantity)
k (Tekst vervangen - "{{DISPLAYTITLE:.*}}" door "")
 
(9 tussenliggende versies door 4 gebruikers niet weergegeven)
Regel 1: Regel 1:
{{#customtitle:medicationDispenseEvent.quantity|medicationDispenseEvent.quantity}}
 
  
<noinclude>{{DocumentPart|ns=mp|title=V6.12_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>
+
 
 +
<noinclude>{{DocumentPart|ns=7phcy|title=V6.12_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>
 
====medicationDispenseEvent.quantity====
 
====medicationDispenseEvent.quantity====
  
{{Captionformat|Formaat: <u>''Ambulante verstrekkingen''</u>}}
+
{{Captionformat|Formaat:}}
<syntaxhighlight lang="xml">
+
 
              <quantity value="…" [ unit="…" ]>
+
''Klinische verstrekkingen''
                <translation code="…"
+
<quantity nullFlavor="NA"/>
                              codeSystem=”2.16.840.1.113883.2.4.4.1.900.2"
+
 
                              displayName="…"/>
+
''Ambulante verstrekkingen''
              [ <translation code="…"
+
<quantity value="…" [ unit="…" ]>
                              codeSystem=" 2.16.840.1.113883.2.4.4.12"
+
    <translation code="…" codeSystem="2.16.840.1.113883.2.4.4.1.900.2" displayName="…"/>
                              displayName="…"/>
+
  [ <translation code="…" codeSystem=" 2.16.840.1.113883.2.4.4.12" displayName="…"/> ]
              ]
+
</quantity>
              </quantity>
 
</syntaxhighlight>
 
&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;&ensp;'''''<u>Klinische verstrekkingen</u>'''''
 
<syntaxhighlight lang="xml">
 
              <quantity nullFlavor="NA"/>
 
</syntaxhighlight>
 
  
 
'''Definitie''': De hoeveelheid medicatie die is verstrekt bij deze medicatieverstrekking.
 
'''Definitie''': De hoeveelheid medicatie die is verstrekt bij deze medicatieverstrekking.
Regel 27: Regel 21:
 
* Bij '''ambulante verstrekkingen''' (meestal bij openbare apotheken) is <quantity> '''verplicht gevuld''' met de aan de patiënt of diens vertegenwoordiger afgeleverde hoeveelheid van de medicatie. Deze registratie is momenteel een wettelijke eis.
 
* Bij '''ambulante verstrekkingen''' (meestal bij openbare apotheken) is <quantity> '''verplicht gevuld''' met de aan de patiënt of diens vertegenwoordiger afgeleverde hoeveelheid van de medicatie. Deze registratie is momenteel een wettelijke eis.
 
* Bij '''klinische verstrekkingen''' (dus geaccordeerde klinische medicatieopdrachten) hoeft <quantity> '''niet gevuld''' te zijn, omdat het in de klinische situatie vaak heel lastig is (en sowieso niet erg zinvol) om de ‘verstrekte’ hoeveelheid te bepalen.  
 
* Bij '''klinische verstrekkingen''' (dus geaccordeerde klinische medicatieopdrachten) hoeft <quantity> '''niet gevuld''' te zijn, omdat het in de klinische situatie vaak heel lastig is (en sowieso niet erg zinvol) om de ‘verstrekte’ hoeveelheid te bepalen.  
Er wordt dan de ''nullFlavor'' ”NA” (not applicable) meegegeven in het element.
+
Er wordt dan de ''nullFlavor'' "NA" (not applicable) meegegeven in het element.
  
 
De primaire eenheid moet afkomstig zijn uit de [http://aurora.rg.iupui.edu/UCUM|Unified Codes for Units of Measure]] (UCUM). Deze lijst met eenheden is wereldwijd geaccepteerd. De lijst met eenheden uit de UCUM is ook opgenomen als HL7 vocabulary domain ''UnitsOfMeasureCaseSensitive''.
 
De primaire eenheid moet afkomstig zijn uit de [http://aurora.rg.iupui.edu/UCUM|Unified Codes for Units of Measure]] (UCUM). Deze lijst met eenheden is wereldwijd geaccepteerd. De lijst met eenheden uit de UCUM is ook opgenomen als HL7 vocabulary domain ''UnitsOfMeasureCaseSensitive''.
Regel 37: Regel 31:
 
{{NoteBox|Vooral het feit dat HL7v3 geen ‘telbare’ eenheden, zoals tabletten, ondersteunt, leidt soms tot verwarring. De gedachte is dat dit feitelijk geen teleenheden zijn, maar de farmaceutische vorm van de medicatie. Deze is impliciet door de gekozen medicatiecode of kan desgewenst expliciet worden doorgegeven. Op deze manier wordt inconsistentie tussen hoeveelheid en vorm voorkomen.}}  
 
{{NoteBox|Vooral het feit dat HL7v3 geen ‘telbare’ eenheden, zoals tabletten, ondersteunt, leidt soms tot verwarring. De gedachte is dat dit feitelijk geen teleenheden zijn, maar de farmaceutische vorm van de medicatie. Deze is impliciet door de gekozen medicatiecode of kan desgewenst expliciet worden doorgegeven. Op deze manier wordt inconsistentie tussen hoeveelheid en vorm voorkomen.}}  
  
De unit “1” is de default voor telbare eenheden (het betekent dus ‘eenheden’ en niets meer). Het weglaten van de unit wordt dus geïnterpreteerd als unit=”1”. }}
+
De unit "1" is de default voor telbare eenheden (het betekent dus ‘eenheden’ en niets meer). Het weglaten van de unit wordt dus geïnterpreteerd als unit="1". }}
  
 
Normaal gesproken zijn alleen de volgende eenheden nog in de praktijk:
 
Normaal gesproken zijn alleen de volgende eenheden nog in de praktijk:
Regel 75: Regel 69:
 
|alleen klinisch
 
|alleen klinisch
 
|}
 
|}
 
  
 
{| class="wikitable" width="50%"
 
{| class="wikitable" width="50%"
Regel 112: Regel 105:
  
 
Het is '''verplicht''' om naast (dus niet in plaats van!) de bovengenoemde UCUM codering van HL7, ook een vertaling door te geven naar de '''G-Standaard basiseenheden''' (tabel 2 van de thesauraus). Daarnaast kan '''optioneel''' een vertaling worden aangeduid naar de '''G-Standaard deelverpakkingen''' (tabel 4). In beide gevallen wordt gebruik gemaakt van de '''numerieke codes''' uit deze tabellen (doorgegeven '''zonder voorloopnullen''').
 
Het is '''verplicht''' om naast (dus niet in plaats van!) de bovengenoemde UCUM codering van HL7, ook een vertaling door te geven naar de '''G-Standaard basiseenheden''' (tabel 2 van de thesauraus). Daarnaast kan '''optioneel''' een vertaling worden aangeduid naar de '''G-Standaard deelverpakkingen''' (tabel 4). In beide gevallen wordt gebruik gemaakt van de '''numerieke codes''' uit deze tabellen (doorgegeven '''zonder voorloopnullen''').
 
  
 
De G-Standaard basiseenheden hebben OID '''2.16.840.1.113883.2.4.4.1.900.2'''.
 
De G-Standaard basiseenheden hebben OID '''2.16.840.1.113883.2.4.4.1.900.2'''.
 
De G-Standaard deelverpakkingen hebben OID '''2.16.840.1.113883.2.4.4.12'''.
 
De G-Standaard deelverpakkingen hebben OID '''2.16.840.1.113883.2.4.4.12'''.
 
  
 
'''XML voorbeeld:'''
 
'''XML voorbeeld:'''
  
Er zijn aan een patiënt in een openbare apotheek 6 verpakkingen met elk 12 tabletten van een bepaald medicijn verstrekt. De totale verstrekte hoeveelheid is dus 72 tabletten. Het feit dat het om tabletten gaat volgt uit de farmaceutische vorm van de medicatie. Merk op dat “unit de defaultwaarde “1” heeft, en dus ook weggelaten mag worden.
+
Er zijn aan een patiënt in een openbare apotheek 6 verpakkingen met elk 12 tabletten van een bepaald medicijn verstrekt. De totale verstrekte hoeveelheid is dus 72 tabletten. Het feit dat het om tabletten gaat volgt uit de farmaceutische vorm van de medicatie. Merk op dat "unit de defaultwaarde "1" heeft, en dus ook weggelaten mag worden.
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<quantity value=“72” unit=“1”>
+
<quantity value="72" unit="1">
   <translation value="30" code="245"  
+
   <translation value="72" code="245"  
 
     codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
 
     codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
 
     displayName="stuk"/>
 
     displayName="stuk"/>
Regel 133: Regel 124:
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<quantity value=”200” unit=”ml”>
+
<quantity value="200" unit="ml">
 
   <translation value="200" code="233"
 
   <translation value="200" code="233"
 
       codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
 
       codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
Regel 143: Regel 134:
  
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
<quantity nullFlavor=”NA”/>
+
<quantity nullFlavor="NA"/>
 
</syntaxhighlight>
 
</syntaxhighlight>

Huidige versie van 25 aug 2020 om 16:44


Dit materiaal is onderdeel van HL7v3-domein Pharmacy V6.12_HL7v3-domeinspecificatie_Pharmacy.
  • Compatible wijzigingen/nadere bewoordingen, tikfouten kunnen direct in de Wiki gewijzigd worden
  • Open issues die discussie vergen s.v.p. in de commentaarsectie opnemen.

medicationDispenseEvent.quantity

Formaat:

Klinische verstrekkingen

<quantity nullFlavor="NA"/>			

Ambulante verstrekkingen

<quantity value="…" [ unit="…" ]>	
    <translation code="…" codeSystem="2.16.840.1.113883.2.4.4.1.900.2" displayName="…"/>
  [ <translation code="…" codeSystem=" 2.16.840.1.113883.2.4.4.12" displayName="…"/> ]
</quantity>	

Definitie: De hoeveelheid medicatie die is verstrekt bij deze medicatieverstrekking.

Er gelden aparte regels voor de ambulante respectievelijk klinische setting:

  • Bij ambulante verstrekkingen (meestal bij openbare apotheken) is <quantity> verplicht gevuld met de aan de patiënt of diens vertegenwoordiger afgeleverde hoeveelheid van de medicatie. Deze registratie is momenteel een wettelijke eis.
  • Bij klinische verstrekkingen (dus geaccordeerde klinische medicatieopdrachten) hoeft <quantity> niet gevuld te zijn, omdat het in de klinische situatie vaak heel lastig is (en sowieso niet erg zinvol) om de ‘verstrekte’ hoeveelheid te bepalen.

Er wordt dan de nullFlavor "NA" (not applicable) meegegeven in het element.

De primaire eenheid moet afkomstig zijn uit de Codes for Units of Measure] (UCUM). Deze lijst met eenheden is wereldwijd geaccepteerd. De lijst met eenheden uit de UCUM is ook opgenomen als HL7 vocabulary domain UnitsOfMeasureCaseSensitive.

Het datatype PQ dat hierbij gebruikt wordt, kan betrekking hebben op een meetbare hoeveelheid van het geneesmiddel (bijvoorbeeld in grammen of liters) of op het aantal telbare eenheden (bijvoorbeeld tabletten of ampullen). HL7v3 hanteert dit als volgt:

  • ‘Meetbare’ hoeveelheden worden in overeenkomstige fysieke eenheden uitgedrukt;
  • ‘Telbare’ hoeveelheden kennen alleen een aantal met als eenheid ‘1’ (‘units’).

De unit "1" is de default voor telbare eenheden (het betekent dus ‘eenheden’ en niets meer). Het weglaten van de unit wordt dus geïnterpreteerd als unit="1". }}

Normaal gesproken zijn alleen de volgende eenheden nog in de praktijk:

unit betekenis opmerkingen
m meter zie tabel voorvoegsels
g gram zie tabel voorvoegsels
l liter zie tabel voorvoegsels
[drp] druppel = 1/12 ml
[tsp_us] theelepel = 0.003 l
[tbs_us] eetlepel = 0.015 l
[iU] internationale eenheid alleen klinisch
Tabel voorvoegsels
voorvoegsel bij unit betekenis omrekenfactor
u micro 1/1.000.000
m milli 1/1.000
c centi 1/100
d deci 1/10
k kilo 1.000


Deze voorvoegsels kunnen alleen gebruikt worden in combinatie met m, g en l. De achterliggende gedachte achter het attribuut unit van het datatype PQ is dat meetbare waarden zoveel mogelijk naar elkaar omgerekend moeten kunnen worden. Het mag dus niets uitmaken of een systeem 2 mg of 0.002 g stuurt als verstrekte hoeveelheid, omdat het ontvangende systeem in staat moet zijn om te zien dat deze feitelijk hetzelfde zijn. Ontvangende systemen moeten de mogelijke eenheden kunnen omrekenen.


VERTALING NAAR ANDERE CODERINGSSYSTEMEN

Het is verplicht om naast (dus niet in plaats van!) de bovengenoemde UCUM codering van HL7, ook een vertaling door te geven naar de G-Standaard basiseenheden (tabel 2 van de thesauraus). Daarnaast kan optioneel een vertaling worden aangeduid naar de G-Standaard deelverpakkingen (tabel 4). In beide gevallen wordt gebruik gemaakt van de numerieke codes uit deze tabellen (doorgegeven zonder voorloopnullen).

De G-Standaard basiseenheden hebben OID 2.16.840.1.113883.2.4.4.1.900.2. De G-Standaard deelverpakkingen hebben OID 2.16.840.1.113883.2.4.4.12.

XML voorbeeld:

Er zijn aan een patiënt in een openbare apotheek 6 verpakkingen met elk 12 tabletten van een bepaald medicijn verstrekt. De totale verstrekte hoeveelheid is dus 72 tabletten. Het feit dat het om tabletten gaat volgt uit de farmaceutische vorm van de medicatie. Merk op dat "unit de defaultwaarde "1" heeft, en dus ook weggelaten mag worden.

<quantity value="72" unit="1">
  <translation value="72" code="245" 
     codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
     displayName="stuk"/>
</quantity>

Een apotheekhoudende huisarts heeft aan een patiënt 200 ml van een vloeistof verstrekt.

<quantity value="200" unit="ml">
   <translation value="200" code="233"
      codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
      displayName="MILLILITER"/>
</quantity>

Er wordt informatie doorgegeven over een (geaccordeerde) klinische medicatieopdracht.

<quantity nullFlavor="NA"/>