MOPA — Medical Oncology Prior Authorization - Local Development build (v0.1.1-snapshot-080926) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Page standards status: Informative |
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
| Oncology CRD Client Capability Statement |
Capability Statement for systems acting as an Oncology CRD Client (e.g., an EHR or oncology ordering system). A conformant client claims support for the Da Vinci CRD oncology profile defined in this IG by meeting the requirements below. |
| Oncology CRD Service Capability Statement |
Capability Statement for systems acting as an Oncology CRD Service (e.g., a payer or prior-authorization platform). A conformant service claims support for the Da Vinci CRD oncology profile defined in this IG by meeting the requirements below. |
These define constraints on FHIR resources for systems conforming to this implementation guide.
| Anti-Cancer Regimen PlanDefinition |
A canonical, reusable anti-cancer therapy regimen definition represented as a FHIR PlanDefinition order set. This resource is NOT patient-specific; it is referenced by AntiCancerRegimenRequestGroup instances via RequestGroup.instantiatesCanonical. A regimen definition describes the protocol — component drugs, timing, cycle structure, and sequential phase ordering. Treatment intent and line of therapy are patient-specific ordering categories and are carried on the RequestGroup via the category extension; this canonical definition does not carry those attributes. mCODE Migration Candidate — This profile is proposed for inclusion in mCODE STU5. It addresses the gap documented in the mCODE gap analysis: mCODE does not currently represent anti-cancer regimens as first-class, computable entities. |
| Anti-Cancer Regimen RequestGroup |
A patient-specific ordered anti-cancer therapy regimen instance. This resource is included in the CDS Hooks draftOrders Bundle and referenced in context.selections at order-select and order-sign. CDS Hooks Context. This profile is designed for use in the Da Vinci CRD workflow.
The Two-Stage Hook Pattern. The MOPA workflow uses
CRD Order Profile Proposal. This profile serves as the domain-specific layer for
oncology regimens. A complementary CRD order profile for RequestGroup.instantiatesCanonical SHALL be populated with the canonical URL of the AntiCancerRegimenPlanDefinition when the canonical regimen definition is known. Two scheduling patterns are supported in regimen actions:
mCODE Migration Candidate — This profile is proposed for inclusion in mCODE STU5. It is the MVP artifact for oncology prior authorization: the selected clinical unit passed to the CRD service. |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| Data Requirement Label |
A human-readable label that identifies a DataRequirement entry within an OncologyDataRequirementsLibrary. Used by tools such as DTR questionnaire generators and CRD content viewers to display requirement names without parsing profile URLs. The first DataRequirement entry in every condition-specific Library (the primary cancer condition) SHALL carry a label of the canonical form '[Cancer Type] Diagnosis' (e.g., 'Breast Cancer Diagnosis') to make the diagnostic prerequisite explicit and machine-discoverable. mCODE Migration Candidate — Proposed for inclusion in mCODE STU5. |
| Line of Therapy Request Category |
Constrains the Da Vinci CRD Request Category extension for a
patient-specific anti-cancer regimen line-of-therapy category. The instance extension URL
remains mCODE Migration Candidate — This constraint profile and its terminology semantics are proposed for inclusion in mCODE STU5; the underlying extension remains owned by Da Vinci CRD. |
| Regimen Days of Cycle |
Specifies the days within a repeating treatment cycle on which a
regimen action is to be performed. Semantically identical to the HL7 core extension
timing-daysOfCycle,
but with context broadened to The cycle length is expressed via This extension is a migration candidate for inclusion in the HL7 FHIR Extensions pack with an expanded context. See regimen-model.html. |
| Treatment Intent Request Category |
Constrains the Da Vinci CRD Request Category extension for a
patient-specific anti-cancer regimen treatment-intent category. The instance extension URL
remains mCODE Migration Candidate — This constraint profile and its terminology semantics are proposed for inclusion in mCODE STU5; the underlying extension remains owned by Da Vinci CRD. |
These define sets of codes used by systems conforming to this implementation guide.
| Regimen Intent Value Set |
The clinical intent of an anti-cancer regimen. All codes are drawn from the SNOMED CT "Intents (nature of procedure values)" hierarchy (363675004). mCODE Migration Candidate — Proposed for mCODE STU5. |
| Treatment Line Value Set |
Codes representing the ordinal line of systemic anti-cancer therapy. Used by LineOfTherapyRequestCategory for the patient-specific RequestGroup category. mCODE Migration Candidate — Proposed for mCODE STU5. |
These define new code systems used by systems conforming to this implementation guide.
| MOPA Local Code System |
Local codes defined by the MOPA IG for concepts that do not yet have an established representation in LOINC, SNOMED CT, or mCODE. These codes are migration candidates and should be retired in favor of standard codes as they become available. |
| Treatment Line Code System |
Ordinal codes representing the line of systemic anti-cancer therapy.
These codes are used in TreatmentLineVS and in the LineOfTherapyRequestCategory constraint
profile for the RequestGroup mCODE Migration Candidate — These codes are proposed for adoption in mCODE STU5 or as a SNOMED CT extension request. Once standard codes are available, this code system should be deprecated. |
These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.
| Example Oncologist: Dr. Maria Lopez |
Fictional medical oncologist used across MOPA IG examples. |
| Example Patient: Jane Smith |
Fictional 57-year-old female patient used consistently across all MOPA IG examples. DO NOT use real patient data. |
| Example Regimen Definition: PHD (Pertuzumab + Trastuzumab + Docetaxel) |
Canonical definition of pertuzumab (840 mg loading, then 420 mg IV) plus trastuzumab (8 mg/kg loading, then 6 mg/kg IV) plus docetaxel (75 mg/m² IV), every 21 days, for metastatic HER2-positive breast cancer. Treatment intent and line of therapy are carried on the RequestGroup via the category extension. |
| Example Regimen Definition: TH (Paclitaxel + Trastuzumab, Weekly) |
Canonical definition of weekly Paclitaxel (80 mg/m² IV) plus Trastuzumab (4 mg/kg loading, then 2 mg/kg IV) for 12 weeks in HER2-positive early breast cancer. The canonical definition carries protocol structure only — treatment intent and line of therapy are patient-context and live on the RequestGroup. |
| Example Regimen Definition: ddAC→T (Dose-Dense AC then Paclitaxel) |
Canonical definition of dose-dense doxorubicin (60 mg/m²) plus cyclophosphamide (600 mg/m²) q14d × 4 cycles (AC phase), followed by paclitaxel (175 mg/m²) q14d × 4 cycles (T phase) for breast cancer. Demonstrates sequential phase ordering using action.relatedAction with relationship = after-end. |
| Example Regimen Order: PHD (Jane Smith, First-Line Metastatic HER2+) |
Patient-specific draft PHD regimen order for Jane Smith, first-line metastatic HER2+ breast cancer. Pertuzumab + Trastuzumab + Docetaxel q21d. Demonstrates palliative intent and first-line metastatic treatment setting. |
| Example Regimen Order: TH (Jane Smith, Adjuvant HER2+) — Typical |
Patient-specific draft ordered TH regimen for Jane Smith at order-select. instantiatesCanonical references RegimenTH. All Must Support elements populated. Demonstrates regimen-days-of-cycle (days 1, 8, 15 of a 21-day cycle) and is the primary reference example for AntiCancerRegimenRequestGroup. |
| Example Regimen Order: ddAC→T (Jane Smith, Adjuvant) — Sequential Phases |
Patient-specific draft ddAC→T order for Jane Smith. AC phase (doxorubicin + cyclophosphamide q14d x4) followed by T phase (paclitaxel q14d x4). Demonstrates sequential phase ordering with action.relatedAction relationship = after-end. |
| Example: CDS Hooks order-select draftOrders Bundle (TH regimen) |
Collection Bundle placed in context.draftOrders of an order-select CDS Hooks request. At order-select the RequestGroup is present but individual MedicationRequests are still draft and are not required. |
| Example: CDS Hooks order-sign draftOrders Bundle (TH regimen) |
Collection Bundle placed in context.draftOrders of an order-sign CDS Hooks request. At order-sign the RequestGroup plus all companion MedicationRequests are present. |
| Example: Cyclophosphamide MedicationRequest (ddAC→T regimen, draft) |
Draft MedicationRequest for cyclophosphamide 600 mg/m² IV in ddAC phase. |
| Example: Docetaxel MedicationRequest (PHD regimen, draft) |
Draft MedicationRequest for docetaxel 75 mg/m² IV q21d in PHD regimen. |
| Example: Doxorubicin MedicationRequest (ddAC→T regimen, draft) |
Draft MedicationRequest for doxorubicin 60 mg/m² IV in ddAC phase. |
| Example: Metastatic HER2+ Breast Cancer (Stage IV) |
Metastatic HER2-positive breast cancer with liver and bone involvement, newly diagnosed Stage IV (de novo). Used in PHD regimen examples. |
| Example: Paclitaxel MedicationRequest (T phase, ddAC→T regimen, draft) |
Draft MedicationRequest for paclitaxel 175 mg/m² IV q14d in T phase. |
| Example: Paclitaxel MedicationRequest (TH regimen, draft) |
Draft MedicationRequest for paclitaxel 80 mg/m² IV weekly in TH regimen. |
| Example: Pegfilgrastim MedicationRequest (ddAC→T regimen, draft) |
Draft MedicationRequest for pegfilgrastim 6 mg subcutaneous on day 2 of each ddAC cycle. |
| Example: Pertuzumab MedicationRequest (PHD regimen, draft) |
Draft MedicationRequest for pertuzumab IV q21d in PHD regimen. |
| Example: Primary HER2+ Breast Cancer (Stage IIB) |
Invasive ductal carcinoma of right breast, HER2-positive, Stage IIB (T2 N1 M0), diagnosed November 2025. Referenced by all MOPA examples depicting Jane Smith's adjuvant treatment course. |
| Example: Trastuzumab MedicationRequest (PHD regimen, draft) |
Draft MedicationRequest for trastuzumab IV q21d in PHD regimen. |
| Example: Trastuzumab MedicationRequest (TH regimen, draft) |
Draft MedicationRequest for trastuzumab IV weekly in TH regimen. |