HL7 Europe Common Cancer Model, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 1.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-eu/cancer-common/ and changes regularly. See the Directory of published versions
| Active as of 2026-10-20 |
JSON representation of the CancerPatient logical model.
{
"resourceType" : "StructureDefinition",
"id" : "CancerPatient",
"text" : {
"status" : "extensions",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: StructureDefinition CancerPatient</b></p><table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" class=\"xhtTableBorder0\"><tr class=\"xhtRowBorder1\"><th scope=\"col\" style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"The logical name of the element\">Name</a></th><th scope=\"col\" style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Information about the use of the element\">Flags</a></th><th scope=\"col\" style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Minimum and Maximum # of times the element can appear in the instance\">Card.</a></th><th scope=\"col\" style=\"; width: 100px\" class=\"hierarchy xhtCellBorder0\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Reference to the type of the element\">Type</a></th><th scope=\"col\" style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Additional information about the element\">Description & Constraints</a><span style=\"float: right\"><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/></a></span></th></tr><tr class=\"xhtRowBorder0 xhtRowEven\"><td style=\"background-image: url(tbl_bck1.png)\" class=\"hierarchy xhtCellBorder0 xhtCellNoWrap\"><img src=\"tbl_spacer.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_element.gif\" alt=\"\" style=\"background-color: white; background-color: inherit\" title=\"Element\" class=\"hierarchy\"/> <a href=\"StructureDefinition-CancerPatient-definitions.html#CancerPatient\" title=\"Logical model describing the patient affected by cancer, acting as the central subject for diagnosis, treatments, disease evolution and follow-up. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerPatient).\">CancerPatient</a><a name=\"CancerPatient\"> </a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\"/><td style=\"\" class=\"hierarchy xhtCellBorder0\"><span class=\"xhtPieceDeEmphasized\">0</span><span class=\"xhtPieceDeEmphasized\">..</span><span class=\"xhtPieceDeEmphasized\">*</span></td><td style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"http://build.fhir.org/types.html#Base\">Base</a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\">Cancer Patient<br/><span class=\"xhtPieceBold\">Instances of this type can be the target of a Reference</span></td></tr>\r\n<tr class=\"xhtRowBorder0 xhtRowOdd\"><td style=\"background-image: url(tbl_bck10.png)\" class=\"hierarchy xhtCellBorder0 xhtCellNoWrap\"><img src=\"tbl_spacer.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_primitive.png\" alt=\"\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Primitive Data Type\" class=\"hierarchy\"/> <span style=\"position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0\" class=\"sr-only\">CancerPatient.</span><a href=\"StructureDefinition-CancerPatient-definitions.html#CancerPatient.birthDate\" title=\"Patient date of birth (at least the year should be available).\">birthDate</a><a name=\"CancerPatient.birthDate\"> </a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\"/><td style=\"\" class=\"hierarchy xhtCellBorder0\">1..1</td><td style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#dateTime\">dateTime</a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\">BirthDate</td></tr>\r\n<tr class=\"xhtRowBorder0 xhtRowEven\"><td style=\"background-image: url(tbl_bck10.png)\" class=\"hierarchy xhtCellBorder0 xhtCellNoWrap\"><img src=\"tbl_spacer.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_datatype.gif\" alt=\"\" style=\"background-color: white; background-color: inherit\" title=\"Data Type\" class=\"hierarchy\"/> <span style=\"position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0\" class=\"sr-only\">CancerPatient.</span><a href=\"StructureDefinition-CancerPatient-definitions.html#CancerPatient.sexAtBirth\" title=\"Biological sex assigned at birth, determined by sex characteristics observed at birth or infancy (e.g., genital characteristics and/or chromosome composition). This represents sex as a biological variable and should not be used to represent gender identity or administrative gender.\">sexAtBirth</a><a name=\"CancerPatient.sexAtBirth\"> </a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\"/><td style=\"\" class=\"hierarchy xhtCellBorder0\">1..1</td><td style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#CodeableConcept\">CodeableConcept</a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\">SexAtBirth</td></tr>\r\n<tr class=\"xhtRowBorder0 xhtRowOdd\"><td style=\"background-image: url(tbl_bck10.png)\" class=\"hierarchy xhtCellBorder0 xhtCellNoWrap\"><img src=\"tbl_spacer.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_datatype.gif\" alt=\"\" style=\"background-color: #F7F7F7; background-color: inherit\" title=\"Data Type\" class=\"hierarchy\"/> <span style=\"position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0\" class=\"sr-only\">CancerPatient.</span><a href=\"StructureDefinition-CancerPatient-definitions.html#CancerPatient.observedSexGender\" title=\"Recorded sex at the time of cancer diagnosis, if different from SexAtBirth. This captures what is documented at diagnosis and should be interpreted in line with the clinical record context.\">observedSexGender</a><a name=\"CancerPatient.observedSexGender\"> </a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\"/><td style=\"\" class=\"hierarchy xhtCellBorder0\">0..1</td><td style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#CodeableConcept\">CodeableConcept</a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\">ObservedSex Gender</td></tr>\r\n<tr class=\"xhtRowBorder0 xhtRowEven\"><td style=\"background-image: url(tbl_bck00.png)\" class=\"hierarchy xhtCellBorder0 xhtCellNoWrap\"><img src=\"tbl_spacer.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"tbl_vjoin_end.png\" alt=\"\" style=\"background-color: inherit\" class=\"hierarchy\"/><img src=\"icon_datatype.gif\" alt=\"\" style=\"background-color: white; background-color: inherit\" title=\"Data Type\" class=\"hierarchy\"/> <span style=\"position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0\" class=\"sr-only\">CancerPatient.</span><a href=\"StructureDefinition-CancerPatient-definitions.html#CancerPatient.comorbiditiesAtCancerDiagnosis\" title=\"Active chronic conditions present at the time of cancer diagnosis.\">comorbiditiesAtCancerDiagnosis</a><a name=\"CancerPatient.comorbiditiesAtCancerDiagnosis\"> </a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\"/><td style=\"\" class=\"hierarchy xhtCellBorder0\">0..*</td><td style=\"\" class=\"hierarchy xhtCellBorder0\"><a href=\"http://hl7.org/fhir/R4/datatypes.html#CodeableConcept\">CodeableConcept</a></td><td style=\"\" class=\"hierarchy xhtCellBorder0\">ComorbiditiesAtCancerDiagnosis<br/></td></tr>\r\n<tr><td colspan=\"5\" class=\"hierarchy\"><br/><a href=\"https://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#table-views\" title=\"Legend for this format\"><img src=\"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAAABmJLR0QA/wD/AP+gvaeTAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAB3RJTUUH3goXBCwdPqAP0wAAAldJREFUOMuNk0tIlFEYhp9z/vE2jHkhxXA0zJCMitrUQlq4lnSltEqCFhFG2MJFhIvIFpkEWaTQqjaWZRkp0g26URZkTpbaaOJkDqk10szoODP//7XIMUe0elcfnPd9zsfLOYplGrpRwZaqTtw3K7PtGem7Q6FoidbGgqHVy/HRb669R+56zx7eRV1L31JGxYbBtjKK93cxeqfyQHbehkZbUkK20goELEuIzEd+dHS+qz/Y8PTSif0FnGkbiwcAjHaU1+QWOptFiyCLp/LnKptpqIuXHx6rbR26kJcBX3yLgBfnd7CxwJmflpP2wUg0HIAoUUpZBmKzELGWcN8nAr6Gpu7tLU/CkwAaoKTWRSQyt89Q8w6J+oVQkKnBoblH7V0PPvUOvDYXfopE/SJmALsxnVm6LbkotrUtNowMeIrVrBcBpaMmdS0j9df7abpSuy7HWehwJdt1lhVwi/J58U5beXGAF6c3UXLycw1wdFklArBn87xdh0ZsZtArghBdAA3+OEDVubG4UEzP6x1FOWneHh2VDAHBAt80IbdXDcesNoCvs3E5AFyNSU5nbrDPZpcUEQQTFZiEVx+51fxMhhyJEAgvlriadIJZZksRuwBYMOPBbO3hePVVqgEJhFeUuFLhIPkRP6BQLIBrmMenujm/3g4zc398awIe90Zb5A1vREALqneMcYgP/xVQWlG+Ncu5vgwwlaUNx+3799rfe96u9K0JSDXcOzOTJg4B6IgmXfsygc7/Bvg9g9E58/cDVmGIBOP/zT8Bz1zqWqpbXIsd0O9hajXfL6u4BaOS6SeWAAAAAElFTkSuQmCC\" alt=\"doco\" style=\"background-color: inherit\"/> Documentation for this format</a></td></tr></table></div>"
},
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-type-characteristics",
"valueCode" : "can-be-target"
}
],
"url" : "http://hl7.eu/fhir/cancer-common/StructureDefinition/CancerPatient",
"version" : "1.0.0-ballot",
"name" : "CancerPatient",
"title" : "Cancer Patient",
"status" : "active",
"date" : "2026-10-20T16:00:15+00:00",
"publisher" : "HL7 Europe",
"contact" : [
{
"name" : "HL7 Europe",
"telecom" : [
{
"system" : "url",
"value" : "http://hl7.eu"
}
]
}
],
"description" : "Logical model describing the patient affected by cancer, acting as the central subject for diagnosis, treatments, disease evolution and follow-up. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerPatient).",
"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/CancerPatient",
"baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Base",
"derivation" : "specialization",
"snapshot" : {
"extension" : [
{
"url" : "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version",
"valueString" : "4.0.1"
}
],
"element" : [
{
"id" : "CancerPatient",
"path" : "CancerPatient",
"short" : "Cancer Patient",
"definition" : "Logical model describing the patient affected by cancer, acting as the central subject for diagnosis, treatments, disease evolution and follow-up. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerPatient).",
"min" : 0,
"max" : "*",
"base" : {
"path" : "Base",
"min" : 0,
"max" : "*"
},
"isModifier" : false
},
{
"id" : "CancerPatient.birthDate",
"path" : "CancerPatient.birthDate",
"short" : "BirthDate",
"definition" : "Patient date of birth (at least the year should be available).",
"comment" : "At least the year must be present.",
"min" : 1,
"max" : "1",
"base" : {
"path" : "CancerPatient.birthDate",
"min" : 1,
"max" : "1"
},
"type" : [
{
"code" : "dateTime"
}
]
},
{
"id" : "CancerPatient.sexAtBirth",
"path" : "CancerPatient.sexAtBirth",
"short" : "SexAtBirth",
"definition" : "Biological sex assigned at birth, determined by sex characteristics observed at birth or infancy (e.g., genital characteristics and/or chromosome composition). This represents sex as a biological variable and should not be used to represent gender identity or administrative gender.",
"comment" : "This element refers to biological sex assigned at birth (not gender identity). It is typically captured once and is not expected to change. Choice: Male | Female | Unknown | Other",
"min" : 1,
"max" : "1",
"base" : {
"path" : "CancerPatient.sexAtBirth",
"min" : 1,
"max" : "1"
},
"type" : [
{
"code" : "CodeableConcept"
}
]
},
{
"id" : "CancerPatient.observedSexGender",
"path" : "CancerPatient.observedSexGender",
"short" : "ObservedSex Gender",
"definition" : "Recorded sex at the time of cancer diagnosis, if different from SexAtBirth. This captures what is documented at diagnosis and should be interpreted in line with the clinical record context.",
"comment" : "It shall be present if changed respect the SexAtBirth. See https://confluence.hl7.org/spaces/VOC/pages/40743893/The+Gender+Harmony+Project",
"min" : 0,
"max" : "1",
"base" : {
"path" : "CancerPatient.observedSexGender",
"min" : 0,
"max" : "1"
},
"type" : [
{
"code" : "CodeableConcept"
}
]
},
{
"id" : "CancerPatient.comorbiditiesAtCancerDiagnosis",
"path" : "CancerPatient.comorbiditiesAtCancerDiagnosis",
"short" : "ComorbiditiesAtCancerDiagnosis",
"definition" : "Active chronic conditions present at the time of cancer diagnosis.",
"comment" : "Active chronic conditions present at the time of cancer diagnosis.",
"min" : 0,
"max" : "*",
"base" : {
"path" : "CancerPatient.comorbiditiesAtCancerDiagnosis",
"min" : 0,
"max" : "*"
},
"type" : [
{
"code" : "CodeableConcept"
}
]
}
]
},
"differential" : {
"element" : [
{
"id" : "CancerPatient",
"path" : "CancerPatient",
"short" : "Cancer Patient",
"definition" : "Logical model describing the patient affected by cancer, acting as the central subject for diagnosis, treatments, disease evolution and follow-up. Derived from Cancer_Common_Logical_Model_20260521.xlsx (sheet CancerPatient)."
},
{
"id" : "CancerPatient.birthDate",
"path" : "CancerPatient.birthDate",
"short" : "BirthDate",
"definition" : "Patient date of birth (at least the year should be available).",
"comment" : "At least the year must be present.",
"min" : 1,
"max" : "1",
"type" : [
{
"code" : "dateTime"
}
]
},
{
"id" : "CancerPatient.sexAtBirth",
"path" : "CancerPatient.sexAtBirth",
"short" : "SexAtBirth",
"definition" : "Biological sex assigned at birth, determined by sex characteristics observed at birth or infancy (e.g., genital characteristics and/or chromosome composition). This represents sex as a biological variable and should not be used to represent gender identity or administrative gender.",
"comment" : "This element refers to biological sex assigned at birth (not gender identity). It is typically captured once and is not expected to change. Choice: Male | Female | Unknown | Other",
"min" : 1,
"max" : "1",
"type" : [
{
"code" : "CodeableConcept"
}
]
},
{
"id" : "CancerPatient.observedSexGender",
"path" : "CancerPatient.observedSexGender",
"short" : "ObservedSex Gender",
"definition" : "Recorded sex at the time of cancer diagnosis, if different from SexAtBirth. This captures what is documented at diagnosis and should be interpreted in line with the clinical record context.",
"comment" : "It shall be present if changed respect the SexAtBirth. See https://confluence.hl7.org/spaces/VOC/pages/40743893/The+Gender+Harmony+Project",
"min" : 0,
"max" : "1",
"type" : [
{
"code" : "CodeableConcept"
}
]
},
{
"id" : "CancerPatient.comorbiditiesAtCancerDiagnosis",
"path" : "CancerPatient.comorbiditiesAtCancerDiagnosis",
"short" : "ComorbiditiesAtCancerDiagnosis",
"definition" : "Active chronic conditions present at the time of cancer diagnosis.",
"comment" : "Active chronic conditions present at the time of cancer diagnosis.",
"min" : 0,
"max" : "*",
"type" : [
{
"code" : "CodeableConcept"
}
]
}
]
}
}