Connectathon 11 Snapshot

This page is part of the FHIR Specification (v1.2.0: STU 3 Draft). 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

4.23 Resource MedicationDispense - Content

Pharmacy Work GroupMaturity Level: 1Compartments: Patient, Practitioner

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.

4.23.1 Scope and Usage

This resource covers the supply of medications to a patient. Examples include dispensing and pick-up from an out-patient or community pharmacy, dispensing patient-specific medications from in-patient pharmacy to ward, as well as issuing a single dose from ward stock to a patient for consumption. The medication dispense is the result of a pharmacy system responding to a medication order.

4.23.2 Boundaries and Relationships

The Medication domain includes a number of related resources

MedicationOrder An order for both supply of the medication and the instructions for administration of the medicine to a patient.
MedicationDispense Provision of a supply of a medication with the intention that it is subsequently consumed by a patient (usually in response to a prescription).
MedicationAdministration When a patient actually consumes a medicine, or it is otherwise administered to them
MedicationStatement This is a record of a medication being taken by a patient or that a medication has been given to a patient, where the record is the result of a report from the patient or another clinician. A medication statement is not a part of the prescribe->dispense->administer sequence, but is a report that such a sequence (or at least a part of it) did take place, resulting in a belief that the patient has received a particular medication.

This resource does not deal with the supply or transfer of non-medication related items to a patient.

4.23.3 Background and Context

The supply and the associated administration instructions may not exactly follow the original order (prescription), either because some details were left for completion at this point in the process or because the dispenser exercised their clinical judgment to make some appropriate modification.

4.23.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationDispense Σ IDomainResourceDispensing a medication to a named patient
whenHandedOver cannot be before whenPrepared
... identifier Σ0..1IdentifierExternal identifier
... status ?! Σ0..1codein-progress | on-hold | completed | entered-in-error | stopped
MedicationDispenseStatus (Required)
... patient Σ0..1Reference(Patient)Who the dispense is for
... dispenser Σ0..1Reference(Practitioner)Practitioner responsible for dispensing medication
... authorizingPrescription Σ0..*Reference(MedicationOrder)Medication order that authorizes the dispense
... type Σ0..1CodeableConceptTrial fill, partial fill, emergency fill, etc.
ActPharmacySupplyType (Example)
... quantity Σ0..1SimpleQuantityAmount dispensed
... daysSupply Σ0..1SimpleQuantityDays Supply
... medication[x] Σ1..1What medication was supplied
.... medicationCodeableConceptCodeableConcept
.... medicationReferenceReference(Medication)
... whenPrepared Σ0..1dateTimeDispense processing time
... whenHandedOver Σ0..1dateTimeWhen product was given out
... destination Σ0..1Reference(Location)Where the medication was sent
... receiver Σ0..*Reference(Patient | Practitioner)Who collected the medication
... note Σ0..1stringInformation about the dispense
... dosageInstruction Σ0..*BackboneElementMedicine administration instructions to the patient/caregiver
.... text Σ0..1stringDosage Instructions
.... additionalInstructions Σ0..1CodeableConceptE.g. "Take with food"
.... timing Σ0..1TimingWhen medication should be administered
.... asNeeded[x] Σ0..1Take "as needed" f(or x)
..... asNeededBooleanboolean
..... asNeededCodeableConceptCodeableConcept
.... site[x] Σ0..1Body site to administer to
SNOMED CT Anatomical Structure for Administration Site Codes (Example)
..... siteCodeableConceptCodeableConcept
..... siteReferenceReference(BodySite)
.... route Σ0..1CodeableConceptHow drug should enter body
SNOMED CT Route Codes (Example)
.... method Σ0..1CodeableConceptTechnique for administering medication
.... dose[x] Σ0..1Amount of medication per dose
..... doseRangeRange
..... doseQuantitySimpleQuantity
.... rate[x] Σ0..1Amount of medication per unit of time
..... rateRatioRatio
..... rateRangeRange
.... maxDosePerPeriod Σ0..1RatioUpper limit on medication per unit of time
... substitution Σ0..1BackboneElementDeals with substitution of one medicine for another
.... type Σ1..1CodeableConceptType of substitution
ActSubstanceAdminSubstitutionCode (Example)
.... reason Σ0..*CodeableConceptWhy was substitution made
SubstanceAdminSubstitutionReason (Example)
.... responsibleParty Σ0..*Reference(Practitioner)Who is responsible for the substitution

