FHIR Release 3 (STU) 4

This page is part of the FHIR Specification (v3.0.2: (v4.0.1: R4 - Mixed Normative and STU 3). ) in it's permanent home (it will always be available at this URL). 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 R4 R3 R2

11.3 Resource MedicationDispense - Content

Pharmacy Work Group Maturity Level : 2   Trial Use Security Category : Patient Compartments : 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.

11.3.1 Scope and Usage

This resource covers the supply of medications to a patient. Examples include dispensing and pick-up from an out-patient outpatient or community pharmacy, dispensing patient-specific medications from in-patient inpatient 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.

MedicationDispense is an event resource from a FHIR workflow perspective - see Workflow Event

11.3.2 Boundaries and Relationships

The Medication domain includes a number of related resources

MedicationRequest 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 the medication 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, 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.

11.3.3 Background and Context

The supply and the associated administration instructions may might 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.

This resource is referenced by ChargeItem , MedicationStatement and MedicationStatement Observation

11.3.4 Resource Content

Structure

0..1 Organization organization was acting for notDone 0..1 boolean Whether the dispense was or was not performed notDoneReason[x] 0..1 Why a dispense was not performed notDoneReasonCodeableConcept CodeableConcept notDoneReasonReference Reference ( DetectedIssue )
Name Flags Card. Type Description & Constraints doco
. . MedicationDispense I TU DomainResource Dispensing a medication to a named patient
+ Rule: whenHandedOver cannot be before whenPrepared
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier 0..* Identifier External identifier
. . . partOf 0..* Reference ( Procedure ) Event that dispense is part of
. . . status ?! Σ 1..1 code preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
MedicationDispenseStatus Medication dispense status codes ( Required )
. . category . statusReason[x] 0..1 Why a dispense was not performed
Medication dispense status reason codes ( Example )
.... statusReasonCodeableConcept CodeableConcept
. . . . statusReasonReference Reference ( DetectedIssue )
... category 0..1 CodeableConcept Type of medication dispense
MedicationDispenseCategory Medication dispense category codes ( Preferred )
. . . medication[x] Σ 1..1 What medication was supplied
SNOMED CT Medication Codes ( Example )
. . . . medicationCodeableConcept CodeableConcept
. . . . medicationReference Reference ( Medication )
. . . subject Σ 0..1 Reference ( Patient | Group ) Who the dispense is for
. . . context 0..1 Reference ( Encounter | EpisodeOfCare ) Encounter / Episode associated with event
. . . supportingInformation 0..* Reference ( Any ) Information that supports the dispensing of the medication
. . . performer 0..* BackboneElement Who performed event
. . . . function 0..1 CodeableConcept Who performed the dispense and what they did
Medication dispense performer function codes ( Example )
... . actor 1..1 Reference ( Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson ) Individual who was performing
. . onBehalfOf . location 0..1 Reference ( Organization Location ) Where the dispense occurred
. . . authorizingPrescription 0..* Reference ( MedicationRequest ) Medication order that authorizes the dispense
. . . type 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc.
ActPharmacySupplyType V3 Value SetActPharmacySupplyType ( Example )
. . . quantity 0..1 SimpleQuantity Amount dispensed
. . . daysSupply 0..1 SimpleQuantity Amount of medication expressed as a timing amount
. . . whenPrepared Σ 0..1 dateTime When product was packaged and reviewed
. . . whenHandedOver 0..1 dateTime When product was given out
. . . destination 0..1 Reference ( Location ) Where the medication was sent
. . . receiver 0..* Reference ( Patient | Practitioner ) Who collected the medication
. . . note 0..* Annotation Information about the dispense
. . . dosageInstruction 0..* Dosage How the medication is to be used by the patient or administered by the caregiver
. . . substitution 0..1 BackboneElement Whether a substitution was performed on the dispense
. . . . wasSubstituted 1..1 boolean Whether a substitution was or was not performed on the dispense
. . . . type 0..1 CodeableConcept Code signifying whether a different drug was dispensed from what was prescribed
ActSubstanceAdminSubstitutionCode V3 Value SetActSubstanceAdminSubstitutionCode ( Example )
. . . . reason 0..* CodeableConcept Why was substitution made
SubstanceAdminSubstitutionReason V3 Value SetSubstanceAdminSubstitutionReason ( Example )
. . . . responsibleParty 0..* Reference ( Practitioner | PractitionerRole ) Who is responsible for the substitution
. . . detectedIssue 0..* Reference ( DetectedIssue ) Clinical issue with action
. . . eventHistory 0..* Reference ( Provenance ) A list of releveant relevant lifecycle events

doco Documentation for this format

UML Diagram ( Legend )

