Uzbekistan Core PractitionerRole profile, used to define roles of practitioners

UZ Core PractitionerRole is the join that places a Practitioner inside an Organization - and optionally at a Location or offering a HealthcareService - with a stated role and specialty. This is the context that clinical resources point to as the performer or requester: it answers "in what capacity, and on whose behalf, did this professional act". Roles and specialties are coded from the Tibtoifa-derived national value sets.

When a clinical resource records who acted, point it at the PractitionerRole, not the bare Practitioner: the same practitioner may hold several roles, and only the role captures the capacity - and the organization - they acted on behalf of.

Mandatory and Must Support data elements

The elements below must always be present (mandatory) or must be supported when the data is available (Must Support) - not all are required, but your system must populate each Must Support element when it has the data and process it on receipt. This is the human-readable summary; the formal views below give the exact cardinalities, types, and terminology bindings.

Each UZ Core PractitionerRole Must Have

The base FHIR PractitionerRole has no mandatory elements, and this profile does not add any. In practice you will populate the practitioner and organization references together (see Must Support below).

Each UZ Core PractitionerRole Must Support

• an identifier for the role;
• the active flag;
• the practitioner reference (who is acting);
• the organization reference (the employer or hosting organization);
• a role code (code) - the position/profession, from the national role value set;
• a specialty - the clinical specialization, from the national profession-specialization value set;
• a location reference (where the role is exercised);
• a healthcareService reference (the service the role delivers).

Role and specialty are sliced to the DHP national code systems, but free text (code.text) is allowed where a coded value is not available.

Building the JSON, step by step

The examples below go from the smallest instance the server will accept to a fully coded role. Copy one and adapt it - every value shown validates against this profile. The complete reference instances are linked at the bottom of the page (coded role, free-text role).

The smallest PractitionerRole you should send

The base resource has no mandatory elements and this profile adds none, but a PractitionerRole is only useful once it actually joins someone to somewhere. In practice the minimum you send is the practitioner (who is acting) and the organization (on whose behalf), both plain references, plus the active flag. Every UZ Core resource must also name the profile it claims to conform to in meta.profile:

{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role"]
  },
  "active": true,
  "practitioner": { "reference": "Practitioner/example-practitioner" },
  "organization": { "reference": "Organization/example-organization" }
}

practitioner and organization are plain Reference values - the target sits directly under reference as Type/id. They point at a Practitioner and an Organization respectively.

A realistic, coded role

In practice you state the capacity: the code (the position/profession) and the specialty (the clinical specialization), and where the role is delivered through healthcareService. Both code and specialty are lists of CodeableConcept (not CodeableReference), and each is sliced to a national DHP code system - so the system URI must match exactly. healthcareService is a list of plain references:

{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role" ]
  },
  "active": true,
  "practitioner": { "reference": "Practitioner/example-practitioner" },
  "organization": { "reference": "Organization/example-organization" },
  "code": [
    {
      "coding": [
        {
          "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs",
          "code": "2212.14",
          "display": "Vrach ginekolog"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs",
          "code": "394585009",
          "display": "Akusherlik va ginekologiya"
        }
      ]
    }
  ],
  "healthcareService": [ { "reference": "HealthcareService/example-healthcareservice" } ]
}

The role code is drawn from the national position-and-profession-cs system and the specialty from profession-specialization-cs. These are the two sliced systems on this profile; using any other system simply leaves the slice unmatched. See Terminology for how the DHP code systems are sourced.

Recording where the role is exercised

The role can also point at the Location where it is carried out. location (like healthcareService) is a list of plain references; both slot into the same resource as the coded role above:

{
  "healthcareService": [
    { "reference": "HealthcareService/example-healthcareservice" }
  ],
  "location": [
    { "reference": "Location/example-location" }
  ]
}

When there is no coded role

If the position is not yet in the national value set, do not invent a code - use the free-text code.text instead of a coding. The role still joins a practitioner to an organization, it just describes the capacity in words (full instance: free-text role):

