minimal Common Oncology Data Elements (mCODE) Implementation Guide
2.1.0 - STU 2.1 United States of America flag

This page is part of the HL7 FHIR Implementation Guide: minimal Common Oncology Data Elements (mCODE) Release 1 - US Realm | STU1 (v2.1.0: STU 2) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: Secondary Cancer Condition Profile

Official URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-secondary-cancer-condition Version: 2.1.0
Active as of 2023-03-21 Computable Name: SecondaryCancerCondition

Records the history of secondary neoplasms, including location(s) and the date of onset of metastases. A secondary cancer results from the spread (metastasization) of cancer from its original site (Definition from: NCI Dictionary of Cancer Terms).

Usage

  • SNOMED CT coding: Use a code from the disorder hierarchy under secondary malignant neoplastic disease (SNOMED CT 128462008).
  • ICD-10-CM coding: Use one of the codes given in this value set representing secondary malignant neoplasms and neoplasms of uncertain or unspecified behavior. If body site is not precoordinated (implied by the code), it should be specified separately using the body location.

Note that ICD-O-3 specifies morphology and topography, not disorder; in this case that the disorder code must be SNOMED CT 128462008 (Secondary malignant neoplastic disease). The ICD-O-3 morphology and topography codes should be entered in the HistologyMorphologyBehavior and bodySite fields, respectively.

Conformance

Condition resources associated with an in-scope patient with a Condition.code in the value set SecondaryCancerDisorderVS MUST conform to this profile. Beyond this requirement, a producer of resources SHOULD ensure that any resource instance associated with an mCODE patient that would reasonably be expected to conform to this profile SHOULD be published in this form, for example, when employing a code that extends the SecondaryCancerDisorderVS value set. Any resource intended to conform to this profile SHOULD populate meta.profile accordingly.

Usage:

Formal Views of Profile Content

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

This structure is derived from USCoreCondition

