US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: AllergyIntolerance - Mappings

Active as of 2025-03-31

Mappings for the AllergyIntolerance resource profile.

Scroll down for the Raw FHIR, CDW & SDA mappings (if any).

Note that the CDW and SDA mappings are derived from a look-up based on the VistA source mappings in CDW and VPR SDA.

Mapping Sources

Use Case: AllergyIntolerance (Source)PATIENT ALLERGIES (120.8).001IEN.01PATIENT.02REACTANT1GMR ALLERGY2DRUG INGREDIENTS3.1ALLERGY TYPE4ORIGINATION DATE/TIME5ORIGINATOR10REACTIONS17MECHANISM19VERIFIED22ENTERED IN ERROR26COMMENTSREACTIONS (120.81).01REACTION3DATE ENTEREDSIGN/SYMPTOMS (120.83).01NAME99.99VUIDADVERSE REACTION REPORTING (120.85)14.5SEVERITYCOMMENTS (120.826).01DATE/TIME COMMENT ENTERED1USER ENTERING2COMMENTS[6 OBSERVED/HISTORICAL = O]

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
233 team-approved V2F PATIENT ALLERGIES - IEN (120.8-.001) source value AllergyIntolerance.identifier[va-IEN] .value .system = http://va.gov/identifiers/$Sta3n/120.8 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
233-1 team-approved V2F fixed value AllergyIntolerance.identifier[va-IEN] .system http://va.gov/identifiers/$Sta3n/120.8 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1610 for review C2F CDW.cdwwork.allergy.allergy.AllergySID source value AllergyIntolerance.identifier[va-CDW] .value .system = http://va.gov/identifiers/CDWSID/cdwwork.allergy.allergy Source is AllergySID from Allergy Table in CDW http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1610-1 for review C2F fixed value AllergyIntolerance.identifier[va-CDW] .system http://va.gov/identifiers/CDWSID/cdwwork.allergy.allergy generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
245 team-approved V2F PATIENT ALLERGIES - REACTANT (120.8-.02) source value AllergyIntolerance.code .text text only http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
246 team-approved V2F PATIENT ALLERGIES - GMR ALLERGY (120.8-1) source value AllergyIntolerance.code http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
248 for review V2F PATIENT ALLERGIES - PATIENT (120.8-.01) reference AllergyIntolerance.patient /Patient Source is MVIPersonFullICN from SMVIPerson Table http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1224 team-approved V2F PATIENT ALLERGIES - ORIGINATION DATE/TIME (120.8-4) source value AllergyIntolerance.recordedDate Lighthouse exposes this source object as RecordedDate FHIR field http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
251 team-approved V2F PATIENT ALLERGIES - ORIGINATOR (120.8-5) reference AllergyIntolerance.recorder /Practitioner http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
252 team-approved V2F PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS (120.8-10 > 120.81-.01 > 120.83-) source value AllergyIntolerance.reaction.manifestation .coding.system=urn:oid:2.16.840.1.113883.6.233
.coding.code = {VUID (99.99)}
.coding.display = {NAME (.01)} 
.text = {NAME (.01)}
http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
252-1 team-approved V2F fixed value AllergyIntolerance.reaction.manifestation .coding.system urn:oid:2.16.840.1.113883.6.233 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
252-2 team-approved V2F PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS - VUID (120.8-10 > 120.81-.01 > 120.83-99.99) source value AllergyIntolerance.reaction.manifestation .coding.code generated from mapParameter line 2 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
252-3 team-approved V2F PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS - NAME (120.8-10 > 120.81-.01 > 120.83-.01) source value AllergyIntolerance.reaction.manifestation .coding.display generated from mapParameter line 3 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
252-4 team-approved V2F PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS - NAME (120.8-10 > 120.81-.01 > 120.83-.01) source value AllergyIntolerance.reaction.manifestation .text generated from mapParameter line 4 http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
531 team-approved V2F PATIENT ALLERGIES - MECHANISM (120.8-17) terminologyMaps AllergyIntolerance.type VF_allergyMechanism http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
535 team-approved V2F PATIENT ALLERGIES - VERIFIED (120.8-19) terminologyMaps AllergyIntolerance.verificationStatus VF_allergyVerificationStatus http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
536 for review V2F PATIENT ALLERGIES - ENTERED IN ERROR (120.8-22) terminologyMaps AllergyIntolerance.clinicalStatus VF_allergyActive confirm CHAPI http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
537 team-approved V2F PATIENT ALLERGIES - ENTERED IN ERROR (120.8-22) terminologyMaps AllergyIntolerance.verificationStatus VF_allergyEnteredInError http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
556 team-approved V2F PATIENT ALLERGIES - ALLERGY TYPE (120.8-3.1) terminologyMaps AllergyIntolerance.category VF_allergySubstanceCategory http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
557 for review V2F ADVERSE REACTION REPORTING - SEVERITY (120.85-14.5) terminologyMaps AllergyIntolerance.reaction.severity VF_allergySeverity This Data is not in CDW Assess for CHAPI via VPR http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1502 for review V2F PATIENT ALLERGIES - COMMENTS > COMMENTS - DATE/TIME COMMENT ENTERED (120.8-26 > 120.826-.01) source value AllergyIntolerance.note .time http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1503 for review V2F PATIENT ALLERGIES - COMMENTS > COMMENTS - USER ENTERING (120.8-26 > 120.826-1) source value AllergyIntolerance.note .authorString http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1504 for review V2F PATIENT ALLERGIES - COMMENTS > COMMENTS - COMMENTS (120.8-26 > 120.826-2) source value AllergyIntolerance.note .text http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1505 for review V2F PATIENT ALLERGIES - DRUG INGREDIENTS (120.8-2) source value AllergyIntolerance.code CHAPI to rxn code; looking into http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1
1652 for review V2F PATIENT ALLERGIES - REACTIONS > REACTIONS - DATE ENTERED (120.8-10 > 120.81-3) source value 6 OBSERVED/HISTORICAL = O AllergyIntolerance.reaction.onset http://hl7.org/fhir/us/core/StructureDefinition/us-core-allergyintolerance | 5.0.1

