Visit the HL7 website
Visit the FHIR website

CA Core+ v1.1.0 DFT-preBallot

1.1.0-DFT-preBallot   Canada flag
  • Index
  • Home
  • Business Context
    • Business Context
    • Relationship to PCHDCF
    • Relationship to Other Specifications
    • CA Core+ to pCHDCF Mapping
  • Technical Context
    • Technical Context
    • Artifact Status Summary
    • Profiling Conventions & Approach
    • General Guidance
    • Mapping Logic
    • Security And Privacy
  • Modules
    • Modules
    • Common Data Exchange
    • Workflows
  • FHIR Artifacts
    • FHIR Artifacts
    • Profiles
    • Extensions
    • Data Types
    • Terminology
    • Examples
    • Download
  • Change Log
    • Change Log
    • Specification Guidance
    • Copyrights
    • Known Issues & Future Development
    • Specification Feedback
    1. Index
    2. FHIR Artifacts
    3. Extensions
    4. MedicationRenderedDosage

DFT-preBallot - The specification is a DFT-preBallot version of CA Core+ for collecting community feedback. For a full list of available versions, see the Directory of published versions

MedicationRenderedDosage

Links

Extension

ext-medication-rendered-dosage

Description

Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the rendering of the overall resource instance)

References to this Extension

MedicationRequestCACore, MedicationStatementCACore

Standards Status FMM
trial-use 2

Resource Content

  • Overview
  • Tree view
  • XML
  • JSON
MedicationRenderedDosage (Extension)CExtension
There are no (further) constraints on this element
Element id
Extension
Short description

Optional Extensions Element

Definition

Optional Extension Element - found in all resources.

Data type

Extension

Conditions

The cardinality or value of this element may be affected by these constraints: ele-1

Constraints
  • 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()
Mappings
  • rim: n/a
  • rim: N/A
  • CACDI: Medication Dosage Instruction
id0..1string
There are no (further) constraints on this element
Element id
Extension.id
Short description

Unique id for inter-element referencing

Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

Data type

string

Mappings
  • rim: n/a
extensionC0..0Extension
There are no (further) constraints on this element
Element id
Extension.extension
Short description

Additional content defined by implementations

Alternate names

extensions, user content

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 manageable, 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.

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.

Data type

Extension

Slicing

Unordered, Open, by url(Value)

Extensions are always sliced by (at least) url

Constraints
  • 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()
Mappings
  • rim: n/a
url1..1uriFixed Value
There are no (further) constraints on this element
Element id
Extension.url
Short description

identifies the meaning of the extension

Definition

Source of the definition for the extension code - a logical name or a URL.

Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Data type

uri

Fixed value
http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage
Mappings
  • rim: N/A
value[x]S1..1
There are no (further) constraints on this element
Element id
Extension.value[x]
Short description

Rendered Dosage Instruction

Definition

Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the overall resource instance)

Comments

Usage Note: This is intended to provide the dosage instructions to the Pharmacist for dispensing. This will be displayed to the Pharmacist upon receipt of the ePrescription. The EMR may not provide individual/structured dosage instructions so all data that would have been conveyed as structured dosage data is provided here as well in human readable form. This is also used to convey the dosage instructions when a fax is used, as there will be no structured prescription on the fax. 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: MUST allow all printable characters and carriage return/line feeds.

Conformance Rule: The following MUST be included if available, in human-readable form: 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. If an EMR only supports a single separate/discrete field to capture patient instructions in the EMR, this should not be included here.

Conformance Rule: If an EMR sends discrete data elements they must also populate this with a textual view of the SIG (as per the MIF definition). E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field.

Conformance Rule: If an EMR has discrete field for Pharmacy Notes (Dispenser Instructions), they should not be included here. If EMR's have both concepts combined into one field, they can both be included here.

