US Veterans Health Administration FHIR Map Set Implementation Guide
1.3.1 - 250401 United States of America flag

Publication Build: This will be filled in by the publication tooling

Resource Profile: Practitioner - Mappings

Active as of 2025-03-31

Mappings for the Practitioner 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.

Mapping Sources

Use Case: Practitioner (Source)NAME COMPONENTS (20)1FAMILY (LAST) NAME2GIVEN (FIRST) NAME4PREFIX5SUFFIXNEW PERSON (200).001IEN.131PHONE (HOME)4SEX5DOB10.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
376-1 team-approved V2F fixed value Practitioner.identifier[NPI] .system http://hl7.org/fhir/sid/us-npi generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
376-2 team-approved V2F fixed value Practitioner.identifier[NPI] .type http://terminology.hl7.org/CodeSystem/v2-0203#NPI generated from mapParameter line 2 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
377-1 team-approved V2F fixed value Practitioner.identifier[va-DEA] .system urn:oid:2.16.840.1.113883.4.814 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
377-2 team-approved V2F fixed value Practitioner.identifier[va-DEA] .type http://terminology.hl7.org/CodeSystem/v2-0203#DEA generated from mapParameter line 2 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
378-1 team-approved V2F fixed value Practitioner.identifier[va-nr] .system urn:oid:2.16.840.1.113883.4.349 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
378-2 team-approved V2F fixed value Practitioner.identifier[va-nr] .type http://va.gov/terminology/vistaDefinedTerms/200-53.3#VA_Number generated from mapParameter line 2 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
379-1 team-approved V2F fixed value Practitioner.identifier[va-VPID] .system urn:oid:2.16.840.1.113883.4.349 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
379-2 team-approved V2F fixed value Practitioner.identifier[va-VPID] .type http://va.gov/terminology/vistaDefinedTerms/200-9000#VPID generated from mapParameter line 2 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
382-1 team-approved V2F NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - FAMILY (LAST) NAME (200-10.1 > 20-1) source value Practitioner.name .family generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
382-2 team-approved V2F NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - GIVEN (FIRST) NAME (200-10.1 > 20-2) source value Practitioner.name .given generated from mapParameter line 2 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
382-3 team-approved V2F NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - PREFIX (200-10.1 > 20-4) source value Practitioner.name .prefix generated from mapParameter line 3 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
382-4 team-approved V2F NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - SUFFIX (200-10.1 > 20-5) source value Practitioner.name .suffix generated from mapParameter line 4 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
383 team-approved V2F NEW PERSON - PHONE (HOME) (200-.131) source value Practitioner.telecom .value .system=#phone
.use=#home		 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
383-1 team-approved V2F fixed value Practitioner.telecom .system #phone generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
383-2 team-approved V2F fixed value Practitioner.telecom .use #home generated from mapParameter line 2 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
415-1 team-approved V2F fixed value Practitioner.identifier[va-IEN] .system http://va.gov/identifiers/$Sta3n/200 generated from mapParameter line 1 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitioner | 5.0.1
415-2 team-approved V2F fixed value Practitioner.identifier[va-IEN] .type http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN generated from mapParameter line 2 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 for Veterans Health Information Systems Technology and Architecture (VistA) ()

Practitioner
Practitioner
   identifier
   identifier (NPI)
      type376-2: fixed value = http://terminology.hl7.org/CodeSystem/v2-0203#NPI

generated from mapParameter line 2
      system376-1: fixed value = http://hl7.org/fhir/sid/us-npi

generated from mapParameter line 1
      value376: source value based on NEW PERSON - NPI (200-41.99)

changed .code from PRN to NPI
      period
         start380: source value based on NEW PERSON - EFFECTIVE DATE/TIME (200-42)
   identifier (va-DEA)
      type377-2: fixed value = http://terminology.hl7.org/CodeSystem/v2-0203#DEA

generated from mapParameter line 2
      system377-1: fixed value = urn:oid:2.16.840.1.113883.4.814

generated from mapParameter line 1
      value377: source value based on NEW PERSON - DEA# (200-53.2)

changed .code from PRN to DEA
   identifier (va-nr)
      type378-2: fixed value = http://va.gov/terminology/vistaDefinedTerms/200-53.3#VA_Number

generated from mapParameter line 2
      system378-1: fixed value = urn:oid:2.16.840.1.113883.4.349

generated from mapParameter line 1
      value378: source value based on NEW PERSON - VA# (200-53.3)

changed .code from PRN to VA_Number. Value set is extensible
   identifier (va-VPID)
      type379-2: fixed value = http://va.gov/terminology/vistaDefinedTerms/200-9000#VPID

generated from mapParameter line 2
      system379-1: fixed value = urn:oid:2.16.840.1.113883.4.349

