HL7 Version 2 to FHIR
1.0.0 - STU 1
HL7 Version 2 to FHIR
1.0.0 - STU 1
HL7 Version 2 to FHIR, published by HL7 International / Orders and Observations. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/v2-to-fhir/ and changes regularly. See the Directory of published versions
| Official URL: http://hl7.org/fhir/uv/v2mappings/ConceptMap/message-adt-a11-to-bundle | Version: 1.0.0 | |||
| Standards status: Informative | Computable Name: MessageADT_A11ToBundle | |||
Copyright/Legal: Copyright (c) 2025, HL7 International, Inc., All Rights Reserved. |
||||
This ConceptMap represents a mapping from the HL7 V2 Message ADT_A11 to the FHIR Message Bundle.
This ConceptMap represents the mapping from the HL7 V2 ADT_A11 Message to the FHIR Message Bundle. See also the FHIR Shorthand or the CSV Source.
| HL7 v2 | Condition (IF True, args) | HL7 FHIR | Comments | |||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Sort Order | Identifier | Syntax | Name | Cardinality - Min | Cardinality - Max | Computable ANTLR | Computable FHIRPath | Narrative | Primary Target | Segment Map | References | |
| 1 | ADT_A11.MSH | MSH | Message Header | 1 | 1 | Bundle | MSH[Bundle] | |||||
| 1 | ADT_A11.MSH | MSH | Message Header | 1 | 1 | MessageHeader | MSH[MessageHeader] | Processing of the MSH segment results in the creation of a new MessageHeader resource. | ||||
| 1 | ADT_A11.MSH | MSH | Message Header | 1 | 1 | If there is a source in MSH-4, or known based on the configuration. | Provenance | MSH[Provenance-Source] | Provenance[1].target.reference=Bundle.id; Provenance[1].target.reference=MessageHeader[1].id | If the FHIR transformation does not yield a FHIR message, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Proviance resource instance to the relevant FHIR resources generated. | ||
| 1 | ADT_A11.MSH | MSH | Message Header | 1 | 1 | Provenance | MSH[Provenance-Transformation] | Provenance[2].target.reference=Bundle.id | If the FHIR transformation does not yield a FHIR Bunlde, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Provenance resource instance to the relevant FHIR resources generated. | |||
| 1 | ADT_A11.MSH | MSH | Message Header | 1 | 1 | Encounter | MSH[Encounter] | Encounter[1].subject.reference=Patient[1].id | ||||
| 2 | ADT_A01.ARV | [{ ARV }] | Access Restrictions | 0 | -1 | |||||||
| 3 | ADT_A11.SFT | [{ SFT }] | Software Segment | 0 | -1 | If the software does represent not the original source system | Provenance.entity.what(Device) | SFT[Device] | Provenance[1].entity.what.reference=Device.id Provenance[1].entity.role="derivation" | |||
| 3 | ADT_A11.SFT | [{ SFT }] | Software Segment | 0 | -1 | If the software represents the original source system | Provenance.entity.what(Device) | SFT[Device] | Provenance[1].entity.what.reference=Device.id Provenance[1].entity.role="source" | |||
| 4 | ADT_A11.UAC | [ UAC ] | User Authentication Credential | 0 | 1 | |||||||
| 5 | ADT_A11.EVN | EVN | Event Type | 1 | 1 | Provenance | EVN[Provenance] | Provenance[3].target.reference=MessageHeader[1].id | ||||
| 5 | ADT_A11.EVN | EVN | Event Type | 1 | 1 | IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED) | Provenance | MSH[Provenance-Operator] | Provenance[3].target.reference=MessageHeader[1].id | If EVN-5 is not valued, then the MSH may have either the sending responsible organization (MSH-22) or the sending facility (MSH-4) to reasonable approximate the agent relevant for this Provenance instance. | ||
| 6 | ADT_A11.PID | PID | Patient Identification | 1 | 1 | Patient | PID[Patient] | Processing of the PID segment results in the creation of a new Patient resource | ||||
| 6 | ADT_A11.PID | PID | Patient Identification | 1 | 1 | Account | PID[Account] | Account.subject.reference=Patient[1].id | ||||
| 6 | ADT_A11.PID | PID | Patient Identification | 1 | 1 | IF PID-33 AND PID-34 VALUED | One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date. | Provenance | PID[Provenance-Patient] | Provenance.target.reference=Patient[1].id | ||
| 7 | ADT_A11.PD1 | [ PD1 ] | Additional Demographics | 0 | 1 | Patient | PD1[Patient] | Incorporate PD1 content into the Patient created from the PID segment. | ||||
| 7 | ADT_A01.PD1 | [ PD1 ] | Additional Demographics | 0 | 1 | IF PD1-7 VALUED | Observation | PD1[Observation-LivingWill] | Observation[1].subject.reference=Patient[1].id | |||
| 8 | ADT_A11.PV1 | PV1 | Patient Visit | 1 | 1 | Encounter | PV1[Encounter] | Encounter[1].subject.reference=Patient[1].id | Processing of the PV1 segment results in the creation of a new Encounter resource | |||
| 8 | ADT_A11.PV1 | PV1 | Patient Visit | 1 | 1 | IF PV1-43 VALUED | Basic | PV1[Basic-EncounterHistory] | Basic.extension-EncounterHistory.subject.reference=Patient[1].id | |||
| 8 | ADT_A11.PV1 | PV1 | Patient Visit | 1 | 1 | Patient | PV1[Patient] | |||||
| 8 | ADT_A11.PV1 | PV1 | Patient Visit | 1 | 1 | IF PV1-20 VALUE | Coverage | PV1[Coverage] | Coverage.beneficiary.reference=Patient[1].id | |||
| 9 | ADT_A11.PV2 | [ PV2 ] | Patient Visit - Additional Info. | 0 | 1 | Encounter | PV2[Encounter] | Encounter[1].subject.reference=Patient[1].id | Incorporate PV2 content into the Encounter created from the PV1 segment. | |||
| 10 | ADT_A11.DB1 | [{ DB1 }] | Disability Information | 0 | -1 | |||||||
| 11 | ADT_A11.OBSERVATION | [{ | --- OBSERVATION begin | 0 | -1 | |||||||
| 11.1 | ADT_A11.OBSERVATION.OBX | OBX | Observation/Result | 0 | -1 | IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS "NA" | Observation | OBX[Observation] | Observation[3].subject.reference=Patient[1].id | One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1]. | ||
| 11.1 | ADT_A11.OBSERVATION.OBX | OBX | Observation/Result | 0 | -1 | IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT "NA" | Observation | OBX[Observation-Component] | Observation[3].subject.reference=Patient[1].id | One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1]. | ||
| 11.2 | /ADT_A11.OBSERVATION | }] | --- OBSERVATION end | |||||||||
| 12 | ADT_A11.DG1 | [{ DG1 }] | Diagnosis Information | 0 | -1 | If in context of the patient | Condition | DG1[Condition] | Condition[1].subject.reference=Patient[1].id | Processing of the DG1 segment results in the creation of a new Condition resource | ||
| 12 | ADT_A11.DG1 | [{ DG1 }] | Diagnosis Information | 0 | -1 | If in context of an encounter | Encounter | DG1[Encounter] | Encounter[1].diagnosis.reference=Condition[1].id | |||
| 12 | ADT_A11.DG1 | [{ DG1 }] | Diagnosis Information | 0 | -1 | If in context of a episode of care | EpisodeOfCare | DG1[EpisodeOfCare] | EpisodeOfCare.patient.reference=Patient[1].id; EpisodeOfCare.diagnosis.reference=Condition[1].id | |||
Mapping from (not specified) to (not specified)
Group 1 Mapping from unspecified code system to unspecified code system
| Source Concept Details | Relationship | Target Concept Details | Comment | ||||
| Codes from | NarrativeCondition | ComputableANTLR | Codes from | ||||
| ADT_A11.MSH | Message Header | is equivalent to | Bundle | Bundle | |||
| ADT_A11.MSH | Message Header | is equivalent to | MessageHeader[1] | MessageHeader[1] | Processing of the MSH segment results in the creation of a new MessageHeader resource. | ||
| ADT_A11.MSH | Message Header | If there is a source in MSH-4, or known based on the configuration. | is equivalent to | Provenance[1] | Provenance[1] | If the FHIR transformation does not yield a FHIR message, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Proviance resource instance to the relevant FHIR resources generated. | |
| ADT_A11.MSH | Message Header | is equivalent to | Provenance[2] | Provenance[2] | If the FHIR transformation does not yield a FHIR Bunlde, but only a set of resource (APIs, repository, etc.) than one should consider attaching this Provenance resource instance to the relevant FHIR resources generated. | ||
| ADT_A11.MSH | Message Header | is equivalent to | Encounter[1] | Encounter[1] | |||
| ADT_A11.SFT | Software Segment | If the software does represent not the original source system | is equivalent to | Provenance[1].entity.what(Device) | Provenance[1].entity.what(Device) | ||
| ADT_A11.SFT | Software Segment | If the software represents the original source system | is equivalent to | Provenance[1].entity.what(Device) | Provenance[1].entity.what(Device) | ||
| ADT_A11.EVN | Event Type | is equivalent to | Provenance[3] | Provenance[3] | |||
| ADT_A11.EVN | Event Type | IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED) | is equivalent to | Provenance[3] | Provenance[3] | If EVN-5 is not valued, then the MSH may have either the sending responsible organization (MSH-22) or the sending facility (MSH-4) to reasonable approximate the agent relevant for this Provenance instance. | |
| ADT_A11.PID | Patient Identification | is equivalent to | Patient[1] | Patient[1] | Processing of the PID segment results in the creation of a new Patient resource | ||
| ADT_A11.PID | Patient Identification | is equivalent to | Account | Account | |||
| ADT_A11.PID | Patient Identification | One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date. | IF PID-33 AND PID-34 VALUED | is equivalent to | Provenance[4] | Provenance[4] | |
| ADT_A11.PD1 | Additional Demographics | is equivalent to | Patient[1] | Patient[1] | Incorporate PD1 content into the Patient created from the PID segment. | ||
| ADT_A01.PD1 | Additional Demographics | IF PD1-7 VALUED | is equivalent to | Observation[1] | Observation[1] | ||
| ADT_A11.PV1 | Patient Visit | is equivalent to | Encounter[1] | Encounter[1] | Processing of the PV1 segment results in the creation of a new Encounter resource | ||
| ADT_A11.PV1 | Patient Visit | IF PV1-43 VALUED | is equivalent to | Basic | Basic | ||
| ADT_A11.PV1 | Patient Visit | is equivalent to | Patient[1] | Patient[1] | |||
| ADT_A11.PV1 | Patient Visit | IF PV1-20 VALUE | is equivalent to | Coverage[1] | Coverage[1] | ||
| ADT_A11.PV2 | Patient Visit - Additional Info. | is equivalent to | Encounter[1] | Encounter[1] | Incorporate PV2 content into the Encounter created from the PV1 segment. | ||
| ADT_A11.OBSERVATION.OBX | Observation/Result | IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS "NA" | is equivalent to | Observation[3] | Observation[3] | One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1]. | |
| ADT_A11.OBSERVATION.OBX | Observation/Result | IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT "NA" | is equivalent to | Observation[3] | Observation[3] | One cannot determine whether this observation made during the PV1/PV2 communicated above, or from a prior visit/stay. It is therefore up to the implementer whether to populate Observation.encounter.reference with the Encounter[1].id or not. Only when the ADT message involves an event before the encounter occurs, e.g., the intiial registration, it is clear that the observation is NOT associated with Encounter[1]. | |
| ADT_A11.DG1 | Diagnosis Information | If in context of the patient | is equivalent to | Condition[1] | Condition[1] | Processing of the DG1 segment results in the creation of a new Condition resource | |
| ADT_A11.DG1 | Diagnosis Information | If in context of an encounter | is equivalent to | Encounter[1] | Encounter[1] | ||
| ADT_A11.DG1 | Diagnosis Information | If in context of a episode of care | is equivalent to | EpisodeOfCare[1] | EpisodeOfCare[1] | ||
IG © 2020+ HL7 International / Orders and Observations. Package hl7.fhir.uv.v2mappings#1.0.0 based on FHIR 4.0.1. Generated 2025-09-08
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change