2nd DSTU Draft For Comment

This page is part of the FHIR Specification (v0.4.0: DSTU 2 Draft). The current version which supercedes this version is 5.0.0. For a full list of available versions, see the Directory of published versions . Page versions: R5 R4B R4 R3 R2

5.4 Resource Practitioner - Content

This resource maintained by the Patient Administration Work Group

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

5.4.1 Scope and Usage

Practitioner covers all individuals who are engaged in the healthcare process and healthcare-related services as part of their formal responsibilities and this Resource is used for attribution of activities and responsibilities to these individuals. Practitioners include (but are not limited to):

  • physicians, dentists, pharmacists
  • physician assistants, nurses, scribes
  • midwives, dietitians, therapists, optometrists, paramedics
  • medical technicians, laboratory scientists, prosthetic technicians, radiographers
  • social workers, professional home carers, official volunteers
  • receptionists handling patient registration
  • IT personnel merging or unmerging patient records

5.4.2 Boundaries and Relationships

The Resource SHALL not be used for persons involved without a formal responsibility like individuals taking care for friends, relatives or neighbors. These can be registered as a Patient's Contact. If performing some action or being referenced by another resource, use RelatedPerson.

5.4.3 Background and Context

Practitioner performs different roles within the same or even different organizations. Depending on jurisdiction and custom, it may be necessary to maintain a specific Practitioner Resource for each such role or have a single Practitioner with multiple roles. The role can be limited to a specific period, after which authorization for this role ends. Note that the represented organization need not necessarily be the (direct) employer of a Practitioner.

This resource is referenced by Alert, AllergyIntolerance, Appointment, AppointmentResponse, Basic, CarePlan, CarePlan2, ClaimResponse, ClinicalAssessment, Communication, CommunicationRequest, Composition, Condition, Contract, Contraindication, DiagnosticOrder, DiagnosticReport, DocumentManifest, DocumentReference, EligibilityRequest, EligibilityResponse, Encounter, EnrollmentRequest, EnrollmentResponse, EpisodeOfCare, ExplanationOfBenefit, Group, ImagingObjectSelection, ImagingStudy, Immunization, InstitutionalClaim, List, Media, MedicationAdministration, MedicationDispense, MedicationPrescription, MedicationStatement, MessageHeader, NutritionOrder, Observation, OralHealthClaim, Order, OrderResponse, Other, Patient, PaymentNotice, PaymentReconciliation, PendedRequest, Person, PharmacyClaim, Procedure, ProcedureRequest, ProfessionalClaim, QuestionnaireAnswers, Readjudicate, ReferralRequest, Reversal, RiskAssessment, SecurityEvent, Specimen, StatusRequest, StatusResponse, Supply, SupportingDocumentation, VisionClaim and VisionPrescription

5.4.4 Resource Content

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner DomainResourceA person with a formal responsibility in the provisioning of healthcare or related services
... identifier Σ0..*IdentifierA identifier for the person as this agent
... name Σ0..1HumanNameA name associated with the person
... telecom Σ0..*ContactPointA contact detail for the practitioner
... address Σ0..*AddressWhere practitioner can be found/visited
... gender Σ0..1codemale | female | other | unknown
AdministrativeGender (Required)
... birthDate Σ0..1dateThe date of birth for the practitioner
... photo 0..*AttachmentImage of the person
... practitionerRole 0..*ElementThe list of Roles/Organizations that the Practitioner is associated with
.... managingOrganization 0..1OrganizationThe Organization where the Practitioner performs the roles associated
.... role Σ0..1CodeableConceptRoles which this practitioner may perform
PractitionerRole (Example)
.... specialty Σ0..*CodeableConceptSpecific specialty of the practitioner
PractitionerSpecialty (Example)
.... period Σ0..1PeriodThe period during which the practitioner is authorized to perform in these role(s)
.... location 0..*LocationThe location(s) at which this practitioner provides care
.... healthcareService 0..*HealthcareServiceThe list of healthcare services that this worker offers at this location of this organization
... qualification 0..*ElementQualifications obtained by training and certification
.... identifier 0..*IdentifierAn identifier for this qualification for the practitioner
.... code 1..1CodeableConceptCoded representation of the qualification
Qualification (Example)
.... period 0..1PeriodPeriod during which the qualification is valid
.... issuer 0..1OrganizationOrganization that regulates and issues the qualification
... communication 0..*CodeableConceptA language the practitioner is able to use in patient communication
Language (Required)

UML Diagram