MedicationDispense ( DomainResource ) Identifier assigned Identifiers associated with this Medication Dispense that are defined by business processes and/or used to refer to it when a direct URL reference to the dispensing facility - this resource itself is an identifier not appropriate. They are business identifiers assigned outside FHIR to this resource by the performer or other systems and remain constant as the resource is updated and propagates from server to server identifier : Identifier [0..*] The procedure that trigger the dispense is done because of partOf : Reference [0..*] « Procedure » A code specifying the state of the set of dispense events (this element modifies the meaning of other elements) status : code [0..1] [1..1] « A coded concept specifying the state of the dispense event. (Strength=Required) MedicationDispenseStatus MedicationDispense Status ! » Indicates the reason why a dispense was not performed statusReason[x] : Type [0..1] « CodeableConcept | Reference ( DetectedIssue ); A code describing why a dispense was not performed. (Strength=Example) MedicationDispense Status Rea... ?? » Indicates the type of medication dispense and (for example, where the medication is expected to be consumed or administered (i.e. inpatient or outpatient)) category : CodeableConcept [0..1] « A code describing where the dispensed medication is expected to be consumed or administered administered. (Strength=Preferred) MedicationDispenseCategory MedicationDispense Category ? » 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 medications medication[x] : Type [1..1] « CodeableConcept | Reference ( Medication ); A coded concept identifying which substance or product can be dispensed dispensed. (Strength=Example) SNOMED CT Medication SNOMEDCTMedicationCodes ?? » A link to a resource representing the person or the group to whom the medication will be given subject : Reference [0..1] « Patient | Group » The encounter or episode of care that establishes the context for this event context : Reference [0..1] « Encounter | EpisodeOfCare » Additional information that supports the medication being dispensed supportingInformation : Reference [0..*] « Any » The principal physical location where the dispense was performed location : Reference [0..1] « Location » Indicates the medication order that is being dispensed against authorizingPrescription : Reference [0..*] « MedicationRequest » Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc type : 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 v3.ActPharmacySupplyType ?? » The amount of medication that has been dispensed. Includes unit of measure quantity : Quantity ( SimpleQuantity ) [0..1] The amount of medication expressed as a timing amount daysSupply : Quantity ( SimpleQuantity ) [0..1] The time when the dispensed product was packaged and reviewed whenPrepared : dateTime [0..1] The time the dispensed product was provided to the patient or their representative whenHandedOver : dateTime [0..1] Identification of the facility/location where the medication was shipped to, as part of the dispense event destination : 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 professional receiver : Reference [0..*] « Patient | Practitioner » Extra information about the dispense that could not be conveyed in the other attributes note : Annotation [0..*] Indicates how the medication is to be used by the patient dosageInstruction : Dosage [0..*] Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a patient; e.g. Drug-drug drug-drug interaction, duplicate therapy, dosage alert etc detectedIssue : Reference [0..*] DetectedIssue True if the dispense was not performed for some reason notDone : boolean [0..1] Indicates the reason why a dispense was not performed notDoneReason[x] : Type [0..1] CodeableConcept | Reference ( « DetectedIssue ) » A summary of the events of interest that have occurred, such as when the dispense was verified eventHistory : Reference [0..*] « Provenance » Performer Distinguishes the type of performer in the dispense. For example, date enterer, packager, final checker function : CodeableConcept [0..1] « A code describing the role an individual played in dispensing a medication. (Strength=Example) MedicationDispense Performer ... ?? » The device, practitioner, etc. who performed the action. It should be assumed that the actor is the dispenser of the medication actor : Reference [1..1] « Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson » The organization the device or practitioner was acting on behalf of onBehalfOf : Reference [0..1] Organization Substitution True if the dispenser dispensed a different drug or product from what was prescribed wasSubstituted : boolean [1..1] A code signifying whether a different drug was dispensed from what was prescribed type : CodeableConcept [0..1] « A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription prescription. (Strength=Example) ActSubstanceAdminSubstitution... v3.ActSubstanceAdminSubstitut... ?? » Indicates the reason for the substitution of (or lack of substitution) from what was prescribed reason : CodeableConcept [0..*] « A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed prescribed. (Strength=Example) SubstanceAdminSubstitutionRea... v3.SubstanceAdminSubstitution... ?? » The person or organization that has primary responsibility for the substitution responsibleParty : Reference [0..*] « Practitioner | PractitionerRole » Indicates who or what performed the event. It should be assumed that the performer is the dispenser of the medication event performer [0..*] Indicates whether or not substitution was made as part of the dispense. In some cases 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 why. If nothing is specified, substitution was not done substitution [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>
 <</partOf>
 <
 <</category>

 <identifier><!-- 0..* Identifier External identifier --></identifier>
 <partOf><!-- 0..* Reference(Procedure) Event that dispense is part of --></partOf>
 <status value="[code]"/><!-- 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown -->
 <statusReason[x]><!-- 0..1 CodeableConcept|Reference(DetectedIssue) Why a dispense was not performed --></statusReason[x]>
 <category><!-- 0..1 CodeableConcept Type of medication dispense --></category>

 <medication[x]><!-- 1..1 CodeableConcept|Reference(Medication) What medication was supplied --></medication[x]>
 <subject><!-- 0..1 Reference(Patient|Group) Who the dispense is for --></subject>
 <context><!-- 0..1 Reference(Encounter|EpisodeOfCare) Encounter / Episode associated with event --></context>
 <supportingInformation><!-- 0..* Reference(Any) Information that supports the dispensing of the medication --></supportingInformation>
 <
  <|
    </actor>
  <</onBehalfOf>

 <performer>  <!-- 0..* Who performed event -->
  <function><!-- 0..1 CodeableConcept Who performed the dispense and what they did --></function>
  <actor><!-- 1..1 Reference(Practitioner|PractitionerRole|Organization|Patient|
    Device|RelatedPerson) Individual who was performing --></actor>
 </performer>
 <location><!-- 0..1 Reference(Location) Where the dispense occurred --></location>

 <authorizingPrescription><!-- 0..* Reference(MedicationRequest) 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) Amount of medication expressed as a timing amount --></daysSupply>
 <
 <

 <whenPrepared value="[dateTime]"/><!-- 0..1 When product was packaged and reviewed -->
 <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><!-- 0..* Annotation Information about the dispense --></note>
 <dosageInstruction><!-- 0..* Dosage How the medication is to be used by the patient or administered by the caregiver --></dosageInstruction>
 <
  <

 <substitution>  <!-- 0..1 Whether a substitution was performed on the dispense -->
  <wasSubstituted value="[boolean]"/><!-- 1..1 Whether a substitution was or was not performed on the dispense -->

  <type><!-- 0..1 CodeableConcept Code signifying whether a different drug was dispensed from what was prescribed --></type>
  <</reason>
  <</responsibleParty>

  <reason><!-- 0..* CodeableConcept Why was substitution made --></reason>
  <responsibleParty><!-- 0..* Reference(Practitioner|PractitionerRole) Who is responsible for the substitution --></responsibleParty>

 </substitution>
 <</detectedIssue>
 <
 <</notDoneReason[x]>
 <</eventHistory>

 <detectedIssue><!-- 0..* Reference(DetectedIssue) Clinical issue with action --></detectedIssue>
 <eventHistory><!-- 0..* Reference(Provenance) A list of relevant lifecycle events --></eventHistory>

