MedicationRequest (CA-Core)

Additional information on this profile (including the JSON & XML structure and detailed element descriptions) can be found at package/structuredefinition-medicationrequest-ca-core.json

This profile imposes the CA Baseline (v1.1.7) MedicationRequest Profile.

Profile

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
extensionI0..*Extension
modifierExtension?! I0..*Extension
identifier0..*Identifier
statusΣ ?!1..1codeBinding
statusReason0..1CodeableConcept
intentΣ ?!1..1codeBinding
category0..*CodeableConcept
priorityΣ0..1codeBinding
doNotPerformΣ ?!0..1boolean
reportedBooleanboolean
reportedReferenceReference(Patient | Practitioner | PractitionerRole | RelatedPerson | Organization)
medicationReferenceΣ0..1Reference(package/structuredefinition-medication-ca-core.json)
medicationCodeableConceptΣ0..1CodeableConceptBinding
subjectΣ I1..1Reference(package/structuredefinition-patient-ca-core.json | Group)
encounterI0..1Reference(Encounter)
supportingInformationI0..*Reference(Resource)
authoredOnΣ0..1dateTime
requesterΣ I0..1Reference(package/structuredefinition-practitioner-ca-core.json | package/structuredefinition-practitionerrole-ca-core.json | Practitioner | PractitionerRole | Organization | Patient | RelatedPerson | Device)
performerI0..1Reference(Practitioner | PractitionerRole | Organization | Patient | Device | RelatedPerson | CareTeam)
performerTypeΣ0..1CodeableConcept
recorderI0..1Reference(Practitioner | PractitionerRole)
reasonCode0..*CodeableConceptBinding
reasonReferenceI0..*Reference(Condition | Observation)
instantiatesCanonicalΣ0..*canonical()
instantiatesUriΣ0..*uri
basedOnΣ I0..*Reference(CarePlan | MedicationRequest | ServiceRequest | ImmunizationRecommendation)
groupIdentifierΣ0..1Identifier
courseOfTherapyType0..1CodeableConcept
insuranceI0..*Reference(Coverage | ClaimResponse)
note0..*Annotation
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
sequenceΣ0..1integer
textΣ0..1string
additionalInstructionΣ0..*CodeableConcept
patientInstructionΣ0..1string
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
eventΣ0..*dateTime
id0..1string
extensionI0..*Extension
boundsDurationDuration
boundsRangeRange
boundsPeriodPeriod
countΣ0..1positiveInt
countMaxΣ0..1positiveInt
durationΣ0..1decimal
durationMaxΣ0..1decimal
durationUnitΣ0..1codeBinding
frequencyΣ0..1positiveInt
frequencyMaxΣ0..1positiveInt
periodΣ0..1decimal
periodMaxΣ0..1decimal
periodUnitΣ0..1codeBinding
dayOfWeekΣ0..*codeBinding
timeOfDayΣ0..*time
whenΣ0..*codeBinding
offsetΣ0..1unsignedInt
codeΣ0..1CodeableConceptBinding
asNeededBooleanboolean
asNeededCodeableConceptCodeableConcept
siteΣ0..1CodeableConcept
routeΣ0..1CodeableConceptBinding
methodΣ0..1CodeableConcept
id0..1string
extensionI0..*Extension
typeΣ0..1CodeableConcept
id0..1string
extensionI0..*Extension
lowΣ I0..1package/structuredefinition-drug-quantity-ca-core.json
highΣ I0..1package/structuredefinition-drug-quantity-ca-core.json
doseQuantityΣ I0..1package/structuredefinition-drug-quantity-ca-core.json
rateRatioRatio
rateRangeRange
rateQuantitySimpleQuantity
maxDosePerPeriodΣ I0..1Ratio
maxDosePerAdministrationΣ I0..1SimpleQuantity
maxDosePerLifetimeΣ I0..1SimpleQuantity
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
quantityI0..1SimpleQuantity
durationI0..1Duration
dispenseIntervalI0..1Duration
validityPeriodI0..1Period
numberOfRepeatsAllowed0..1unsignedInt
quantityI0..1SimpleQuantity
expectedSupplyDurationI0..1Duration
performerI0..1Reference(Organization)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
allowedBooleanboolean
allowedCodeableConceptCodeableConcept
reason0..1CodeableConcept
priorPrescriptionI0..1Reference(MedicationRequest)
detectedIssueI0..*Reference(DetectedIssue)
eventHistoryI0..*Reference(Provenance)

Obligations

Obligations are a new (and evolving) mechanism in FHIR to provide a consistent and machine processable way for profiles to define their expectations for system behaviors.

This profile utilizes the Obligation Extension to convey these expectations.

