{ "resourceType" : "ConceptMap", "id" : "segment-al1-to-allergyintolerance", "text" : { "status" : "generated", "div" : "

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 DetailsRelationshipTarget Concept DetailsComment
Codes from NarrativeConditionCodes from
AL1is equivalent toclinicalStatus.coding.codeclinicalStatus.coding.codeWhile .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.
AL1is equivalent toclinicalStatus.coding.systemclinicalStatus.coding.system
AL1-2Allergen Type Codeis equivalent tocategorycategoryThe 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\\
AL1-2Allergen Type Codeis equivalent tocategory.extension[1].urlcategory.extension[1].url
AL1-2Allergen Type Codeis equivalent tocategory.extension[1].valueCodeableConceptcategory.extension[1].valueCodeableConcept
AL1-2Allergen Type Codeis equivalent totypetype
AL1-3Allergen Code/Mnemonic/Descriptionis equivalent tocodecode
AL1-4Allergy Severity CodeIf severity was used equivalent to criticalityis equivalent tocriticalitycriticalityNote 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-4Allergy Severity CodeIf severity was used equivalent to criticalityis equivalent tocriticality.extension[1].urlcriticality.extension[1].url
AL1-4Allergy Severity CodeIf severity was used equivalent to criticalityis equivalent tocriticality.extension[1].valueCodeableConceptcriticality.extension[1].valueCodeableConcept
AL1-4Allergy Severity CodeIf severity was not used equivalent to criticalityis equivalent toreaction.severityreaction.severity
AL1-5Allergy Reaction Codeis equivalent toreaction.manifestation.textreaction.manifestation.textAllergyIntolerance.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-6Identification Dateis equivalent toonsetDateTimeonsetDateTimeWithdrawn as of 2.7, Refer to IAM-11 Onset or IAM-13 Reported Date
" }, "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-08-25", "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" }] }] }] }