Mappings for Veterans Health Information Systems Technology and Architecture (VistA) ()

AllergyIntolerance
AllergyIntolerance
   identifier
   identifier (va-IEN)
      system233-1: fixed value = http://va.gov/identifiers/$Sta3n/120.8

generated from mapParameter line 1

      value233: source value based on PATIENT ALLERGIES - IEN (120.8-.001)
   identifier (va-CDW)
      system1610-1: fixed value = http://va.gov/identifiers/CDWSID/cdwwork.allergy.allergy

generated from mapParameter line 1

      value1610: source value based on CDW.cdwwork.allergy.allergy.AllergySID

Source is AllergySID from Allergy Table in CDW

   clinicalStatus536: terminologyMaps using VF_allergyActive on PATIENT ALLERGIES - ENTERED IN ERROR (120.8-22)

confirm CHAPI

   verificationStatus535: terminologyMaps using VF_allergyVerificationStatus on PATIENT ALLERGIES - VERIFIED (120.8-19), 537: terminologyMaps using VF_allergyEnteredInError on PATIENT ALLERGIES - ENTERED IN ERROR (120.8-22),
   type531: terminologyMaps using VF_allergyMechanism on PATIENT ALLERGIES - MECHANISM (120.8-17)
   category556: terminologyMaps using VF_allergySubstanceCategory on PATIENT ALLERGIES - ALLERGY TYPE (120.8-3.1)
   code246: source value based on PATIENT ALLERGIES - GMR ALLERGY (120.8-1), 1505: source value based on PATIENT ALLERGIES - DRUG INGREDIENTS (120.8-2),

CHAPI to rxn code; looking into

      text245: source value based on PATIENT ALLERGIES - REACTANT (120.8-.02)

text only

   patient248: reference based on PATIENT ALLERGIES - PATIENT (120.8-.01)

Source is MVIPersonFullICN from SMVIPerson Table

   recordedDate1224: source value based on PATIENT ALLERGIES - ORIGINATION DATE/TIME (120.8-4)

Lighthouse exposes this source object as RecordedDate FHIR field

   recorder251: reference based on PATIENT ALLERGIES - ORIGINATOR (120.8-5)
   note
      author[x] (authorString)1503: source value based on PATIENT ALLERGIES - COMMENTS > COMMENTS - USER ENTERING (120.8-26 > 120.826-1)
      time1502: source value based on PATIENT ALLERGIES - COMMENTS > COMMENTS - DATE/TIME COMMENT ENTERED (120.8-26 > 120.826-.01)
      text1504: source value based on PATIENT ALLERGIES - COMMENTS > COMMENTS - COMMENTS (120.8-26 > 120.826-2)
   reaction
      manifestation252: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS (120.8-10 > 120.81-.01 > 120.83-)
         coding
            system252-1: fixed value = urn:oid:2.16.840.1.113883.6.233

