IDEA4RC FHIR Implementation Guide
0.1.0 - CI Build 150

IDEA4RC FHIR Implementation Guide, published by IDEA4RC Project. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-eu/idea4rc/ and changes regularly. See the Directory of published versions

: Radiotherapy Model to this guide Map - XML Representation

Draft as of 2025-09-10

Raw xml | Download


<ConceptMap xmlns="http://hl7.org/fhir">
  <id value="radiotherapy2FHIR"/>
  <text>
    <status value="generated"/>
    <div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ConceptMap radiotherapy2FHIR</b></p><a name="radiotherapy2FHIR"> </a><a name="hcradiotherapy2FHIR"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <a href="StructureDefinition-Radiotherapy.html">Radiotherapy</a> to <a href="StructureDefinition-Procedure-radiotheraphy-eu-i4rc.html">Procedure: Radiotherapy</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>diagnosisReference (Diagnosis reference (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.reasonReference</td><td/></tr><tr><td>episodeEventReference (Episode Event reference (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.reasonReference</td><td/></tr><tr><td>radiotherapyHospital (Radiotherapy Hospital (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.performer</td><td>In case the actual Organization performing the procedure is captured. It could be a perfomer of type Organization; or a perfomer.organization if of type PractitionerRole</td></tr><tr><td>radiotherapyHospital (Radiotherapy Hospital (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:sameHospital</td><td>Temporary included in the guide for covering the request of tracking if this information has been captured and maintained by the same or other organizations. It is envisioned that this kind of requirements could be covered by recording where specific act are taking place.</td></tr><tr><td>intent (Intent (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:procedureIntent</td><td>from mcode https://build.fhir.org/ig/HL7/fhir-mCODE-ig/StructureDefinition-mcode-radiotherapy-course-summary.html</td></tr><tr><td>setting (Setting (M (only if Intent is Curative OR Unknown)))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.extension:procedureCategoryR5</td><td/></tr><tr><td>beamQuality (Beam quality (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:modalityAndTechnique.extension:modality.valueCodeableConcept</td><td>For now we can use the mcode extension</td></tr><tr><td>other (Other; specify (O))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:modalityAndTechnique.extension:modality.valueCodeableConcept.text</td><td/></tr><tr><td>treatmentTechnique (Treatment technique (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:modalityAndTechnique.extension:technique.valueCodeableConcept</td><td>For now we can use the mcode extension</td></tr><tr><td>totalDoseGy (Total Dose (TD) Gy (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.extension:doseToVolume.extension:totalDoseDelivered</td><td/></tr><tr><td>totalHighDose (Total High Dose (Gy) (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.extension:totalHighDoseDelivered</td><td/></tr><tr><td>numberOfFractions (Number of fractions (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:doseToVolume.extension:fractionsDelivered</td><td/></tr><tr><td>adaptiveRt (Adaptive RT (O))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.extension:adaptive.value</td><td/></tr><tr><td>igrt (IGRT  (image guide radiotherapy) (O))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.extension:modalityAndTechnique.extension:technique.valueCodeableConcept</td><td>If is present the extension with code 2000100046 'Image guided radiotherapy (IGRT)' it is 'true', else it is 'false'</td></tr><tr><td>reirradiation (Reirradiation (local or regional) (O))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure</td><td>If is present another procedure in the same site for the same condition it is 'true', else it is 'false'</td></tr><tr><td>fieldOfReirradiation (Field of Re-irradiation (O))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.reasonCode</td><td>Present only in the second procedure with the same site for the same condition </td></tr><tr><td>startDate (Start date (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.performedPeriod.start</td><td/></tr><tr><td>endDate (End  date (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.performedPeriod.end</td><td/></tr><tr><td>treatmentSitePrimaryOnly (Treatment site primary only (M (suggest to modify the label into Primary only)))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If bodySite = 1 and is the same of the Condition: Primary Cancer it is 'true', else it is 'false'</td></tr><tr><td>treatmentSiteNeckOnly (Treatment site neck only (M (suggest to modify the label into Neck only)))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If bodySite = 1 and is 36770046 'Neck' it is 'true', else it is 'false'</td></tr><tr><td>treatmentSitePrimaryAndIpsilateralNeck (Treatment site primary and ipsilateral neck (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If bodySite &gt; 1 and one is the same of the Condition: Primary Cancer and another is 36770046 'Neck' with Procedure.bosySite.extension:lateralityQualifier 4112106 'Ipsilateral' it is 'true', else it is 'false'</td></tr><tr><td>treatmentSitePrimaryAndBilateralNeck (Treatment site primary and bilateral neck (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If bodySite &gt; 1 and one is the same of the Condition: Primary Cancer and another is 36770046 'Neck' with Procedure.bosySite.extension:lateralityQualifier 4197258 'Right and left' it is 'true', else it is 'false'</td></tr><tr><td>treatmentSiteDistantMetastasis (Treatment site distant metastasis (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If is 36769180 'Metastasis' it is 'true', else it is 'false'</td></tr><tr><td>otherTreatmentSite (Other Treatment Site (O))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.bodySite</td><td/></tr><tr><td>metastaticTreatmentSiteLung (Metastatic treatment site lung (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If is 36770283 'Metastasis to lung' it is 'true', else it is 'false'</td></tr><tr><td>metastaticTreatmentSiteMediastinum (Metastatic treatment site mediastinum (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If is 35225542 'Metastasis to mediastinum' it is 'true', else it is 'false'</td></tr><tr><td>metastaticTreatmentSiteBone (Metastatic treatment site bone (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If is 36769301 'Metastasis to bone' it is 'true', else it is 'false'</td></tr><tr><td>metastaticTreatmentSiteSoftTissue (Metastatic treatment site soft tissue (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If is 35225724 'Metastasis to soft tissues' it is 'true', else it is 'false'</td></tr><tr><td>metastaticTreatmentSiteLiver (Metastatic treatment site liver (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.bodySite</td><td>If is 36770544 'Metastasis to liver' it is 'true', else it is 'false'</td></tr><tr><td>rtTreatmentCompletedAsPlanned (RT Treatment Completed as Planned? (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.extension:terminationReason</td><td>For now we can use the mcode extension</td></tr><tr><td>regionalDeepHyperthemia (Regional deep hyperthemia (M))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#relatedto" title="relatedto">is related to</a></td><td>Procedure.partOf</td><td/></tr><tr><td>treatmentResponse (Treatment response (R))</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>Procedure.outcome</td><td/></tr></table></div>
  </text>
  <url value="http://hl7.eu/fhir/ig/idea4rc/ConceptMap/radiotherapy2FHIR"/>
  <version value="0.1.0"/>
  <name value="Radiotherapy2FHIR"/>
  <title value="Radiotherapy Model to this guide Map"/>
  <status value="draft"/>
  <experimental value="true"/>
  <date value="2025-09-10T15:18:34+00:00"/>
  <publisher value="IDEA4RC Project"/>
  <contact>
    <name value="IDEA4RC Project"/>
    <telecom>
      <system value="url"/>
      <value value="https://www.idea4rc.eu/"/>
    </telecom>
  </contact>
  <contact>
    <name value="IDEA4RC Project"/>
    <telecom>
      <system value="url"/>
      <value value="https://www.idea4rc.eu/"/>
    </telecom>
  </contact>
  <description
               value="It shows how the Radiotherapy model is mapped into this guide"/>
  <jurisdiction>
    <coding>
      <system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
      <code value="150"/>
      <display value="Europe"/>
    </coding>
  </jurisdiction>
  <group>
    <source
            value="http://hl7.eu/fhir/ig/idea4rc/StructureDefinition/Radiotherapy"/>
    <target
            value="http://hl7.eu/fhir/ig/idea4rc/StructureDefinition/Procedure-radiotheraphy-eu-i4rc"/>
    <element>
      <code value="diagnosisReference"/>
      <display value="Diagnosis reference (M)"/>
      <target>
        <code value="Procedure.reasonReference"/>
        <equivalence value="relatedto"/>
      </target>
    </element>
    <element>
      <code value="episodeEventReference"/>
      <display value="Episode Event reference (M)"/>
      <target>
        <code value="Procedure.reasonReference"/>
        <equivalence value="relatedto"/>
      </target>
    </element>
    <element>
      <code value="radiotherapyHospital"/>
      <display value="Radiotherapy Hospital (M)"/>
      <target>
        <code value="Procedure.performer"/>
        <equivalence value="relatedto"/>
        <comment
                 value="In case the actual Organization performing the procedure is captured. It could be a perfomer of type Organization; or a perfomer.organization if of type PractitionerRole"/>
      </target>
    </element>
    <element>
      <code value="radiotherapyHospital"/>
      <display value="Radiotherapy Hospital (M)"/>
      <target>
        <code value="Procedure.extension:sameHospital"/>
        <equivalence value="relatedto"/>
        <comment
                 value="Temporary included in the guide for covering the request of tracking if this information has been captured and maintained by the same or other organizations. It is envisioned that this kind of requirements could be covered by recording where specific act are taking place."/>
      </target>
    </element>
    <element>
      <code value="intent"/>
      <display value="Intent (M)"/>
      <target>
        <code value="Procedure.extension:procedureIntent"/>
        <equivalence value="relatedto"/>
        <comment
                 value="from mcode https://build.fhir.org/ig/HL7/fhir-mCODE-ig/StructureDefinition-mcode-radiotherapy-course-summary.html"/>
      </target>
    </element>
    <element>
      <code value="setting"/>
      <display value="Setting (M (only if Intent is Curative OR Unknown))"/>
      <target>
        <code value="Procedure.extension:procedureCategoryR5"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="beamQuality"/>
      <display value="Beam quality (M)"/>
      <target>
        <code
              value="Procedure.extension:modalityAndTechnique.extension:modality.valueCodeableConcept"/>
        <equivalence value="relatedto"/>
        <comment value="For now we can use the mcode extension"/>
      </target>
    </element>
    <element>
      <code value="other"/>
      <display value="Other; specify (O)"/>
      <target>
        <code
              value="Procedure.extension:modalityAndTechnique.extension:modality.valueCodeableConcept.text"/>
        <equivalence value="relatedto"/>
      </target>
    </element>
    <element>
      <code value="treatmentTechnique"/>
      <display value="Treatment technique (M)"/>
      <target>
        <code
              value="Procedure.extension:modalityAndTechnique.extension:technique.valueCodeableConcept"/>
        <equivalence value="relatedto"/>
        <comment value="For now we can use the mcode extension"/>
      </target>
    </element>
    <element>
      <code value="totalDoseGy"/>
      <display value="Total Dose (TD) Gy (M)"/>
      <target>
        <code
              value="Procedure.extension:doseToVolume.extension:totalDoseDelivered"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="totalHighDose"/>
      <display value="Total High Dose (Gy) (R)"/>
      <target>
        <code value="Procedure.extension:totalHighDoseDelivered"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="numberOfFractions"/>
      <display value="Number of fractions (M)"/>
      <target>
        <code
              value="Procedure.extension:doseToVolume.extension:fractionsDelivered"/>
        <equivalence value="relatedto"/>
      </target>
    </element>
    <element>
      <code value="adaptiveRt"/>
      <display value="Adaptive RT (O)"/>
      <target>
        <code value="Procedure.extension:adaptive.value"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="igrt"/>
      <display value="IGRT  (image guide radiotherapy) (O)"/>
      <target>
        <code
              value="Procedure.extension:modalityAndTechnique.extension:technique.valueCodeableConcept"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is present the extension with code 2000100046 'Image guided radiotherapy (IGRT)' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="reirradiation"/>
      <display value="Reirradiation (local or regional) (O)"/>
      <target>
        <code value="Procedure"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is present another procedure in the same site for the same condition it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="fieldOfReirradiation"/>
      <display value="Field of Re-irradiation (O)"/>
      <target>
        <code value="Procedure.reasonCode"/>
        <equivalence value="equivalent"/>
        <comment
                 value="Present only in the second procedure with the same site for the same condition "/>
      </target>
    </element>
    <element>
      <code value="startDate"/>
      <display value="Start date (M)"/>
      <target>
        <code value="Procedure.performedPeriod.start"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="endDate"/>
      <display value="End  date (M)"/>
      <target>
        <code value="Procedure.performedPeriod.end"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="treatmentSitePrimaryOnly"/>
      <display
               value="Treatment site primary only (M (suggest to modify the label into Primary only))"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If bodySite = 1 and is the same of the Condition: Primary Cancer it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="treatmentSiteNeckOnly"/>
      <display
               value="Treatment site neck only (M (suggest to modify the label into Neck only))"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If bodySite = 1 and is 36770046 'Neck' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="treatmentSitePrimaryAndIpsilateralNeck"/>
      <display value="Treatment site primary and ipsilateral neck (M)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If bodySite &gt; 1 and one is the same of the Condition: Primary Cancer and another is 36770046 'Neck' with Procedure.bosySite.extension:lateralityQualifier 4112106 'Ipsilateral' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="treatmentSitePrimaryAndBilateralNeck"/>
      <display value="Treatment site primary and bilateral neck (M)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If bodySite &gt; 1 and one is the same of the Condition: Primary Cancer and another is 36770046 'Neck' with Procedure.bosySite.extension:lateralityQualifier 4197258 'Right and left' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="treatmentSiteDistantMetastasis"/>
      <display value="Treatment site distant metastasis (M)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is 36769180 'Metastasis' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="otherTreatmentSite"/>
      <display value="Other Treatment Site (O)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
    <element>
      <code value="metastaticTreatmentSiteLung"/>
      <display value="Metastatic treatment site lung (R)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is 36770283 'Metastasis to lung' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="metastaticTreatmentSiteMediastinum"/>
      <display value="Metastatic treatment site mediastinum (R)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is 35225542 'Metastasis to mediastinum' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="metastaticTreatmentSiteBone"/>
      <display value="Metastatic treatment site bone (R)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is 36769301 'Metastasis to bone' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="metastaticTreatmentSiteSoftTissue"/>
      <display value="Metastatic treatment site soft tissue (R)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is 35225724 'Metastasis to soft tissues' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="metastaticTreatmentSiteLiver"/>
      <display value="Metastatic treatment site liver (R)"/>
      <target>
        <code value="Procedure.bodySite"/>
        <equivalence value="relatedto"/>
        <comment
                 value="If is 36770544 'Metastasis to liver' it is 'true', else it is 'false'"/>
      </target>
    </element>
    <element>
      <code value="rtTreatmentCompletedAsPlanned"/>
      <display value="RT Treatment Completed as Planned? (M)"/>
      <target>
        <code value="Procedure.extension:terminationReason"/>
        <equivalence value="equivalent"/>
        <comment value="For now we can use the mcode extension"/>
      </target>
    </element>
    <element>
      <code value="regionalDeepHyperthemia"/>
      <display value="Regional deep hyperthemia (M)"/>
      <target>
        <code value="Procedure.partOf"/>
        <equivalence value="relatedto"/>
      </target>
    </element>
    <element>
      <code value="treatmentResponse"/>
      <display value="Treatment response (R)"/>
      <target>
        <code value="Procedure.outcome"/>
        <equivalence value="equivalent"/>
      </target>
    </element>
  </group>
</ConceptMap>