{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role"]
  },
  "active": true,
  "practitioner": { "reference": "Practitioner/example-practitioner" },
  "organization": { "reference": "Organization/example-organization" },
  "code": [
    { "text": "Surgeon at Republican Specialized Scientific Center of Surgery, inpatient care" }
  ],
  "healthcareService": [
    { "reference": "HealthcareService/example-healthcareservice" }
  ]
}

code.text carries the human-readable role; you can supply text alongside a coding, or on its own when no national code applies. See Missing & suppressed data for when to reach for free text over a code.

For example API calls and a sample payload, see the Quick Start at the bottom of this page.

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

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
PractitionerRole		0..*	PractitionerRole(5.0.0)	Roles/organizations the practitioner is associated with
PractitionerRole.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
PractitionerRole.contained		0..*	Resource	Contained, inline Resources
PractitionerRole.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
PractitionerRole.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Identifiers for a role/location
PractitionerRole.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUseVS (0.11.1) (required)
PractitionerRole.identifier.type	Σ This element is included in summaries.	0..1	CodeableConcept	Description of identifier Binding: IdentifierTypeVS (0.11.1) (required)
PractitionerRole.active	S This element must be supported. Σ This element is included in summaries.	0..1	boolean	Whether this practitioner role record is in active use
PractitionerRole.practitioner	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Practitioner)	Practitioner that provides services for the organization
PractitionerRole.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Organization)	Organization where the roles are available
PractitionerRole.code	S This element must be supported. Σ This element is included in summaries.	1..1	CodeableConcept	Roles which this practitioner may perform Binding: PractitionerRole (example): The role a person plays representing an organization.
PractitionerRole.code.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.code.Slices for coding.coding:role	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.code.Slices for coding.coding:role.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs (extensions allowed)
PractitionerRole.code.Slices for coding.coding:role.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: PositionAndProfessionVS (0.11.1) (required)
PractitionerRole.specialty	S This element must be supported. Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the practitioner Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
PractitionerRole.specialty.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs (extensions allowed)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: ProfessionSpecializationVS (0.11.1) (required)
PractitionerRole.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(Location)	Location(s) where the practitioner provides care
PractitionerRole.healthcareService	S This element must be supported.	0..*	Reference(HealthcareService)	Healthcare services provided for this role's Organization/Location(s)
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
PractitionerRole.identifier.​use	Base	required	Types of possible identifier uses	📍0.11.1	This IG
PractitionerRole.identifier.​type	Base	required	Types of possible identifiers	📍0.11.1	This IG
PractitionerRole.code	Base	example	Practitioner Role	📍5.0.0	FHIR Std.
PractitionerRole.code.​coding:role.code	Base	required	Defines the possible positions and professions	📍0.11.1	This IG
PractitionerRole.specialty	Base	preferred	Practice Setting Code Value Set	📍5.0.0	FHIR Std.
PractitionerRole.specialty.​coding:dhpSpecialty.​code	Base	required	Profession specializations	📍0.11.1	This IG

Constraints

Id

Grade

Path(s)

Description

Expression

