Id: OpioidCDSRoutines Url: Library - OpioidCDS Routines Version: 2022.1.0 Name: OpioidCDSRoutines Title: Library - OpioidCDS Routines Status: active Experimental: true Type: system: http://terminology.hl7.org/CodeSystem/library-type code: logic-library Date: 2026-01-27 18:30:23+0000 Publisher: Centers for Disease Control and Prevention (CDC) Related Artifacts: Dependencies http://fhir.org/guides/cqf/common/Library/FHIR-ModelInfo|4.0.1 FHIR Helpersversion: null4.0.1) Library - OpioidCDS Commonversion: null2022.1.0) Library - OpioidCDS Common Configurationversion: null2022.1.0) Parameters: Name Type Min Max In/Out Patient Patient 0 1 Out Palliative Care Lookback Period Period 0 1 Out Patient Age Less Than 18 boolean 0 1 Out Condition Positive for Sickle Cell boolean 0 1 Out Encounter Period Period 0 1 Out Encounters with Cancer Diagnosis During Encounter Period Encounter 0 * Out Number of Encounters with Cancer Diagnosis During Encounter Period integer 0 1 Out Has Two or More Encounters with Cancer Diagnosis During Encounter Period boolean 0 1 Out Has Active Cancer Diagnosis on Problem List boolean 0 1 Out Is Active Cancer Treatment? boolean 0 1 Out Conditions Likely Terminal for Opioid Prescribing boolean 0 1 Out CDC 2022 Guideline General Inclusion Criteria boolean 0 1 Out Prescription/Dispense Inclusion Period Period 0 1 Out Report Inclusion Period Period 0 1 Out Opioid RX with Ambulatory Abuse Potential In Past 90 Days MedicationRequest 0 * Out Has Opioid RX with Ambulatory Abuse Potential In Past 90 Days boolean 0 1 Out Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days MedicationDispense 0 * Out Has Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days boolean 0 1 Out Is Opioid Naive? boolean 0 1 Out Data Requirements: Type Profile MS Code Filter Patient http://hl7.org/fhir/StructureDefinition/Patient Encounter http://hl7.org/fhir/StructureDefinition/Encounter ;;; MedicationDispense http://hl7.org/fhir/StructureDefinition/MedicationDispense ;;; code filter: path: medication value set: http://fhir.org/guides/cdc/opioid-cds/ValueSet/opioid-analgesics-with-ambulatory-misuse-potential MedicationDispense http://hl7.org/fhir/StructureDefinition/MedicationDispense ;;; Medication http://hl7.org/fhir/StructureDefinition/Medication ;; Content: text/cql library OpioidCDSRoutines version '2022.1.0' using FHIR version '4.0.1' include FHIRHelpers version '4.0.1' called FHIRHelpers include OpioidCDSCommon version '2022.1.0' called Common include OpioidCDSCommonConfig version '2022.1.0' called Config context Patient /* ** Routine #1 ** CDC 2022 General Inclusion Criteria Routine ** ** Definition | Answer to Proceed | Details | Data (Terminology) Requirement ** ------------------------------------------------------------------------------------------------------------------------------------ ** Age < 18 years? | No | Calculate age from date of birth; exclude | Date of birth ** | | patients with age less than 18 years at the | ** | | time of the prescription | ** ------------------------------------------------------------------------------------------------------------------------------------ ** Evidence of | No | Look for documented findings consistent | Sickle cell disease conditions ** sickle cell disease? | | with those listed in the sickle cell | ** | | value set | ** ------------------------------------------------------------------------------------------------------------------------------------ ** Active cancer | No | See sub-routine 3 | See sub-routine 3 ** treatment? | | | ** ------------------------------------------------------------------------------------------------------------------------------------ ** Conditions Likely | No | Look for patients with active conditions in | Conditions likely terminal for opioid ** Terminal for opioid | | the value set end-of-life-conditions | prescribing ** prescribing present? | | | ** ------------------------------------------------------------------------------------------------------------------------------------ ** */ define "Palliative Care Lookback Period": Interval[Today() - 90 days, Today()] define "CDC 2022 Guideline General Inclusion Criteria": not "Patient Age Less Than 18" and not "Condition Positive for Sickle Cell" and not "Is Active Cancer Treatment?" and not "Conditions Likely Terminal for Opioid Prescribing" define "Patient Age Less Than 18": if (Config."Age Less than 18 Years Is Enabled") then AgeInYearsAt(Today()) < 18 else false define "Condition Positive for Sickle Cell": if (Config."Sickle Cell Check Enabled") then exists( Common."Positive Sickle Cell Condition" ) else false define "Conditions Likely Terminal for Opioid Prescribing": if (Config."End-Stage Disease Criteria Enabled") then exists ( Common."US Core-Categorized Conditions" EOLC where EOLC.code in Common."Conditions likely terminal for opioid prescribing" // and EOLC.clinicalStatus in Common."Active Condition" ) else false // End of CDC 2022 General Inclusion Criteria Routine /* ** Routine #2 ** Opioid Naive Routine ** ** Definition | Answer to Proceed | Details | Data (Terminology) Requirement ** ---------------------------------------------------------------------------------------------------------------------------------------- ** Opioid analgesics with | No | Look for an existing prescription (order) for | Opioid analgesics with ** ambulatory misuse potential | | opioid that is in the value set for opioid with | ambulatory misuse potential ** prescription in past 90 days | | ambulatory abuse potential authored | ** excluding the previous 24 | | within the past 90 days (excluding previous 24 | ** hours | | hours) | ** ---------------------------------------------------------------------------------------------------------------------------------------- ** Opioid analgesics with | No | Look for evidence of active medication on | Opioid analgesics with ** ambulatory misuse potential | | the medication list that is in the value set | ambulatory misuse potential ** reported in past 90 days | | for opioid with ambulatory care abuse | ** excluding previous 24 hours* | | potential | ** ---------------------------------------------------------------------------------------------------------------------------------------- ** Opioid analgesics with | No | Look for evidence of a dispensing event for | Opioid analgesics with ** ambulatory misuse potential | | medication that is in the value set for opioid | ambulatory misuse potential ** dispensing event in past 90 | | with ambulatory use potential occurring | ** days excluding previous 24 | | within the past 90 days (excluding previous 24 | ** hours | | hours) | ** ---------------------------------------------------------------------------------------------------------------------------------------- ** *Future consideration: Current algorithm addresses only orders (prescriptions). ** ** Note – orders use RxNorm, but medication lists and dispensed medication will ** require an NDC value set and/or local mapping of NDC to RxNorm to enable this element ** */ define "Prescription/Dispense Inclusion Period": Interval[Now() - 90 days, Now() - 24 hours] define "Report Inclusion Period": Interval[Now() - 90 days, Now() - 24 hours) // NOTE: MedicationStatement-dependent logic comment out due to bug in Publisher not supporting MedicationStatement in AllTypes. define "Is Opioid Naive?": not ("Has Opioid RX with Ambulatory Abuse Potential In Past 90 Days") /* and not ("Has Report of Opioid with Ambulatory Care Abuse Potential Reported in Past 90 Days") */ and not ("Has Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days") define "Opioid RX with Ambulatory Abuse Potential In Past 90 Days": Common."Active Ambulatory Opioid Rx" Rx where Rx.authoredOn during day of "Prescription/Dispense Inclusion Period" define "Has Opioid RX with Ambulatory Abuse Potential In Past 90 Days": if (Config."Opioid Naive Prescription Condition Is Enabled") then exists ("Opioid RX with Ambulatory Abuse Potential In Past 90 Days") else false // NOTE: 2020-02-05: Review direction of MedicationStatement resource (US-Core focusing on MedicationRequest i/o Statement) // NOTE: 2020-04-21: MedicationStatement a) Shouldn't be use since guidance/direction from USCore is targeting MedicationUse in R5, and b) Breaks in the publisher /* define "Reports of Opioid with Ambulatory Care Abuse Potential Reported in Past 90 Days": [MedicationStatement: Common."Opioid analgesics with ambulatory misuse potential"] Statement where Statement.status in {'active', 'completed'} and Statement.effective during day of "Report Inclusion Period" */ /* define "Has Report of Opioid with Ambulatory Care Abuse Potential Reported in Past 90 Days": Config."Opioid Naive Report Condition Is Enabled" and exists ("Reports of Opioid with Ambulatory Care Abuse Potential Reported in Past 90 Days") */ define "Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days": [MedicationDispense: Common."Opioid analgesics with ambulatory misuse potential"] OpioidDispense where OpioidDispense.whenHandedOver during day of "Prescription/Dispense Inclusion Period" and OpioidDispense.status = 'completed' define "Has Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days": if (Config."Opioid Naive Prescription Condition Is Enabled") then exists ("Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days") else false // End of Opioid Naive Routine /* ** Routine #3 ** Active Cancer Treatment Routine ** ** Definition | Answer to Proceed | Details | Data (Terminology) Requirement ** --------------------------------------------------------------------------------------------------------------------------------- ** Two office visits within the | No | Look for a minimum of two distinct | Office Visit ** past 12 months | | encounters within 12 months of the date | ** | | of the current visit for which each of the | ** | | following is true: | ** | | - the encounter diagnosis (primary or | ** | | secondary or co-morbidity diagnosis) | ** | | is listed in the CDC Malignant Cancer | ** | | Conditions value set | ** --------------------------------------------------------------------------------------------------------------------------------- ** Office visits with an | No | The encounter is performed by an | Oncology specialty ** oncology specialist | | oncologist as defined in the oncology | designations (NUCC) ** present | | specialty designations using the | ** | | National Uniform Claim Committee | ** | | (NUCC) classifications | ** --------------------------------------------------------------------------------------------------------------------------------- ** Office visits including CDC | No | The encounter diagnosis (primary or | CDC malignant cancer ** malignant cancer | | secondary or co-morbidity diagnosis) | conditions ** condition | | is listed in the CDC Malignant Cancer | ** | | Conditions value set | ** ---------------------------------------------------------------------------------------------------------------------------------- ** */ define "Encounter Period": Interval[Today() - 12 months, Today()) define "Is Active Cancer Treatment?": if (Config."Active Cancer Treatment Encounters Condition Is Enabled") then "Has Two or More Encounters with Cancer Diagnosis During Encounter Period" or "Has Active Cancer Diagnosis on Problem List" else false // encounter-diagnosis, problem-list and health-concern Conditions // define "US Core-Categorized Cancer Diagnoses": // Common."US Core-Categorized Conditions" C // where C.code in Common."CDC malignant cancer conditions" // define "Encounters with Cancer Diagnosis During Encounter Period": // [Encounter] Encounter // with "US Core-Categorized Cancer Diagnoses" CancerDiagnosis // such that date from Encounter.period."start".value in day of "Encounter Period" // and EndsWith(CancerDiagnosis.encounter.reference, Encounter.id) define "Encounters with Cancer Diagnosis During Encounter Period": [Encounter] Encounters where date from Encounters.period."start" in day of "Encounter Period" and exists ( Common."USCore Encounter Cancer Diagnoses" CancerDiagnoses where EndsWith(CancerDiagnoses.encounter.reference, Encounters.id) ) define "Number of Encounters with Cancer Diagnosis During Encounter Period": Count ("Encounters with Cancer Diagnosis During Encounter Period") define "Has Two or More Encounters with Cancer Diagnosis During Encounter Period": "Number of Encounters with Cancer Diagnosis During Encounter Period" >= 2 define "Has Active Cancer Diagnosis on Problem List": exists ( Common."USCore Problem List Cancer Diagnoses" CancerDiagnoses where CancerDiagnoses.category in Common."Problem List Condition Category" and exists( CancerDiagnoses.clinicalStatus.coding ClinicalStatus where ClinicalStatus.code ~ 'active' ) ) // End of Active Cancer Treatment Routine /* ** Routine #4 ** For Subacute or Chronic Pain Routine ** ** Definition | Answer to Proceed | Details | Data (Terminology) Requirement ** ----------------------------------------------------------------------------------------------------------------------------------- ** Order for opioid analgesic | Yes | Order for opioid analgesics with ambulatory | Opioid analgesics with ** with expected supply | | misuse potential with a supply duration of >= | ambulatory misuse potential ** duration >= 28 days | | 28 days | ** | | | ** | | - Subacute definition = order for opioid | ** | | analgesics with ambulatory misuse | ** | | potential with a supply duration of one to | ** | | two months. | ** | | - Chronic pain definition = order for opioid | ** | | analgesics with ambulatory misuse | ** | | potential with a supply duration of >= two | ** | | months. | ** ----------------------------------------------------------------------------------------------------------------------------------- ** */ define function "Is Subacute or Chronic Pain Prescription?"(prescription FHIR.MedicationRequest): "Is Subacute or Chronic Pain Using Expected Supply Duration"(prescription) or "Is Subacute or Chronic Pain Using Validity Period"(prescription) define function "Is Subacute or Chronic Pain Using Expected Supply Duration"(prescription FHIR.MedicationRequest): ( prescription.dispenseRequest is not null and prescription.dispenseRequest.expectedSupplyDuration is not null and ( Common.GetDurationInDays(prescription.dispenseRequest.expectedSupplyDuration) >= 28 days ) ) define function "Is Subacute or Chronic Pain Using Validity Period"(prescription FHIR.MedicationRequest): ( prescription.dispenseRequest is not null and prescription.dispenseRequest.validityPeriod is not null and ( days between prescription.dispenseRequest.validityPeriod.start and prescription.dispenseRequest.validityPeriod.end >= 28 ) ) // End of For Subacute or Chronic Pain Routine /* ** Routine #5 ** For Acute Pain Routine ** ** Definition | Answer to Proceed | Details | Data (Terminology) Requirement ** ----------------------------------------------------------------------------------------------------------------------------------- ** Order for opioid analgesics | Yes | Look for an existing prescription (order) for | Opioid analgesics with ** with ambulatory misuse | | opioid analgesics with ambulatory abuse | ambulatory misuse potential ** potential of duration < 28 | | potential of duration < 28 days | ** days | | | ** ----------------------------------------------------------------------------------------------------------------------------------- ** */ // should allow DateTime precision, but not working in the Ruler specifically define function "Is Acute Pain Prescription?"(prescription FHIR.MedicationRequest): prescription.dispenseRequest is not null and prescription.dispenseRequest.expectedSupplyDuration is not null and Common.GetDurationInDays( prescription.dispenseRequest.expectedSupplyDuration ) < 28 days // should allow DateTime precision, but not working in the Ruler specifically define function "Acute Pain Prescription Greater Than 7 Days?"(prescription FHIR.MedicationRequest): prescription.dispenseRequest is not null and prescription.dispenseRequest.expectedSupplyDuration is not null and Common.GetDurationInDays( prescription.dispenseRequest.expectedSupplyDuration ) > 7 days and Common.GetDurationInDays( prescription.dispenseRequest.expectedSupplyDuration ) < 28 days // End of For Acute Pain Routine // TODO: Include logic for dispensing and patient-reported events Content: application/elm+xml Encoded data (140156 characters) Content: application/elm+json Encoded data (246800 characters)
Centers for Disease Control and Prevention (CDC)
Encounters with Cancer Diagnosis During Encounter Period
Number of Encounters with Cancer Diagnosis During Encounter Period
Has Two or More Encounters with Cancer Diagnosis During Encounter Period
Has Active Cancer Diagnosis on Problem List
Conditions Likely Terminal for Opioid Prescribing
CDC 2022 Guideline General Inclusion Criteria
Opioid RX with Ambulatory Abuse Potential In Past 90 Days
Has Opioid RX with Ambulatory Abuse Potential In Past 90 Days
Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days
Has Opioid Dispense with Ambulatory Abuse Potential In Past 90 Days