</MedicationDispense>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "MedicationDispense",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "

  "identifier" : [{ Identifier }], // External identifier
  "partOf" : [{ Reference(Procedure) }], // Event that dispense is part of
  "status" : "<code>", // R!  preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  // statusReason[x]: Why a dispense was not performed. One of these 2:

  "statusReasonCodeableConcept" : { CodeableConcept },
  "statusReasonReference" : { Reference(DetectedIssue) },
  "category" : { CodeableConcept }, // Type of medication dispense

  // medication[x]: What medication was supplied. One of these 2:
  " },
  " },
  "
  "
  "
  "
    "|
    
    "

  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "subject" : { Reference(Patient|Group) }, // Who the dispense is for
  "context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter / Episode associated with event
  "supportingInformation" : [{ Reference(Any) }], // Information that supports the dispensing of the medication
  "performer" : [{ // Who performed event
    "function" : { CodeableConcept }, // Who performed the dispense and what they did
    "actor" : { Reference(Practitioner|PractitionerRole|Organization|Patient|
    Device|RelatedPerson) } // R!  Individual who was performing
  }],
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "
    "
    "

  "location" : { Reference(Location) }, // Where the dispense occurred
  "authorizingPrescription" : [{ Reference(MedicationRequest) }], // Medication order that authorizes the dispense
  "type" : { CodeableConcept }, // Trial fill, partial fill, emergency fill, etc.
  "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed
  "daysSupply" : { Quantity(SimpleQuantity) }, // Amount of medication expressed as a timing amount
  "whenPrepared" : "<dateTime>", // When product was packaged and reviewed
  "whenHandedOver" : "<dateTime>", // When product was given out
  "destination" : { Reference(Location) }, // Where the medication was sent
  "receiver" : [{ Reference(Patient|Practitioner) }], // Who collected the medication
  "note" : [{ Annotation }], // Information about the dispense
  "dosageInstruction" : [{ Dosage }], // How the medication is to be used by the patient or administered by the caregiver
  "substitution" : { // Whether a substitution was performed on the dispense
    "wasSubstituted" : <boolean>, // R!  Whether a substitution was or was not performed on the dispense
    "type" : { CodeableConcept }, // Code signifying whether a different drug was dispensed from what was prescribed
    "reason" : [{ CodeableConcept }], // Why was substitution made
    "responsibleParty" : [{ Reference(Practitioner|PractitionerRole) }] // Who is responsible for the substitution

  },
  "
  "
  
  " },
  " },
  "

  "detectedIssue" : [{ Reference(DetectedIssue) }], // Clinical issue with action
  "eventHistory" : [{ Reference(Provenance) }] // A list of relevant lifecycle events

}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:MedicationDispense;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:MedicationDispense.identifier [ Identifier ], ... ; # 0..* External identifier
  fhir:MedicationDispense.partOf [ Reference(Procedure) ], ... ; # 0..* Event that dispense is part of
  fhir:MedicationDispense.status [ code ]; # 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  # MedicationDispense.statusReason[x] : 0..1 Why a dispense was not performed. One of these 2
    fhir:MedicationDispense.statusReasonCodeableConcept [ CodeableConcept ]
    fhir:MedicationDispense.statusReasonReference [ Reference(DetectedIssue) ]
  fhir:MedicationDispense.category [ CodeableConcept ]; # 0..1 Type of medication dispense

  # MedicationDispense.medication[x] : 1..1 What medication was supplied. One of these 2
    fhir:MedicationDispense.medicationCodeableConcept [ CodeableConcept ]
    fhir:MedicationDispense.medicationReference [ Reference(Medication) ]
  fhir:MedicationDispense.subject [ Reference(Patient|Group) ]; # 0..1 Who the dispense is for
  fhir:MedicationDispense.context [ Reference(Encounter|EpisodeOfCare) ]; # 0..1 Encounter / Episode associated with event
  fhir:MedicationDispense.supportingInformation [ Reference(Any) ], ... ; # 0..* Information that supports the dispensing of the medication
  fhir:
    fhir:
    fhir:

  fhir:MedicationDispense.performer [ # 0..* Who performed event
    fhir:MedicationDispense.performer.function [ CodeableConcept ]; # 0..1 Who performed the dispense and what they did
    fhir:MedicationDispense.performer.actor [ Reference(Practitioner|PractitionerRole|Organization|Patient|Device|RelatedPerson) ]; # 1..1 Individual who was performing

  ], ...;
  fhir:MedicationDispense.location [ Reference(Location) ]; # 0..1 Where the dispense occurred

  fhir:MedicationDispense.authorizingPrescription [ Reference(MedicationRequest) ], ... ; # 0..* Medication order that authorizes the dispense
  fhir:MedicationDispense.type [ CodeableConcept ]; # 0..1 Trial fill, partial fill, emergency fill, etc.
  fhir:MedicationDispense.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Amount dispensed
  fhir:MedicationDispense.daysSupply [ Quantity(SimpleQuantity) ]; # 0..1 Amount of medication expressed as a timing amount
  fhir:MedicationDispense.whenPrepared [ dateTime ]; # 0..1 When product was packaged and reviewed
  fhir:MedicationDispense.whenHandedOver [ dateTime ]; # 0..1 When product was given out
  fhir:MedicationDispense.destination [ Reference(Location) ]; # 0..1 Where the medication was sent
  fhir:MedicationDispense.receiver [ Reference(Patient|Practitioner) ], ... ; # 0..* Who collected the medication
  fhir:MedicationDispense.note [ Annotation ], ... ; # 0..* Information about the dispense
  fhir:MedicationDispense.dosageInstruction [ Dosage ], ... ; # 0..* How the medication is to be used by the patient or administered by the caregiver
  fhir:

  fhir:MedicationDispense.substitution [ # 0..1 Whether a substitution was performed on the dispense

    fhir:MedicationDispense.substitution.wasSubstituted [ boolean ]; # 1..1 Whether a substitution was or was not performed on the dispense
    fhir:MedicationDispense.substitution.type [ CodeableConcept ]; # 0..1 Code signifying whether a different drug was dispensed from what was prescribed
    fhir:
    fhir:

    fhir:MedicationDispense.substitution.reason [ CodeableConcept ], ... ; # 0..* Why was substitution made
    fhir:MedicationDispense.substitution.responsibleParty [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Who is responsible for the substitution

  ];
  fhir:
  fhir:
  # . One of these 2
    fhir: ]
    fhir:) ]
  fhir:

  fhir:MedicationDispense.detectedIssue [ Reference(DetectedIssue) ], ... ; # 0..* Clinical issue with action
  fhir:MedicationDispense.eventHistory [ Reference(Provenance) ], ... ; # 0..* A list of relevant lifecycle events

]

