CodeX Radiation Therapy
2.0.0 - STU2  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: Radiotherapy Treatment Plan

Official URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-treatment-plan Version: 2.0.0
Draft as of 2025-02-17 Computable Name: RadiotherapyTreatmentPlan
Other Identifiers: OID:2.16.840.1.113883.4.642.40.14.42.35

A Radiotherapy Treatment Plan resource describes the radiotherapy treatment that is planned to be delivered with a single treatment plan.

Usage

This profile is used to represent a single radiotherapy treatment plan as elaborated in a radiotherapy treatment planning system. An overview of radiotherapy courses, phases, and treatment plans is shown here. In FHIR, treatment plans are represented as filler orders, and the corresponding prescriptions as original orders. The relationships between the various radiotherapy profiles are shown here.

Conformance

ServiceRequest resource instances whose code is SNOMEDCT 1255724003 (Radiotherapy treatment plan (regime/therapy)) and whose intent is http://hl7.org/fhir/request-intent#filler-order "Filler Order" MUST conform to this profile. 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.

NameFlagsCard.TypeDescription & Constraintsdoco
.. ServiceRequest C 0..* USCoreServiceRequestProfile A request for a service to be performed
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
dom-6: A resource should have narrative for robust management
prr-1: orderDetail SHALL only be present if code is present
codexrt-motion-management-none: If the respiratory motion management is 'none', then no other respiratory motion management extensions are allowed. They would also be 'none' or contradict the 'none'. SNOMEDCT code 721031000124102 is "External beam radiotherapy without respiratory motion management (procedure)"
codexrt-free-breathing-technique: The extension for the technique of free-breathing motion management is only allowed if motion management is free-breathing. SNOMEDCT code 721071000124104 is "External beam radiotherapy with free breathing (procedure)"
CategoryPreferred: This code 108290001 is inactive and should be used only for backward compatibility.
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
ele-1: All FHIR elements must have a @value or children
... Slices for extension S 1..* Extension Extension
Slice: Unordered, Open by value:url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... modalityAndTechnique SC 0..1 (Complex) Radiotherapy Modality And Technique Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality-and-technique
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
TechniquesForNeutronBeamModality: Allowed Techniques for Neutron Beam Modality
TechniquesForPhotonBeamModality: Allowed Techniques for Photon Beam Modality
TechniquesForElectronBeamModality: Allowed Techniques for Electron Beam Modality
TechniquesForCarbonIonBeamModality: Allowed Techniques for Carbon Ion Beam Modality
TechniquesForProtonBeamModality: Allowed Techniques for Proton Beam Modality
TechniquesForInternalRadiotherapyPermanentSeeds: Allowed Techniques for Internal Radiotherapy - Permanent Seeds
TechniquesForLowDoseRateUsingTempRadSource: Allowed Techniques for Low Dose Rate Using Temp Radiation Source
TechniquesForPulsedDoseRate: Allowed Techniques for Pulsed Dose Rate
TechniquesForHighDoseRate: Allowed Techniques for High Dose Rate
TechniquesForHighDoseRateElectronic: Allowed Techniques for High Dose Rate Electronic
TechniquesForRadioPharmaceutical: Allowed Techniques for Radiopharmaceutical
ModalityTextRequiredForOther: Require a text literal for code other
TechniqueTextRequiredForOther: Require a text literal for code other
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... modality S 1..1 (Complex) Radiotherapy Modality Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality"
....... value[x] 1..1 CodeableConcept Value of extension
Binding: Radiotherapy Modality Value Set (required)
ele-1: All FHIR elements must have a @value or children
...... technique S 0..* (Complex) Radiotherapy Technique Extension
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-technique
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-technique"
....... value[x] 1..1 CodeableConcept Value of extension
Binding: Radiotherapy Technique Value Set (required)
ele-1: All FHIR elements must have a @value or children
...... radiotherapyEnergyOrIsotope S 0..* SimpleQuantity Radiotherapy Energy or Isotope
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-energy-or-isotope
Binding: Radiotherapy Energy Unit Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... radiotherapyTreatmentApplicatorType S 0..* CodeableConcept Radiotherapy Treatment Applicator Type
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-treatment-applicator-type
Binding: Brachytherapy Applicator Type Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... url 1..1 uri "http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-radiotherapy-modality-and-technique"
.... imageGuidedRadiotherapyModality SC 0..* (Complex) Image Guided Radiotherapy Modality
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-image-guided-radiotherapy-modality
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
IGRTEnergyAllowed: Energy is only allowed for X-Ray, Fluorograph, or CT Modalities.
.... radiotherapyFractionsPlanned S 1..1 positiveInt Number of Planned Fractions
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-fractions-planned
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... radiotherapyDosePlannedToVolume S 0..* (Complex) Planned Dose to a Dose Reference
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-dose-planned-to-volume
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... Slices for extension 1..* Extension Extension
Slice: Unordered, Open by value:url
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... extension:volume S 1..1 Extension Volume targeted by the planned dose
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "volume"
....... value[x] 1..1 Reference(Radiotherapy Volume) Value of extension
ele-1: All FHIR elements must have a @value or children
...... extension:fractionDose S 0..1 Extension Radiation Dose Planned per Fraction
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "fractionDose"
....... value[x] 0..1 Quantity Value of extension
ele-1: All FHIR elements must have a @value or children
Required Pattern: At least the following
........ system 1..1 uri System that defines coded unit form
Fixed Value: http://unitsofmeasure.org
........ code 1..1 code Coded form of the unit
Fixed Value: cGy
...... extension:totalDose S 0..1 Extension Total Physical Radiation Dose Planned
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
....... extension 0..0
....... url 1..1 uri "totalDose"
....... value[x] 1..1 Quantity Value of extension
ele-1: All FHIR elements must have a @value or children
Required Pattern: At least the following
........ system 1..1 uri System that defines coded unit form
Fixed Value: http://unitsofmeasure.org
........ code 1..1 code Coded form of the unit
Fixed Value: cGy
...... pointDose S 0..1 boolean Point Dose
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-point-dose
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... primaryPlanDose S 0..1 boolean Primary Plan Dose
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-primary-plan-dose
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
...... radiobiologicMetric S 0..* Quantity Radiotherapy Biologically Effective Dose
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiobiologic-metric
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... url 1..1 uri "http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-dose-planned-to-volume"
.... radiotherapyReasonForRevisionOrAdaptation S 0..* CodeableConcept Reason for Revision or Adaptation
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-reason-for-revision-or-adaptation
Binding: Radiotherapy Reason for Revision or Adaptation Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... intrafractionVerification SC 0..* (Complex) Intrafraction Verification
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-intrafraction-verification
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
IntrafractionVerificationQualifierAllowed: Qualifier is only allowed for X-Ray procedure.
.... respiratoryMotionManagement S 0..* CodeableConcept Respiratory Motion Management
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management
Binding: Radiotherapy Respiratory Motion Management Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... freeBreathingMotionManagementTechnique S 0..* CodeableConcept Free-Breathing Motion Management Technique
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-free-breathing-motion-mgmt-technique
Binding: Radiotherapy Free-Breathing Motion Management Technique Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... radiotherapyDicomPlan 0..1 (Complex) DICOM Treatment Plan
URL: http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-dicom-reference
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
.... identifier:displayName SΣ 1..1 Identifier The name that is displayed to the user.
ele-1: All FHIR elements must have a @value or children
..... use ?!Σ 1..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .


ele-1: All FHIR elements must have a @value or children
Required Pattern: usual
..... system SΣ 1..1 uri The namespace for the identifier value
ele-1: All FHIR elements must have a @value or children
Example General: http://www.acme.com/identifiers/patient
..... value SΣ 1..1 string The value that is unique
ele-1: All FHIR elements must have a @value or children
Example General: 123456
.... identifier:official SΣ 1..* Identifier A business identifier for the request or procedure, which is independent of its FHIR representation, such as a GUID or DICOM UID.
ele-1: All FHIR elements must have a @value or children
..... use ?!Σ 1..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .


ele-1: All FHIR elements must have a @value or children
Required Pattern: official
..... system SΣ 1..1 uri The namespace for the identifier value
ele-1: All FHIR elements must have a @value or children
Example General: http://www.acme.com/identifiers/patient
..... value SΣ 1..1 string The value that is unique
ele-1: All FHIR elements must have a @value or children
Example General: 123456
... Slices for basedOn Σ 0..* Reference(CarePlan | ServiceRequest | MedicationRequest) What request fulfills
Slice: Unordered, Open by profile:$this.resolve()
ele-1: All FHIR elements must have a @value or children
.... basedOn:plan-prescription SΣ 0..1 Reference(Radiotherapy Plan Prescription) Radiotherapy Plan Prescription that this Treatment Plan fulfills.
ele-1: All FHIR elements must have a @value or children
.... basedOn:planned-phase SΣ 0..1 Reference(Radiotherapy Planned Phase) Radiotherapy Planned Phase that this Treatment Plan fulfills (in most cases together with other treatment plans).
ele-1: All FHIR elements must have a @value or children
.... basedOn:planned-course SΣ 0..1 Reference(Radiotherapy Planned Course) Radiotherapy Planned Course that this Treatment Plan fulfills (in most cases together with other treatment plans).
ele-1: All FHIR elements must have a @value or children
... replaces SΣ 0..* Reference(Radiotherapy Treatment Plan) Previous retired plan that is replaced by this plan
ele-1: All FHIR elements must have a @value or children
... status ?!SΣ 1..1 code (USCDI) draft | active | on-hold | revoked | completed | entered-in-error | unknown
Binding: RequestStatus (required): The status of a service order.


