Terug naar index << Terug naar templates

Template Medicatieverstrekking

Template 2.16.840.1.113883.2.4.3.11.60.20.77.10.2 - MedicationDispenseEventMessage

Id 2.16.840.1.113883.2.4.3.11.60.20.77.10.2

Classificatie HL7v2/v3 message level template

Relatie Afgeleide: model PORX_MT924000NL02 (DYNAMISCH)

Context Padnaam /

Versie geldig vanaf 2013‑05‑21 status In ontwikkeling

Open/gesloten Open (ook andere dan gedefinieerde elementen zijn toegestaan)

Omschrijving

De template is bedoeld om alle relevante gegevens rond een medicatieverstrekking weer te geven. Het payload model PORX_MT924000NL02 wordt gebruikt bij het versturen van een nieuwe verstrekking, maar bestaat op zichzelf uit niets anders dan template MedicationDispenseEvent. MedicationDispenseEvent fungeert daarnaast als onderdeel van de Medicatieverstrekkingenlijst, als component van een opgeleverde lijst.
De belangrijkste kenmerken van het model zijn:

Elke verstrekking heeft betrekking op één enkele patiënt.
Elke verstrekking hoort bij max. één medicatievoorschrift.
Elke verstrekking kent één enkele verstrekker als uitvoerder.
Elke verstrekking heeft één ‘verantwoordelijke zorgverlener’.
Elke verstrekking heeft betrekking op één enkele soort medicatie.
Elke verstrekking zal één of meer toedieningsverzoeken betreffen.

De zogenaamde focal class is de klasse MedicationDispenseEvent, die betrekking heeft op één enkele medicatieverstrekking.

Gebruikt door / Gebruikt

Gebruikt door / Gebruikt 1 template

Gebruikt Template-id	Naam	Versie
2.16.840.1.113883.2.4.3.11.60.20.77.10.110	MedicationDispenseEvent	DYNAMISCH

Item DT Card Conf Omschrijving Label

hl7:QURX_IN990113NL

(MedicationDispenseEventMessage)

hl7:ControlActProcess

(MedicationDispenseEventMessage)

hl7:subject

(MedicationDispenseEventMessage)

Ingevoegd van 2.16.840.1.113883.2.4.3.11.60.20.77.10.110 Medication Dispense Event (DYNAMISCH)

hl7:medicationDispenseEvent

0 .. *

(MedicationDispenseEventMessage)

@classCode

0 .. 1

SPLY

@moodCode

0 .. 1

EVN

Gekoppeld aan concepten:

mp-dataelement800-5	Verstrekking
mp-dataelement612-5	Verstrekking
mp-dataelement612-3440	Terhandstelling

hl7:id

1 .. 1

Verstrekkingsnummer

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement800-3000	Identificatie
mp-dataelement612-3000	Identificatie

hl7:statusCode

1 .. 1

(MedicationDispenseEventMessage)

@code

1 .. 1

completed

Gekoppeld aan concepten:

mp-dataelement800-9542	Status
mp-dataelement612-9542	Status

hl7:effectiveTime

IVL_TS

1 .. 1

Verstrekkingsdatum/periode

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-3450

Datum

hl7:quantity

1 .. 1

Verstrekte hoeveelheid. Bij ambulante verstrekkingen verplicht om een waarde mee te geven.
Verdere informatie

(MedicationDispenseEventMessage)

@nullFlavor

0 .. 1

Bij klinische verstrekkingen hoeft quantity niet gevuld te zijn. Er wordt dan nullFlavor NA meegegeven.

Gekoppeld aan concepten:

mp-dataelement612-3460

Hoeveelheid

hl7:translation

PQR

1 .. 1

Vertaling door te geven naar de G-Standaard basiseenheden (tabel 2 van de thesauraus).

(MedicationDispenseEventMessage)

@codeSystem

1 .. 1

2.16.840.1.113883.2.4.4.1.900.2

hl7:translation

PQR

0 .. 1

Vertaling door te geven naar de G-G-Standaard deelverpakkingen (tabel 4).

(MedicationDispenseEventMessage)

@codeSystem

1 .. 1

2.16.840.1.113883.2.4.4.12

hl7:expectedUseTime

IVL_TS

0 .. 1

Logistieke verbruiksperiode
Verdere informatie

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-3465

Verbruiksperiode

hl7:width

1 .. 1

Logistieke duur verbruik. Alleen element width is toegestaan.

(MedicationDispenseEventMessage)

Schematron assert role error