Changes since DSTU2 R3

MedicationDispense
MedicationDispense.identifier MedicationDispense.status
  • Max Min Cardinality changed from 1 0 to * MedicationDispense.partOf Added Element MedicationDispense.category Added Element 1
    • MedicationDispense.subject
  • Renamed Change value set from patient http://hl7.org/fhir/ValueSet/medication-dispense-status to subject Add Reference(Group) MedicationDispense.context Added Element MedicationDispense.supportingInformation Added Element MedicationDispense.performer Added Element http://hl7.org/fhir/ValueSet/medicationdispense-status|4.0.1
MedicationDispense.performer.actor MedicationDispense.statusReason[x]
  • Added Element
MedicationDispense.performer.onBehalfOf MedicationDispense.performer.function
  • Added Element
MedicationDispense.authorizingPrescription Type changed from Reference(MedicationOrder) to Reference(MedicationRequest) MedicationDispense.note MedicationDispense.performer.actor
  • Max Cardinality changed from 1 to * Type changed from string to Annotation MedicationDispense.dosageInstruction Reference: Added Target Type changed from BackboneElement to Dosage PractitionerRole
MedicationDispense.substitution.wasSubstituted MedicationDispense.location
  • Added Element
MedicationDispense.substitution.type Min Cardinality changed from 1 to 0 MedicationDispense.detectedIssue Added Element MedicationDispense.notDone Added Element MedicationDispense.notDoneReason[x] Added Element MedicationDispense.eventHistory MedicationDispense.substitution.responsibleParty
  • Type Reference: Added Element MedicationDispense.dispenser deleted MedicationDispense.dosageInstruction.text deleted MedicationDispense.dosageInstruction.additionalInstructions deleted MedicationDispense.dosageInstruction.timing deleted MedicationDispense.dosageInstruction.asNeeded[x] deleted MedicationDispense.dosageInstruction.site[x] deleted MedicationDispense.dosageInstruction.route deleted MedicationDispense.dosageInstruction.method deleted Target Type PractitionerRole
MedicationDispense.dosageInstruction.dose[x] MedicationDispense.performer.onBehalfOf
  • deleted
MedicationDispense.dosageInstruction.rate[x] MedicationDispense.notDone
  • deleted
MedicationDispense.dosageInstruction.maxDosePerPeriod MedicationDispense.notDoneReason[x]
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 7 31 tests that all execute ok. 7 6 fail round-trip testing and 1 31 r3 resources are invalid (2 (0 errors). ). )

Structure

