US Quality Core Implementation Guide
0.1.0 - cibuild

US Quality Core Implementation Guide, published by ASTP. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/FHIR/us-quality-core/ and changes regularly. See the Directory of published versions

## Resource Profile: US Quality Core PractitionerRole

Official URL: http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-practitionerrole | Version: 0.1.0
Active as of 2026-03-31 | Computable Name: USQualityCorePractitionerRole

Profile of PractitionerRole for decision support/quality metrics. Defines the core set of elements and extensions for quality rule and measure authors.

Usage

See the patterns page for implementation and usage patterns.

### Examples

PractitionerRole Example

USCDI+ Quality Elements:

- identifier: (USCDI+ Quality) Business Identifiers that are specific to a role/location
- identifier.system: (USCDI+ Quality) The namespace for the identifier value
- identifier.value: (USCDI+ Quality) The value that is unique
- practitioner: (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
- code: (USCDI+ Quality) Roles which this practitioner may perform
- specialty: (USCDI+ Quality) Specific specialty of the practitioner
- location: (USCDI+ Quality) The location(s) at which this practitioner provides care
- telecom: (USCDI+ Quality) Contact details that are specific to the role/location/service
- telecom.system: (USCDI+ Quality) phone \| fax \| email \| pager \| url \| sms \| other
- telecom.value: (USCDI+ Quality) The actual contact point details

Usages:

- Refer to this Profile: US Quality Core AdverseEvent, US Quality Core CareTeam, US Quality Core Claim, US Quality Core ClaimResponse... Show 11 more, US Quality Core DiagnosticReport Profile for Laboratory Results Reporting, US Quality Core Encounter, US Quality Core ImagingStudy, US Quality Core Medication Not Requested, US Quality Core MedicationRequest, US Quality Core NonPatient Observation, US Quality Core Observation Screening Assessment, US Quality Core QuestionnaireResponse, US Quality Core Service Not Requested, US Quality Core ServiceRequest and US Quality Core Simple Observation
- Examples for this Profile: PractitionerRole/example
- CapabilityStatements using this Profile: US Quality Core Client CapabilityStatement and US Quality Core Server CapabilityStatement

You can also check for usages in the FHIR IG Statistics

### Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
PractitionerRole | C | 0..* | USCorePractitionerRoleProfile | Roles/organizations the practitioner is associated with Constraints: pd-1, us-core-13
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | (USCDI+ Quality) Business Identifiers that are specific to a role/location
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system | Σ | 1..1 | uri | (USCDI+ Quality) The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | (USCDI+ Quality) The value that is unique Example General: 123456
active | Σ | 1..1 | boolean | Whether this practitioner role record is in active use
period | Σ | 1..1 | Period | The period during which the practitioner is authorized to perform in these role(s)
practitioner | S Σ C | 0..1 | Reference(US Quality Core Practitioner) | (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
organization | S Σ C | 0..1 | Reference(US Quality Core Organization) | Organization where the roles are available
code | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Roles which this practitioner may perform Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc.
specialty | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Specific specialty of the practitioner Binding: Healthcare Provider Taxonomy (extensible)
location | S Σ C | 0..* | Reference(US Quality Core Location) | (USCDI+ Quality) The location(s) at which this practitioner provides care
healthcareService | C | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s)
telecom | S Σ C | 0..* | ContactPoint | (USCDI+ Quality) Contact details that are specific to the role/location/service
system | S Σ C | 1..1 | code | (USCDI+ Quality) phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value | S Σ | 1..1 | string | (USCDI+ Quality) The actual contact point details
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
endpoint | S C | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the practitioner with this role
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
PractitionerRole.identifier.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
PractitionerRole.code | Base | extensible | Care Team Member Function | 📦20190418 | VSAC v0.11
PractitionerRole.specialty | Base | extensible | Healthcare Provider Taxonomy | 📦20190521 | VSAC v0.11
PractitionerRole.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
PractitionerRole.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | PractitionerRole | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | PractitionerRole | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | PractitionerRole | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
pd-1 | error | PractitionerRole | SHALL have contact information or a reference to an Endpoint | `telecom or endpoint`
us-core-13 | error | PractitionerRole | SHALL have a practitioner, an organization, a healthcare service, or a location. | `practitioner or organization or healthcareService or location`

This structure is derived from USCorePractitionerRoleProfile

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
PractitionerRole |  | 0..* | USCorePractitionerRoleProfile | Roles/organizations the practitioner is associated with
identifier |  | 1..* | Identifier | (USCDI+ Quality) Business Identifiers that are specific to a role/location
use |  | 1..1 | code | usual | official | temp | secondary | old (If known)
system |  | 1..1 | uri | (USCDI+ Quality) The namespace for the identifier value
value |  | 1..1 | string | (USCDI+ Quality) The value that is unique
active |  | 1..1 | boolean | Whether this practitioner role record is in active use
period |  | 1..1 | Period | The period during which the practitioner is authorized to perform in these role(s)
practitioner |  | 0..1 | Reference(US Quality Core Practitioner) | (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
organization |  | 0..1 | Reference(US Quality Core Organization) | Organization where the roles are available
code |  | 0..* | CodeableConcept | (USCDI+ Quality) Roles which this practitioner may perform Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc.
specialty |  | 0..* | CodeableConcept | (USCDI+ Quality) Specific specialty of the practitioner Binding: Healthcare Provider Taxonomy (extensible)
location |  | 0..* | Reference(US Quality Core Location) | (USCDI+ Quality) The location(s) at which this practitioner provides care
healthcareService | C | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s)
telecom | C | 0..* | ContactPoint | (USCDI+ Quality) Contact details that are specific to the role/location/service
system |  | 1..1 | code | (USCDI+ Quality) phone | fax | email | pager | url | sms | other
value |  | 1..1 | string | (USCDI+ Quality) The actual contact point details
endpoint | C | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the practitioner with this role
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
PractitionerRole.code | Base | extensible | Care Team Member Function | 📦20190418 | VSAC v0.11
PractitionerRole.specialty | Base | extensible | Healthcare Provider Taxonomy | 📦20190521 | VSAC v0.11

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
PractitionerRole | C | 0..* | USCorePractitionerRoleProfile | Roles/organizations the practitioner is associated with Constraints: pd-1, us-core-13
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | (USCDI+ Quality) Business Identifiers that are specific to a role/location
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
system | Σ | 1..1 | uri | (USCDI+ Quality) The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | (USCDI+ Quality) The value that is unique Example General: 123456
period | Σ | 0..1 | Period | Time period when id is/was valid for use
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | Σ | 1..1 | boolean | Whether this practitioner role record is in active use
period | Σ | 1..1 | Period | The period during which the practitioner is authorized to perform in these role(s)
practitioner | S Σ C | 0..1 | Reference(US Quality Core Practitioner) | (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
organization | S Σ C | 0..1 | Reference(US Quality Core Organization) | Organization where the roles are available
code | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Roles which this practitioner may perform Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc.
specialty | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Specific specialty of the practitioner Binding: Healthcare Provider Taxonomy (extensible)
location | S Σ C | 0..* | Reference(US Quality Core Location) | (USCDI+ Quality) The location(s) at which this practitioner provides care
healthcareService | C | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s)
telecom | S Σ C | 0..* | ContactPoint | (USCDI+ Quality) Contact details that are specific to the role/location/service
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | S Σ C | 1..1 | code | (USCDI+ Quality) phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value | S Σ | 1..1 | string | (USCDI+ Quality) The actual contact point details
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
rank | Σ | 0..1 | positiveInt | Specify preferred order of use (1 = highest)
period | Σ | 0..1 | Period | Time period when the contact point was/is in use
availableTime |  | 0..* | BackboneElement | Times the Service Site is available
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
daysOfWeek |  | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): The days of the week.
allDay |  | 0..1 | boolean | Always available? e.g. 24 hour service
availableStartTime |  | 0..1 | time | Opening time of day (ignored if allDay = true)
availableEndTime |  | 0..1 | time | Closing time of day (ignored if allDay = true)
notAvailable |  | 0..* | BackboneElement | Not available during this time due to provided reason
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
description |  | 1..1 | string | Reason presented to the user explaining why time not available
during |  | 0..1 | Period | Service not available from this date
availabilityExceptions |  | 0..1 | string | Description of availability exceptions
endpoint | S C | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the practitioner with this role
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
PractitionerRole.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
PractitionerRole.identifier.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
PractitionerRole.identifier.​type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std.
PractitionerRole.code | Base | extensible | Care Team Member Function | 📦20190418 | VSAC v0.11
PractitionerRole.specialty | Base | extensible | Healthcare Provider Taxonomy | 📦20190521 | VSAC v0.11
PractitionerRole.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
PractitionerRole.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
PractitionerRole.availableTime.​daysOfWeek | Base | required | DaysOfWeek | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | PractitionerRole | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | PractitionerRole | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | PractitionerRole | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
pd-1 | error | PractitionerRole | SHALL have contact information or a reference to an Endpoint | `telecom or endpoint`
us-core-13 | error | PractitionerRole | SHALL have a practitioner, an organization, a healthcare service, or a location. | `practitioner or organization or healthcareService or location`