ele-1: All FHIR elements must have a @value or children
... intent ?!SΣ 1..1 code (USCDI) proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option
Binding: RequestIntent (required): The kind of service request.


ele-1: All FHIR elements must have a @value or children
Required Pattern: filler-order
... Slices for category SΣ 1..* CodeableConcept (USCDI) Classification of service
Slice: Unordered, Open by pattern:$this
Binding: ServiceRequestCategoryCodes (example): Classification of the requested service.


ele-1: All FHIR elements must have a @value or children
.... category:us-core SΣ 0..* CodeableConcept (USCDI) Classification of service
Binding: US Core ServiceRequest Category Codes (required): Note that other codes are permitted, see Required Bindings When Slicing by Value Sets


ele-1: All FHIR elements must have a @value or children
.... category:radiotherapy SΣ 1..1 CodeableConcept (USCDI) Classification of service
Binding: Radiotherapy Category Code Max Value Set (required)
ele-1: All FHIR elements must have a @value or children
... code SΣ 1..1 CodeableConcept (USCDI) What is being requested/ordered
Binding: US Core Procedure Codes (extensible)
ele-1: All FHIR elements must have a @value or children
Required Pattern: At least the following
.... coding 1..* Coding Code defined by a terminology system
Fixed Value: (complex)
..... system 1..1 uri Identity of the terminology system
Fixed Value: http://snomed.info/sct
..... code 1..1 code Symbol in syntax defined by the system
Fixed Value: 1255724003
..... display 1..1 string Representation defined by the system
Fixed Value: Radiotherapy treatment plan (regime/therapy)
... subject SΣ 1..1 Reference(US Core Patient Profile) (USCDI) Individual or Entity the service is ordered for
ele-1: All FHIR elements must have a @value or children
... occurrence[x] SΣ 0..1 (USCDI) When service should occur
ele-1: All FHIR elements must have a @value or children
.... occurrencePeriod Period
... authoredOn SΣ 0..1 dateTime (USCDI) Date request signed
ele-1: All FHIR elements must have a @value or children
... requester SΣ 0..1 Reference(US Core Practitioner Profile) (USCDI) Who/what is requesting service
ele-1: All FHIR elements must have a @value or children
... Slices for performer SΣ 0..* Reference(Practitioner | PractitionerRole | Organization | CareTeam | HealthcareService | Patient | Device | RelatedPerson) Requested performer
Slice: Unordered, Open by profile:$this.resolve()
ele-1: All FHIR elements must have a @value or children
.... performer:treatmentOrSeedDevice SΣ 0..* Reference(Radiotherapy Treatment Device | Radiotherapy Seed Device) Radiotherapy Treatment Device or Seed Device used as part of therapy.
ele-1: All FHIR elements must have a @value or children
... locationReference SΣ 0..* Reference(US Core Location Profile) Location where the radiotherapy treatment is requested.
ele-1: All FHIR elements must have a @value or children
... reasonCode SΣ 0..* CodeableConcept (USCDI) Explanation/Justification for procedure or service
Binding: Cancer Disorder Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
... reasonReference SΣ 0..* Reference(Condition) (USCDI) US Core Profile that supports the requested service
ele-1: All FHIR elements must have a @value or children
... bodySite SΣ 0..* CodeableConcept Body site that is treated with radiotherapy
Binding: Radiotherapy Treatment Location Value Set (extensible)
ele-1: All FHIR elements must have a @value or children
.... Slices for extension Content/Rules for all slices
..... locationQualifier 0..* CodeableConcept General location qualifier (excluding laterality) for this bodySite
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-body-location-qualifier
Binding: Body Location Qualifier Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
..... lateralityQualifier 0..1 CodeableConcept Laterality qualifier for this bodySite
URL: http://hl7.org/fhir/us/mcode/StructureDefinition/mcode-laterality-qualifier
Binding: Laterality Qualifier Value Set (required)
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
ServiceRequest.extension:modalityAndTechnique.extension:modality.value[x]requiredRadiotherapyModalityVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-modality-vs
ServiceRequest.extension:modalityAndTechnique.extension:technique.value[x]requiredRadiotherapyTechniqueVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-technique-vs
ServiceRequest.identifier:displayName.userequiredPattern: usual
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
ServiceRequest.identifier:official.userequiredPattern: official
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
ServiceRequest.statusrequiredRequestStatus
http://hl7.org/fhir/ValueSet/request-status|4.0.1
from the FHIR Standard
ServiceRequest.intentrequiredPattern: filler-order
http://hl7.org/fhir/ValueSet/request-intent|4.0.1
from the FHIR Standard
ServiceRequest.categoryexampleServiceRequestCategoryCodes
http://hl7.org/fhir/ValueSet/servicerequest-category
from the FHIR Standard
ServiceRequest.category:us-corerequiredUSCoreServiceRequestCategoryCodes
http://hl7.org/fhir/us/core/ValueSet/us-core-servicerequest-category
ServiceRequest.category:radiotherapyrequiredRadiotherapyCategoryVS
http://hl7.org/fhir/us/codex-radiation-therapy/ValueSet/codexrt-radiotherapy-category-vs
from this IG
ServiceRequest.codeextensiblePattern: SNOMED-CT Code 1255724003("Radiotherapy treatment plan (regime/therapy)")
http://hl7.org/fhir/us/core/ValueSet/us-core-procedure-code
ServiceRequest.reasonCodeextensibleCancerDisorderVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-cancer-disorder-vs
ServiceRequest.bodySiteextensibleRadiotherapyTreatmentLocationVS
http://hl7.org/fhir/us/mcode/ValueSet/mcode-radiotherapy-treatment-location-vs

