ACCESS Gateway EHR Specification HL7 FHIR® Implementation Guide-v1.0.0-WIP-draft

Medication Request (Clinician) Profile

FHIR Requirements for medication request information displayed to a clinician.

Constraints on the MedicationRequest resource to reflect source data mappings for the ACCESS Health project. Focus of this profile is on display of medication request information to clinician viewers.

This profile was generated from HL7 MedicationRequest StructureDefinition

Sources-To-Date

  • Nova Scotia DIS Specification

  • New Brunswick DIS Specification

  • Newfoundland & Labrador DIS Specification

  • Prince Edward Island DIS Specification

Constraints

As part of the scope of the discovery phase of this project, mappings, profiles, and implementation guides were expected to be agnostic with regard to implementation decisions or architectural paradigm.

  • It could not be assumed that future implementations will exchange information via a RESTful API.
  • Design for how resources could be identified and verified/matched across organizations and jurisdictions fell outside of scope for this phase. Mappings had to be made under the most basic assumption that resources could be referenced on a local server.

This profile is informed by the Drug Information System vendor specifications from all four Atlantic Provinces. While vendor specifications provide helpful insight into system configurations, test messages and documentation on known variances from the CeRX standard are foundational in accessing each jurisdiction's future conformance to the FHIR profile.

Supported CeRX interaction types limitations:

New Brunswick DIS does not currently support query interactions, because of this an alternative CeRX message type (Record Dispense Processing Request) was used for both MedicationRequest and MedicationDispense. No alternative CeRX message type could be found for New Brunswick that supported Medication Profile/Statement information, so New Brunswick mappings were excluded from this profile.

There were a number of cases where the CeRX conformance binding also limited the ability to change the lower cardinality limits on desired FHIR elements (to mandate the presence of critical values). CeRX makes the distinction between:

  • Mandatory conformance: the property must be supported and must always be present with a non-null value
  • Required conformance: the property must be support but may appear with a flavor of null.

In cases where the CeRX conformance strength was required (not mandatory) the lower cardinality bounds were not modified in the profile in order to avoid conformance errors that could occur because of limitations in the source data. Those cases are discussed further below.

Test message limitations:

Test messages were only available from one DIS (Prince Edward Island).

  • Further examination of test and pre-production messages will be critical for validating each jurisdiction’s conformance to the standard, as even slight variation can create errors in extraction and risks in conformance to the profile.

Documented variance limitations:

Only two jurisdictions (Newfoundland Labrador and New Brunswick) called out specific differences from the CeRx standard in their implementations. None of the differences identified by these sources impacted the interactions that were examined for conversion.

  • While this might imply that conversion from CeRx to FHIR in Atlantic provinces could be accomplished in a broadly standardized manner across jurisdictions, it is important to note that the absence of noted variances in the other two jurisdictions is not the same as confirmation that variances do not exist.

Note Additional evaluation and iteration of these profiles, as additional jurisdictional specifications are made available, is paramount to ensure the final profile reflects the current state of Atlantic systems.

ACCESS MedicationRequest (Clinician) Profile

ACCESS MedicationRequest (Clinician) Profile