doco Documentation for this format

UML Diagram

MedicationDispense (DomainResource)Identifier assigned by the dispensing facility - this is an identifier assigned outside FHIRidentifier : Identifier [0..1]A code specifying the state of the set of dispense events (this element modifies the meaning of other elements)status : code [0..1] « A code specifying the state of the dispense event. (Strength=Required)MedicationDispenseStatus! »A link to a resource representing the person to whom the medication will be givenpatient : Reference [0..1] « Patient »The individual responsible for dispensing the medicationdispenser : Reference [0..1] « Practitioner »Indicates the medication order that is being dispensed againstauthorizingPrescription : Reference [0..*] « MedicationOrder »Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etctype : CodeableConcept [0..1] « Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. (Strength=Example)ActPharmacySupplyType?? »The amount of medication that has been dispensed. Includes unit of measurequantity : Quantity(SimpleQuantity) [0..1]The amount of medication expressed as a timing amountdaysSupply : Quantity(SimpleQuantity) [0..1]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 medicationsmedication[x] : Type [1..1] « CodeableConcept|Reference(Medication) »The time when the dispensed product was packaged and reviewedwhenPrepared : dateTime [0..1]The time the dispensed product was provided to the patient or their representativewhenHandedOver : dateTime [0..1]Identification of the facility/location where the medication was shipped to, as part of the dispense eventdestination : Reference [0..1] « Location »Identifies the person who picked up the medication. This will usually be a patient or their caregiver, but some cases exist where it can be a healthcare professionalreceiver : Reference [0..*] « Patient|Practitioner »Extra information about the dispense that could not be conveyed in the other attributesnote : string [0..1]DosageInstructionFree 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 the medicationtext : string [0..1]Additional instructions such as "Swallow with plenty of water" which may or may not be codedadditionalInstructions : CodeableConcept [0..1]The timing schedule for giving the medication to 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 and 1 Nov 2013"timing : Timing [0..1]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 following logic applies: If set to True, this indicates that the medication is only taken when needed, within the specified scheduleasNeeded[x] : Type [0..1] « boolean|CodeableConcept »A coded specification of the anatomic site where the medication first enters the bodysite[x] : Type [0..1] « CodeableConcept|Reference(BodySite); A coded concept describing the site location the medicine enters into or onto the body (Strength=Example)SNOMED CT Anatomical Structur...?? »A code specifying the route or physiological path of administration of a therapeutic agent into or onto a subjectroute : CodeableConcept [0..1] « A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject (Strength=Example)SNOMED CT Route ?? »A coded value indicating the method by which the medication is intended to be or was introduced into or on the bodymethod : CodeableConcept [0..1]The amount of therapeutic or other substance given at one administration eventdose[x] : Type [0..1] « Range|Quantity(SimpleQuantity) »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 default of '1' in the denominator, but this is being discussed. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hoursrate[x] : Type [0..1] « Ratio|Range »The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time, e.g. 1000mg in 24 hoursmaxDosePerPeriod : Ratio [0..1]SubstitutionA code signifying whether a different drug was dispensed from what was prescribedtype : CodeableConcept [1..1] « A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription (Strength=Example)ActSubstanceAdminSubstitution...?? »Indicates the reason for the substitution of (or lack of substitution) from what was prescribedreason : CodeableConcept [0..*] « A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed (Strength=Example)SubstanceAdminSubstitutionRea...?? »The person or organization that has primary responsibility for the substitutionresponsibleParty : Reference [0..*] « Practitioner »Indicates how the medication is to be used by the patientdosageInstruction[0..*]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 cases substitution is not expected but does happen. This block explains what substitution did or did not happen and whysubstitution[0..1]