test not(./child::*/name()!='width')

Melding Bij logistieke verbruiksduur is alleen element width toegestaan.

hl7:performer

1 .. 1

Verstrekkende medewerker/instelling

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

PRF

Gekoppeld aan concepten:

mp-dataelement612-3010

Verstrekker

Bevat 2.16.840.1.113883.2.4.3.11.60.20.77.10.9004 Performer (DYNAMISCH) met overschreven kardinaliteit 1 .. 1 Verplicht Vereist

hl7:product

1 .. 1

Verstrekte medicatie

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

PRD

hl7:dispensedMedication

1 .. 1

Verdere informatie

(MedicationDispenseEventMessage)

@classCode

0 .. 1

DST

Gekoppeld aan concepten:

mp-dataelement612-3470

Geneesmiddel

Ingevoegd van 2.16.840.1.113883.2.4.3.11.60.20.77.10.106 Medication Kind (DYNAMISCH) 1 .. 1 Verplicht Vereist

hl7:MedicationKind

1 .. 1

Verdere informatie

(MedicationDispenseEventMessage)

@classCode

0 .. 1

MMAT

@determinerCode

0 .. 1

KIND

Ingevoegd van 2.16.840.1.113883.2.4.3.11.60.20.77.10.9005 Medication Code (DYNAMISCH) 1 .. 1 Verplicht

Voorbeeld

Een voorschrijver schrijft DIAZEPAM TABLET 5 MG voor op het niveau van de GPK

<code code="20664" codeSystem="2.16.840.1.113883.2.4.4.1" displayName="DIAZEPAM TABLET 5 MG"/>

Voorbeeld

Een voorschrijver schrijft voor op het niveau van de PRK, maar zijn software zorgt er automatisch voor dat ook de bijbehorende GPK meegegeven wordt (n-op-1 relatie).

<code code="7447" codeSystem="2.16.840.1.113883.2.4.4.10" displayName="DIAZEPAM TABLET 5 MG"> <translation code="20664" codeSystem="2.16.840.1.113883.2.4.4.1"/> </code>

Voorbeeld

Een voorschrijver schrijft voor op het niveau van de HPK, maar zijn software zorgt er voor dat zowel de bijbehorende PRK als de GPK meegegeven worden (n-op-1 relatie).

<code code="239038" codeSystem="2.16.840.1.113883.2.4.4.7" displayName="VALIUM TABLET 5 MG"> <translation code="7447" codeSystem="2.16.840.1.113883.2.4.4.10"/> <translation code="20664" codeSystem="2.16.840.1.113883.2.4.4.1"/> </code>

Voorbeeld

Er heeft een verstrekking plaatsgevonden, waarbij een specifiek artikel is geregistreerd. Het apotheeksysteem verzendt het artikelnummer, plus vertalingen naar HPK en PRK.

<code code="546342" codeSystem="2.16.840.1.113883.2.4.4.8" displayName="VALIUM TABLET 5 MG"> <translation code="239038" codeSystem="2.16.840.1.113883.2.4.4.7"/> <translation code="20664" codeSystem="2.16.840.1.113883.2.4.4.1"/> </code>

Keuze min 1 element(en) en max 1 element(en). Elementen om uit te kiezen:

hl7:code[@code]
hl7:code[@nullFlavor]

hl7:code
waar
[@code]

0 .. 1

Bevat codering voor medicatie. Deze primaire code in het datatype CE moet de meest specifieke aanduiding zijn die in het registrerende systeem is vastgelegd.

@codeSystem='2.16.840.1.113883.2.4.4.1' is GPK. Generieke productcode: merkloze aanduiding op basis van de werkzame stof, inclusief de sterkte, de farmaceutische vorm en soms toedieningsweg.
@codeSystem='2.16.840.1.113883.2.4.4.10' is PRK. Voorschrijfcode: GPK inclusief extra kenmerken om te zorgen dat alle bij het voorschrijven relevante informatie in één code gevangen wordt (soms ook hulpstoffen).
@codeSystem='2.16.840.1.113883.2.4.4.7' is HPK. Handelsproductcode: GPK inclusief merkaanduiding van een specifieke fabrikant.
@codeSystem='2.16.840.1.113883.2.4.4.8' is KNMPnummer. Artikelnummer: HPK inclusief aanduiding van specifieke verpakkingsvorm.

(MedicationDispenseEventMessage)

CONF

@codeSystem moet "2.16.840.1.113883.2.4.4.1" zijn

