7phcy:V6.12.11 medicationDispenseRequest.quantity - Bewerkingsoverzicht

Wetering: MP-207 afleveradres specificatie /* medicationDispenseRequest.destination */

2020-10-30T09:32:24Z

MP-207 afleveradres specificatie medicationDispenseRequest.destination

← Oudere versie		Versie van 30 okt 2020 09:32
Regel 119:		Regel 119:
	====medicationDispenseRequest.destination====		====medicationDispenseRequest.destination====
	{{Captionformat\|Formaat (''afleverlocatie'')}}		{{Captionformat\|Formaat (''afleverlocatie'')}}
	Bij elk verstrekkingsverzoek kan optioneel worden aangegeven op welke plaats de		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 is dit gegeven vanzelfsprekend niet nodig. Het dient dus alleen gebruikt te worden om een afwijkend afleveradres (in een ambulante situatie) aan te duiden.
	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.		'''XML voorbeeld:''' Medicatie moet op het woonadres bezorgd worden.
Regel 139:		Regel 135:
	</syntaxhighlight>		</syntaxhighlight>

	Als de afleverlocatie wordt doorgegeven, dan is dit attribuut verplicht gevuld en		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).
	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		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’ in combinatie met een korte beschrijving in unitID te worden doorgegeven en niet het woonadres zelf.
	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.

	~~{{NoteBox\|Onderstaand voorbeeld is onjuist en zal worden aangepast in de volgende versie van de publicatie. Zie [https://bits.nictiz.nl/browse/MP-207 issue MP-207].}}~~

	'''XML voorbeeld:''' Er wordt doorgegeven dat aflevering op het (bekende) woonadres moet plaatsvinden:		'''XML voorbeeld:''' Er wordt doorgegeven dat aflevering op het (bekende) woonadres moet plaatsvinden:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<addr use=~~’HP’~~/>		<destination>
			<serviceDeliveryLocation>
			<code nullFlavor="NI"/>
			<addr use="HP">
			<unitID>Thuisadres</unitID>
			</addr>
			</serviceDeliveryLocation>
			</destination>
	</syntaxhighlight>		</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.		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.

	{{NoteBox\|~~Onderstaand~~ gebruik van desc is achterhaald en de zibs gebruiken hiervoor unitID~~. Daarom zal dit worden aangepast in de volgende versie van de publicatie. Zie [https://bits.nictiz.nl/browse/MP-207 issue MP-207]~~. Ontvangers dienen rekening te houden met zowel desc als unitID.}}		<syntaxhighlight lang="xml">
			<destination>
			<serviceDeliveryLocation>
			<code nullFlavor="NI"/>
			<addr>
			<unitID>Bezorgen aan de balie</unitID>
			</addr>
			</serviceDeliveryLocation>
			</destination>
			</syntaxhighlight>

			{{NoteBox\|In de vorige versie van de specificaties (6.12.10) werd gebruik gemaakt van desc. Dit is achterhaald (de zibs gebruiken hiervoor unitID). Ontvangers dienen echter rekening te houden met zowel desc als unitID.}}

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

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

	De heer Pietersen is op vakantie in de regio van apotheek ‘De Gulden Pil’. Zijn		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.
	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.		'''XML voorbeeld:''' Een vakantieadres.

Maarten Ligtvoet: Copy of V6.12.10

2020-09-16T14:18:10Z

Copy of V6.12.10

Nieuwe pagina

<noinclude>{{DocumentPart|ns=7phcy|title=V6.12.11_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.

{{NoteBox|Onderstaand voorbeeld is onjuist en zal worden aangepast in de volgende versie van de publicatie. Zie [https://bits.nictiz.nl/browse/MP-207 issue MP-207].}}

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

{{NoteBox|Onderstaand gebruik van desc is achterhaald en de zibs gebruiken hiervoor unitID. Daarom zal dit worden aangepast in de volgende versie van de publicatie. Zie [https://bits.nictiz.nl/browse/MP-207 issue MP-207]. Ontvangers dienen rekening te houden met zowel desc als unitID.}}

'''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>9999 AA</postalCode>
<city>Buitendorp</city>
</addr>
</syntaxhighlight>