| Package | hl7.fhir.uv.v2mappings |
| Resource Type | ConceptMap |
| Id | message-adt-a11-to-bundle |
| FHIR Version | R4 |
| Source | http://hl7.org/fhir/uv/v2mappings/https://build.fhir.org/ig/HL7/v2-to-fhir/ConceptMap-message-adt-a11-to-bundle.html |
| URL | http://hl7.org/fhir/uv/v2mappings/ConceptMap/message-adt-a11-to-bundle |
| Version | 1.0.0 |
| Status | active |
| Date | 2025-07-23 |
| Name | MessageADT_A11ToBundle |
| Title | Message ADT_A11 to Bundle Map |
| Realm | uv |
| Authority | hl7 |
| Description | This ConceptMap represents a mapping from the HL7 V2 Message ADT_A11 to the FHIR Message Bundle. |
| Copyright | Copyright (c) 2025, HL7 International, Inc., All Rights Reserved. |
No resources found
No resources found
Note: links and images are rebased to the (stated) source
Generated Narrative: ConceptMap message-adt-a11-to-bundle
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] | ||
FHIR{
"resourceType": "ConceptMap",
"id": "message-adt-a11-to-bundle",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "derived-from"
},
{
"url": "label",
"valueString": "Message ADT:A11 to Bundle.fsh"
},
{
"url": "url",
"valueUri": "https://docs.google.com/spreadsheets/d/1qnrjsHZkYMiOIGb2vhZEjxQWCf6vo-exl8QJ6xp3kH4/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-a11-to-bundle",
"version": "1.0.0",
"name": "MessageADT_A11ToBundle",
"title": "Message ADT_A11 to Bundle Map",
"status": "active",
"experimental": true,
"date": "2025-07-23",
"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_A11 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_A11.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_A11.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_A11.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_A11.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": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.MSH",
"display": "Message Header",
"target": [
{
"code": "Encounter[1]",
"display": "Encounter[1]",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.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_A11.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_A11.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_A11.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_A11.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_A11.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_A11.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_A11.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_A01.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": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.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_A11.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_A11.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_A11.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_A11.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_A11.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": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.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\""
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.DG1",
"display": "Diagnosis Information",
"target": [
{
"code": "Condition[1]",
"display": "Condition[1]",
"equivalence": "equivalent",
"comment": "Processing of the DG1 segment results in the creation of a new Condition resource",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If in context of the patient"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.DG1",
"display": "Diagnosis Information",
"target": [
{
"code": "Encounter[1]",
"display": "Encounter[1]",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If in context of an encounter"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "ADT_A11.DG1",
"display": "Diagnosis Information",
"target": [
{
"code": "EpisodeOfCare[1]",
"display": "EpisodeOfCare[1]",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If in context of a episode of care"
}
]
}
]
}
]
}
]
}