@codeSystem moet "2.16.840.1.113883.2.4.4.7" zijn

@codeSystem moet "2.16.840.1.113883.2.4.4.8" zijn

@codeSystem moet "2.16.840.1.113883.2.4.4.10" zijn

Gekoppeld aan concepten:

mp-dataelement612-3480

Code

hl7:translation

0 .. *

De vertalingen in het datatype CE bevatten dan equivalente of meer generieke codes uit andere coderingssystemen, maar nooit meer specifieke codes. Omdat niet alle systemen reeds de PRK-codering ondersteunen, is het verplicht om altijd ook de GPK-codering mee te geven als PRK de primaire code is.

(MedicationDispenseEventMessage)

Schematron assert role error

test (@code and @displayName) or not(@code)

Melding Medicatiecode moet attribuut @displayName hebben tenzij er geen code is

Schematron assert role error

test not(hl7:translation/@codeSystem=@codeSystem)

Melding Medicatiecode kan geen translation hebben uit hetzelfde codesysteem

Schematron assert role error

test not(hl7:translation/@codeSystem='2.16.840.1.113883.2.4.4.10') or (hl7:translation/@codeSystem='2.16.840.1.113883.2.4.4.10' and @codeSystem!='2.16.840.1.113883.2.4.4.1')

Melding Eventuele translation elementen moeten equivalente of meer algemene alternatieve coderingen bevatten. GPK kan dus niet vertaald worden naar PRK.

Schematron assert role error

test not(hl7:translation/@codeSystem='2.16.840.1.113883.2.4.4.7') or (hl7:translation/@codeSystem='2.16.840.1.113883.2.4.4.7' and @codeSystem='2.16.840.1.113883.2.4.4.8')

Melding Eventuele translation elementen moeten equivalente of meer algemene alternatieve coderingen bevatten. Alleen artikelnummer kan dus vertaald worden naar HPK.

Schematron assert role error

test not(hl7:translation/@codeSystem='2.16.840.1.113883.2.4.4.8')

Melding Eventuele translation elementen moeten equivalente of meer algemene alternatieve coderingen bevatten. Er kan geen vertaling zijn naar artikelnummer.

Schematron assert role error

test not(@codeSystem='2.16.840.1.113883.2.4.4.10') or (hl7:translation/@codeSystem='2.16.840.1.113883.2.4.4.1')

Melding Medicatiecode uit PRK moet een translation hebben uit GPK

Schematron assert role error

test not(hl7:originalText)

Melding Bij gecodeerde medicatie mag originalText geen waarde hebben

hl7:code
waar
[@nullFlavor]

0 .. 1

Bij magistrale receptuur (eigen bereiding) is het verplicht om: Het element te vullen met de nullFlavor ”OTH” én een subelement originalText toe te voegen, met daarin een korte omschrijving van de medicatie. Bij voorkeur wordt daarnaast een uitgebreidere beschrijving van samenstelling en bereidingswijze doorgegeven (zie hiervoor de hiernavolgende elementen).

(MedicationDispenseEventMessage)

@nullFlavor

1 .. 1

OTH

hl7:originalText

1 .. 1

(MedicationDispenseEventMessage)

Schematron assert role error

test not(@nullFlavor) or @nullFlavor='OTH'

Melding Bij niet gecodeerde medicatie moet @nullFlavor 'OTH' bevatten

hl7:desc

0 .. 1

Medicatieomschrijving
Verdere informatie

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-3490

Omschrijving

Schematron assert role error

test ../hl7:code/@nullFlavor

Melding Bij gecodeerde medicatie mag desc geen waarde hebben

hl7:activeIngredient

0 .. *

Werkzame stof
Verdere informatie

(MedicationDispenseEventMessage)

@classCode

0 .. 1

ACTI

Gekoppeld aan concepten:

mp-dataelement612-3500

Ingrediënten

Bevat 2.16.840.1.113883.2.4.3.11.60.20.77.10.107 Active Ingredient (DYNAMISCH) met overschreven kardinaliteit 0 .. *

hl7:otherIngredient

0 .. *

Andere ingrediënt
Verdere informatie

(MedicationDispenseEventMessage)

@classCode

0 .. 1

INGR

Bevat 2.16.840.1.113883.2.4.3.11.60.20.77.10.109 Other Ingredient (DYNAMISCH) met overschreven kardinaliteit 0 .. *

Schematron assert role error

test ../hl7:code/@nullFlavor

Melding Bij gecodeerde medicatie mag otherIngredient niet gebruikt worden

