description: 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.
package_name: hl7.fhir.r4.core
derivation: specialization
name: MedicationDispense
type: MedicationDispense
elements:
  statusReasonReference:
    short: Why a dispense was not performed
    refers: ['http://hl7.org/fhir/StructureDefinition/DetectedIssue']
    type: Reference
    choiceOf: statusReason
    index: 6
  category:
    short: Type of medication dispense
    type: CodeableConcept
    binding: {strength: preferred, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-category'}
    index: 7
  whenHandedOver: {type: dateTime, short: When product was given out, index: 24}
  whenPrepared: {short: When product was packaged and reviewed, type: dateTime, isSummary: true, index: 23}
  eventHistory:
    short: A list of relevant lifecycle events
    refers: ['http://hl7.org/fhir/StructureDefinition/Provenance']
    type: Reference
    array: true
    index: 35
  substitution:
    type: BackboneElement
    short: Whether a substitution was performed on the dispense
    index: 29
    elements:
      wasSubstituted: {type: boolean, short: Whether a substitution was or was not performed on the dispense, index: 30}
      type:
        short: Code signifying whether a different drug was dispensed from what was prescribed
        type: CodeableConcept
        binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ActSubstanceAdminSubstitutionCode'}
        index: 31
      reason:
        short: Why was substitution made
        type: CodeableConcept
        array: true
        binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason'}
        index: 32
      responsibleParty:
        short: Who is responsible for the substitution
        refers: ['http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole']
        type: Reference
        array: true
        index: 33
    required: [wasSubstituted]
  detectedIssue:
    short: Clinical issue with action
    refers: ['http://hl7.org/fhir/StructureDefinition/DetectedIssue']
    type: Reference
    array: true
    index: 34
  medicationCodeableConcept: {short: What medication was supplied, type: CodeableConcept, choiceOf: medication, isSummary: true, index: 10}
  type:
    short: Trial fill, partial fill, emergency fill, etc.
    type: CodeableConcept
    binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ActPharmacySupplyType'}
    index: 20
  statusReason:
    short: Why a dispense was not performed
    choices: [statusReasonCodeableConcept, statusReasonReference]
    index: 4
  note: {type: Annotation, short: Information about the dispense, array: true, index: 27}
  statusReasonCodeableConcept: {short: Why a dispense was not performed, type: CodeableConcept, choiceOf: statusReason, index: 5}
  supportingInformation:
    short: Information that supports the dispensing of the medication
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    index: 14
  status:
    isModifier: true
    short: preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
    type: code
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-status|4.0.1'}
    isModifierReason: 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
    isSummary: true
    index: 2
  dosageInstruction: {short: How the medication is to be used by the patient or administered by the caregiver, type: Dosage, array: true, index: 28}
  daysSupply: {type: Quantity, short: Amount of medication expressed as a timing amount, index: 22}
  identifier: {short: External identifier, type: Identifier, array: true, index: 0}
  context:
    short: Encounter / Episode associated with event
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter', 'http://hl7.org/fhir/StructureDefinition/EpisodeOfCare']
    type: Reference
    index: 13
  medicationReference:
    short: What medication was supplied
    refers: ['http://hl7.org/fhir/StructureDefinition/Medication']
    type: Reference
    choiceOf: medication
    isSummary: true
    index: 11
  quantity: {type: Quantity, short: Amount dispensed, index: 21}
  partOf:
    short: Event that dispense is part of
    refers: ['http://hl7.org/fhir/StructureDefinition/Procedure']
    type: Reference
    array: true
    index: 1
  location:
    short: Where the dispense occurred
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    index: 18
  authorizingPrescription:
    short: Medication order that authorizes the dispense
    refers: ['http://hl7.org/fhir/StructureDefinition/MedicationRequest']
    type: Reference
    array: true
    index: 19
  receiver:
    short: Who collected the medication
    refers: ['http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner']
    type: Reference
    array: true
    index: 26
  subject:
    short: Who the dispense is for
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', 'http://hl7.org/fhir/StructureDefinition/Patient']
    type: Reference
    isSummary: true
    index: 12
  destination:
    short: Where the medication was sent
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    index: 25
  performer:
    type: BackboneElement
    short: Who performed event
    array: true
    index: 15
    elements:
      function:
        short: Who performed the dispense and what they did
        type: CodeableConcept
        binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-performer-function'}
        index: 16
      actor:
        short: Individual who was performing
        refers: ['http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Patient', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole', 'http://hl7.org/fhir/StructureDefinition/RelatedPerson']
        type: Reference
        index: 17
    required: [actor]
  medication:
    short: What medication was supplied
    choices: [medicationCodeableConcept, medicationReference]
    isSummary: true
    index: 9
package_version: 4.0.1
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/MedicationDispense
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.0.1
required: [medicationCodeableConcept, status, medication, medicationReference]