MedicationDispense

ResourceClinical · MedicationsTrial useMaturity 2

Indicates that a medication product is to be or has been dispensed for a named person/patient. This includes a description of the medication product (supply) provided and the instructions for administering the medication. The medication dispense is the result of a pharmacy system responding to a medication order.

StructureSearch parametersHL7 specificationStructureDefinition JSON

Tested supportFull test results →

Backends

PostgreSQLElasticsearch

Interactions

CreateReadUpdatePatchDelete

Search

15 of 15 parameters tested

Structure

Show inherited elements (14)

Element	Card.	Type	Description
identifier	0..*	Identifier	External identifier
partOf	0..*	Reference(Procedure)	Event that dispense is part of
statusRequired?!Σ	1..1	code	preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknownBinding (required): medicationdispense-status
statusReason[x]	0..1	CodeableConcept | Reference(DetectedIssue)	Why a dispense was not performedBinding (example): medicationdispense-status-reason
category	0..1	CodeableConcept	Type of medication dispenseBinding (preferred): medicationdispense-category
medication[x]RequiredΣ	1..1	CodeableConcept | Reference(Medication)	What medication was suppliedBinding (example): medication-codes
subjectΣ	0..1	Reference(Patient | Group)	Who the dispense is for
context	0..1	Reference(Encounter | EpisodeOfCare)	Encounter / Episode associated with event
supportingInformation	0..*	Reference(Resource)	Information that supports the dispensing of the medication
performer	0..*	BackboneElement	Who performed event
function	0..1	CodeableConcept	Who performed the dispense and what they didBinding (example): medicationdispense-performer-function
actorRequired	1..1	Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson)	Individual who was performing
location	0..1	Reference(Location)	Where the dispense occurred
authorizingPrescription	0..*	Reference(MedicationRequest)	Medication order that authorizes the dispense
type	0..1	CodeableConcept	Trial fill, partial fill, emergency fill, etc.Binding (example): v3-ActPharmacySupplyType
quantity	0..1	Quantity	Amount dispensed
daysSupply	0..1	Quantity	Amount of medication expressed as a timing amount
whenPreparedΣ	0..1	dateTime	When product was packaged and reviewed
whenHandedOver	0..1	dateTime	When product was given out
destination	0..1	Reference(Location)	Where the medication was sent
receiver	0..*	Reference(Patient | Practitioner)	Who collected the medication
note	0..*	Annotation	Information about the dispense
dosageInstruction	0..*	Dosage	How the medication is to be used by the patient or administered by the caregiver
substitution	0..1	BackboneElement	Whether a substitution was performed on the dispense
wasSubstitutedRequired	1..1	boolean	Whether a substitution was or was not performed on the dispense
type	0..1	CodeableConcept	Code signifying whether a different drug was dispensed from what was prescribedBinding (example): v3-ActSubstanceAdminSubstitutionCode
reason	0..*	CodeableConcept	Why was substitution madeBinding (example): v3-SubstanceAdminSubstitutionReason
responsibleParty	0..*	Reference(Practitioner | PractitionerRole)	Who is responsible for the substitution
detectedIssue	0..*	Reference(DetectedIssue)	Clinical issue with action
eventHistory	0..*	Reference(Provenance)	A list of relevant lifecycle events

Σ in _summary results · ?! modifier element · 1.. required · inherited elements in grey

Search parameters

Query with GET [base]/MedicationDispense?[parameter]=[value]. Type decides which modifiers and prefixes apply, see search features.

Parameter	Type	Description	PG	ES
code	token	Returns dispenses of this medicine code (MedicationDispense.medication.ofType(CodeableConcept))
context	reference	Returns dispenses with a specific context (episode or episode of care) MedicationDispense.context
destination	reference	Returns dispenses that should be sent to a specific destination MedicationDispense.destination
identifier	token	Returns dispenses with this external identifier MedicationDispense.identifier
medication	reference	Returns dispenses of this medicine resource (MedicationDispense.medication.ofType(Reference))
patient	reference	The identity of a patient to list dispenses for MedicationDispense.subject.where(resolve() is Patient)
performer	reference	Returns dispenses performed by a specific individual MedicationDispense.performer.actor
prescription	reference	The identity of a prescription to list dispenses from MedicationDispense.authorizingPrescription
receiver	reference	The identity of a receiver to list dispenses for MedicationDispense.receiver
responsibleparty	reference	Returns dispenses with the specified responsible party MedicationDispense.substitution.responsibleParty
status	token	Returns dispenses with a specified dispense status MedicationDispense.status
subject	reference	The identity of a patient for whom to list dispenses MedicationDispense.subject
type	token	Returns dispenses of a specific type MedicationDispense.type
whenhandedover	date	Returns dispenses handed over on this date MedicationDispense.whenHandedOver
whenprepared	date	Returns dispenses prepared on this date MedicationDispense.whenPrepared

PG: PostgreSQL, ES: Elasticsearch. passes its TestScript checks, fails, not tested yet.

Common parameters on every resource (8)

_haste-health-author	reference	The author of the resource
_id	token	Logical id of this artifact
_lastUpdated	date	When the resource version last changed
_profile	uri	Profiles this resource claims to conform to
_security	token	Security Labels applied to this resource
_source	uri	Identifies where the resource comes from
_tag	token	Tags applied to this resource
_type	token	Derived from the R4B Definition