This structure is derived from PractitionerRole

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
PractitionerRole		0..*	PractitionerRole(5.0.0)	Roles/organizations the practitioner is associated with
PractitionerRole.identifier	S This element must be supported.	0..*	Identifier	Identifiers for a role/location
PractitionerRole.identifier.use		0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUseVS (0.11.1) (required)
PractitionerRole.identifier.type		0..1	CodeableConcept	Description of identifier Binding: IdentifierTypeVS (0.11.1) (required)
PractitionerRole.active	S This element must be supported.	0..1	boolean	Whether this practitioner role record is in active use
PractitionerRole.practitioner	S This element must be supported.	0..1	Reference(Practitioner)	Practitioner that provides services for the organization
PractitionerRole.organization	S This element must be supported.	0..1	Reference(Organization)	Organization where the roles are available
PractitionerRole.code	S This element must be supported.	1..1	CodeableConcept	Roles which this practitioner may perform
PractitionerRole.code.Slices for coding		0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.code.Slices for coding.coding:role	S This element must be supported.	0..1	Coding	Code defined by a terminology system
PractitionerRole.code.Slices for coding.coding:role.system	S This element must be supported.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs (extensions allowed)
PractitionerRole.code.Slices for coding.coding:role.code	S This element must be supported.	1..1	code	Symbol in syntax defined by the system Binding: PositionAndProfessionVS (0.11.1) (required)
PractitionerRole.specialty	S This element must be supported.	0..*	CodeableConcept	Specific specialty of the practitioner
PractitionerRole.specialty.Slices for coding		0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty	S This element must be supported.	0..1	Coding	Code defined by a terminology system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.system	S This element must be supported.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs (extensions allowed)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.code	S This element must be supported.	1..1	code	Symbol in syntax defined by the system Binding: ProfessionSpecializationVS (0.11.1) (required)
PractitionerRole.location	S This element must be supported.	0..*	Reference(Location)	Location(s) where the practitioner provides care
PractitionerRole.healthcareService	S This element must be supported.	0..*	Reference(HealthcareService)	Healthcare services provided for this role's Organization/Location(s)
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
PractitionerRole.identifier.​use	Base	required	Types of possible identifier uses	📍0.11.1	This IG
PractitionerRole.identifier.​type	Base	required	Types of possible identifiers	📍0.11.1	This IG
PractitionerRole.code.​coding:role.code	Base	required	Defines the possible positions and professions	📍0.11.1	This IG
PractitionerRole.specialty.​coding:dhpSpecialty.​code	Base	required	Profession specializations	📍0.11.1	This IG

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
PractitionerRole		0..*	PractitionerRole(5.0.0)	Roles/organizations the practitioner is associated with
PractitionerRole.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
PractitionerRole.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
PractitionerRole.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
PractitionerRole.language		0..1	code	Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language Additional Bindings Purpose CommonLanguages Starter
PractitionerRole.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
PractitionerRole.contained		0..*	Resource	Contained, inline Resources
PractitionerRole.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
PractitionerRole.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
PractitionerRole.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Identifiers for a role/location
PractitionerRole.identifier.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.identifier.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUseVS (0.11.1) (required)
PractitionerRole.identifier.type	Σ This element is included in summaries.	0..1	CodeableConcept	Description of identifier Binding: IdentifierTypeVS (0.11.1) (required)
PractitionerRole.identifier.system	Σ This element is included in summaries.	0..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
PractitionerRole.identifier.value	Σ This element is included in summaries. C	0..1	string	The value that is unique Example General: 123456
PractitionerRole.identifier.period	Σ This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
PractitionerRole.identifier.assigner	Σ This element is included in summaries.	0..1	Reference(Organization)	Organization that issued id (may be just text)
PractitionerRole.active	S This element must be supported. Σ This element is included in summaries.	0..1	boolean	Whether this practitioner role record is in active use
PractitionerRole.period	Σ This element is included in summaries.	0..1	Period	The period during which the practitioner is authorized to perform in these role(s)
PractitionerRole.practitioner	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Practitioner)	Practitioner that provides services for the organization
PractitionerRole.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Organization)	Organization where the roles are available
PractitionerRole.code	S This element must be supported. Σ This element is included in summaries.	1..1	CodeableConcept	Roles which this practitioner may perform Binding: PractitionerRole (example): The role a person plays representing an organization.
PractitionerRole.code.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.code.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.code.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.code.Slices for coding.coding:role	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.code.Slices for coding.coding:role.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.code.Slices for coding.coding:role.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.code.Slices for coding.coding:role.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs (extensions allowed)
PractitionerRole.code.Slices for coding.coding:role.version	Σ This element is included in summaries.	0..1	string	Version of the system - if relevant
PractitionerRole.code.Slices for coding.coding:role.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: PositionAndProfessionVS (0.11.1) (required)
PractitionerRole.code.Slices for coding.coding:role.display	Σ This element is included in summaries. C	0..1	string	Representation defined by the system
PractitionerRole.code.Slices for coding.coding:role.userSelected	Σ This element is included in summaries.	0..1	boolean	If this coding was chosen directly by the user
PractitionerRole.code.text	Σ This element is included in summaries.	0..1	string	Plain text representation of the concept
PractitionerRole.specialty	S This element must be supported. Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the practitioner Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
PractitionerRole.specialty.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.specialty.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.specialty.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs (extensions allowed)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.version	Σ This element is included in summaries.	0..1	string	Version of the system - if relevant
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: ProfessionSpecializationVS (0.11.1) (required)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.display	Σ This element is included in summaries. C	0..1	string	Representation defined by the system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.userSelected	Σ This element is included in summaries.	0..1	boolean	If this coding was chosen directly by the user
PractitionerRole.specialty.text	Σ This element is included in summaries.	0..1	string	Plain text representation of the concept
PractitionerRole.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(Location)	Location(s) where the practitioner provides care
PractitionerRole.healthcareService	S This element must be supported.	0..*	Reference(HealthcareService)	Healthcare services provided for this role's Organization/Location(s)
PractitionerRole.contact		0..*	ExtendedContactDetail	Official contact details relating to this PractitionerRole
PractitionerRole.characteristic		0..*	CodeableConcept	Collection of characteristics (attributes) Binding: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
PractitionerRole.communication		0..*	CodeableConcept	A language the practitioner (in this role) can use in patient communication Binding: AllLanguages (required): IETF language tag for a human language Additional Bindings Purpose CommonLanguages Starter
PractitionerRole.availability		0..*	Availability	Times the Practitioner is available at this location and/or healthcare service (including exceptions)
PractitionerRole.endpoint		0..*	Reference(Endpoint)	Endpoints for interacting with the practitioner in this role
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
PractitionerRole.language	Base	required	All Languages	📍5.0.0	FHIR Std.
PractitionerRole.identifier.​use	Base	required	Types of possible identifier uses	📍0.11.1	This IG
PractitionerRole.identifier.​type	Base	required	Types of possible identifiers	📍0.11.1	This IG
PractitionerRole.code	Base	example	Practitioner Role	📍5.0.0	FHIR Std.
PractitionerRole.code.​coding:role.code	Base	required	Defines the possible positions and professions	📍0.11.1	This IG
PractitionerRole.specialty	Base	preferred	Practice Setting Code Value Set	📍5.0.0	FHIR Std.
PractitionerRole.specialty.​coding:dhpSpecialty.​code	Base	required	Profession specializations	📍0.11.1	This IG
PractitionerRole.characteristic	Base	example	Service Mode	📍5.0.0	FHIR Std.
PractitionerRole.communication	Base	required	All Languages	📍5.0.0	FHIR Std.

