Changes

US Veterans Health Administration FHIR Map Set Implementation Guide
2.1.0 - 260101 United States of America flag

US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 2.1.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 VAPatient

key	column	old value (VA-FHIR-CoP-MapSet-PREVIOUS.xlsx)	new value (VA-FHIR-CoP-MapSet.xlsx)
use-case VAPatient
resource Patient
2274
	fhirPath	`Patient.identifier`	`Patient.identifier[va-dfn]`
use-case VAAppointment
resource Appointment
754
	fhirPath	`Appointment.participant[va-apptclinic]`	`Appointment.participant[va-appt-clinic]`
use-case Diagnostic Report Note: Surgical Pathology
resource DiagnosticReport
2212
	mapCase		`{63>63-8>63.08}`
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/fhir/sid/{sta3n}/63.07`
use-case Microbiology
resource DiagnosticReport
1536	deleted maprow		DELETED
1605
	mapParameters	`.system = http://va.gov/fhir/sid/{sta3n}/63.51`	`.system = http://va.gov/fhir/sid/{sta3n}/63.5`
2281	new maprow		NEW
resource Observation
	maprow count	11	8
1454	deleted maprow		DELETED
1480	deleted maprow		DELETED
1484	deleted maprow		DELETED
1450
	status	`for review`	`in process`
1659
	status	`for review`	`inactive`
1476
	status	`for review`	`in process`
2067
	status	`for review`	`in process`
resource Specimen
	maprow count	6	7
1454	new maprow		NEW
1469
	status	`for review`	`in process`
1470
	status	`for review`	`in process`
	vistaFileFieldName	`MICROBIOLOGY - COLLECTION SAMPLE`	`MICROBIOLOGY - SITE/SPECIMEN`
	vistaFileField	`63.05-.055`	`63.05-.05`
	vistaSubFileFieldName	`COLLECTION SAMPLE - NAME`	`TOPOGRAPHY FIELD - NAME`
	vistaSubFileField	`62-.01`	`61-.01`
2258
	mapCase		`{63>63-5>63.05}`
2261
	vistaFileFieldName	`MICROBIOLOGY - TOPOGRAPHY`	`MICROBIOLOGY - COLLECTION SAMPLE`
	vistaSubFileFieldName	`TOPOGRAPHY - NAME`	`COLLECTION SAMPLE - NAME`
	vistaSubFileField	`61-.01`	`62-.01`
	fhirSubPath	`.bodySite.text`	`.method.text`
use-case Microbiology: Bacteriology
new resource Observation[bacteriaId]
resource Observation[bacteria]
	maprow count	3	2
1525	deleted maprow		DELETED
1488
	status	`for review`	`in process`
use-case Microbiology: Parasitology
new resource Observation[parasiteId]
resource Observation[parasite]
	maprow count	3	2
1528	deleted maprow		DELETED
1489
	status	`for review`	`in process`
use-case Microbiology: Mycology
new resource Observation[fungusId]
resource Observation[fungus]
	maprow count	3	2
1527	deleted maprow		DELETED
1490
	status	`for review`	`in process`
use-case Microbiology: Mycobacteriology
new resource Observation[mycobactId]
resource Observation[mycobact]
	maprow count	3	2
1526	deleted maprow		DELETED
1491
	status	`for review`	`in process`
use-case Microbiology: Virology
new resource Observation[virusId]
resource Observation[virus]
	maprow count	3	2
1529	deleted maprow		DELETED
1492
	status	`for review`	`in process`
use-case Encounter: PTF
resource Encounter
456
	status	`update-alert`	`for review`
461
	status	`team-approved`	`for review`
use-case Encounter: Visit
resource Encounter
1599
	mapParameters	`.display = {NAME (.01)} .identifier.value = {STATION NUMBER (99)} .identifier.system = http://va.gov/identifiers/4-99`	`.display = {NAME (.01)} .identifier.value = {STATION NUMBER (99)} .identifier.system = http://va.gov/fhir/sid/4-99`
