US Veterans Health Administration FHIR Map Set Implementation Guide
1.8.0 - 250901 United States of America flag

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

Resource Profile: PractitionerRole - Mappings

Active as of 2025-09-02

Mappings for the PractitionerRole 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 Role (Source)Use Case: Practitioner Role (Source)HOSPITAL LOCATION (44)  NEW PERSON (200).01NAME.132OFFICE PHONE.133PHONE #3.134PHONE #4.135COMMERCIAL PHONE.136FAX NUMBER.137VOICE PAGER.138DIGITAL PAGER.151EMAIL ADDRESS8TITLE16DIVISION20.3SIGNATURE BLOCK TITLE8932.1PERSON CLASSPERSON CLASS (200.05).01Person Class2Effective Date3Expiration DateTITLE (3.1).01NAMEPERSON CLASS (8932.1)1CLASSIFICATION6X12 CODE[date > now or = null][date < now]

Raw Mappings

key status direction source mapApproach mapCase FHIR Path subPath mapValue mapParameter mapComment FHIR URL | Ver
384 team-approved V2F NEW PERSON - OFFICE PHONE (200-.132) source value PractitionerRole.telecom[va-work] .value .system=#phone
.use=#work
Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
385 team-approved V2F NEW PERSON - PHONE #3 (200-.133) source value PractitionerRole.telecom[va-phone3] .value .system=#phone Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
386 team-approved V2F NEW PERSON - PHONE #4 (200-.134) source value PractitionerRole.telecom[va-phone4] .value .system=#phone Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
387 team-approved V2F NEW PERSON - COMMERCIAL PHONE (200-.135) source value PractitionerRole.telecom[va-commercial] .value .system=#phone
.use=#work
Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
388 team-approved V2F NEW PERSON - FAX NUMBER (200-.136) source value PractitionerRole.telecom[va-fax] .value .system=#fax
.use=#work
Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
389 team-approved V2F NEW PERSON - VOICE PAGER (200-.137) source value PractitionerRole.telecom[va-voice-pager] .value .system=#pager Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
390 team-approved V2F NEW PERSON - DIGITAL PAGER (200-.138) source value PractitionerRole.telecom[va-data-pager] .value .system=#pager Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
391 team-approved V2F NEW PERSON - EMAIL ADDRESS (200-.151) source value PractitionerRole.telecom[va-mail] .value .system=#email Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
411 for review V2F NEW PERSON - PERSON CLASS > PERSON CLASS - Expiration Date (200-8932.1 > 200.05-3) fixed value date > now or = null PractitionerRole.active true This is the NUCC Provider Taxonomy. Changed mapping to indicate the expiration date field related to the class which aligns to the role 04/12/23 Confirmed during FHIR Office Hours: Role expiration date should be used; termination date is a system date http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
412 for review V2F NEW PERSON - PERSON CLASS > PERSON CLASS - Expiration Date (200-8932.1 > 200.05-3) fixed value date < now PractitionerRole.active false Changed mapping to indicate the expiration date field related to the class which aligns to the role 04/12/23 Confirmed during FHIR Office Hours: Role expiration date should be used; termination date is a system date http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
413 team-approved V2F NEW PERSON - PERSON CLASS > PERSON CLASS - Effective Date (200-8932.1 > 200.05-2) source value PractitionerRole.period .start Changed mapping to indicate the effective date field related to the class which aligns to the role http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
414 team-approved V2F NEW PERSON - NAME (200-.01) reference PractitionerRole.practitioner /Practitioner Use US Core Practitioner Profile. Changed map to better align with US Core http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
416 for review V2F NEW PERSON - PERSON CLASS > PERSON CLASS - Expiration Date (200-8932.1 > 200.05-3) source value PractitionerRole.period .end Changed mapping to indicate the expiration date field related to the class which aligns to the role 04/12/23 Confirmed during FHIR Office Hours: Role expiration date should be used; termination date is a system date http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
417 for review V2F NEW PERSON - SIGNATURE BLOCK TITLE (200-20.3) source value PractitionerRole.extension[http://hl7.org/fhir/StructureDefinition/practitioner-job-title] .valueCodeableConcept.text http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
418 for review V2F NEW PERSON - TITLE > TITLE - NAME (200-8 > 3.1-.01) source value PractitionerRole.extension[http://hl7.org/fhir/StructureDefinition/practitioner-job-title] .valueCodeableConcept.text http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
419 team-approved V2F NEW PERSON - PERSON CLASS > PERSON CLASS - Person Class > PERSON CLASS - X12 CODE (200-8932.1 > 200.05-.01 > 8932.1-6) source value PractitionerRole.specialty.coding .code .system = http://nucc.org/provider-taxonomy
.display = concat({PROVIDER TYPE (.01)}, {CLASSIFICATION (1)}, {AREA OF SPECIALIZATION (2)})
Added paths http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
422 team-approved V2F HOSPITAL LOCATION - (44-) reference 44-2600>44.1-.01>200 PractitionerRole.location /Location This is a reverse pointer. Location 44 contains 44.1, pointing at providers http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
1408 team-approved V2F NEW PERSON - PERSON CLASS > PERSON CLASS - Person Class > PERSON CLASS - X12 CODE (200-8932.1 > 200.05-.01 > 8932.1-6) source value PractitionerRole.code.coding .code .system = http://nucc.org/provider-taxonomy
.display = {CLASSIFICATION (1)}
NUCC and X12 codes are the same http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
2013 team-approved V2F target not supported PractitionerRole.endpoint See key 1410 http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 5.0.1
1411 for review V2F NEW PERSON - DIVISION (200-16) reference PractitionerRole.organization /Organization Issue: VistA may have more than one record. Instantiate multiple Role resources. http://hl7.org/fhir/us/core/StructureDefinition/us-core-practitionerrole | 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
.. PractitionerRole
PRD (as one example)
Role
ServiceSiteProvider
... id
... meta
... implicitRules
... text
Act.text?
... contained
N/A
... Slices for extension
.... extension:practitioner-job-title
..... id
n/a
..... extension
..... url
N/A
..... value[x]
N/A
...... 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
... modifierExtension
N/A
... identifier
PRD-7 (or XCN.1)
.id
./Identifiers
FiveWs.identifier
... active
STF-7
.statusCode
FiveWs.status
... period
PRD-8/9 / PRA-5.4
.performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime
  • (ServD maps Practitioners and Organizations via another entity
  • so this concept is not available)
FiveWs.done[x]
.... id
n/a
.... extension
n/a
.... start
DR.1
./low
.... end
DR.2
./high
... practitioner
.player
... organization
.scoper
... code
PRD-1 / STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17
.code
  • (ServD maps Practitioners and Organizations via another entity
  • so this concept is not available)
.... id
n/a
.... extension
n/a
.... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
..... id
n/a
..... extension
n/a
..... system
C*E.3
./codeSystem
..... version
C*E.7
./codeSystemVersion
..... code
C*E.1
./code
..... display
C*E.2 - but note this is not well followed
CV.displayName
..... userSelected
Sometimes implied by being first
CD.codingRationale
.... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
... specialty
PRA-5
.player.HealthCareProvider[@classCode = 'PROV'].code
./Specialty
.... id
n/a
.... extension
n/a
.... coding
  • C*E.1-8
  • C*E.10-22
  • union(.
  • ./translation)
..... id
n/a
..... extension
n/a
..... system
C*E.3
./codeSystem
..... version
C*E.7
./codeSystemVersion
..... code
C*E.1
./code
..... display
C*E.2 - but note this is not well followed
CV.displayName
..... userSelected
Sometimes implied by being first
CD.codingRationale
.... text
C*E.9. But note many systems use C*E.2 for this
./originalText[mediaType/code="text/plain"]/data
... location
.performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC']
  • (ServD maps Practitioners and Organizations via another entity
  • so this concept is not available)<br/> However these are accessed via the Site.ServiceSite.ServiceSiteProvider record. (The Site has the location)
FiveWs.where[x]
... healthcareService
EDU-2 / AFF-3
.player.QualifiedEntity[@classCode = 'QUAL'].code
... Slices for telecom
.telecom
.... telecom:All Slices
..... 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
.... telecom:va-work
.telecom
..... 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
.... telecom:va-phone3
.telecom
..... 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
.... telecom:va-phone4
.telecom
..... 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
.... telecom:va-commercial
.telecom
..... 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
.... telecom:va-fax
.telecom
..... 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
.... telecom:va-voice-pager
.telecom
..... 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
.... telecom:va-data-pager
.telecom
..... 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
.... telecom:va-mail
.telecom
..... 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
... availableTime
.effectiveTime
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... daysOfWeek
.effectiveTime
.... allDay
.effectiveTime
.... availableStartTime
.effectiveTime
.... availableEndTime
.effectiveTime
... notAvailable
.effectiveTime
.... id
n/a
.... extension
n/a
.... modifierExtension
N/A
.... description
n/a
.... during
.effectiveTime
... availabilityExceptions
.effectiveTime
... endpoint
n/a

doco Documentation for this format