This structure is derived from USCorePractitionerRoleProfile

Summary

Mandatory: 6 elements(2 nested mandatory elements)

Structures

This structure refers to these other structures:

- US Quality Core Practitioner (http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-practitioner)
- US Quality Core Organization (http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-organization)
- US Quality Core Location (http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-location)

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
PractitionerRole | C | 0..* | USCorePractitionerRoleProfile | Roles/organizations the practitioner is associated with Constraints: pd-1, us-core-13
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | (USCDI+ Quality) Business Identifiers that are specific to a role/location
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
system | Σ | 1..1 | uri | (USCDI+ Quality) The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | (USCDI+ Quality) The value that is unique Example General: 123456
active | Σ | 1..1 | boolean | Whether this practitioner role record is in active use
period | Σ | 1..1 | Period | The period during which the practitioner is authorized to perform in these role(s)
practitioner | S Σ C | 0..1 | Reference(US Quality Core Practitioner) | (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
organization | S Σ C | 0..1 | Reference(US Quality Core Organization) | Organization where the roles are available
code | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Roles which this practitioner may perform Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc.
specialty | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Specific specialty of the practitioner Binding: Healthcare Provider Taxonomy (extensible)
location | S Σ C | 0..* | Reference(US Quality Core Location) | (USCDI+ Quality) The location(s) at which this practitioner provides care
healthcareService | C | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s)
telecom | S Σ C | 0..* | ContactPoint | (USCDI+ Quality) Contact details that are specific to the role/location/service
system | S Σ C | 1..1 | code | (USCDI+ Quality) phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value | S Σ | 1..1 | string | (USCDI+ Quality) The actual contact point details
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
endpoint | S C | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the practitioner with this role
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
PractitionerRole.identifier.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
PractitionerRole.code | Base | extensible | Care Team Member Function | 📦20190418 | VSAC v0.11
PractitionerRole.specialty | Base | extensible | Healthcare Provider Taxonomy | 📦20190521 | VSAC v0.11
PractitionerRole.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
PractitionerRole.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | PractitionerRole | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | PractitionerRole | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | PractitionerRole | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
pd-1 | error | PractitionerRole | SHALL have contact information or a reference to an Endpoint | `telecom or endpoint`
us-core-13 | error | PractitionerRole | SHALL have a practitioner, an organization, a healthcare service, or a location. | `practitioner or organization or healthcareService or location`

