Changes

US Veterans Health Administration FHIR Map Set Implementation Guide
1.10.0 - 251101 United States of America flag

US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.10.0 See the Directory of published versions

</tr> </table>

key column old value (VA-FHIR-CoP-MapSet-PREVIOUS.xlsx) new value (VA-FHIR-CoP-MapSet.xlsx)

use-case AllergyIntolerance

key	column	old value (VA-FHIR-CoP-MapSet-PREVIOUS.xlsx)	new value (VA-FHIR-CoP-MapSet.xlsx)
use-case AllergyIntolerance
resource AllergyIntolerance
233
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/120.8`	`.system = http://va.gov/identifiers/{sta3n}/120.8`
537
	status	`team-approved`	`inactive`
use-case Patient
resource Patient
	maprow count	25	26
272
	fhirPath	`Patient.identifier[va-mr]`	`Patient.identifier[va-icn]`
	mapParameters	`.system=urn:oid:2.16.840.1.113883.4.349 .type=http://terminology.hl7.org/CodeSystem/v2-0203#MR`	`.system=urn:oid:2.16.840.1.113883.4.349 .type=http://terminology.hl7.org/CodeSystem/v2-0203#PN`
2274	new maprow		NEW
use-case Observation 2507 EXAM
resource Observation
907
	mapParameters	`.system=http://va.gov/fhir/identifiers/$Sta3n/396.4-.01`	`.system=http://va.gov/fhir/identifiers/{sta3n}/396.4-.01`
use-case Condition: Problem
resource Condition
345
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/9000011`	`.system = http://va.gov/identifiers/{sta3n}/9000011`
use-case Condition: Encounter Diagnosis
resource Condition
346
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/9000010.07`	`.system = http://va.gov/identifiers/{sta3n}/9000010.07`
use-case Diagnostic Report Note: Surgical Pathology
resource DiagnosticReport
1606
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.53`	`.system = http://va.gov/identifiers/{sta3n}/63.53`
2207
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Lab Observation: Chem, hem, tox, ria, ser
resource DiagnosticReport
1602
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.07`	`.system = http://va.gov/identifiers/{sta3n}/63.07`
resource Observation
851
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.04`	`.system = http://va.gov/identifiers/{sta3n}/63.04`
use-case Diagnostic Report Note: Electron Microscopy
resource DiagnosticReport
1604
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.52`	`.system = http://va.gov/identifiers/{sta3n}/63.52`
2209
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Microbiology
resource DiagnosticReport
1605
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.5`	`.system = http://va.gov/identifiers/{sta3n}/63.5`
resource Observation
1476
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.05`	`.system = http://va.gov/identifiers/{sta3n}/63.05`
use-case Microbiology: Bacteriology
resource Observation
	maprow count	4	5
1522
	vistaFileFieldName	`MICROBIOLOGY - ORGANISM`	`ANTIMICROBIAL SUSCEPTIBILITY - NAME`
	vistaFileField	`63.05-12`	`62.06-.01`
	vistaSubFileFieldName	`ORGANISM - ORGANISM`
	vistaSubFileField	`63.3-5+to+160`
	mapApproach	`transform`	`source value`
	mapCase		`{5>63-5>63.05}`
	fhirSubPath		`.text`
	mapParameters	`.coding.code = .coding.system = "http://loinc.org"`
2276	new maprow		NEW
use-case Document Reference
resource DocumentReference
	maprow count	43	44
871
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/8925`	`.system = http://va.gov/identifiers/{sta3n}/8925`
2269	new maprow		NEW
new use-case Encounter: PTF
new use-case Encounter: Visit
use-case Immunization
resource Immunization
1767
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Implantable Device: A Lead
resource Device
1350
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/698.2`	`.system = http://va.gov/identifiers/{sta3n}/698.2`
use-case Implantable Device: Dental
resource Device
1352
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/228.9`	`.system = http://va.gov/identifiers/{sta3n}/228.9`
use-case Implantable Device: Pacemaker
resource Device
1349
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/698`	`.system = http://va.gov/identifiers/{sta3n}/698`
use-case Implantable Device: Prosthesis
resource Device
1348
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/131.01`	`.system = http://va.gov/identifiers/{sta3n}/131.01`
use-case Implantable Device: V Lead
resource Device
1351
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/698.1`	`.system = http://va.gov/identifiers/{sta3n}/698.1`
use-case Diagnostic Report Note: Cytopathology
resource DiagnosticReport
1603
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/63.51`	`.system = http://va.gov/identifiers/{sta3n}/63.51`
2211
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Location
resource Location
755
	mapParameters	`.system=http://va.gov/identifiers/$Sta3n/44`	`.system=http://va.gov/identifiers/{sta3n}/44`
