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
| Page standards status: Informative |
<ConceptMap xmlns="http://hl7.org/fhir">
<id value="message-adt-a17-to-bundle"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ConceptMap message-adt-a17-to-bundle</b></p><a name="message-adt-a17-to-bundle"> </a><a name="hcmessage-adt-a17-to-bundle"> </a><p>Mapping from (not specified) to (not specified)</p><br/><p><b>Group 1 </b>Mapping from <code>unspecified code system</code> to <code>unspecified code system</code></p><table class="grid"><tr><td colspan="4"><b>Source Concept Details</b></td><td><b>Relationship</b></td><td colspan="2"><b>Target Concept Details</b></td><td><b>Comment</b></td></tr><tr><td colspan="2"><b>Codes</b> from </td><td><b>NarrativeCondition</b></td><td><b>ComputableANTLR</b></td><td/><td colspan="2"><b>Codes</b> from </td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.MSH</td><td style="border-left-width: 0px">Message Header</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Bundle</td><td style="border-left-width: 0px">Bundle</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.MSH</td><td style="border-left-width: 0px">Message Header</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">MessageHeader[1]</td><td style="border-left-width: 0px">MessageHeader[1]</td><td>Processing of the MSH segment results in the creation of a new MessageHeader resource.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.MSH</td><td style="border-left-width: 0px">Message Header</td><td>If there is a source in MSH-4, or known based on the configuration.</td><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[1]</td><td style="border-left-width: 0px">Provenance[1]</td><td>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.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.MSH</td><td style="border-left-width: 0px">Message Header</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[2]</td><td style="border-left-width: 0px">Provenance[2]</td><td>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.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.SFT</td><td style="border-left-width: 0px">Software Segment</td><td>If the software does represent not the original source system</td><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[1].entity.what(Device)</td><td style="border-left-width: 0px">Provenance[1].entity.what(Device)</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.SFT</td><td style="border-left-width: 0px">Software Segment</td><td>If the software represents the original source system</td><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[1].entity.what(Device)</td><td style="border-left-width: 0px">Provenance[1].entity.what(Device)</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.EVN</td><td style="border-left-width: 0px">Event Type</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[3]</td><td style="border-left-width: 0px">Provenance[3]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.EVN</td><td style="border-left-width: 0px">Event Type</td><td/><td>IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[3]</td><td style="border-left-width: 0px">Provenance[3]</td><td>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.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PID</td><td style="border-left-width: 0px">Patient Identification</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Patient[1]</td><td style="border-left-width: 0px">Patient[1]</td><td>Processing of the PID segment results in the creation of a new Patient resource</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PID</td><td style="border-left-width: 0px">Patient Identification</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Account[1]</td><td style="border-left-width: 0px">Account[1]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PID</td><td style="border-left-width: 0px">Patient Identification</td><td>One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date.</td><td>IF PID-33 AND PID-34 VALUED</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[4]</td><td style="border-left-width: 0px">Provenance[4]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PD1</td><td style="border-left-width: 0px">Additional Demographics</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Patient[1]</td><td style="border-left-width: 0px">Patient[1]</td><td>Incorporate PD1 content into the Patient created from the PID segment.</td></tr><tr><td style="border-right-width: 0px">ADT_A01.PD1</td><td style="border-left-width: 0px">Additional Demographics</td><td/><td>IF PD1-7 VALUED</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Observation[3]</td><td style="border-left-width: 0px">Observation[3]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PV1</td><td style="border-left-width: 0px">Patient Visit</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Encounter[1]</td><td style="border-left-width: 0px">Encounter[1]</td><td>Processing of the PV1 segment results in the creation of a new Encounter resource</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PV1</td><td style="border-left-width: 0px">Patient Visit</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Patient[1]</td><td style="border-left-width: 0px">Patient[1]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PV2</td><td style="border-left-width: 0px">Patient Visit - Additional Info.</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Encounter[1]</td><td style="border-left-width: 0px">Encounter[1]</td><td>Incorporate PV2 content into the Encounter created from the PV1 segment.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.OBSERVATION.OBX</td><td style="border-left-width: 0px">Observation/Result</td><td/><td>IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS "NA"</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Observation[1]</td><td style="border-left-width: 0px">Observation[1]</td><td>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].</td></tr><tr><td style="border-right-width: 0px">ADT_A17.OBSERVATION.OBX</td><td style="border-left-width: 0px">Observation/Result</td><td/><td>IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT "NA"</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Observation[1]</td><td style="border-left-width: 0px">Observation[1]</td><td>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].</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PID</td><td style="border-left-width: 0px">Patient Identification</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Patient[2]</td><td style="border-left-width: 0px">Patient[2]</td><td>Processing of the PID segment results in the creation of a new Patient resource</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PID</td><td style="border-left-width: 0px">Patient Identification</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Account[2]</td><td style="border-left-width: 0px">Account[2]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PID</td><td style="border-left-width: 0px">Patient Identification</td><td>One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date.</td><td>IF PID-33 AND PID-34 VALUED</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Provenance[5]</td><td style="border-left-width: 0px">Provenance[5]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PD1</td><td style="border-left-width: 0px">Additional Demographics</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Patient[2]</td><td style="border-left-width: 0px">Patient[2]</td><td>Incorporate PD1 content into the Patient created from the PID segment.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PV1</td><td style="border-left-width: 0px">Patient Visit</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Encounter[2]</td><td style="border-left-width: 0px">Encounter[2]</td><td>Processing of the PV1 segment results in the creation of a new Encounter resource</td></tr><tr><td style="border-right-width: 0px">ADT_A17.PV1</td><td style="border-left-width: 0px">Patient Visit</td><td/><td>IF PV1-43 VALUED</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Basic</td><td style="border-left-width: 0px">Basic</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PV1</td><td style="border-left-width: 0px">Patient Visit</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Patient[1]</td><td style="border-left-width: 0px">Patient[1]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PV1</td><td style="border-left-width: 0px">Patient Visit</td><td/><td>IF PV1-20 VALUE</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Coverage[1]</td><td style="border-left-width: 0px">Coverage[1]</td><td/></tr><tr><td style="border-right-width: 0px">ADT_A17.PV2</td><td style="border-left-width: 0px">Patient Visit - Additional Info.</td><td/><td/><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Encounter[2]</td><td style="border-left-width: 0px">Encounter[2]</td><td>Incorporate PV2 content into the Encounter created from the PV1 segment.</td></tr><tr><td style="border-right-width: 0px">ADT_A17.OBSERVATION.OBX</td><td style="border-left-width: 0px">Observation/Result</td><td>Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.</td><td>IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS "NA"</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Observation[2]</td><td style="border-left-width: 0px">Observation[2]</td><td>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].</td></tr><tr><td style="border-right-width: 0px">ADT_A17.OBSERVATION.OBX</td><td style="border-left-width: 0px">Observation/Result</td><td>Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet.</td><td>IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT "NA"</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td style="border-right-width: 0px">Observation[2]</td><td style="border-left-width: 0px">Observation[2]</td><td>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].</td></tr></table></div>
</text>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact">
<extension url="type">
<valueCode value="derived-from"/>
</extension>
<extension url="label">
<valueString value="Message ADT:A17 to Bundle.fsh"/>
</extension>
<extension url="url">
<valueUri
value="https://docs.google.com/spreadsheets/d/160nkohdfsWd4kjmuDqKi73g5WY3Frsdy4qZn1e9yyZo/edit#gid=0"/>
</extension>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
<valueCode value="oo"/>
</extension>
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
<valueCode value="informative">
<extension
url="http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom">
<valueCanonical
value="http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings"/>
</extension>
</valueCode>
</extension>
<url
value="http://hl7.org/fhir/uv/v2mappings/ConceptMap/message-adt-a17-to-bundle"/>
<version value="1.0.0"/>
<name value="MessageADT_A17ToBundle"/>
<title value="Message ADT_A17 to Bundle Map"/>
<status value="active"/>
<experimental value="true"/>
<date value="2025-08-25"/>
<publisher value="HL7 International / Orders and Observations"/>
<contact>
<name value="HL7 Orders and Observations Workgroup"/>
<telecom>
<system value="url"/>
<value value="http://www.hl7.org/Special/committees/orders"/>
</telecom>
</contact>
<description
value="This ConceptMap represents a mapping from the HL7 V2 Message ADT_A17 to the FHIR Message Bundle."/>
<jurisdiction>
<coding>
<system value="http://unstats.un.org/unsd/methods/m49/m49.htm"/>
<code value="001"/>
</coding>
</jurisdiction>
<copyright
value="Copyright (c) 2025, HL7 International, Inc., All Rights Reserved."/>
<group>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.MSH"/>
<display value="Message Header"/>
<target>
<code value="Bundle"/>
<display value="Bundle"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.MSH"/>
<display value="Message Header"/>
<target>
<code value="MessageHeader[1]"/>
<display value="MessageHeader[1]"/>
<equivalence value="equivalent"/>
<comment
value="Processing of the MSH segment results in the creation of a new MessageHeader resource."/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.MSH"/>
<display value="Message Header"/>
<target>
<code value="Provenance[1]"/>
<display value="Provenance[1]"/>
<equivalence value="equivalent"/>
<comment
value="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."/>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="If there is a source in MSH-4, or known based on the configuration."/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.MSH"/>
<display value="Message Header"/>
<target>
<code value="Provenance[2]"/>
<display value="Provenance[2]"/>
<equivalence value="equivalent"/>
<comment
value="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."/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="-1"/>
</extension>
</extension>
<code value="ADT_A17.SFT"/>
<display value="Software Segment"/>
<target>
<code value="Provenance[1].entity.what(Device)"/>
<display value="Provenance[1].entity.what(Device)"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="If the software does represent not the original source system"/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="-1"/>
</extension>
</extension>
<code value="ADT_A17.SFT"/>
<display value="Software Segment"/>
<target>
<code value="Provenance[1].entity.what(Device)"/>
<display value="Provenance[1].entity.what(Device)"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="If the software represents the original source system"/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.EVN"/>
<display value="Event Type"/>
<target>
<code value="Provenance[3]"/>
<display value="Provenance[3]"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.EVN"/>
<display value="Event Type"/>
<target>
<code value="Provenance[3]"/>
<display value="Provenance[3]"/>
<equivalence value="equivalent"/>
<comment
value="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."/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value
value="IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED)"/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PID"/>
<display value="Patient Identification"/>
<target>
<code value="Patient[1]"/>
<display value="Patient[1]"/>
<equivalence value="equivalent"/>
<comment
value="Processing of the PID segment results in the creation of a new Patient resource"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PID"/>
<display value="Patient Identification"/>
<target>
<code value="Account[1]"/>
<display value="Account[1]"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PID"/>
<display value="Patient Identification"/>
<target>
<code value="Provenance[4]"/>
<display value="Provenance[4]"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value value="IF PID-33 AND PID-34 VALUED"/>
</dependsOn>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date."/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PD1"/>
<display value="Additional Demographics"/>
<target>
<code value="Patient[1]"/>
<display value="Patient[1]"/>
<equivalence value="equivalent"/>
<comment
value="Incorporate PD1 content into the Patient created from the PID segment."/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A01.PD1"/>
<display value="Additional Demographics"/>
<target>
<code value="Observation[3]"/>
<display value="Observation[3]"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value value="IF PD1-7 VALUED"/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV1"/>
<display value="Patient Visit"/>
<target>
<code value="Encounter[1]"/>
<display value="Encounter[1]"/>
<equivalence value="equivalent"/>
<comment
value="Processing of the PV1 segment results in the creation of a new Encounter resource"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV1"/>
<display value="Patient Visit"/>
<target>
<code value="Patient[1]"/>
<display value="Patient[1]"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV2"/>
<display value="Patient Visit - Additional Info."/>
<target>
<code value="Encounter[1]"/>
<display value="Encounter[1]"/>
<equivalence value="equivalent"/>
<comment
value="Incorporate PV2 content into the Encounter created from the PV1 segment."/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="-1"/>
</extension>
</extension>
<code value="ADT_A17.OBSERVATION.OBX"/>
<display value="Observation/Result"/>
<target>
<code value="Observation[1]"/>
<display value="Observation[1]"/>
<equivalence value="equivalent"/>
<comment
value="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]."/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value
value="IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS "NA""/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="-1"/>
</extension>
</extension>
<code value="ADT_A17.OBSERVATION.OBX"/>
<display value="Observation/Result"/>
<target>
<code value="Observation[1]"/>
<display value="Observation[1]"/>
<equivalence value="equivalent"/>
<comment
value="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]."/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value
value="IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT "NA""/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PID"/>
<display value="Patient Identification"/>
<target>
<code value="Patient[2]"/>
<display value="Patient[2]"/>
<equivalence value="equivalent"/>
<comment
value="Processing of the PID segment results in the creation of a new Patient resource"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PID"/>
<display value="Patient Identification"/>
<target>
<code value="Account[2]"/>
<display value="Account[2]"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PID"/>
<display value="Patient Identification"/>
<target>
<code value="Provenance[5]"/>
<display value="Provenance[5]"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value value="IF PID-33 AND PID-34 VALUED"/>
</dependsOn>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date."/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PD1"/>
<display value="Additional Demographics"/>
<target>
<code value="Patient[2]"/>
<display value="Patient[2]"/>
<equivalence value="equivalent"/>
<comment
value="Incorporate PD1 content into the Patient created from the PID segment."/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV1"/>
<display value="Patient Visit"/>
<target>
<code value="Encounter[2]"/>
<display value="Encounter[2]"/>
<equivalence value="equivalent"/>
<comment
value="Processing of the PV1 segment results in the creation of a new Encounter resource"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV1"/>
<display value="Patient Visit"/>
<target>
<code value="Basic"/>
<display value="Basic"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value value="IF PV1-43 VALUED"/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV1"/>
<display value="Patient Visit"/>
<target>
<code value="Patient[1]"/>
<display value="Patient[1]"/>
<equivalence value="equivalent"/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="1"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV1"/>
<display value="Patient Visit"/>
<target>
<code value="Coverage[1]"/>
<display value="Coverage[1]"/>
<equivalence value="equivalent"/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value value="IF PV1-20 VALUE"/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="1"/>
</extension>
</extension>
<code value="ADT_A17.PV2"/>
<display value="Patient Visit - Additional Info."/>
<target>
<code value="Encounter[2]"/>
<display value="Encounter[2]"/>
<equivalence value="equivalent"/>
<comment
value="Incorporate PV2 content into the Encounter created from the PV1 segment."/>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="-1"/>
</extension>
</extension>
<code value="ADT_A17.OBSERVATION.OBX"/>
<display value="Observation/Result"/>
<target>
<code value="Observation[2]"/>
<display value="Observation[2]"/>
<equivalence value="equivalent"/>
<comment
value="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]."/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value
value="IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS "NA""/>
</dependsOn>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet."/>
</dependsOn>
</target>
</element>
<element>
<extension
url="http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo">
<extension url="cardinalityMin">
<valueInteger value="0"/>
</extension>
<extension url="cardinalityMax">
<valueInteger value="-1"/>
</extension>
</extension>
<code value="ADT_A17.OBSERVATION.OBX"/>
<display value="Observation/Result"/>
<target>
<code value="Observation[2]"/>
<display value="Observation[2]"/>
<equivalence value="equivalent"/>
<comment
value="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]."/>
<dependsOn>
<property value="Computable-ANTLR"/>
<value
value="IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT "NA""/>
</dependsOn>
<dependsOn>
<property value="Narrative-Condition"/>
<value
value="Based on profiles, such as Vital Signs, certain observations are represented on the Observation, while others on its components. No computable guidance available yet."/>
</dependsOn>
</target>
</element>
</group>
</ConceptMap>
IG © 2020+ HL7 International / Orders and Observations. Package hl7.fhir.uv.v2mappings#1.0.0 based on FHIR 4.0.1. Generated 2025-08-25
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change