Practitioner - FHIR v3.4.0
Current Build
Patient Administration Work GroupMaturity Level: 3 Trial Use Compartments: Practitioner

Detailed Descriptions for the elements in the Practitioner resource.

Practitioner
Element IdPractitioner
Definition

A person who is directly or indirectly involved in the provisioning of healthcare.

Control1..1
TypeDomainResource
Requirements

Need to track doctors, staff, locums etc. for both healthcare practitioners, funders, etc.

Practitioner.identifier
Element IdPractitioner.identifier
Definition

An identifier that applies to this person in this role.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Requirements

Often, specific identities are assigned for the agent.

Summarytrue
Practitioner.active
Element IdPractitioner.active
Definition

Whether this practitioner's record is in active use.

Control0..1
Typeboolean
Meaning if MissingThis resource is generally assumed to be active if no value is provided for the active element
Requirements

Need to be able to mark a practitioner record as not to be used because it was created in error.

Summarytrue
Comments

If the practitioner is not in use by one organization, then it should mark the period on the PractitonerRole with an end date (even if they are active) as they may be active in another role.

Practitioner.name
Element IdPractitioner.name
Definition

The name(s) associated with the practitioner.

Control0..*
TypeHumanName
Requirements

The name(s) that a Practitioner is known by. Where there are multiple, the name that the practitioner is usually known as should be used in the display.

Summarytrue
Comments

The selection of the use property should ensure that there is a single usual name specified, and others use the nickname (alias), old, or other values as appropriate.

In general, select the value to be used in the ResourceReference.display based on this:

  1. There is more than 1 name
  2. Use = usual
  3. Period is current to the date of the usage
  4. Use = official
  5. Other order as decided by internal business rules.
Practitioner.telecom
Element IdPractitioner.telecom
Definition

A contact detail for the practitioner, e.g. a telephone number or an email address.

Control0..*
TypeContactPoint
Requirements

Need to know how to reach a practitioner independent to any roles the practitioner may have.

Summarytrue
Comments

Person may have multiple ways to be contacted with different uses or applicable periods. May need to have options for contacting the person urgently and to help with identification. These typically will have home numbers, or mobile numbers that are not role specific.

Practitioner.address
Element IdPractitioner.address
Definition

Address(es) of the practitioner that are not role specific (typically home address). Work addresses are not typically entered in this property as they are usually role dependent.

Control0..*
TypeAddress
Requirements

The home/mailing address of the practitioner is often required for employee administration purposes, and also for some rostering services where the start point (practitioners home) can be used in calculations.

Summarytrue
Comments

The PractitionerRole does not have an address value on it, as it is expected that the location property be used for this purpose (which has an address).

Practitioner.gender
Element IdPractitioner.gender
Definition

Administrative Gender - the gender that the person is considered to have for administration and record keeping purposes.

Control0..1
Terminology BindingAdministrativeGender (Required)
Typecode
Requirements

Needed to address the person correctly.

Summarytrue
Practitioner.birthDate
Element IdPractitioner.birthDate
Definition

The date of birth for the practitioner.

Control0..1
Typedate
Requirements

Needed for identification.

Summarytrue
Practitioner.photo
Element IdPractitioner.photo
Definition

Image of the person.

Control0..*
TypeAttachment
Requirements

Many EHR systems have the capability to capture an image of patients and personnel. Fits with newer social media usage too.

Practitioner.qualification
Element IdPractitioner.qualification
Definition

The official certifications, training, and licenses that authorize or otherwise pertain to the provision of care by the practitioner. For example, a medical license issued by a medical board authorizing the practitioner to practice medicine within a certian locality.

Control0..*
Practitioner.qualification.identifier
Element IdPractitioner.qualification.identifier
Definition

An identifier that applies to this person's qualification in this role.

NoteThis is a business identifer, not a resource identifier (see discussion)
Control0..*
TypeIdentifier
Requirements

Often, specific identities are assigned for the qualification.

Practitioner.qualification.code
Element IdPractitioner.qualification.code
Definition

Coded representation of the qualification.

Control1..1
Terminology BindingV2.0360.2.7 (Example)
TypeCodeableConcept
Practitioner.qualification.period
Element IdPractitioner.qualification.period
Definition

Period during which the qualification is valid.

Control0..1
TypePeriod
Requirements

Qualifications are often for a limited period of time, and can be revoked.

Practitioner.qualification.issuer
Element IdPractitioner.qualification.issuer
Definition

Organization that regulates and issues the qualification.

Control0..1
TypeReference(Organization)
Practitioner.communication
Element IdPractitioner.communication
Definition

A language the practitioner can use in patient communication.

Control0..*
Terminology BindingCommon Languages (Preferred but limited to All Languages)
TypeCodeableConcept
Requirements

Knowing which language a practitioner speaks can help in facilitating communication with patients.

Comments

The structure aa-BB with this exact casing is one the most widely used notations for locale. However not all systems code this but instead have it as free text. Hence CodeableConcept instead of code as the data type.