use-case Lung Cancer Screening
resource DiagnosticReport
935
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case MedicationRequest: NonVA
resource MedicationRequest
1762
	mapParameters	`.system=http://va.gov/identifiers/$Sta3n/55.05-7 .type=http://terminology.hl7.org/CodeSystem/v2-0203#FILL`	`.system=http://va.gov/identifiers/{sta3n}/55.05-7 .type=http://terminology.hl7.org/CodeSystem/v2-0203#FILL`
1763
	mapParameters	`.system=http://va.gov/identifiers/$Sta3n/55.05`	`.system=http://va.gov/identifiers/{sta3n}/55.05`
use-case Observation EXAM
resource Observation
1583
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Practitioner
resource Practitioner
	maprow count	36	37
415
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/200 .type=http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN`	`.system = http://va.gov/identifiers/{sta3n}/200 .type=http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN`
2271	new maprow		NEW
use-case Procedure: Outpatient
resource Procedure
1300
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Procedure: Radiology
resource Procedure
1511
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Procedure: Surgery
resource Procedure
1285
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Smoking Status Observation
resource Observation
1241
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/9000010.23`	`.system = http://va.gov/identifiers/{sta3n}/9000010.23`
1246
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
use-case Vital Signs
resource Observation
660
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/120.5`	`.system = http://va.gov/identifiers/{sta3n}/120.5`
use-case Observation Imaging Result: Echo
resource Observation
1617
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/691`	`.system = http://va.gov/identifiers/{sta3n}/691`
use-case Observation Imaging Result: EKG
resource Observation
1618
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/691.5`	`.system = http://va.gov/identifiers/{sta3n}/691.5`
use-case Observation Imaging Result: Rad/Nuc
resource Observation
1619
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/74`	`.system = http://va.gov/identifiers/{sta3n}/74`
use-case MedicationRequest: Pending
resource MedicationRequest
	maprow count	23	24
1747
	mapParameters	`.system = http://va.gov/identifiers/$Sta3n/52.41-.01 .type=http://terminology.hl7.org/CodeSystem/v2-0203#PLAC`	`.system = http://va.gov/identifiers/{sta3n}/52.41-.01 .type=http://terminology.hl7.org/CodeSystem/v2-0203#PLAC`
2270	new maprow		NEW
use-case Debt Portal
resource ChargeItem[charges]
2237
	mapParameters	`.value=Sta3n&"-"&{IEN (.001)} .type.text="Sta3n - IBAction.IEN" .system="http://va.gov/identifiers//350</code></td>`	`.value=concat({sta3n},"-",{IEN (.001)}) .type.text="Sta3n - IBAction.IEN" .system="http://va.gov/identifiers/{sta3n}/350`
2008
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
2009
	mapValue	`/EncounterInpatientEncounter`	`/EncounterPTFEncounter`
use-case Decision Precision Plus
resource Observation[smokingpacks]
	maprow count	2	3
2224
	mapCase	`9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY`	`9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 <> null`
	mapParameters	`.code = http://snomed.info/sct#11641000161103 "Average number of packs of cigarettes smoked per day (observable entity)" .valueQuantity.unit = /d`	`.code = http://snomed.info/sct#11641000161103 "Average number of packs of cigarettes smoked per day (observable entity)" .valueQuantity.unit = {#}`
2272	new maprow		NEW
resource Observation[smokingyears]
	maprow count	2	3
2249
	vistaSubFileFieldName	`HEALTH FACTORS - FACTOR`
	vistaSubFileField	`9999999.64-.01`
	mapCase	`9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED`	`9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED AND 9000010.23-220 <> null`
	mapParameters	`.code = http://snomed.info/sct#11651000161100 "Number of years smoked cigarettes (observable entity)" .valueQuantity.unit = a`	`.code = http://snomed.info/sct#11651000161100 "Number of years smoked cigarettes (observable entity)" .valueQuantity.unit = {#}`
2273	new maprow		NEW
use-case Decision Precision Plus: abstract
resource Observation
2229
	mapValue	`/EncounterOutpatient`	`/EncounterVisit`
new use-case Document Reference AIS
termmap VF_allergyVerificationStatus
	group http://terminology.hl7.org/CodeSystem/allergyintolerance-verification maps	2	3

resource AllergyIntolerance

233

mapParameters .system = http://va.gov/identifiers/$Sta3n/120.8 .system = http://va.gov/identifiers/{sta3n}/120.8

537

status team-approved inactive

use-case Patient

resource Patient

maprow count 25 26

272

fhirPath Patient.identifier[va-mr] Patient.identifier[va-icn]