Note: Simplifier is working on rendering of Obligations. In the meantime the Obligations applied on the profile (see JSON & XML structure) have been rendered as a table below for easier viewing.

Obligation Code Actor Elements
SHALL:able-to-populate Server Actor (CA Core) status, priority, medication[x]:medicationReference, medication[x]:medicationCodeableConcept, subject, authoredOn, requester, reasonCode, dosageInstruction, dosageInstruction.text, dosageInstruction.timing, dosageInstruction.timing.repeat, dosageInstruction.timing.repeat.durationUnit, dosageInstruction.timing.repeat.frequency, dosageInstruction.timing.repeat.period, dosageInstruction.route, dosageInstruction.doseAndRate, dosageInstruction.doseAndRate.dose[x]:doseRange, dosageInstruction.doseAndRate.dose:doseQuantity, dispenseRequest.numberOfRepeatsAllowed, detectedIssue
SHALL:no-error Client Actor (CA Core) status, priority, medication[x]:medicationReference, medication[x]:medicationCodeableConcept, subject, authoredOn, requester, reasonCode, dosageInstruction, dosageInstruction.text, dosageInstruction.timing, dosageInstruction.timing.repeat, dosageInstruction.timing.repeat.durationUnit, dosageInstruction.timing.repeat.frequency, dosageInstruction.timing.repeat.period, dosageInstruction.route, dosageInstruction.doseAndRate, dosageInstruction.doseAndRate.dose[x]:doseRange, dosageInstruction.doseAndRate.dose:doseQuantity dispenseRequest.numberOfRepeatsAllowed, detectedIssue

Terminology

This version of the guide is based on the early content development of the pan-Canadian Health Data Content Framework (pCHDCF). The pCHDCF is beginning to introduce recommended terminology for select concepts. Implementers should be aware that the identification of preferred terminology continues to progress and that some coded elements may have terminology recommendations added in future releases.

Note: Preferred valueSet bindings for MedicationRequest.medicationCodeableConcept and MedicationRequest.dosageInstruction.route are expected to continue to change as pCHDCF undergoes further refinement. The point-in-time materials used to create the profiles in this release recommend the use of PrescribeIT valueSets that are heavily implemented in production but may not be in sync with the preferred valueSets expressed in other pan-Canadian specifications. This will be addressed through pCHDCF with the final recommendation in pCHDCF v1.0 expected to resolve any current differences with other pan-Canadian specifications by identifying the preferred terminology that should be used moving forward (e.g., PS-CA v2.0).

Note: Implementers should be aware of the limitations in some terminology referenced in this guide that is not fully expressed as an enumerated FHIR ValueSet or resolvable FHIR CodeSystems. Readers should refer to the Known Issues & Future Development page.

Bindings

Primary bindings are expressed in the rendering of the profile above (as well as can be found in the JSON/XML file).

Additional terminology bindings are also expressed in this profile to surface Alternate Value Sets expressed in the pCHDCF Data Content Standard. Currently, Simplifier does not render the additionalBinding extension that is applied within the profile to express these Alternate Value Sets. See Known Issues & Future Development page.

In the interim, the terminology that has been expressed as additionalBindings is rendered below for ease of use:

Mappings to pCHDCF