XML Template

<MedicationDispense xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..1 Identifier External identifier --></identifier>
 <status value="[code]"/><!-- 0..1 in-progress | on-hold | completed | entered-in-error | stopped -->
 <patient><!-- 0..1 Reference(Patient) Who the dispense is for --></patient>
 <dispenser><!-- 0..1 Reference(Practitioner) Practitioner responsible for dispensing medication --></dispenser>
 <authorizingPrescription><!-- 0..* Reference(MedicationOrder) Medication order that authorizes the dispense --></authorizingPrescription>
 <type><!-- 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc. --></type>
 <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount dispensed --></quantity>
 <daysSupply><!-- 0..1 Quantity(SimpleQuantity) Days Supply --></daysSupply>
 <medication[x]><!-- 1..1 CodeableConcept|Reference(Medication) What medication was supplied --></medication[x]>
 <whenPrepared value="[dateTime]"/><!-- 0..1 Dispense processing time -->
 <whenHandedOver value="[dateTime]"/><!-- 0..1 When product was given out -->
 <destination><!-- 0..1 Reference(Location) Where the medication was sent --></destination>
 <receiver><!-- 0..* Reference(Patient|Practitioner) Who collected the medication --></receiver>
 <note value="[string]"/><!-- 0..1 Information about the dispense -->
 <dosageInstruction>  <!-- 0..* Medicine administration instructions to the patient/caregiver -->
  <text value="[string]"/><!-- 0..1 Dosage Instructions -->
  <additionalInstructions><!-- 0..1 CodeableConcept E.g. "Take with food" --></additionalInstructions>
  <timing><!-- 0..1 Timing When medication should be administered --></timing>
  <asNeeded[x]><!-- 0..1 boolean|CodeableConcept Take "as needed" f(or x) --></asNeeded[x]>
  <site[x]><!-- 0..1 CodeableConcept|Reference(BodySite) Body site to administer to --></site[x]>
  <route><!-- 0..1 CodeableConcept How drug should enter body --></route>
  <method><!-- 0..1 CodeableConcept Technique for administering medication --></method>
  <dose[x]><!-- 0..1 Range|Quantity(SimpleQuantity) Amount of medication per dose --></dose[x]>
  <rate[x]><!-- 0..1 Ratio|Range Amount of medication per unit of time --></rate[x]>
  <maxDosePerPeriod><!-- 0..1 Ratio Upper limit on medication per unit of time --></maxDosePerPeriod>
 </dosageInstruction>
 <substitution>  <!-- 0..1 Deals with substitution of one medicine for another -->
  <type><!-- 1..1 CodeableConcept Type of substitution --></type>
  <reason><!-- 0..* CodeableConcept Why was substitution made --></reason>
  <responsibleParty><!-- 0..* Reference(Practitioner) Who is responsible for the substitution --></responsibleParty>
 </substitution>
</MedicationDispense>

JSON Template