mapParameters .system=urn:oid:2.16.840.1.113883.4.349 .type=http://terminology.hl7.org/CodeSystem/v2-0203#MR .system=urn:oid:2.16.840.1.113883.4.349 .type=http://terminology.hl7.org/CodeSystem/v2-0203#PN

2274 new maprow NEW

use-case Observation 2507 EXAM

resource Observation

907

mapParameters .system=http://va.gov/fhir/identifiers/$Sta3n/396.4-.01 .system=http://va.gov/fhir/identifiers/{sta3n}/396.4-.01

use-case Condition: Problem

resource Condition

345

mapParameters .system = http://va.gov/identifiers/$Sta3n/9000011 .system = http://va.gov/identifiers/{sta3n}/9000011

use-case Condition: Encounter Diagnosis

resource Condition

346

mapParameters .system = http://va.gov/identifiers/$Sta3n/9000010.07 .system = http://va.gov/identifiers/{sta3n}/9000010.07

use-case Diagnostic Report Note: Surgical Pathology

resource DiagnosticReport

1606

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.53 .system = http://va.gov/identifiers/{sta3n}/63.53

2207

mapValue /EncounterOutpatient /EncounterVisit

use-case Lab Observation: Chem, hem, tox, ria, ser

resource DiagnosticReport

1602

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.07 .system = http://va.gov/identifiers/{sta3n}/63.07

resource Observation

851

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.04 .system = http://va.gov/identifiers/{sta3n}/63.04

use-case Diagnostic Report Note: Electron Microscopy

resource DiagnosticReport

1604

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.52 .system = http://va.gov/identifiers/{sta3n}/63.52

2209

mapValue /EncounterOutpatient /EncounterVisit

use-case Microbiology

resource DiagnosticReport

1605

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.5 .system = http://va.gov/identifiers/{sta3n}/63.5

resource Observation

1476

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.05 .system = http://va.gov/identifiers/{sta3n}/63.05

use-case Microbiology: Bacteriology

resource Observation

maprow count 4 5

1522

vistaFileFieldName MICROBIOLOGY - ORGANISM ANTIMICROBIAL SUSCEPTIBILITY - NAME

vistaFileField 63.05-12 62.06-.01

vistaSubFileFieldName ORGANISM - ORGANISM

vistaSubFileField 63.3-5+to+160

mapApproach transform source value

mapCase {5>63-5>63.05}

fhirSubPath .text

mapParameters .coding.code = .coding.system = "http://loinc.org"

2276 new maprow NEW

use-case Document Reference

resource DocumentReference

maprow count 43 44

871

mapParameters .system = http://va.gov/identifiers/$Sta3n/8925 .system = http://va.gov/identifiers/{sta3n}/8925

2269 new maprow NEW

new use-case Encounter: PTF

new use-case Encounter: Visit

use-case Immunization

resource Immunization

1767

mapValue /EncounterOutpatient /EncounterVisit

use-case Implantable Device: A Lead

resource Device

1350

mapParameters .system = http://va.gov/identifiers/$Sta3n/698.2 .system = http://va.gov/identifiers/{sta3n}/698.2

use-case Implantable Device: Dental

resource Device

1352

mapParameters .system = http://va.gov/identifiers/$Sta3n/228.9 .system = http://va.gov/identifiers/{sta3n}/228.9

use-case Implantable Device: Pacemaker

resource Device

1349

mapParameters .system = http://va.gov/identifiers/$Sta3n/698 .system = http://va.gov/identifiers/{sta3n}/698

use-case Implantable Device: Prosthesis

resource Device

1348

mapParameters .system = http://va.gov/identifiers/$Sta3n/131.01 .system = http://va.gov/identifiers/{sta3n}/131.01

use-case Implantable Device: V Lead

resource Device

1351

mapParameters .system = http://va.gov/identifiers/$Sta3n/698.1 .system = http://va.gov/identifiers/{sta3n}/698.1

use-case Diagnostic Report Note: Cytopathology

resource DiagnosticReport

1603

mapParameters .system = http://va.gov/identifiers/$Sta3n/63.51 .system = http://va.gov/identifiers/{sta3n}/63.51

2211

mapValue /EncounterOutpatient /EncounterVisit

use-case Location

resource Location

755

mapParameters .system=http://va.gov/identifiers/$Sta3n/44 .system=http://va.gov/identifiers/{sta3n}/44

use-case Lung Cancer Screening

resource DiagnosticReport

935

mapValue /EncounterOutpatient /EncounterVisit

use-case MedicationRequest: NonVA

resource MedicationRequest

1762