0..1 Organization organization was acting for notDone 0..1 boolean Whether the dispense was or was not performed notDoneReason[x] 0..1 Why a dispense was not performed notDoneReasonCodeableConcept CodeableConcept notDoneReasonReference Reference ( DetectedIssue )
Name Flags Card. Type Description & Constraints doco
. . MedicationDispense I TU DomainResource Dispensing a medication to a named patient
+ Rule: whenHandedOver cannot be before whenPrepared
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . identifier 0..* Identifier External identifier
. . . partOf 0..* Reference ( Procedure ) Event that dispense is part of
. . . status ?! Σ 1..1 code preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
MedicationDispenseStatus Medication dispense status codes ( Required )
. . category . statusReason[x] 0..1 Why a dispense was not performed
Medication dispense status reason codes ( Example )
.... statusReasonCodeableConcept CodeableConcept
. . . . statusReasonReference Reference ( DetectedIssue )
... category 0..1 CodeableConcept Type of medication dispense
MedicationDispenseCategory Medication dispense category codes ( Preferred )
. . . medication[x] Σ 1..1 What medication was supplied
SNOMED CT Medication Codes ( Example )
. . . . medicationCodeableConcept CodeableConcept
. . . . medicationReference Reference ( Medication )
. . . subject Σ 0..1 Reference ( Patient | Group ) Who the dispense is for
. . . context 0..1 Reference ( Encounter | EpisodeOfCare ) Encounter / Episode associated with event
. . . supportingInformation 0..* Reference ( Any ) Information that supports the dispensing of the medication
. . . performer 0..* BackboneElement Who performed event
. . . . function 0..1 CodeableConcept Who performed the dispense and what they did
Medication dispense performer function codes ( Example )
... . actor 1..1 Reference ( Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson ) Individual who was performing
. . onBehalfOf . location 0..1 Reference ( Organization Location ) Where the dispense occurred
. . . authorizingPrescription 0..* Reference ( MedicationRequest ) Medication order that authorizes the dispense
. . . type 0..1 CodeableConcept Trial fill, partial fill, emergency fill, etc.
ActPharmacySupplyType V3 Value SetActPharmacySupplyType ( Example )
. . . quantity 0..1 SimpleQuantity Amount dispensed
. . . daysSupply 0..1 SimpleQuantity Amount of medication expressed as a timing amount
. . . whenPrepared Σ 0..1 dateTime When product was packaged and reviewed
. . . whenHandedOver 0..1 dateTime When product was given out
. . . destination 0..1 Reference ( Location ) Where the medication was sent
. . . receiver 0..* Reference ( Patient | Practitioner ) Who collected the medication
. . . note 0..* Annotation Information about the dispense
. . . dosageInstruction 0..* Dosage How the medication is to be used by the patient or administered by the caregiver
. . . substitution 0..1 BackboneElement Whether a substitution was performed on the dispense
. . . . wasSubstituted 1..1 boolean Whether a substitution was or was not performed on the dispense
. . . . type 0..1 CodeableConcept Code signifying whether a different drug was dispensed from what was prescribed
ActSubstanceAdminSubstitutionCode V3 Value SetActSubstanceAdminSubstitutionCode ( Example )
. . . . reason 0..* CodeableConcept Why was substitution made
SubstanceAdminSubstitutionReason V3 Value SetSubstanceAdminSubstitutionReason ( Example )
. . . . responsibleParty 0..* Reference ( Practitioner | PractitionerRole ) Who is responsible for the substitution
. . . detectedIssue 0..* Reference ( DetectedIssue ) Clinical issue with action
. . . eventHistory 0..* Reference ( Provenance ) A list of releveant relevant lifecycle events

doco Documentation for this format

UML Diagram ( Legend )

MedicationDispense ( DomainResource ) Identifier assigned Identifiers associated with this Medication Dispense that are defined by business processes and/or used to refer to it when a direct URL reference to the dispensing facility - this resource itself is an identifier not appropriate. They are business identifiers assigned outside FHIR to this resource by the performer or other systems and remain constant as the resource is updated and propagates from server to server identifier : Identifier [0..*] The procedure that trigger the dispense is done because of partOf : Reference [0..*] « Procedure » A code specifying the state of the set of dispense events (this element modifies the meaning of other elements) status : code [0..1] [1..1] « A coded concept specifying the state of the dispense event. (Strength=Required) MedicationDispenseStatus MedicationDispense Status ! » Indicates the reason why a dispense was not performed statusReason[x] : Type [0..1] « CodeableConcept | Reference ( DetectedIssue ); A code describing why a dispense was not performed. (Strength=Example) MedicationDispense Status Rea... ?? » Indicates the type of medication dispense and (for example, where the medication is expected to be consumed or administered (i.e. inpatient or outpatient)) category : CodeableConcept [0..1] « A code describing where the dispensed medication is expected to be consumed or administered administered. (Strength=Preferred) MedicationDispenseCategory MedicationDispense Category ? » 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 medications medication[x] : Type [1..1] « CodeableConcept | Reference ( Medication ); A coded concept identifying which substance or product can be dispensed dispensed. (Strength=Example) SNOMED CT Medication SNOMEDCTMedicationCodes ?? » A link to a resource representing the person or the group to whom the medication will be given subject : Reference [0..1] « Patient | Group » The encounter or episode of care that establishes the context for this event context : Reference [0..1] « Encounter | EpisodeOfCare » Additional information that supports the medication being dispensed supportingInformation : Reference [0..*] « Any » The principal physical location where the dispense was performed location : Reference [0..1] « Location » Indicates the medication order that is being dispensed against authorizingPrescription : Reference [0..*] « MedicationRequest » Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc type : 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 v3.ActPharmacySupplyType ?? » The amount of medication that has been dispensed. Includes unit of measure quantity : Quantity ( SimpleQuantity ) [0..1] The amount of medication expressed as a timing amount daysSupply : Quantity ( SimpleQuantity ) [0..1] The time when the dispensed product was packaged and reviewed whenPrepared : dateTime [0..1] The time the dispensed product was provided to the patient or their representative whenHandedOver : dateTime [0..1] Identification of the facility/location where the medication was shipped to, as part of the dispense event destination : 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 professional receiver : Reference [0..*] « Patient | Practitioner » Extra information about the dispense that could not be conveyed in the other attributes note : Annotation [0..*] Indicates how the medication is to be used by the patient dosageInstruction : Dosage [0..*] Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a patient; e.g. Drug-drug drug-drug interaction, duplicate therapy, dosage alert etc detectedIssue : Reference [0..*] DetectedIssue True if the dispense was not performed for some reason notDone : boolean [0..1] Indicates the reason why a dispense was not performed notDoneReason[x] : Type [0..1] CodeableConcept | Reference ( « DetectedIssue ) » A summary of the events of interest that have occurred, such as when the dispense was verified eventHistory : Reference [0..*] « Provenance » Performer Distinguishes the type of performer in the dispense. For example, date enterer, packager, final checker function : CodeableConcept [0..1] « A code describing the role an individual played in dispensing a medication. (Strength=Example) MedicationDispense Performer ... ?? » The device, practitioner, etc. who performed the action. It should be assumed that the actor is the dispenser of the medication actor : Reference [1..1] « Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson » The organization the device or practitioner was acting on behalf of onBehalfOf : Reference [0..1] Organization Substitution True if the dispenser dispensed a different drug or product from what was prescribed wasSubstituted : boolean [1..1] A code signifying whether a different drug was dispensed from what was prescribed type : CodeableConcept [0..1] « A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription prescription. (Strength=Example) ActSubstanceAdminSubstitution... v3.ActSubstanceAdminSubstitut... ?? » Indicates the reason for the substitution of (or lack of substitution) from what was prescribed reason : CodeableConcept [0..*] « A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed prescribed. (Strength=Example) SubstanceAdminSubstitutionRea... v3.SubstanceAdminSubstitution... ?? » The person or organization that has primary responsibility for the substitution responsibleParty : Reference [0..*] « Practitioner | PractitionerRole » Indicates who or what performed the event. It should be assumed that the performer is the dispenser of the medication event performer [0..*] Indicates whether or not substitution was made as part of the dispense. In some cases 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 why. If nothing is specified, substitution was not done substitution [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>
 <</partOf>
 <
 <</category>

 <identifier><!-- 0..* Identifier External identifier --></identifier>
 <partOf><!-- 0..* Reference(Procedure) Event that dispense is part of --></partOf>
 <status value="[code]"/><!-- 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown -->
 <statusReason[x]><!-- 0..1 CodeableConcept|Reference(DetectedIssue) Why a dispense was not performed --></statusReason[x]>
 <category><!-- 0..1 CodeableConcept Type of medication dispense --></category>

 <medication[x]><!-- 1..1 CodeableConcept|Reference(Medication) What medication was supplied --></medication[x]>
 <subject><!-- 0..1 Reference(Patient|Group) Who the dispense is for --></subject>
 <context><!-- 0..1 Reference(Encounter|EpisodeOfCare) Encounter / Episode associated with event --></context>
 <supportingInformation><!-- 0..* Reference(Any) Information that supports the dispensing of the medication --></supportingInformation>
 <
  <|
    </actor>
  <</onBehalfOf>

 <performer>  <!-- 0..* Who performed event -->
  <function><!-- 0..1 CodeableConcept Who performed the dispense and what they did --></function>
  <actor><!-- 1..1 Reference(Practitioner|PractitionerRole|Organization|Patient|
    Device|RelatedPerson) Individual who was performing --></actor>
 </performer>
 <location><!-- 0..1 Reference(Location) Where the dispense occurred --></location>

 <authorizingPrescription><!-- 0..* Reference(MedicationRequest) 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) Amount of medication expressed as a timing amount --></daysSupply>
 <
 <

 <whenPrepared value="[dateTime]"/><!-- 0..1 When product was packaged and reviewed -->
 <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><!-- 0..* Annotation Information about the dispense --></note>
 <dosageInstruction><!-- 0..* Dosage How the medication is to be used by the patient or administered by the caregiver --></dosageInstruction>
 <
  <

 <substitution>  <!-- 0..1 Whether a substitution was performed on the dispense -->
  <wasSubstituted value="[boolean]"/><!-- 1..1 Whether a substitution was or was not performed on the dispense -->

  <type><!-- 0..1 CodeableConcept Code signifying whether a different drug was dispensed from what was prescribed --></type>
  <</reason>
  <</responsibleParty>

  <reason><!-- 0..* CodeableConcept Why was substitution made --></reason>
  <responsibleParty><!-- 0..* Reference(Practitioner|PractitionerRole) Who is responsible for the substitution --></responsibleParty>

 </substitution>
 <</detectedIssue>
 <
 <</notDoneReason[x]>
 <</eventHistory>

 <detectedIssue><!-- 0..* Reference(DetectedIssue) Clinical issue with action --></detectedIssue>
 <eventHistory><!-- 0..* Reference(Provenance) A list of relevant lifecycle events --></eventHistory>

