HL7 v2 to FHIR R4 maps
The maps of the HL7 Version 2 to FHIR guide (hl7.fhir.uv.v2mappings#1.0.0) and the FHIR R4 elements they write (hl7.fhir.r4.core#4.0.1). The maps are informative guidance, so check them against your own interface.
Apply these maps to a message with the converter.
Message maps 13
Which segments of a message become which resources.
Segment maps 33
Where each field of a segment goes. The list shows the resources a segment feeds.
- AIGAppointment Information - General Resource
- AILAppointment Information - Location Resource
- AIPAppointment Information - Personnel Resource
- AISAppointment Information
- AL1Patient Allergy Information
- DG1Diagnosis
- EVNEvent Type
- IAMPatient Adverse Reaction Information
- IN1Insurance
- IN3Insurance Additional Information, Certification
- MRGMerge Patient Information
- MSAMessage Acknowledgment
- MSHMessage Header
- NK1Next Of Kin / Associated Parties
- NTENotes And Comments
- OBRObservation Request
- OBXObservation/result
- ORCCommon Order
- PD1Patient Additional Demographic
- PIDPatient Identification
- PR1Procedures
- PRTParticipation Information
- PV1Patient Visit
- PV2Patient Visit - Additional Information
- ROLRole
- RXAPharmacy/treatment Administration
- RXOPharmacy/treatment Order
- RXRPharmacy/treatment Route
- SCHScheduling Activity Information
- SFTSoftware Segment
- SPMSpecimen
- TQ1Timing/quantity
- TXATranscription Document Header
Data type maps 42
How a composite HL7 v2 value becomes FHIR elements.
- CECoded Element
- CFCoded Element With Formatted Values
- CNECoded With No Exceptions
- CNNComposite Id Number And Name Simplified
- CQComposite Quantity With Units
- CWECoded With Exceptions
- CXExtended Composite Id With Check Digit
- DLDDischarge To Location And Date
- DLNDriver's License Number
- DRDate/time Range
- DTMDate/time
- EDEncapsulated Data
- EIEntity Identifier
- EIPEntity Identifier Pair
- FNFamily Name
- FTFormatted Text Data
- HDHierarchic Designator
- IDCoded Value For Hl7 Defined Tables
- ISCoded Value For User-defined Tables
- MSGMessage Type
- NANumeric Array
- NDLName With Date And Location
- NMNumeric
- NRNumeric Range
- OG
- PLPerson Location
- PLNPractitioner License Or Other Id Number
- PTProcessing Type
- RIRepeat Interval
- RPReference Pointer
- RPTRepeat Pattern
- SADStreet Address
- SNStructured Numeric
- SPSSpecimen Source
- STString Data
- TQTiming Quantity
- TSTime Stamp
- XADExtended Address
- XCNExtended Composite Id Number And Name For Persons
- XONExtended Composite Name And Identification Number For Organizations
- XPNExtended Person Name
- XTNExtended Telecommunication Number
Code maps 70
Translation of HL7 table codes into FHIR codes.
- 0001Administrative Sex
- 0002Marital Status
- 0003Event Type
- 0003Event Type
- 0004Patient Class
- 0004Patient Class
- 0006Religion
- 0007Admission Type
- 0052Diagnosis Type
- 0062Event Reason
- 0063Relationship
- 0069Hospital Service
- 0074Diagnostic Service Section ID
- 0078Abnormal flags
- 0080Nature of Abnormal Testing
- 0085Observation Result Status Codes Interpretation
- 0092Re-Admission Indicator
- 0116Bed Status
- 0119Order Control Codes
- 0123Result Status
- 0127Allergen Type
- 0127Allergen Type
- 0127Allergen Type
- 0128Allergy Severity
- 0128Allergy Severity
- 0128Allergy Severity
- 0130Visit User Code
- 0131Contact Role
- 0136Yes/no Indicator
- 0136Yes/no Indicator
- 0161Allow Substitution
- 0162Route of Administration
- 0163Body Site
- 0165Administration Method
- 0177Confidentiality Code
- 0185Preferred Method of Contact
- 0190Address Type
- 0190Address Type
- 0200Name Type
- 0201Telecommunication Use Code
- 0202Telecommunication Equipment Type
- 0203Identifier Type
- 0204Organizational Name Type
- 0215Publicity Code
- 0217Visit Priority Code
- 0272Document Confidentiality Status
- 0276Appointment reason codes
- 0277Appointment Type Codes
- 0278Filler status codes
- 0301Universal ID Type
- 0315Living Will Code
- 0322Completion Status
- 0335Repeat Pattern
- 0360Degree/License/Certificate
- 0364Comment Type
- 0371Additive/Preservative
- 0399Country Code
- 0430Mode of Arrival Code
- 0432Admission Level of Care Code
- 0443Provider Role
- 0444Name Assembly Order
- 0482Order Type
- 0485Extended Priority Codes
- 0487Specimen Type
- 0488Specimen Collection Method
- 0490Specimen Reject Reason
- 0493Specimen Condition
- 0528Event Related Period
- 0550Body Parts
- 0912Participation
FHIR resources and types 46
The FHIR elements the maps write, with the HL7 v2 elements that populate each one.
- Account
- Address
- AllergyIntolerance
- Annotation
- Appointment
- Attachment
- Basic
- Bundle
- CareTeam
- CodeableConcept
- Coding
- Condition
- ContactPoint
- Coverage
- Device
- DiagnosticReport
- DocumentReference
- Duration
- Encounter
- EpisodeOfCare
- Extension
- HumanName
- Identifier
- Immunization
- Location
- MedicationAdministration
- MedicationRequest
- MessageHeader
- Meta
- Observation
- Organization
- Patient
- Period
- Practitioner
- PractitionerRole
- Procedure
- Provenance
- Quantity
- Range
- Ratio
- RelatedPerson
- SampledData
- ServiceRequest
- Specimen
- Task
- Timing
Nothing matches the filter.