MyHealtheVet PHR FHIR API, published by VA Digital Services. This guide is not an authorized publication; it is the continuous build for version 0.3.9-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/department-of-veterans-affairs/mhv-fhir-phr-mapping/ and changes regularly. See the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• XML
• JSON

Resource Profile: MHVpractitioner - Mappings

Page standards status: Trial-use

Maturity Level: 3

Mappings for the VA.MHV.PHR.practitioner resource profile.

Mappings for VIA to mhv-fhir-phr (UserTO)

MHVpractitioner
Practitioner	UserTO
identifier
use	`usual`
system	ID system must start with urn:oid:2.16.840.1.113883.4.349.4. The next would be the {stationNbr}
value	`UserTO` + {UserTO.id}
name
text	UserTO.name
telecom	UserTO.phone, UserTO.pager, UserTO.digitalPager, UserTO.emailAddress
communication	UserTO.greeting

Mappings for VIA to mhv-fhir-phr (AuthorTO)

MHVpractitioner
Practitioner	AuthorTO
identifier
use	`usual`
system	ID system must start with urn:oid:2.16.840.1.113883.4.349.4. The next would be the {stationNbr}
value	`AuthorTO.` + {AuthorTO.id}
name
text	AuthorTO.name

Mappings for HDR to mhv-fhir-phr (PractitionerLite)

MHVpractitioner
Practitioner	PractitionerLite
identifier
use	`secondary`
system	identifier.assigingFacility, `http://va.gov/systems/` + idSourceTable
value	identifier.identity
name	name
family	name.family
given	name.given, name.middle
prefix	name.prefix
suffix	name.suffix, name.title

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

MHVpractitioner
Practitioner	PRD (as one example)
identifier	PRD-7 (or XCN.1)
use	N/A
type	CX.5
system	CX.4 / EI-2-4
value	CX.1 / EI.1
period	CX.7 + CX.8
assigner	CX.4 / (CX.4,CX.9,CX.10)
identifier (TOid)	PRD-7 (or XCN.1)
use	N/A
type	CX.5
system	CX.4 / EI-2-4
value	CX.1 / EI.1
period	CX.7 + CX.8
assigner	CX.4 / (CX.4,CX.9,CX.10)
identifier (HDRid)	PRD-7 (or XCN.1)
use	N/A
type	CX.5
system	CX.4 / EI-2-4
value	CX.1 / EI.1
period	CX.7 + CX.8
assigner	CX.4 / (CX.4,CX.9,CX.10)
name	XCN Components
use	XPN.7, but often indicated by which field contains the name
text	implied by XPN.11
family	XPN.1/FN.1
given	XPN.2 + XPN.3
prefix	XPN.5
suffix	XPN/4
period	XPN.13 + XPN.14
telecom	PRT-15, STF-10, ROL-12
address	ORC-24, STF-11, ROL-11, PRT-14
gender	STF-5
birthDate	STF-6
qualification	CER?
communication	PID-15, NK1-20, LAN-2

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

MHVpractitioner
Practitioner	Entity. Role, or Act, Role
text	Act.text?
contained	N/A
extension	N/A
modifierExtension	N/A
identifier	./id
id	n/a
extension	n/a
use	Role.code or implied by context
type	Role.code or implied by context
system	II.root or Role.id.root
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
period	Role.effectiveTime or implied by context
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
identifier (TOid)	./id
id	n/a
extension	n/a
use	Role.code or implied by context
type	Role.code or implied by context
system	II.root or Role.id.root
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
period	Role.effectiveTime or implied by context
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
identifier (HDRid)	./id
id	n/a
extension	n/a
use	Role.code or implied by context
type	Role.code or implied by context
system	II.root or Role.id.root
value	II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
period	Role.effectiveTime or implied by context
assigner	II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
active	./statusCode
name	./name
id	n/a
extension	n/a
use	unique(./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
address	./addr
gender	./administrativeGender
birthDate	./birthTime
photo	./subjectOf/ObservationEvent[code="photo"]/value
qualification	.playingEntity.playingRole[classCode=QUAL].code
id	n/a
extension	n/a
modifierExtension	N/A
identifier	.playingEntity.playingRole[classCode=QUAL].id
code	.playingEntity.playingRole[classCode=QUAL].code
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/)

MHVpractitioner
Practitioner	Provider
identifier	./Identifiers
system	./IdentifierType
value	./Value
period	./StartDate and ./EndDate
assigner	./IdentifierIssuingAuthority
identifier (TOid)	./Identifiers
system	./IdentifierType
value	./Value
period	./StartDate and ./EndDate
assigner	./IdentifierIssuingAuthority
identifier (HDRid)	./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
address	./Addresses
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)

MHVpractitioner
Practitioner
identifier	FiveWs.identifier
identifier (TOid)	FiveWs.identifier
identifier (HDRid)	FiveWs.identifier
active	FiveWs.status