| Package | hl7.fhir.uv.v2mappings |
| Resource Type | ConceptMap |
| Id | segment-al1-to-allergyintolerance |
| FHIR Version | R4 |
| Source | http://hl7.org/fhir/uv/v2mappings/https://build.fhir.org/ig/HL7/v2-to-fhir/ConceptMap-segment-al1-to-allergyintolerance.html |
| URL | http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-al1-to-allergyintolerance |
| Version | 1.0.0 |
| Status | active |
| Date | 2025-07-29 |
| Name | SegmentAL1ToAllergyIntolerance |
| Title | Segment AL1 to AllergyIntolerance Map |
| Realm | uv |
| Authority | hl7 |
| Description | This ConceptMap represents a mapping from the HL7 V2 Segment AL1 to the FHIR AllergyIntolerance Resource. |
| 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 segment-al1-to-allergyintolerance
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 | Codes from | ||||
| AL1 | is equivalent to | clinicalStatus.coding.code | clinicalStatus.coding.code | While .clinicalStatus is not required, constraint ait-1 (AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error.) does necessitate populating this element in the map as it's not possible to infer a verificationStatus of "entered-in-error" based on the data in AL1. | ||
| AL1 | is equivalent to | clinicalStatus.coding.system | clinicalStatus.coding.system | |||
| AL1-2 | Allergen Type Code | is equivalent to | category | category | The FHIR table has a "required" binding. Do we need to expand the values in the FHIR table? Could other be used for: Miscellaneous allergy Miscellaneous contraindication Animal Allergy HL70127 is a user defined table\ | |
| AL1-2 | Allergen Type Code | is equivalent to | category.extension[1].url | category.extension[1].url | ||
| AL1-2 | Allergen Type Code | is equivalent to | category.extension[1].valueCodeableConcept | category.extension[1].valueCodeableConcept | ||
| AL1-2 | Allergen Type Code | is equivalent to | type | type | ||
| AL1-3 | Allergen Code/Mnemonic/Description | is equivalent to | code | code | ||
| AL1-4 | Allergy Severity Code | If severity was used equivalent to criticality | is equivalent to | criticality | criticality | Note that AllergyIntolerance.reaction.severity is available in FHIR but from a base standard perspective that is actually not the most appropriate and would require that AL1-6 is valued as well. However, a local implementation may have used vocabulary that better fits AllergyIntolerance.reaction.severity and should then consider that instead as a local variation. Note that the .reaction though is at a particular time, while .criticality is an overall assement that matches HL7 v2 generally better. |
| AL1-4 | Allergy Severity Code | If severity was used equivalent to criticality | is equivalent to | criticality.extension[1].url | criticality.extension[1].url | |
| AL1-4 | Allergy Severity Code | If severity was used equivalent to criticality | is equivalent to | criticality.extension[1].valueCodeableConcept | criticality.extension[1].valueCodeableConcept | |
| AL1-4 | Allergy Severity Code | If severity was not used equivalent to criticality | is equivalent to | reaction.severity | reaction.severity | |
| AL1-5 | Allergy Reaction Code | is equivalent to | reaction.manifestation.text | reaction.manifestation.text | AllergyIntolerance.reaction can repeat, presumably to capture both multiple manifestations of the reaction (rash and nausea) as well as reactions to independent exposures (last week and last month) - we may want to confirm this understanding.\ | |
| AL1-6 | Identification Date | is equivalent to | onsetDateTime | onsetDateTime | Withdrawn as of 2.7, Refer to IAM-11 Onset or IAM-13 Reported Date | |
FHIR{
"resourceType": "ConceptMap",
"id": "segment-al1-to-allergyintolerance",
"text": {
"status": "generated",
"div": "<!-- snip (see above) -->"
},
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "derived-from"
},
{
"url": "label",
"valueString": "Segment AL1 to AllergyIntolerance.fsh"
},
{
"url": "url",
"valueUri": "https://docs.google.com/spreadsheets/d/10aUgY2Kw3sYlbaw-QHykWri8J3Fb3J_Xc7DvCY_nzyE/edit?usp=sharing"
}
],
"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/segment-al1-to-allergyintolerance",
"version": "1.0.0",
"name": "SegmentAL1ToAllergyIntolerance",
"title": "Segment AL1 to AllergyIntolerance Map",
"status": "active",
"experimental": true,
"date": "2025-07-29",
"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 Segment AL1 to the FHIR AllergyIntolerance Resource.",
"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": [
{
"code": "AL1",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"active\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "clinicalStatus.coding.code",
"display": "clinicalStatus.coding.code",
"equivalence": "equivalent",
"comment": "While .clinicalStatus is not required, constraint ait-1 (AllergyIntolerance.clinicalStatus SHALL be present if verificationStatus is not entered-in-error.) does necessitate populating this element in the map as it's not possible to infer a verificationStatus of \"entered-in-error\" based on the data in AL1."
}
]
},
{
"code": "AL1",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "uri"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "clinicalStatus.coding.system",
"display": "clinicalStatus.coding.system",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-2",
"display": "Allergen Type Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": -1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70127-to-allergy-intolerance-category"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "category",
"display": "category",
"equivalence": "equivalent",
"comment": "The FHIR table has a \"required\" binding. Do we need to expand the values in the FHIR table?\n\nCould other be used for:\nMiscellaneous allergy\nMiscellaneous contraindication\nAnimal Allergy\n\nHL70127 is a user defined table\\"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-2",
"display": "Allergen Type Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "uri"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/StructureDefinition/alternate-codes\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "category.extension[1].url",
"display": "category.extension[1].url",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-2",
"display": "Allergen Type Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CodeableConcept"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70127-to-v2-0127"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "category.extension[1].valueCodeableConcept",
"display": "category.extension[1].valueCodeableConcept",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-2",
"display": "Allergen Type Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70127-to-allergy-intolerance-type"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "type",
"display": "type",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-3",
"display": "Allergen Code/Mnemonic/Description",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CodeableConcept"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "code",
"display": "code",
"equivalence": "equivalent"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-4",
"display": "Allergy Severity Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70128-to-allergy-intolerance-criticality"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "criticality",
"display": "criticality",
"equivalence": "equivalent",
"comment": "Note that AllergyIntolerance.reaction.severity is available in FHIR but from a base standard perspective that is actually not the most appropriate and would require that AL1-6 is valued as well. However, a local implementation may have used vocabulary that better fits AllergyIntolerance.reaction.severity and should then consider that instead as a local variation. Note that the .reaction though is at a particular time, while .criticality is an overall assement that matches HL7 v2 generally better.",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If severity was used equivalent to criticality"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-4",
"display": "Allergy Severity Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "uri"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "assignment",
"valueString": "\"http://hl7.org/fhir/StructureDefinition/alternate-codes\""
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "criticality.extension[1].url",
"display": "criticality.extension[1].url",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If severity was used equivalent to criticality"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-4",
"display": "Allergy Severity Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CodeableConcept"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70128-original-to-v2-0128"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "criticality.extension[1].valueCodeableConcept",
"display": "criticality.extension[1].valueCodeableConcept",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If severity was used equivalent to criticality"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CWE"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-4",
"display": "Allergy Severity Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "code"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
},
{
"url": "mappedVia",
"valueUrl": "ConceptMap/table-hl70128-to-reaction-event-severity"
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "reaction.severity",
"display": "reaction.severity",
"equivalence": "equivalent",
"dependsOn": [
{
"property": "Narrative-Condition",
"value": "If severity was not used equivalent to criticality"
}
]
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "ST"
},
{
"url": "cardinalityMin",
"valueInteger": -1
},
{
"url": "cardinalityMax",
"valueInteger": -1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-5",
"display": "Allergy Reaction Code",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "CodeableConcept"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "reaction.manifestation.text",
"display": "reaction.manifestation.text",
"equivalence": "equivalent",
"comment": "AllergyIntolerance.reaction can repeat, presumably to capture both multiple manifestations of the reaction (rash and nausea) as well as reactions to independent exposures (last week and last month) - we may want to confirm this understanding.\\"
}
]
},
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "DT"
},
{
"url": "cardinalityMin",
"valueInteger": 1
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "AL1-6",
"display": "Identification Date",
"target": [
{
"extension": [
{
"extension": [
{
"url": "type",
"valueCode": "dateTime"
},
{
"url": "cardinalityMin",
"valueInteger": 0
},
{
"url": "cardinalityMax",
"valueInteger": 1
}
],
"url": "http://hl7.org/fhir/uv/v2mappings/StructureDefinition/TypeInfo"
}
],
"code": "onsetDateTime",
"display": "onsetDateTime",
"equivalence": "equivalent",
"comment": "Withdrawn as of 2.7, Refer to IAM-11 Onset or IAM-13 Reported Date"
}
]
}
]
}
]
}