HL7 Version 2 to FHIR
1.0.0 - STU 1 International flag

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

ConceptMap: Segment IAM to AllergyIntolerance Map (Experimental)

Official URL: http://hl7.org/fhir/uv/v2mappings/ConceptMap/segment-iam-to-allergyintolerance Version: 1.0.0
Standards status: Informative Computable Name: SegmentIAMToAllergyIntolerance

Copyright/Legal: Copyright (c) 2025, HL7 International, Inc., All Rights Reserved.

This ConceptMap represents a mapping from the HL7 V2 Segment IAM to the FHIR AllergyIntolerance Resource.

This ConceptMap represents the mapping from the HL7 V2 IAM Segment to the FHIR AllergyIntolerance Resource. See also the FHIR Shorthand or the CSV Source.

HL7 v2Condition (IF True, args)HL7 FHIRComments
Sort OrderIdentifierNameData TypeCardinality - MinCardinality - MaxComputable ANTLRComputable FHIRPathNarrativeFHIR AttributeExtensionData TypeCardinality - MinCardinality - MaxData Type MappingVocabulary Mapping
(IS, ID, CE, CEN, CWE)
Assignment
0AllergyIntolerance.clinicalStatus.coding.codecode01"active"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 IAM.
0AllergyIntolerance.clinicalStatus.coding.systemuri01"http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical"
1IAM-1Set ID - IAMSI11
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.categorycode0-1CWE[code]AllergenType[AllergyIntoleranceCategory]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
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.category.extension.urluri11"http://hl7.org/fhir/StructureDefinition/alternate-codes"
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.category.extension.valueCodeableConceptCodeableConcept11CWE[CodeableConcept]AllergenType[AllergyIntoleranceOriginalCategory]
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.typecode01CWE[code]AllergyType
3IAM-3Allergen Code/Mnemonic/DescriptionCWE11codeCodeableConcept01CWE[CodeableConcept]
4IAM-4Allergy Severity CodeCWE01If severity was not used equivalent to criticalityAllergyIntolerance.reaction.severitycode01CWE[Code]AllergySeverity[AllergyIntolerance.reaction.severity]
4IAM-4Allergy Severity CodeCWE01If severity was used equivalent to criticalityAllergyIntolerance.criticalitycode01CWE[code]AllergySeverity[AllergyIntolerance.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.
4IAM-4Allergy Severity CodeCWE01If severity was used equivalent to criticalityAllergyIntolerance.criticality.extension.urluri11"http://hl7.org/fhir/StructureDefinition/alternate-codes"
4IAM-4Allergy Severity CodeCWE01If severity was used equivalent to criticalityAllergyIntolerance.criticality.extension.valueCodeableConceptCodeableConcept11CWE[CodeableConcept]AllergySeverity[AllergyIntolerance.criticality-original]
5IAM-5Allergy Reaction CodeST01AllergyIntolerance.reaction.manifestation.textCodeableConcept01CWE[CodeableConcept]
5IAM-5Allergy Reaction CodeST01
6IAM-6Allergy Action CodeCNE11
7IAM-7Allergy Unique IdentifierEI01IdentifierIdentifier0-1EI[Identifier-Extension]
8IAM-8Action ReasonST01
9IAM-9Sensitivity to Causative Agent CodeCWE01
10IAM-10Allergen Group Code/Mnemonic/DescriptionCWE01
11IAM-11Onset DateDT01AllergyIntolerance.onsetDateTimedateTime01
12IAM-12Onset Date TextST01IF IAM-11 NOT VALUEDAllergyIntolerance.onsetStringstring01Cannot map to both onsetDateTime and onsetString, so take onsetDateTime if available.
13IAM-13Reported Date/TimeDTM01AllergyIntolerance.recordedDatedateTime01
14IAM-14Reported ByXPN01IF IAM-15 NOT VALUEDIf IAM-15 is not valued, not always 100% clear this is a practitioner, so much review locally.AllergyIntolerance.recorder.reference(AllergyIntolerance.Practitioner.name)HumanName01XPN[HumanName]
14IAM-14Reported ByXPN01IF IAM-15 EQUALS "SEL"AllergyIntolerance.recorder.reference(AllergyIntolerance.Patient.name)HumanName01XPN[HumanName]
14IAM-14Reported ByXPN01IF IAM-15 VALUED AND NOT "SEL"AllergyIntolerance.recorder.reference(AllergyIntolerance.RelatedPerson.name)HumanName01XPN[HumanName]
15IAM-15Relationship to PatientCWE01IF IAM-15 VALUED AND NOT "SEL"AllergyIntolerance.recorder.reference(AllergyIntolerance.RelatedPerson.relationship)CodeableConcept0-1CWE[CodeableConcept]Relationship
16IAM-16Alert Device CodeCWE01
17IAM-17Allergy Clinical StatusCWE01AllergyIntolerance.clinicalStatusCodeableConcept01CWE[CodeableConcept]
18IAM-18Statused by PersonXCN01
19IAM-19Statused by OrganizationXON01
20IAM-20Statused at Date/TimeDTM01
21IAM-21Inactivated by PersonXCN01
22IAM-22Inactivated Date/TimeDTM01
23IAM-23Initially Recorded by PersonXCN01
24IAM-24Initially Recorded Date/TimeDTM01
25IAM-25Modified by PersonXCN01
26IAM-26Modified Date/TimeDTM01
27IAM-27Clinician Identified CodeCWE01codeCodeableConceptCWE[CodeableConcept]The values are added as additional .coding entries in the CodeableConcept for AllergyIntolerance.code
28IAM-28Initially Recorded by OrganizationXON01
29IAM-29Modified by OrganizationXON01
30IAM-30Inactivated by OrganizationXON01

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 NarrativeConditionComputableANTLRCodes from
IAM-2Allergen Type Codeis equivalent tocategorycategoryThe 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\
IAM-2Allergen Type Codeis equivalent tocategory.extension[1].urlcategory.extension[1].url
IAM-2Allergen Type Codeis equivalent tocategory.extension[1].valueCodeableConceptcategory.extension[1].valueCodeableConcept
IAM-2Allergen Type Codeis equivalent totypetype
IAM-3Allergen Code/Mnemonic/Descriptionis equivalent tocode[1]code[1]
IAM-4Allergy Severity CodeIf severity was not used equivalent to criticalityis equivalent toreaction.severityreaction.severity
IAM-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.
IAM-4Allergy Severity CodeIf severity was used equivalent to criticalityis equivalent tocriticality.extension[1].urlcriticality.extension[1].url
IAM-4Allergy Severity CodeIf severity was used equivalent to criticalityis equivalent tocriticality.extension[1].valueCodeableConceptcriticality.extension[1].valueCodeableConcept
IAM-5Allergy Reaction Codeis equivalent toreaction.manifestation.textreaction.manifestation.text
IAM-7Allergy Unique Identifieris equivalent toidentifieridentifier
IAM-11Onset Dateis equivalent toonsetDateTimeonsetDateTime
IAM-12Onset Date TextIF IAM-11 NOT VALUEDis equivalent toonsetStringonsetStringCannot map to both onsetDateTime and onsetString, so take onsetDateTime if available.
IAM-13Reported Date/Timeis equivalent torecordedDaterecordedDate
IAM-14Reported ByIf IAM-15 is not valued, not always 100% clear this is a practitioner, so much review locally.IF IAM-15 NOT VALUEDis equivalent torecorder.reference(Practitioner.name)recorder.reference(Practitioner.name)
IAM-14Reported ByIF IAM-15 EQUALS "SEL"is equivalent torecorder.reference(Patient[1].name)recorder.reference(Patient[1].name)
IAM-14Reported ByIF IAM-15 VALUED AND NOT "SEL"is equivalent torecorder.reference(RelatedPerson.name)recorder.reference(RelatedPerson.name)
IAM-15Relationship to PatientIF IAM-15 VALUED AND NOT "SEL"is equivalent torecorder.reference(RelatedPerson.relationship)recorder.reference(RelatedPerson.relationship)
IAM-17Allergy Clinical Statusis equivalent toclinicalStatusclinicalStatus
IAM-27Clinician Identified Codeis equivalent tocode[1]code[1]The values are added as additional .coding entries in the CodeableConcept for AllergyIntolerance.code

Notes: