HL7v2 & EHR → FHIR Mappings
Field-by-field references for mapping HL7v2 messages and EHR extracts (Epic, Cerner, MEDITECH) to FHIR US Core resources. Each page is derived from a real Interoperall mapping template you can fork in one click — so the source field, FHIR path, and transform shown here are exactly what runs.
HL7v2 Standard
- ADT^A01 → US Core Patient — Inpatient admission. Maps PID demographics to US Core Patient (MRN, name, DOB, gender, address, phone).
- ADT^A03 → US Core Patient (with discharge) — Discharge event. Same Patient demographics as A01, plus PV1-45 discharge timestamp into an extension.
- ADT^A04 → US Core Patient (outpatient registration) — Outpatient registration event. Maps PID demographics plus PV1 outpatient class into US Core Patient.
- ADT^A08 → US Core Patient (info update) — Patient information update. Re-applies full demographics so receivers reconcile latest PID values.
- ORU^R01 → US Core Observation — Lab result. Maps OBX into an Observation with code, value, units, and reference range.
- ORU^R01 vital signs → US Core Observation (panel) — Vital signs panel (BP, HR, temperature, SpO2). Maps the first OBX (systolic BP) into a US Core Vital Signs Observation; pair with extra rules per OBX as needed.
- RDE^O11 → US Core MedicationRequest — Pharmacy/treatment encoded order. Maps RXE into a MedicationRequest with code, dose, frequency.
- SIU^S12 → FHIR Appointment — New appointment booking. Maps SCH/AIL into a FHIR Appointment (status, type, start/end, location).
- VXU^V04 → US Core Immunization — Vaccination update. Maps RXA into a US Core Immunization (CVX code, dose, date, status).
- MDM^T02 → US Core DocumentReference — Document notification with content. Maps TXA + OBX into a US Core DocumentReference with type, status, author, and inline content.
Generic
- Generic CSV → Patient (basic demographics) — A simple flat CSV row with familiar column names mapped into a FHIR Patient resource.
Epic
- Epic Clarity PATIENT → US Core Patient — Epic Clarity PATIENT table extract (CSV). Maps PAT_ID, PAT_NAME parts, BIRTH_DATE, SEX_C into US Core Patient.
- Epic Clarity PAT_ENC → US Core Encounter — Epic Clarity PAT_ENC table extract (CSV). Maps encounter id, admit/discharge times, department, class into US Core Encounter.
- Epic Clarity ORDER_RESULTS → US Core Observation (lab) — Epic Clarity ORDER_RESULTS row (CSV). Maps LOINC code, numeric / string value, units, and reference ranges into a US Core Lab Observation.
MEDITECH
- MEDITECH MAGIC PATIENT.MIS → US Core Patient — MEDITECH MAGIC PATIENT.MIS extract (CSV). Maps PT_ID, PT_NAME parts, PT_DOB, PT_SEX, address, phone into US Core Patient.
- MEDITECH MAGIC ADM.MIS → US Core Encounter — MEDITECH MAGIC ADM.MIS admission extract (CSV). Maps admit/discharge dates, location, class into US Core Encounter.
Cerner
- Cerner PERSON → US Core Patient — Cerner Millennium PERSON table extract (CSV). Maps PERSON_ID, NAME_FIRST/LAST, BIRTH_DT_TM, SEX_CD, address into US Core Patient.
- Cerner ENCOUNTER → US Core Encounter — Cerner Millennium ENCOUNTER table extract (CSV). Maps ENCNTR_ID, REG_DT_TM, DISCH_DT_TM, ENCNTR_TYPE_CD, LOC_NURSE_UNIT_CD into US Core Encounter.
Related tools
Mapping Library — browse and fork every template. Mapping Builder — build and run your own.