Changes

US Veterans Health Administration FHIR Map Set Implementation Guide
2.3.0 - 260301 United States of America flag

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

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

use-case VAAllergyIntolerance

key	column	old value (VA-FHIR-CoP-MapSet-PREVIOUS.xlsx)	new value (VA-FHIR-CoP-MapSet.xlsx)
use-case VAAllergyIntolerance
resource AllergyIntolerance
248
	mapParameters		`.display = {PATIENT > PATIENT - NAME (.01>2-.01)}`
251
	mapParameters		`.display = {ORIGINATOR > NEW PERSON - NAME (5>200-.01)}`
252
	vistaSubFileFieldName	`REACTIONS - REACTION > SIGN/SYMPTOMS`	`REACTIONS - REACTION > SIGN/SYMPTOMS - NAME`
	vistaSubFileField	`120.81-.01 > 120.83-`	`120.81-.01 > 120.83-.01`
	fhirSubPath		`.text`
	mapParameters	`.coding.system=urn:oid:2.16.840.1.113883.6.233 .coding.code = {VUID (99.99)} .coding.display = {NAME (.01)} .text = {NAME (.01)}`	`.coding.system=urn:oid:2.16.840.1.113883.6.233 .coding.code = {VUID (99.99)} .coding.display = {NAME (.01)}`
use-case VAPatient
resource Patient
273
	vistaFileFieldName	`PATIENT - NAME`	`PATIENT - NAME COMPONENTS`
	vistaFileField	`2-.01`	`2-1.01`
	vistaSubFileFieldName		`NAME COMPONENTS -`
	vistaSubFileField		`20-`
	fhirSubPath	`.text`
	mapParameters	`.family=LAST .given=FIRST & MIDDLE .suffix=SUFFIX`	`.family = {FAMILY (LAST) NAME (1)} .given = {GIVEN (FIRST) NAME (2)} .prefix = {PREFIX (4)} .suffix = {SUFFIX (5)}`
575
	vistaSubFileFieldName		`ETHNICITY INFORMATION - ETHNICITY INFORMATION`
	vistaSubFileField		`2.06-.01`
576
	vistaSubFileFieldName		`RACE INFORMATION - RACE INFORMATION`
	vistaSubFileField		`2.02-.01`
use-case VAAppointment
resource Appointment
1722
	mapParameters	`.type.coding.code = #PART .status = #accepted`	`.type.coding.code = #PART .status = #accepted .actor.display = {NAME (.01)}`
use-case Condition: Problem
resource Condition
365
	vistaSubFileFieldName	`ICD DIAGNOSIS`	`ICD DIAGNOSIS - CODE NUMBER`
	vistaSubFileField	`80-`	`80-.01`
	fhirSubPath		`.code`
	mapParameters	`.system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)}) .code = {CODE NUMBER(.01)}`	`.system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)})`
367
	mapParameters		`.display = {NAME (.01)}`
use-case Condition: Encounter Diagnosis
resource Condition
1613
	mapParameters	`.system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)}) .code = {CODE NUMBER(.01)}`	`.system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)})`
1611
	mapParameters		`.display = {NAME (.01)}`
use-case Diagnostic Report Note: Surgical Pathology
resource DiagnosticReport
1435
	mapParameters		`.display = {RELEASED BY > NEW PERSON - NAME (.13>200-.01)}`
use-case Lab Observation: Chem, hem, tox, ria, ser
resource Observation
852
	vistaFileField	`63.04-2+through+862`	`63.04-2to862`
857
	vistaFileField	`63.04-2+through+862`	`63.04-2to862`
use-case Microbiology
resource DiagnosticReport
1605
	status	`in process`	`issue`
	vistaFileFieldName	`MICROBIOLOGY - ORDERED TEST`	`MICROBIOLOGY - IEN`
	vistaFileField	`63.05-.35`	`63.05-.001`
	vistaSubFileFieldName	`ORDERED TEST - IEN`
	vistaSubFileField	`63.5-.001`
1420
	status	`in process`	`inactive`
1661
	status	`in process`	`inactive`
1521
	status	`inactive`	`in process`
	mapValue	`http://loinc.org#11502-2 "Laboratory report"`	`http://loinc.org#70004-7 "Diagnostic study note"`
use-case Microbiology: Bacteriology
resource Observation[susceptibility]
1523
	vistaSubFileField	`63.3-5+to+160`	`63.3-5to160`
1524
	vistaSubFileField	`63.3-5.1+to+160.1`	`63.3-5.1to160.1`