generated from mapParameter line 1
      value379: source value based on NEW PERSON - VPID (200-9000)

changed .code from PRN to VPID. Value set is extensible
   identifier (va-IEN)
      type415-2: fixed value = http://va.gov/terminology/vistaDefinedTerms/200-.001#IEN

generated from mapParameter line 2
      system415-1: fixed value = http://va.gov/identifiers/$Sta3n/200

generated from mapParameter line 1
      value415: source value based on NEW PERSON - IEN (200-.001)
   name
      text382: 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)
      family382-1: source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - FAMILY (LAST) NAME (200-10.1 > 20-1)

generated from mapParameter line 1
      given382-2: source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - GIVEN (FIRST) NAME (200-10.1 > 20-2)

generated from mapParameter line 2
      prefix382-3: source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - PREFIX (200-10.1 > 20-4)

generated from mapParameter line 3
      suffix382-4: source value based on NEW PERSON - NAME COMPONENTS > NAME COMPONENTS - SUFFIX (200-10.1 > 20-5)

generated from mapParameter line 4
   telecom
      system383-1: fixed value = #phone

generated from mapParameter line 1
      value383: source value based on NEW PERSON - PHONE (HOME) (200-.131)
      use383-2: fixed value = #home

generated from mapParameter line 2
   gender1790: terminologyMaps using VF_providerGender on NEW PERSON - SEX (200-4)

Added per LH request to help support deduplication fingerprints
   birthDate394: source value based on NEW PERSON - DOB (200-5)
   qualification
      code
         text395: source value based on NEW PERSON - DEGREE (200-10.6)

There is also 12.1 CURRENT DEGREE LEVEL; not in cdw

Mappings for Clinical Data Warehouse (CDW) ()

Practitioner
Practitioner
   identifier
   identifier (NPI)
      valueSStaff.PrescribingProvider.NPI,SStaff.SStaff.NPI
   identifier (va-DEA)
      valueSStaff.PrescribingProvider.DEA,SStaff.SStaff.DEA
   identifier (va-nr)
      valueSStaff.PrescribingProvider.VANumber,SStaff.SStaff.VANumber
   identifier (va-VPID)
      valueSStaff.PrescribingProvider.VPID,SStaff.SStaff.VAPersonIdentificationNumber
   name
      textSStaff.SStaff.FirstName,SStaff.SStaff.LastName,SStaff.SStaff.MiddleName,SStaff.SStaff.StaffNamePrefix,SStaff.SStaff.StaffNameSuffix
      familySStaff.SStaff.FirstName,SStaff.SStaff.LastName,SStaff.SStaff.MiddleName,SStaff.SStaff.StaffNamePrefix,SStaff.SStaff.StaffNameSuffix
      givenSStaff.SStaff.FirstName,SStaff.SStaff.LastName,SStaff.SStaff.MiddleName,SStaff.SStaff.StaffNamePrefix,SStaff.SStaff.StaffNameSuffix
      prefixSStaff.SStaff.FirstName,SStaff.SStaff.LastName,SStaff.SStaff.MiddleName,SStaff.SStaff.StaffNamePrefix,SStaff.SStaff.StaffNameSuffix
      suffixSStaff.SStaff.FirstName,SStaff.SStaff.LastName,SStaff.SStaff.MiddleName,SStaff.SStaff.StaffNamePrefix,SStaff.SStaff.StaffNameSuffix
   telecom
      valueSStaff.PrescribingProvider.HomePhone,SStaff.SStaff.HomePhone
   genderSStaff.SStaff.Gender,Staff.Staff.Gender
   birthDateSStaff.SStaff.BirthDateTime,Staff.Staff.BirthDateTime
   qualification
      code
         textSStaff.SStaff.Degree,Staff.Staff.Degree

Mappings for HL7 v2 Mapping (http://hl7.org/v2)

Practitioner
PractitionerPRD (as one example)
   identifierPRD-7 (or XCN.1)
   identifier (NPI)PRD-7 (or XCN.1)
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
         startDR.1
         endDR.2
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (va-DEA)PRD-7 (or XCN.1)
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (va-nr)PRD-7 (or XCN.1)
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (va-VPID)PRD-7 (or XCN.1)
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   identifier (va-IEN)PRD-7 (or XCN.1)
      useN/A
      typeCX.5
      systemCX.4 / EI-2-4
      valueCX.1 / EI.1
      periodCX.7 + CX.8
      assignerCX.4 / (CX.4,CX.9,CX.10)
   nameXCN Components
      useXPN.7, but often indicated by which field contains the name
      textimplied by XPN.11
      familyXPN.1/FN.1
      givenXPN.2 + XPN.3
      prefixXPN.5
      suffixXPN/4
      periodXPN.13 + XPN.14
   telecomPRT-15, STF-10, ROL-12
      systemXTN.3
      valueXTN.1 (or XTN.12)
      useXTN.2 - but often indicated by field
      rankn/a
      periodN/A
   addressORC-24, STF-11, ROL-11, PRT-14
      useXAD.7
      typeXAD.18
      textXAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
      lineXAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)
      cityXAD.3
      districtXAD.9
      stateXAD.4
      postalCodeXAD.5
      countryXAD.6
      periodXAD.12 / XAD.13 + XAD.14
   genderSTF-5
   birthDateSTF-6
   qualificationCER?
      code
         codingC*E.1-8, C*E.10-22
         textC*E.9. But note many systems use C*E.2 for this
   communicationPID-15, NK1-20, LAN-2

