# CancerConditionAtDiagnosis - HL7 Europe Common Cancer Model v1.0.0-ballot

* [**Table of Contents**](toc.md)
* [**Artifacts Summary**](artifacts.md)
* **CancerConditionAtDiagnosis**

## Logical Model: CancerConditionAtDiagnosis 

| | |
| :--- | :--- |
| *Official URL*:http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerConditionAtDiagnosis | *Version*:1.0.0-ballot |
| Active as of 2026-06-14 | *Computable Name*:CancerConditionAtDiagnosis |
| **Copyright/Legal**: HL7 Europe Copyright. Licensed under Common Creative License (CC0 1.0). Details at [Copyright](copyright.md). | |

 
Logical model representing the cancer condition at first diagnosis, capturing initial tumour characteristics and the diagnostic context that initiates the cancer journey. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerConditionAtDiagnosis). 

**Usages:**

* Refer to this Logical Model: [Active Surveillance](StructureDefinition-ActiveSurveillance.md), [CancerStage](StructureDefinition-CancerStage.md), [ClinicalCancerProgression](StructureDefinition-ClinicalCancerProgression.md), [OverallCancerTreatmentResponse](StructureDefinition-OverallCancerTreatmentResponse.md)... Show 3 more, [Radiotherapy](StructureDefinition-Radiotherapy.md), [Surgery](StructureDefinition-Surgery.md) and [SystemicTreatment](StructureDefinition-SystemicTreatment.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/resource/hl7.fhir.eu.cancer-common|current/StructureDefinition/StructureDefinition-CancerConditionAtDiagnosis.json)

### Formal Views of Profile Content

 [Description of Profiles, Differentials, Snapshots and how the different presentations work](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

 

Other representations of profile: [CSV](StructureDefinition-CancerConditionAtDiagnosis.csv), [Excel](StructureDefinition-CancerConditionAtDiagnosis.xlsx) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "CancerConditionAtDiagnosis",
  "extension" : [{
    "url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
    "valueCode" : "can-be-target"
  }],
  "url" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerConditionAtDiagnosis",
  "version" : "1.0.0-ballot",
  "name" : "CancerConditionAtDiagnosis",
  "title" : "CancerConditionAtDiagnosis",
  "status" : "active",
  "date" : "2026-06-14T12:51:40+02:00",
  "publisher" : "HL7 Europe",
  "contact" : [{
    "name" : "HL7 Europe",
    "telecom" : [{
      "system" : "url",
      "value" : "http://hl7.eu"
    }]
  }],
  "description" : "Logical model representing the cancer condition at first diagnosis, capturing initial tumour characteristics and the diagnostic context that initiates the cancer journey. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerConditionAtDiagnosis).",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
      "code" : "150",
      "display" : "Europe"
    }]
  }],
  "copyright" : "HL7 Europe Copyright. Licensed under Common Creative License (CC0 1.0). Details at [Copyright](copyright.html).",
  "fhirVersion" : "4.0.1",
  "kind" : "logical",
  "abstract" : false,
  "type" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerConditionAtDiagnosis",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation" : "specialization",
  "differential" : {
    "element" : [{
      "id" : "CancerConditionAtDiagnosis",
      "path" : "CancerConditionAtDiagnosis",
      "short" : "CancerConditionAtDiagnosis",
      "definition" : "Logical model representing the cancer condition at first diagnosis, capturing initial tumour characteristics and the diagnostic context that initiates the cancer journey. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerConditionAtDiagnosis).",
      "constraint" : [{
        "key" : "ccad-1",
        "severity" : "error",
        "human" : "At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.",
        "expression" : "(visitDate | biopsyDate | imagingDate | labReportDate).exists()",
        "source" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerConditionAtDiagnosis"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.subject",
      "path" : "CancerConditionAtDiagnosis.subject",
      "short" : "Subject",
      "definition" : "Reference to the patient (subject) affected by the cancer condition at first diagnosis.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerPatient"]
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.histologyBehaviour",
      "path" : "CancerConditionAtDiagnosis.histologyBehaviour",
      "short" : "HistologyBehaviour",
      "definition" : "Histology and behaviour of the neoplasm at first diagnosis. Histology describes the tumour cell type (morphology), while behaviour indicates whether the tumour is malignant, benign, carcinoma in situ, or of uncertain/borderline malignancy. This information may be unavailable during early diagnostic workup (e.g., before biopsy results are final) but is expected to be present once the diagnostic workup is completed.",
      "comment" : "WG recommends ICD03, the WG will monitor possible next versions. This attribute becomes mandatory once the cancer has been diagnosed; however, during the diagnostic workup it may still be absent, as the biopsy resulting from the surgery may not yet be available.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.bodySite",
      "path" : "CancerConditionAtDiagnosis.bodySite",
      "short" : "BodySite",
      "definition" : "Primary anatomical site where the cancer condition was first detected.",
      "comment" : "WG recommends ICD03, the WG will monitor possible next versions. It is required to choose the most specific code available, meaning the most detailed code in the hierarchical terminology that precisely identifies the body site.",
      "min" : 1,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.tumourGradeSystem",
      "path" : "CancerConditionAtDiagnosis.tumourGradeSystem",
      "short" : "TumourGradeSystem",
      "definition" : "Classification system used to define tumour grade, describing how abnormal tumour cells and tissue appear under microscopic examination (e.g. Gleason for prostate cancer, FNCLCC for soft tissue sarcomas). The grading system provides an indication of the biological aggressiveness of the tumour.",
      "comment" : "It represents the classification system used to define the tumour grade, such as Gleason (a grading system for prostate cancer) or FNCLCC (a grading system for soft tissue sarcomas).",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.tumourGradeValue",
      "path" : "CancerConditionAtDiagnosis.tumourGradeValue",
      "short" : "TumourGradeValue",
      "definition" : "Grade value assigned according to the selected TumourGradeSystem. The grade reflects the degree of cellular differentiation and biological aggressiveness of the tumour and may evolve over time.",
      "comment" : "It represents the measured grade value based on the specific classification defined in the TumourGradeSystem.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "string"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.visitDate",
      "path" : "CancerConditionAtDiagnosis.visitDate",
      "short" : "VisitDate",
      "definition" : "Date of the clinical visit that established the diagnosis (one of the diagnosis dates).",
      "comment" : "At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "dateTime"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.biopsyDate",
      "path" : "CancerConditionAtDiagnosis.biopsyDate",
      "short" : "BiopsyDate",
      "definition" : "Date of the biopsy supporting the diagnosis (one of the diagnosis dates).",
      "comment" : "At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "dateTime"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.imagingDate",
      "path" : "CancerConditionAtDiagnosis.imagingDate",
      "short" : "ImagingDate",
      "definition" : "Date of the diagnostic imaging supporting the diagnosis (one of the diagnosis dates).",
      "comment" : "At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "dateTime"
      }]
    },
    {
      "id" : "CancerConditionAtDiagnosis.labReportDate",
      "path" : "CancerConditionAtDiagnosis.labReportDate",
      "short" : "LabReportDate",
      "definition" : "Date of the laboratory report supporting the diagnosis, including biomarkers when applicable.",
      "comment" : "At least one of visitDate, biopsyDate, imagingDate, labReportDate must be present, since the model requires a diagnosis date for the Cancer Condition.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "dateTime"
      }]
    }]
  }
}

```