identifierIdentifier
statusScodeBinding
statusReasonCodeableConcept
intentScodeBinding
doNotPerformboolean
reportedboolean
medicationCodeableConceptCodeableConcept
medicationReferenceReference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-medication)
subjectSReference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-patient)
authoredOnSdateTime
requesterSReference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-practitioner)
performerReference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-organization | http://hl7.org/fhir/ca/core/StructureDefinition/profile-practitioner)
performerTypeCodeableConcept
reasonCodeCodeableConcept
groupIdentifierIdentifier
courseOfTherapyTypeCodeableConceptBinding
insuranceReference(http://hl7.org/fhir/StructureDefinition/Coverage)
authorReferenceReference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-organization | http://hl7.org/fhir/ca/core/StructureDefinition/profile-patient | http://hl7.org/fhir/ca/core/StructureDefinition/profile-practitioner | http://hl7.org/fhir/StructureDefinition/RelatedPerson)
timedateTime
textmarkdown
sequenceinteger
textS1..1string
timingTiming
siteCodeableConceptBinding
routeCodeableConceptBinding
typeCodeableConcept
doseRangeRange
rateRatioRatio
maxDosePerPeriodRatio
DurationDuration
Quantity
dispenseIntervalDuration
validityPeriodPeriod
numberOfRepeatsAllowedSunsignedInt
quantityS
expectedSupplyDurationSDuration
performerReference(http://hl7.org/fhir/ca/core/StructureDefinition/profile-organization)
allowedBoolean
reasonCodeableConceptBinding
priorPrescriptionReference(ACCESS MedicationRequest (Clinician) Profile)
detectedIssueReference(http://hl7.org/fhir/StructureDefinition/DetectedIssue)
eventHistoryReference(http://hl7.org/fhir/StructureDefinition/Provenance)

Key differences from MedicationRequest Base Resource:

  • Removed the following elements from the profile due to lack of available semantically equivalent CeRX fields across examined sites:

    • category, priority, encounter, supportingInformation, recorder, reasonReference, instantiatesCanonical, instantiatesUri, basedOn, authorReference, dosageInstruction sub-elements (additionalInstruction, patientInstruction, method

  • Flagged the following elements as "Must Support":

    • status, intent, medication, subject, authoredOn, requester, dosageInstruction, dosageInstruction.text, dispenseRequest, dispenseRequest.numberOfRepeatsAllowed, dispenseRequest.quantity, dispenseRequest.expectedSupplyDuration

  • Changed the cardinality of the following elements:

    • N/A - no cardinality changes

SME Note 1:

While there was a desire to make authoredOn, requester, dosageInstruction.sequence, and dispenseRequest elements with 1..1 cardinality, the semantically equivalent data points had a CeRX conformance strength of required (meaning null values could be present).

Reviews with a pharmacy SME confirmed that the CeRX conformance strength is due to those values not always being known at the time of the message creation, particularly in the cases of inferred prescriptions:

  • combinedMedicationRequest/author/time
  • combinedMedicationRequest/author/assignedPerson/id
  • combinedMedicationRequest/fulfillment3/supplyEventFirstSummary
  • combinedMedicationRequest/component3/supplyRequest

SME Note 2:

Implementors must be aware of the complex nature of mapping multiple FHIR dosageInstruction elements (0..*) to the CeRX equivalents for dosageInstruction.text and dosageInstruction structured sub-elements (timing, site, route, etc).

In CeRX, DosageInstruction.sequence is considered a mandatory field but is linked to the structured dosage lines. If there are multiple dosage instruction texts present for a prescription, those are separated at the Component1 level and do not have an equivalent sequence number that can be mapped.

Simplified CeRX Diagram Showing Relationships between Components, DosageInstructions, and DosageLines:

Simplified CeRX MedRequest DosageInstruction Relationships

Key differences from ACCESS MedicationRequest Patient Profile:

Must Support Differences

  • dispenseRequest.expectedSupplyDuration is flagged as a Must Support element in the clinician profile but is an optional element in the Patient Profile
    • expectedSupplyDuration is likely to support clinician workflows but unlikely to add immediate value to patients that already have information on quantity, repeats, expiration, etc.

Cardinality Constraint Differences N/A - no cardinality differences between the patient and clinician profile

Data Type Constraint Differences N/A - no data type differences between the patient and clinician profile

Binding Differences N/A - no binding differences between the patient and clinician profile

Key differences from US Core MedicationRequest R4 Profile:

The ACCESS MedicationRequest (Clinician) Profile and US Core MedicationRequest profiles are fairly similar. Semantic mappings from source data (CeRX messages) were both rich and available which resulted in the ACCESS profiles including many more optional FHIR fields than other profiles (e.g. MedicationStatement).

Differences between the two profiles are due to the natural constraints/variances from the anticipated data sources: CeRX Medication Prescription Detail Query Response (PORX_IN060260CA) & inferred from Record Dispense Processing Request (PORX_IN020190CA).

Differences between the two profiles are as follows:

Must Support Differences

  • intent is flagged as Must Support for the ACCESS profile, but not the US Core profile
    • There isn't a 1:1 conversion between the values in CeRX and the values in the required MedicationRequest Intent value set
    • This profile assumes that the FHIR resources generated from CeRX messages by Canadian Drug Information Systems that should be able to differentiate between whether the CeRX message type represents:
      • an order (a request/demand and authorization for action),
      • a plan(an intention to ensure something occurs without providing an authorization for others to act),
      • or a proposal (a suggestion made by someone/something that doesn't have an intention to ensure it occurs and without providing an authorization to act).
  • dispenseRequest (and some of its sub-elements) are flagged as Must Support for the ACCESS profile, but not US Core. Through reviews with SMEs, the importance of remaining fill information (that is part of the dispenseRequest) is both available given the source data (CeRX messages) and critical to both clinicians and patients.

Cardinality Constraint Differences

  • US Core creates a lower cardinality constraint (1..1) on the authoredOn element and the requester element, which the ACCESS profiles do not inherit. Because at least one jurisdiction (New Brunswick) does not support Medication Request CeRX messages (prescription information has to be inferred from Medication Dispense CeRX messages), an authoredOn date and requesting practitioner is not guaranteed for every MedicationRequest that is transformed from CeRX source messages.

Data Type Constraint Differences

  • US Core references its own profiles (Medication, Patient, Practitioner), while the ACCESS profile references the CA Core Profiles

Binding Differences