use-case Document Reference
resource DocumentReference
874
	vistaSubFileFieldName	`TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE`	`TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE - DOCUMENT TYPE`
	vistaSubFileField	`8925.1-1501 > 8926.1`	`8925.1-1501 > 8926.1-.08`
	fhirSubPath		`.text`
	mapParameters	`.coding[va-loinc].system=http://loinc.org .coding[va-loinc].code={CODING SYSTEM(2)} .text={DOCUMENT TYPE(.08)}`	`.coding[va-loinc].system=http://loinc.org .coding[va-loinc].code={CODING SYSTEM > CODING SYSTEM – CODE(2>8926.12-.02)}`
876
	mapParameters		`.display = {NAME (.01)}`
use-case Encounter: PTF
resource Encounter
450
	vistaFileField	`45-45.01+to+45.05`	`45-45.01to45.05`
1616
	vistaSubFileFieldName	`CPT`	`CPT - SHORT NAME`
	vistaSubFileField	`81-`	`81-2`
	fhirSubPath		`.text`
	mapParameters	`.coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)} .text = {SHORT NAME (2)}`	`.coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)}`
use-case Encounter: Visit
resource Encounter
440
	mapParameters		`.display = {NAME (.01)}`
1615
	vistaSubFileFieldName	`CPT`	`CPT - SHORT NAME`
	vistaSubFileField	`81-`	`81-2`
	fhirSubPath		`.text`
	mapParameters	`.coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)} .text = {SHORT NAME (2)}`	`.coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)}`
use-case VAImmunization
resource Immunization
333
	mapParameters		`.display = {NAME (.01)}`
464
	vistaSubFileFieldName	`UCUM CODES -`	`UCUM CODES - UCUM CODE`
	vistaSubFileField	`757.5-`	`757.5-1`
	fhirSubPath		`.code`
	mapParameters	`.unit = {DESCRIPTION OF THE UNIT (.01)} .code= {UCUM CODE (1)}`	`.unit = {DESCRIPTION OF THE UNIT (.01)}`
use-case Implantable Device: A Lead
resource Device
1401
	mapParameters		`.display = {NAME (.01)}`
use-case Implantable Device: Pacemaker
resource Device
1400
	mapParameters		`.display = {NAME (.01)}`
use-case Implantable Device: V Lead
resource Device
1402
	mapParameters		`.display = {NAME (.01)}`
use-case Lung Cancer Screening
resource DiagnosticReport
933
	mapParameters		`.display = {NAME (.01)}`
use-case MedicationRequest: Outpatient
resource MedicationRequest
	maprow count	41	38
813	deleted maprow		DELETED
814	deleted maprow		DELETED
817	deleted maprow		DELETED
818	deleted maprow		DELETED
2282
	mapCase		`NOT S`
2283	new maprow		NEW
use-case Observation EXAM
resource Observation
1580
	vistaSubFileFieldName	`EXAM`	`EXAM - PRINT NAME`
	vistaSubFileField	`9999999.15-`	`9999999.15-200`
	fhirPath	`Observation.code.coding[va-code]`	`Observation.code.text`
	mapParameters	`.system= http://va.gov/fhir/CodeSystem/9999999.15 .code = {NAME(.01)} .display = {PRINT NAME(200)}`
1581
	vistaSubFileFieldName	`EXAM - CODE MAPPINGS > CODE MAPPINGS`	`EXAM - CODE MAPPINGS > CODE MAPPINGS - CODE`
	vistaSubFileField	`9999999.15-210>9999999.18`	`9999999.15-210>9999999.18-1`
	fhirPath	`Observation.code.coding[va-sct]`	`Observation.code.coding`
	fhirSubPath		`.code`
	mapParameters	`.system = termmap(VF_ICDCodingSystems,{CODING SYSTEM(.01)}) .code = {CODE(1)}`	`.system = termmap(VF_ICDCodingSystems,{CODING SYSTEM(.01)})`
1582
	mapParameters		`.display = {NAME (.01)}`
1586
	vistaSubFileFieldName	`UCUM CODES`	`UCUM CODES - UCUM CODE`
	vistaSubFileField	`757.5-`	`757.5-1`
	fhirSubPath		`.code`
	mapParameters	`.unit = {DESCRIPTION OF THE UNIT (.01)} .code= {UCUM CODE (1)}`	`.unit = {DESCRIPTION OF THE UNIT (.01)}`
use-case VAPractitioner
resource Practitioner
382
	fhirSubPath	`.text`
