minimal Common Oncology Data Elements (mCODE) Implementation Guide
4.0.0-ballot - STU4 Ballot United States of America flag

minimal Common Oncology Data Elements (mCODE) Implementation Guide, published by HL7 International / Clinical Interoperability Council. This guide is not an authorized publication; it is the continuous build for version 4.0.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-mCODE-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Cancer-Related Medication Request Profile

Official URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-cancer-related-medication-request Version: 4.0.0-ballot
Active as of 2024-10-30 Maturity Level: 3 Computable Name: CancerRelatedMedicationRequest
Other Identifiers: OID:2.16.840.1.113883.4.642.40.15.42.9

A record of a medication prescription or consumption associated with cancer treatment. The medication may reported by the prescriber, prescribing organization, or patient. It does not have to be directly observed.

Conformance

MedicationRequest resources associated with an in-scope patient and associated with cancer treatment SHALL conform to this profile. Beyond this requirement, a producer of resources SHOULD ensure that any resource instance associated with an in-scope patient that would reasonably be expected to conform to this profile (i.e., a prescription, administration, or medication exposure) SHOULD be published in this form.

Usage:

Changes since version true:

  • No changes
  • Formal Views of Profile Content

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

    This structure is derived from USCoreMedicationRequestProfile

    Terminology Bindings (Differential)

    PathConformanceValueSetURI
    MedicationRequest.statusReasonpreferredTreatmentTerminationReasonVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-treatment-termination-reason-vs
    from this IG
    MedicationRequest.reasonCodeextensibleCancerDisorderVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
    from this IG

    Constraints

    IdGradePath(s)DetailsRequirements
    mcode-reason-requiredwarningMedicationRequestOne of reasonCode or reasonReference SHALL be present
    : reasonCode.exists() or reasonReference.exists()
    termination-reason-code-invarianterrorMedicationRequestWhen status is stopped, only certain statusReason values are allowed
    : status = 'stopped' and statusReason.exists() and statusReason.coding.exists() implies statusReason.coding.exists(system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006'))
    termination-reason-invarianterrorMedicationRequestCertain statusReason values are allowed only when status is stopped
    : statusReason.exists() and statusReason.coding.exists( system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006')) implies status = 'stopped'

    Terminology Bindings

    PathConformanceValueSetURI
    MedicationRequest.statusrequiredmedicationrequest Status
    http://hl7.org/fhir/ValueSet/medicationrequest-status
    from the FHIR Standard
    MedicationRequest.statusReasonpreferredTreatmentTerminationReasonVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-treatment-termination-reason-vs
    from this IG
    MedicationRequest.intentrequiredmedicationRequest Intent
    http://hl7.org/fhir/ValueSet/medicationrequest-intent
    from the FHIR Standard
    MedicationRequest.categoryexamplemedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.category:us-corerequiredmedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.medication[x]extensibleMedicationClinicalDrug .
    http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4
    MedicationRequest.reasonCodeextensibleCancerDisorderVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
    from this IG
    MedicationRequest.dosageInstruction.doseAndRate.dose[x]preferredCommon UCUM units
    Additional Bindings Purpose
    UCUMCodes Max Binding
    http://hl7.org/fhir/ValueSet/ucum-common
    from the FHIR Standard

    Constraints

    IdGradePath(s)DetailsRequirements
    mcode-reason-requiredwarningMedicationRequestOne of reasonCode or reasonReference SHALL be present
    : reasonCode.exists() or reasonReference.exists()
    termination-reason-code-invarianterrorMedicationRequestWhen status is stopped, only certain statusReason values are allowed
    : status = 'stopped' and statusReason.exists() and statusReason.coding.exists() implies statusReason.coding.exists(system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006'))
    termination-reason-invarianterrorMedicationRequestCertain statusReason values are allowed only when status is stopped
    : statusReason.exists() and statusReason.coding.exists( system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006')) implies status = 'stopped'

    Terminology Bindings

    PathConformanceValueSetURI
    MedicationRequest.languagepreferredCommonLanguages
    Additional Bindings Purpose
    AllLanguages Max Binding
    http://hl7.org/fhir/ValueSet/languages
    from the FHIR Standard
    MedicationRequest.statusrequiredmedicationrequest Status
    http://hl7.org/fhir/ValueSet/medicationrequest-status
    from the FHIR Standard
    MedicationRequest.statusReasonpreferredTreatmentTerminationReasonVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-treatment-termination-reason-vs
    from this IG
    MedicationRequest.intentrequiredmedicationRequest Intent
    http://hl7.org/fhir/ValueSet/medicationrequest-intent
    from the FHIR Standard
    MedicationRequest.categoryexamplemedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.category:us-corerequiredmedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.priorityrequiredRequestPriority
    http://hl7.org/fhir/ValueSet/request-priority|4.0.1
    from the FHIR Standard
    MedicationRequest.medication[x]extensibleMedicationClinicalDrug .
    http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4
    MedicationRequest.performerTypeexampleProcedurePerformerRoleCodes
    http://hl7.org/fhir/ValueSet/performer-role
    from the FHIR Standard
    MedicationRequest.reasonCodeextensibleCancerDisorderVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
    from this IG
    MedicationRequest.courseOfTherapyTypeexamplemedicationRequest Course of Therapy Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-course-of-therapy
    from the FHIR Standard
    MedicationRequest.dosageInstruction.additionalInstructionexampleSNOMEDCTAdditionalDosageInstructions
    http://hl7.org/fhir/ValueSet/additional-instruction-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.asNeeded[x]exampleSNOMEDCTMedicationAsNeededReasonCodes
    http://hl7.org/fhir/ValueSet/medication-as-needed-reason
    from the FHIR Standard
    MedicationRequest.dosageInstruction.siteexampleSNOMEDCTAnatomicalStructureForAdministrationSiteCodes
    http://hl7.org/fhir/ValueSet/approach-site-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.routeexampleSNOMEDCTRouteCodes
    http://hl7.org/fhir/ValueSet/route-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.methodexampleSNOMEDCTAdministrationMethodCodes
    http://hl7.org/fhir/ValueSet/administration-method-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.doseAndRate.typeexampleDoseAndRateType
    http://hl7.org/fhir/ValueSet/dose-rate-type
    from the FHIR Standard
    MedicationRequest.dosageInstruction.doseAndRate.dose[x]preferredCommon UCUM units
    Additional Bindings Purpose
    UCUMCodes Max Binding
    http://hl7.org/fhir/ValueSet/ucum-common
    from the FHIR Standard
    MedicationRequest.substitution.allowed[x]exampleActSubstanceAdminSubstitutionCode
    http://terminology.hl7.org/ValueSet/v3-ActSubstanceAdminSubstitutionCode
    MedicationRequest.substitution.reasonexampleSubstanceAdminSubstitutionReason
    http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason

    Constraints

    IdGradePath(s)DetailsRequirements
    mcode-reason-requiredwarningMedicationRequestOne of reasonCode or reasonReference SHALL be present
    : reasonCode.exists() or reasonReference.exists()
    termination-reason-code-invarianterrorMedicationRequestWhen status is stopped, only certain statusReason values are allowed
    : status = 'stopped' and statusReason.exists() and statusReason.coding.exists() implies statusReason.coding.exists(system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006'))
    termination-reason-invarianterrorMedicationRequestCertain statusReason values are allowed only when status is stopped
    : statusReason.exists() and statusReason.coding.exists( system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006')) implies status = 'stopped'

    Differential View

    This structure is derived from USCoreMedicationRequestProfile

    Terminology Bindings (Differential)

    PathConformanceValueSetURI
    MedicationRequest.statusReasonpreferredTreatmentTerminationReasonVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-treatment-termination-reason-vs
    from this IG
    MedicationRequest.reasonCodeextensibleCancerDisorderVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
    from this IG

    Constraints

    IdGradePath(s)DetailsRequirements
    mcode-reason-requiredwarningMedicationRequestOne of reasonCode or reasonReference SHALL be present
    : reasonCode.exists() or reasonReference.exists()
    termination-reason-code-invarianterrorMedicationRequestWhen status is stopped, only certain statusReason values are allowed
    : status = 'stopped' and statusReason.exists() and statusReason.coding.exists() implies statusReason.coding.exists(system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006'))
    termination-reason-invarianterrorMedicationRequestCertain statusReason values are allowed only when status is stopped
    : statusReason.exists() and statusReason.coding.exists( system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006')) implies status = 'stopped'

    Key Elements View

    Terminology Bindings

    PathConformanceValueSetURI
    MedicationRequest.statusrequiredmedicationrequest Status
    http://hl7.org/fhir/ValueSet/medicationrequest-status
    from the FHIR Standard
    MedicationRequest.statusReasonpreferredTreatmentTerminationReasonVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-treatment-termination-reason-vs
    from this IG
    MedicationRequest.intentrequiredmedicationRequest Intent
    http://hl7.org/fhir/ValueSet/medicationrequest-intent
    from the FHIR Standard
    MedicationRequest.categoryexamplemedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.category:us-corerequiredmedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.medication[x]extensibleMedicationClinicalDrug .
    http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4
    MedicationRequest.reasonCodeextensibleCancerDisorderVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
    from this IG
    MedicationRequest.dosageInstruction.doseAndRate.dose[x]preferredCommon UCUM units
    Additional Bindings Purpose
    UCUMCodes Max Binding
    http://hl7.org/fhir/ValueSet/ucum-common
    from the FHIR Standard

    Constraints

    IdGradePath(s)DetailsRequirements
    mcode-reason-requiredwarningMedicationRequestOne of reasonCode or reasonReference SHALL be present
    : reasonCode.exists() or reasonReference.exists()
    termination-reason-code-invarianterrorMedicationRequestWhen status is stopped, only certain statusReason values are allowed
    : status = 'stopped' and statusReason.exists() and statusReason.coding.exists() implies statusReason.coding.exists(system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006'))
    termination-reason-invarianterrorMedicationRequestCertain statusReason values are allowed only when status is stopped
    : statusReason.exists() and statusReason.coding.exists( system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006')) implies status = 'stopped'

    Snapshot View

    Terminology Bindings

    PathConformanceValueSetURI
    MedicationRequest.languagepreferredCommonLanguages
    Additional Bindings Purpose
    AllLanguages Max Binding
    http://hl7.org/fhir/ValueSet/languages
    from the FHIR Standard
    MedicationRequest.statusrequiredmedicationrequest Status
    http://hl7.org/fhir/ValueSet/medicationrequest-status
    from the FHIR Standard
    MedicationRequest.statusReasonpreferredTreatmentTerminationReasonVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-treatment-termination-reason-vs
    from this IG
    MedicationRequest.intentrequiredmedicationRequest Intent
    http://hl7.org/fhir/ValueSet/medicationrequest-intent
    from the FHIR Standard
    MedicationRequest.categoryexamplemedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.category:us-corerequiredmedicationRequest Category Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-category
    from the FHIR Standard
    MedicationRequest.priorityrequiredRequestPriority
    http://hl7.org/fhir/ValueSet/request-priority|4.0.1
    from the FHIR Standard
    MedicationRequest.medication[x]extensibleMedicationClinicalDrug .
    http://cts.nlm.nih.gov/fhir/ValueSet/2.16.840.1.113762.1.4.1010.4
    MedicationRequest.performerTypeexampleProcedurePerformerRoleCodes
    http://hl7.org/fhir/ValueSet/performer-role
    from the FHIR Standard
    MedicationRequest.reasonCodeextensibleCancerDisorderVS
    http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
    from this IG
    MedicationRequest.courseOfTherapyTypeexamplemedicationRequest Course of Therapy Codes
    http://hl7.org/fhir/ValueSet/medicationrequest-course-of-therapy
    from the FHIR Standard
    MedicationRequest.dosageInstruction.additionalInstructionexampleSNOMEDCTAdditionalDosageInstructions
    http://hl7.org/fhir/ValueSet/additional-instruction-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.asNeeded[x]exampleSNOMEDCTMedicationAsNeededReasonCodes
    http://hl7.org/fhir/ValueSet/medication-as-needed-reason
    from the FHIR Standard
    MedicationRequest.dosageInstruction.siteexampleSNOMEDCTAnatomicalStructureForAdministrationSiteCodes
    http://hl7.org/fhir/ValueSet/approach-site-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.routeexampleSNOMEDCTRouteCodes
    http://hl7.org/fhir/ValueSet/route-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.methodexampleSNOMEDCTAdministrationMethodCodes
    http://hl7.org/fhir/ValueSet/administration-method-codes
    from the FHIR Standard
    MedicationRequest.dosageInstruction.doseAndRate.typeexampleDoseAndRateType
    http://hl7.org/fhir/ValueSet/dose-rate-type
    from the FHIR Standard
    MedicationRequest.dosageInstruction.doseAndRate.dose[x]preferredCommon UCUM units
    Additional Bindings Purpose
    UCUMCodes Max Binding
    http://hl7.org/fhir/ValueSet/ucum-common
    from the FHIR Standard
    MedicationRequest.substitution.allowed[x]exampleActSubstanceAdminSubstitutionCode
    http://terminology.hl7.org/ValueSet/v3-ActSubstanceAdminSubstitutionCode
    MedicationRequest.substitution.reasonexampleSubstanceAdminSubstitutionReason
    http://terminology.hl7.org/ValueSet/v3-SubstanceAdminSubstitutionReason

    Constraints

    IdGradePath(s)DetailsRequirements
    mcode-reason-requiredwarningMedicationRequestOne of reasonCode or reasonReference SHALL be present
    : reasonCode.exists() or reasonReference.exists()
    termination-reason-code-invarianterrorMedicationRequestWhen status is stopped, only certain statusReason values are allowed
    : status = 'stopped' and statusReason.exists() and statusReason.coding.exists() implies statusReason.coding.exists(system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006'))
    termination-reason-invarianterrorMedicationRequestCertain statusReason values are allowed only when status is stopped
    : statusReason.exists() and statusReason.coding.exists( system = 'http://snomed.info/sct' and (code = '182992009' or code = '266721009' or code = '407563006' or code = '160932005' or code = '105480006' or code = '184081006' or code = '309846006' or code = '399307001' or code = '419620001' or code = '7058009' or code = '443729008' or code = '77386006')) implies status = 'stopped'

     

    Other representations of profile: CSV, Excel, Schematron