generated from mapParameter line 1

            code252-2: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS - VUID (120.8-10 > 120.81-.01 > 120.83-99.99)

generated from mapParameter line 2

            display252-3: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS - NAME (120.8-10 > 120.81-.01 > 120.83-.01)

generated from mapParameter line 3

         text252-4: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS - NAME (120.8-10 > 120.81-.01 > 120.83-.01)

generated from mapParameter line 4

      onset1652: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - DATE ENTERED (120.8-10 > 120.81-3) if 6 OBSERVED/HISTORICAL = O
      severity557: terminologyMaps using VF_allergySeverity on ADVERSE REACTION REPORTING - SEVERITY (120.85-14.5)

This Data is not in CDW Assess for CHAPI via VPR

Mappings for Clinical Data Warehouse (CDW) ()

AllergyIntolerance
AllergyIntolerance
   identifier
   identifier (va-IEN)
   identifier (va-CDW)
      system1610-1: fixed value from undefined
      value1610: source value from CDW.cdwwork.allergy.allergy.AllergySID
   clinicalStatusAllergy.Allergy.EnteredInErrorFlag
   verificationStatusAllergy.Allergy.VerifiedFlag, Allergy.Allergy.EnteredInErrorFlag
   typeAllergy.Allergy.Mechanism
   categoryAllergy.Allergy.AllergyType
   code
      textAllergy.Allergy.AllergicReactant
   patientAllergy.AllergicReaction.PatientIEN,Allergy.Allergy.PatientIEN,Allergy.AllergyComment.PatientIEN,Allergy.AllergyDrugClass.PatientIEN,Allergy.AllergyDrugIngredient.PatientIEN
   recordedDateAllergy.AllergicReaction.OriginationDateTime,Allergy.Allergy.OriginationDateTime,Allergy.AllergyComment.OriginationDateTime,Allergy.AllergyDrugClass.OriginationDateTime,Allergy.AllergyDrugIngredient.OriginationDateTime
   recorderAllergy.Allergy.OriginatingStaffIEN
   note
      author[x] (authorString)Allergy.AllergyComment.EnteringStaffIEN
      timeAllergy.AllergyComment.CommentEnteredDateTime
   reaction
      onsetAllergy.AllergicReaction.EnteredDateTime

Mappings for Summary Document Architecure (SDA) ()

AllergyIntolerance
AllergyIntolerance
   clinicalStatusAllergy.Status
   verificationStatusAllergy.Certainty, Allergy.Status
   typeAllergy.Extension[AllergyExtension].Mechanism
   categoryAllergy.AllergyCategory
   codeAllergy.Allergy,Allergy.Extension[AllergyExtension].OriginalCode, Allergy.Extension[AllergyExtension].DrugProducts
      textAllergy.FreeTextAllergy
   recorderAllergy.EnteredBy
   note
      author[x] (authorString)Allergy.Comments,Allergy.InactiveComments,Allergy.Extension[AllergyExtension].Comments Allergy.Comment[VA.Comment].EnteredBy
      timeAllergy.Comments,Allergy.InactiveComments,Allergy.Extension[AllergyExtension].Comments
      textAllergy.Comments,Allergy.InactiveComments,Allergy.Extension[AllergyExtension].Comments Allergy.Comment[VA.Comment].CommentText
   reaction
      manifestationAllergy.Reaction,Allergy.Extension[AllergyExtension].Reactions
         coding
            codeAllergy.Reaction,Allergy.Extension[AllergyExtension].Reactions
            displayAllergy.Reaction,Allergy.Extension[AllergyExtension].Reactions
         textAllergy.Reaction,Allergy.Extension[AllergyExtension].Reactions
      onsetAllergy.Reaction,Allergy.Extension[AllergyExtension].Reactions Allergy.Reaction.Extension,Allergy.Extension[ReactionExtension].EnteredOn
      severityAllergy.Severity,Allergy.AllergyObservation[VA.AllergyObservation].Severity

