Skip to content
Radiation Oncology IT

Radiation Oncology HL7/FHIR Integration Guide

10 min read · For interface analysts, integration engineers, oncology IT teams, and IT leaders connecting the oncology information system to the EHR and downstream systems.

Interfaces are where radiation oncology systems meet the rest of the hospital, and where data quality, charges, and clinical accuracy quietly break. Radiation oncology integration is specialized and poorly documented in public resources.

This guide maps what flows where, what commonly breaks, and how to test it, written for the oncology context rather than generic HL7. Exact message profiles depend on system versions and local configuration, so treat this as a working map, not vendor documentation.

HL7 vs FHIR in the oncology context

Classic HL7 v2 still dominates the interfaces that run oncology operations: ADT, orders, results, scheduling, and charges. FHIR concepts are emerging but are not yet the backbone of most oncology environments. Set realistic expectations about FHIR maturity before scoping any project around it.

Core interfaces in a radiation oncology environment

InterfaceDirectionStandardWhat it carries
ADTEHR to OISHL7 v2Patient demographics and encounters
OrdersEHR to OISHL7 v2Orders and order updates
Results / docsOIS to EHRHL7 v2Results and documentation back to the record
SchedulingBidirectionalHL7 v2Appointment data
ChargesOIS to billingHL7 v2Charges to the revenue cycle system
Imaging / RTVariousDICOM / DICOM RTImaging and treatment data touchpoints

Data mapping considerations

  • Patient identity and MRN handling across identity domains.
  • Dictionaries and code sets aligned on both sides.
  • Episode and encounter alignment.
  • Charge codes mapped to the billing system.

Common failure points

  • Identity mismatches and duplicates.
  • Dropped or stuck messages.
  • Mapping gaps between systems.
  • Timing and sequencing issues such as out-of-order ADT.
  • Charge logic mismatches.
  • Silent failures that no one is monitoring.

A testing approach for oncology interfaces

  • Build a test matrix with one row per message type and test case.
  • Define expected versus actual for each.
  • Test edge cases: cancellations, updates, and merges.
  • Validate end to end, including charges.
  • Add monitoring and alerting before go-live, not after.

Common questions

Do you work directly in our interface engine?
Engagements vary. We frequently work alongside your interface team to analyze, map, test, and troubleshoot. Direct engine access depends on your environment and your access policies.
Is this official integration documentation?
No. This is a vendor-neutral working guide. Exact message profiles and capabilities depend on system versions and local configuration. Always validate against your environment.

GlobalSABT is an independent consulting company and is not affiliated with, certified by, or endorsed by Epic, Varian, Elekta, Oracle Cerner, or any other system vendor. Product names describe environments only. Do not submit Protected Health Information, patient identifiers, medical record numbers, or confidential clinical data through this form.

Working on a radiation oncology interface?

Get help with mapping, testing, and troubleshooting from a vendor-neutral team that knows the oncology context.