US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401
Publication Build: This will be filled in by the publication tooling
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.
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 |
AllergyIntolerance | ||
AllergyIntolerance | ||
identifier | ||
identifier (va-IEN) | ||
system | 233-1: fixed value = http://va.gov/identifiers/$Sta3n/120.8 | generated from mapParameter line 1 |
value | 233: source value based on PATIENT ALLERGIES - IEN (120.8-.001) | |
identifier (va-CDW) | ||
system | 1610-1: fixed value = http://va.gov/identifiers/CDWSID/cdwwork.allergy.allergy | generated from mapParameter line 1 |
value | 1610: source value based on CDW.cdwwork.allergy.allergy.AllergySID | Source is AllergySID from Allergy Table in CDW |
clinicalStatus | 536: terminologyMaps using VF_allergyActive on PATIENT ALLERGIES - ENTERED IN ERROR (120.8-22) | confirm CHAPI |
verificationStatus | 535: 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) | , |
type | 531: terminologyMaps using VF_allergyMechanism on PATIENT ALLERGIES - MECHANISM (120.8-17) | |
category | 556: terminologyMaps using VF_allergySubstanceCategory on PATIENT ALLERGIES - ALLERGY TYPE (120.8-3.1) | |
code | 246: 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 |
text | 245: source value based on PATIENT ALLERGIES - REACTANT (120.8-.02) | text only |
patient | 248: reference based on PATIENT ALLERGIES - PATIENT (120.8-.01) | Source is MVIPersonFullICN from SMVIPerson Table |
recordedDate | 1224: source value based on PATIENT ALLERGIES - ORIGINATION DATE/TIME (120.8-4) | Lighthouse exposes this source object as RecordedDate FHIR field |
recorder | 251: 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) | |
time | 1502: source value based on PATIENT ALLERGIES - COMMENTS > COMMENTS - DATE/TIME COMMENT ENTERED (120.8-26 > 120.826-.01) | |
text | 1504: source value based on PATIENT ALLERGIES - COMMENTS > COMMENTS - COMMENTS (120.8-26 > 120.826-2) | |
reaction | ||
manifestation | 252: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - REACTION > SIGN/SYMPTOMS (120.8-10 > 120.81-.01 > 120.83-) | |
coding | ||
system | 252-1: fixed value = urn:oid:2.16.840.1.113883.6.233 | generated from mapParameter line 1 |
code | 252-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 |
display | 252-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 |
text | 252-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 |
onset | 1652: source value based on PATIENT ALLERGIES - REACTIONS > REACTIONS - DATE ENTERED (120.8-10 > 120.81-3) if 6 OBSERVED/HISTORICAL = O | |
severity | 557: terminologyMaps using VF_allergySeverity on ADVERSE REACTION REPORTING - SEVERITY (120.85-14.5) | This Data is not in CDW Assess for CHAPI via VPR |
AllergyIntolerance | ||
AllergyIntolerance | ||
identifier | ||
identifier (va-IEN) | ||
identifier (va-CDW) | ||
system | 1610-1: fixed value from undefined | |
value | 1610: source value from CDW.cdwwork.allergy.allergy.AllergySID | |
clinicalStatus | Allergy.Allergy.EnteredInErrorFlag | |
verificationStatus | Allergy.Allergy.VerifiedFlag, Allergy.Allergy.EnteredInErrorFlag | |
type | Allergy.Allergy.Mechanism | |
category | Allergy.Allergy.AllergyType | |
code | ||
text | Allergy.Allergy.AllergicReactant | |
patient | Allergy.AllergicReaction.PatientIEN,Allergy.Allergy.PatientIEN,Allergy.AllergyComment.PatientIEN,Allergy.AllergyDrugClass.PatientIEN,Allergy.AllergyDrugIngredient.PatientIEN | |
recordedDate | Allergy.AllergicReaction.OriginationDateTime,Allergy.Allergy.OriginationDateTime,Allergy.AllergyComment.OriginationDateTime,Allergy.AllergyDrugClass.OriginationDateTime,Allergy.AllergyDrugIngredient.OriginationDateTime | |
recorder | Allergy.Allergy.OriginatingStaffIEN | |
note | ||
author[x] (authorString) | Allergy.AllergyComment.EnteringStaffIEN | |
time | Allergy.AllergyComment.CommentEnteredDateTime | |
reaction | ||
onset | Allergy.AllergicReaction.EnteredDateTime |
AllergyIntolerance | ||
AllergyIntolerance | ||
clinicalStatus | Allergy.Status | |
verificationStatus | Allergy.Certainty, Allergy.Status | |
type | Allergy.Extension[AllergyExtension].Mechanism | |
category | Allergy.AllergyCategory | |
code | Allergy.Allergy,Allergy.Extension[AllergyExtension].OriginalCode, Allergy.Extension[AllergyExtension].DrugProducts | |
text | Allergy.FreeTextAllergy | |
recorder | Allergy.EnteredBy | |
note | ||
author[x] (authorString) | Allergy.Comments,Allergy.InactiveComments,Allergy.Extension[AllergyExtension].Comments Allergy.Comment[VA.Comment].EnteredBy | |
time | Allergy.Comments,Allergy.InactiveComments,Allergy.Extension[AllergyExtension].Comments | |
text | Allergy.Comments,Allergy.InactiveComments,Allergy.Extension[AllergyExtension].Comments Allergy.Comment[VA.Comment].CommentText | |
reaction | ||
manifestation | Allergy.Reaction,Allergy.Extension[AllergyExtension].Reactions | |
coding | ||
code | Allergy.Reaction,Allergy.Extension[AllergyExtension].Reactions | |
display | Allergy.Reaction,Allergy.Extension[AllergyExtension].Reactions | |
text | Allergy.Reaction,Allergy.Extension[AllergyExtension].Reactions | |
onset | Allergy.Reaction,Allergy.Extension[AllergyExtension].Reactions Allergy.Reaction.Extension,Allergy.Extension[ReactionExtension].EnteredOn | |
severity | Allergy.Severity,Allergy.AllergyObservation[VA.AllergyObservation].Severity |
AllergyIntolerance | ||
AllergyIntolerance | Entity. Role, or Act, Observation[classCode=OBS, moodCode=EVN] | |
text | Act.text? | |
contained | N/A | |
extension | N/A | |
modifierExtension | N/A | |
identifier | id | |
identifier (va-IEN) | id | |
id | n/a | |
extension | n/a | |
use | Role.code or implied by context | |
type | Role.code or implied by context | |
system | II.root or Role.id.root | |
value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) | |
period | Role.effectiveTime or implied by context | |
assigner | II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper | |
identifier (va-CDW) | id | |
id | n/a | |
extension | n/a | |
use | Role.code or implied by context | |
type | Role.code or implied by context | |
system | II.root or Role.id.root | |
value | II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root) | |
period | Role.effectiveTime or implied by context | |
assigner | II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper | |
clinicalStatus | Observation ACT .inboundRelationship[typeCode=COMP].source[classCode=OBS, code="clinicalStatus", moodCode=EVN].value | |
verificationStatus | Observation ACT .inboundRelationship[typeCode=COMP].source[classCode=OBS, code="verificationStatus", moodCode=EVN].value | |
type | code | |
category | value < IntoleranceValue (Agent) | |
criticality | inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code=SEV, value <= SeverityObservation (Severity Level)] | |
code | substance/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 | |
id | n/a | |
extension | n/a | |
coding | union(., ./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 | |
lastOccurrence | outBoundRelationship[typeCode=SUBJ].target[classCode=OBS, moodCode=EVN, code <= CommonClinicalObservationType, value <= ObservationValue (Reaction Type)].effectiveTime | |
note | subjectOf.observationEvent[code="annotation"].value | |
id | n/a | |
extension | n/a | |
author[x] | Act.participant[typeCode=AUT].role | |
author[x] (authorString) | Act.participant[typeCode=AUT].role | |
time | Act.effectiveTime | |
text | Act.text | |
reaction | outBoundRelationship[typeCode=SUBJ].target[classCode=OBS, moodCode=EVN, code <= CommonClinicalObservationType, value <= ObservationValue (Reaction Type)] | |
id | n/a | |
extension | n/a | |
modifierExtension | N/A | |
substance | outBoundRelationship[typeCode=SAS].target[classCode=SBADM, code <= ExposureCode].participation[typeCode=CSM].role[classCode=ADMM].player[classCode=MAT, determinerCode=KIND, code <= ExposureAgentEntityType] | |
manifestation | code | |
id | n/a | |
extension | n/a | |
coding | union(., ./translation) | |
id | n/a | |
extension | n/a | |
system | ./codeSystem | |
version | ./codeSystemVersion | |
code | ./code | |
display | CV.displayName | |
userSelected | CD.codingRationale | |
text | ./originalText[mediaType/code="text/plain"]/data | |
description | text | |
onset | effectiveTime.low | |
severity | inboundRelationship[typeCode=SUBJ].source[classCode=OBS, moodCode=EVN, code=SEV, value <= SeverityObservation (Severity Level)] | |
exposureRoute | outBoundRelationship[typeCode=SAS].target[classCode=SBADM, code <= ExposureCode].routeCode | |
note | subjectOf.observationEvent[code="annotation"].value |
AllergyIntolerance | ||
AllergyIntolerance | ||
identifier | FiveWs.identifier | |
identifier (va-IEN) | FiveWs.identifier | |
identifier (va-CDW) | FiveWs.identifier | |
clinicalStatus | FiveWs.status | |
verificationStatus | FiveWs.status | |
type | FiveWs.class | |
category | FiveWs.class | |
criticality | FiveWs.grade | |
code | FiveWs.what[x] | |
patient | FiveWs.subject[x], FiveWs.subject | |
encounter | FiveWs.context | |
onset[x] | FiveWs.init | |
recordedDate | FiveWs.recorded | |
recorder | FiveWs.author | |
asserter | FiveWs.source |
AllergyIntolerance | ||
AllergyIntolerance | ||
identifier | IAM-7 | |
identifier (va-IEN) | IAM-7 | |
use | N/A | |
type | CX.5 | |
system | CX.4 / EI-2-4 | |
value | CX.1 / EI.1 | |
period | CX.7 + CX.8 | |
assigner | CX.4 / (CX.4,CX.9,CX.10) | |
identifier (va-CDW) | IAM-7 | |
use | N/A | |
type | CX.5 | |
system | CX.4 / EI-2-4 | |
value | CX.1 / EI.1 | |
period | CX.7 + CX.8 | |
assigner | CX.4 / (CX.4,CX.9,CX.10) | |
type | IAM-9 | |
category | AL1-2 | |
criticality | AL1-4 | |
code | AL1-3 / IAM-3 | |
coding | C*E.1-8, C*E.10-22 | |
text | C*E.9. But note many systems use C*E.2 for this | |
patient | (PID-3) | |
recordedDate | IAM-13 | |
asserter | IAM-14 (if patient) / IAM-18 (if practitioner) | |
note | ||
author[x] | N/A | |
author[x] (authorString) | N/A | |
time | N/A | |
text | N/A | |
reaction | ||
manifestation | AL1-5 | |
coding | C*E.1-8, C*E.10-22 | |
system | C*E.3 | |
version | C*E.7 | |
code | C*E.1 | |
display | C*E.2 - but note this is not well followed | |
userSelected | Sometimes implied by being first | |
text | C*E.9. But note many systems use C*E.2 for this | |
onset | AL1-6 |