{doco
  "resourceType" : "MedicationDispense",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // External identifier
  "status" : "<code>", // in-progress | on-hold | completed | entered-in-error | stopped
  "patient" : { Reference(Patient) }, // Who the dispense is for
  "dispenser" : { Reference(Practitioner) }, // Practitioner responsible for dispensing medication
  "authorizingPrescription" : [{ Reference(MedicationOrder) }], // Medication order that authorizes the dispense
  "type" : { CodeableConcept }, // Trial fill, partial fill, emergency fill, etc.
  "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed
  "daysSupply" : { Quantity(SimpleQuantity) }, // Days Supply
  // medication[x]: What medication was supplied. One of these 2:
  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "whenPrepared" : "<dateTime>", // Dispense processing time
  "whenHandedOver" : "<dateTime>", // When product was given out
  "destination" : { Reference(Location) }, // Where the medication was sent
  "receiver" : [{ Reference(Patient|Practitioner) }], // Who collected the medication
  "note" : "<string>", // Information about the dispense
  "dosageInstruction" : [{ // Medicine administration instructions to the patient/caregiver
    "text" : "<string>", // Dosage Instructions
    "additionalInstructions" : { CodeableConcept }, // E.g. "Take with food"
    "timing" : { Timing }, // When medication should be administered
    // asNeeded[x]: Take "as needed" f(or x). One of these 2:
    "asNeededBoolean" : <boolean>,
    "asNeededCodeableConcept" : { CodeableConcept },
    // site[x]: Body site to administer to. One of these 2:
    "siteCodeableConcept" : { CodeableConcept },
    "siteReference" : { Reference(BodySite) },
    "route" : { CodeableConcept }, // How drug should enter body
    "method" : { CodeableConcept }, // Technique for administering medication
    // dose[x]: Amount of medication per dose. One of these 2:
    "doseRange" : { Range },
    "doseQuantity" : { Quantity(SimpleQuantity) },
    // rate[x]: Amount of medication per unit of time. One of these 2:
    "rateRatio" : { Ratio },
    "rateRange" : { Range },
    "maxDosePerPeriod" : { Ratio } // Upper limit on medication per unit of time
  }],
  "substitution" : { // Deals with substitution of one medicine for another
    "type" : { CodeableConcept }, // R!  Type of substitution
    "reason" : [{ CodeableConcept }], // Why was substitution made
    "responsibleParty" : [{ Reference(Practitioner) }] // Who is responsible for the substitution
  }
}

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. MedicationDispense Σ IDomainResourceDispensing a medication to a named patient
whenHandedOver cannot be before whenPrepared
... identifier Σ0..1IdentifierExternal identifier
... status ?! Σ0..1codein-progress | on-hold | completed | entered-in-error | stopped
MedicationDispenseStatus (Required)
... patient Σ0..1Reference(Patient)Who the dispense is for
... dispenser Σ0..1Reference(Practitioner)Practitioner responsible for dispensing medication
... authorizingPrescription Σ0..*Reference(MedicationOrder)Medication order that authorizes the dispense
... type Σ0..1CodeableConceptTrial fill, partial fill, emergency fill, etc.
ActPharmacySupplyType (Example)
... quantity Σ0..1SimpleQuantityAmount dispensed
... daysSupply Σ0..1SimpleQuantityDays Supply
... medication[x] Σ1..1What medication was supplied
.... medicationCodeableConceptCodeableConcept
.... medicationReferenceReference(Medication)
... whenPrepared Σ0..1dateTimeDispense processing time
... whenHandedOver Σ0..1dateTimeWhen product was given out
... destination Σ0..1Reference(Location)Where the medication was sent
... receiver Σ0..*Reference(Patient | Practitioner)Who collected the medication
... note Σ0..1stringInformation about the dispense
... dosageInstruction Σ0..*BackboneElementMedicine administration instructions to the patient/caregiver
.... text Σ0..1stringDosage Instructions
.... additionalInstructions Σ0..1CodeableConceptE.g. "Take with food"
.... timing Σ0..1TimingWhen medication should be administered
.... asNeeded[x] Σ0..1Take "as needed" f(or x)
..... asNeededBooleanboolean
..... asNeededCodeableConceptCodeableConcept
.... site[x] Σ0..1Body site to administer to
SNOMED CT Anatomical Structure for Administration Site Codes (Example)
..... siteCodeableConceptCodeableConcept
..... siteReferenceReference(BodySite)
.... route Σ0..1CodeableConceptHow drug should enter body
SNOMED CT Route Codes (Example)
.... method Σ0..1CodeableConceptTechnique for administering medication
.... dose[x] Σ0..1Amount of medication per dose
..... doseRangeRange
..... doseQuantitySimpleQuantity
.... rate[x] Σ0..1Amount of medication per unit of time
..... rateRatioRatio
..... rateRangeRange
.... maxDosePerPeriod Σ0..1RatioUpper limit on medication per unit of time
... substitution Σ0..1BackboneElementDeals with substitution of one medicine for another
.... type Σ1..1CodeableConceptType of substitution
ActSubstanceAdminSubstitutionCode (Example)
.... reason Σ0..*CodeableConceptWhy was substitution made
SubstanceAdminSubstitutionReason (Example)
.... responsibleParty Σ0..*Reference(Practitioner)Who is responsible for the substitution

doco Documentation for this format

UML Diagram

MedicationDispense (DomainResource)Identifier assigned by the dispensing facility - this is an identifier assigned outside FHIRidentifier : Identifier [0..1]A code specifying the state of the set of dispense events (this element modifies the meaning of other elements)status : code [0..1] « A code specifying the state of the dispense event. (Strength=Required)MedicationDispenseStatus! »A link to a resource representing the person to whom the medication will be givenpatient : Reference [0..1] « Patient »The individual responsible for dispensing the medicationdispenser : Reference [0..1] « Practitioner »Indicates the medication order that is being dispensed againstauthorizingPrescription : Reference [0..*] « MedicationOrder »Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etctype : CodeableConcept [0..1] « Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. (Strength=Example)ActPharmacySupplyType?? »The amount of medication that has been dispensed. Includes unit of measurequantity : Quantity(SimpleQuantity) [0..1]The amount of medication expressed as a timing amountdaysSupply : Quantity(SimpleQuantity) [0..1]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 medicationsmedication[x] : Type [1..1] « CodeableConcept|Reference(Medication) »The time when the dispensed product was packaged and reviewedwhenPrepared : dateTime [0..1]The time the dispensed product was provided to the patient or their representativewhenHandedOver : dateTime [0..1]Identification of the facility/location where the medication was shipped to, as part of the dispense eventdestination : Reference [0..1] « Location »Identifies the person who picked up the medication. This will usually be a patient or their caregiver, but some cases exist where it can be a healthcare professionalreceiver : Reference [0..*] « Patient|Practitioner »Extra information about the dispense that could not be conveyed in the other attributesnote : string [0..1]DosageInstructionFree 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 the medicationtext : string [0..1]Additional instructions such as "Swallow with plenty of water" which may or may not be codedadditionalInstructions : CodeableConcept [0..1]The timing schedule for giving the medication to 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 and 1 Nov 2013"timing : Timing [0..1]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 following logic applies: If set to True, this indicates that the medication is only taken when needed, within the specified scheduleasNeeded[x] : Type [0..1] « boolean|CodeableConcept »A coded specification of the anatomic site where the medication first enters the bodysite[x] : Type [0..1] « CodeableConcept|Reference(BodySite); A coded concept describing the site location the medicine enters into or onto the body (Strength=Example)SNOMED CT Anatomical Structur...?? »A code specifying the route or physiological path of administration of a therapeutic agent into or onto a subjectroute : CodeableConcept [0..1] « A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject (Strength=Example)SNOMED CT Route ?? »A coded value indicating the method by which the medication is intended to be or was introduced into or on the bodymethod : CodeableConcept [0..1]The amount of therapeutic or other substance given at one administration eventdose[x] : Type [0..1] « Range|Quantity(SimpleQuantity) »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 default of '1' in the denominator, but this is being discussed. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hoursrate[x] : Type [0..1] « Ratio|Range »The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time, e.g. 1000mg in 24 hoursmaxDosePerPeriod : Ratio [0..1]SubstitutionA code signifying whether a different drug was dispensed from what was prescribedtype : CodeableConcept [1..1] « A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription (Strength=Example)ActSubstanceAdminSubstitution...?? »Indicates the reason for the substitution of (or lack of substitution) from what was prescribedreason : CodeableConcept [0..*] « A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed (Strength=Example)SubstanceAdminSubstitutionRea...?? »The person or organization that has primary responsibility for the substitutionresponsibleParty : Reference [0..*] « Practitioner »Indicates how the medication is to be used by the patientdosageInstruction[0..*]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 cases substitution is not expected but does happen. This block explains what substitution did or did not happen and whysubstitution[0..1]

XML Template

