DSTU2 FHIR Release 3 (STU)

This page is part of the FHIR Specification (v1.0.2: DSTU (v3.0.2: STU 2). 3). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2 R3 R2

Pharmacy Work Group Maturity Level : 2   Trial Use Compartments : Patient , Practitioner

Detailed Descriptions for the elements in the MedicationDispense resource.

Summary true 0..1 MedicationDispense.authorizingPrescription Control 0..* Type Reference ( MedicationOrder ) Summary true Summary true MedicationDispense.quantity Definition The amount of medication that has been dispensed. Includes unit of measure. Control 0..1 Type SimpleQuantity Summary true MedicationDispense.daysSupply Definition The amount of medication expressed as a timing amount. Control 0..1 Type SimpleQuantity Summary true Summary CodeableConcept true [x] Note See Choice of Data Types for further information about how to use [x] Summary true true true Type
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.

Control 1..1
Summary Comments true

The WG will be updating the MedicationDispense resource to adjust each affected resource to align with the workflow pattern (see workflow.html).

Invariants Defined on this element
mdd-1 : whenHandedOver cannot be before whenPrepared (xpath: ( expression : whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared, xpath: not(exists(f:whenHandedOver/@value)) or not(exists(f:whenPrepared/@value)) or ( f:whenHandedOver/@value >= f:whenPrepared/@value))
MedicationDispense.identifier
Definition

Identifier assigned by the dispensing facility - this is an identifier assigned outside FHIR.

Note This is a business identifer, not a resource identifier (see discussion )
Control 0..1 0..*
Type Identifier
MedicationDispense.status MedicationDispense.partOf
Definition

A code specifying the state of The procedure that the set of dispense events. is done because of.

Control 0..1 Binding MedicationDispenseStatus: A code specifying the state of the dispense event. ( Required ) 0..*
Type code Is Modifier Reference true Summary ( Procedure true )
MedicationDispense.patient MedicationDispense.status
Definition

A link to a resource representing code specifying the person to whom state of the medication will be given. set of dispense events.

Control 0..1
Type Terminology Binding Reference MedicationDispenseStatus ( Patient Required )
Summary true Comments SubstanceAdministration->subject->Patient. To Do Why is patient optional? Can this be used for non-patient med tranfers? Type MedicationDispense.dispenser Definition The individual responsible for dispensing the medication. Control code
Type Is Modifier Reference ( Practitioner ) true
Summary true
Definition Comments

Indicates This element is labeled as a modifier because the medication order status contains codes that is being dispensed against. mark the resource as not currently valid.

MedicationDispense.type MedicationDispense.category
Definition

Indicates the type of dispensing event that medication dispense and where the medication is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. expected to be consumed or administered.

Control 0..1
Terminology Binding ActPharmacySupplyType: Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. MedicationDispenseCategory ( Example Preferred )
Type CodeableConcept
MedicationDispense.medication[x]
Definition

Identifies the medication being administered. This is either a link to a resource representing the details of the medication or a simple attribute carrying a code that identifies the medication from a known list of medications.

Control 1..1
Terminology Binding SNOMED CT Medication Codes ( Example )
Type CodeableConcept | Reference ( Medication )
[x] Note See Choice of Data Types for further information about how to use [x]
Summary 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 recommended. Note: do not use Medication.name to describe the dispensed medication. When the only available information is a text description of recommended.  For example if you require form or lot number, then you must reference the medication, Medication.code.text should be used. Medication resource. .

MedicationDispense.whenPrepared MedicationDispense.subject
Definition

The time when A link to a resource representing the dispensed product was packaged and reviewed. person or the group to whom the medication will be given.

Control 0..1
Type dateTime Reference ( Patient | Group )
Summary true
Comments

SubstanceAdministration->subject->Patient.

MedicationDispense.whenHandedOver MedicationDispense.context
Definition

The time the dispensed product was provided to the patient encounter or their representative. episode of care that establishes the context for this event.

Control 0..1
Type dateTime Reference Summary ( Encounter true | EpisodeOfCare )
MedicationDispense.destination MedicationDispense.supportingInformation
Definition

Identification of the facility/location where Additional information that supports the medication was shipped to, as part of the dispense event. being dispensed.

Control 0..1 0..*
Type Reference ( Location Any )
MedicationDispense.performer
Definition

Indicates who or what performed the event. It should be assumed that the performer is the dispenser of the medication.

Control true 0..*
Comments

The performer will be reviewed as part of STU4.

MedicationDispense.receiver MedicationDispense.performer.actor
Definition

Identifies the person The device, practitioner, etc. who picked up performed the medication. This will usually be a patient or their caregiver, but some cases exist where it can action. It should be a healthcare professional. assumed that the actor is the dispenser of the medication.

Control 0..* 1..1
Type Reference ( Practitioner | Organization | Patient | Practitioner Device ) Summary | RelatedPerson true )
MedicationDispense.note MedicationDispense.performer.onBehalfOf
Definition

