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 |
{
"resourceType" : "ConceptMap",
"id" : "message-adt-a02-to-bundle",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: ConceptMap message-adt-a02-to-bundle</b></p><a name=\"message-adt-a02-to-bundle\"> </a><a name=\"hcmessage-adt-a02-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=\"5\"><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>ComputableFHIRPath</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_A02.MSH</td><td style=\"border-left-width: 0px\">Message Header</td><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_A02.MSH</td><td style=\"border-left-width: 0px\">Message Header</td><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_A02.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/><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_A02.MSH</td><td style=\"border-left-width: 0px\">Message Header</td><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_A02.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/><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_A02.SFT</td><td style=\"border-left-width: 0px\">Software Segment</td><td>If the software represents the original source system</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[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_A02.EVN</td><td style=\"border-left-width: 0px\">Event Type</td><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_A02.EVN</td><td style=\"border-left-width: 0px\">Event Type</td><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_A02.PID</td><td style=\"border-left-width: 0px\">Patient Identification</td><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_A02.PID</td><td style=\"border-left-width: 0px\">Patient Identification</td><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</td><td style=\"border-left-width: 0px\">Account</td><td/></tr><tr><td style=\"border-right-width: 0px\">ADT_A02.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/><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_A02.PD1</td><td style=\"border-left-width: 0px\">Additional Demographics</td><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_A02.PD1</td><td style=\"border-left-width: 0px\">Additional Demographics</td><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[1]</td><td style=\"border-left-width: 0px\">Observation[1]</td><td/></tr><tr><td style=\"border-right-width: 0px\">ADT_A02:follow:PID.ROL</td><td style=\"border-left-width: 0px\">Role</td><td/><td>(element("3.1")="PP")and(element("3.3")="HL70443")</td><td>IF ROL-3.1 EQUALS "PP" AND ROL-3.3 EQUALS "HL70443"</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_A02:follow:PID.ROL</td><td style=\"border-left-width: 0px\">Role</td><td>When the ROL includes entries with roles in Table HL70443 other than "PP", then they may be candidates for CareTeam, but not all. That is implementation specific.</td><td>(element("3.1")!="PP")or(element("3.3")!="HL70443")</td><td>IF ROL-3.3 EQUALS "HL70443" AND ROL-3.1 IS NOT "PP"</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\">CareTeam[1]</td><td style=\"border-left-width: 0px\">CareTeam[1]</td><td/></tr><tr><td style=\"border-right-width: 0px\">ADT_A02:follow:PID.PRT</td><td style=\"border-left-width: 0px\">Participation</td><td/><td/><td>IF PRT-4 IS "PP"</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_A02:follow:PID.PRT</td><td style=\"border-left-width: 0px\">Participation</td><td/><td/><td>IF PRT-4 IS IN ("AD", "AP", "ARI", "AT", "CP", "FHCP", "OP", "PH", "PP", "PRI", "RP", "RT", "VP", "PO")</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\">CareTeam[1]</td><td style=\"border-left-width: 0px\">CareTeam[1]</td><td/></tr><tr><td style=\"border-right-width: 0px\">ADT_A02.PV1</td><td style=\"border-left-width: 0px\">Patient Visit</td><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_A02.PV1</td><td style=\"border-left-width: 0px\">Patient Visit</td><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_A02.PV1</td><td style=\"border-left-width: 0px\">Patient Visit</td><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_A02.PV1</td><td style=\"border-left-width: 0px\">Patient Visit</td><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_A02.PV2</td><td style=\"border-left-width: 0px\">Patient Visit - Additional Info.</td><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_A02:follow:PV1.ROL</td><td style=\"border-left-width: 0px\">Role</td><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/></tr><tr><td style=\"border-right-width: 0px\">ADT_A02.OBSERVATION.OBX</td><td style=\"border-left-width: 0px\">Observation/Result</td><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[3]</td><td style=\"border-left-width: 0px\">Observation[3]</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_A02.OBSERVATION.OBX</td><td style=\"border-left-width: 0px\">Observation/Result</td><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[3]</td><td style=\"border-left-width: 0px\">Observation[3]</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>"
},
"extension" : [
{
"extension" : [
{
"url" : "type",
"valueCode" : "derived-from"
},
{
"url" : "label",
"valueString" : "Message ADT:A02 to Bundle.fsh"
},
{
"url" : "url",
"valueUri" : "https://docs.google.com/spreadsheets/d/1BY-JEvMz5f22Tq489SdiWWEW-PqltTODb6JJVejjqTY/edit#gid=0"
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/RelatedArtifact"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
"valueCode" : "oo"
},
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
"valueCode" : "informative",
"_valueCode" : {
"extension" : [
{
"url" : "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
"valueCanonical" : "http://hl7.org/fhir/uv/v2mappings/ImplementationGuide/hl7.fhir.uv.v2mappings"
}
]
}
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/ConceptMap/message-adt-a02-to-bundle",
"version" : "1.0.0",
"name" : "MessageADT_A02ToBundle",
"title" : "Message ADT_A02 to Bundle Map",
"status" : "active",
"experimental" : true,
"date" : "2025-07-10",
"publisher" : "HL7 International / Orders and Observations",
"contact" : [
{
"name" : "HL7 Orders and Observations Workgroup",
"telecom" : [
{
"system" : "url",
"value" : "http://www.hl7.org/Special/committees/orders"
}
]
}
],
"description" : "This ConceptMap represents a mapping from the HL7 V2 Message ADT_A02 to the FHIR Message Bundle.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "http://unstats.un.org/unsd/methods/m49/m49.htm",
"code" : "001"
}
]
}
],
"copyright" : "Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.",
"group" : [
{
"element" : [
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.MSH",
"display" : "Message Header",
"target" : [
{
"code" : "Bundle",
"display" : "Bundle",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.MSH",
"display" : "Message Header",
"target" : [
{
"code" : "MessageHeader[1]",
"display" : "MessageHeader[1]",
"equivalence" : "equivalent",
"comment" : "Processing of the MSH segment results in the creation of a new MessageHeader resource."
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.MSH",
"display" : "Message Header",
"target" : [
{
"code" : "Provenance[1]",
"display" : "Provenance[1]",
"equivalence" : "equivalent",
"comment" : "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" : "Narrative-Condition",
"value" : "If there is a source in MSH-4, or known based on the configuration."
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.MSH",
"display" : "Message Header",
"target" : [
{
"code" : "Provenance[2]",
"display" : "Provenance[2]",
"equivalence" : "equivalent",
"comment" : "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."
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.SFT",
"display" : "Software Segment",
"target" : [
{
"code" : "Provenance[1].entity.what(Device)",
"display" : "Provenance[1].entity.what(Device)",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Narrative-Condition",
"value" : "If the software does represent not the original source system"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.SFT",
"display" : "Software Segment",
"target" : [
{
"code" : "Provenance[1].entity.what(Device)",
"display" : "Provenance[1].entity.what(Device)",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Narrative-Condition",
"value" : "If the software represents the original source system"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.EVN",
"display" : "Event Type",
"target" : [
{
"code" : "Provenance[3]",
"display" : "Provenance[3]",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.EVN",
"display" : "Event Type",
"target" : [
{
"code" : "Provenance[3]",
"display" : "Provenance[3]",
"equivalence" : "equivalent",
"comment" : "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" : "Computable-ANTLR",
"value" : "IF EVN-5 NOT VALUED AND (MSH-22 IS VALUED OR MSH-4 IS VALUED)"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PID",
"display" : "Patient Identification",
"target" : [
{
"code" : "Patient[1]",
"display" : "Patient[1]",
"equivalence" : "equivalent",
"comment" : "Processing of the PID segment results in the creation of a new Patient resource"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PID",
"display" : "Patient Identification",
"target" : [
{
"code" : "Account",
"display" : "Account",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PID",
"display" : "Patient Identification",
"target" : [
{
"code" : "Provenance[4]",
"display" : "Provenance[4]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF PID-33 AND PID-34 VALUED"
},
{
"property" : "Narrative-Condition",
"value" : "One may drop PID-33 from the condition if PID-34 Last Update Facility is still sufficient without a date."
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PD1",
"display" : "Additional Demographics",
"target" : [
{
"code" : "Patient[1]",
"display" : "Patient[1]",
"equivalence" : "equivalent",
"comment" : "Incorporate PD1 content into the Patient created from the PID segment."
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PD1",
"display" : "Additional Demographics",
"target" : [
{
"code" : "Observation[1]",
"display" : "Observation[1]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF PD1-7 VALUED"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02:follow:PID.ROL",
"display" : "Role",
"target" : [
{
"code" : "Patient[1]",
"display" : "Patient[1]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF ROL-3.1 EQUALS \"PP\" AND ROL-3.3 EQUALS \"HL70443\""
},
{
"property" : "Computable-FHIRPath",
"value" : "(element(\"3.1\")=\"PP\")and(element(\"3.3\")=\"HL70443\")"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02:follow:PID.ROL",
"display" : "Role",
"target" : [
{
"code" : "CareTeam[1]",
"display" : "CareTeam[1]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF ROL-3.3 EQUALS \"HL70443\" AND ROL-3.1 IS NOT \"PP\""
},
{
"property" : "Computable-FHIRPath",
"value" : "(element(\"3.1\")!=\"PP\")or(element(\"3.3\")!=\"HL70443\")"
},
{
"property" : "Narrative-Condition",
"value" : "When the ROL includes entries with roles in Table HL70443 other than \"PP\", then they may be candidates for CareTeam, but not all. That is implementation specific."
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02:follow:PID.PRT",
"display" : "Participation",
"target" : [
{
"code" : "Patient[1]",
"display" : "Patient[1]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF PRT-4 IS \"PP\""
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02:follow:PID.PRT",
"display" : "Participation",
"target" : [
{
"code" : "CareTeam[1]",
"display" : "CareTeam[1]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF PRT-4 IS IN (\"AD\", \"AP\", \"ARI\", \"AT\", \"CP\", \"FHCP\", \"OP\", \"PH\", \"PP\", \"PRI\", \"RP\", \"RT\", \"VP\", \"PO\")"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PV1",
"display" : "Patient Visit",
"target" : [
{
"code" : "Encounter[1]",
"display" : "Encounter[1]",
"equivalence" : "equivalent",
"comment" : "Processing of the PV1 segment results in the creation of a new Encounter resource"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PV1",
"display" : "Patient Visit",
"target" : [
{
"code" : "Basic",
"display" : "Basic",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF PV1-43 VALUED"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PV1",
"display" : "Patient Visit",
"target" : [
{
"code" : "Patient[1]",
"display" : "Patient[1]",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PV1",
"display" : "Patient Visit",
"target" : [
{
"code" : "Coverage[1]",
"display" : "Coverage[1]",
"equivalence" : "equivalent",
"dependsOn" : [
{
"property" : "Computable-ANTLR",
"value" : "IF PV1-20 VALUE"
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.PV2",
"display" : "Patient Visit - Additional Info.",
"target" : [
{
"code" : "Encounter[1]",
"display" : "Encounter[1]",
"equivalence" : "equivalent",
"comment" : "Incorporate PV2 content into the Encounter created from the PV1 segment."
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 0
},
{
"url" : "cardinalityMax",
"valueInteger" : -1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02:follow:PV1.ROL",
"display" : "Role",
"target" : [
{
"code" : "Encounter[1]",
"display" : "Encounter[1]",
"equivalence" : "equivalent"
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.OBSERVATION.OBX",
"display" : "Observation/Result",
"target" : [
{
"code" : "Observation[3]",
"display" : "Observation[3]",
"equivalence" : "equivalent",
"comment" : "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" : "Computable-ANTLR",
"value" : "IF OBX-5 LST.count LESS THAN OR EQUALS 1 OR OBX-2 IS \"NA\""
}
]
}
]
},
{
"extension" : [
{
"extension" : [
{
"url" : "cardinalityMin",
"valueInteger" : 1
},
{
"url" : "cardinalityMax",
"valueInteger" : 1
}
],
"url" : "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code" : "ADT_A02.OBSERVATION.OBX",
"display" : "Observation/Result",
"target" : [
{
"code" : "Observation[3]",
"display" : "Observation[3]",
"equivalence" : "equivalent",
"comment" : "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" : "Computable-ANTLR",
"value" : "IF OBX-5 LST.count GREATER THAN 1 AND OBX-2 IS NOT \"NA\""
}
]
}
]
}
]
}
]
}
IG © 2020+ HL7 International / Orders and Observations. Package hl7.fhir.uv.v2mappings#1.0.0 based on FHIR 4.0.1. Generated 2025-07-10
Links: Table of Contents |
QA Report
| Version History |
|
Propose a change