Constraints

Id

Grade

Path(s)

Description

Expression

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
PractitionerRole		0..*	PractitionerRole(5.0.0)	Roles/organizations the practitioner is associated with
PractitionerRole.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
PractitionerRole.contained		0..*	Resource	Contained, inline Resources
PractitionerRole.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
PractitionerRole.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Identifiers for a role/location
PractitionerRole.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUseVS (0.11.1) (required)
PractitionerRole.identifier.type	Σ This element is included in summaries.	0..1	CodeableConcept	Description of identifier Binding: IdentifierTypeVS (0.11.1) (required)
PractitionerRole.active	S This element must be supported. Σ This element is included in summaries.	0..1	boolean	Whether this practitioner role record is in active use
PractitionerRole.practitioner	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Practitioner)	Practitioner that provides services for the organization
PractitionerRole.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Organization)	Organization where the roles are available
PractitionerRole.code	S This element must be supported. Σ This element is included in summaries.	1..1	CodeableConcept	Roles which this practitioner may perform Binding: PractitionerRole (example): The role a person plays representing an organization.
PractitionerRole.code.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.code.Slices for coding.coding:role	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.code.Slices for coding.coding:role.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs (extensions allowed)
PractitionerRole.code.Slices for coding.coding:role.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: PositionAndProfessionVS (0.11.1) (required)
PractitionerRole.specialty	S This element must be supported. Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the practitioner Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
PractitionerRole.specialty.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs (extensions allowed)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: ProfessionSpecializationVS (0.11.1) (required)
PractitionerRole.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(Location)	Location(s) where the practitioner provides care
PractitionerRole.healthcareService	S This element must be supported.	0..*	Reference(HealthcareService)	Healthcare services provided for this role's Organization/Location(s)
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
PractitionerRole.identifier.​use	Base	required	Types of possible identifier uses	📍0.11.1	This IG
PractitionerRole.identifier.​type	Base	required	Types of possible identifiers	📍0.11.1	This IG
PractitionerRole.code	Base	example	Practitioner Role	📍5.0.0	FHIR Std.
PractitionerRole.code.​coding:role.code	Base	required	Defines the possible positions and professions	📍0.11.1	This IG
PractitionerRole.specialty	Base	preferred	Practice Setting Code Value Set	📍5.0.0	FHIR Std.
PractitionerRole.specialty.​coding:dhpSpecialty.​code	Base	required	Profession specializations	📍0.11.1	This IG

