HL7 v2 · FHIR R4 · MOSAIQ · ARIA · Epic Beacon
HL7 v2 in. FHIR out.
Radiation oncology still runs on HL7 v2 feeds. New EHR and OIS projects now expect FHIR APIs on top of them. I map both sides, find the interfaces the vendor SOW missed, and give your team the playbooks to run the build.
- 18years in HL7 integration
- 3platforms: MOSAIQ, ARIA, Beacon
- 5ready-to-run playbooks
- 10days to a scoped plan
One event. Two formats.
The same clinical event as an HL7 v2 message and as a FHIR R4 resource. Synthetic data, no PHI. The details under each example are where go-live defects start.
MSH|^~\&|HOSTEHR|MAIN|ARIA|RADONC|20261003091500||ADT^A04^ADT_A01|MSG00001|P|2.5.1
EVN|A04|20261003091500
PID|1||MRN0042^^^MAIN^MR||DOE^JANE^Q||19620314|F
PV1|1|O|RADONC^LINAC2^^MAIN{
"resourceType": "Patient",
"identifier": [
{
"type": {
"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v2-0203", "code": "MR"}]
},
"value": "MRN0042"
}
],
"name": [{"family": "DOE", "given": ["JANE", "Q"]}],
"gender": "female",
"birthDate": "1962-03-14"
}Watch for: PV1 becomes a separate Encounter resource. Decide early which system owns it.
The SOW counted three. The clinic needed seven.
An actual page from the Interface Scope Assessment Kit. Rows marked in mint are the gap. Finding it before kickoff is what these playbooks are built to do, whether the feed is HL7 v2, FHIR, or both.
| ID | Interface | Message type | Source → Target | Status | In vendor SOW? | Est. build hrs |
|---|---|---|---|---|---|---|
| INT-01 | Patient demographics | ADT A01/A08/A40 | Host EHR → ARIA | New build | Yes | 60 |
| INT-02 | Scheduling feed | SIU S12/S14/S15 | Host EHR → ARIA | TBD | Unclear | 60 |
| INT-03 | Orders | ORM O01 | Host EHR → ARIA | New build | Yes | 120 |
| INT-04 | Charges outbound | DFT P03 | ARIA → Billing | New build | Yes | 120 |
| INT-05 | Documents to legal record | MDM T02 | ARIA → Host EHR | TBD | No | 60 |
| INT-07 | Lab results inbound | ORU R01 | LIS → ARIA | TBD | No | 60 |
Ready the same day. Editable forever.
Every playbook ships as working files: Excel workbooks with formulas, dropdowns, and status logic, plus Word guides with role-by-role steps. One payment, no subscription.
Oncology Go-Live Readiness Checklist
1 × XLSX · 1 × DOCX
- T-30 to T+30 task timeline with owners and sign-off gates
- HL7/DICOM interface and data-validation checks
- Command-center plan and rollback decision criteria
MOSAIQ → ARIA Migration Runbook
1 × XLSX (7 tabs) · 1 × DOCX
- Full data-mapping specification including DICOM RT object coverage
- 24-test validation suite with evidence tracking
- Timed cutover runsheet, rollback procedure, and four phase gates
- Live tracker workbook: readiness dashboard, validation pass rate, issue log
TG-263 Structure Nomenclature Remediation Kit
1 × XLSX (7 tabs) · 1 × DOCX
- Six-phase workflow to align an existing department with AAPM Report No. 263
- Frequency triage so clinical review time goes to the names that matter
- Mapping decision rules, exception governance, and a recurring compliance audit
Oncology Workflow Optimization Toolkit
1 × XLSX (6 tabs) · 1 × DOCX
- Two-week audit structure with eight role interview guides
- Weighted scoring rubric and impact-vs-effort prioritization
- ROI calculator that turns each finding into an annual dollar figure
- Executive readout template and 90-day roadmap
Interface Scope Assessment Kit
1 × XLSX (5 tabs) · 2 × DOCX
- Interface inventory matrix with effort model and risk register
- Six role-specific stakeholder interview guides
- Findings report skeleton with section-by-section writing guides
Save $48
Complete Oncology IT Playbook Bundle
All three core playbooks
- Go-Live Readiness Checklist
- MOSAIQ → ARIA Migration Runbook
- Workflow Optimization Toolkit
Interface Scope Assessment. Two weeks, fixed fee.
Before your next OIS deployment or EHR migration starts, I list every interface the project needs, compare it with the vendor SOW, and give your sponsor the gap, the hours, and the risks. A missed interface found mid-project is a five-figure change order. Found in week two, it is a line item.
Week 1 · Discovery
Documents, interviews, workflow traces
SOW and engine route-list review, interviews across clinical, technical, scheduling, and revenue roles, and an end-to-end trace of every clinical workflow.
Week 2 · Analysis
Inventory matrix, effort model, risk register
Every interface classified as existing, modify, or new build, with hours, ownership, and SOW coverage. Every open item gets a named owner and a date.
Day 10 · Readout
Executive presentation and full report
Your sponsor leaves with the real interface count, the contract gap in dollars, and the build sequence. The deliverables are yours to keep.
Done for you
Interface Scope Assessment
Remote · no PHI access required
- Complete interface inventory matrix
- Scored risk register with owners
- Findings report, 15 to 25 pages
- 90-minute executive readout
- Optional: interface workstream lead through go-live
Written inside the go-lives. Not from a template library.
Every item traces to something that happened in a live MOSAIQ, ARIA, or Epic Beacon deployment.
Built in live environments
The failure points are in here because I watched them fail.
Working files, not PDFs
Formulas calculate, dropdowns validate, and status colors update as you work.
Editable and yours
Remove the branding, add your own, and reuse on every project.
HL7 v2 and FHIR
Interface checks cover the v2 feeds you run now and the FHIR APIs coming next.
See the quality before you buy.
Get the HL7-DICOM Reference tab from the assessment kit free: ten message types, what each carries, and the stakeholder phrases that tell you an interface is missing.
One email with the file. No sequence, no spam.
Learn HL7 v2 and FHIR on real integration work
A practical course for health IT analysts and engineers. Lessons release one at a time. The full course is $45, one payment.