This
page
is
part
of
the
FHIR
Specification
(v3.0.2:
STU
3).
The
current
version
which
supercedes
this
version
is
5.0.0
.
For
a
full
list
Continuous
Integration
Build
of
available
versions,
see
FHIR
(will
be
incorrect/inconsistent
at
times).
See
the
Directory
of
published
versions
.
Page
versions:
R5
R4B
R4
R3
R2
Responsible
Owner:
Pharmacy
Work
Group
|
|
Security Category : Patient | Compartments : Encounter , Group , Patient , Practitioner |
Detailed Descriptions for the elements in the MedicationDispense resource.
| MedicationDispense | |||||||||
|
| MedicationDispense | ||||||||
| Definition |
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. |
||||||||
| Short Display | Dispensing a medication to a named patient | ||||||||
|
|
|
||||||||
|
|
|
||||||||
|
|
false | ||||||||
| Constraints |
|
||||||||
| MedicationDispense.identifier | |||||||||
|
|
MedicationDispense.identifier | ||||||||
| Definition |
|
||||||||
|
| External identifier | ||||||||
| Note |
This
is
a
business
|
||||||||
|
|
0..* | ||||||||
| Type | Identifier | ||||||||
| Summary | false | ||||||||
| Comments | This is a business identifier, not a resource identifier. | ||||||||
| MedicationDispense.basedOn | |||||||||
| Element Id | MedicationDispense.basedOn | ||||||||
| Definition | A plan that is fulfilled in whole or in part by this MedicationDispense. | ||||||||
| Short Display | Plan that is fulfilled by this dispense | ||||||||
| Cardinality | 0..* | ||||||||
| Type | Reference ( CarePlan ) | ||||||||
| Summary | false | ||||||||
| MedicationDispense.partOf | |||||||||
|
|
MedicationDispense.partOf | ||||||||
| Definition |
The procedure or medication administration that triggered the dispense. | ||||||||
| Short Display |
Event
that
dispense
is
|
||||||||
|
|
0..* | ||||||||
| Type | Reference ( Procedure | MedicationAdministration ) | ||||||||
| Summary | false | ||||||||
| Comments | While both a procedure and a medication administration may have triggered the dispense, but it is not expected that multiple procedures and/or multiple medication administrations would be triggers. | ||||||||
| MedicationDispense.status | |||||||||
|
| MedicationDispense.status | ||||||||
| Definition |
A code specifying the state of the set of dispense events. |
||||||||
| Short Display | preparation | in-progress | cancelled | on-hold | completed | entered-in-error | unfulfilled | declined | unknown | ||||||||
| Cardinality |
|
||||||||
| Terminology Binding |
|
||||||||
| Type | code | ||||||||
| Is Modifier | true (Reason: This element is labelled as a modifier because it is a status element that contains status entered-in-error which means that the resource should not be treated as valid) | ||||||||
| Summary | true | ||||||||
| Comments |
This element is labeled as a modifier because the status contains codes that mark the resource as not currently valid. |
||||||||
| MedicationDispense.notPerformedReason | |||||||||
| Element Id | MedicationDispense.notPerformedReason | ||||||||
| Definition | Indicates the reason why a dispense was not performed. | ||||||||
| Short Display | Why a dispense was not performed | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding | MedicationDispense Status Reason Codes ( Example ) | ||||||||
| Type | CodeableReference ( DetectedIssue ) | ||||||||
| Summary | false | ||||||||
| MedicationDispense.statusChanged | |||||||||
| Element Id | MedicationDispense.statusChanged | ||||||||
| Definition | The date (and maybe time) when the status of the dispense record changed. | ||||||||
| Short Display | When the status changed | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | dateTime | ||||||||
| Summary | false | ||||||||
| MedicationDispense.category | |||||||||
|
| MedicationDispense.category | ||||||||
| Definition |
Indicates
the
type
of
medication
dispense
|
||||||||
| Short Display | Type of medication dispense | ||||||||
|
|
|
||||||||
| Terminology Binding |
|
||||||||
| Type | CodeableConcept | ||||||||
| Summary | false | ||||||||
| Comments | The category can be used to include where the medication is expected to be consumed or other types of dispenses. Invariants can be used to bind to different value sets when profiling to bind.
The
committee
will
revisit
these
codes,
expecting
to
use
a
codesystem
from
terminology.hl7.org
| ||||||||
|
|
|||||||||
|
| MedicationDispense.medication | ||||||||
| Definition |
Identifies
the
medication
|
||||||||
| Short Display | What medication was (or was intended to be) supplied | ||||||||
|
|
1..1 | ||||||||
| Terminology Binding | SNOMED CT Medication Codes ( Example ) | ||||||||
| Type |
|
||||||||
|
|
true | ||||||||
| Comments |
If
only
a
code
is
specified,
then
it
needs
to
be
a
code
for
a
specific
product.
If
more
information
is
required,
then
the
use
of
the
medication
resource
is
|
||||||||
| MedicationDispense.subject | |||||||||
|
| MedicationDispense.subject | ||||||||
| Definition |
A link to a resource representing the person or the group to whom the medication will be given. |
||||||||
| Short Display | Who the dispense is for | ||||||||
| Cardinality |
|
||||||||
| Type | Reference ( Patient | Group ) | ||||||||
| Summary | true | ||||||||
| Comments |
SubstanceAdministration->subject->Patient. |
||||||||
|
|
|||||||||
|
| MedicationDispense.encounter | ||||||||
| Definition |
The
encounter
|
||||||||
| Short Display | Encounter associated with event | ||||||||
| Cardinality | 0..1 | ||||||||
| Type |
Reference
(
Encounter
|
||||||||
| Summary | false | ||||||||
| MedicationDispense.supportingInformation | |||||||||
|
| MedicationDispense.supportingInformation | ||||||||
| Definition |
Additional information that supports the medication being dispensed. For example, there may be requirements that a specific lab test has been completed prior to dispensing or the patient's weight at the time of dispensing is documented. |
||||||||
| Short Display | Information that supports the dispensing of the medication | ||||||||
| Cardinality | 0..* | ||||||||
| Type | Reference ( Any ) | ||||||||
| Summary | false | ||||||||
| MedicationDispense.performer | |||||||||
|
| MedicationDispense.performer | ||||||||
| Definition |
Indicates
who
or
what
performed
the
event.
|
||||||||
| Short Display | Who performed event | ||||||||
| Cardinality | 0..* | ||||||||
| Summary | false | ||||||||
| MedicationDispense.performer.function | |||||||||
| Element Id | MedicationDispense.performer.function | ||||||||
| Definition |
Distinguishes
the
|
||||||||
| Short Display | Who performed the dispense and what they did | ||||||||
| Cardinality | 0..1 | ||||||||
|
| MedicationDispense Performer Function Codes ( Example ) | ||||||||
|
| CodeableConcept | ||||||||
| Requirements |
|
||||||||
| Summary | false | ||||||||
| MedicationDispense.performer.actor | |||||||||
|
|
MedicationDispense.performer.actor | ||||||||
| Definition |
The device, practitioner, etc. who performed the action. It should be assumed that the actor is the dispenser of the medication. |
||||||||
| Short Display | Individual who was performing | ||||||||
| Cardinality | 1..1 | ||||||||
| Type | Reference ( Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam | Group ) | ||||||||
| Summary | false | ||||||||
| Comments | The different performer functions within a dispense process can vary - and some of these functions may be restricted to clinical professionals - such distinction is usually specific to a jurisdiction and context. While performer.function and performer.actor don't add restrictions on which resources can be referenced, this element is expected to be used according to the local restrictions, for example not allowing Group (e.g., household) or RelatedPerson to be the dispenser. | ||||||||
|
|
|||||||||
|
| MedicationDispense.location | ||||||||
| Definition |
The
|
||||||||
| Short Display | Where the dispense occurred | ||||||||
| Cardinality | 0..1 | ||||||||
| Type |
Reference
(
|
||||||||
| Summary | false | ||||||||
| MedicationDispense.authorizingPrescription | |||||||||
|
| MedicationDispense.authorizingPrescription | ||||||||
| Definition |
Indicates the medication order that is being dispensed against. |
||||||||
| Short Display | Medication order that authorizes the dispense | ||||||||
|
|
0..* | ||||||||
| Type | Reference ( MedicationRequest ) | ||||||||
|
|
false | ||||||||
| Comments |
Maps to basedOn in Event logical model. |
||||||||
| MedicationDispense.type | |||||||||
|
|
MedicationDispense.type | ||||||||
| Definition |
Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. |
||||||||
| Short Display | Trial fill, partial fill, emergency fill, etc | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding |
ActPharmacySupplyType
(
Example
)
|
||||||||
| Type | CodeableConcept | ||||||||
| Summary | false | ||||||||
| MedicationDispense.quantity | |||||||||
|
| MedicationDispense.quantity | ||||||||
| Definition |
The amount of medication that has been (or was intended to be) dispensed. Includes unit of measure. |
||||||||
| Short Display | Amount of medication | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | SimpleQuantity | ||||||||
| Summary | false | ||||||||
| MedicationDispense.daysSupply | |||||||||
|
| MedicationDispense.daysSupply | ||||||||
| Definition |
The amount of medication expressed as a timing amount. |
||||||||
| Short Display | Amount of medication expressed as a timing amount | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | SimpleQuantity | ||||||||
| Summary | false | ||||||||
| MedicationDispense.fillNumber | |||||||||
| Element Id | MedicationDispense.fillNumber | ||||||||
| Definition | Represents the known number of the fill over the entire lifetime of the prescription, i.e. if this is the first dispense by this pharmacy but the third fill overall, then the fillNumber will be 3. Each fill number represents one dispensation, even if that dispensation is not for the full quantity. Partial fills are not represented by decimal quantities, i.e., a partial fill of 40 tablets (full quantity is 100 tablets) adds 1 to the prior fill number, not 0.4. This means that the 'fillNumber' may sometimes be higher than the MedicationRequest.numberOfRepeatsAllowed, as the latter assumes full fills, while fillNumber does not. | ||||||||
| Short Display | A number that represents the known fill this dispense represents | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | positiveInt | ||||||||
| Summary | false | ||||||||
| Comments | This element may be inaccurate as it relies on the dispensing pharmacy to be aware of all fills that have occurred for the request. | ||||||||
| MedicationDispense.recorded | |||||||||
| Element Id | MedicationDispense.recorded | ||||||||
| Definition | The date the occurrence of the MedicationDispense was first captured in the system. | ||||||||
| Short Display | When the recording of the dispense started | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | dateTime | ||||||||
| Summary | false | ||||||||
| MedicationDispense.whenPrepared | |||||||||
|
| MedicationDispense.whenPrepared | ||||||||
| Definition |
The time when the dispensed product was packaged and reviewed. |
||||||||
| Short Display | When product was packaged and reviewed | ||||||||
|
|
0..1 | ||||||||
| Type | dateTime | ||||||||
| Summary | true | ||||||||
| Constraints |
| ||||||||
| MedicationDispense.whenHandedOver | |||||||||
|
| MedicationDispense.whenHandedOver | ||||||||
| Definition |
The time the dispensed product was provided to the patient or their representative. |
||||||||
| Short Display | When product was given out | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | dateTime | ||||||||
| Summary | false | ||||||||
| Constraints |
| ||||||||
| MedicationDispense.destination | |||||||||
|
|
MedicationDispense.destination | ||||||||
| Definition |
Identification
of
the
facility/location
where
the
medication
|
||||||||
| Short Display | Where the medication was/will be sent | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | Reference ( Location ) | ||||||||
| Summary | false | ||||||||
| MedicationDispense.receiver | |||||||||
|
|
MedicationDispense.receiver | ||||||||
| Definition |
Identifies
the
person
who
picked
up
the
|
||||||||
| Short Display | Who collected the medication or where the medication was delivered | ||||||||
|
|
0..* | ||||||||
| Type | Reference ( Patient | Practitioner | RelatedPerson | Location | PractitionerRole | Organization | Group ) | ||||||||
| Summary | false | ||||||||
| MedicationDispense.note | |||||||||
|
| MedicationDispense.note | ||||||||
| Definition |
Extra information about the dispense that could not be conveyed in the other attributes. |
||||||||
| Short Display | Information about the dispense | ||||||||
|
|
0..* | ||||||||
| Type | Annotation | ||||||||
| Summary | false | ||||||||
| MedicationDispense.renderedDosageInstruction | |||||||||
| Element Id | MedicationDispense.renderedDosageInstruction | ||||||||
| Definition | The full representation of the dose of the medication included in all dosage instructions. To be used when multiple dosage instructions are included to represent complex dosing such as increasing or tapering doses. | ||||||||
| Short Display | Full representation of the dosage instructions | ||||||||
| Cardinality | 0..1 | ||||||||
| Type | markdown | ||||||||
| Summary | false | ||||||||
| Comments | The content of the renderedDosageInstructions must not be different than the dose represented in the dosageInstruction content. | ||||||||
| MedicationDispense.dosageInstruction | |||||||||
|
| MedicationDispense.dosageInstruction | ||||||||
| Definition |
Indicates how the medication is to be used by the patient. |
||||||||
| Short Display | How the medication is to be used by the patient or administered by the caregiver | ||||||||
| Cardinality | 0..* | ||||||||
| Type | Dosage | ||||||||
| Summary | false | ||||||||
| Comments |
When the dose or rate is intended to change over the entire administration period (e.g. Tapering dose prescriptions), multiple instances of dosage instructions will need to be supplied to convey the different doses/rates. The pharmacist reviews the medication order prior to dispense and updates the dosageInstruction based on the actual product being dispensed. | ||||||||
| MedicationDispense.doseAdministrationAid | |||||||||
| Element Id | MedicationDispense.doseAdministrationAid | ||||||||
| Definition | Provides information about the type of adherence packaging supplied for the medication dispense. | ||||||||
| Short Display | Type of adherence packaging to use for the dispense | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding | Medication Dose Aids ( Example ) | ||||||||
| Type | CodeableConcept | ||||||||
| Summary | false | ||||||||
| Comments |
When the dose or rate is intended to change over the entire administration period (e.g. Tapering dose prescriptions), multiple instances of dosage instructions will need to be supplied to convey the different doses/rates. The pharmacist reviews the medication order prior to dispense and updates the dosageInstruction based on the actual product being dispensed. |
||||||||
| MedicationDispense.substitution | |||||||||
|
| MedicationDispense.substitution | ||||||||
| Definition |
Indicates
whether
or
not
substitution
was
made
as
part
of
the
dispense.
In
some
|
||||||||
| Short Display | Whether a substitution was performed on the dispense | ||||||||
| Cardinality | 0..1 | ||||||||
| Summary | false | ||||||||
| MedicationDispense.substitution.wasSubstituted | |||||||||
|
|
MedicationDispense.substitution.wasSubstituted | ||||||||
| Definition |
True if the dispenser dispensed a different drug or product from what was prescribed. |
||||||||
| Short Display | Whether a substitution was or was not performed on the dispense | ||||||||
| Cardinality | 1..1 | ||||||||
| Type | boolean | ||||||||
| Summary | false | ||||||||
| MedicationDispense.substitution.type | |||||||||
|
| MedicationDispense.substitution.type | ||||||||
| Definition |
A code signifying whether a different drug was dispensed from what was prescribed. |
||||||||
| Short Display | Code signifying whether a different drug was dispensed from what was prescribed | ||||||||
| Cardinality | 0..1 | ||||||||
| Terminology Binding |
ActSubstanceAdminSubstitutionCode
(
Example
)
|
||||||||
| Type | CodeableConcept | ||||||||
| Summary | false | ||||||||
| MedicationDispense.substitution.reason | |||||||||
|
| MedicationDispense.substitution.reason | ||||||||
| Definition |
Indicates
the
reason
for
the
substitution
|
||||||||
| Short Display | Why was substitution made | ||||||||
| Cardinality | 0..* | ||||||||
| Terminology Binding |
SubstanceAdminSubstitutionReason
(
Example
)
|
||||||||
| Type | CodeableConcept | ||||||||
|
|
|
||||||||
|
|
|||||||||
|
|
|
||||||||
|
|
The person or organization that has primary responsibility for the substitution. |
||||||||
|
|
|
||||||||
|
|
0..1 | ||||||||
| Type |
|
||||||||
|
Summary
|
|
||||||||
|
|
|||||||||
|
|
|
||||||||
| Definition |
A summary of the events of interest that have occurred, such as when the dispense was verified. |
||||||||
| Short Display | A list of relevant lifecycle events | ||||||||
| Cardinality | 0..* | ||||||||
| Type | Reference ( Provenance ) | ||||||||
|
| false | ||||||||
| Comments |
This
|
||||||||