PrescribeIT® Specification and Guide Version 5.0


v5.0 of this specification has been superseded by v5.3. v5.3 is compatible but adds additional features for Quebec.

The version (Bundle.meta.tag:version) that is sent in the message will remain PrescribeIT5.0

 

The official URL for this extension is:

http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative

Status: draft
Extension maintained by:

If set to true, indicates that the medication code sent was chosen as a "representative" code of a drug picked at a more general level. I.e. The user didn't actually choose this specific code. The intended constraints around what drug should be supplied are conveyed by the request's substitution rules.

Context of Use

This extension may be used on the following element(s):

  • {"type"=>"Medication.code.coding"}

Usage info

Usage:

Download Excel representation

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Extension

NameCard.TypeConstraints and Usage
.  Extension 0..1ExtensionDefinition:
If set to true, indicates that the medication code sent was chosen as a "representative" code of a drug picked at a more general level. I.e. The user didn't actually choose this specific code. The intended constraints around what drug should be supplied are conveyed by the request's substitution rules.


Comments:
Usage Note: Below the Grid View, we have provided a business scenario to provide further guidance and clarity on the intended use.



Conformance Rule: If prescribing by Generic Name, a (representative) DIN must be present in the message and this boolean must be 'true'.



Usage Note: ONLY the ingredients are to be interpreted from the DIN when it is a Representative DIN. The strength and the form may be supplied as separate fields. If the strength is not supplied, then the prescriber must specify the dosage.



Usage Note: Upon receipt of a prescription, the PMS will look at this field. If 'true', then this is a representative DIN. The PMS my choose to use this as a means to automatically filter and present a list of possible DINs/ appropriate medication . The prescribed dosage (e.g. 20 mg) and route will also be considered. Once presented with a list, the pharmacist can select a medication from this list or may select another generic equivalent with the same prescribed dosage.



Usage in the EMR: The representative DIN is chosen by the EMR (not the prescriber) based on the drug and route that is entered by the prescriber.



Usage Notes: The representative DIN is NOT intended for display to the pharmacist, as this is ONLY used for filtering. It would be appropriate to show the pharmacist the generic name (HICL or GCN) associated with the representative DIN. The drug name MUST be shown to the pharmacist.



Note: This concept does NOT exist today; pharmacists dispense based on the generic name. Its use within ePrescribing is to allow for automation as it provides a codified value to represent what the prescriber wants. This may assist the pharmacist in dispensing.



Usage Note: If the form and route are not supplied in the message, then the prescriber must specify the dosage.

..  url 1..1uri"http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative"
..  value[x] 1..1booleanDefinition:
If set to true, indicates that the medication code sent was chosen as a "representative" code of a drug picked at a more general level. I.e. The user didn't actually choose this specific code. The intended constraints around what drug should be supplied are conveyed by the request's substitution rules.


Comments:
If this is present, a corresponding substitution code should also be present

This structure is derived from Extension

Summary

Mandatory: 2 elements
Must-Support: 2 elements
Fixed Value: 1 element
Prohibited: 1 element

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..1ExtensionRepresentative Drug
... extension 0..0
... url S1..1uri"http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative"
... value[x] S1..1booleanRepresentative Drug

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..1ExtensionRepresentative Drug
... id 0..1idxml:id (or equivalent in JSON)
... url S1..1uri"http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative"
... value[x] S1..1booleanRepresentative Drug

doco Documentation for this format

Grid View

This structure is derived from Extension

NameCard.TypeConstraints and Usage
.  Extension 0..1ExtensionDefinition:
If set to true, indicates that the medication code sent was chosen as a "representative" code of a drug picked at a more general level. I.e. The user didn't actually choose this specific code. The intended constraints around what drug should be supplied are conveyed by the request's substitution rules.


Comments:
Usage Note: Below the Grid View, we have provided a business scenario to provide further guidance and clarity on the intended use.



Conformance Rule: If prescribing by Generic Name, a (representative) DIN must be present in the message and this boolean must be 'true'.



Usage Note: ONLY the ingredients are to be interpreted from the DIN when it is a Representative DIN. The strength and the form may be supplied as separate fields. If the strength is not supplied, then the prescriber must specify the dosage.



Usage Note: Upon receipt of a prescription, the PMS will look at this field. If 'true', then this is a representative DIN. The PMS my choose to use this as a means to automatically filter and present a list of possible DINs/ appropriate medication . The prescribed dosage (e.g. 20 mg) and route will also be considered. Once presented with a list, the pharmacist can select a medication from this list or may select another generic equivalent with the same prescribed dosage.



Usage in the EMR: The representative DIN is chosen by the EMR (not the prescriber) based on the drug and route that is entered by the prescriber.



Usage Notes: The representative DIN is NOT intended for display to the pharmacist, as this is ONLY used for filtering. It would be appropriate to show the pharmacist the generic name (HICL or GCN) associated with the representative DIN. The drug name MUST be shown to the pharmacist.



Note: This concept does NOT exist today; pharmacists dispense based on the generic name. Its use within ePrescribing is to allow for automation as it provides a codified value to represent what the prescriber wants. This may assist the pharmacist in dispensing.



Usage Note: If the form and route are not supplied in the message, then the prescriber must specify the dosage.

..  url 1..1uri"http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative"
..  value[x] 1..1booleanDefinition:
If set to true, indicates that the medication code sent was chosen as a "representative" code of a drug picked at a more general level. I.e. The user didn't actually choose this specific code. The intended constraints around what drug should be supplied are conveyed by the request's substitution rules.


Comments:
If this is present, a corresponding substitution code should also be present

This structure is derived from Extension

Summary

Mandatory: 2 elements
Must-Support: 2 elements
Fixed Value: 1 element
Prohibited: 1 element

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..1ExtensionRepresentative Drug
... extension 0..0
... url S1..1uri"http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative"
... value[x] S1..1booleanRepresentative Drug

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Extension 0..1ExtensionRepresentative Drug
... id 0..1idxml:id (or equivalent in JSON)
... url S1..1uri"http://prescribeit.ca/fhir/StructureDefinition/ext-medication-code-representative"
... value[x] S1..1booleanRepresentative Drug

doco Documentation for this format

 

Other representations of extension: Schematron

3.1.3 Terminology Bindings

Constraints

IdPathDetailsRequirements