US Veterans Health Administration FHIR Map Set Implementation Guide
1.8.0 - 250901
US Veterans Health Administration FHIR Map Set Implementation Guide - Downloaded Version 1.8.0 See the Directory of published versions
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.
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 |
No Mappings Found
No Mappings Found
Name | HL7 v2 Mapping | RIM Mapping | ServD | FiveWs Pattern Mapping![]() |
---|---|---|---|---|
![]() ![]() |
PRD (as one example) |
Role |
ServiceSiteProvider |
|
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
||||
![]() ![]() ![]() |
Act.text? |
|||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() ![]() |
|
|
||
![]() ![]() ![]() ![]() ![]() ![]() |
C*E.9. But note many systems use C*E.2 for this |
./originalText[mediaType/code="text/plain"]/data |
||
![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() |
PRD-7 (or XCN.1) |
.id |
./Identifiers |
FiveWs.identifier |
![]() ![]() ![]() |
STF-7 |
.statusCode |
FiveWs.status | |
![]() ![]() ![]() |
PRD-8/9 / PRA-5.4 |
.performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime |
|
FiveWs.done[x] |
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
DR.1 |
./low |
||
![]() ![]() ![]() ![]() |
DR.2 |
./high |
||
![]() ![]() ![]() |
.player |
|||
![]() ![]() ![]() |
.scoper |
|||
![]() ![]() ![]() |
PRD-1 / STF-18 / PRA-3 / PRT-4 / ROL-3 / ORC-12 / OBR-16 / PV1-7 / PV1-8 / PV1-9 / PV1-17 |
.code |
|
|
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
|
|
||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
C*E.3 |
./codeSystem |
||
![]() ![]() ![]() ![]() ![]() |
C*E.7 |
./codeSystemVersion |
||
![]() ![]() ![]() ![]() ![]() |
C*E.1 |
./code |
||
![]() ![]() ![]() ![]() ![]() |
C*E.2 - but note this is not well followed |
CV.displayName |
||
![]() ![]() ![]() ![]() ![]() |
Sometimes implied by being first |
CD.codingRationale |
||
![]() ![]() ![]() ![]() |
C*E.9. But note many systems use C*E.2 for this |
./originalText[mediaType/code="text/plain"]/data |
||
![]() ![]() ![]() |
PRA-5 |
.player.HealthCareProvider[@classCode = 'PROV'].code |
./Specialty |
|
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
|
|
||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
C*E.3 |
./codeSystem |
||
![]() ![]() ![]() ![]() ![]() |
C*E.7 |
./codeSystemVersion |
||
![]() ![]() ![]() ![]() ![]() |
C*E.1 |
./code |
||
![]() ![]() ![]() ![]() ![]() |
C*E.2 - but note this is not well followed |
CV.displayName |
||
![]() ![]() ![]() ![]() ![]() |
Sometimes implied by being first |
CD.codingRationale |
||
![]() ![]() ![]() ![]() |
C*E.9. But note many systems use C*E.2 for this |
./originalText[mediaType/code="text/plain"]/data |
||
![]() ![]() ![]() |
.performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC'] |
|
FiveWs.where[x] | |
![]() ![]() ![]() |
EDU-2 / AFF-3 |
.player.QualifiedEntity[@classCode = 'QUAL'].code |
||
![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() |
||||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() ![]() |
.telecom |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() ![]() |
XTN.3 |
./scheme |
./ContactPointType |
|
![]() ![]() ![]() ![]() ![]() |
XTN.1 (or XTN.12) |
./url |
./Value |
|
![]() ![]() ![]() ![]() ![]() |
XTN.2 - but often indicated by field |
unique(./use) |
./ContactPointPurpose |
|
![]() ![]() ![]() ![]() ![]() |
n/a |
n/a |
||
![]() ![]() ![]() ![]() ![]() |
N/A |
./usablePeriod[type="IVL<TS>"] |
./StartDate and ./EndDate |
|
![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
N/A |
|||
![]() ![]() ![]() ![]() |
n/a |
|||
![]() ![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() |
.effectiveTime |
|||
![]() ![]() ![]() |
n/a |
|||
![]() |