use-case Procedure: Outpatient
resource Procedure
1299
	mapParameters		`.display = {NAME (.01)}`
use-case Procedure: Radiology
resource Procedure
1509
	vistaSubFileFieldName	`EXAMINATIONS - PROCEDURE > RAD/NUC MED PROCEDURES - CPT CODE > CPT`	`EXAMINATIONS - PROCEDURE > RAD/NUC MED PROCEDURES - CPT CODE > CPT - CPT CODE`
	vistaSubFileField	`70.03-2 > 71-9 > 81-`	`70.03-2 > 71-9 > 81-.01`
	fhirSubPath		`.code`
	mapParameters	`.system = "http://www.ama-assn.org/go/cpt" .code = {CPT CODE(.01)} .display = {SHORT NAME(2)}`	`.system = "http://www.ama-assn.org/go/cpt" .display = {SHORT NAME(2)}`
use-case Procedure: Surgery
resource Procedure
1344
	vistaSubFileFieldName	`CPT`	`CPT - CPT CODE`
	vistaSubFileField	`81`	`81-.01`
	fhirSubPath		`.code`
	mapParameters	`.code = {CPT CODE(.01)} .system = http://www.ama-assn.org/go/cpt .display = {SHORT NAME(2)}`	`.system = http://www.ama-assn.org/go/cpt .display = {SHORT NAME(2)}`
use-case Smoking Status Observation
resource Observation
1245
	mapParameters		`.display = {NAME (.01)}`
use-case Observation Imaging Result: Echo
resource Observation
1631
	mapParameters		`.display = {NAME (.01)}`
use-case Observation Imaging Result: EKG
resource Observation
1632
	mapParameters		`.display = {NAME (.01)}`
use-case Decision Precision Plus
resource Observation[smoking]
2232
	status	`in process`	`inactive`
use-case Decision Precision Plus: abstract
resource Observation
2266
	mapParameters		`.display = {NAME (.01)}`
use-case Document Reference AIS
resource DocumentReference
2269
	vistaSubFileFieldName	`TIU DOCUMENT DEFINITION`	`TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE - IEN`
	vistaSubFileField	`8925.1-.001`	`8925.1-1501 > 8926.1-.001`
	fhirSubPath		`.coding[va-ien].code`
	mapParameters	`.coding[va-ien].system=http://va.gov/fhir/CodeSystem/{sta3n}Sta3n8925.1 .coding[va-ien].code={CODING SYSTEM(2)} .text={DOCUMENT TYPE(.08)}`	`.coding[va-ien].system=http://va.gov/fhir/CodeSystem/{sta3n}Sta3n8925.1 .text={STANDARD TITLE(.01)}`
2275
	fhirSubPath	`.reference`
	mapParameters	`An appointment reference identifier provided by the CES appointment system. This is not persisted in VistA.`
new resource Parameters
new use-case MedicationRequest: Outpatient List

resource AllergyIntolerance

248

mapParameters .display = {PATIENT > PATIENT - NAME (.01>2-.01)}

251

mapParameters .display = {ORIGINATOR > NEW PERSON - NAME (5>200-.01)}

252

vistaSubFileFieldName REACTIONS - REACTION > SIGN/SYMPTOMS REACTIONS - REACTION > SIGN/SYMPTOMS - NAME

vistaSubFileField 120.81-.01 > 120.83- 120.81-.01 > 120.83-.01

fhirSubPath .text

mapParameters .coding.system=urn:oid:2.16.840.1.113883.6.233 .coding.code = {VUID (99.99)} .coding.display = {NAME (.01)} .text = {NAME (.01)} .coding.system=urn:oid:2.16.840.1.113883.6.233 .coding.code = {VUID (99.99)} .coding.display = {NAME (.01)}

use-case VAPatient

resource Patient

273

vistaFileFieldName PATIENT - NAME PATIENT - NAME COMPONENTS

vistaFileField 2-.01 2-1.01

vistaSubFileFieldName NAME COMPONENTS -

vistaSubFileField 20-

fhirSubPath .text

mapParameters .family=LAST .given=FIRST & MIDDLE .suffix=SUFFIX .family = {FAMILY (LAST) NAME (1)} .given = {GIVEN (FIRST) NAME (2)} .prefix = {PREFIX (4)} .suffix = {SUFFIX (5)}

575

vistaSubFileFieldName ETHNICITY INFORMATION - ETHNICITY INFORMATION

vistaSubFileField 2.06-.01

576

vistaSubFileFieldName RACE INFORMATION - RACE INFORMATION

