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.r6.examples
derivation: specialization
name: MedicationDispense
type: MedicationDispense
elements:
  category:
    isModifier: false
    short: Type of medication dispense
    type: CodeableConcept
    mustSupport: false
    array: true
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-admin-location'}
    isSummary: false
    index: 6
  whenHandedOver: {isModifier: false, short: When product was given out, type: dateTime, mustSupport: false, isSummary: false, index: 22}
  whenPrepared: {isModifier: false, short: When product was packaged and reviewed, type: dateTime, mustSupport: false, isSummary: true, index: 21}
  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: 33
  substitution:
    isModifier: false
    short: Whether a substitution was performed on the dispense
    type: BackboneElement
    mustSupport: false
    isSummary: false
    index: 28
    elements:
      wasSubstituted: {isModifier: false, short: Whether a substitution was or was not performed on the dispense, type: boolean, mustSupport: false, isSummary: false, index: 29}
      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: 30
      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: 31
      responsibleParty:
        isModifier: false
        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
        mustSupport: false
        isSummary: false
        index: 32
    required: [wasSubstituted]
  encounter:
    isModifier: false
    short: Encounter associated with event
    refers: ['http://hl7.org/fhir/StructureDefinition/Encounter']
    type: Reference
    mustSupport: false
    isSummary: false
    index: 9
  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: 16
  recorded: {isModifier: false, short: When the recording of the dispense started, type: dateTime, mustSupport: false, isSummary: false, index: 20}
  note: {isModifier: false, short: Information about the dispense, type: Annotation, mustSupport: false, array: true, isSummary: false, index: 25}
  statusChanged: {isModifier: false, short: When the status changed, type: dateTime, mustSupport: false, 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: 10
  notPerformedReason:
    isModifier: false
    short: Why a dispense was not performed
    type: CodeableReference
    mustSupport: false
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-status-reason'}
    isSummary: false
    index: 4
  status:
    isModifier: true
    short: preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
    index: 3
    type: code
    mustSupport: false
    binding: {strength: required, valueSet: 'http://hl7.org/fhir/ValueSet/medicationdispense-status|6.0.0-ballot3'}
    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: 27}
  daysSupply: {isModifier: false, short: Amount of medication expressed as a timing amount, type: Quantity, mustSupport: false, isSummary: false, index: 18}
  identifier: {isModifier: false, short: External identifier, type: Identifier, mustSupport: false, array: true, isSummary: false, index: 0}
  renderedDosageInstruction: {isModifier: false, short: Full representation of the dosage instructions, type: markdown, mustSupport: false, isSummary: false, index: 26}
  basedOn:
    isModifier: false
    short: Plan that is fulfilled by this dispense
    refers: ['http://hl7.org/fhir/StructureDefinition/CarePlan']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 1
  fillNumber: {isModifier: false, short: A number that represents the known fill this dispense represents, type: positiveInt, mustSupport: false, isSummary: false, index: 19}
  quantity: {isModifier: false, short: Amount dispensed, type: Quantity, mustSupport: false, isSummary: false, index: 17}
  partOf:
    isModifier: false
    short: Event that dispense is part of
    refers: ['http://hl7.org/fhir/StructureDefinition/MedicationAdministration', 'http://hl7.org/fhir/StructureDefinition/Procedure']
    type: Reference
    mustSupport: false
    array: true
    isSummary: false
    index: 2
  location:
    isModifier: false
    short: Where the dispense occurred
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    mustSupport: false
    isSummary: false
    index: 14
  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: 15
  receiver:
    isModifier: false
    short: Who collected the medication or where the medication was delivered
    refers: ['http://hl7.org/fhir/StructureDefinition/Group', '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
    mustSupport: false
    array: true
    isSummary: false
    index: 24
  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: 8
  destination:
    isModifier: false
    short: Where the medication was/will be sent
    refers: ['http://hl7.org/fhir/StructureDefinition/Location']
    type: Reference
    mustSupport: false
    isSummary: false
    index: 23
  performer:
    isModifier: false
    short: Who performed event
    index: 11
    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: 12
      actor:
        isModifier: false
        short: Individual who was performing
        refers: ['http://hl7.org/fhir/StructureDefinition/CareTeam', 'http://hl7.org/fhir/StructureDefinition/Device', 'http://hl7.org/fhir/StructureDefinition/Group', '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: 13
    required: [actor]
    isSummary: false
  medication:
    isModifier: false
    short: What medication was supplied
    type: CodeableReference
    mustSupport: false
    binding: {strength: example, valueSet: 'http://hl7.org/fhir/ValueSet/medication-codes'}
    isSummary: true
    index: 7
package_version: 6.0.0-ballot3
class: resource
kind: resource
url: http://hl7.org/fhir/StructureDefinition/MedicationDispense
base: http://hl7.org/fhir/StructureDefinition/DomainResource
version: 6.0.0-ballot3
required: [status, subject, medication]