Usage Note: It is recognized that very complex instructions may be conveyed as text only (not as structured data). Example: take 500 mg twice a day at breakfast and at lunch AND 250 mg once a day at bedtime - THEN (new dosage line).....). The pharmacy will receive as text, enter it in their system and do the dosage checking. If the EMR submits the structured frequency in the message, this should be consistent with the textual instructions. The PMS may ignore the structured frequency, or override it to align with the textual instructions. Example: the EMR may enter frequency (multiplier of the dose) in their system like this (2 qam and 3 qhs ), in the structured frequency. The textual instructions could say Take 2 tablets in the morning and 3 at bedtime.

Constraints
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Maximum string length

5000

Mappings
  • rim: N/A
valueStringstring
There are no (further) constraints on this element
Data type

string

MedicationRenderedDosage (Extension)CExtensionElement id
Extension
Short description

Optional Extensions Element

Definition

Optional Extension Element - found in all resources.

Data type

Extension

Conditions

The cardinality or value of this element may be affected by these constraints: ele-1

Constraints
  • 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()
Mappings
  • rim: n/a
  • rim: N/A
  • CACDI: Medication Dosage Instruction
id0..1string
There are no (further) constraints on this element
Element id
Extension.id
Short description

Unique id for inter-element referencing

Definition

Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

Data type

string

Mappings
  • rim: n/a
extensionC0..0Extension
There are no (further) constraints on this element
Element id
Extension.extension
Short description

Additional content defined by implementations

Alternate names

extensions, user content

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 manageable, 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.

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.

Data type

Extension

Slicing

Unordered, Open, by url(Value)

Extensions are always sliced by (at least) url

Constraints
  • 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()
Mappings
  • rim: n/a
url1..1uriFixed ValueElement id
Extension.url
Short description

identifies the meaning of the extension

Definition

Source of the definition for the extension code - a logical name or a URL.

Comments

The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.

Data type

uri

Fixed value
http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage
Mappings
  • rim: N/A
value[x]S1..1Element id
Extension.value[x]
Short description

Rendered Dosage Instruction

Definition

Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the overall resource instance)

Comments

Usage Note: This is intended to provide the dosage instructions to the Pharmacist for dispensing. This will be displayed to the Pharmacist upon receipt of the ePrescription. The EMR may not provide individual/structured dosage instructions so all data that would have been conveyed as structured dosage data is provided here as well in human readable form. This is also used to convey the dosage instructions when a fax is used, as there will be no structured prescription on the fax. 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: MUST allow all printable characters and carriage return/line feeds.

Conformance Rule: The following MUST be included if available, in human-readable form: 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. If an EMR only supports a single separate/discrete field to capture patient instructions in the EMR, this should not be included here.

Conformance Rule: If an EMR sends discrete data elements they must also populate this with a textual view of the SIG (as per the MIF definition). E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field.

Conformance Rule: If an EMR has discrete field for Pharmacy Notes (Dispenser Instructions), they should not be included here. If EMR's have both concepts combined into one field, they can both be included here.

Usage Note: It is recognized that very complex instructions may be conveyed as text only (not as structured data). Example: take 500 mg twice a day at breakfast and at lunch AND 250 mg once a day at bedtime - THEN (new dosage line).....). The pharmacy will receive as text, enter it in their system and do the dosage checking. If the EMR submits the structured frequency in the message, this should be consistent with the textual instructions. The PMS may ignore the structured frequency, or override it to align with the textual instructions. Example: the EMR may enter frequency (multiplier of the dose) in their system like this (2 qam and 3 qhs ), in the structured frequency. The textual instructions could say Take 2 tablets in the morning and 3 at bedtime.

Constraints
  • ele-1: All FHIR elements must have a @value or children
    hasValue() or (children().count() > id.count())
Maximum string length

5000

Mappings
  • rim: N/A
valueStringstringData type

string

