US Veterans Health Administration FHIR Map Set Implementation Guide
1.6.0 - 250701 United States of America flag

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

Resource Profile: Practitioner - Mappings

Active as of 2025-06-20

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).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
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
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
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

NameHL7 v2 MappingRIM MappingServDFiveWs Pattern Mappingdoco
.. Practitioner
PRD (as one example)
Role
Provider
... id
... meta
... implicitRules
... text
Act.text?
... contained
N/A
... extension
N/A
... modifierExtension
N/A
... Slices for identifier
PRD-7 (or XCN.1)
./id
./Identifiers
FiveWs.identifier
.... identifier:NPI
PRD-7 (or XCN.1)
./id
./Identifiers
FiveWs.identifier
..... id
n/a
..... extension
n/a
..... use
N/A
Role.code or implied by context
..... type
CX.5
Role.code or implied by context
..... system
CX.4 / EI-2-4
II.root or Role.id.root
./IdentifierType
..... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
./Value
..... period
CX.7 + CX.8
Role.effectiveTime or implied by context
./StartDate and ./EndDate
...... id
n/a
...... extension
n/a
...... start
DR.1
./low
...... end
DR.2
./high
..... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
./IdentifierIssuingAuthority
.... identifier:va-DEA
PRD-7 (or XCN.1)
./id
./Identifiers
FiveWs.identifier
..... id
n/a
..... extension
n/a
..... use
N/A
Role.code or implied by context
..... type
CX.5
Role.code or implied by context
..... system
CX.4 / EI-2-4
II.root or Role.id.root
./IdentifierType
..... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
./Value
..... period
CX.7 + CX.8
Role.effectiveTime or implied by context
./StartDate and ./EndDate
..... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
./IdentifierIssuingAuthority
.... identifier:va-nr
PRD-7 (or XCN.1)
./id
./Identifiers
FiveWs.identifier
..... id
n/a
..... extension
n/a
..... use
N/A
Role.code or implied by context
..... type
CX.5
Role.code or implied by context
..... system
CX.4 / EI-2-4
II.root or Role.id.root
./IdentifierType
..... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
./Value
..... period
CX.7 + CX.8
Role.effectiveTime or implied by context
./StartDate and ./EndDate
..... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
./IdentifierIssuingAuthority
.... identifier:va-VPID
PRD-7 (or XCN.1)
./id
./Identifiers
FiveWs.identifier
..... id
n/a
..... extension
n/a
..... use
N/A
Role.code or implied by context
..... type
CX.5
Role.code or implied by context
..... system
CX.4 / EI-2-4
II.root or Role.id.root
./IdentifierType
..... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
./Value
..... period
CX.7 + CX.8
Role.effectiveTime or implied by context
./StartDate and ./EndDate
..... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
./IdentifierIssuingAuthority
.... identifier:va-IEN
PRD-7 (or XCN.1)
./id
./Identifiers
FiveWs.identifier
..... id
n/a
..... extension
n/a
..... use
N/A
Role.code or implied by context
..... type
CX.5
Role.code or implied by context
..... system
CX.4 / EI-2-4
II.root or Role.id.root
./IdentifierType
..... value
CX.1 / EI.1
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
./Value
..... period
CX.7 + CX.8
Role.effectiveTime or implied by context
./StartDate and ./EndDate
..... assigner
  • CX.4 / (CX.4
  • CX.9
  • CX.10)
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
./IdentifierIssuingAuthority
... active
./statusCode
FiveWs.status
... name
XCN Components
./name
  • ./PreferredName (GivenNames
  • FamilyName
  • TitleCode)
.... id
n/a
.... extension
n/a
.... use
  • XPN.7
  • but often indicated by which field contains the name
unique(./use)
./NamePurpose
.... text
implied by XPN.11
./formatted
.... family
XPN.1/FN.1
./part[partType = FAM]
./FamilyName
.... given
XPN.2 + XPN.3
./part[partType = GIV]
./GivenNames
.... prefix
XPN.5
./part[partType = PFX]
./TitleCode
.... suffix
XPN/4
./part[partType = SFX]
.... period
XPN.13 + XPN.14
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
... telecom
  • PRT-15
  • STF-10
  • ROL-12
./telecom
./ContactPoints
.... id
n/a
.... extension
n/a
.... system
XTN.3
./scheme
./ContactPointType
.... value
XTN.1 (or XTN.12)
./url
./Value
.... use
XTN.2 - but often indicated by field
unique(./use)
./ContactPointPurpose
.... rank
n/a
n/a
.... period
N/A
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
... address
  • ORC-24
  • STF-11
  • ROL-11
  • PRT-14
./addr
n/a
.... id
n/a
.... extension
n/a
.... use
XAD.7
unique(./use)
./AddressPurpose
.... type
XAD.18
unique(./use)
.... text
XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6
./formatted
.... line
XAD.1 and XAD.2 have different meanings for a company address than for a person address)
AD.part[parttype = AL]
./StreetAddress (newline delimitted)
.... city
XAD.3
AD.part[parttype = CTY]
./Jurisdiction
.... district
XAD.9
AD.part[parttype = CNT | CPA]
.... state
XAD.4
AD.part[parttype = STA]
./Sites
.... postalCode
XAD.5
AD.part[parttype = ZIP]
./PostalIdentificationCode
.... country
XAD.6
AD.part[parttype = CNT]
./Country
.... period
XAD.12 / XAD.13 + XAD.14
./usablePeriod[type="IVL<TS>"]
./StartDate and ./EndDate
... gender
STF-5
./administrativeGender
./GenderCode
... birthDate
STF-6
./birthTime
(not represented in ServD)
... photo
./subjectOf/ObservationEvent[code="photo"]/value
./ImageURI (only supports the URI reference)
... qualification
CER?
.playingEntity.playingRole[classCode=QUAL].code
./Qualifications
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... identifier
.playingEntity.playingRole[classCode=QUAL].id
.... code
.playingEntity.playingRole[classCode=QUAL].code
./Qualifications.Value
..... id
n/a
..... extension
n/a
..... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
..... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
.... period
.playingEntity.playingRole[classCode=QUAL].effectiveTime
./Qualifications.StartDate and ./Qualifications.EndDate
.... issuer
.playingEntity.playingRole[classCode=QUAL].scoper
... communication
  • PID-15
  • NK1-20
  • LAN-2
./languageCommunication
./Languages.LanguageSpokenCode

doco Documentation for this format