mapParameters .system=http://va.gov/identifiers/$Sta3n/55.05-7 .type=http://terminology.hl7.org/CodeSystem/v2-0203#FILL .system=http://va.gov/identifiers/{sta3n}/55.05-7 .type=http://terminology.hl7.org/CodeSystem/v2-0203#FILL

1763

mapParameters .system=http://va.gov/identifiers/$Sta3n/55.05 .system=http://va.gov/identifiers/{sta3n}/55.05

use-case Observation EXAM

resource Observation

1583

mapValue /EncounterOutpatient /EncounterVisit

use-case Practitioner

resource Practitioner

maprow count 36 37

415

mapParameters .system = http://va.gov/identifiers/$Sta3n/200 .type=http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN .system = http://va.gov/identifiers/{sta3n}/200 .type=http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN

2271 new maprow NEW

use-case Procedure: Outpatient

resource Procedure

1300

mapValue /EncounterOutpatient /EncounterVisit

use-case Procedure: Radiology

resource Procedure

1511

mapValue /EncounterOutpatient /EncounterVisit

use-case Procedure: Surgery

resource Procedure

1285

mapValue /EncounterOutpatient /EncounterVisit

use-case Smoking Status Observation

resource Observation

1241

mapParameters .system = http://va.gov/identifiers/$Sta3n/9000010.23 .system = http://va.gov/identifiers/{sta3n}/9000010.23

1246

mapValue /EncounterOutpatient /EncounterVisit

use-case Vital Signs

resource Observation

660

mapParameters .system = http://va.gov/identifiers/$Sta3n/120.5 .system = http://va.gov/identifiers/{sta3n}/120.5

use-case Observation Imaging Result: Echo

resource Observation

1617

mapParameters .system = http://va.gov/identifiers/$Sta3n/691 .system = http://va.gov/identifiers/{sta3n}/691

use-case Observation Imaging Result: EKG

resource Observation

1618

mapParameters .system = http://va.gov/identifiers/$Sta3n/691.5 .system = http://va.gov/identifiers/{sta3n}/691.5

use-case Observation Imaging Result: Rad/Nuc

resource Observation

1619

mapParameters .system = http://va.gov/identifiers/$Sta3n/74 .system = http://va.gov/identifiers/{sta3n}/74

use-case MedicationRequest: Pending

resource MedicationRequest

maprow count 23 24

1747

mapParameters .system = http://va.gov/identifiers/$Sta3n/52.41-.01 .type=http://terminology.hl7.org/CodeSystem/v2-0203#PLAC .system = http://va.gov/identifiers/{sta3n}/52.41-.01 .type=http://terminology.hl7.org/CodeSystem/v2-0203#PLAC

2270 new maprow NEW

use-case Debt Portal

resource ChargeItem[charges]

2237

mapParameters .value=Sta3n&"-"&{IEN (.001)} .type.text="Sta3n - IBAction.IEN" .system="http://va.gov/identifiers//350</code></td> .value=concat({sta3n},"-",{IEN (.001)}) .type.text="Sta3n - IBAction.IEN" .system="http://va.gov/identifiers/{sta3n}/350

2008

mapValue /EncounterOutpatient /EncounterVisit

2009

mapValue /EncounterInpatientEncounter /EncounterPTFEncounter

use-case Decision Precision Plus

resource Observation[smokingpacks]

maprow count 2 3

2224

mapCase 9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY 9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 <> null

mapParameters .code = http://snomed.info/sct#11641000161103 "Average number of packs of cigarettes smoked per day (observable entity)" .valueQuantity.unit = /d .code = http://snomed.info/sct#11641000161103 "Average number of packs of cigarettes smoked per day (observable entity)" .valueQuantity.unit = {#}

2272 new maprow NEW

resource Observation[smokingyears]

maprow count 2 3

2249

vistaSubFileFieldName HEALTH FACTORS - FACTOR

vistaSubFileField 9999999.64-.01

mapCase 9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED 9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED AND 9000010.23-220 <> null

mapParameters .code = http://snomed.info/sct#11651000161100 "Number of years smoked cigarettes (observable entity)" .valueQuantity.unit = a .code = http://snomed.info/sct#11651000161100 "Number of years smoked cigarettes (observable entity)" .valueQuantity.unit = {#}

2273 new maprow NEW

use-case Decision Precision Plus: abstract

resource Observation

2229

mapValue /EncounterOutpatient /EncounterVisit

new use-case Document Reference AIS

termmap VF_allergyVerificationStatus

group http://terminology.hl7.org/CodeSystem/allergyintolerance-verification maps 2 3

<prev

top

next>

IG © 2025 VA. Package va.maps#1.10.0 based on FHIR 4.0.1. Generated 2025-11-04
Links: Table of Contents | QA Report | Propose a change