Practitioner (DomainResource)An identifier that applies to this person in this roleidentifier : Identifier 0..*A name associated with the personname : HumanName 0..1A contact detail for the practitioner, e.g. a telephone number or an email addresstelecom : ContactPoint 0..*The postal address where the practitioner can be found or visited or to which mail can be deliveredaddress : Address 0..*Administrative Gender - the gender that the person is considered to have for administration and record keeping purposesgender : code 0..1 « The gender of a person used for administrative purposesAdministrativeGender »The date of birth for the practitionerbirthDate : date 0..1Image of the personphoto : Attachment 0..*A language the practitioner is able to use in patient communicationcommunication : CodeableConcept 0..* « A human languageLanguage »PractitionerRoleThe Organization where the Practitioner performs the roles associatedmanagingOrganization : Reference(Organization) 0..1Roles which this practitioner is authorized to perform for the organizationrole : CodeableConcept 0..1 « (The role a person plays representing an organizationPractitionerRole) »Specific specialty of the practitionerspecialty : CodeableConcept 0..* « (Specific specialty associated with the agencyPractitionerSpecialty) »The period during which the person is authorized to act as a practitioner in these role(s) for the organizationperiod : Period 0..1The location(s) at which this practitioner provides carelocation : Reference(Location) 0..*The list of healthcare services that this worker offers at this location of this organizationhealthcareService : Reference(HealthcareService) 0..*QualificationAn identifier that applies to this person's qualification in this roleidentifier : Identifier 0..*Coded representation of the qualificationcode : CodeableConcept 1..1 « (Specific qualification the practitioner has to provide a serviceQualification) »Period during which the qualification is validperiod : Period 0..1Organization that regulates and issues the qualificationissuer : Reference(Organization) 0..1The list of Roles/Organizations that the Practitioner is associated withpractitionerRole0..*Qualifications obtained by training and certificationqualification0..*

XML Template

<Practitioner xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier A identifier for the person as this agent --></identifier>
 <name><!-- 0..1 HumanName A name associated with the person --></name>
 <telecom><!-- 0..* ContactPoint A contact detail for the practitioner --></telecom>
 <address><!-- 0..* Address Where practitioner can be found/visited --></address>
 <gender value="[code]"/><!-- 0..1 male | female | other | unknown -->
 <birthDate value="[date]"/><!-- 0..1 The date  of birth for the practitioner -->
 <photo><!-- 0..* Attachment Image of the person --></photo>
 <practitionerRole>  <!-- 0..* The list of Roles/Organizations that the Practitioner is associated with -->
  <managingOrganization><!-- 0..1 Reference(Organization) 
      The Organization where the Practitioner performs the roles associated --></managingOrganization>
  <role><!-- 0..1 CodeableConcept Roles which this practitioner may perform --></role>
  <specialty><!-- 0..* CodeableConcept Specific specialty of the practitioner --></specialty>
  <period><!-- 0..1 Period 
      The period during which the practitioner is authorized to perform in these role(s) --></period>
  <location><!-- 0..* Reference(Location) 
      The location(s) at which this practitioner provides care --></location>
  <healthcareService><!-- 0..* Reference(HealthcareService) 
      The list of healthcare services that this worker offers at this location of this organization --></healthcareService>
 </practitionerRole>
 <qualification>  <!-- 0..* Qualifications obtained by training and certification -->
  <identifier><!-- 0..* Identifier 
      An identifier for this qualification for the practitioner --></identifier>
  <code><!-- 1..1 CodeableConcept Coded representation of the qualification --></code>
  <period><!-- 0..1 Period Period during which the qualification is valid --></period>
  <issuer><!-- 0..1 Reference(Organization) 
      Organization that regulates and issues the qualification --></issuer>
 </qualification>
 <communication><!-- 0..* CodeableConcept A language the practitioner is able to use in patient communication --></communication>
</Practitioner>

JSON Template

{doco
  "resourceType" : "Practitioner",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // A identifier for the person as this agent
  "name" : { HumanName }, // A name associated with the person
  "telecom" : [{ ContactPoint }], // A contact detail for the practitioner
  "address" : [{ Address }], // Where practitioner can be found/visited
  "gender" : "<code>", // male | female | other | unknown
  "birthDate" : "<date>", // The date  of birth for the practitioner
  "photo" : [{ Attachment }], // Image of the person
  "practitionerRole" : [{ // The list of Roles/Organizations that the Practitioner is associated with
    "managingOrganization" : { Reference(Organization) }, // 
      The Organization where the Practitioner performs the roles associated
    "role" : { CodeableConcept }, // Roles which this practitioner may perform
    "specialty" : [{ CodeableConcept }], // Specific specialty of the practitioner
    "period" : { Period }, // 
      The period during which the practitioner is authorized to perform in these role(s)
    "location" : [{ Reference(Location) }], // 
      The location(s) at which this practitioner provides care
    "healthcareService" : [{ Reference(HealthcareService) }] // 
      The list of healthcare services that this worker offers at this location of this organization
  }],
  "qualification" : [{ // Qualifications obtained by training and certification
    "identifier" : [{ Identifier }], // 
      An identifier for this qualification for the practitioner
    "code" : { CodeableConcept }, // R! Coded representation of the qualification
    "period" : { Period }, // Period during which the qualification is valid
    "issuer" : { Reference(Organization) } // 
      Organization that regulates and issues the qualification
  }],
  "communication" : [{ CodeableConcept }] // A language the practitioner is able to use in patient communication
}