<MedicationDispense xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..1 Identifier External identifier --></identifier>
 <status value="[code]"/><!-- 0..1 in-progress | on-hold | completed | entered-in-error | stopped -->
 <patient><!-- 0..1 Reference(Patient) Who the dispense is for --></patient>
 <dispenser><!-- 0..1 Reference(Practitioner) Practitioner responsible for dispensing medication --></dispenser>
 <authorizingPrescription><!-- 0..* Reference(MedicationOrder) Medication order that authorizes the dispense --></authorizingPrescription>
 <type><!-- 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc. --></type>
 <quantity><!-- 0..1 Quantity(SimpleQuantity) Amount dispensed --></quantity>
 <daysSupply><!-- 0..1 Quantity(SimpleQuantity) Days Supply --></daysSupply>
 <medication[x]><!-- 1..1 CodeableConcept|Reference(Medication) What medication was supplied --></medication[x]>
 <whenPrepared value="[dateTime]"/><!-- 0..1 Dispense processing time -->
 <whenHandedOver value="[dateTime]"/><!-- 0..1 When product was given out -->
 <destination><!-- 0..1 Reference(Location) Where the medication was sent --></destination>
 <receiver><!-- 0..* Reference(Patient|Practitioner) Who collected the medication --></receiver>
 <note value="[string]"/><!-- 0..1 Information about the dispense -->
 <dosageInstruction>  <!-- 0..* Medicine administration instructions to the patient/caregiver -->
  <text value="[string]"/><!-- 0..1 Dosage Instructions -->
  <additionalInstructions><!-- 0..1 CodeableConcept E.g. "Take with food" --></additionalInstructions>
  <timing><!-- 0..1 Timing When medication should be administered --></timing>
  <asNeeded[x]><!-- 0..1 boolean|CodeableConcept Take "as needed" f(or x) --></asNeeded[x]>
  <site[x]><!-- 0..1 CodeableConcept|Reference(BodySite) Body site to administer to --></site[x]>
  <route><!-- 0..1 CodeableConcept How drug should enter body --></route>
  <method><!-- 0..1 CodeableConcept Technique for administering medication --></method>
  <dose[x]><!-- 0..1 Range|Quantity(SimpleQuantity) Amount of medication per dose --></dose[x]>
  <rate[x]><!-- 0..1 Ratio|Range Amount of medication per unit of time --></rate[x]>
  <maxDosePerPeriod><!-- 0..1 Ratio Upper limit on medication per unit of time --></maxDosePerPeriod>
 </dosageInstruction>
 <substitution>  <!-- 0..1 Deals with substitution of one medicine for another -->
  <type><!-- 1..1 CodeableConcept Type of substitution --></type>
  <reason><!-- 0..* CodeableConcept Why was substitution made --></reason>
  <responsibleParty><!-- 0..* Reference(Practitioner) Who is responsible for the substitution --></responsibleParty>
 </substitution>
</MedicationDispense>

JSON Template