<StructureDefinition xmlns="http://hl7.org/fhir">
<id value="ext-medication-rendered-dosage" />
<extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="trial-use" />
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
<valueInteger value="2" />
</extension>
<url value="http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage" />
<version value="1.1.0" />
<name value="MedicationRenderedDosage" />
<title value="Medication Rendered Dosage Instruction" />
<status value="draft" />
<experimental value="false" />
<date value="2025-08-27" />
<publisher value="Canada Health Infoway" />
<contact>
<name value="National Standards Release Centre" />
<telecom>
<system value="url" />
<value value="http://www.infoway-inforoute.ca" />
</telecom>
<telecom>
<system value="email" />
<value value="standards@infoway-inforoute.ca" />
</telecom>
</contact>
<description value="Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the rendering of the overall resource instance)" />
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166" />
<code value="CA" />
</coding>
</jurisdiction>
<copyright value="Copyright © 2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy)." />
<fhirVersion value="4.0.1" />
<mapping>
<identity value="CACDI" />
<name value="Canadian Core Data for Interoperability (CACDI)" />
</mapping>
<kind value="complex-type" />
<abstract value="false" />
<context>
<type value="element" />
<expression value="MedicationRequest" />
</context>
<context>
<type value="element" />
<expression value="MedicationStatement" />
</context>
<context>
<type value="element" />
<expression value="Medication" />
</context>
<type value="Extension" />
<baseDefinition value="http://hl7.org/fhir/StructureDefinition/Extension" />
<derivation value="constraint" />
<snapshot>
<element id="Extension">
<extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="normative" />
</extension>
<extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version">
<valueCode value="4.0.0" />
</extension>
<path value="Extension" />
<short value="Optional Extensions Element" />
<definition value="Optional Extension Element - found in all resources." />
<min value="0" />
<max value="*" />
<base>
<path value="Extension" />
<min value="0" />
<max value="*" />
</base>
<condition value="ele-1" />
<constraint>
<key value="ele-1" />
<severity value="error" />
<human value="All FHIR elements must have a @value or children" />
<expression value="hasValue() or (children().count() > id.count())" />
<xpath value="@value|f:*|h:div" />
<source value="http://hl7.org/fhir/StructureDefinition/Element" />
</constraint>
<constraint>
<key value="ext-1" />
<severity value="error" />
<human value="Must have either extensions or value[x], not both" />
<expression value="extension.exists() != value.exists()" />
<xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])" />
</constraint>
<isModifier value="false" />
<mapping>
<identity value="rim" />
<map value="n/a" />
</mapping>
<mapping>
<identity value="rim" />
<map value="N/A" />
</mapping>
<mapping>
<identity value="CACDI" />
<map value="Medication Dosage Instruction" />
</mapping>
</element>
<element id="Extension.id">
<path value="Extension.id" />
<representation value="xmlAttr" />
<short value="Unique id for inter-element referencing" />
<definition value="Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces." />
<min value="0" />
<max value="1" />
<base>
<path value="Element.id" />
<min value="0" />
<max value="1" />
</base>
<type>
<extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
<valueUrl value="string" />
</extension>
<code value="http://hl7.org/fhirpath/System.String" />
</type>
<isModifier value="false" />
<isSummary value="false" />
<mapping>
<identity value="rim" />
<map value="n/a" />
</mapping>
</element>
<element id="Extension.extension">
<path value="Extension.extension" />
<slicing>
<discriminator>
<type value="value" />
<path value="url" />
</discriminator>
<description value="Extensions are always sliced by (at least) url" />
<rules value="open" />
</slicing>
<short value="Additional content defined by implementations" />
<definition value="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 manageable, 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." />
<comment value="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." />
<alias value="extensions" />
<alias value="user content" />
<min value="0" />
<max value="0" />
<base>
<path value="Element.extension" />
<min value="0" />
<max value="*" />
</base>
<type>
<code value="Extension" />
</type>
<constraint>
<key value="ele-1" />
<severity value="error" />
<human value="All FHIR elements must have a @value or children" />
<expression value="hasValue() or (children().count() > id.count())" />
<xpath value="@value|f:*|h:div" />
<source value="http://hl7.org/fhir/StructureDefinition/Element" />
</constraint>
<constraint>
<key value="ext-1" />
<severity value="error" />
<human value="Must have either extensions or value[x], not both" />
<expression value="extension.exists() != value.exists()" />
<xpath value="exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])" />
<source value="http://hl7.org/fhir/StructureDefinition/Extension" />
</constraint>
<isModifier value="false" />
<isSummary value="false" />
<mapping>
<identity value="rim" />
<map value="n/a" />
</mapping>
</element>
<element id="Extension.url">
<path value="Extension.url" />
<representation value="xmlAttr" />
<short value="identifies the meaning of the extension" />
<definition value="Source of the definition for the extension code - a logical name or a URL." />
<comment value="The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension." />
<min value="1" />
<max value="1" />
<base>
<path value="Extension.url" />
<min value="1" />
<max value="1" />
</base>
<type>
<extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type">
<valueUrl value="uri" />
</extension>
<code value="http://hl7.org/fhirpath/System.String" />
</type>
<fixedUri value="http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage" />
<isModifier value="false" />
<isSummary value="false" />
<mapping>
<identity value="rim" />
<map value="N/A" />
</mapping>
</element>
<element id="Extension.value[x]">
<path value="Extension.value[x]" />
<short value="Rendered Dosage Instruction" />
<definition value="Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the overall resource instance)" />
<comment value="Usage Note: This is intended to provide the dosage instructions to the Pharmacist for dispensing. This will be displayed to the Pharmacist upon receipt of the ePrescription. The EMR may not provide individual/structured dosage instructions so all data that would have been conveyed as structured dosage data is provided here as well in human readable form. This is also used to convey the dosage instructions when a fax is used, as there will be no structured prescription on the fax. The rendered dosage instruction must contain all dosage instructions and must be able to stand on its own.\n\nConformance 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').\n\nConformance Rule: MUST allow all printable characters and carriage return/line feeds.\n\nConformance Rule: The following MUST be included if available, in human-readable form: 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. If an EMR only supports a single separate/discrete field to capture patient instructions in the EMR, this should not be included here.\n\nConformance Rule: If an EMR sends discrete data elements they must also populate this with a textual view of the SIG (as per the MIF definition). E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field.\n\nConformance Rule: If an EMR has discrete field for Pharmacy Notes (Dispenser Instructions), they should not be included here. If EMR's have both concepts combined into one field, they can both be included here.\n\nUsage Note: It is recognized that very complex instructions may be conveyed as text only (not as structured data). Example: take 500 mg twice a day at breakfast and at lunch AND 250 mg once a day at bedtime - THEN (new dosage line).....). The pharmacy will receive as text, enter it in their system and do the dosage checking. If the EMR submits the structured frequency in the message, this should be consistent with the textual instructions. The PMS may ignore the structured frequency, or override it to align with the textual instructions. Example: the EMR may enter frequency (multiplier of the dose) in their system like this (2 qam and 3 qhs ), in the structured frequency. The textual instructions could say Take 2 tablets in the morning and 3 at bedtime." />
<min value="1" />
<max value="1" />
<base>
<path value="Extension.value[x]" />
<min value="0" />
<max value="1" />
</base>
<type>
<code value="string" />
</type>
<maxLength value="5000" />
<constraint>
<key value="ele-1" />
<severity value="error" />
<human value="All FHIR elements must have a @value or children" />
<expression value="hasValue() or (children().count() > id.count())" />
<xpath value="@value|f:*|h:div" />
<source value="http://hl7.org/fhir/StructureDefinition/Element" />
</constraint>
<mustSupport value="true" />
<isModifier value="false" />
<isSummary value="false" />
<mapping>
<identity value="rim" />
<map value="N/A" />
</mapping>
</element>
</snapshot>
<differential>
<element id="Extension">
<path value="Extension" />
<mapping>
<identity value="CACDI" />
<map value="Medication Dosage Instruction" />
</mapping>
</element>
<element id="Extension.extension">
<path value="Extension.extension" />
<max value="0" />
</element>
<element id="Extension.url">
<path value="Extension.url" />
<fixedUri value="http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage" />
</element>
<element id="Extension.value[x]">
<path value="Extension.value[x]" />
<short value="Rendered Dosage Instruction" />
<definition value="Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the overall resource instance)" />
<comment value="Usage Note: This is intended to provide the dosage instructions to the Pharmacist for dispensing. This will be displayed to the Pharmacist upon receipt of the ePrescription. The EMR may not provide individual/structured dosage instructions so all data that would have been conveyed as structured dosage data is provided here as well in human readable form. This is also used to convey the dosage instructions when a fax is used, as there will be no structured prescription on the fax. The rendered dosage instruction must contain all dosage instructions and must be able to stand on its own.\n\nConformance 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').\n\nConformance Rule: MUST allow all printable characters and carriage return/line feeds.\n\nConformance Rule: The following MUST be included if available, in human-readable form: 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. If an EMR only supports a single separate/discrete field to capture patient instructions in the EMR, this should not be included here.\n\nConformance Rule: If an EMR sends discrete data elements they must also populate this with a textual view of the SIG (as per the MIF definition). E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field.\n\nConformance Rule: If an EMR has discrete field for Pharmacy Notes (Dispenser Instructions), they should not be included here. If EMR's have both concepts combined into one field, they can both be included here.\n\nUsage Note: It is recognized that very complex instructions may be conveyed as text only (not as structured data). Example: take 500 mg twice a day at breakfast and at lunch AND 250 mg once a day at bedtime - THEN (new dosage line).....). The pharmacy will receive as text, enter it in their system and do the dosage checking. If the EMR submits the structured frequency in the message, this should be consistent with the textual instructions. The PMS may ignore the structured frequency, or override it to align with the textual instructions. Example: the EMR may enter frequency (multiplier of the dose) in their system like this (2 qam and 3 qhs ), in the structured frequency. The textual instructions could say Take 2 tablets in the morning and 3 at bedtime." />
<min value="1" />
<type>
<code value="string" />
</type>
<maxLength value="5000" />
<mustSupport value="true" />
</element>
</differential>
</StructureDefinition>
{
"resourceType": "StructureDefinition",
"id": "ext-medication-rendered-dosage",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "trial-use"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
"valueInteger": 2
}
],
"url": "http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage",
"version": "1.1.0",
"name": "MedicationRenderedDosage",
"title": "Medication Rendered Dosage Instruction",
"status": "draft",
"experimental": false,
"date": "2025-08-27",
"publisher": "Canada Health Infoway",
"contact": [
{
"name": "National Standards Release Centre",
"telecom": [
{
"system": "url",
"value": "http://www.infoway-inforoute.ca"
},
{
"system": "email",
"value": "standards@infoway-inforoute.ca"
}
]
}
],
"description": "Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the rendering of the overall resource instance)",
"jurisdiction": [
{
"coding": [
{
"system": "urn:iso:std:iso:3166",
"code": "CA"
}
]
}
],
"copyright": "Copyright © 2025+ Canada Health Infoway. All rights reserved. [Terms of Use and License Agreements](https://ic.infoway-inforoute.ca/en/about/tou). [Privacy Policy](https://www.infoway-inforoute.ca/en/legal/privacy-policy).",
"fhirVersion": "4.0.1",
"mapping": [
{
"identity": "CACDI",
"name": "Canadian Core Data for Interoperability (CACDI)"
}
],
"kind": "complex-type",
"abstract": false,
"context": [
{
"type": "element",
"expression": "MedicationRequest"
},
{
"type": "element",
"expression": "MedicationStatement"
},
{
"type": "element",
"expression": "Medication"
}
],
"type": "Extension",
"baseDefinition": "http://hl7.org/fhir/StructureDefinition/Extension",
"derivation": "constraint",
"snapshot": {
"element": [
{
"id": "Extension",
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode": "normative"
},
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-normative-version",
"valueCode": "4.0.0"
}
],
"path": "Extension",
"short": "Optional Extensions Element",
"definition": "Optional Extension Element - found in all resources.",
"min": 0,
"max": "*",
"base": {
"path": "Extension",
"min": 0,
"max": "*"
},
"condition": [
"ele-1"
],
"constraint": [
{
"key": "ele-1",
"severity": "error",
"human": "All FHIR elements must have a @value or children",
"expression": "hasValue() or (children().count() > id.count())",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element"
},
{
"key": "ext-1",
"severity": "error",
"human": "Must have either extensions or value[x], not both",
"expression": "extension.exists() != value.exists()",
"xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])"
}
],
"isModifier": false,
"mapping": [
{
"identity": "rim",
"map": "n/a"
},
{
"identity": "rim",
"map": "N/A"
},
{
"identity": "CACDI",
"map": "Medication Dosage Instruction"
}
]
},
{
"id": "Extension.id",
"path": "Extension.id",
"representation": [
"xmlAttr"
],
"short": "Unique id for inter-element referencing",
"definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
"min": 0,
"max": "1",
"base": {
"path": "Element.id",
"min": 0,
"max": "1"
},
"type": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
"valueUrl": "string"
}
],
"code": "http://hl7.org/fhirpath/System.String"
}
],
"isModifier": false,
"isSummary": false,
"mapping": [
{
"identity": "rim",
"map": "n/a"
}
]
},
{
"id": "Extension.extension",
"path": "Extension.extension",
"slicing": {
"discriminator": [
{
"type": "value",
"path": "url"
}
],
"description": "Extensions are always sliced by (at least) url",
"rules": "open"
},
"short": "Additional content defined by implementations",
"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 manageable, 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.",
"comment": "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.",
"alias": [
"extensions",
"user content"
],
"min": 0,
"max": "0",
"base": {
"path": "Element.extension",
"min": 0,
"max": "*"
},
"type": [
{
"code": "Extension"
}
],
"constraint": [
{
"key": "ele-1",
"severity": "error",
"human": "All FHIR elements must have a @value or children",
"expression": "hasValue() or (children().count() > id.count())",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element"
},
{
"key": "ext-1",
"severity": "error",
"human": "Must have either extensions or value[x], not both",
"expression": "extension.exists() != value.exists()",
"xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
"source": "http://hl7.org/fhir/StructureDefinition/Extension"
}
],
"isModifier": false,
"isSummary": false,
"mapping": [
{
"identity": "rim",
"map": "n/a"
}
]
},
{
"id": "Extension.url",
"path": "Extension.url",
"representation": [
"xmlAttr"
],
"short": "identifies the meaning of the extension",
"definition": "Source of the definition for the extension code - a logical name or a URL.",
"comment": "The definition may point directly to a computable or human-readable definition of the extensibility codes, or it may be a logical URI as declared in some other specification. The definition SHALL be a URI for the Structure Definition defining the extension.",
"min": 1,
"max": "1",
"base": {
"path": "Extension.url",
"min": 1,
"max": "1"
},
"type": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
"valueUrl": "uri"
}
],
"code": "http://hl7.org/fhirpath/System.String"
}
],
"fixedUri": "http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage",
"isModifier": false,
"isSummary": false,
"mapping": [
{
"identity": "rim",
"map": "N/A"
}
]
},
{
"id": "Extension.value[x]",
"path": "Extension.value[x]",
"short": "Rendered Dosage Instruction",
"definition": "Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the overall resource instance)",
"comment": "Usage Note: This is intended to provide the dosage instructions to the Pharmacist for dispensing. This will be displayed to the Pharmacist upon receipt of the ePrescription. The EMR may not provide individual/structured dosage instructions so all data that would have been conveyed as structured dosage data is provided here as well in human readable form. This is also used to convey the dosage instructions when a fax is used, as there will be no structured prescription on the fax. The rendered dosage instruction must contain all dosage instructions and must be able to stand on its own.\n\nConformance 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').\n\nConformance Rule: MUST allow all printable characters and carriage return/line feeds.\n\nConformance Rule: The following MUST be included if available, in human-readable form: 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. If an EMR only supports a single separate/discrete field to capture patient instructions in the EMR, this should not be included here.\n\nConformance Rule: If an EMR sends discrete data elements they must also populate this with a textual view of the SIG (as per the MIF definition). E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field.\n\nConformance Rule: If an EMR has discrete field for Pharmacy Notes (Dispenser Instructions), they should not be included here. If EMR's have both concepts combined into one field, they can both be included here.\n\nUsage Note: It is recognized that very complex instructions may be conveyed as text only (not as structured data). Example: take 500 mg twice a day at breakfast and at lunch AND 250 mg once a day at bedtime - THEN (new dosage line).....). The pharmacy will receive as text, enter it in their system and do the dosage checking. If the EMR submits the structured frequency in the message, this should be consistent with the textual instructions. The PMS may ignore the structured frequency, or override it to align with the textual instructions. Example: the EMR may enter frequency (multiplier of the dose) in their system like this (2 qam and 3 qhs ), in the structured frequency. The textual instructions could say Take 2 tablets in the morning and 3 at bedtime.",
"min": 1,
"max": "1",
"base": {
"path": "Extension.value[x]",
"min": 0,
"max": "1"
},
"type": [
{
"code": "string"
}
],
"maxLength": 5000,
"constraint": [
{
"key": "ele-1",
"severity": "error",
"human": "All FHIR elements must have a @value or children",
"expression": "hasValue() or (children().count() > id.count())",
"xpath": "@value|f:*|h:div",
"source": "http://hl7.org/fhir/StructureDefinition/Element"
}
],
"mustSupport": true,
"isModifier": false,
"isSummary": false,
"mapping": [
{
"identity": "rim",
"map": "N/A"
}
]
}
]
},
"differential": {
"element": [
{
"id": "Extension",
"path": "Extension",
"mapping": [
{
"identity": "CACDI",
"map": "Medication Dosage Instruction"
}
]
},
{
"id": "Extension.extension",
"path": "Extension.extension",
"max": "0"
},
{
"id": "Extension.url",
"path": "Extension.url",
"fixedUri": "http://prescribeit.ca/fhir/StructureDefinition/ext-medication-rendered-dosage"
},
{
"id": "Extension.value[x]",
"path": "Extension.value[x]",
"short": "Rendered Dosage Instruction",
"definition": "Provides a complete text rendering of the dosage instruction lines for an order or dispense (separate from the overall resource instance)",
"comment": "Usage Note: This is intended to provide the dosage instructions to the Pharmacist for dispensing. This will be displayed to the Pharmacist upon receipt of the ePrescription. The EMR may not provide individual/structured dosage instructions so all data that would have been conveyed as structured dosage data is provided here as well in human readable form. This is also used to convey the dosage instructions when a fax is used, as there will be no structured prescription on the fax. The rendered dosage instruction must contain all dosage instructions and must be able to stand on its own.\n\nConformance 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').\n\nConformance Rule: MUST allow all printable characters and carriage return/line feeds.\n\nConformance Rule: The following MUST be included if available, in human-readable form: 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. If an EMR only supports a single separate/discrete field to capture patient instructions in the EMR, this should not be included here.\n\nConformance Rule: If an EMR sends discrete data elements they must also populate this with a textual view of the SIG (as per the MIF definition). E.g. PO value for RouteofAdministration will be conveyed as 'oral' in this field.\n\nConformance Rule: If an EMR has discrete field for Pharmacy Notes (Dispenser Instructions), they should not be included here. If EMR's have both concepts combined into one field, they can both be included here.\n\nUsage Note: It is recognized that very complex instructions may be conveyed as text only (not as structured data). Example: take 500 mg twice a day at breakfast and at lunch AND 250 mg once a day at bedtime - THEN (new dosage line).....). The pharmacy will receive as text, enter it in their system and do the dosage checking. If the EMR submits the structured frequency in the message, this should be consistent with the textual instructions. The PMS may ignore the structured frequency, or override it to align with the textual instructions. Example: the EMR may enter frequency (multiplier of the dose) in their system like this (2 qam and 3 qhs ), in the structured frequency. The textual instructions could say Take 2 tablets in the morning and 3 at bedtime.",
"min": 1,
"type": [
{
"code": "string"
}
],
"maxLength": 5000,
"mustSupport": true
}
]
}
}

Terminology bindings

IG © based on FHIR R4 | Package package:ca.infoway.io.core@1.1.0-dft-preballot
HL7® and FHIR® are the registered trademarks of Health Level Seven International