Mappings for RIM Mapping (http://hl7.org/v3)

AllergyIntolerance
AllergyIntoleranceEntity. Role, or Act, Observation[classCode=OBS, moodCode=EVN]
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifierid
   identifier (va-IEN)id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (va-CDW)id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   clinicalStatusObservation ACT .inboundRelationship[typeCode=COMP].source[classCode=OBS, code="clinicalStatus", moodCode=EVN].value
   verificationStatusObservation ACT .inboundRelationship[typeCode=COMP].source[classCode=OBS, code="verificationStatus", moodCode=EVN].value
   typecode
   categoryvalue < IntoleranceValue (Agent)
   criticalityinboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code=SEV, value <= SeverityObservation (Severity Level)]
   codesubstance/product: .participation[typeCode=CAGNT].role[classCode=ADMM].player[classCode=MAT, determinerCode=KIND, code <= ExposureAgentEntityType] negated/excluded substance/product: .participation[typeCode=CAGNT, negationInd=true].role[classCode=ADMM].player[classCode=MAT, determinerCode=KIND, code <= ExposureAgentEntityType] positive or negated/excluded condition/situation: Observation.code=ASSERTION; Observation.value
      idn/a
      extensionn/a
      codingunion(., ./translation)
      text./originalText[mediaType/code="text/plain"]/data
   patient.participation[typeCode=SBJ].role[classCode=PAT]
   encounter.inboundRelationship[typeCode=COMP].source[classCode=ENC, moodCode=EVN]
   onset[x]effectiveTime.low
   recordedDate.participation[typeCode=AUT].time
   recorder.participation[typeCode=AUT].role
   asserter.participation[typeCode=INF].role
   lastOccurrenceoutBoundRelationship[typeCode=SUBJ].target[classCode=OBS, moodCode=EVN, code <= CommonClinicalObservationType, value <= ObservationValue (Reaction Type)].effectiveTime
   notesubjectOf.observationEvent[code="annotation"].value
      idn/a
      extensionn/a
      author[x]Act.participant[typeCode=AUT].role
      author[x] (authorString)Act.participant[typeCode=AUT].role
      timeAct.effectiveTime
      textAct.text
   reactionoutBoundRelationship[typeCode=SUBJ].target[classCode=OBS, moodCode=EVN, code <= CommonClinicalObservationType, value <= ObservationValue (Reaction Type)]
      idn/a
      extensionn/a
      modifierExtensionN/A
      substanceoutBoundRelationship[typeCode=SAS].target[classCode=SBADM, code <= ExposureCode].participation[typeCode=CSM].role[classCode=ADMM].player[classCode=MAT, determinerCode=KIND, code <= ExposureAgentEntityType]
      manifestationcode
         idn/a
         extensionn/a
         codingunion(., ./translation)
            idn/a
            extensionn/a
            system./codeSystem
            version./codeSystemVersion
            code./code
            displayCV.displayName
            userSelectedCD.codingRationale
         text./originalText[mediaType/code="text/plain"]/data
      descriptiontext
      onseteffectiveTime.low
      severityinboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code=SEV, value <= SeverityObservation (Severity Level)]
      exposureRouteoutBoundRelationship[typeCode=SAS].target[classCode=SBADM, code <= ExposureCode].routeCode
      notesubjectOf.observationEvent[code="annotation"].value

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

AllergyIntolerance
AllergyIntolerance
   identifierFiveWs.identifier
   identifier (va-IEN)FiveWs.identifier
   identifier (va-CDW)FiveWs.identifier
   clinicalStatusFiveWs.status
   verificationStatusFiveWs.status
   typeFiveWs.class
   categoryFiveWs.class
   criticalityFiveWs.grade
   codeFiveWs.what[x]
   patientFiveWs.subject[x], FiveWs.subject
   encounterFiveWs.context
   onset[x]FiveWs.init
   recordedDateFiveWs.recorded
   recorderFiveWs.author
   asserterFiveWs.source

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

AllergyIntolerance
AllergyIntolerance
   identifierIAM-7
   identifier (va-IEN)IAM-7
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (va-CDW)IAM-7
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   typeIAM-9
   categoryAL1-2
   criticalityAL1-4
   codeAL1-3 / IAM-3
      codingC*E.1-8, C*E.10-22
      textC*E.9. But note many systems use C*E.2 for this
   patient(PID-3)
   recordedDateIAM-13
   asserterIAM-14 (if patient) / IAM-18 (if practitioner)
   note
      author[x]N/A
      author[x] (authorString)N/A
      timeN/A
      textN/A
   reaction
      manifestationAL1-5
         codingC*E.1-8, C*E.10-22
            systemC*E.3
            versionC*E.7
            codeC*E.1
            displayC*E.2 - but note this is not well followed
            userSelectedSometimes implied by being first
         textC*E.9. But note many systems use C*E.2 for this
      onsetAL1-6