Constraints

IdGradePath(s)DetailsRequirements
CategoryPreferredwarningServiceRequestThis code 108290001 is inactive and should be used only for backward compatibility.
: category.exists() and category.coding.exists( code = '108290001' ).not()
codexrt-free-breathing-techniqueerrorServiceRequestThe extension for the technique of free-breathing motion management is only allowed if motion management is free-breathing. SNOMEDCT code 721071000124104 is "External beam radiotherapy with free breathing (procedure)"
: extension.exists(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-free-breathing-motion-mgmt-technique') implies extension.exists(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management' and value.exists(coding.exists(code = '721071000124104' and system = 'http://snomed.info/sct')))
codexrt-motion-management-noneerrorServiceRequestIf the respiratory motion management is 'none', then no other respiratory motion management extensions are allowed. They would also be 'none' or contradict the 'none'. SNOMEDCT code 721031000124102 is "External beam radiotherapy without respiratory motion management (procedure)"
: extension.exists(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management' and value.exists(coding.exists(code = '721031000124102' and system = 'http://snomed.info/sct'))) implies extension.where(url = 'http://hl7.org/fhir/us/codex-radiation-therapy/StructureDefinition/codexrt-radiotherapy-respiratory-motion-management').count() = 1

 

Other representations of profile: CSV, Excel, Schematron