Structure

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner DomainResourceA person with a formal responsibility in the provisioning of healthcare or related services
... identifier Σ0..*IdentifierA identifier for the person as this agent
... name Σ0..1HumanNameA name associated with the person
... telecom Σ0..*ContactPointA contact detail for the practitioner
... address Σ0..*AddressWhere practitioner can be found/visited
... gender Σ0..1codemale | female | other | unknown
AdministrativeGender (Required)
... birthDate Σ0..1dateThe date of birth for the practitioner
... photo 0..*AttachmentImage of the person
... practitionerRole 0..*ElementThe list of Roles/Organizations that the Practitioner is associated with
.... managingOrganization 0..1OrganizationThe Organization where the Practitioner performs the roles associated
.... role Σ0..1CodeableConceptRoles which this practitioner may perform
PractitionerRole (Example)
.... specialty Σ0..*CodeableConceptSpecific specialty of the practitioner
PractitionerSpecialty (Example)
.... period Σ0..1PeriodThe period during which the practitioner is authorized to perform in these role(s)
.... location 0..*LocationThe location(s) at which this practitioner provides care
.... healthcareService 0..*HealthcareServiceThe list of healthcare services that this worker offers at this location of this organization
... qualification 0..*ElementQualifications obtained by training and certification
.... identifier 0..*IdentifierAn identifier for this qualification for the practitioner
.... code 1..1CodeableConceptCoded representation of the qualification
Qualification (Example)
.... period 0..1PeriodPeriod during which the qualification is valid
.... issuer 0..1OrganizationOrganization that regulates and issues the qualification
... communication 0..*CodeableConceptA language the practitioner is able to use in patient communication
Language (Required)

UML Diagram

Practitioner (DomainResource)An identifier that applies to this person in this roleidentifier : Identifier 0..*A name associated with the personname : HumanName 0..1A contact detail for the practitioner, e.g. a telephone number or an email addresstelecom : ContactPoint 0..*The postal address where the practitioner can be found or visited or to which mail can be deliveredaddress : Address 0..*Administrative Gender - the gender that the person is considered to have for administration and record keeping purposesgender : code 0..1 « The gender of a person used for administrative purposesAdministrativeGender »The date of birth for the practitionerbirthDate : date 0..1Image of the personphoto : Attachment 0..*A language the practitioner is able to use in patient communicationcommunication : CodeableConcept 0..* « A human languageLanguage »PractitionerRoleThe Organization where the Practitioner performs the roles associatedmanagingOrganization : Reference(Organization) 0..1Roles which this practitioner is authorized to perform for the organizationrole : CodeableConcept 0..1 « (The role a person plays representing an organizationPractitionerRole) »Specific specialty of the practitionerspecialty : CodeableConcept 0..* « (Specific specialty associated with the agencyPractitionerSpecialty) »The period during which the person is authorized to act as a practitioner in these role(s) for the organizationperiod : Period 0..1The location(s) at which this practitioner provides carelocation : Reference(Location) 0..*The list of healthcare services that this worker offers at this location of this organizationhealthcareService : Reference(HealthcareService) 0..*QualificationAn identifier that applies to this person's qualification in this roleidentifier : Identifier 0..*Coded representation of the qualificationcode : CodeableConcept 1..1 « (Specific qualification the practitioner has to provide a serviceQualification) »Period during which the qualification is validperiod : Period 0..1Organization that regulates and issues the qualificationissuer : Reference(Organization) 0..1The list of Roles/Organizations that the Practitioner is associated withpractitionerRole0..*Qualifications obtained by training and certificationqualification0..*

XML Template