Extra information about the dispense that could not be conveyed in The organization the other attributes. device or practitioner was acting on behalf of.

Control 0..1
Type string Reference Summary ( Organization true )
MedicationDispense.dosageInstruction MedicationDispense.authorizingPrescription
Definition

Indicates how the medication order that is to be used by the patient. being dispensed against.

Control 0..*
Summary Type true Reference ( MedicationRequest )
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 Maps to convey the different doses/rates. basedOn in Event logical model.

MedicationDispense.dosageInstruction.text MedicationDispense.type
Definition

Free text dosage instructions can be used for cases where the instructions are too complex to code. When coded instructions are present, the free text instructions may still be present for display to humans taking or administering Indicates the medication. type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc.

Control 0..1
Type Terminology Binding string ActPharmacySupplyType ( Example )
Summary Type true CodeableConcept
MedicationDispense.dosageInstruction.additionalInstructions MedicationDispense.quantity
Definition

Additional instructions such as "Swallow with plenty The amount of water" which may or may not be coded. medication that has been dispensed. Includes unit of measure.

Control 0..1
Binding Type AdditionalInstructions : Codes identifying additional instructions such as "take with water" or "avoid operating heavy machinery" SimpleQuantity
Type MedicationDispense.daysSupply
Definition

The amount of medication expressed as a timing amount.

Control 0..1
Summary Type true SimpleQuantity
MedicationDispense.dosageInstruction.timing MedicationDispense.whenPrepared
Definition

The timing schedule for giving the medication to time when the patient. The Schedule data type allows many different expressions. For example, "Every 8 hours"; "Three times a day"; "1/2 an hour before breakfast for 10 days from 23-Dec 2011:"; "15 Oct 2013, 17 Oct 2013 dispensed product was packaged and 1 Nov 2013". reviewed.

Control 0..1
Type Timing dateTime
Summary true
MedicationDispense.dosageInstruction.asNeeded[x] MedicationDispense.whenHandedOver
Definition

Indicates whether the Medication is only taken when needed within a specific dosing schedule (Boolean option), or it indicates the precondition for taking the Medication (CodeableConcept). Specifically if 'boolean' datatype is selected, then The time the following logic applies: If set dispensed product was provided to True, this indicates that the medication is only taken when needed, within the specified schedule. patient or their representative.

Control 0..1
Binding MedicationAsNeededReason : A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc. Type boolean | CodeableConcept [x] Note See Choice of Data Types for further information about how to use [x] Summary dateTime
MedicationDispense.dosageInstruction.site[x] MedicationDispense.destination
Definition

A coded specification Identification of the anatomic site facility/location where the medication first enters was shipped to, as part of the body. dispense event.

Control 0..1
Binding SNOMED CT Anatomical Structure for Administration Site Codes: A coded concept describing the site location the medicine enters into or onto the body ( Example ) Type CodeableConcept | Reference ( BodySite Location )
MedicationDispense.dosageInstruction.route MedicationDispense.receiver
Definition

A code specifying Identifies the route or physiological path of administration of person who picked up the medication. This will usually be a therapeutic agent into patient or onto their caregiver, but some cases exist where it can be a subject. healthcare professional.

Control 0..1 0..*
Binding Type SNOMED CT Route Codes: A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject Reference ( Example Patient | Practitioner )
Type MedicationDispense.note
Definition CodeableConcept

Extra information about the dispense that could not be conveyed in the other attributes.

Control 0..*
Summary Type true Annotation
MedicationDispense.dosageInstruction.method MedicationDispense.dosageInstruction
Definition

A coded value indicating the method by which Indicates how the medication is intended to be or was introduced into or on used by the body. patient.

Control 0..1 Binding MedicationAdministrationMethod : A coded concept describing the technique by which the medicine is administered 0..*
Type CodeableConcept Summary Dosage
Comments

This attribute will most often NOT be populated. It is most commonly used for injections. For example, Slow Push, Deep IV. One of the reasons this attribute is not used often, is that When the method dose or rate is often pre-coordinated with intended to change over the route and/or form entire administration period (e.g. Tapering dose prescriptions), multiple instances of administration. This means the codes used in route or form may pre-coordinate the method in the route code or dosage instructions will need to be supplied to convey the form code. different doses/rates. The implementation decision about what coding system pharmacist reviews the medication order prior to use for route or form code will determine how frequently dispense and updates the method code will be populated e.g. if route or form code pre-coordinate method code, then this attribute will not be populated often; if there is no pre-coordination then method code may be used frequently. dosageInstruction based on the actual product being dispensed.