{doco
  "resourceType" : "MedicationDispense",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : { Identifier }, // External identifier
  "status" : "<code>", // in-progress | on-hold | completed | entered-in-error | stopped
  "patient" : { Reference(Patient) }, // Who the dispense is for
  "dispenser" : { Reference(Practitioner) }, // Practitioner responsible for dispensing medication
  "authorizingPrescription" : [{ Reference(MedicationOrder) }], // Medication order that authorizes the dispense
  "type" : { CodeableConcept }, // Trial fill, partial fill, emergency fill, etc.
  "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed
  "daysSupply" : { Quantity(SimpleQuantity) }, // Days Supply
  // medication[x]: What medication was supplied. One of these 2:
  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "whenPrepared" : "<dateTime>", // Dispense processing time
  "whenHandedOver" : "<dateTime>", // When product was given out
  "destination" : { Reference(Location) }, // Where the medication was sent
  "receiver" : [{ Reference(Patient|Practitioner) }], // Who collected the medication
  "note" : "<string>", // Information about the dispense
  "dosageInstruction" : [{ // Medicine administration instructions to the patient/caregiver
    "text" : "<string>", // Dosage Instructions
    "additionalInstructions" : { CodeableConcept }, // E.g. "Take with food"
    "timing" : { Timing }, // When medication should be administered
    // asNeeded[x]: Take "as needed" f(or x). One of these 2:
    "asNeededBoolean" : <boolean>,
    "asNeededCodeableConcept" : { CodeableConcept },
    // site[x]: Body site to administer to. One of these 2:
    "siteCodeableConcept" : { CodeableConcept },
    "siteReference" : { Reference(BodySite) },
    "route" : { CodeableConcept }, // How drug should enter body
    "method" : { CodeableConcept }, // Technique for administering medication
    // dose[x]: Amount of medication per dose. One of these 2:
    "doseRange" : { Range },
    "doseQuantity" : { Quantity(SimpleQuantity) },
    // rate[x]: Amount of medication per unit of time. One of these 2:
    "rateRatio" : { Ratio },
    "rateRange" : { Range },
    "maxDosePerPeriod" : { Ratio } // Upper limit on medication per unit of time
  }],
  "substitution" : { // Deals with substitution of one medicine for another
    "type" : { CodeableConcept }, // R!  Type of substitution
    "reason" : [{ CodeableConcept }], // Why was substitution made
    "responsibleParty" : [{ Reference(Practitioner) }] // Who is responsible for the substitution
  }
}

 

Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

4.23.4.1 Terminology Bindings

PathDefinitionTypeReference
MedicationDispense.status A code specifying the state of the dispense event.RequiredMedicationDispenseStatus
MedicationDispense.type Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc.ExampleActPharmacySupplyType
MedicationDispense.dosageInstruction.additionalInstructions Codes identifying additional instructions such as "take with water" or "avoid operating heavy machinery"UnknownNo details provided yet
MedicationDispense.dosageInstruction.asNeeded[x] 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.UnknownNo details provided yet
MedicationDispense.dosageInstruction.site[x] A coded concept describing the site location the medicine enters into or onto the bodyExampleSNOMED CT Anatomical Structure for Administration Site Codes
MedicationDispense.dosageInstruction.route A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subjectExampleSNOMED CT Route Codes
MedicationDispense.dosageInstruction.method A coded concept describing the technique by which the medicine is administeredUnknownNo details provided yet
MedicationDispense.substitution.type A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescriptionExampleActSubstanceAdminSubstitutionCode
MedicationDispense.substitution.reason A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribedExampleSubstanceAdminSubstitutionReason

4.23.4.2 Constraints

  • mdd-1: whenHandedOver cannot be before whenPrepared (xpath: not(exists(f:whenHandedOver/@value)) or not(exists(f:whenPrepared/@value)) or ( f:whenHandedOver/@value >= f:whenPrepared/@value))

4.23.5 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPaths
codetokenReturn dispenses of this medicine codeMedicationDispense.medicationCodeableConcept
destinationreferenceReturn dispenses that should be sent to a specific destinationMedicationDispense.destination
(Location)
dispenserreferenceReturn all dispenses performed by a specific individualMedicationDispense.dispenser
(Practitioner)
identifiertokenReturn dispenses with this external identifierMedicationDispense.identifier
medicationreferenceReturn dispenses of this medicine resourceMedicationDispense.medicationReference
(Medication)
patientreferenceThe identity of a patient to list dispenses forMedicationDispense.patient
(Patient)
prescriptionreferenceThe identity of a prescription to list dispenses fromMedicationDispense.authorizingPrescription
(MedicationOrder)
receiverreferenceWho collected the medicationMedicationDispense.receiver
(Patient, Practitioner)
responsiblepartyreferenceReturn all dispenses with the specified responsible partyMedicationDispense.substitution.responsibleParty
(Practitioner)
statustokenStatus of the dispenseMedicationDispense.status
typetokenReturn all dispenses of a specific typeMedicationDispense.type
whenhandedoverdateDate when medication handed over to patient (outpatient setting), or supplied to ward or clinic (inpatient setting)MedicationDispense.whenHandedOver
whenprepareddateDate when medication preparedMedicationDispense.whenPrepared