vistaSubFileField 2.02-.01

use-case VAAppointment

resource Appointment

1722

mapParameters .type.coding.code = #PART .status = #accepted .type.coding.code = #PART .status = #accepted .actor.display = {NAME (.01)}

use-case Condition: Problem

resource Condition

365

vistaSubFileFieldName ICD DIAGNOSIS ICD DIAGNOSIS - CODE NUMBER

vistaSubFileField 80- 80-.01

fhirSubPath .code

mapParameters .system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)}) .code = {CODE NUMBER(.01)} .system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)})

367

mapParameters .display = {NAME (.01)}

use-case Condition: Encounter Diagnosis

resource Condition

1613

mapParameters .system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)}) .code = {CODE NUMBER(.01)} .system=termmap(VF_ICDCodingSystems,{CODING SYSTEM(1.1)})

1611

mapParameters .display = {NAME (.01)}

use-case Diagnostic Report Note: Surgical Pathology

resource DiagnosticReport

1435

mapParameters .display = {RELEASED BY > NEW PERSON - NAME (.13>200-.01)}

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

resource Observation

852

vistaFileField 63.04-2+through+862 63.04-2to862

857

vistaFileField 63.04-2+through+862 63.04-2to862

use-case Microbiology

resource DiagnosticReport

1605

status in process issue

vistaFileFieldName MICROBIOLOGY - ORDERED TEST MICROBIOLOGY - IEN

vistaFileField 63.05-.35 63.05-.001

vistaSubFileFieldName ORDERED TEST - IEN

vistaSubFileField 63.5-.001

1420

status in process inactive

1661

status in process inactive

1521

status inactive in process

mapValue http://loinc.org#11502-2 "Laboratory report" http://loinc.org#70004-7 "Diagnostic study note"

use-case Microbiology: Bacteriology

resource Observation[susceptibility]

1523

vistaSubFileField 63.3-5+to+160 63.3-5to160

1524

vistaSubFileField 63.3-5.1+to+160.1 63.3-5.1to160.1

use-case Document Reference

resource DocumentReference

874

vistaSubFileFieldName TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE - DOCUMENT TYPE

vistaSubFileField 8925.1-1501 > 8926.1 8925.1-1501 > 8926.1-.08

fhirSubPath .text

mapParameters .coding[va-loinc].system=http://loinc.org .coding[va-loinc].code={CODING SYSTEM(2)} .text={DOCUMENT TYPE(.08)} .coding[va-loinc].system=http://loinc.org .coding[va-loinc].code={CODING SYSTEM > CODING SYSTEM – CODE(2>8926.12-.02)}

876

mapParameters .display = {NAME (.01)}

use-case Encounter: PTF

resource Encounter

450

vistaFileField 45-45.01+to+45.05 45-45.01to45.05

1616

vistaSubFileFieldName CPT CPT - SHORT NAME

vistaSubFileField 81- 81-2

fhirSubPath .text

mapParameters .coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)} .text = {SHORT NAME (2)} .coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)}

use-case Encounter: Visit

resource Encounter

440

mapParameters .display = {NAME (.01)}

1615

vistaSubFileFieldName CPT CPT - SHORT NAME

vistaSubFileField 81- 81-2

fhirSubPath .text

mapParameters .coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)} .text = {SHORT NAME (2)} .coding.system=http://www.ama-assn.org/go/cpt .coding.code = {CPT CODE (.01)} .coding.display = {SHORT NAME (2)}

use-case VAImmunization

resource Immunization

333

mapParameters .display = {NAME (.01)}

464

vistaSubFileFieldName UCUM CODES - UCUM CODES - UCUM CODE

vistaSubFileField 757.5- 757.5-1

fhirSubPath .code

mapParameters .unit = {DESCRIPTION OF THE UNIT (.01)} .code= {UCUM CODE (1)} .unit = {DESCRIPTION OF THE UNIT (.01)}

use-case Implantable Device: A Lead

resource Device

1401

mapParameters .display = {NAME (.01)}

use-case Implantable Device: Pacemaker

resource Device

1400

mapParameters .display = {NAME (.01)}

use-case Implantable Device: V Lead

resource Device

1402

mapParameters .display = {NAME (.01)}

use-case Lung Cancer Screening

resource DiagnosticReport

933

mapParameters .display = {NAME (.01)}

use-case MedicationRequest: Outpatient

resource MedicationRequest

maprow count 41 38

813 deleted maprow DELETED

814 deleted maprow DELETED

817 deleted maprow DELETED

