US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001 United States of America flag

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

Resource Profile: Practitioner - Mappings

Active as of 2025-09-30

Mappings for the Practitioner resource profile.

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

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

Mapping Sources

Use Case: Practitioner (Source)Use Case: Practitioner (Source)NAME COMPONENTS (20)1FAMILY (LAST) NAME2GIVEN (FIRST) NAME4PREFIX5SUFFIXNEW PERSON (200).001IEN4SEX5DOB10.1NAME COMPONENTS10.6DEGREE41.99NPI42EFFECTIVE DATE/TIME53.2DEA#53.3VA#9000VPID

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
376 team-approved V2F NEW PERSON - NPI (200-41.99) source value Practitioner.identifier[NPI] .value .system = http://hl7.org/fhir/sid/us-npi
.type=http://terminology.hl7.org/CodeSystem/v2-0203#NPI
changed .code from PRN to NPI http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
377 team-approved V2F NEW PERSON - DEA# (200-53.2) source value Practitioner.identifier[va-DEA] .value .system = urn:oid:2.16.840.1.113883.4.814
.type=http://terminology.hl7.org/CodeSystem/v2-0203#DEA
changed .code from PRN to DEA http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
378 team-approved V2F NEW PERSON - VA# (200-53.3) source value Practitioner.identifier[va-nr] .value .system = urn:oid:2.16.840.1.113883.4.349
.type=http://va.gov/terminology/vistaDefinedTerms/200-53.3#VA_Number
changed .code from PRN to VA_Number. Value set is extensible http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
379 team-approved V2F NEW PERSON - VPID (200-9000) source value Practitioner.identifier[va-VPID] .value .system = urn:oid:2.16.840.1.113883.4.349
.type=http://va.gov/terminology/vistaDefinedTerms/200-9000#VPID
changed .code from PRN to VPID. Value set is extensible http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
380 team-approved V2F NEW PERSON - EFFECTIVE DATE/TIME (200-42) source value Practitioner.identifier[NPI] .period.start http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
382 team-approved V2F NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - (200-10.1 > 20-) source value Practitioner.name .text .family = {FAMILY (LAST) NAME (1)}
.given = {GIVEN (FIRST) NAME (2)}
.prefix = {PREFIX (4)}
.suffix = {SUFFIX (5)}
Change map to better align with US Core Must Support (last name only) http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
394 team-approved V2F NEW PERSON - DOB (200-5) source value Practitioner.birthDate http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
395 team-approved V2F NEW PERSON - DEGREE (200-10.6) source value Practitioner.qualification .code.text There is also 12.1 CURRENT DEGREE LEVEL; not in cdw http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
415 team-approved V2F NEW PERSON - IEN (200-.001) source value Practitioner.identifier[va-IEN] .value .system = http://va.gov/identifiers/$Sta3n/200
.type=http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN
http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
1790 for review V2F NEW PERSON - SEX (200-4) terminologyMaps Practitioner.gender VF_providerGender Added per LH request to help support deduplication fingerprints http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameVeterans Health Information Systems Technology and Architecture (VistA)Clinical Data Warehouse (CDW)doco
.. Practitioner
... id
... meta
... implicitRules
... text
... contained
... extension
... modifierExtension
... Slices for identifier
.... identifier:NPI
..... id
..... extension
..... use
..... type
fixed value = http://terminology.hl7.org/CodeSystem/v2-0203#NPI
mapParameter line 2
..... system
fixed value = http://hl7.org/fhir/sid/us-npi
mapParameter line 1
..... value
source value based on NEW PERSON - NPI (200-41.99)
changed .code from PRN to NPI
SStaff.PrescribingProvider.NPI SStaff.SStaff.NPI
..... period
...... id
...... extension
...... start
source value based on NEW PERSON - EFFECTIVE DATE/TIME (200-42)
...... end
..... assigner
.... identifier:va-DEA
..... id
..... extension
..... use
..... type
fixed value = http://terminology.hl7.org/CodeSystem/v2-0203#DEA
mapParameter line 2
..... system
fixed value = urn:oid:2.16.840.1.113883.4.814
mapParameter line 1
..... value
source value based on NEW PERSON - DEA# (200-53.2)
changed .code from PRN to DEA
SStaff.PrescribingProvider.DEA SStaff.SStaff.DEA
..... period
..... assigner
.... identifier:va-nr
..... id
..... extension
..... use
..... type
fixed value = http://va.gov/terminology/vistaDefinedTerms/200-53.3#VA_Number
mapParameter line 2
..... system
fixed value = urn:oid:2.16.840.1.113883.4.349
mapParameter line 1
..... value
source value based on NEW PERSON - VA# (200-53.3)
changed .code from PRN to VA_Number. Value set is extensible
SStaff.PrescribingProvider.VANumber SStaff.SStaff.VANumber
..... period
..... assigner
.... identifier:va-VPID
..... id
..... extension
..... use
..... type
fixed value = http://va.gov/terminology/vistaDefinedTerms/200-9000#VPID
mapParameter line 2
..... system
fixed value = urn:oid:2.16.840.1.113883.4.349
mapParameter line 1
..... value
source value based on NEW PERSON - VPID (200-9000)
changed .code from PRN to VPID. Value set is extensible
SStaff.PrescribingProvider.VPID SStaff.SStaff.VAPersonIdentificationNumber
..... period
..... assigner
.... identifier:va-IEN
..... id
..... extension
..... use
..... type
fixed value = http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN
mapParameter line 2
..... system
fixed value = http://va.gov/identifiers/$Sta3n/200
mapParameter line 1
..... value
source value based on NEW PERSON - IEN (200-.001)
..... period
..... assigner
... active
... name
.... id
.... extension
.... use
.... text
source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - (200-10.1 > 20-)
Change map to better align with US Core Must Support (last name only)
SStaff.SStaff.FirstName SStaff.SStaff.LastName SStaff.SStaff.MiddleName SStaff.SStaff.StaffNamePrefix SStaff.SStaff.StaffNameSuffix
.... family
source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - FAMILY (LAST) NAME (200-10.1 > 20-1)
mapParameter line 1
SStaff.SStaff.FirstName SStaff.SStaff.LastName SStaff.SStaff.MiddleName SStaff.SStaff.StaffNamePrefix SStaff.SStaff.StaffNameSuffix
.... given
source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - GIVEN (FIRST) NAME (200-10.1 > 20-2)
mapParameter line 2
SStaff.SStaff.FirstName SStaff.SStaff.LastName SStaff.SStaff.MiddleName SStaff.SStaff.StaffNamePrefix SStaff.SStaff.StaffNameSuffix
.... prefix
source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - PREFIX (200-10.1 > 20-4)
mapParameter line 3
SStaff.SStaff.FirstName SStaff.SStaff.LastName SStaff.SStaff.MiddleName SStaff.SStaff.StaffNamePrefix SStaff.SStaff.StaffNameSuffix
.... suffix
source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - SUFFIX (200-10.1 > 20-5)
mapParameter line 4
SStaff.SStaff.FirstName SStaff.SStaff.LastName SStaff.SStaff.MiddleName SStaff.SStaff.StaffNamePrefix SStaff.SStaff.StaffNameSuffix
.... period
... telecom
.... id
.... extension
.... system
.... value
.... use
.... rank
.... period
... address
.... id
.... extension
.... use
.... type
.... text
.... line
.... city
.... district
.... state
.... postalCode
.... country
.... period
... gender
terminologyMaps using VF_providerGender on NEW PERSON - SEX (200-4)
Added per LH request to help support deduplication fingerprints
SStaff.SStaff.Gender Staff.Staff.Gender
... birthDate
source value based on NEW PERSON - DOB (200-5)
SStaff.SStaff.BirthDateTime Staff.Staff.BirthDateTime
... photo
... qualification
.... id
.... extension
.... modifierExtension
.... identifier
.... code
..... id
..... extension
..... coding
..... text
source value based on NEW PERSON - DEGREE (200-10.6)
There is also 12.1 CURRENT DEGREE LEVEL; not in cdw
SStaff.SStaff.Degree Staff.Staff.Degree
.... period
.... issuer
... communication

doco Documentation for this format