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