Medication Prescription and Dispense (MPD)
1.0.0-preview - ci-build

Medication Prescription and Dispense (MPD), published by Integrating the Healthcare Enterprise (IHE). This guide is not an authorized publication; it is the continuous build for version 1.0.0-preview built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/pharm-mpd/tree/92/merge and changes regularly. See the Directory of published versions

## Logical Model: IHEMedicationDispenseModel - Detailed Descriptions

Active as of 2025-05-01

Definitions for the IHEMedicationDispenseModel logical model.

- Key Elements Table
- Differential Elements Table
- Snapshot Elements Table

Guidance on how to interpret the contents of this table can be found here

0. IHEMedicationDispenseModel
Definition | Logical model for medication dispense report (based on request or independently) Base definition for all types defined in FHIR type system.
Short | Medication dispense (model)Base for all types and resources
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. IHEMedicationDispenseModel.identifier
Definition | Identifier for the dispense
Short | Identifier for the dispense
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
4. IHEMedicationDispenseModel.patient
Definition | The person for whom the medication is prescribed/ordered
Short | The person for whom the medication is prescribed/ordered
Control | 1..1
Type | Reference(Patient (model))
6. IHEMedicationDispenseModel.receiver
Definition | Identification of the person who received the dispensed medication, especially when it was not the patient
Short | Identification of the person who received the dispensed medication, especially when it was not the patient
Control | 0..1
Type | Reference(Patient (model), Practitioner (model), RelatedPerson, PractitionerRole)
8. IHEMedicationDispenseModel.dispenser
Definition | The person who dispensed the product, and takes the responsibility of the dispensation
Short | The person who dispensed the product, and takes the responsibility of the dispensation
Control | 1..1
Type | Reference(Practitioner (model), Organization, Device)
10. IHEMedicationDispenseModel.relatedRequest
Definition | Prescription/request/order the dispense is related to
Short | Prescription/request/order the dispense is related to
Control | 0..*
Type | Reference(Medication order (model))
12. IHEMedicationDispenseModel.medication
Definition | Exact dispensed product
Short | Exact dispensed product
Control | 1..1
Type | Reference(Medicinal product (model))
14. IHEMedicationDispenseModel.dispensedQuantity
Definition | Number of dispensed packages if the pack size is known, or number of smaller items/units
Short | Number of dispensed packages if the pack size is known, or number of smaller items/units
Control | 1..1
Type | Quantity
16. IHEMedicationDispenseModel.timeOfDispensation
Definition | Date and time of dispensation
Short | Date and time of dispensation
Control | 1..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. IHEMedicationDispenseModel.substitution
Definition | Substitution was made
Short | Substitution was made
Control | 0..1
Type | BackboneElement
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
20. IHEMedicationDispenseModel.substitution.id
Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short | Unique id for inter-element referencing
Control | 0..1 This element is affected by the following invariants: ele-1
Type | id string
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
22. IHEMedicationDispenseModel.substitution.extension
Definition | May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short | Additional content defined by implementations
Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Alternate Names | extensions, user content
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
Slicing | This element introduces a set of slices on `IHEMedicationDispenseModel.substitution.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
24. IHEMedicationDispenseModel.substitution.modifierExtension
Definition | May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Short | Extensions that cannot be ignored even if unrecognized
Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control | 0..*
Type | Extension
Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
Summary | true
Requirements | Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.
Alternate Names | extensions, user content, modifiers
Invariants | ele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count())) ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
26. IHEMedicationDispenseModel.substitution.substitutionOccurred
Definition | Indicates whether substitution was made by the dispenser
Short | Indicates whether substitution was made by the dispenser
Control | 1..1
Type | boolean
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
28. IHEMedicationDispenseModel.substitution.type
Definition | Indicates the type of substitution made by the dispenser
Short | Indicates the type of substitution made by the dispenser
Control | 0..1
Type | CodeableConcept
30. IHEMedicationDispenseModel.substitution.reason
Definition | The reason for the substitution by the dispenser or why a required substitution was not made
Short | The reason for the substitution by the dispenser or why a required substitution was not made
Control | 0..1
Type | CodeableConcept
32. IHEMedicationDispenseModel.status
Definition | Status of the dispensation
Short | Status of the dispensation
Control | 1..1
Type | CodeableConcept
34. IHEMedicationDispenseModel.statusReason
Definition | Reason for the current status of dispensation, for example the reason why the dispensation was made invalid
Short | Reason for the current status of dispensation, for example the reason why the dispensation was made invalid
Control | 0..*
Type | CodeableConcept
36. IHEMedicationDispenseModel.statusReasonText
Definition | Textual reason for the current status of dispensation
Short | Textual reason for the current status of dispensation
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
38. IHEMedicationDispenseModel.usageInstructions
Definition | Dosaging and administration instructions
Short | Dosaging and administration instructions
Control | 0..*
Type | Reference(Dosaging (model))
40. IHEMedicationDispenseModel.comment
Definition | Additional information or comments
Short | Additional information or comments
Control | 0..*
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension

Guidance on how to interpret the contents of this table can be found here

0. IHEMedicationDispenseModel
Definition | Logical model for medication dispense report (based on request or independently)
Short | Medication dispense (model)
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. IHEMedicationDispenseModel.identifier
Definition | Identifier for the dispense
Short | Identifier for the dispense
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
4. IHEMedicationDispenseModel.patient
Definition | The person for whom the medication is prescribed/ordered
Short | The person for whom the medication is prescribed/ordered
Control | 1..1
Type | Reference(Patient (model))
6. IHEMedicationDispenseModel.receiver
Definition | Identification of the person who received the dispensed medication, especially when it was not the patient
Short | Identification of the person who received the dispensed medication, especially when it was not the patient
Control | 0..1
Type | Reference(Patient (model), Practitioner (model), RelatedPerson, PractitionerRole)
8. IHEMedicationDispenseModel.dispenser
Definition | The person who dispensed the product, and takes the responsibility of the dispensation
Short | The person who dispensed the product, and takes the responsibility of the dispensation
Control | 1..1
Type | Reference(Practitioner (model), Organization, Device)
10. IHEMedicationDispenseModel.relatedRequest
Definition | Prescription/request/order the dispense is related to
Short | Prescription/request/order the dispense is related to
Control | 0..*
Type | Reference(Medication order (model))
12. IHEMedicationDispenseModel.medication
Definition | Exact dispensed product
Short | Exact dispensed product
Control | 1..1
Type | Reference(Medicinal product (model))
14. IHEMedicationDispenseModel.dispensedQuantity
Definition | Number of dispensed packages if the pack size is known, or number of smaller items/units
Short | Number of dispensed packages if the pack size is known, or number of smaller items/units
Control | 1..1
Type | Quantity
16. IHEMedicationDispenseModel.timeOfDispensation
Definition | Date and time of dispensation
Short | Date and time of dispensation
Control | 1..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. IHEMedicationDispenseModel.substitution
Definition | Substitution was made
Short | Substitution was made
Control | 0..1
Type | BackboneElement
20. IHEMedicationDispenseModel.substitution.substitutionOccurred
Definition | Indicates whether substitution was made by the dispenser
Short | Indicates whether substitution was made by the dispenser
Control | 1..1
Type | boolean
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
22. IHEMedicationDispenseModel.substitution.type
Definition | Indicates the type of substitution made by the dispenser
Short | Indicates the type of substitution made by the dispenser
Control | 0..1
Type | CodeableConcept
24. IHEMedicationDispenseModel.substitution.reason
Definition | The reason for the substitution by the dispenser or why a required substitution was not made
Short | The reason for the substitution by the dispenser or why a required substitution was not made
Control | 0..1
Type | CodeableConcept
26. IHEMedicationDispenseModel.status
Definition | Status of the dispensation
Short | Status of the dispensation
Control | 1..1
Type | CodeableConcept
28. IHEMedicationDispenseModel.statusReason
Definition | Reason for the current status of dispensation, for example the reason why the dispensation was made invalid
Short | Reason for the current status of dispensation, for example the reason why the dispensation was made invalid
Control | 0..*
Type | CodeableConcept
30. IHEMedicationDispenseModel.statusReasonText
Definition | Textual reason for the current status of dispensation
Short | Textual reason for the current status of dispensation
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
32. IHEMedicationDispenseModel.usageInstructions
Definition | Dosaging and administration instructions
Short | Dosaging and administration instructions
Control | 0..*
Type | Reference(Dosaging (model))
34. IHEMedicationDispenseModel.comment
Definition | Additional information or comments
Short | Additional information or comments
Control | 0..*
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension

Guidance on how to interpret the contents of this table can be found here

0. IHEMedicationDispenseModel
Definition | Logical model for medication dispense report (based on request or independently)
Short | Medication dispense (model)
Control | 0..*
Is Modifier | false
Logical Model | Instances of this logical model are not marked to be the target of a Reference
2. IHEMedicationDispenseModel.identifier
Definition | Identifier for the dispense
Short | Identifier for the dispense
Note | This is a business identifier, not a resource identifier (see discussion)
Control | 0..*
Type | Identifier
4. IHEMedicationDispenseModel.patient
Definition | The person for whom the medication is prescribed/ordered
Short | The person for whom the medication is prescribed/ordered
Control | 1..1
Type | Reference(Patient (model))
6. IHEMedicationDispenseModel.receiver
Definition | Identification of the person who received the dispensed medication, especially when it was not the patient
Short | Identification of the person who received the dispensed medication, especially when it was not the patient
Control | 0..1
Type | Reference(Patient (model), Practitioner (model), RelatedPerson, PractitionerRole)
8. IHEMedicationDispenseModel.dispenser
Definition | The person who dispensed the product, and takes the responsibility of the dispensation
Short | The person who dispensed the product, and takes the responsibility of the dispensation
Control | 1..1
Type | Reference(Practitioner (model), Organization, Device)
10. IHEMedicationDispenseModel.relatedRequest
Definition | Prescription/request/order the dispense is related to
Short | Prescription/request/order the dispense is related to
Control | 0..*
Type | Reference(Medication order (model))
12. IHEMedicationDispenseModel.medication
Definition | Exact dispensed product
Short | Exact dispensed product
Control | 1..1
Type | Reference(Medicinal product (model))
14. IHEMedicationDispenseModel.dispensedQuantity
Definition | Number of dispensed packages if the pack size is known, or number of smaller items/units
Short | Number of dispensed packages if the pack size is known, or number of smaller items/units
Control | 1..1
Type | Quantity
16. IHEMedicationDispenseModel.timeOfDispensation
Definition | Date and time of dispensation
Short | Date and time of dispensation
Control | 1..1
Type | dateTime
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
18. IHEMedicationDispenseModel.substitution
Definition | Substitution was made
Short | Substitution was made
Control | 0..1
Type | BackboneElement
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`)
20. IHEMedicationDispenseModel.substitution.id
Definition | Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Short | Unique id for inter-element referencing
Control | 0..1 This element is affected by the following invariants: ele-1
Type | id
Is Modifier | false
XML Format | In the XML format, this property is represented as an attribute.
Summary | false
22. IHEMedicationDispenseModel.substitution.extension
Definition | May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
Short | Additional content defined by implementations
Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control | 0..*
Type | Extension
Is Modifier | false
Summary | false
Alternate Names | extensions, user content
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
Slicing | This element introduces a set of slices on `IHEMedicationDispenseModel.substitution.extension`. The slices areUnordered and Open, and can be differentiated using the following discriminators: value @ url
24. IHEMedicationDispenseModel.substitution.modifierExtension
Definition | May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and managable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Short | Extensions that cannot be ignored even if unrecognized
Comments | There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Control | 0..*
Type | Extension
Is Modifier | true because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
Summary | true
Requirements | Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.
Alternate Names | extensions, user content, modifiers
Invariants | ele-1: All FHIR elements must have a @value or children (`hasValue() or (children().count() > id.count())`) ext-1: Must have either extensions or value[x], not both (`extension.exists() != value.exists()`)
26. IHEMedicationDispenseModel.substitution.substitutionOccurred
Definition | Indicates whether substitution was made by the dispenser
Short | Indicates whether substitution was made by the dispenser
Control | 1..1
Type | boolean
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
28. IHEMedicationDispenseModel.substitution.type
Definition | Indicates the type of substitution made by the dispenser
Short | Indicates the type of substitution made by the dispenser
Control | 0..1
Type | CodeableConcept
30. IHEMedicationDispenseModel.substitution.reason
Definition | The reason for the substitution by the dispenser or why a required substitution was not made
Short | The reason for the substitution by the dispenser or why a required substitution was not made
Control | 0..1
Type | CodeableConcept
32. IHEMedicationDispenseModel.status
Definition | Status of the dispensation
Short | Status of the dispensation
Control | 1..1
Type | CodeableConcept
34. IHEMedicationDispenseModel.statusReason
Definition | Reason for the current status of dispensation, for example the reason why the dispensation was made invalid
Short | Reason for the current status of dispensation, for example the reason why the dispensation was made invalid
Control | 0..*
Type | CodeableConcept
36. IHEMedicationDispenseModel.statusReasonText
Definition | Textual reason for the current status of dispensation
Short | Textual reason for the current status of dispensation
Control | 0..1
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension
38. IHEMedicationDispenseModel.usageInstructions
Definition | Dosaging and administration instructions
Short | Dosaging and administration instructions
Control | 0..*
Type | Reference(Dosaging (model))
40. IHEMedicationDispenseModel.comment
Definition | Additional information or comments
Short | Additional information or comments
Control | 0..*
Type | string
Primitive Value | This primitive element may be present, or absent, or replaced by an extension