</MedicationDispense>

JSON Template 

{doco
  "resourceType" : "",

  "resourceType" : "MedicationDispense",

  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "
  "
  "
  "

  "identifier" : [{ Identifier }], // External identifier
  "partOf" : [{ Reference(Procedure) }], // Event that dispense is part of
  "status" : "<code>", // R!  preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  // statusReason[x]: Why a dispense was not performed. One of these 2:

  "statusReasonCodeableConcept" : { CodeableConcept },
  "statusReasonReference" : { Reference(DetectedIssue) },
  "category" : { CodeableConcept }, // Type of medication dispense

  // medication[x]: What medication was supplied. One of these 2:
  " },
  " },
  "
  "
  "
  "
    "|
    
    "

  "medicationCodeableConcept" : { CodeableConcept },
  "medicationReference" : { Reference(Medication) },
  "subject" : { Reference(Patient|Group) }, // Who the dispense is for
  "context" : { Reference(Encounter|EpisodeOfCare) }, // Encounter / Episode associated with event
  "supportingInformation" : [{ Reference(Any) }], // Information that supports the dispensing of the medication
  "performer" : [{ // Who performed event
    "function" : { CodeableConcept }, // Who performed the dispense and what they did
    "actor" : { Reference(Practitioner|PractitionerRole|Organization|Patient|
    Device|RelatedPerson) } // R!  Individual who was performing
  }],
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
  "
    "
    "
    "
    "

  "location" : { Reference(Location) }, // Where the dispense occurred
  "authorizingPrescription" : [{ Reference(MedicationRequest) }], // Medication order that authorizes the dispense
  "type" : { CodeableConcept }, // Trial fill, partial fill, emergency fill, etc.
  "quantity" : { Quantity(SimpleQuantity) }, // Amount dispensed
  "daysSupply" : { Quantity(SimpleQuantity) }, // Amount of medication expressed as a timing amount
  "whenPrepared" : "<dateTime>", // When product was packaged and reviewed
  "whenHandedOver" : "<dateTime>", // When product was given out
  "destination" : { Reference(Location) }, // Where the medication was sent
  "receiver" : [{ Reference(Patient|Practitioner) }], // Who collected the medication
  "note" : [{ Annotation }], // Information about the dispense
  "dosageInstruction" : [{ Dosage }], // How the medication is to be used by the patient or administered by the caregiver
  "substitution" : { // Whether a substitution was performed on the dispense
    "wasSubstituted" : <boolean>, // R!  Whether a substitution was or was not performed on the dispense
    "type" : { CodeableConcept }, // Code signifying whether a different drug was dispensed from what was prescribed
    "reason" : [{ CodeableConcept }], // Why was substitution made
    "responsibleParty" : [{ Reference(Practitioner|PractitionerRole) }] // Who is responsible for the substitution

  },
  "
  "
  
  " },
  " },
  "

  "detectedIssue" : [{ Reference(DetectedIssue) }], // Clinical issue with action
  "eventHistory" : [{ Reference(Provenance) }] // A list of relevant lifecycle events

}