Schematron assert role error

test not(hl7:code/@nullFlavor) or hl7:activeIngredient or hl7:otherIngredient or hl7:desc

Melding Als er geen gecodeerde medicatie is en ook geen ingrediënten dan moet desc een waarde hebben

hl7:directTargetOf

0 .. 1

Bijbehorend Medicatievoorschrift

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

DIR

hl7:prescription

1 .. 1

Medicatievoorschrift
Verdere informatie

(MedicationDispenseEventMessage)

@classCode

0 .. 1

SBADM

@moodCode

0 .. 1

RQO

hl7:id

1 .. 1

De identificatie van het medicatievoorschrift behorend bij de verstrekking. De identificatie wordt gegenereerd door het voorschrijvende systeem (bijvoorbeeld van de huisarts of medisch specialist) en wordt door het verstrekkend systeem slechts overgenomen ter referentie. Hierbij moet zowel root als extension bewaard worden.
Verdere informatie

(MedicationDispenseEventMessage)

@nullFlavor

0 .. 1

UNK

Als geen voorschriftnummer via elektronische uitwisseling met het voorschrijvend systeem verkregen is, dan dient op de plaats van dit element expliciet de nullFlavor ”UNK” te worden opgenomen.
Verdere informatie

Voorbeeld

<id extension="0008112345" root="2.16.840.1.113883.2.4.6.1.1025463.1.9" assigningAuthorityName="HIS van Dr. Jansen"/>

Voorbeeld

<id nullFlavor="UNK"/>

hl7:statusCode

1 .. 1

De status van het medicatievoorschrift behorend bij de verstrekking. Die status is “active” als de patiënt nog medicatie gebruikt op basis van dit voorschrift (meestal betreft dit de medicatie die bij de onderhavige verstrekking is geleverd) en “completed” als het gebruik van medicatie op basis van dit voorschrift afgerond is.

(MedicationDispenseEventMessage)

@nullFlavor

0 .. 1

UNK

In de meeste gevallen zal het verstrekkende systeem echter niet over deze informatie beschikken en daarom de nullFlavor ”UNK” opleveren (status voorschrift is onbekend).

CONF

@code moet "active" zijn

@code moet "completed" zijn

Voorbeeld

<statusCode code="active"/>

Voorbeeld

<statusCode nullFlavor="UNK"/>

hl7:subject

0 .. 1

subject is conditioneel verplicht, afhankelijk van de HL7v3 interactie waarbinnen de Medicatieverstrekking wordt gebruikt:

subject niet opnemen als de Medicatieverstrekking onderdeel is van een Medicatieverstrekkingenlijst (antwoord op interactie OpvragenVerstrekkingenlijst).
subject verplicht opnemen als de Medicatieverstrekking wordt gebruikt als op zichzelf staande payload van een notificatie (in de interactie meldVerstrekking)

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

SBJ

Schematron assert role error

