PractitionerRole Profile¶

Canonical	`../StructureDefinition/nexus-emr-core-practitionerrole`
Status	draft · 1.26.0
Base	PractitionerRole (constraint)
Source	FSH · JSON

Represents a practitioner's role at an organization/location -- the tenant-scoped access/role binding (the "actor"). Links a Practitioner to an Organization and Location(s) and carries the clinical role code(s). A practitioner may have one or more PractitionerRoles, including more than one active at the same organization. This is NOT the EMR user: the user's stable identity is the Practitioner (which carries the user-account identifier). Use PractitionerRole to differentiate providers by role (e.g. list only doctors, route a task to a nurse), not to represent the login.

Overview

Represents a practitioner's role at an organization/location -- the tenant-scoped access/role binding (the "actor"). A practitioner may have one or more PractitionerRoles, including more than one active at the same organization. This is not the EMR user: the user's stable identity is NexusEmrCorePractitioner, which carries the user-account identifier. Use PractitionerRole to differentiate providers by role (list only doctors, route a task to a nurse), not to represent the login.

Key Requirements

At least one identifier must use Nexus EMR naming pattern
Required reference to the practitioner (Must Support)
Organization where role is performed (Must Support)
Locations where practitioner works in this role
Human-readable text summary recommended

Identifiers

identifier is 0..* and no canonical system is mandated. Carry the identifier the source system assigns, under a system URI that genuinely identifies it.

Role / assignment IDs: identifiers here identify the role/assignment record, not the EMR user account (that id lives on the Practitioner).

Clinical roles

code binds (extensible) to the Nexus clinical-roles ValueSet -- the "Clinical Roles" dropdown (doctor, nurse, MOA, echo-tech, ...). This is a binding on PractitionerRole.code, not a separate resource, and is distinct from access permissions (managed in the auth layer). Access permissions do NOT live on PractitionerRole.

Invariants

None on this profile. practitionerrole-has-raw-identifier (warning) was removed in 1.21.0 with its 33 siblings. Its recommendation stands unchecked: SHOULD carry at least one source/raw identifier that is not the Nexus EMR canonical one.

Examples

Basic practitioner role

Implementation Notes

Primary Use Case: a practitioner's role/assignment binding at an organization (the actor); the role codes used for provider filtering and workflow routing
Not the EMR user account: the user's identity is the Practitioner (use NexusEmrCorePractitioner)
Practitioner Reference: Must always reference a valid NexusEmrCorePractitioner
Organization Reference: Should reference a valid NexusEmrCoreOrganization when known

Terminology bindings

Path	Strength	Value set
`PractitionerRole.code`	extensible	Clinical Roles