Maarten Ligtvoet: Tekst vervangen - "{{DISPLAYTITLE:.*}}" door ""

2020-08-25T14:08:29Z

Tekst vervangen - "{{DISPLAYTITLE:.*}}" door ""

← Oudere versie		Versie van 25 aug 2020 14:08
Regel 1:		Regel 1:
	~~{{DISPLAYTITLE:medicationDispenseRequest.quantity\|medicationDispenseRequest.quantity}}~~

	<noinclude>{{DocumentPart\|ns=7phcy\|title=V6.12.8_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>		<noinclude>{{DocumentPart\|ns=7phcy\|title=V6.12.8_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>

Maarten Ligtvoet: Tekst vervangen - "{{#customtitle:" door "{{DISPLAYTITLE:"

2020-07-20T01:27:50Z

Tekst vervangen - "{{#customtitle:" door "{{DISPLAYTITLE:"

← Oudere versie		Versie van 20 jul 2020 01:27
Regel 1:		Regel 1:
	{{~~#customtitle~~:medicationDispenseRequest.quantity\|medicationDispenseRequest.quantity}}		{{DISPLAYTITLE:medicationDispenseRequest.quantity\|medicationDispenseRequest.quantity}}

	<noinclude>{{DocumentPart\|ns=7phcy\|title=V6.12.8_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>		<noinclude>{{DocumentPart\|ns=7phcy\|title=V6.12.8_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>

Wetering op 9 okt 2018 om 13:50

2018-10-09T13:50:25Z

← Oudere versie		Versie van 9 okt 2018 13:50
Regel 5:		Regel 5:

	{{Captionformat\|Formaat:}}		{{Captionformat\|Formaat:}}
			'''''Klinische voorschriften'''''
			<quantity nullFlavor="NA"/>
	'''Ambulante voorschriften'''		'''Ambulante voorschriften'''
	<quantity value="…" [ unit="…" ]>		<quantity value="…" [ unit="…" ]>
Regel 15:		Regel 17:
	]		]
	</quantity>		</quantity>
	~~'''''Klinische voorschriften'''''~~
	~~<quantity nullFlavor="NA"/>~~

	'''Definitie''': De '''hoeveelheid''' die '''per (deel)verstrekking''' moet worden verstrekt.		'''Definitie''': De '''hoeveelheid''' die '''per (deel)verstrekking''' moet worden verstrekt.
Regel 117:		Regel 117:
	<quantity nullFlavor="NA"/>		<quantity nullFlavor="NA"/>
	</syntaxhighlight>		</syntaxhighlight>

	====medicationDispenseRequest.destination====		====medicationDispenseRequest.destination====
	{{Captionformat\|Formaat (''afleverlocatie'')}}		{{Captionformat\|Formaat (''afleverlocatie'')}}

Maarten Ligtvoet: Copy of V6.12.7

2018-02-21T11:27:25Z

Copy of V6.12.7

Nieuwe pagina

{{#customtitle:medicationDispenseRequest.quantity|medicationDispenseRequest.quantity}}

<noinclude>{{DocumentPart|ns=7phcy|title=V6.12.8_HL7v3-domeinspecificatie_Pharmacy}}</noinclude>
====medicationDispenseRequest.quantity====

{{Captionformat|Formaat:}}
'''Ambulante voorschriften'''
<quantity value="…" [ unit="…" ]>
<translation value="…" code="…"
codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
displayName="…"/>
[ <translation value="…" code="…"
codeSystem="2.16.840.1.113883.2.4.4.12"
displayName="…"/>
]
</quantity>
'''''Klinische voorschriften'''''
<quantity nullFlavor="NA"/>

'''Definitie''': De '''hoeveelheid''' die '''per (deel)verstrekking''' moet worden verstrekt.

{{NoteBox|In Nederland bestaat momenteel voor ambulante medicatievoorschriften (verstrekt in de eerste lijn) de wettelijke verplichting om de te verstrekken hoeveelheid van de medicatie expliciet door te geven. Dit bekent dat dit attribuut in ambulante voorschriften altijd '''gevuld en groter dan 0''' moet zijn.
Andersom wordt het bij klinische medicatievoorschriften '''niet gevuld''', omdat bij klinische medicatie de logistiek van medicatieverstrekkingen los staat van het voorschrift.}}

De primaire eenheid moet afkomstig zijn uit de 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''.

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 '''a'''ls eenheid ‘1’ (’units’).

{{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”.}}

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

{|| class="wikitable"
|+Typische UCUM eenheden
|-
!unit!!betekenis!!opmerkingen
|-
|m||meter||zie voorvoegsels
|-
|g||gram||zie voorvoegsels
|-
|l||liter||zie voorvoegsels
|-
|[drp]||druppel||= 1/12 ml
|-
|[tsp_us]||theelepel||= 0.003 l
|-
|[tbs_us]||eetlepel||= 0.015 l
|-
|[iU]||internationale eenheid||alleen klinisch
|-
|}
{|| class="wikitable"
|+Typische UCUM 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 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.'''

{{NoteBox|De waarde van dit gegevenselement hangt samen met het aantal gewenste deelverstrekkingen in het verstrekkingsverzoek. De <quantity> geeft de hoeveelheid te verstrekken medicatie per deelverstrekking aan. De totaal te verstrekken hoeveelheid wordt dan: '''''<repeatNumber>'' x ''<quantity>'''''.}}

<font size="3">'''VERTALING NAAR ANDERE CODERINGSSYSTEMEN'''</font>

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:'''

Een voorschrijver spreekt met de patiënt af dat deze eerst twee weken lang 3 x daags een tablet van een geneesmiddel zal slikken, vervolgens vier weken lang 2 x daags en tenslotte 6 weken lang 1 x daags een tablet (afbouwschema). In het verstrekkingsverzoek aan de openbare apotheek wordt een aantal van (14x3) + (28x2) + (42x1) = 140 tabletten genoemd als totaal te verstrekken hoeveelheid (in één verstrekking).

Daarbij wordt een vertaling meegegeven naar G-Standaard basiseenheden (subtabel 2 van de thesaurus). Hiermee wordt aangeduid dat het gaat om basiseenheid “245" (stuk). Merk op dat unit de defaultwaarde “1" heeft, en dus ook weggelaten mag worden.

<syntaxhighlight lang="xml">
<quantity value="140" unit="1">
<translation value="150" code="245"
codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
displayName="stuk"/>
</quantity>
</syntaxhighlight>

Er wordt doorgegeven dat het gaat om 20 milliliter van de te verstrekken medicatie, maar daarbij wordt een vertaling meegegeven naar G-Standaard deelverpakkingen (subtabel 4 van de thesaurus). Hiermee wordt aangeduid dat het gaat om 2 ampullen.

Merk op dat er in dit geval niet alleen een andere (vertaalde) eenheid wordt gebruikt, maar dat daarbij natuurlijk ook een andere hoeveelheid hoort (20 ml = 2 ampullen).

<syntaxhighlight lang="xml">
<quantity value="20" unit="ml">
<translation value="20" code="233"
codeSystem="2.16.840.1.113883.2.4.4.1.900.2"
displayName="MILLILITER"/>
<translation value="2" code="1"
codeSystem="2.16.840.1.113883.2.4.4.12"
displayName="AMPUL"/>
</quantity>
</syntaxhighlight>

In een klinische medicatieopdracht staat geen expliciete te verstrekken hoeveelheid.

<syntaxhighlight lang="xml">
<quantity nullFlavor="NA"/>
</syntaxhighlight>
====medicationDispenseRequest.destination====
{{Captionformat|Formaat (''afleverlocatie'')}}
Bij elk verstrekkingsverzoek kan optioneel worden aangegeven op welke plaats de
medicatie verstrekt (of liever gezegd: afgeleverd) dient te worden. Als deze locatie de
apotheek zelf is, dan dit gegeven vanzelfsprekend niet nodig. Het dient dus alleen gebruikt
te worden om een afwijkend afleveradres (in een ambulante situatie) aan te
duiden

'''XML voorbeeld:''' Medicatie moet op het woonadres bezorgd worden.
<syntaxhighlight lang="xml">
<destination>
<serviceDeliveryLocation>
<code nullFlavor="NI"/>
<addr use="HP">
<streetName>Prikstraat</streetName>
<houseNumber>12</houseNumber>
<city>Amsterdam</city>
</addr>
</serviceDeliveryLocation>
</destination>
</syntaxhighlight>

Als de afleverlocatie wordt doorgegeven, dan is dit attribuut verplicht gevuld en
bevat het adres waar de verstrekking van medicatie geacht wordt plaats te vinden.
Aangezien dit momenteel beperkt is tot ambulante medicatievoorschriften, zal dit in
de praktijk meestal het woonadres van de patiënt zijn (dit kan ook in een
verzorgingshuis zijn).

Aangezien het woonadres van de patiënt meestal al bekend zal zijn (omdat
voorschrijver en verstrekker gesynchroniseerde patiëntgegevens hebben of omdat de
patiëntgegevens zijn meegestuurd met het voorschrift), is het handig om zo eenvoudig
mogelijk te kunnen aanduiden dat aflevering bij de patiënt thuis dient plaats te vinden.
In dat geval hoeft slechts de use code ‘HP’ te worden doorgegeven en niet het
woonadres zelf.

'''XML voorbeeld:''' Er wordt doorgegeven dat aflevering op het (bekende) woonadres moet plaatsvinden:
<syntaxhighlight lang="xml">
<addr use=’HP’/>
</syntaxhighlight>

Het is ook mogelijk dat een adres al bekend is, maar een nadere toelichting nodig is in een specifieke situatie. Bijvoorbeeld bij iemand die in een verpleeghuis woont, hetgeen ook bekend is bij de apotheek, maar waar aangegeven wordt waar de medicatie afgegeven kan worden.

'''XML voorbeeld:''' Wanneer het adres bekend is, kan ook volstaan worden met een nadere toelichting voor de afleverlocatie.

<syntaxhighlight lang="xml">
<destination>
<serviceDeliveryLocation>
<code nullFlavor="NI"></code>
<addr>
<desc>Bezorgen aan de balie.</desc>
</addr>
</serviceDeliveryLocation>
</destination>
</syntaxhighlight>

De heer Pietersen is op vakantie in de regio van apotheek ‘De Gulden Pil’. Zijn
reguliere woonadres wordt doorgegeven bij de patiëntgegevens in het voorschrift,
maar daarnaast wordt doorgegeven dat de medicatie moet worden afgeleverd op het
vakantieadres:

'''XML voorbeeld:''' Een vakantieadres.

<syntaxhighlight lang="xml">
<addr use=’HV’>
<streetAddressLine>Camping de Wigwam</streetAddressLine>
<streetAddressLine>plaats 4F</streetAddressLine>
<streetName>Landweg</streetName>
<houseNumber>20-24</houseNumber>
<postalCode>9999AA</postalCode>
<city>Buitendorp</city>
</addr>
</syntaxhighlight>

7phcy:V6.12.8 medicationDispenseRequest.quantity - Bewerkingsoverzicht

Maarten Ligtvoet: Tekst vervangen - "{{DISPLAYTITLE:.*}}" door ""

Maarten Ligtvoet: Tekst vervangen - "{{#customtitle:" door "{{DISPLAYTITLE:"

Wetering op 9 okt 2018 om 13:50

Maarten Ligtvoet: Copy of V6.12.7