Finnish Implementation Guide for SMART App Launch
2.0.0-rc3 - qa-preview

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

## Resource Profile: FiSMARTPractitioner - Mappings

Draft as of 2025-06-01

Mappings for the fi-smart-practitioner resource profile.

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

FiSMARTPractitioner
Practitioner | PRD (as one example)
identifier | PRD-7 (or XCN.1)
identifier (PIC) | 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 (Terhikki) | 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 (SV) | 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
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)

FiSMARTPractitioner
Practitioner | Entity. Role, or Act, Role
text | Act.text?
contained | N/A
extension | N/A
modifierExtension | N/A
identifier | ./id
identifier (PIC) | ./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 (Terhikki) | ./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 (SV) | ./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
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/)

FiSMARTPractitioner
Practitioner | Provider
identifier | ./Identifiers
identifier (PIC) | ./Identifiers
system | ./IdentifierType
value | ./Value
period | ./StartDate and ./EndDate
assigner | ./IdentifierIssuingAuthority
identifier (Terhikki) | ./Identifiers
system | ./IdentifierType
value | ./Value
period | ./StartDate and ./EndDate
assigner | ./IdentifierIssuingAuthority
identifier (SV) | ./Identifiers
system | ./IdentifierType
value | ./Value
period | ./StartDate and ./EndDate
assigner | ./IdentifierIssuingAuthority
name | ./PreferredName (GivenNames, FamilyName, TitleCode)
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)

FiSMARTPractitioner
Practitioner |
identifier | FiveWs.identifier
identifier (PIC) | FiveWs.identifier
identifier (Terhikki) | FiveWs.identifier
identifier (SV) | FiveWs.identifier
active | FiveWs.status