Turtle Template 

@prefix fhir: <http://hl7.org/fhir/> .doco


[ a fhir:MedicationDispense;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:MedicationDispense.identifier [ Identifier ], ... ; # 0..* External identifier
  fhir:MedicationDispense.partOf [ Reference(Procedure) ], ... ; # 0..* Event that dispense is part of
  fhir:MedicationDispense.status [ code ]; # 1..1 preparation | in-progress | cancelled | on-hold | completed | entered-in-error | stopped | declined | unknown
  # MedicationDispense.statusReason[x] : 0..1 Why a dispense was not performed. One of these 2
    fhir:MedicationDispense.statusReasonCodeableConcept [ CodeableConcept ]
    fhir:MedicationDispense.statusReasonReference [ Reference(DetectedIssue) ]
  fhir:MedicationDispense.category [ CodeableConcept ]; # 0..1 Type of medication dispense

  # MedicationDispense.medication[x] : 1..1 What medication was supplied. One of these 2
    fhir:MedicationDispense.medicationCodeableConcept [ CodeableConcept ]
    fhir:MedicationDispense.medicationReference [ Reference(Medication) ]
  fhir:MedicationDispense.subject [ Reference(Patient|Group) ]; # 0..1 Who the dispense is for
  fhir:MedicationDispense.context [ Reference(Encounter|EpisodeOfCare) ]; # 0..1 Encounter / Episode associated with event
  fhir:MedicationDispense.supportingInformation [ Reference(Any) ], ... ; # 0..* Information that supports the dispensing of the medication
  fhir:
    fhir:
    fhir:

  fhir:MedicationDispense.performer [ # 0..* Who performed event
    fhir:MedicationDispense.performer.function [ CodeableConcept ]; # 0..1 Who performed the dispense and what they did
    fhir:MedicationDispense.performer.actor [ Reference(Practitioner|PractitionerRole|Organization|Patient|Device|RelatedPerson) ]; # 1..1 Individual who was performing

  ], ...;
  fhir:MedicationDispense.location [ Reference(Location) ]; # 0..1 Where the dispense occurred

  fhir:MedicationDispense.authorizingPrescription [ Reference(MedicationRequest) ], ... ; # 0..* Medication order that authorizes the dispense
  fhir:MedicationDispense.type [ CodeableConcept ]; # 0..1 Trial fill, partial fill, emergency fill, etc.
  fhir:MedicationDispense.quantity [ Quantity(SimpleQuantity) ]; # 0..1 Amount dispensed
  fhir:MedicationDispense.daysSupply [ Quantity(SimpleQuantity) ]; # 0..1 Amount of medication expressed as a timing amount
  fhir:MedicationDispense.whenPrepared [ dateTime ]; # 0..1 When product was packaged and reviewed
  fhir:MedicationDispense.whenHandedOver [ dateTime ]; # 0..1 When product was given out
  fhir:MedicationDispense.destination [ Reference(Location) ]; # 0..1 Where the medication was sent
  fhir:MedicationDispense.receiver [ Reference(Patient|Practitioner) ], ... ; # 0..* Who collected the medication
  fhir:MedicationDispense.note [ Annotation ], ... ; # 0..* Information about the dispense
  fhir:MedicationDispense.dosageInstruction [ Dosage ], ... ; # 0..* How the medication is to be used by the patient or administered by the caregiver
  fhir:

  fhir:MedicationDispense.substitution [ # 0..1 Whether a substitution was performed on the dispense

    fhir:MedicationDispense.substitution.wasSubstituted [ boolean ]; # 1..1 Whether a substitution was or was not performed on the dispense
    fhir:MedicationDispense.substitution.type [ CodeableConcept ]; # 0..1 Code signifying whether a different drug was dispensed from what was prescribed
    fhir:
    fhir:

    fhir:MedicationDispense.substitution.reason [ CodeableConcept ], ... ; # 0..* Why was substitution made
    fhir:MedicationDispense.substitution.responsibleParty [ Reference(Practitioner|PractitionerRole) ], ... ; # 0..* Who is responsible for the substitution

  ];
  fhir:
  fhir:
  # . One of these 2
    fhir: ]
    fhir:) ]
  fhir:

  fhir:MedicationDispense.detectedIssue [ Reference(DetectedIssue) ], ... ; # 0..* Clinical issue with action
  fhir:MedicationDispense.eventHistory [ Reference(Provenance) ], ... ; # 0..* A list of relevant lifecycle events

]

Changes since DSTU2 Release 3

MedicationDispense
MedicationDispense.identifier MedicationDispense.status
  • Max Min Cardinality changed from 1 0 to * MedicationDispense.partOf Added Element MedicationDispense.category Added Element 1
    • MedicationDispense.subject
  • Renamed Change value set from patient http://hl7.org/fhir/ValueSet/medication-dispense-status to subject Add Reference(Group) MedicationDispense.context Added Element MedicationDispense.supportingInformation Added Element MedicationDispense.performer Added Element http://hl7.org/fhir/ValueSet/medicationdispense-status|4.0.1