<Practitioner xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier A identifier for the person as this agent --></identifier>
 <name><!-- 0..1 HumanName A name associated with the person --></name>
 <telecom><!-- 0..* ContactPoint A contact detail for the practitioner --></telecom>
 <address><!-- 0..* Address Where practitioner can be found/visited --></address>
 <gender value="[code]"/><!-- 0..1 male | female | other | unknown -->
 <birthDate value="[date]"/><!-- 0..1 The date  of birth for the practitioner -->
 <photo><!-- 0..* Attachment Image of the person --></photo>
 <practitionerRole>  <!-- 0..* The list of Roles/Organizations that the Practitioner is associated with -->
  <managingOrganization><!-- 0..1 Reference(Organization) 
      The Organization where the Practitioner performs the roles associated --></managingOrganization>
  <role><!-- 0..1 CodeableConcept Roles which this practitioner may perform --></role>
  <specialty><!-- 0..* CodeableConcept Specific specialty of the practitioner --></specialty>
  <period><!-- 0..1 Period 
      The period during which the practitioner is authorized to perform in these role(s) --></period>
  <location><!-- 0..* Reference(Location) 
      The location(s) at which this practitioner provides care --></location>
  <healthcareService><!-- 0..* Reference(HealthcareService) 
      The list of healthcare services that this worker offers at this location of this organization --></healthcareService>
 </practitionerRole>
 <qualification>  <!-- 0..* Qualifications obtained by training and certification -->
  <identifier><!-- 0..* Identifier 
      An identifier for this qualification for the practitioner --></identifier>
  <code><!-- 1..1 CodeableConcept Coded representation of the qualification --></code>
  <period><!-- 0..1 Period Period during which the qualification is valid --></period>
  <issuer><!-- 0..1 Reference(Organization) 
      Organization that regulates and issues the qualification --></issuer>
 </qualification>
 <communication><!-- 0..* CodeableConcept A language the practitioner is able to use in patient communication --></communication>
</Practitioner>

JSON Template

{doco
  "resourceType" : "Practitioner",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // A identifier for the person as this agent
  "name" : { HumanName }, // A name associated with the person
  "telecom" : [{ ContactPoint }], // A contact detail for the practitioner
  "address" : [{ Address }], // Where practitioner can be found/visited
  "gender" : "<code>", // male | female | other | unknown
  "birthDate" : "<date>", // The date  of birth for the practitioner
  "photo" : [{ Attachment }], // Image of the person
  "practitionerRole" : [{ // The list of Roles/Organizations that the Practitioner is associated with
    "managingOrganization" : { Reference(Organization) }, // 
      The Organization where the Practitioner performs the roles associated
    "role" : { CodeableConcept }, // Roles which this practitioner may perform
    "specialty" : [{ CodeableConcept }], // Specific specialty of the practitioner
    "period" : { Period }, // 
      The period during which the practitioner is authorized to perform in these role(s)
    "location" : [{ Reference(Location) }], // 
      The location(s) at which this practitioner provides care
    "healthcareService" : [{ Reference(HealthcareService) }] // 
      The list of healthcare services that this worker offers at this location of this organization
  }],
  "qualification" : [{ // Qualifications obtained by training and certification
    "identifier" : [{ Identifier }], // 
      An identifier for this qualification for the practitioner
    "code" : { CodeableConcept }, // R! Coded representation of the qualification
    "period" : { Period }, // Period during which the qualification is valid
    "issuer" : { Reference(Organization) } // 
      Organization that regulates and issues the qualification
  }],
  "communication" : [{ CodeableConcept }] // A language the practitioner is able to use in patient communication
}

 

Alternate definitions: Schema/Schematron, Resource Profile (XML, JSON), Questionnaire

5.4.4.1 Terminology Bindings

PathDefinitionTypeReference
Practitioner.gender The gender of a person used for administrative purposesFixedhttp://hl7.org/fhir/administrative-gender
Practitioner.practitionerRole.role The role a person plays representing an organizationExamplehttp://hl7.org/fhir/vs/practitioner-role
Practitioner.practitionerRole.specialty Specific specialty associated with the agencyExamplehttp://hl7.org/fhir/vs/practitioner-specialty
Practitioner.qualification.code Specific qualification the practitioner has to provide a serviceExamplehttp://hl7.org/fhir/vs/anzsco-occupations
Practitioner.communication A human languageFixedIETF language tag

5.4.5 Notes:

  • Practitioner.period is different from Qualification.period: the first concerns the period during which the Practitioner is allowed to perform in the given roles for the organization. The second is about the period of validity for qualifications for which licenses have been obtained by training or otherwise.

5.4.6 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

NameTypeDescriptionPaths
addressstringAn address in any kind of address/partPractitioner.address
communicationtokenOne of the languages that the practitioner can communicate withPractitioner.communication
familystringA portion of the family namePractitioner.name
gendertokenGender of the practitionerPractitioner.gender
givenstringA portion of the given namePractitioner.name
identifiertokenA practitioner's IdentifierPractitioner.identifier
locationreferenceOne of the locations at which this practitioner provides carePractitioner.practitionerRole.location
(Location)
namestringA portion of either family or given namePractitioner.name
organizationreferenceThe identity of the organization the practitioner represents / acts on behalf ofPractitioner.practitionerRole.managingOrganization
(Organization)
phoneticstringA portion of either family or given name using some kind of phonetic matching algorithmPractitioner.name
roletokenThe practitioner can perform this role at for the organizationPractitioner.practitionerRole.role
specialtytokenThe practitioner has this specailty at an organizationPractitioner.practitionerRole.specialty
telecomstringThe value in any kind of contactPractitioner.telecom