Constraints

Id

Grade

Path(s)

Description

Expression

Differential View

This structure is derived from PractitionerRole

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
PractitionerRole		0..*	PractitionerRole(5.0.0)	Roles/organizations the practitioner is associated with
PractitionerRole.identifier	S This element must be supported.	0..*	Identifier	Identifiers for a role/location
PractitionerRole.identifier.use		0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUseVS (0.11.1) (required)
PractitionerRole.identifier.type		0..1	CodeableConcept	Description of identifier Binding: IdentifierTypeVS (0.11.1) (required)
PractitionerRole.active	S This element must be supported.	0..1	boolean	Whether this practitioner role record is in active use
PractitionerRole.practitioner	S This element must be supported.	0..1	Reference(Practitioner)	Practitioner that provides services for the organization
PractitionerRole.organization	S This element must be supported.	0..1	Reference(Organization)	Organization where the roles are available
PractitionerRole.code	S This element must be supported.	1..1	CodeableConcept	Roles which this practitioner may perform
PractitionerRole.code.Slices for coding		0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.code.Slices for coding.coding:role	S This element must be supported.	0..1	Coding	Code defined by a terminology system
PractitionerRole.code.Slices for coding.coding:role.system	S This element must be supported.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs (extensions allowed)
PractitionerRole.code.Slices for coding.coding:role.code	S This element must be supported.	1..1	code	Symbol in syntax defined by the system Binding: PositionAndProfessionVS (0.11.1) (required)
PractitionerRole.specialty	S This element must be supported.	0..*	CodeableConcept	Specific specialty of the practitioner
PractitionerRole.specialty.Slices for coding		0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty	S This element must be supported.	0..1	Coding	Code defined by a terminology system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.system	S This element must be supported.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs (extensions allowed)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.code	S This element must be supported.	1..1	code	Symbol in syntax defined by the system Binding: ProfessionSpecializationVS (0.11.1) (required)
PractitionerRole.location	S This element must be supported.	0..*	Reference(Location)	Location(s) where the practitioner provides care
PractitionerRole.healthcareService	S This element must be supported.	0..*	Reference(HealthcareService)	Healthcare services provided for this role's Organization/Location(s)
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
PractitionerRole.identifier.​use	Base	required	Types of possible identifier uses	📍0.11.1	This IG
PractitionerRole.identifier.​type	Base	required	Types of possible identifiers	📍0.11.1	This IG
PractitionerRole.code.​coding:role.code	Base	required	Defines the possible positions and professions	📍0.11.1	This IG
PractitionerRole.specialty.​coding:dhpSpecialty.​code	Base	required	Profession specializations	📍0.11.1	This IG