MedicationDispense.performer.actor MedicationDispense.statusReason[x]
  • Added Element
MedicationDispense.performer.onBehalfOf MedicationDispense.performer.function
  • Added Element
MedicationDispense.authorizingPrescription Type changed from Reference(MedicationOrder) to Reference(MedicationRequest) MedicationDispense.note MedicationDispense.performer.actor
  • Max Cardinality changed from 1 to * Type changed from string to Annotation MedicationDispense.dosageInstruction Reference: Added Target Type changed from BackboneElement to Dosage PractitionerRole
MedicationDispense.substitution.wasSubstituted MedicationDispense.location
  • Added Element
MedicationDispense.substitution.type Min Cardinality changed from 1 to 0 MedicationDispense.detectedIssue Added Element MedicationDispense.notDone Added Element MedicationDispense.notDoneReason[x] Added Element MedicationDispense.eventHistory MedicationDispense.substitution.responsibleParty
  • Type Reference: Added Element MedicationDispense.dispenser deleted MedicationDispense.dosageInstruction.text deleted MedicationDispense.dosageInstruction.additionalInstructions deleted MedicationDispense.dosageInstruction.timing deleted MedicationDispense.dosageInstruction.asNeeded[x] deleted MedicationDispense.dosageInstruction.site[x] deleted MedicationDispense.dosageInstruction.route deleted MedicationDispense.dosageInstruction.method deleted Target Type PractitionerRole
MedicationDispense.dosageInstruction.dose[x] MedicationDispense.performer.onBehalfOf
  • deleted
MedicationDispense.dosageInstruction.rate[x] MedicationDispense.notDone
  • deleted
MedicationDispense.dosageInstruction.maxDosePerPeriod MedicationDispense.notDoneReason[x]
  • deleted

See the Full Difference for further information

This analysis is available as XML or JSON .

See R2 <--> R3 <--> R4 Conversion Maps (status = 7 31 tests that all execute ok. 7 6 fail round-trip testing and 1 31 r3 resources are invalid (2 (0 errors). ). )

 

Alternate See the Profiles & Extensions and the alternate definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) + see the extensions & the dependency analysis

11.3.4.1 Terminology Bindings

Path Definition Type Reference
MedicationDispense.status A coded concept specifying the state of the dispense event. Required MedicationDispenseStatus MedicationDispense Status Codes
MedicationDispense.statusReason[x] A code describing why a dispense was not performed. Example MedicationDispense Status Reason Codes
MedicationDispense.category A code describing where the dispensed medication is expected to be consumed or administered administered. Preferred MedicationDispenseCategory MedicationDispense Category Codes
MedicationDispense.medication[x] A coded concept identifying which substance or product can be dispensed dispensed. Example SNOMED CT Medication SNOMEDCTMedicationCodes
MedicationDispense.performer.function A code describing the role an individual played in dispensing a medication. Example MedicationDispense Performer Function Codes
MedicationDispense.type Indicates the type of dispensing event that is performed. For example, Trial Fill, Completion of Trial, Partial Fill, Emergency Fill, Samples, etc. Example ActPharmacySupplyType v3.ActPharmacySupplyType
MedicationDispense.substitution.type A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription prescription. Example ActSubstanceAdminSubstitutionCode v3.ActSubstanceAdminSubstitutionCode
MedicationDispense.substitution.reason A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed prescribed. Example SubstanceAdminSubstitutionReason v3.SubstanceAdminSubstitutionReason

11.3.4.2 Constraints

id Level Location Description Expression
mdd-1 : Rule (base) whenHandedOver cannot be before whenPrepared ( expression : whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared )

11.3.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.

Name Type Description Expression In Common
code token Return Returns dispenses of this medicine code MedicationDispense.medication.as(CodeableConcept) (MedicationDispense.medication as CodeableConcept) 4 13 Resources
context reference Returns dispenses with a specific context (episode or episode of care) MedicationDispense.context
( EpisodeOfCare , Encounter )
destination reference Return Returns dispenses that should be sent to a specific destination MedicationDispense.destination
( Location )
identifier token Return Returns dispenses with this external identifier MedicationDispense.identifier 3 30 Resources
medication reference Return Returns dispenses of this medicine resource MedicationDispense.medication.as(Reference) (MedicationDispense.medication as Reference)
( Medication ) 		3 Resources
patient reference The identity of a patient to list dispenses for MedicationDispense.subject MedicationDispense.subject.where(resolve() is Patient)
( Patient ) 		3 33 Resources
performer reference Return Returns dispenses performed by a specific individual MedicationDispense.performer.actor
( Practitioner , Organization , Device , Patient , PractitionerRole , RelatedPerson )
prescription reference The identity of a prescription to list dispenses from MedicationDispense.authorizingPrescription
( MedicationRequest ) 		1 Resources
receiver reference The identity of a receiver to list dispenses for MedicationDispense.receiver
( Practitioner , Patient )
responsibleparty reference Return Returns dispenses with the specified responsible party MedicationDispense.substitution.responsibleParty
( Practitioner , PractitionerRole )
status token Return Returns dispenses with a specified dispense status MedicationDispense.status 3 Resources
subject reference The identity of a patient for whom to list dispenses for MedicationDispense.subject
( Group , Patient )
type token Return Returns dispenses of a specific type MedicationDispense.type
whenhandedover date Returns dispenses handed over on this date MedicationDispense.whenHandedOver
whenprepared date Returns dispenses prepared on this date MedicationDispense.whenPrepared