test not(name(/*)='QURX_IN990113NL')

Melding subject niet opnemen als de Medicatieverstrekking onderdeel is van een Medicatieverstrekkingenlijst

hl7:Patient

1 .. 1

Verdere informatie

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-9543

Patientgegevens

Bevat 2.16.840.1.113883.2.4.3.11.60.20.77.10.816 PatientNL in verstrekking (DYNAMISCH) met overschreven kardinaliteit 1 .. 1 Verplicht Vereist

hl7:author

0 .. 1

Verdere informatie

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

AUT

hl7:time

1 .. 1

De datum en eventueel tijd waarop het bijbehorende voorschrift werd geschreven. In het geval van een voorschrift dat direct elektronisch werd vastgelegd is de voorschrijftijd meestal gelijk aan de systeemtijd op het moment van invoer. In het geval van een handmatig voorschrift dat later elektronisch wordt vastgelegd, kan de voorschrijfdatum met terugwerkende kracht worden ingevoerd (datum op het papieren recept). Als de voorschrijfdatum niet bekend is, kan nullFlavor ”UNK” worden gebruikt.

(MedicationDispenseEventMessage)

@nullFlavor

0 .. 1

UNK

Voorbeeld

Een verstrekking vindt plaats op basis van een voorschrift dat om 14:24 op 10 december 2010 is geschreven (dit is meegekomen met het elektronisch ontvangen voorschrift).

<time value="201012101424"/>

Voorbeeld

Een verstrekking vindt plaats op basis van een voorschrift, waarvan de voorschrijfdatum niet (meer) bekend is (omdat het onderdeel is van incomplete historische gegevens).

<time nullFlavor="UNK"/>

hl7:AssignedPerson

1 .. 1

De voorschrijvende arts. Bij het doorgeven van de voorschrijvende arts wordt gebruik gemaakt van de CMET R_AssignedPerson [identified], waarin alleen een verplichte identificatie is opgenomen. Zie voor de CMET R_AssignedPerson [identified] de [HL7v3 IH Basis].

(MedicationDispenseEventMessage)

Voorbeeld

Er wordt een medicatieverstrekking opgevraagd, behorende bij een voorschrift van huisarts mevrouw Bette van Hamelen, die als AGB-Z nummer 01042119 heeft.

<AssignedPerson> <id extension="01042119" root="2.16.840.1.113883.2.4.6.1"/> </AssignedPerson>

hl7:id

1 .. 1

Identificatie van de voorschrijver bij een medicatieverstrekking mag op basis van:

UZI-nummer (OID 2.16.528.1.1007.3.1)
AGB-Z nummer (OID 2.16.840.1.113883.2.4.6.1)

De reden dat AGB-Z nummers toegestaan zijn is dat een medicatieverstrekking het gevolg kan zijn van een voorschrift dat is voorgeschreven op een moment dat de betreffende zorgverlener nog geen UZI-nummer had. Het AGB-Z nummer is momenteel de meest gangbare methode om zorgverleners mee te identificeren.

(MedicationDispenseEventMessage)

@root

1 .. 1

CONF

@root moet "2.16.528.1.1007.3.1" zijn

@root moet "2.16.840.1.113883.2.4.6.1" zijn

hl7:therapeuticAgentOf

1 .. *

Bijbehorend(e) Toedieningsverzoek(en).
Verdere informatie

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

TPA

Gekoppeld aan concepten:

mp-dataelement612-9603

Gebruiksinstructie

Bevat 2.16.840.1.113883.2.4.3.11.60.20.77.10.100 Medication Administration Request (DYNAMISCH) met overschreven kardinaliteit 1 .. * Verplicht Vereist

hl7:responsibleParty

1 .. 1

Verantwoordelijke zorgverlener/zorginstelling

(MedicationDispenseEventMessage)

@typeCode

0 .. 1

RESP

Gekoppeld aan concepten:

mp-dataelement612-3

Zorgverlener / Zorginstelling

hl7:assignedCareProvider

1 .. 1

(MedicationDispenseEventMessage)

@classCode

0 .. 1

ASSIGNED

Gekoppeld aan concepten:

mp-dataelement612-500

Zorgverlener

hl7:id

1 .. 1

Zorgverlenersnummer van de verantwoordelijke

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-510

Identificatie

hl7:code

1 .. 1

Zorgverlenersrol van de verantwoordelijke

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-650

Zorgverlenerrol

hl7:representedOrganization

1 .. 1

(MedicationDispenseEventMessage)

@classCode

0 .. 1

ORG

@determinerCode

0 .. 1

INSTANCE

Gekoppeld aan concepten:

mp-dataelement612-660

Zorginstelling

hl7:id

1 .. 1

Identificatie van de verstrekkende zorginstelling

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-670

Identificatie

hl7:name

0 .. 1

Naam van de zorginstelling

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-680

Naam

hl7:addr

0 .. 1

Vestigingsplaats van de zorginstelling.

(MedicationDispenseEventMessage)

Gekoppeld aan concepten:

mp-dataelement612-690

Vestigingsplaats

Variabele let Naam performerIdRoot

Waarde hl7:performer/hl7:assignedPerson/hl7:representedOrganization/hl7:id/@root

Variabele let Naam performerIdExtension

Waarde hl7:performer/hl7:assignedPerson/hl7:representedOrganization/hl7:id/@extension

Variabele let Naam responsiblePartyIdRoot

Waarde hl7:responsibleParty/hl7:assignedCareProvider/hl7:representedOrganization/hl7:id/@root

Variabele let Naam responsiblePartyIdExt

Waarde hl7:responsibleParty/hl7:assignedCareProvider/hl7:representedOrganization/hl7:id/@extension

Schematron assert role error

test not(hl7:performer/hl7:assignedPerson/hl7:representedOrganization and hl7:responsibleParty/hl7:assignedCareProvider/hl7:representedOrganization) or ($performerIdRoot=$responsiblePartyIdRoot and $performerIdExtension=$responsiblePartyIdExt)

Melding performer en responsibleParty moeten van dezelfde organisatie zijn