Draft Data Content Standard Element (As of 2024-02-15) Draft Data Content Standard Element Definition (As of 2024-02-15) FHIR Profile Element Additional Notes
Medication Request Status A code specifying the current state of the order (e.g., active, completed). MedicationRequest.status
Medication Request Priority An Indication of how quickly the medication request should be addressed with respect to other requests. MedicationRequest.priority
Medication Brand Name The brand name of the medication that is being prescribed. MedicationRequest.medication[x] Mapping of this concept applies to both medicationReference or medicationCodeableConcept data types, mappings to Medication elements can be found in the Medication Profile
Medication Generic Name The generic name of medication that is being prescribed. MedicationRequest.medication[x] Mapping of this concept applies to both medicationReference or medicationCodeableConcept data types, mappings to Medication elements can be found in the Medication Profile
Medication Request Date The date that the medication request was made. MedicationRequest.authoredOn
Medication Prescriber First Name The first name of the provider prescribing the medication. MedicationRequest.requester.name.given MedicationRequest.requester is used to link to these details housed in the practitioner resource (e.g. first name, last name, ID) as indicated in the pCHDCF artefacts
Medication Prescriber Last Name The first name of the provider prescribing the medication. MedicationRequest.requester.name.family MedicationRequest.requester is used to link to these details housed in the practitioner resource (e.g. first name, last name, ID) as indicated in the pCHDCF artefacts
Medication Prescriber ID The jurisdictional registration number of the provider prescribing the medication. MedicationRequest.requester.identifier MedicationRequest.requester is used to link to these details housed in the practitioner resource (e.g. first name, last name, ID) as indicated in the pCHDCF artefacts
Medication Reason The reason why the medication is being prescribed or used. MedicationRequest.reasonCode
Medication Administration Instruction The administration instructions for the medication. MedicationRequest.dosageInstruction.text
Medication Administration Instruction Time Instructions about when medication should be administered. MedicationRequest.dosageInstruction.timing The current definition for this concept implies a separation of generic instructions from the instructions of when the medication should be administered. While dosageInstruction.timing provides these details, the current mapping is to a backbone element where individual structured components are expressed together to provide meaning (e.g., frequency + period + bounds instead of a instruction text string for timing). Reviewers are encouraged to provide feedback on whether these separated timing instructions are more commonly captured as structured fields or in string form in child fields (e.g., dosageInstruction.additionalInstruction, dosageInstruction.code.text), to help inform future mapping and obligations
Medication Period of Use The relevant duration for the medication. MedicationRequest.dosageInstruction.timing.repeat.durationUnit The current definition for this concept is loose and may continue to change as the pCHDCF is refined. The supply of TimeUnitofMeasure UCUM as expected terminology for this concept in the pCHDCF influenced the selection of this mapping target over others.
Medication Frequency The number of occurrences within a given time period that a dose of a drug is to be administered. MedicationRequest.dosageInstruction.timing.repeat.frequency + MedicationRequest.dosageInstruction.timing.repeat.period The current definition for this concept implies that the frequency is understood within a given time period. To fully provide meaning to frequency under this definition, the MedicationRequest.dosageInstruction.timing.repeat.period element must also be used.
Medication Route of Administration The path by which the pharmaceutical product is taken into or makes contact with the body (e.g., oral, intramuscular). MedicationRequest.dosageInstruction.route
Medication Prescribed Dose The measured portion of a drug to be taken at any one time that pertains to the drug prescribed. MedicationRequest.dosageInstruction.doseAndRate.dose[x] Mapping of this concept applies to both the doseRange and doseQuantity data types. Explicit mappings to value and units can be found in the Drug Quantity Profile
Medication Dose A measured portion of medicine taken at any one time. MedicationRequest.dosageInstruction.doseAndRate.dose[x] Mapping of this concept applies to both the doseRange and doseQuantity data types. Explicit mappings to value and units can be found in the Drug Quantity Profile
Medication Dose Unit of Measure The unit of measure of a drug dose taken at any one time. Quantity.system + Quantity.code To fully provide meaning to unit of measure under this definition (which has an expeded CodeableConcept data type), the system and code sub-elements must be used together
Medication Refills The number of refills or repeats authorized. MedicationRequest.dispenseRequest.numberOfRepeatsAllowed
Medication Incident A description of a preventable event that may cause or lead to inappropriate medication use or patient harm while the medication is in the control of the healthcare professional, patient, or consumer. MedicationRequest.detectedIssue Reviewers are encouraged to provide further feedback on this mapping and the impacts of expectations to support this element instead of other targets (e.g., AdverseEvent, Observation)
Preferred Pharmacy Name The name of the preferred pharmacy. N/A Expected to be housed outside of MedicationRequest Resource. Preferred Pharmacy is an approved Core Extension, that once created will be applied on the Patient resource. See https://jira.hl7.org/browse/FHIR-38703
Preferred Pharmacy Identifier The location code of the preferred pharmacy. N/A Expected to be housed outside of MedicationRequest Resource. Preferred Pharmacy is an approved Core Extension, that once created will be applied on the Patient resource. See https://jira.hl7.org/browse/FHIR-38703
Preferred Pharmacy Code The postal code of the preferred pharmacy. N/A Expected to be housed outside of MedicationRequest Resource. Preferred Pharmacy is an approved Core Extension, that once created will be applied on the Patient resource. See https://jira.hl7.org/browse/FHIR-38703
Preferred Pharmacy Phone Number The telephone phone number of the preferred pharmacy. N/A Expected to be housed outside of MedicationRequest Resource. Preferred Pharmacy is an approved Core Extension, that once created will be applied on the Patient resource. See https://jira.hl7.org/browse/FHIR-38703
Preferred Pharmacy Fax Number The fax number of the preferred pharmacy. N/A Expected to be housed outside of MedicationRequest Resource. Preferred Pharmacy is an approved Core Extension, that once created will be applied on the Patient resource. See https://jira.hl7.org/browse/FHIR-38703
Medication reason preferred product not prescribed The reason why a preferred medication was not prescribed. N/A No mapping has been suggested for this concept until it is further modeled and refined to express whether it applied to an adapted prescription, a dispense record, or some alternative. Reviewers are encouraged to provide feedback on whether this concept is expressed in their implementations today