Snapshot ViewView

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
PractitionerRole		0..*	PractitionerRole(5.0.0)	Roles/organizations the practitioner is associated with
PractitionerRole.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
PractitionerRole.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
PractitionerRole.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
PractitionerRole.language		0..1	code	Language of the resource content Binding: AllLanguages (required): IETF language tag for a human language Additional Bindings Purpose CommonLanguages Starter
PractitionerRole.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
PractitionerRole.contained		0..*	Resource	Contained, inline Resources
PractitionerRole.extension		0..*	Extension	Additional content defined by implementations Constraints: ext-1
PractitionerRole.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored Constraints: ext-1
PractitionerRole.identifier	S This element must be supported. Σ This element is included in summaries.	0..*	Identifier	Identifiers for a role/location
PractitionerRole.identifier.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.identifier.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	0..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUseVS (0.11.1) (required)
PractitionerRole.identifier.type	Σ This element is included in summaries.	0..1	CodeableConcept	Description of identifier Binding: IdentifierTypeVS (0.11.1) (required)
PractitionerRole.identifier.system	Σ This element is included in summaries.	0..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
PractitionerRole.identifier.value	Σ This element is included in summaries. C	0..1	string	The value that is unique Example General: 123456
PractitionerRole.identifier.period	Σ This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
PractitionerRole.identifier.assigner	Σ This element is included in summaries.	0..1	Reference(Organization)	Organization that issued id (may be just text)
PractitionerRole.active	S This element must be supported. Σ This element is included in summaries.	0..1	boolean	Whether this practitioner role record is in active use
PractitionerRole.period	Σ This element is included in summaries.	0..1	Period	The period during which the practitioner is authorized to perform in these role(s)
PractitionerRole.practitioner	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Practitioner)	Practitioner that provides services for the organization
PractitionerRole.organization	S This element must be supported. Σ This element is included in summaries.	0..1	Reference(Organization)	Organization where the roles are available
PractitionerRole.code	S This element must be supported. Σ This element is included in summaries.	1..1	CodeableConcept	Roles which this practitioner may perform Binding: PractitionerRole (example): The role a person plays representing an organization.
PractitionerRole.code.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.code.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.code.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.code.Slices for coding.coding:role	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.code.Slices for coding.coding:role.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.code.Slices for coding.coding:role.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.code.Slices for coding.coding:role.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs (extensions allowed)
PractitionerRole.code.Slices for coding.coding:role.version	Σ This element is included in summaries.	0..1	string	Version of the system - if relevant
PractitionerRole.code.Slices for coding.coding:role.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: PositionAndProfessionVS (0.11.1) (required)
PractitionerRole.code.Slices for coding.coding:role.display	Σ This element is included in summaries. C	0..1	string	Representation defined by the system
PractitionerRole.code.Slices for coding.coding:role.userSelected	Σ This element is included in summaries.	0..1	boolean	If this coding was chosen directly by the user
PractitionerRole.code.text	Σ This element is included in summaries.	0..1	string	Plain text representation of the concept
PractitionerRole.specialty	S This element must be supported. Σ This element is included in summaries.	0..*	CodeableConcept	Specific specialty of the practitioner Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
PractitionerRole.specialty.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.specialty.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.specialty.Slices for coding	Σ This element is included in summaries.	0..*	Coding	Code defined by a terminology system Slice: Unordered, Open by value:system Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty	S This element must be supported. Σ This element is included in summaries.	0..1	Coding	Code defined by a terminology system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.id		0..1	id	Unique id for inter-element referencing
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url Constraints: ext-1
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.system	S This element must be supported. Σ This element is included in summaries.	1..1	uri	Identity of the terminology system Required Pattern: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs (extensions allowed)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.version	Σ This element is included in summaries.	0..1	string	Version of the system - if relevant
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.code	S This element must be supported. Σ This element is included in summaries. C	1..1	code	Symbol in syntax defined by the system Binding: ProfessionSpecializationVS (0.11.1) (required)
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.display	Σ This element is included in summaries. C	0..1	string	Representation defined by the system
PractitionerRole.specialty.Slices for coding.coding:dhpSpecialty.userSelected	Σ This element is included in summaries.	0..1	boolean	If this coding was chosen directly by the user
PractitionerRole.specialty.text	Σ This element is included in summaries.	0..1	string	Plain text representation of the concept
PractitionerRole.location	S This element must be supported. Σ This element is included in summaries.	0..*	Reference(Location)	Location(s) where the practitioner provides care
PractitionerRole.healthcareService	S This element must be supported.	0..*	Reference(HealthcareService)	Healthcare services provided for this role's Organization/Location(s)
PractitionerRole.contact		0..*	ExtendedContactDetail	Official contact details relating to this PractitionerRole
PractitionerRole.characteristic		0..*	CodeableConcept	Collection of characteristics (attributes) Binding: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
PractitionerRole.communication		0..*	CodeableConcept	A language the practitioner (in this role) can use in patient communication Binding: AllLanguages (required): IETF language tag for a human language Additional Bindings Purpose CommonLanguages Starter
PractitionerRole.availability		0..*	Availability	Times the Practitioner is available at this location and/or healthcare service (including exceptions)
PractitionerRole.endpoint		0..*	Reference(Endpoint)	Endpoints for interacting with the practitioner in this role
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
PractitionerRole.language	Base	required	All Languages	📍5.0.0	FHIR Std.
PractitionerRole.identifier.​use	Base	required	Types of possible identifier uses	📍0.11.1	This IG
PractitionerRole.identifier.​type	Base	required	Types of possible identifiers	📍0.11.1	This IG
PractitionerRole.code	Base	example	Practitioner Role	📍5.0.0	FHIR Std.
PractitionerRole.code.​coding:role.code	Base	required	Defines the possible positions and professions	📍0.11.1	This IG
PractitionerRole.specialty	Base	preferred	Practice Setting Code Value Set	📍5.0.0	FHIR Std.
PractitionerRole.specialty.​coding:dhpSpecialty.​code	Base	required	Profession specializations	📍0.11.1	This IG
PractitionerRole.characteristic	Base	example	Service Mode	📍5.0.0	FHIR Std.
PractitionerRole.communication	Base	required	All Languages	📍5.0.0	FHIR Std.