MedicationDispense.dosageInstruction.dose[x] MedicationDispense.substitution
Definition

The amount of therapeutic Indicates whether or not substitution was made as part of the dispense. In some cases substitution will be expected but does not happen, in other substance given at one administration event. cases substitution is not expected but does happen. This block explains what substitution did or did not happen and why. If nothing is specified, substitution was not done.

Control 0..1
Type Range | SimpleQuantity MedicationDispense.substitution.wasSubstituted
[x] Note Definition See Choice of Data Types for further information about how to use [x]

True if the dispenser dispensed a different drug or product from what was prescribed.

Summary Control true 1..1
Comments Type Note that this specifies the quantity of the specified medication, not the quantity of active ingredient(s). The prescribed strength can be calculated by multiplying the doseQuantity by the strength of each active ingredient in the prescribed Medication. If the administration is not intended to be instantaneous (rate is present or timing has a duration), this can be specified to convey the total amount to be administered over the period of time as indicated by the schedule. boolean
MedicationDispense.dosageInstruction.rate[x] MedicationDispense.substitution.type
Definition

Identifies the speed with which the medication was or will be introduced into the patient. Typically the rate for an infusion e.g. 100 ml per 1 hour or 100 ml/hr. May also be expressed as a rate per unit of time e.g. 500 ml per 2 hours. Currently we do not specify A code signifying whether a default of '1' in the denominator, but this is being discussed. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hours. different drug was dispensed from what was prescribed.

Control 0..1
Type Terminology Binding Ratio ActSubstanceAdminSubstitutionCode | Range ( Example )
[x] Note See Choice of Data Types Type for further information about how to use [x] Summary CodeableConcept
MedicationDispense.dosageInstruction.maxDosePerPeriod MedicationDispense.substitution.reason
Definition

The maximum total quantity of a therapeutic substance that may be administered to a subject over Indicates the period reason for the substitution of time, e.g. 1000mg in 24 hours. (or lack of substitution) from what was prescribed.

Control 0..1 0..*
Type Terminology Binding Ratio SubstanceAdminSubstitutionReason ( Example )
Summary Type true CodeableConcept
MedicationDispense.substitution MedicationDispense.substitution.responsibleParty
Definition

Indicates whether The person or not substitution was made as part of organization that has primary responsibility for the dispense. In some cases substitution will be expected but does not happen, in other cases substitution is not expected but does happen. This block explains what substitution did or did not happen and why. substitution.

Control 0..1 0..*
Summary Type true To Do Shouldn't substitution be captured on a product by product basis? Reference ( Practitioner )
MedicationDispense.substitution.type MedicationDispense.detectedIssue
Definition

A code signifying whether Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a different drug was dispensed from what was prescribed. patient; e.g. Drug-drug interaction, duplicate therapy, dosage alert etc.

Control 1..1 0..*
Binding Type ActSubstanceAdminSubstitutionCode: A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription Reference ( Example DetectedIssue )
Alternate Names Contraindication; Drug Utilization Review (DUR); Alert
MedicationDispense.notDone
Definition CodeableConcept

True if the dispense was not performed for some reason.

Control 0..1
Summary Type true boolean
MedicationDispense.substitution.reason MedicationDispense.notDoneReason[x]
Definition

Indicates the reason for the substitution of (or lack of substitution) from what why a dispense was prescribed. not performed.

Control 0..* Binding SubstanceAdminSubstitutionReason: A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed ( Example ) 0..1
Type CodeableConcept | Reference ( DetectedIssue )
Summary [x] Note true See Choice of Data Types for further information about how to use [x]
MedicationDispense.substitution.responsibleParty MedicationDispense.eventHistory
Definition

The person or organization A summary of the events of interest that has primary responsibility for have occurred, such as when the substitution. dispense was verified.

Control 0..*
Type Reference ( Practitioner Provenance )
Summary true Comments To Do rename.

This may not include provenances for all versions of the request – only those deemed “relevant” or important. This SHALL NOT include the Provenance associated with this current version of the resource. (If that provenance is deemed to be a “relevant” change, it will need to be added as part of a later update. Until then, it can be queried directly as the Provenance that points to this version using _revinclude All Provenances should have some historical version of this Request as their subject.).