use-case Implantable Device: Pacemaker
resource Device
1349
	mapParameters	`.system = http://va.gov/fhir/sid/{sta3n}/698.1`	`.system = http://va.gov/fhir/sid/{sta3n}/698`
use-case MedicationRequest: Outpatient
resource MedicationRequest
	maprow count	40	41
2282	new maprow		NEW
use-case MedicationDispense: Original
resource MedicationDispense
1711
	fhirPath	`MedicationDispense.location`	`MedicationDispense.performer`
	fhirSubPath		`.actor`
	mapValue	`/VALocation`	`/VAOrganization`
new resource Organization
use-case Decision Precision Plus
resource Observation[smoking]
2232
	status	`in process`	`for review`
	fhirSubPath	`.dataAbsentReason`	`.valueCodeableConcept`
resource Observation[smokingpacks]
2224
	mapCase	`9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 <> null`	`9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 <> null`
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 6.1.0`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
2239
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 6.1.0`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
2272
	mapCase	`9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 is null`	`9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 is null AND isNumber(81101)`
	fhirSubPath	`.valueString`	`.valueQuantity.value`
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 5.0.1`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
resource Observation[quityear]
2226
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 6.1.0`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
resource Observation[smokingyears]
2238
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 6.1.0`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
2249
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 6.1.0`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
2273
	mapCase	`9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED; 9000010.23-220 is null`	`9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED AND 9000010.23-220 is null AND isNumber(81101)`
	fhirSubPath	`.valueString`	`.valueQuantity.value`
	fhirURL	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history \| 6.1.0`	`http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment \| 6.1.0`
use-case Decision Precision Plus: abstract
resource Observation
2228
	status	`in process`	`for review`
2268
	mapValue	`/Practitioner`	`/VAPractitioner`
use-case Document Reference AIS
resource DocumentReference
2275
	mapValue	`/Appointment`	`/VAAppointment`
	fhirURL		`http://hl7.org/fhir/StructureDefinition/DocumentReference \| 4.0.1`
2277
	fhirPath	`DocumentReference.content.attachment.data`	`DocumentReference.content.attachment.url`
	mapValue	`/Binary`
	fhirURL		`http://hl7.org/fhir/StructureDefinition/DocumentReference \| 4.0.1`
new termmap V_DEASpecialHandling

resource Patient

2274

fhirPath Patient.identifier Patient.identifier[va-dfn]

use-case VAAppointment

resource Appointment

754

fhirPath Appointment.participant[va-apptclinic] Appointment.participant[va-appt-clinic]

use-case Diagnostic Report Note: Surgical Pathology

resource DiagnosticReport

2212

mapCase {63>63-8>63.08}

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/fhir/sid/{sta3n}/63.07

use-case Microbiology

resource DiagnosticReport

1536 deleted maprow DELETED

1605

mapParameters .system = http://va.gov/fhir/sid/{sta3n}/63.51 .system = http://va.gov/fhir/sid/{sta3n}/63.5

2281 new maprow NEW

resource Observation

maprow count 11 8

1454 deleted maprow DELETED

1480 deleted maprow DELETED

1484 deleted maprow DELETED

1450

status for review in process

1659

status for review inactive

1476

status for review in process

2067

status for review in process

resource Specimen

maprow count 6 7

1454 new maprow NEW

1469

status for review in process

1470

status for review in process

vistaFileFieldName MICROBIOLOGY - COLLECTION SAMPLE MICROBIOLOGY - SITE/SPECIMEN

vistaFileField 63.05-.055 63.05-.05

vistaSubFileFieldName COLLECTION SAMPLE - NAME TOPOGRAPHY FIELD - NAME

vistaSubFileField 62-.01 61-.01

2258

mapCase {63>63-5>63.05}

2261

