3.49.6 StructureDefinition: PrescribeIT Dispense - Detailed Descriptions
Definitions for the profile-medicationdispense Profile.
MedicationDispense | |
Definition | 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. |
Control | 0..* |
Must Support | true |
Max Length | 0 |
Invariants | Defined on this element mdd-1: whenHandedOver cannot be before whenPrepared (: whenHandedOver.empty() or whenPrepared.empty() or whenHandedOver >= whenPrepared) |
MedicationDispense.id | |
Definition | The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes. |
Control | 1..1 |
Type | id |
Must Support | true |
Comments | Usage Note: This will usually be a GUID and is assigned by the sending application. Ideally it should be consistent for all messages referencing this same set of coverage information. |
Max Length | 0 |
MedicationDispense.meta | |
Definition | The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content may not always be associated with version changes to the resource. |
Control | 0..1 |
Type | Meta |
Max Length | 0 |
MedicationDispense.implicitRules | |
Definition | A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. |
Control | 0..1 |
Type | uri |
Is Modifier | true |
Comments | Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element as much as possible. |
Max Length | 0 |
MedicationDispense.language | |
Definition | The base language in which the resource is written. |
Control | 0..1 |
Binding | A human language. The codes SHALL be taken from http://tools.ietf.org/html/bcp47 |
Type | code |
Comments | Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute). |
Max Length | 0 |
MedicationDispense.text | |
Definition | A human-readable narrative that contains a summary of the resource, and may be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety. |
Control | 0..1 This element is affected by the following invariants: dom-1 |
Type | Narrative |
Alternate Names | narrative, html, xhtml, display |
Comments | Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. |
Max Length | 0 |
MedicationDispense.contained | |
Definition | These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope. |
Control | 0..* |
Type | Resource |
Alternate Names | inline resources, anonymous resources, contained resources |
Comments | This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. |
Max Length | 0 |
MedicationDispense.extension | |
Definition | An Extension |
Control | 0..* |
Type | Extension |
Must Support | true |
Max Length | 0 |
MedicationDispense.extension ([CanonicalType[http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage]]) | |
Definition | Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the rendering of the overall resource instance) |
Control | 1..1 |
Type | Extension(Medication Rendered Dosage Instruction) (Extension Type: string) |
Must Support | true |
Comments | Conformance Rule: In the context of a dispense notification, this will be populated by the PMS and will reflect the directions as presented to the patient on the label. The rendered dosage instruction must contain all dosage instructions and must be able to stand on its own. Conformance Rule: This field is made up of structured dosage information as well as patient instructions, assembled into one field and formatted as human-readable, meaning that codes should not be used (e.g. 'days' should be used instead of 'd'). Conformance Rule: Dosage quantity, dosage unit, dosage frequency, form, strength, max quantity per period,minimal interval between dispense, route of administration and where applicable, the administration site. Note: Any additional patient instructions that are specified at the dosage line level (e.g. take with food, starting one day before dental appointment) should be included. Conformance Rule: If a PMS sends discrete data elements they must also populate this with a textual view of the SIG. E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field. |
Max Length | 0 |
MedicationDispense.extension ([CanonicalType[http://prescribeit.ca/fhir/StructureDefinition/ext-dispense-quantity-remaining]]) | |
Definition | The total authorized quantity outstanding after the fill issued as part of this dispense record |
Control | 1..1 |
Type | Extension(Medication Dispense Quantity Remaining) (Extension Type: Quantity(PrescribeIT Drug Quantity)) |
Must Support | true |
Comments | Should be specified even if 0. |
Max Length | 0 |
MedicationDispense.modifierExtension | |
Definition | May be used to represent additional information that is not part of the basic definition of the resource, and that modifies the understanding of the element that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to 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. |
Control | 0..* |
Type | Extension |
Is Modifier | true |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.identifier | |
Definition | A technical identifier - identifies some entity uniquely and unambiguously. |
Note | This is a business identifier, not a resource identifier (see discussion) |
Control | 1..1 |
Type | Identifier(Shared Health Identifier) |
Must Support | true |
Comments | This is the identifier assigned by the pharmacy to a specific dispense. The system element will generally be an OID of the form [Vendor root].[Application instance node].4 expressed as a urn (e.g. urn:oid:1.2.3.4). The value will be the pharmacy-assigned dispense identifier. |
Max Length | 0 |
MedicationDispense.status | |
Definition | A code specifying the state of the set of dispense events. |
Control | 1..1 |
Binding | A code specifying the state of the dispense event. The codes SHALL be taken from MedicationDispenseStatus |
Type | code |
Is Modifier | true |
Must Support | true |
Comments | Fixed value: completed |
Max Length | 0 |
Fixed Value | completed |
MedicationDispense.medicationCodeableConcept | |
Definition | A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text. |
Control | 1..1 |
Binding | The codes SHALL be taken from PrescriptionMedicinalProduct; other codes may be used where these codes are not suitable |
Type | CodeableConcept(Shared Health CodeableConcept Required Text with optional code) |
Must Support | true |
Comments | Conformance Rule: This element is used to represent the medication dispensed A 'code' (Canadian Clinical Drug Data Set, or DIN or NPN) must be accompanied by 'text' when dispensing. For compounds, a code is not used and the description will be sent as 'text'. A DIN or an NPN may also be used if an appropriate CCDD code is not yet available. This has an extensible binding meaning that the CCDD code system should be used but if a code is not available, vendors may also submit a code from the DIN or NPN code system. (Eventually CCDD will encompass all DINs and NPNs.)
|
Max Length | 0 |
MedicationDispense.patient | |
Definition | A link to a resource representing the person to whom the medication will be given. |
Control | 1..1 |
Type | Reference(Shared Health Patient) |
Must Support | true |
Comments | SubstanceAdministration->subject->Patient. |
Max Length | 0 |
MedicationDispense.patient.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.patient.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.patient.reference | |
Definition | A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources. |
Control | 1..1 This element is affected by the following invariants: ref-1 |
Type | string |
Must Support | true |
Comments | This must point to the patient associated with the message |
Max Length | 0 |
MedicationDispense.patient.display | |
Definition | Plain text narrative that identifies the resource in addition to the resource reference. |
Control | 0..1 |
Type | string |
Comments | This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it. |
Max Length | 0 |
MedicationDispense.dispenser | |
Definition | The individual responsible for dispensing the medication. |
Control | 1..1 |
Type | Reference(Practitioner) |
Must Support | true |
Comments | Only organization (conveyed by the extension) is needed. No need to send the actual dispensing practitioner |
Max Length | 0 |
MedicationDispense.dispenser.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dispenser.extension | |
Definition | An Extension |
Control | 0..* |
Type | Extension |
Must Support | true |
Max Length | 0 |
MedicationDispense.dispenser.extension ([CanonicalType[http://sharedhealth.exchange/fhir/StructureDefinition/ext-reference-practitioner-org]]) | |
Definition | Allows capturing the organization responsible for an action instead of or in addition to identifying the responsible practitioner |
Control | 1..1 |
Type | Extension(Reference Practitioner Organization) (Extension Type: Reference(Shared Health - eRx Service Location)) |
Must Support | true |
Comments | For Shared Health purposes, only the pharmacy is relevant, not the dispensing pharmacist or technician. In the future, this should be supported directly by the resource. |
Max Length | 0 |
MedicationDispense.dispenser.reference | |
Definition | A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources. |
Control | 0..1 This element is affected by the following invariants: ref-1 |
Type | string |
Comments | Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server. |
Max Length | 0 |
MedicationDispense.dispenser.display | |
Definition | Plain text narrative that identifies the resource in addition to the resource reference. |
Control | 0..1 |
Type | string |
Comments | This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it. |
Max Length | 0 |
MedicationDispense.authorizingPrescription | |
Definition | Indicates the medication order that is being dispensed against. |
Control | 1..1 |
Type | Reference(PrescribeIT Prescription) |
Must Support | true |
Comments | Conformance note: This must refer to the MedicationOrder being dispensed. Conformance Rule: If the MedicationOrder is included in the bundle (e.g. for a renewal request when sending the most recent dispense), use the 'reference' element and refer to the MedicationOrder.id. If the MedicationOrder is not included in the bundle (e.g. a Dispense Notification), use the extension to convey the business identifier of the prescription. |
Max Length | 0 |
MedicationDispense.authorizingPrescription.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.authorizingPrescription.extension | |
Definition | An Extension |
Control | 0..* |
Type | Extension |
Must Support | true |
Max Length | 0 |
MedicationDispense.authorizingPrescription.extension ([CanonicalType[http://sharedhealth.exchange/fhir/StructureDefinition/ext-reference-identifier]]) | |
Definition | Allows a reference to identify the target prescription, dispense or task by business identifier rather than URL |
Control | 1..1 |
Type | Extension(Referenced Requisition identifier) (Extension Type: Identifier(Shared Health Identifier)) |
Must Support | true |
Comments | Usage Note: This is used when the dispense is sent stand-alone. |
Max Length | 0 |
MedicationDispense.authorizingPrescription.extension.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.authorizingPrescription.extension.extension(extension) | |
Definition | An Extension |
Control | 0..0 |
Type | Extension |
MedicationDispense.authorizingPrescription.extension.url | |
Definition | Source of the definition for the extension code - a logical name or a URL. |
Control | 1..1 |
Type | uri |
Must Support | true |
Comments | Fixed value: http://hl7.org/fhir/StructureDefinition/extension-Reference.identifier |
Max Length | 0 |
Fixed Value | http://hl7.org/fhir/StructureDefinition/extension-Reference.identifier |
MedicationDispense.authorizingPrescription.extension.valueIdentifier | |
Definition | A technical identifier - identifies some entity uniquely and unambiguously. |
Control | 1..1 |
Type | Identifier(PrescribeIT™ Prescriber Prescription Identifier) |
Must Support | true |
Comments | When this is present, the reference is typically omitted |
Max Length | 0 |
MedicationDispense.authorizingPrescription.reference | |
Definition | A reference to a location at which the other resource is found. The reference may be a relative reference, in which case it is relative to the service base URL, or an absolute URL that resolves to the location where the resource is found. The reference may be version specific or not. If the reference is not to a FHIR RESTful server, then it should be assumed to be version specific. Internal fragment references (start with '#') refer to contained resources. |
Control | 0..1 This element is affected by the following invariants: ref-1 |
Type | string |
Comments | Using absolute URLs provides a stable scalable approach suitable for a cloud/web context, while using relative/logical references provides a flexible approach suitable for use when trading across closed eco-system boundaries. Absolute URLs do not need to point to a FHIR RESTful server, though this is the preferred approach. If the URL conforms to the structure "/[type]/[id]" then it should be assumed that the reference is to a FHIR RESTful server. |
Max Length | 0 |
MedicationDispense.authorizingPrescription.display | |
Definition | Plain text narrative that identifies the resource in addition to the resource reference. |
Control | 0..1 |
Type | string |
Comments | This is generally not the same as the Resource.text of the referenced resource. The purpose is to identify what's being referenced, not to fully describe it. |
Max Length | 0 |
MedicationDispense.type | |
Definition | A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text. |
Control | 0..1 |
Binding | The codes SHALL be taken from ActPharmacySupplyType |
Type | CodeableConcept(Shared Health CodeableConcept Code) |
Must Support | true |
Comments | Usage note: For future use |
Max Length | 0 |
MedicationDispense.quantity | |
Definition | A measured or counted amount of a medication expressed as a value and human-readable string with optional coded units expressed in a local coding system |
Control | 1..1 |
Type | Quantity(PrescribeIT Drug Quantity) |
Must Support | true |
Comments | Conformance Rule: Quantity is used throughout the messages. It may be a drug form (e.g. TAB) an administrable drug (e.g. PUFF) form or a unit of measure (e.g. mg). You must send the coding system and code. |
Max Length | 0 |
Invariants | Defined on this element qty-3: If a code for the unit is present, the system SHALL also be present (: code.empty() or system.exists()) sqty-1: The comparator is not used on a SimpleQuantity (: comparator.empty()) |
MedicationDispense.daysSupply | |
Definition | The number of days that the dispensed quantity is expected to last. Cannot be mandatory as there are some situations where 'as needed' cannot be used to determine days supply. |
Control | 1..1 |
Type | Quantity(SimpleQuantity) |
Must Support | true |
Requirements | Useful in monitoring patient compliance. May also be useful in determining and managing certain contraindications ('Fill-Too-Soon', 'Fill-Too-Late', and 'Duration of Therapy'). Because 'Days Supply' may be necessary to compute total dispensed quantity, it is made a"populated field. |
Comments | Usage Note: There are some situations where this cannot be calculated, an estimated value will be used as drug plans will require this.(e.g. warfarin 1mg with take as directed dosing instructions) |
Max Length | 0 |
MedicationDispense.daysSupply.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.daysSupply.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.daysSupply.value | |
Definition | The value of the measured amount. The value includes an implicit precision in the presentation of the value. |
Control | 1..1 |
Type | decimal |
Must Support | true |
Requirements | Precision is handled implicitly in almost all cases of measurement. |
Comments | The implicit precision in the value should always be honored. |
Max Length | 0 |
MedicationDispense.daysSupply.comparator | |
Definition | Not allowed to be used in this context |
Control | 0..0 |
Binding | How the Quantity should be understood and represented. The codes SHALL be taken from QuantityComparator |
Type | code |
Is Modifier | true |
Requirements | Need a framework for handling measures where the value is <5ug/L or >400mg/L due to the limitations of measuring methodology. |
Comments | This is labeled as "Is Modifier" because the comparator modifies the interpretation of the value significantly. If there is no comparator, then there is no modification of the value. |
Max Length | 0 |
Meaning if Missing | If there is no comparator, then there is no modification of the value |
MedicationDispense.daysSupply.unit | |
Definition | A human-readable form of the unit. |
Control | 0..1 |
Type | string |
Requirements | There are many representations for units of measure and in many contexts, particular representations are fixed and required. I.e. mcg for micrograms. |
Max Length | 0 |
MedicationDispense.daysSupply.system | |
Definition | The identification of the system that provides the coded form of the unit. |
Control | 1..1 This element is affected by the following invariants: qty-3 |
Type | uri |
Must Support | true |
Requirements | Need to know the system that defines the coded form of the unit. |
Max Length | 0 |
MedicationDispense.daysSupply.code | |
Definition | A computer processable form of the unit in some unit representation system. |
Control | 1..1 |
Type | code |
Must Support | true |
Requirements | Need a computable form of the unit that is fixed across all forms. UCUM provides this for quantities, but SNOMED CT provides many units of interest. |
Comments | Fixed value: d |
Max Length | 0 |
Fixed Value | d |
MedicationDispense.whenPrepared | |
Definition | The time when the dispensed product was packaged and reviewed. |
Control | 1..1 |
Type | dateTime |
Must Support | true |
Comments | This represents the date the medication was dispensed. |
Max Length | 0 |
MedicationDispense.whenHandedOver | |
Definition | The time the dispensed product was provided to the patient or their representative. |
Control | 0..1 |
Type | dateTime |
Max Length | 0 |
MedicationDispense.destination | |
Definition | Identification of the facility/location where the medication was shipped to, as part of the dispense event. |
Control | 0..1 |
Type | Reference(Location) |
Max Length | 0 |
MedicationDispense.receiver | |
Definition | 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. |
Control | 0..* |
Type | Reference(Patient | Practitioner) |
Max Length | 0 |
MedicationDispense.note | |
Definition | Extra information about the dispense that could not be conveyed in the other attributes. |
Control | 0..* |
Type | Annotation |
Max Length | 0 |
MedicationDispense.dosageInstruction | |
Definition | Indicates how the medication is to be used by the patient. The pharmacist reviews the medication order prior to dispense and updates the dosageInstruction based on the actual product being dispensed. |
Control | 0..* |
Type | BackboneElement |
Must Support | true |
Comments | When the dose or rate is intended to change over the entire administration period (e.g. Tapering dose prescriptions), multiple instances of dosage instructions will need to be supplied to convey the different doses/rates. Conformance Rule: If PMS is able to support the structured dosage, they may do so but this is not mandatory |
Max Length | 0 |
MedicationDispense.dosageInstruction.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dosageInstruction.extension | |
Definition | An Extension |
Control | 0..* |
Type | Extension |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.extension ([CanonicalType[http://prescribeit.ca/fhir/StructureDefinition/ext-medication-dosageinstruction-sequence]]) | |
Definition | Indicates the sequence of a particular dosage line within all dosage lines - equivalent to the repetition number of the dosage instruction element this extension is on. |
Control | 1..1 |
Type | Extension(Medication Dosage Line Sequence) (Extension Type: integer(positiveInt)) |
Must Support | true |
Comments | Conformance Rule: This must match the positional sequence of the dosageInstruction repetition. I.e. The first dosageInstruction repetition must have a 'sequence' value of 1, the second a 'sequence' value of 2, etc. |
Max Length | 0 |
MedicationDispense.dosageInstruction.extension ([CanonicalType[http://prescribeit.ca/fhir/StructureDefinition/ext-medicationorder-dosageinstruction-relationship]]) | |
Definition | Indicates how the timing of this dosage instruction relates to the preceding dosage instruction. Specifically, is it concurrent (AND) or sequential (THEN). |
Control | 0..1 |
Type | Extension(Medication Order Dosage Instruction Relationship) (Extension Type: code) |
Must Support | true |
Comments | Conformance Rule: As this will establish the relationship to the previous dosage lines (example: first and second dosage line, the second and thrid dosage line, etc.) this must be present for all dosage lines except for the FIRST dosage line. Usage Note: If THEN; is specified, there is typically a COMPLEXADMINISTRATIONPERIOD specified as well. These will be consecutive periods. Conformance Rule: ANDs and THENs should not be mixed due to ambiguity of meaning |
Max Length | 0 |
MedicationDispense.dosageInstruction.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 that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to 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. |
Control | 0..* |
Type | Extension |
Is Modifier | true |
Alternate Names | extensions, user content, modifiers |
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. |
Max Length | 0 |
MedicationDispense.dosageInstruction.text | |
Definition | A free form description of how the dispensed medication is to be administered to the patient. |
Control | 0..1 |
Type | string |
Must Support | true |
Comments | Conformance Rule: If supported by the PMS, multiple dosage lines can be expressed individually. However, they must be concatenated into the RENDEREDDOSAGEINSTRUCTION as PMS will not be forced to support the receipt of individual lines. Usage Note: This is a string that is typically composed of the route, duration, dose, frequency, per line. Examples are: Prednisone, variable dosage instruction, or concurrent instructions (1 pill morning and 1 pill before bed) or sequential dosages (1 pill for 2 days, then 2 pills). |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions | |
Definition | A free form textual description of extended instruction regarding the administration of the drug. |
Control | 0..1 |
Binding | Codes identifying additional instructions such as "take with water" or "avoid operating heavy machinery" |
Type | CodeableConcept(Shared Health CodeableConcept Text) |
Must Support | true |
Comments | Conformance Rule: When providing an additional instruction at the dosage line level (complex), this should be populated when appropriate. Usage Note: It may be necessary for the EMR to parse instructions such as QHS (take at bedtime), into two data elements DOSAGETIMINGFREQUENCY = once a day and 'at bedtime' would be placed into this field. Usage Note: 'Coding' is not available, so 'Text' is expected to be used HL7 MAPPING - ADDITIONALDOSAGEINSTRUCTION (Business Name Change). Conformance Rule: When text is present, this should contain the additional instructions. Usage Note: At this time there is no known coding system. Therefore ‘text’ will be used. Conformance Rule: Maximum character length set to ‘5000’. |
Max Length | 0 |
Invariants | Defined on this element inv-1: Must have coding or text but not both (: coding.exists() xor text.exists()) |
MedicationDispense.dosageInstruction.additionalInstructions.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding | |
Definition | A reference to a code defined by a terminology system. |
Control | 0..* |
Type | Coding |
Must Support | true |
Requirements | Allows for translations and alternate encodings within a code system. Also supports communication of the same instance to systems requiring different encodings. |
Comments | Codes may be defined very casually in enumerations, or code lists, up to very formal definitions such as SNOMED CT - see the HL7 v3 Core Principles for more information. Ordering of codings is undefined and SHALL NOT be used to infer meaning. Generally, at most only one of the coding values will be labelled as UserSelected = true. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.system | |
Definition | The identification of the code system that defines the meaning of the symbol in the code. |
Control | 1..1 |
Type | uri |
Must Support | true |
Requirements | Need to be unambiguous about the source of the definition of the symbol. |
Comments | - |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.version | |
Definition | The version of the code system which was used when choosing this code. Note that a well-maintained code system does not need the version reported, because the meaning of codes is consistent across versions. However this cannot consistently be assured. and when the meaning is not guaranteed to be consistent, the version SHOULD be exchanged. |
Note | This is a business versionId, not a resource version id (see discussion) |
Control | 0..1 |
Type | string |
Comments | Where the terminology does not clearly define what string should be used to identify code system versions, the recommendation is to use the date (expressed in FHIR date format) on which that version was officially published as the version date. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.code | |
Definition | A symbol in syntax defined by the system. The symbol may be a predefined code or an expression in a syntax defined by the coding system (e.g. post-coordination). |
Control | 1..1 |
Type | code |
Must Support | true |
Requirements | Need to refer to a particular code in the system. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.display | |
Definition | A representation of the meaning of the code in the system, following the rules of the system. |
Control | 0..1 |
Type | string |
Requirements | Need to be able to carry a human-readable meaning of the code for readers that do not know the system. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.coding.userSelected | |
Definition | Indicates that this coding was chosen by a user directly - i.e. off a pick list of available items (codes or displays). |
Control | 0..1 |
Type | boolean |
Requirements | This has been identified as a clinical safety criterium - that this exact system/code pair was chosen explicitly, rather than inferred by the system based on some rules or language processing. |
Comments | Amongst a set of alternatives, a directly chosen code is the most appropriate starting point for new translations. There is some ambiguity about what exactly 'directly chosen' implies, and trading partner agreement may be needed to clarify the use of this element and its consequences more completely. |
Max Length | 0 |
MedicationDispense.dosageInstruction.additionalInstructions.text | |
Definition | A human language representation of the concept as seen/selected/uttered by the user who entered the data and/or which represents the intended meaning of the user. |
Control | 1..1 |
Type | string |
Must Support | true |
Requirements | The codes from the terminologies do not always capture the correct meaning with all the nuances of the human using them, or sometimes there is no appropriate code at all. In these cases, the text is used to capture the full meaning of the source. |
Comments | Very often the text is the same as a displayName of one of the codings. |
Max Length | 5000 |
MedicationDispense.dosageInstruction.timing | |
Definition | A structure describing the frequency (how often the drug is to be administered), offset (elapse time between administrations) represented by one line of dosage administration instruction. Includes the overall time-period the dosage instruction applies. |
Control | 0..1 |
Type | Timing |
Must Support | true |
Comments | Conformance Rule: For EMRs that can support it, this should be specified. Must also be part of the COMPLEXDOSAGEINSTRUCTION Conformance Rule: A start date may optionally be included. Refer to the Timing data type page for guidance on its use. |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.event | |
Definition | Identifies specific times when the event occurs. |
Control | 0..* |
Type | dateTime |
Requirements | In an MAR, for instance, you need to take a general specification, and turn it into a precise specification. |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat | |
Definition | A set of rules that describe when the event should occur. |
Control | 0..1 |
Type | Element |
Must Support | true |
Requirements | Many timing schedules are determined by regular repetitions. |
Max Length | 0 |
Invariants | Defined on this element tim-1: if there's a duration, there needs to be duration units (: duration.empty() or durationUnit.exists()) tim-2: if there's a period, there needs to be period units (: period.empty() or periodUnit.exists()) tim-3: Either frequency or when can exist, not both (: ((period or frequency) and when).not()) tim-4: duration SHALL be a non-negative value (: duration.exists() implies duration >= 0) tim-6: If there's a periodMax, there must be a period (: periodMax.empty() or period.exists()) tim-7: If there's a durationMax, there must be a duration (: durationMax.empty() or duration.exists()) tim-8: If there's a countMax, there must be a count (: countMax.empty() or count.exists()) tim-9: If there's an offset, there must be a when (: offset.empty() or when.exists()) |
MedicationDispense.dosageInstruction.timing.repeat.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.boundsPeriod | |
Definition | Either a duration for the length of the timing schedule, a range of possible length, or outer bounds for start and/or end limits of the timing schedule. |
Control | 0..1 |
Type | Period |
Must Support | true |
Comments | Conformance Rule: If MULTILINEDOSAGE, this will be populated with the total duration of the ADMINISTRATIVE_PERIOD for each dosage line. Conformance Rule: When providing a structured SIG, this should be populated when appropriate. This maps to Duration Must also be part of the COMPLEXDOSAGEINSTRUCTION |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.count | |
Definition | A total count of the desired number of repetitions. |
Control | 0..1 |
Type | integer |
Must Support | true |
Requirements | Repetitions may be limited by end time or total occurrences. |
Comments | If you have both bounds and count, then this should be understood as within the bounds period, until count times happens. |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.countMax | |
Definition | A maximum value for the count of the desired repetitions (e.g. do something 6-8 times). |
Control | 0..1 |
Type | integer |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.duration | |
Definition | How long this thing happens for when it happens. |
Control | 0..1 |
Type | decimal |
Must Support | true |
Requirements | Some activities are not instantaneous and need to be maintained for a period of time. |
Comments | For some events the duration is part of the definition of the event (e.g. IV infusions, where the duration is implicit in the specified quantity and rate). For others, it's part of the timing specification (e.g. exercise). |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.durationMax | |
Definition | The upper limit of how long this thing happens for when it happens. |
Control | 0..1 |
Type | decimal |
Must Support | true |
Requirements | Some activities are not instantaneous and need to be maintained for a period of time. |
Comments | For some events the duration is part of the definition of the event (e.g. IV infusions, where the duration is implicit in the specified quantity and rate). For others, it's part of the timing specification (e.g. exercise). |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.durationUnit | |
Definition | The units of time for the duration, in UCUM units. |
Control | 0..1 |
Binding | A unit of time (units from UCUM). The codes SHALL be taken from UnitsOfTime |
Type | code |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.frequency | |
Definition | The number of times to repeat the action within the specified period / period range (i.e. both period and periodMax provided). |
Control | 0..1 |
Type | integer |
Must Support | true |
Max Length | 0 |
Default Value | 1 |
MedicationDispense.dosageInstruction.timing.repeat.frequencyMax | |
Definition | If present, indicates that the frequency is a range - so repeat between [frequency] and [frequencyMax] times within the period or period range. |
Control | 0..1 |
Type | integer |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.period | |
Definition | Indicates the duration of time over which repetitions are to occur; e.g. to express "3 times per day", 3 would be the frequency and "1 day" would be the period. |
Control | 0..1 |
Type | decimal |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.periodMax | |
Definition | If present, indicates that the period is a range from [period] to [periodMax], allowing expressing concepts such as "do this once every 3-5 days. |
Control | 0..1 |
Type | decimal |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.periodUnit | |
Definition | The units of time for the period in UCUM units. |
Control | 0..1 |
Binding | A unit of time (units from UCUM). The codes SHALL be taken from UnitsOfTime |
Type | code |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.when | |
Definition | A real world event that the occurrence of the event should be tied to. |
Control | 0..0 |
Binding | Real world event that the relating to the schedule. The codes SHALL be taken from EventTiming |
Type | code |
Requirements | Timings are frequently determined by occurrences such as waking, eating and sleep. |
Comments | Use "additionalInstructions" instead |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.repeat.offset | |
Definition | The number of minutes from the event. If the event code does not indicate whether the minutes is before or after the event, then the offset is assumed to be after the event. |
Control | 0..0 |
Type | unsignedInt |
Comments | Use "additionalInstructions" instead |
Max Length | 0 |
MedicationDispense.dosageInstruction.timing.code | |
Definition | A code for the timing pattern. Some codes such as BID are ubiquitous, but many institutions define their own additional codes. If a code is provided, the code is understood to be a complete statement of whatever is specified in the structured timing data, and either the code or the data may be used to interpret the Timing. |
Control | 0..1 |
Binding | Code for a known / defined timing pattern. The codes SHOULD be taken from TimingAbbreviation |
Type | CodeableConcept |
Comments | BID etc are defined as 'at institutionally specified times'. For example, an institution may choose that BID is "always at 7am and 6pm". If it is inappropriate for this choice to be made, the code BID should not be used. Instead, a distinct organization-specific code should be used in place of the HL7-defined BID code and/or the a structured representation should be used (in this case, specifying the two event times). |
Max Length | 0 |
MedicationDispense.dosageInstruction.asNeeded[x] | |
Definition | Indicates whether the Medication is only taken when needed within a specific dosing schedule (Boolean option), or it indicates the precondition for taking the Medication (CodeableConcept). Specifically if 'boolean' datatype is selected, then the following logic applies: If set to True, this indicates that the medication is only taken when needed, within the specified schedule. |
Control | 0..1 |
Binding | A coded concept identifying the precondition that should be met or evaluated prior to consuming or administering a medication dose. For example "pain", "30 minutes prior to sexual intercourse", "on flare-up" etc. |
Type | Choice of: boolean, CodeableConcept |
[x] Note | See Choice of Data Types for further information about how to use [x] |
Must Support | true |
Comments | Conformance Rule: Set value = true. Conformance Rule: When this is specified, it is not acceptable to express the quantity exclusively as a duration/DAYSSUPPLY. The DOSAGEQUANTITY must be set. |
Max Length | 0 |
MedicationDispense.dosageInstruction.siteCodeableConcept | |
Definition | A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text. |
Control | 0..1 |
Binding | The codes SHALL be taken from PrescriptionAdministrationSite; other codes may be used where these codes are not suitable |
Type | CodeableConcept(Shared Health CodeableConcept Required Text with optional code) |
Must Support | true |
Comments | Conformance Rule: When providing a structured SIG, this should be populated when appropriate. If not structured, this should be part of the SIG (RENDEREDDOSAGEINSTRUCTION). Also can be specified for COMPLEX |
Max Length | 0 |
MedicationDispense.dosageInstruction.route | |
Definition | A concept that may be defined by a formal reference to a terminology or ontology or may be provided by text. |
Control | 0..1 |
Binding | The codes SHALL be taken from PrescriptionRouteOfAdministration; other codes may be used where these codes are not suitable |
Type | CodeableConcept(Shared Health CodeableConcept Required Text with optional code) |
Must Support | true |
Comments | Conformance Rule: Coding should be populated if a code is available. However, text is always required. |
Max Length | 0 |
MedicationDispense.dosageInstruction.method | |
Definition | A coded value indicating the method by which the medication is intended to be or was introduced into or on the body. |
Control | 0..1 |
Binding | A coded concept describing the technique by which the medicine is administered |
Type | CodeableConcept |
Comments | This attribute will most often NOT be populated. It is most commonly used for injections. For example, Slow Push, Deep IV. One of the reasons this attribute is not used often, is that the method is often pre-coordinated with the route and/or form of administration. This means the codes used in route or form may pre-coordinate the method in the route code or the form code. The implementation decision about what coding system to use for route or form code will determine how frequently the method code will be populated e.g. if route or form code pre-coordinate method code, then this attribute will not be populated often; if there is no pre-coordination then method code may be used frequently. |
Max Length | 0 |
MedicationDispense.dosageInstruction.doseQuantity | |
Definition | A measured or counted amount of a medication expressed as a value and human-readable string with optional coded units expressed in a local coding system |
Control | 0..1 |
Type | Quantity(PrescribeIT Drug Quantity for Administration) |
Must Support | true |
Comments | Conformance Rule: Could be sent as part of the dosage instruction. OR for those PMSs that can support it, this should be specified. This is quite pointless without the frequency. Conformance Rule: This is NOT specified for COMPLEX. |
Max Length | 0 |
Invariants | Defined on this element qty-3: If a code for the unit is present, the system SHALL also be present (: code.empty() or system.exists()) sqty-1: The comparator is not used on a SimpleQuantity (: comparator.empty()) |
MedicationDispense.dosageInstruction.rateRatio | |
Definition | Identifies the speed with which the medication was or will be introduced into the patient. Typically the rate for an infusion e.g. 100 ml per 1 hour or 100 ml/hr. May also be expressed as a rate per unit of time e.g. 500 ml per 2 hours. Currently we do not specify a default of '1' in the denominator, but this is being discussed. Other examples: 200 mcg/min or 200 mcg/1 minute; 1 liter/8 hours. |
Control | 0..1 |
Type | Ratio |
Must Support | true |
Max Length | 0 |
MedicationDispense.dosageInstruction.maxDosePerPeriod | |
Definition | The maximum total quantity of a therapeutic substance that may be administered to a subject over the period of time, e.g. 1000mg in 24 hours. |
Control | 0..1 |
Type | Ratio |
Must Support | true |
Requirements | Needed when the dosage unit is not expressed as part of the dose quantity (mg, mL) or implicit as part of the drug form (capsules, tablets). Examples are Puffs, Actuations, etc. |
Comments | Conformance Rule: When providing a structured SIG, this should be populated when appropriate. Also can be specified for COMPLEX |
Max Length | 0 |
MedicationDispense.dosageInstruction.maxDosePerPeriod.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.dosageInstruction.maxDosePerPeriod.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.dosageInstruction.maxDosePerPeriod.numerator | |
Definition | A measured or counted amount of a medication expressed as a value and human-readable string with optional coded units expressed in a local coding system |
Control | 1..1 |
Type | Quantity(PrescribeIT Drug Quantity for Administration) |
Must Support | true |
Comments | Usage Note: Quantity is used throughout the messages. It may be a drug form (e.g. TAB) an administrable drug (e.g. PUFF) form or a unit of measure (e.g. mg). |
Max Length | 0 |
Invariants | Defined on this element qty-3: If a code for the unit is present, the system SHALL also be present (: code.empty() or system.exists()) sqty-1: The comparator is not used on a SimpleQuantity (: comparator.empty()) |
MedicationDispense.dosageInstruction.maxDosePerPeriod.denominator | |
Definition | A measured amount (or an amount that can potentially be measured). Note that measured amounts include amounts that are not precisely quantified, including amounts involving arbitrary units and floating currencies. |
Control | 1..1 |
Type | Quantity(Shared Health Quantity) |
Must Support | true |
Comments | The context of use may frequently define what kind of quantity this is and therefore what kind of units can be used. The context of use may also restrict the values for the comparator. |
Max Length | 0 |
Invariants | Defined on this element qty-3: If a code for the unit is present, the system SHALL also be present (: code.empty() or system.exists()) |
MedicationDispense.substitution | |
Definition | Indicates whether or not substitution was made as part of the dispense. In some 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. |
Control | 0..1 |
Type | BackboneElement |
Max Length | 0 |
MedicationDispense.substitution.id | |
Definition | unique id for the element within a resource (for internal references). |
Control | 0..1 |
Type | id |
Max Length | 0 |
MedicationDispense.substitution.extension | |
Definition | May be used to represent additional information that is not part of the basic definition of the element. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. |
Control | 0..* |
Type | Extension |
Alternate Names | extensions, user content |
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. |
Max Length | 0 |
MedicationDispense.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 that contains it. Usually modifier elements provide negation or qualification. In order to make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to 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. |
Control | 0..* |
Type | Extension |
Is Modifier | true |
Alternate Names | extensions, user content, modifiers |
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. |
Max Length | 0 |
MedicationDispense.substitution.type | |
Definition | A code signifying whether a different drug was dispensed from what was prescribed. |
Control | 1..1 |
Binding | A coded concept describing whether a different medicinal product may be dispensed other than the product as specified exactly in the prescription For example codes, see ActSubstanceAdminSubstitutionCode |
Type | CodeableConcept |
Max Length | 0 |
MedicationDispense.substitution.reason | |
Definition | Indicates the reason for the substitution of (or lack of substitution) from what was prescribed. |
Control | 0..* |
Binding | A coded concept describing the reason that a different medication should (or should not) be substituted from what was prescribed For example codes, see SubstanceAdminSubstitutionReason |
Type | CodeableConcept |
Max Length | 0 |
MedicationDispense.substitution.responsibleParty | |
Definition | The person or organization that has primary responsibility for the substitution. |
Control | 0..* |
Type | Reference(Practitioner) |
Max Length | 0 |