HL7 Version 2 to FHIR
0.1.0 - STU1 Ballot

This page is part of the HL7 Version 2 to FHIR (v0.1.0: STU 1 Ballot 1) based on FHIR R4. . For a full list of available versions, see the Directory of published versions

Coding System Maps

The sections below list the table mappings defined by this guide. Table Mapping is driven by CSV files with specific columns. The use of these columns is described in the section on mapping at the bottom of this page.

Chapter 2C Control|Code Tables

Mapping

  • HL7 v2
    • Sort Order
    • Code
      • The code as used in v2 for the concept
    • Text
      • The text as used in v2 for the concept
    • Code System
      • The code system/value set that the concept is part of.
  • HL7 FHIR
    • Code
      • The code as used in FHIR for the concept
    • Display

When mapping from HL7 v2 messages to FHIR Resources, there are a number of cases where concept mapping needs to be performed. When this mapping is performed, there may be information that is lost because it cannot be represented in a required coding system, or more specific detail may be lost when one or more codes is mapped to a singular required or preferred code in the FHIR specified terminology.

FHIR Data Type Binding v2/FHIR Cardinality Comments
code Required or Preferred 0..1/1..1

As the vocabulary is not the same, and the values are fixed in the FHIR Schema, the only way to record the original code is to attach it to an extension. 

Preferred bindings are ONLY used with the code data type in Resource.language, and these should be treated as if they were required bindings.
0..*/1..* This combination is rarely used in FHIR, only for FHIR definition or conformance resources and CoverageEligibilityRequest and CoverageEligibilityResponse, and so is not applicable to V2 conversion.
Coding Required 0..1/1..1/0..*/1..* This combination is not presently used in FHIR When there is a singular coding allow to a required or preferred term
Preferred 0..1/1..1  
0..*/1..*  
Extensible 0..1/1..1  
0..*/1..*

Only applicable to AuditEvent.entity.securityLabel, AuditEvent.source.type, AuditEvent.subtype, Consent.provision.class, Consent.provision.purpose, Consent.provision.securityLabel, ImagingStudy.modality, and StructureDefinition.keyword
CodableConcept Required 0..1  
0..*/1..1/1..* This combination is not presently used in FHIR
Preferred 0..1/1..1
0..*/1..*  
Extensible 0..1/1..1  
0..*/1..*