Mappings for RIM Mapping (http://hl7.org/v3)

Practitioner
PractitionerEntity. Role, or Act, Role
   textAct.text?
   containedN/A
   extensionN/A
   modifierExtensionN/A
   identifier./id
   identifier (NPI)./id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
         idn/a
         extensionn/a
         start./low
         end./high
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (va-DEA)./id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (va-nr)./id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (va-VPID)./id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   identifier (va-IEN)./id
      idn/a
      extensionn/a
      useRole.code or implied by context
      typeRole.code or implied by context
      systemII.root or Role.id.root
      valueII.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
      periodRole.effectiveTime or implied by context
      assignerII.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
   active./statusCode
   name./name
      idn/a
      extensionn/a
      useunique(./use)
      text./formatted
      family./part[partType = FAM]
      given./part[partType = GIV]
      prefix./part[partType = PFX]
      suffix./part[partType = SFX]
      period./usablePeriod[type="IVL<TS>"]
   telecom./telecom
      idn/a
      extensionn/a
      system./scheme
      value./url
      useunique(./use)
      rankn/a
      period./usablePeriod[type="IVL<TS>"]
   address./addr
      idn/a
      extensionn/a
      useunique(./use)
      typeunique(./use)
      text./formatted
      lineAD.part[parttype = AL]
      cityAD.part[parttype = CTY]
      districtAD.part[parttype = CNT | CPA]
      stateAD.part[parttype = STA]
      postalCodeAD.part[parttype = ZIP]
      countryAD.part[parttype = CNT]
      period./usablePeriod[type="IVL<TS>"]
   gender./administrativeGender
   birthDate./birthTime
   photo./subjectOf/ObservationEvent[code="photo"]/value
   qualification.playingEntity.playingRole[classCode=QUAL].code
      idn/a
      extensionn/a
      modifierExtensionN/A
      identifier.playingEntity.playingRole[classCode=QUAL].id
      code.playingEntity.playingRole[classCode=QUAL].code
         idn/a
         extensionn/a
         codingunion(., ./translation)
         text./originalText[mediaType/code="text/plain"]/data
      period.playingEntity.playingRole[classCode=QUAL].effectiveTime
      issuer.playingEntity.playingRole[classCode=QUAL].scoper
   communication./languageCommunication

Mappings for ServD (http://www.omg.org/spec/ServD/1.0/)

Practitioner
PractitionerProvider
   identifier./Identifiers
   identifier (NPI)./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   identifier (va-DEA)./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   identifier (va-nr)./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   identifier (va-VPID)./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   identifier (va-IEN)./Identifiers
      system./IdentifierType
      value./Value
      period./StartDate and ./EndDate
      assigner./IdentifierIssuingAuthority
   name./PreferredName (GivenNames, FamilyName, TitleCode)
      use./NamePurpose
      family./FamilyName
      given./GivenNames
      prefix./TitleCode
      period./StartDate and ./EndDate
   telecom./ContactPoints
      system./ContactPointType
      value./Value
      use./ContactPointPurpose
      period./StartDate and ./EndDate
   address./Addresses, n/a
      use./AddressPurpose
      line./StreetAddress (newline delimitted)
      city./Jurisdiction
      state./Region, ./Sites
      postalCode./PostalIdentificationCode
      country./Country
      period./StartDate and ./EndDate
   gender./GenderCode
   birthDate(not represented in ServD)
   photo./ImageURI (only supports the URI reference)
   qualification./Qualifications
      code./Qualifications.Value
      period./Qualifications.StartDate and ./Qualifications.EndDate
   communication./Languages.LanguageSpokenCode

Mappings for FiveWs Pattern Mapping (http://hl7.org/fhir/fivews)

Practitioner
Practitioner
   identifierFiveWs.identifier
   identifier (NPI)FiveWs.identifier
   identifier (va-DEA)FiveWs.identifier
   identifier (va-nr)FiveWs.identifier
   identifier (va-VPID)FiveWs.identifier
   identifier (va-IEN)FiveWs.identifier
   activeFiveWs.status