Constraints

Id

Grade

Path(s)

Description

Expression

This structure is derived from PractitionerRole

Summary

Mandatory: 1 element(4 nested mandatory elements)
Must-Support: 14 elements

Slices

This structure defines the following Slices:

• The element 1 is sliced based on the value of PractitionerRole.code.coding
• The element 1 is sliced based on the value of PractitionerRole.specialty.coding

Quick Start

Common API interactions for this profile. Requests require a JWT access token - see Security and authentication. [base] is the FHIR server base URL; | separates a code system from its value and must be URL-encoded as %7C.

Read a practitioner role by server id

GET [base]/PractitionerRole/[id]

Find the roles a practitioner holds, or who works in an organization

GET [base]/PractitionerRole?practitioner=Practitioner/[id]&active=true
GET [base]/PractitionerRole?organization=Organization/[id]
GET [base]/PractitionerRole?specialty=https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs|394585009
GET [base]/PractitionerRole?role=https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs|2212.14&location=Location/[id]

Create a new practitioner role

POST [base]/PractitionerRole
{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role" ]
  },
  ...
}

Update an existing practitioner role

PUT [base]/PractitionerRole/[id]
If-Match: W/"3"   # the ETag from your last read; 412 if it changed since
{
  "resourceType": "PractitionerRole",
  "id": "[id]",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role" ]
  },
  ...
}

See the CapabilityStatement for the full list of supported search parameters.

Related

• Workflows
• How to read this guide · Must Support · General guidance