Skip to content
Radiation Oncology IT

Epic, ARIA, and MOSAIQ Interface Troubleshooting Guide

9 min read · For interface analysts, oncology IT teams, application support staff, and IT leaders keeping Epic-to-oncology interfaces stable.

When an oncology interface breaks, teams often lack a structured way to isolate where the failure is: the source, the engine, the destination, or the mapping. Interface failures in oncology are not just IT tickets. They affect scheduling, treatment documentation, and charges, sometimes silently.

This guide gives you a repeatable triage process and a catalog of common failure patterns specific to oncology. Behavior depends on your versions, interface engine, and local configuration.

A structured triage process

Isolate the failing layer in order and confirm exactly where the message stops. Working top to bottom keeps you from guessing.

LayerWhat to checkIf it fails here
1. Source systemWas the event or message generated?Issue is upstream in the EHR or source
2. Outbound messageDid the source send it? Check the outbound queueSource-side send or config issue
3. Interface engineDid the engine receive and process it?Engine connectivity or routing issue
4. MappingDid the fields map correctly?Mapping or dictionary gap
5. Inbound processingDid the destination accept it?Destination intake or validation rejection
6. Destination systemDid the record land correctly?Destination-side config or data issue

Common failure patterns

  • Dropped or stuck messages from queue backups, connectivity, or engine errors.
  • Patient identity mismatches and duplicates from MRN handling or merges.
  • Missing or duplicate charges.
  • Scheduling and appointment sync errors.
  • Orders not crossing, or crossing incorrectly.
  • Results or documentation not posting back to the EHR.
  • Silent failures with no alerting.

Validate after a fix

  • Reprocess the corrected message and confirm it lands correctly.
  • Confirm the downstream charge or result is right.
  • Make sure the fix did not create duplicates.
  • Confirm monitoring and alerting exists for that route.
  • Document the root cause.

Preventing repeat failures

  • Monitor message flow and error queues.
  • Alert on silent routes.
  • Assign clear ownership for triage.
  • Keep mapping and known-issue documentation current.

Common questions

Can you help during an active outage?
We can help you work the triage process and stabilize the interface. Response depends on current availability and your access setup. Reach out with your situation and timeline.

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.

Stuck on a recurring oncology interface problem?

Get vendor-neutral troubleshooting help to isolate the root cause and put monitoring in place so it does not come back.