818 deleted maprow DELETED

2282

mapCase NOT S

2283 new maprow NEW

use-case Observation EXAM

resource Observation

1580

vistaSubFileFieldName EXAM EXAM - PRINT NAME

vistaSubFileField 9999999.15- 9999999.15-200

fhirPath Observation.code.coding[va-code] Observation.code.text

mapParameters .system= http://va.gov/fhir/CodeSystem/9999999.15 .code = {NAME(.01)} .display = {PRINT NAME(200)}

1581

vistaSubFileFieldName EXAM - CODE MAPPINGS > CODE MAPPINGS EXAM - CODE MAPPINGS > CODE MAPPINGS - CODE

vistaSubFileField 9999999.15-210>9999999.18 9999999.15-210>9999999.18-1

fhirPath Observation.code.coding[va-sct] Observation.code.coding

fhirSubPath .code

mapParameters .system = termmap(VF_ICDCodingSystems,{CODING SYSTEM(.01)}) .code = {CODE(1)} .system = termmap(VF_ICDCodingSystems,{CODING SYSTEM(.01)})

1582

mapParameters .display = {NAME (.01)}

1586

vistaSubFileFieldName UCUM CODES UCUM CODES - UCUM CODE

vistaSubFileField 757.5- 757.5-1

fhirSubPath .code

mapParameters .unit = {DESCRIPTION OF THE UNIT (.01)} .code= {UCUM CODE (1)} .unit = {DESCRIPTION OF THE UNIT (.01)}

use-case VAPractitioner

resource Practitioner

382

fhirSubPath .text

use-case Procedure: Outpatient

resource Procedure

1299

mapParameters .display = {NAME (.01)}

use-case Procedure: Radiology

resource Procedure

1509

vistaSubFileFieldName EXAMINATIONS - PROCEDURE > RAD/NUC MED PROCEDURES - CPT CODE > CPT EXAMINATIONS - PROCEDURE > RAD/NUC MED PROCEDURES - CPT CODE > CPT - CPT CODE

vistaSubFileField 70.03-2 > 71-9 > 81- 70.03-2 > 71-9 > 81-.01

fhirSubPath .code

mapParameters .system = "http://www.ama-assn.org/go/cpt" .code = {CPT CODE(.01)} .display = {SHORT NAME(2)} .system = "http://www.ama-assn.org/go/cpt" .display = {SHORT NAME(2)}

use-case Procedure: Surgery

resource Procedure

1344

vistaSubFileFieldName CPT CPT - CPT CODE

vistaSubFileField 81 81-.01

fhirSubPath .code

mapParameters .code = {CPT CODE(.01)} .system = http://www.ama-assn.org/go/cpt .display = {SHORT NAME(2)} .system = http://www.ama-assn.org/go/cpt .display = {SHORT NAME(2)}

use-case Smoking Status Observation

resource Observation

1245

mapParameters .display = {NAME (.01)}

use-case Observation Imaging Result: Echo

resource Observation

1631

mapParameters .display = {NAME (.01)}

use-case Observation Imaging Result: EKG

resource Observation

1632

mapParameters .display = {NAME (.01)}

use-case Decision Precision Plus

resource Observation[smoking]

2232

status in process inactive

use-case Decision Precision Plus: abstract

resource Observation

2266

mapParameters .display = {NAME (.01)}

use-case Document Reference AIS

resource DocumentReference

2269

vistaSubFileFieldName TIU DOCUMENT DEFINITION TIU DOCUMENT DEFINITION - VHA ENTERPRISE STANDARD TITLE > TIU VHA ENTERPRISE STANDARD TITLE - IEN

vistaSubFileField 8925.1-.001 8925.1-1501 > 8926.1-.001

fhirSubPath .coding[va-ien].code

mapParameters .coding[va-ien].system=http://va.gov/fhir/CodeSystem/{sta3n}Sta3n8925.1 .coding[va-ien].code={CODING SYSTEM(2)} .text={DOCUMENT TYPE(.08)} .coding[va-ien].system=http://va.gov/fhir/CodeSystem/{sta3n}Sta3n8925.1 .text={STANDARD TITLE(.01)}

2275

fhirSubPath .reference

mapParameters An appointment reference identifier provided by the CES appointment system. This is not persisted in VistA.

new resource Parameters

new use-case MedicationRequest: Outpatient List

<prev

top

next>

IG © 2026 VA. Package va.maps#2.3.0 based on FHIR 4.0.1. Generated 2026-02-27
Links: Table of Contents | QA Report | Propose a change