CodeX Radiation Therapy
2.0.0 - STU2 United States of America flag

CodeX Radiation Therapy, published by HL7 International / Cross-Group Projects. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/codex-radiation-therapy/ and changes regularly. See the Directory of published versions

Resource Profile: RadiotherapyPlannedPhase - Mappings

Draft as of 2024-12-18

Mappings for the codexrt-radiotherapy-planned-phase resource profile.

Mappings for Workflow Pattern (http://hl7.org/fhir/workflow)

RadiotherapyPlannedPhase
ServiceRequestRequest
   identifierRequest.identifier
   identifier (displayName)Request.identifier
   identifier (official)Request.identifier
   instantiatesCanonicalRequest.instantiatesCanonical
   instantiatesUriRequest.instantiatesUri
   basedOnRequest.basedOn
   basedOn (planned-course)Request.basedOn
   basedOn (phase-prescription)Request.basedOn
   replacesRequest.replaces
   requisitionRequest.groupIdentifier
   statusRequest.status
   intentRequest.intent
   priorityRequest.priority
   codeRequest.code
   subjectRequest.subject
   encounterRequest.encounter
   occurrence[x]Request.occurrence[x]
   authoredOnRequest.authoredOn
   requesterRequest.requester
   performerTypeRequest.performerType
   performerRequest.performer
   performer (treatmentOrSeedDevice)Request.performer
   reasonCodeRequest.reasonCode
   reasonReferenceRequest.reasonReference
   insuranceRequest.insurance
   supportingInfoRequest.supportingInfo
   noteRequest.note
   relevantHistoryRequest.relevantHistory

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

RadiotherapyPlannedPhase
ServiceRequestORC
   identifierORC.2, ORC.3, RF1-6 / RF1-11,
   identifier (displayName)ORC.2, ORC.3, RF1-6 / RF1-11,
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (official)ORC.2, ORC.3, RF1-6 / RF1-11,
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   instantiatesCanonicalVaries by domain
   instantiatesUriVaries by domain
   basedOnORC.8 (plus others)
   basedOn (planned-course)ORC.8 (plus others)
   basedOn (phase-prescription)ORC.8 (plus others)
   replacesHandled by message location of ORC (ORC.1=RO or RU)
   requisitionORC.4
   statusORC.5,RF1-1
   intentN/A
   categoryRF1-5
   category (us-core)RF1-5
   category (radiotherapy)RF1-5
   priorityTQ1.9, RF1-2
   codePR1-3 / OBR-4 (varies by domain)
   orderDetailNTE
   subjectPID
   encounterPV1
   occurrence[x]TQ1/TQ2, OBR-7/OBR-8
   authoredOnORC.9, RF1-7 / RF1-9
   requesterORC.12, PRT
   performerTypePRT, RF!-3
   performerPRT, Practitioner: PRD-2/PRD-7 where PRD-3 = RT; Organization: PRD-10 where PRD-3 = RT
   performer (treatmentOrSeedDevice)PRT, Practitioner: PRD-2/PRD-7 where PRD-3 = RT; Organization: PRD-10 where PRD-3 = RT
   reasonCodeORC.16, RF1-10
   reasonReferenceORC.16
   insuranceIN1/IN2
   supportingInfoAccompanying segments
   bodySiteSPM
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   noteNTE
   patientInstructionNTE
   relevantHistoryN/A

Mappings for RIM Mapping (http://hl7.org/v3)

RadiotherapyPlannedPhase
ServiceRequestEntity. Role, or Act, Act[moodCode<=INT]
   textAct.text?
   containedN/A
   extension
   extension (modalityAndTechnique)
      idn/a
      extension
      extension (modality)
         idn/a
         urlN/A
         value[x]N/A
      extension (technique)
         idn/a
         urlN/A
         value[x]N/A
      extension (radiotherapyEnergyOrIsotope)
      extension (radiotherapyTreatmentApplicatorType)
      urlN/A
   extension (imageGuidedRadiotherapyModality)
   extension (radiotherapyFractionsPlanned)
   extension (radiotherapyDosePlannedToVolume)
      idn/a
      extension
      extension (volume)
         idn/a
         urlN/A
         value[x]N/A
      extension (fractionDose)
         idn/a
         urlN/A
         value[x]N/A
      extension (totalDose)
         idn/a
         urlN/A
         value[x]N/A
      urlN/A
   modifierExtensionN/A
   identifier.identifier
   identifier (displayName).identifier
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (official).identifier
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   instantiatesCanonical.outboundRelationship[typeCode=DEFN].target
   instantiatesUri.outboundRelationship[typeCode=DEFN].target
   basedOn.outboundRelationship[typeCode=FLFS].target
   basedOn (planned-course).outboundRelationship[typeCode=FLFS].target
   basedOn (phase-prescription).outboundRelationship[typeCode=FLFS].target
   replaces.outboundRelationship[typeCode=RPLC].target
   requisition.inboundRelationship(typeCode=COMP].source[moodCode=INT].identifier
   status.status
   intent.moodCode (nuances beyond PRP/PLAN/RQO would need to be elsewhere)
   category.outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="INT"].code
   category (us-core).outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="INT"].code
   category (radiotherapy).outboundRelationship[typeCode="COMP].target[classCode="LIST", moodCode="INT"].code
   priority.priorityCode
   code.code
   orderDetail.code
   subject.participation[typeCode=SBJ].role
   encounter.inboundRelationship(typeCode=COMP].source[classCode<=PCPR, moodCode=EVN]
   occurrence[x].effectiveTime
   authoredOn.participation[typeCode=AUT].time
   requester.participation[typeCode=AUT].role
   performerType.participation[typeCode=PRF].role[scoper.determinerCode=KIND].code
   performer.participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
   performer (treatmentOrSeedDevice).participation[typeCode=PRF].role[scoper.determinerCode=INSTANCE]
   locationCode.participation[typeCode=LOC].role[scoper.determinerCode=KIND].code
   locationReference.participation[typeCode=LOC].role[scoper.determinerCode=INSTANCE]
   reasonCode.reasonCode
   reasonReference.outboundRelationship[typeCode=RSON].target
   insurance.outboundRelationship[typeCode=COVBY].target
   supportingInfo.outboundRelationship[typeCode=PERT].target
   bodySitetargetSiteCode
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   note.inboundRelationship(typeCode=SUBJ].source[classCode=ANNGEN, moodCode=EVN].value[xsi:type=ST]
   patientInstruction.text
   relevantHistory.inboundRelationship(typeCode=SUBJ].source[classCode=CACT, moodCode=EVN]

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

RadiotherapyPlannedPhase
ServiceRequest
   identifierFiveWs.identifier
   identifier (displayName)FiveWs.identifier
   identifier (official)FiveWs.identifier
   statusFiveWs.status
   intentFiveWs.class
   categoryFiveWs.class
   category (us-core)FiveWs.class
   category (radiotherapy)FiveWs.class
   priorityFiveWs.grade
   codeFiveWs.what[x]
   subjectFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   occurrence[x]FiveWs.planned
   authoredOnFiveWs.recorded
   requesterFiveWs.author
   performerTypeFiveWs.actor
   performerFiveWs.actor
   performer (treatmentOrSeedDevice)FiveWs.actor
   locationCodeFiveWs.actor
   locationReferenceFiveWs.actor
   reasonCodeFiveWs.why[x]
   reasonReferenceFiveWs.why[x]

Mappings for Quality Improvement and Clinical Knowledge (QUICK) (http://siframework.org/cqf)

RadiotherapyPlannedPhase
ServiceRequest
   identifierClinicalStatement.identifier
   identifier (displayName)ClinicalStatement.identifier
   identifier (official)ClinicalStatement.identifier
   statusAction.currentStatus
   codeProcedure.procedureCode
   orderDetailProcedure.procedureCode
   subjectClinicalStatement.subject
   encounterClinicalStatement.encounter
   occurrence[x]Procedure.procedureSchedule
   authoredOnProposal.proposedAtTime
   requesterClinicalStatement.statementAuthor
   bodySiteProcedure.targetBodySite
   noteClinicalStatement.additionalText