vistaFileFieldName MICROBIOLOGY - TOPOGRAPHY MICROBIOLOGY - COLLECTION SAMPLE

vistaSubFileFieldName TOPOGRAPHY - NAME COLLECTION SAMPLE - NAME

vistaSubFileField 61-.01 62-.01

fhirSubPath .bodySite.text .method.text

use-case Microbiology: Bacteriology

new resource Observation[bacteriaId]

resource Observation[bacteria]

maprow count 3 2

1525 deleted maprow DELETED

1488

status for review in process

use-case Microbiology: Parasitology

new resource Observation[parasiteId]

resource Observation[parasite]

maprow count 3 2

1528 deleted maprow DELETED

1489

status for review in process

use-case Microbiology: Mycology

new resource Observation[fungusId]

resource Observation[fungus]

maprow count 3 2

1527 deleted maprow DELETED

1490

status for review in process

use-case Microbiology: Mycobacteriology

new resource Observation[mycobactId]

resource Observation[mycobact]

maprow count 3 2

1526 deleted maprow DELETED

1491

status for review in process

use-case Microbiology: Virology

new resource Observation[virusId]

resource Observation[virus]

maprow count 3 2

1529 deleted maprow DELETED

1492

status for review in process

use-case Encounter: PTF

resource Encounter

456

status update-alert for review

461

status team-approved for review

use-case Encounter: Visit

resource Encounter

1599

mapParameters .display = {NAME (.01)} .identifier.value = {STATION NUMBER (99)} .identifier.system = http://va.gov/identifiers/4-99 .display = {NAME (.01)} .identifier.value = {STATION NUMBER (99)} .identifier.system = http://va.gov/fhir/sid/4-99

use-case Implantable Device: Pacemaker

resource Device

1349

mapParameters .system = http://va.gov/fhir/sid/{sta3n}/698.1 .system = http://va.gov/fhir/sid/{sta3n}/698

use-case MedicationRequest: Outpatient

resource MedicationRequest

maprow count 40 41

2282 new maprow NEW

use-case MedicationDispense: Original

resource MedicationDispense

1711

fhirPath MedicationDispense.location MedicationDispense.performer

fhirSubPath .actor

mapValue /VALocation /VAOrganization

new resource Organization

use-case Decision Precision Plus

resource Observation[smoking]

2232

status in process for review

fhirSubPath .dataAbsentReason .valueCodeableConcept

resource Observation[smokingpacks]

2224

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

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 6.1.0 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

2239

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 6.1.0 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

2272

mapCase 9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 is null 9000010.23-.01 > 9999999.64-.01 = LCS PACKS/DAY AND 9000010.23-220 is null AND isNumber(81101)

fhirSubPath .valueString .valueQuantity.value

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 5.0.1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

resource Observation[quityear]

2226

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 6.1.0 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

resource Observation[smokingyears]

2238

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 6.1.0 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

2249

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 6.1.0 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

2273

mapCase 9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED; 9000010.23-220 is null 9000010.23-.01 > 9999999.64-.01 = LCS YEARS SMOKED AND 9000010.23-220 is null AND isNumber(81101)

fhirSubPath .valueString .valueQuantity.value

fhirURL http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-social-history | 6.1.0 http://hl7.org/fhir/us/core/StructureDefinition/us-core-observation-screening-assessment | 6.1.0

use-case Decision Precision Plus: abstract

resource Observation

2228

status in process for review

2268

mapValue /Practitioner /VAPractitioner

use-case Document Reference AIS

resource DocumentReference

2275

mapValue /Appointment /VAAppointment

fhirURL http://hl7.org/fhir/StructureDefinition/DocumentReference | 4.0.1

2277

fhirPath DocumentReference.content.attachment.data DocumentReference.content.attachment.url

mapValue /Binary

fhirURL http://hl7.org/fhir/StructureDefinition/DocumentReference | 4.0.1

new termmap V_DEASpecialHandling

<prev

top

next>

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