NameFlagsCard.TypeDescription & Constraintsdoco
.. Condition 0..*USCoreConditionDetailed information about conditions, problems or diagnoses
... Slices for extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... assertedDate S0..1dateTimeDate the condition was first asserted
URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
... histologyMorphologyBehavior S0..1CodeableConceptHistology-Morphology-Behavior Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-histology-morphology-behavior
Binding: Histology Morphology Behavior Value Set (extensible)
.... value[x] 1..1Reference(Primary Cancer Condition Profile)Value of extension
... code 1..1CodeableConceptIdentification of the condition, problem or diagnosis
Binding: Secondary Cancer Disorder Value Set (extensible)
... bodySite S0..*CodeableConceptAnatomical location, if relevant
Binding: Cancer Body Location Value Set (extensible)
.... locationQualifier S0..*CodeableConceptBody Location Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
.... lateralityQualifier S0..1CodeableConceptLaterality Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
... stage 0..*BackboneElementNot used in this profile

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Condition.codeextensibleSecondaryCancerDisorderVS
Condition.bodySiteextensibleCancerBodyLocationVS
NameFlagsCard.TypeDescription & Constraintsdoco
.. Condition C0..*USCoreConditionDetailed information about conditions, problems or diagnoses
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... assertedDate S0..1dateTimeDate the condition was first asserted
URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
... relatedPrimaryCancerCondition S0..1Reference(Condition)Related Primary Cancer Condition
URL: http://hl7.org/fhir/StructureDefinition/condition-related
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/StructureDefinition/condition-related"
.... value[x] 1..1Reference(Primary Cancer Condition Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... clinicalStatus ?!SΣC0..1CodeableConceptactive | recurrence | relapse | inactive | remission | resolved
Binding: ConditionClinicalStatusCodes (required)
... verificationStatus ?!SΣC0..1CodeableConceptunconfirmed | provisional | differential | confirmed | refuted | entered-in-error
Binding: ConditionVerificationStatus (required)
... category SC1..*CodeableConceptproblem-list-item | encounter-diagnosis | health-concern
Binding: US Core Condition Category Codes (extensible)
... code SΣ1..1CodeableConceptIdentification of the condition, problem or diagnosis
Binding: Secondary Cancer Disorder Value Set (extensible)
... bodySite SΣ0..*CodeableConceptAnatomical location, if relevant
Binding: Cancer Body Location Value Set (extensible)
.... locationQualifier S0..*CodeableConceptBody Location Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
.... lateralityQualifier S0..1CodeableConceptLaterality Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
... subject SΣ1..1Reference(US Core Patient Profile)Who has the condition?
... stage C0..*BackboneElementNot used in this profile
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Condition.clinicalStatusrequiredConditionClinicalStatusCodes
Condition.verificationStatusrequiredConditionVerificationStatus
Condition.categoryextensibleUSCoreConditionCategoryCodes
Condition.codeextensibleSecondaryCancerDisorderVS
Condition.bodySiteextensibleCancerBodyLocationVS
NameFlagsCard.TypeDescription & Constraintsdoco
.. Condition C0..*USCoreConditionDetailed information about conditions, problems or diagnoses
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... assertedDate S0..1dateTimeDate the condition was first asserted
URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
... histologyMorphologyBehavior S0..1CodeableConceptHistology-Morphology-Behavior Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-histology-morphology-behavior
Binding: Histology Morphology Behavior Value Set (extensible)
... relatedPrimaryCancerCondition S0..1Reference(Condition)Related Primary Cancer Condition
URL: http://hl7.org/fhir/StructureDefinition/condition-related
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/StructureDefinition/condition-related"
.... value[x] 1..1Reference(Primary Cancer Condition Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierExternal Ids for this condition
... clinicalStatus ?!SΣC0..1CodeableConceptactive | recurrence | relapse | inactive | remission | resolved
Binding: ConditionClinicalStatusCodes (required)
... verificationStatus ?!SΣC0..1CodeableConceptunconfirmed | provisional | differential | confirmed | refuted | entered-in-error
Binding: ConditionVerificationStatus (required)
... category SC1..*CodeableConceptproblem-list-item | encounter-diagnosis | health-concern
Binding: US Core Condition Category Codes (extensible)
... severity 0..1CodeableConceptSubjective severity of condition
Binding: Condition/DiagnosisSeverity (preferred): A subjective assessment of the severity of the condition as evaluated by the clinician.

... code SΣ1..1CodeableConceptIdentification of the condition, problem or diagnosis
Binding: Secondary Cancer Disorder Value Set (extensible)
... bodySite SΣ0..*CodeableConceptAnatomical location, if relevant
Binding: Cancer Body Location Value Set (extensible)
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... locationQualifier S0..*CodeableConceptBody Location Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
.... lateralityQualifier S0..1CodeableConceptLaterality Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
.... coding Σ0..*CodingCode defined by a terminology system
.... text Σ0..1stringPlain text representation of the concept
... subject SΣ1..1Reference(US Core Patient Profile)Who has the condition?
... encounter Σ0..1Reference(Encounter)Encounter created as part of
... onset[x] Σ0..1Estimated or actual date, date-time, or age
.... onsetDateTimedateTime
.... onsetAgeAge
.... onsetPeriodPeriod
.... onsetRangeRange
.... onsetStringstring
... abatement[x] C0..1When in resolution/remission
.... abatementDateTimedateTime
.... abatementAgeAge
.... abatementPeriodPeriod
.... abatementRangeRange
.... abatementStringstring
... recordedDate Σ0..1dateTimeDate record was first recorded
... recorder Σ0..1Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who recorded the condition
... asserter Σ0..1Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Person who asserts this condition
... stage C0..*BackboneElementNot used in this profile
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... summary C0..1CodeableConceptSimple summary (disease specific)
Binding: ConditionStage (example): Codes describing condition stages (e.g. Cancer stages).

.... assessment C0..*Reference(ClinicalImpression | DiagnosticReport | Observation)Formal record of assessment
.... type 0..1CodeableConceptKind of staging
Binding: ConditionStageType (example): Codes describing the kind of condition staging (e.g. clinical or pathological).

... evidence C0..*BackboneElementSupporting evidence
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code ΣC0..*CodeableConceptManifestation/symptom
Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition.


.... detail ΣC0..*Reference(Resource)Supporting information found elsewhere
... note 0..*AnnotationAdditional information about the Condition

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Condition.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Condition.clinicalStatusrequiredConditionClinicalStatusCodes
Condition.verificationStatusrequiredConditionVerificationStatus
Condition.categoryextensibleUSCoreConditionCategoryCodes
Condition.severitypreferredCondition/DiagnosisSeverity
Condition.codeextensibleSecondaryCancerDisorderVS
Condition.bodySiteextensibleCancerBodyLocationVS
Condition.stage.summaryexampleConditionStage
Condition.stage.typeexampleConditionStageType
Condition.evidence.codeexampleManifestationAndSymptomCodes

Differential View

This structure is derived from USCoreCondition

NameFlagsCard.TypeDescription & Constraintsdoco
.. Condition 0..*USCoreConditionDetailed information about conditions, problems or diagnoses
... Slices for extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... assertedDate S0..1dateTimeDate the condition was first asserted
URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
... histologyMorphologyBehavior S0..1CodeableConceptHistology-Morphology-Behavior Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-histology-morphology-behavior
Binding: Histology Morphology Behavior Value Set (extensible)
.... value[x] 1..1Reference(Primary Cancer Condition Profile)Value of extension
... code 1..1CodeableConceptIdentification of the condition, problem or diagnosis
Binding: Secondary Cancer Disorder Value Set (extensible)
... bodySite S0..*CodeableConceptAnatomical location, if relevant
Binding: Cancer Body Location Value Set (extensible)
.... locationQualifier S0..*CodeableConceptBody Location Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
.... lateralityQualifier S0..1CodeableConceptLaterality Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
... stage 0..*BackboneElementNot used in this profile

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Condition.codeextensibleSecondaryCancerDisorderVS
Condition.bodySiteextensibleCancerBodyLocationVS

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Condition C0..*USCoreConditionDetailed information about conditions, problems or diagnoses
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... Slices for extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... assertedDate S0..1dateTimeDate the condition was first asserted
URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
... relatedPrimaryCancerCondition S0..1Reference(Condition)Related Primary Cancer Condition
URL: http://hl7.org/fhir/StructureDefinition/condition-related
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/StructureDefinition/condition-related"
.... value[x] 1..1Reference(Primary Cancer Condition Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... clinicalStatus ?!SΣC0..1CodeableConceptactive | recurrence | relapse | inactive | remission | resolved
Binding: ConditionClinicalStatusCodes (required)
... verificationStatus ?!SΣC0..1CodeableConceptunconfirmed | provisional | differential | confirmed | refuted | entered-in-error
Binding: ConditionVerificationStatus (required)
... category SC1..*CodeableConceptproblem-list-item | encounter-diagnosis | health-concern
Binding: US Core Condition Category Codes (extensible)
... code SΣ1..1CodeableConceptIdentification of the condition, problem or diagnosis
Binding: Secondary Cancer Disorder Value Set (extensible)
... bodySite SΣ0..*CodeableConceptAnatomical location, if relevant
Binding: Cancer Body Location Value Set (extensible)
.... locationQualifier S0..*CodeableConceptBody Location Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
.... lateralityQualifier S0..1CodeableConceptLaterality Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
... subject SΣ1..1Reference(US Core Patient Profile)Who has the condition?
... stage C0..*BackboneElementNot used in this profile
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Condition.clinicalStatusrequiredConditionClinicalStatusCodes
Condition.verificationStatusrequiredConditionVerificationStatus
Condition.categoryextensibleUSCoreConditionCategoryCodes
Condition.codeextensibleSecondaryCancerDisorderVS
Condition.bodySiteextensibleCancerBodyLocationVS

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Condition C0..*USCoreConditionDetailed information about conditions, problems or diagnoses
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional BindingsPurpose
AllLanguagesMax Binding
... text 0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... Slices for extension S0..*ExtensionExtension
Slice: Unordered, Open by value:url
... assertedDate S0..1dateTimeDate the condition was first asserted
URL: http://hl7.org/fhir/StructureDefinition/condition-assertedDate
... histologyMorphologyBehavior S0..1CodeableConceptHistology-Morphology-Behavior Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-histology-morphology-behavior
Binding: Histology Morphology Behavior Value Set (extensible)
... relatedPrimaryCancerCondition S0..1Reference(Condition)Related Primary Cancer Condition
URL: http://hl7.org/fhir/StructureDefinition/condition-related
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..0
.... url 1..1uri"http://hl7.org/fhir/StructureDefinition/condition-related"
.... value[x] 1..1Reference(Primary Cancer Condition Profile)Value of extension
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier Σ0..*IdentifierExternal Ids for this condition
... clinicalStatus ?!SΣC0..1CodeableConceptactive | recurrence | relapse | inactive | remission | resolved
Binding: ConditionClinicalStatusCodes (required)
... verificationStatus ?!SΣC0..1CodeableConceptunconfirmed | provisional | differential | confirmed | refuted | entered-in-error
Binding: ConditionVerificationStatus (required)
... category SC1..*CodeableConceptproblem-list-item | encounter-diagnosis | health-concern
Binding: US Core Condition Category Codes (extensible)
... severity 0..1CodeableConceptSubjective severity of condition
Binding: Condition/DiagnosisSeverity (preferred): A subjective assessment of the severity of the condition as evaluated by the clinician.

... code SΣ1..1CodeableConceptIdentification of the condition, problem or diagnosis
Binding: Secondary Cancer Disorder Value Set (extensible)
... bodySite SΣ0..*CodeableConceptAnatomical location, if relevant
Binding: Cancer Body Location Value Set (extensible)
.... id 0..1stringUnique id for inter-element referencing
.... Slices for extension 0..*ExtensionAdditional content defined by implementations
Slice: Unordered, Open by value:url
.... locationQualifier S0..*CodeableConceptBody Location Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
.... lateralityQualifier S0..1CodeableConceptLaterality Qualifier Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
.... coding Σ0..*CodingCode defined by a terminology system
.... text Σ0..1stringPlain text representation of the concept
... subject SΣ1..1Reference(US Core Patient Profile)Who has the condition?
... encounter Σ0..1Reference(Encounter)Encounter created as part of
... onset[x] Σ0..1Estimated or actual date, date-time, or age
.... onsetDateTimedateTime
.... onsetAgeAge
.... onsetPeriodPeriod
.... onsetRangeRange
.... onsetStringstring
... abatement[x] C0..1When in resolution/remission
.... abatementDateTimedateTime
.... abatementAgeAge
.... abatementPeriodPeriod
.... abatementRangeRange
.... abatementStringstring
... recordedDate Σ0..1dateTimeDate record was first recorded
... recorder Σ0..1Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Who recorded the condition
... asserter Σ0..1Reference(Practitioner | PractitionerRole | Patient | RelatedPerson)Person who asserts this condition
... stage C0..*BackboneElementNot used in this profile
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... summary C0..1CodeableConceptSimple summary (disease specific)
Binding: ConditionStage (example): Codes describing condition stages (e.g. Cancer stages).

.... assessment C0..*Reference(ClinicalImpression | DiagnosticReport | Observation)Formal record of assessment
.... type 0..1CodeableConceptKind of staging
Binding: ConditionStageType (example): Codes describing the kind of condition staging (e.g. clinical or pathological).

... evidence C0..*BackboneElementSupporting evidence
.... id 0..1stringUnique id for inter-element referencing
.... extension 0..*ExtensionAdditional content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored even if unrecognized
.... code ΣC0..*CodeableConceptManifestation/symptom
Binding: ManifestationAndSymptomCodes (example): Codes that describe the manifestation or symptoms of a condition.


.... detail ΣC0..*Reference(Resource)Supporting information found elsewhere
... note 0..*AnnotationAdditional information about the Condition

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Condition.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Condition.clinicalStatusrequiredConditionClinicalStatusCodes
Condition.verificationStatusrequiredConditionVerificationStatus
Condition.categoryextensibleUSCoreConditionCategoryCodes
Condition.severitypreferredCondition/DiagnosisSeverity
Condition.codeextensibleSecondaryCancerDisorderVS
Condition.bodySiteextensibleCancerBodyLocationVS
Condition.stage.summaryexampleConditionStage
Condition.stage.typeexampleConditionStageType
Condition.evidence.codeexampleManifestationAndSymptomCodes

 

Other representations of profile: CSV, Excel, Schematron