Differential View

This structure is derived from USCorePractitionerRoleProfile

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
PractitionerRole |  | 0..* | USCorePractitionerRoleProfile | Roles/organizations the practitioner is associated with
identifier |  | 1..* | Identifier | (USCDI+ Quality) Business Identifiers that are specific to a role/location
use |  | 1..1 | code | usual | official | temp | secondary | old (If known)
system |  | 1..1 | uri | (USCDI+ Quality) The namespace for the identifier value
value |  | 1..1 | string | (USCDI+ Quality) The value that is unique
active |  | 1..1 | boolean | Whether this practitioner role record is in active use
period |  | 1..1 | Period | The period during which the practitioner is authorized to perform in these role(s)
practitioner |  | 0..1 | Reference(US Quality Core Practitioner) | (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
organization |  | 0..1 | Reference(US Quality Core Organization) | Organization where the roles are available
code |  | 0..* | CodeableConcept | (USCDI+ Quality) Roles which this practitioner may perform Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc.
specialty |  | 0..* | CodeableConcept | (USCDI+ Quality) Specific specialty of the practitioner Binding: Healthcare Provider Taxonomy (extensible)
location |  | 0..* | Reference(US Quality Core Location) | (USCDI+ Quality) The location(s) at which this practitioner provides care
healthcareService | C | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s)
telecom | C | 0..* | ContactPoint | (USCDI+ Quality) Contact details that are specific to the role/location/service
system |  | 1..1 | code | (USCDI+ Quality) phone | fax | email | pager | url | sms | other
value |  | 1..1 | string | (USCDI+ Quality) The actual contact point details
endpoint | C | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the practitioner with this role
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
PractitionerRole.code | Base | extensible | Care Team Member Function | 📦20190418 | VSAC v0.11
PractitionerRole.specialty | Base | extensible | Healthcare Provider Taxonomy | 📦20190521 | VSAC v0.11

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
PractitionerRole | C | 0..* | USCorePractitionerRoleProfile | Roles/organizations the practitioner is associated with Constraints: pd-1, us-core-13
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
implicitRules | ?!Σ | 0..1 | uri | A set of rules under which this content was created
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
text |  | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
contained |  | 0..* | Resource | Contained, inline Resources
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
identifier | Σ | 1..* | Identifier | (USCDI+ Quality) Business Identifiers that are specific to a role/location
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
use | ?!Σ | 1..1 | code | usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
type | Σ | 0..1 | CodeableConcept | Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
system | Σ | 1..1 | uri | (USCDI+ Quality) The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
value | Σ | 1..1 | string | (USCDI+ Quality) The value that is unique Example General: 123456
period | Σ | 0..1 | Period | Time period when id is/was valid for use
assigner | Σ | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | Σ | 1..1 | boolean | Whether this practitioner role record is in active use
period | Σ | 1..1 | Period | The period during which the practitioner is authorized to perform in these role(s)
practitioner | S Σ C | 0..1 | Reference(US Quality Core Practitioner) | (USCDI+ Quality) Practitioner that is able to provide the defined services for the organization
organization | S Σ C | 0..1 | Reference(US Quality Core Organization) | Organization where the roles are available
code | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Roles which this practitioner may perform Binding: Care Team Member Function (extensible): Indicates specific responsibility of an individual within the care team, such as Primary physician, Team coordinator, Caregiver, etc.
specialty | S Σ | 0..* | CodeableConcept | (USCDI+ Quality) Specific specialty of the practitioner Binding: Healthcare Provider Taxonomy (extensible)
location | S Σ C | 0..* | Reference(US Quality Core Location) | (USCDI+ Quality) The location(s) at which this practitioner provides care
healthcareService | C | 0..* | Reference(HealthcareService) | The list of healthcare services that this worker provides for this role's Organization/Location(s)
telecom | S Σ C | 0..* | ContactPoint | (USCDI+ Quality) Contact details that are specific to the role/location/service
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | S Σ C | 1..1 | code | (USCDI+ Quality) phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): Telecommunications form for contact point.
value | S Σ | 1..1 | string | (USCDI+ Quality) The actual contact point details
use | ?!Σ | 0..1 | code | home | work | temp | old | mobile - purpose of this contact point Binding: ContactPointUse (required): Use of contact point.
rank | Σ | 0..1 | positiveInt | Specify preferred order of use (1 = highest)
period | Σ | 0..1 | Period | Time period when the contact point was/is in use
availableTime |  | 0..* | BackboneElement | Times the Service Site is available
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
daysOfWeek |  | 0..* | code | mon | tue | wed | thu | fri | sat | sun Binding: DaysOfWeek (required): The days of the week.
allDay |  | 0..1 | boolean | Always available? e.g. 24 hour service
availableStartTime |  | 0..1 | time | Opening time of day (ignored if allDay = true)
availableEndTime |  | 0..1 | time | Closing time of day (ignored if allDay = true)
notAvailable |  | 0..* | BackboneElement | Not available during this time due to provided reason
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
description |  | 1..1 | string | Reason presented to the user explaining why time not available
during |  | 0..1 | Period | Service not available from this date
availabilityExceptions |  | 0..1 | string | Description of availability exceptions
endpoint | S C | 0..* | Reference(Endpoint) | Technical endpoints providing access to services operated for the practitioner with this role
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
PractitionerRole.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
PractitionerRole.identifier.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
PractitionerRole.identifier.​type | Base | extensible | IdentifierType | 📍4.0.1 | FHIR Std.
PractitionerRole.code | Base | extensible | Care Team Member Function | 📦20190418 | VSAC v0.11
PractitionerRole.specialty | Base | extensible | Healthcare Provider Taxonomy | 📦20190521 | VSAC v0.11
PractitionerRole.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
PractitionerRole.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
PractitionerRole.availableTime.​daysOfWeek | Base | required | DaysOfWeek | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | PractitionerRole | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | PractitionerRole | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource | `contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()`
dom-4 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated | `contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()`
dom-5 | error | PractitionerRole | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | PractitionerRole | A resource should have narrative for robust management | `text.`div`.exists()`
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`
pd-1 | error | PractitionerRole | SHALL have contact information or a reference to an Endpoint | `telecom or endpoint`
us-core-13 | error | PractitionerRole | SHALL have a practitioner, an organization, a healthcare service, or a location. | `practitioner or organization or healthcareService or location`

This structure is derived from USCorePractitionerRoleProfile

Summary

Mandatory: 6 elements(2 nested mandatory elements)

Structures

This structure refers to these other structures:

- US Quality Core Practitioner (http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-practitioner)
- US Quality Core Organization (http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-organization)
- US Quality Core Location (http://fhir.org/guides/astp/us-quality-core/StructureDefinition/us-quality-core-location)

Other representations of profile: CSV, Excel, Schematron