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.r5.core
derivation: specialization
name: MedicationDispense
type: MedicationDispense
elements:
  category:
    short: Type of medication dispense
    type: CodeableConcept
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-admin-location'}
    index: 5
  whenHandedOver: {type: dateTime, short: When product was given out, index: 19}
  whenPrepared: {short: When product was packaged and reviewed, type: dateTime, isSummary: true, index: 18}
  eventHistory:
    short: A list of relevant lifecycle events
    refers: ['http://hl7.org/fhir/StructureDefinition/Provenance']
    type: Reference
    array: true
    index: 31
  substitution:
    type: BackboneElement
    short: Whether a substitution was performed on the dispense
    index: 25
    elements:
      wasSubstituted: {type: boolean, short: Whether a substitution was or was not performed on the dispense, index: 26}
      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: 27
      reason:
        short: Why was substitution made
        type: CodeableConcept
        array: true
        binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason'}
        index: 28
      responsibleParty:
        short: Who is responsible for the substitution
        refers: ['http://hl7.org/fhir/StructureDefinition/Organization', 'http://hl7.org/fhir/StructureDefinition/Practitioner', 'http://hl7.org/fhir/StructureDefinition/PractitionerRole']
        type: Reference
        index: 29
    required: [wasSubstituted]
  detectedIssue:
    short: Clinical issue with action
    refers: ['http://hl7.org/fhir/StructureDefinition/DetectedIssue']
    type: Reference
    array: true
    index: 30
  encounter:
    short: Encounter associated with event
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    index: 8
  type:
    short: Trial fill, partial fill, emergency fill, etc.
    type: CodeableConcept
    binding: {strength: example, valueSet: 'http://terminology.hl7.org/ValueSet/v3-ActPharmacySupplyType'}
    index: 15
  statusReason:
    short: Why a dispense was not performed
    type: CodeableReference
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-status-reason'}
    index: 4
  note: {type: Annotation, short: Information about the dispense, array: true, index: 22}
  supportingInformation:
    short: Information that supports the dispensing of the medication
    refers: ['http://hl7.org/fhir/StructureDefinition/Resource']
    type: Reference
    array: true
    index: 9
  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.4.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
    index: 3
  dosageInstruction: {short: How the medication is to be used by the patient or administered by the caregiver, type: Dosage, array: true, index: 24}
  daysSupply: {type: Quantity, short: Amount of medication expressed as a timing amount, index: 17}
  identifier: {short: External identifier, type: Identifier, array: true, index: 0}
  renderedDosageInstruction: {short: Full representation of the dosage instructions, type: string, index: 23}
  basedOn:
    short: Plan that is fulfilled by this dispense
    refers: ['http://hl7.org/fhir/StructureDefinition/CarePlan']
    type: Reference
    array: true
    index: 1
  quantity: {type: Quantity, short: Amount dispensed, index: 16}
  partOf:
    short: Event that dispense is part of
    refers: ['http://hl7.org/fhir/StructureDefinition/Procedure']
    type: Reference
    array: true
    index: 2
  location:
    short: Where the dispense occurred
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    index: 13
  authorizingPrescription:
    short: Medication order that authorizes the dispense
    refers: ['http://hl7.org/fhir/StructureDefinition/MedicationRequest']
    type: Reference
    array: true
    index: 14
  receiver:
    short: Who collected the medication or where the medication was delivered
    refers: ['http://hl7.org/fhir/StructureDefinition/Location', '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
    array: true
    index: 21
  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: 7
  destination:
    short: Where the medication was sent
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    index: 20
  performer:
    type: BackboneElement
    short: Who performed event
    array: true
    index: 10
    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: 11
      actor:
        short: Individual who was performing
        refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', '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: 12
    required: [actor]
  medication:
    short: What medication was supplied
    type: CodeableReference
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medication-codes'}
    isSummary: true
    index: 6
package_version: 4.4.0
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/MedicationDispense
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 4.4.0
required: [status, medication]