HL7 Version 2 to FHIR
1.0.0-ballot - ballot 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-ballot 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/segment-iam-to-allergyintolerance Version: 1.0.0-ballot
Active as of 2024-12-20 Computable Name: SegmentIAMToAllergyIntolerance

Copyright/Legal: Copyright (c) 2020, 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.codeAllergyIntolerance.code01"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.systemAllergyIntolerance.uri01"http://terminology.hl7.org/CodeSystem/allergyintolerance-clinical"
1IAM-1Set ID - IAMSI11
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.categoryAllergyIntolerance.code0-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.urlAllergyIntolerance.uri11"http://hl7.org/fhir/StructureDefinition/alternate-codes"
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.category.extension.valueCodeableConceptAllergyIntolerance.CodeableConcept11CWE[CodeableConcept]AllergenType[AllergyIntoleranceOriginalCategory]
2IAM-2Allergen Type CodeCWE01AllergyIntolerance.typeAllergyIntolerance.code01CWE[code]AllergenType
3IAM-3Allergen Code/Mnemonic/DescriptionCWE11AllergyIntolerance.codeAllergyIntolerance.CodeableConcept01CWE[CodeableConcept]
4IAM-4Allergy Severity CodeCWE01If severity was not used equivalent to criticalityAllergyIntolerance.reaction.severityAllergyIntolerance.code01CWE[Code]AllergySeverity[AllergyIntolerance.reaction.severity]
4IAM-4Allergy Severity CodeCWE01If severity was used equivalent to criticalityAllergyIntolerance.criticalityAllergyIntolerance.code01CWE[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.urlAllergyIntolerance.uri11"http://hl7.org/fhir/StructureDefinition/alternate-codes"
4IAM-4Allergy Severity CodeCWE01If severity was used equivalent to criticalityAllergyIntolerance.criticality.extension.valueCodeableConceptAllergyIntolerance.CodeableConcept11CWE[CodeableConcept]AllergySeverity[AllergyIntolerance.criticality-original]
5IAM-5Allergy Reaction CodeST01AllergyIntolerance.reaction.manifestation.textAllergyIntolerance.CodeableConcept01CWE[CodeableConcept]
5IAM-5Allergy Reaction CodeST01
6IAM-6Allergy Action CodeCNE11
7IAM-7Allergy Unique IdentifierEI01AllergyIntolerance.identifierAllergyIntolerance.identifier0-1EI[Identifier-Extension]
8IAM-8Action ReasonST01
9IAM-9Sensitivity to Causative Agent CodeCWE01
10IAM-10Allergen Group Code/Mnemonic/DescriptionCWE01
11IAM-11Onset DateDT01AllergyIntolerance.onsetDateTimeAllergyIntolerance.dateTime01
12IAM-12Onset Date TextST01IF IAM-11 NOT VALUEDAllergyIntolerance.onsetStringAllergyIntolerance.string01Cannot map to both onsetDateTime and onsetString, so take onsetDateTime if available.
13IAM-13Reported Date/TimeDTM01AllergyIntolerance.recordedDateAllergyIntolerance.dateTime01
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)AllergyIntolerance.HumanName01XPN[HumanName]
14IAM-14Reported ByXPN01IF IAM-15 EQUALS "SEL"AllergyIntolerance.recorder.reference(AllergyIntolerance.Patient.name)AllergyIntolerance.HumanName01XPN[HumanName]
14IAM-14Reported ByXPN01IF IAM-15 VALUED AND NOT "SEL"AllergyIntolerance.recorder.reference(AllergyIntolerance.RelatedPerson.name)AllergyIntolerance.HumanName01XPN[HumanName]
15IAM-15Relationship to PatientCWE01IF IAM-15 VALUED AND NOT "SEL"AllergyIntolerance.recorder.reference(AllergyIntolerance.RelatedPerson.relationship)AllergyIntolerance.CodeableConcept0-1CWE[CodeableConcept]Relationship
16IAM-16Alert Device CodeCWE01
17IAM-17Allergy Clinical StatusCWE01AllergyIntolerance.clinicalStatusAllergyIntolerance.CodeableConcept01CWE[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 CodeCWE01AllergyIntolerance.codeAllergyIntolerance.CodeableConceptCWE[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

Generated Narrative: ConceptMap segment-iam-to-allergyintolerance

Mapping from IAM to AllergyIntolerance


Group 1 Mapping from unspecified code system to unspecified code system

Source CodeRelationshipTarget CodeComment
IAM-2 (Allergen Type Code)is equivalent tocategoryThe 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-2 (Allergen Type Code)is equivalent tocategory.extension[1].url
IAM-2 (Allergen Type Code)is equivalent tocategory.extension[1].valueCodeableConcept
IAM-2 (Allergen Type Code)is equivalent totype
IAM-3 (Allergen Code/Mnemonic/Description)is equivalent tocode[1]
IAM-4 (Allergy Severity Code)is equivalent toreaction.severity
IAM-4 (Allergy Severity Code)is equivalent tocriticalityNote 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-4 (Allergy Severity Code)is equivalent tocriticality.extension[1].url
IAM-4 (Allergy Severity Code)is equivalent tocriticality.extension[1].valueCodeableConcept
IAM-5 (Allergy Reaction Code)is equivalent toreaction.manifestation.text
IAM-7 (Allergy Unique Identifier)is equivalent toidentifier
IAM-11 (Onset Date)is equivalent toonsetDateTime
IAM-12 (Onset Date Text)is equivalent toonsetStringCannot map to both onsetDateTime and onsetString, so take onsetDateTime if available.
IAM-13 (Reported Date/Time)is equivalent torecordedDate
IAM-14 (Reported By)is equivalent torecorder.reference(Practitioner.name)
IAM-14 (Reported By)is equivalent torecorder.reference(Patient[1].name)
IAM-14 (Reported By)is equivalent torecorder.reference(RelatedPerson.name)
IAM-15 (Relationship to Patient)is equivalent torecorder.reference(RelatedPerson.relationship)
IAM-17 (Allergy Clinical Status)is equivalent toclinicalStatus
IAM-27 (Clinician Identified Code)is equivalent tocode[1]The values are added as additional .coding entries in the CodeableConcept for AllergyIntolerance.code

Notes: