US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001
US Veterans Health Administration FHIR Map Set Implementation Guide
1.9.0 - 251001
US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.9.0 See the Directory of published versions
| Active as of 2025-09-30 |
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.
| 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 | {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 |
No Mappings Found
No Mappings Found
| Name | Veterans Health Information Systems Technology and Architecture (VistA) | Clinical Data Warehouse (CDW) |
|---|---|---|
  PractitionerRole |
||
  id |
||
 meta |
||
| implicitRules |
||
| language |
||
| text |
||
| contained |
||
  Slices for extension |
||
   extension:practitioner-job-title |
||
  id |
||
| extension |
||
| url |
||
 value[x] |
||
| id |
||
| extension |
||
| coding |
||
 text |
source value based on NEW PERSON - TITLE > TITLE - NAME (200-8 > 3.1-.01) |
SStaff.SStaff.PositionTitle
Staff.Staff.PositionTitle |
 modifierExtension |
||
| identifier |
||
| active |
fixed value = false when NEW PERSON - PERSON CLASS > PERSON CLASS - Expiration Date (200-8932.1 > 200.05-3) if date < now 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 |
StaffSub.ProviderTypeAssignment.ExpirationDateTime |
| period |
||
| id |
||
| extension |
||
| start |
source value based on NEW PERSON - PERSON CLASS > PERSON CLASS - Effective Date (200-8932.1 > 200.05-2) Changed mapping to indicate the effective date field related to the class which aligns to the role |
StaffSub.ProviderTypeAssignment.EffectiveDateTime |
| end |
source value based on NEW PERSON - PERSON CLASS > PERSON CLASS - Expiration Date (200-8932.1 > 200.05-3) 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 |
StaffSub.ProviderTypeAssignment.ExpirationDateTime |
 practitioner |
reference based on NEW PERSON - NAME (200-.01) Use US Core Practitioner Profile. Changed map to better align with US Core |
SStaff.PrescribingProvider.StaffName
SStaff.SStaff.StaffName |
| organization |
reference based on NEW PERSON - DIVISION (200-16) Issue: VistA may have more than one record. Instantiate multiple Role resources. |
|
| code |
||
| id |
||
| extension |
||
| coding |
||
| id |
||
| extension |
||
| system |
fixed value = http://nucc.org/provider-taxonomy mapParameter line 1 |
|
| version |
||
| code |
source value based on NEW PERSON - PERSON CLASS > PERSON CLASS - Person Class > PERSON CLASS - X12 CODE (200-8932.1 > 200.05-.01 > 8932.1-6) NUCC and X12 codes are the same |
|
| display |
source value based on NEW PERSON - PERSON CLASS > PERSON CLASS - Person Class > PERSON CLASS - CLASSIFICATION (200-8932.1 > 200.05-.01 > 8932.1-1) mapParameter line 2 |
|
| userSelected |
||
| text |
||
| specialty |
||
| id |
||
| extension |
||
| coding |
||
| id |
||
| extension |
||
| system |
fixed value = http://nucc.org/provider-taxonomy mapParameter line 1 |
|
| version |
||
| code |
source value based on NEW PERSON - PERSON CLASS > PERSON CLASS - Person Class > PERSON CLASS - X12 CODE (200-8932.1 > 200.05-.01 > 8932.1-6) Added paths |
|
| display |
|
|
| userSelected |
||
| text |
||
| location |
reference based on HOSPITAL LOCATION - (44-) if {2600>44.1-.01>200} This is a reverse pointer. Location 44 contains 44.1, pointing at providers |
|
| healthcareService |
||
 Slices for telecom |
||
  telecom:All Slices |
||
  id |
||
| extension |
||
| system |
||
| value |
||
| use |
||
| rank |
||
 period |
||
| telecom:va-work |
||
| id |
||
| extension |
||
| system |
fixed value = #phone mapParameter line 1 |
|
| value |
source value based on NEW PERSON - OFFICE PHONE (200-.132) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.PrescribingProvider.OfficePhone
SStaff.SStaff.OfficePhone |
| use |
fixed value = #work mapParameter line 2 |
|
| rank |
||
 period |
||
| telecom:va-phone3 |
||
| id |
||
| extension |
||
| system |
fixed value = #phone mapParameter line 1 |
|
| value |
source value based on NEW PERSON - PHONE #3 (200-.133) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.SStaff.Phone3 |
| use |
||
| rank |
||
| period |
||
| telecom:va-phone4 |
||
| id |
||
| extension |
||
| system |
fixed value = #phone mapParameter line 1 |
|
| value |
source value based on NEW PERSON - PHONE #4 (200-.134) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.SStaff.Phone4 |
| use |
||
| rank |
||
| period |
||
| telecom:va-commercial |
||
| id |
||
| extension |
||
| system |
fixed value = #phone mapParameter line 1 |
|
| value |
source value based on NEW PERSON - COMMERCIAL PHONE (200-.135) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.PrescribingProvider.CommercialPhone
SStaff.SStaff.CommercialPhone |
| use |
fixed value = #work mapParameter line 2 |
|
| rank |
||
| period |
||
| telecom:va-fax |
||
| id |
||
| extension |
||
| system |
fixed value = #fax mapParameter line 1 |
|
| value |
source value based on NEW PERSON - FAX NUMBER (200-.136) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.PrescribingProvider.FaxNumber
SStaff.SStaff.FaxNumber |
| use |
fixed value = #work mapParameter line 2 |
|
| rank |
||
| period |
||
| telecom:va-voice-pager |
||
| id |
||
| extension |
||
| system |
fixed value = #pager mapParameter line 1 |
|
| value |
source value based on NEW PERSON - VOICE PAGER (200-.137) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.PrescribingProvider.VoicePager
SStaff.SStaff.VoicePager |
| use |
||
| rank |
||
| period |
||
| telecom:va-data-pager |
||
| id |
||
| extension |
||
| system |
fixed value = #pager mapParameter line 1 |
|
| value |
source value based on NEW PERSON - DIGITAL PAGER (200-.138) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.PrescribingProvider.DigitalPager
SStaff.SStaff.DigitalPager |
| use |
||
| rank |
||
| period |
||
| telecom:va-mail |
||
| id |
||
| extension |
||
| system |
fixed value = #email mapParameter line 1 |
|
| value |
source value based on NEW PERSON - EMAIL ADDRESS (200-.151) Change from Practitioner to PractitionerRole (use case and FHIR Path) to support US Core |
SStaff.PrescribingProvider.EmailAddress
SStaff.SStaff.EmailAddress |
| use |
||
| rank |
||
| period |
||
| availableTime |
||
| id |
||
| extension |
||
| modifierExtension |
||
| daysOfWeek |
||
| allDay |
||
| availableStartTime |
||
| availableEndTime |
||
| notAvailable |
||
| id |
||
| extension |
||
| modifierExtension |
||
| description |
||
| during |
||
| availabilityExceptions |
||
| endpoint |
target not supported See key 1410 |
|
| Documentation for this format | ||