DSTU2

This page is part of the FHIR Specification (v0.0.82: (v1.0.2: DSTU 1). 2). 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.3 5.4 Resource Practitioner - Content

Patient Administration Work Group Maturity Level : 1 Compartments : Practitioner

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

5.3.1 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 physicians, dentists, pharmacists
  • physician assistants, nurses, assistants, nurses, scribes
  • midwives, dietitians, therapists, optometrists, midwives, dietitians, therapists, optometrists, paramedics
  • medical technicians, laboratory technicians, laboratory scientists, prosthetic technicians, radiographers
  • social workers, professional home carers, official volunteers
  • receptionists handling patient registration
  • IT personnel merging or unmerging patient records
  • Service animal (e.g., ward assigned dog capable of detecting cancer in patients)

5.3.2 5.4.2 Boundaries and Relationships

The Resource SHALL not 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 the RelatedPerson . resource.

The primary distinction between a Practitioner and a RelatedPerson is based on whether:

  • The person/animal operates on behalf of the care delivery organization over multiple patients (Practitioner) or,
  • Where the person/animal is not associated with the organization, and instead is allocated tasks specifically for the RelatedPerson's Patient (RelatedPerson).

A standard extension animalSpecies can be used to indicate the species of a service animal.

5.3.3 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 Account , AllergyIntolerance , Appointment , AppointmentResponse , AuditEvent , Basic , CarePlan , Claim , ClaimResponse , ClinicalImpression , Communication , CommunicationRequest , Composition , Condition , Contract , DetectedIssue , DiagnosticOrder , DiagnosticReport , DocumentManifest , DocumentReference , EligibilityRequest , EligibilityResponse , Encounter , EnrollmentRequest , EnrollmentResponse , EpisodeOfCare , ExplanationOfBenefit , Flag , Goal , Group , ImagingObjectSelection , ImagingStudy , Immunization , List , Media , MedicationAdministration , MedicationDispense , MedicationOrder , MedicationStatement , MessageHeader , NutritionOrder , Observation , Order , OrderResponse , Patient , PaymentNotice , PaymentReconciliation , Person , Procedure , ProcedureRequest , ProcessRequest , ProcessResponse , Provenance , QuestionnaireResponse , ReferralRequest , RiskAssessment , Schedule , Specimen , SupplyDelivery , SupplyRequest and VisionPrescription

5.3.4 5.4.4 Resource Content

Structure

Name Flags Card. Type Description & Constraints doco
.. Practitioner DomainResource A person with a formal responsibility in the provisioning of healthcare or related services
... identifier Σ 0..* Identifier A identifier for the person as this agent
... active Σ 0..1 boolean Whether this practitioner's record is in active use
... name Σ 0..1 HumanName A name associated with the person
... telecom Σ 0..* ContactPoint A contact detail for the practitioner
... address Σ 0..* Address Where practitioner can be found/visited
... gender Σ 0..1 code male | female | other | unknown
AdministrativeGender ( Required )
... birthDate Σ 0..1 date The date on which the practitioner was born
... photo 0..* Attachment Image of the person
... practitionerRole 0..* BackboneElement Roles/organizations the practitioner is associated with
.... managingOrganization 0..1 Reference ( Organization ) Organization where the roles are performed
.... role Σ 0..1 CodeableConcept Roles which this practitioner may perform
PractitionerRole ( Example )
.... specialty Σ 0..* CodeableConcept Specific specialty of the practitioner
PractitionerSpecialty ( Example )
.... period Σ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
.... location 0..* Reference ( Location ) The location(s) at which this practitioner provides care
.... healthcareService 0..* Reference ( HealthcareService ) The list of healthcare services that this worker provides for this role's Organization/Location(s)
... qualification 0..* BackboneElement Qualifications obtained by training and certification
.... identifier 0..* Identifier An identifier for this qualification for the practitioner
.... code 1..1 CodeableConcept Coded representation of the qualification
ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2 ( Example )
.... period 0..1 Period Period during which the qualification is valid
.... issuer 0..1 Reference ( Organization ) Organization that regulates and issues the qualification
... communication 0..* CodeableConcept A language the practitioner is able to use in patient communication
Language ( Required )

doco Documentation for this format

UML Diagram

Practitioner ( Resource DomainResource ) An identifier that applies to this person in this role identifier : Identifier 0..* [0..*] Whether this practitioner's record is in active use active : boolean [0..1] A name associated with the person name : HumanName 0..1 [0..1] A contact detail for the practitioner, e.g. a telephone number or an email address telecom : Contact ContactPoint 0..* [0..*] The postal address where the practitioner can be found or visited or to which mail can be delivered address : Address 0..1 [0..*] Administrative Gender - the gender that the person is considered to have for administration and record keeping purposes gender : CodeableConcept code 0..1 << [0..1] « The gender of a person used for administrative purposes purposes. (Strength=Required) AdministrativeGender >> ! » The date and time of birth for the practitioner birthDate : dateTime date 0..1 [0..1] Image of the person photo : Attachment 0..* [0..*] The organization that A language the practitioner represents is able to use in patient communication communication : CodeableConcept [0..*] « A human language. (Strength=Required) Language ! » PractitionerRole The organization where the Practitioner performs the roles associated managingOrganization : Resource Reference ( [0..1] « Organization ) 0..1 » Roles which this practitioner is authorized to perform for the organization role : CodeableConcept 0..* << [0..1] « The role a person plays representing an organization (Strength=Example) PractitionerRole >> ?? » Specific specialty of the practitioner specialty : CodeableConcept 0..* << [0..*] « Specific specialty associated with the agency (Strength=Example) PractitionerSpecialty >> ?? » The period during which the person is authorized to act as a practitioner in these role(s) for the organization period : Period 0..1 [0..1] The location(s) at which this practitioner provides care location : Resource Reference ( [0..*] « Location » The list of healthcare services that this worker provides for this role's Organization/Location(s) healthcareService : Reference [0..*] « HealthcareService » Qualification An identifier that applies to this person's qualification in this role identifier : Identifier [0..*] Coded representation of the qualification code : CodeableConcept [1..1] « Specific qualification the practitioner has to provide a service (Strength=Example) ANZSCO -- Australian and New ... ?? » Period during which the qualification is valid period : Period [0..1] Organization that regulates and issues the qualification issuer : Reference [0..1] « Organization » The list of roles/organizations that the practitioner is associated with practitionerRole [0..*] Qualifications obtained by training and certification qualification [0..*]

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>
 <active value="[boolean]"/><!-- 0..1 Whether this practitioner's record is in active use -->
 <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  on which the practitioner was born -->
 <photo><!-- 0..* Attachment Image of the person --></photo>
 <practitionerRole>  <!-- 0..* Roles/organizations the practitioner is associated with -->
  <managingOrganization><!-- 0..1 Reference(Organization) Organization where the roles are performed --></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 provides for this role's Organization/Location(s) --></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
  "active" : <boolean>, // Whether this practitioner's record is in active use
  "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  on which the practitioner was born
  "photo" : [{ Attachment }], // Image of the person
  "practitionerRole" : [{ // Roles/organizations the practitioner is associated with
    "managingOrganization" : { Reference(Organization) }, // Organization where the roles are performed
    "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 provides for this role's Organization/Location(s)
  }],
  "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

Name Flags Card. Type Description & Constraints doco
.. Practitioner DomainResource A person with a formal responsibility in the provisioning of healthcare or related services
... identifier Σ 0..* Identifier A identifier for the person as this agent
... active Σ 0..1 boolean Whether this practitioner's record is in active use
... name Σ 0..1 HumanName A name associated with the person
... telecom Σ 0..* ContactPoint A contact detail for the practitioner
... address Σ 0..* Address Where practitioner can be found/visited
... gender Σ 0..1 code male | female | other | unknown
AdministrativeGender ( Required )
... birthDate Σ 0..1 date The date on which the practitioner was born
... photo 0..* Attachment Image of the person
... practitionerRole 0..* BackboneElement Roles/organizations the practitioner is associated with
.... managingOrganization 0..1 Reference ( Organization ) Organization where the roles are performed
.... role Σ 0..1 CodeableConcept Roles which this practitioner may perform
PractitionerRole ( Example )
.... specialty Σ 0..* CodeableConcept Specific specialty of the practitioner
PractitionerSpecialty ( Example )
.... period Σ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
.... location 0..* Reference ( Location ) The location(s) at which this practitioner provides care
.... healthcareService 0..* Reference ( HealthcareService ) The list of healthcare services that this worker provides for this role's Organization/Location(s)
... qualification 0..* BackboneElement Qualifications obtained by training and certification
.... identifier 0..* Identifier An identifier for this qualification for the practitioner
.... code 1..1 CodeableConcept Coded representation of the qualification
ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2 ( Example )
.... period 0..1 Period Period during which the qualification is valid
.... issuer 0..1 Reference ( Organization ) Organization that regulates and issues the qualification
... communication 0..* CodeableConcept A language the practitioner is able to use in patient communication
Language ( Required )

doco Documentation for this format

UML Diagram

Practitioner ( DomainResource ) An identifier that applies to this person in this role identifier : Identifier [0..*] Whether this practitioner's record is in active use active : boolean [0..1] A name associated with the person name : HumanName [0..1] A contact detail for the practitioner, e.g. a telephone number or an email address telecom : ContactPoint [0..*] The postal address where the practitioner can be found or visited or to which mail can be delivered address : Address [0..*] Administrative Gender - the gender that the person is considered to have for administration and record keeping purposes gender : code [0..1] « The gender of a person used for administrative purposes. (Strength=Required) AdministrativeGender ! » The date of birth for the practitioner birthDate : date [0..1] Image of the person photo : Attachment [0..*] A language the practitioner is able to use in patient communication communication : CodeableConcept 0..* << [0..*] « A human language language. (Strength=Required) Language ! » PractitionerRole The organization where the Practitioner performs the roles associated managingOrganization >> : Reference [0..1] « Organization » Roles which this practitioner is authorized to perform for the organization role : CodeableConcept [0..1] « The role a person plays representing an organization (Strength=Example) PractitionerRole ?? » Specific specialty of the practitioner specialty : CodeableConcept [0..*] « Specific specialty associated with the agency (Strength=Example) PractitionerSpecialty ?? » The period during which the person is authorized to act as a practitioner in these role(s) for the organization period : Period [0..1] The location(s) at which this practitioner provides care location : Reference [0..*] « Location » The list of healthcare services that this worker provides for this role's Organization/Location(s) healthcareService : Reference [0..*] « HealthcareService » Qualification An identifier that applies to this person's qualification in this role identifier : Identifier [0..*] Coded representation of the qualification code : CodeableConcept 1..1 << [1..1] « Specific qualification the practitioner has to provide a service (Strength=Example) Qualification ANZSCO -- Australian and New ... >> ?? » Period during which the qualification is valid period : Period 0..1 [0..1] Organization that regulates and issues the qualification issuer : Resource Reference ( [0..1] « Organization ) 0..1 » The list of roles/organizations that the practitioner is associated with practitionerRole [0..*] Qualifications obtained by training and certification qualification 0..* [0..*] This resource is referenced by AdverseReaction , Alert , AllergyIntolerance , CarePlan , Composition , Condition , DiagnosticOrder , DiagnosticReport , DocumentManifest , DocumentReference , Encounter , Group , ImagingStudy , Immunization , List , Media , MedicationAdministration , MedicationDispense , MedicationPrescription , MessageHeader , Observation , Order , OrderResponse , Other , Patient , Procedure , Questionnaire , SecurityEvent , Specimen and Supply

XML Template

< <!-- from --> <</identifier> <</name> <</telecom> <</address> <</gender> < <</photo> <</organization> <</role> <</specialty> < The period during which the practitioner is authorized to perform in these role(s)</period> < The location(s) at which this practitioner provides care</location> 
<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>
 <active value="[boolean]"/><!-- 0..1 Whether this practitioner's record is in active use -->
 <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  on which the practitioner was born -->
 <photo><!-- 0..* Attachment Image of the person --></photo>
 <practitionerRole>  <!-- 0..* Roles/organizations the practitioner is associated with -->
  <managingOrganization><!-- 0..1 Reference(Organization) Organization where the roles are performed --></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 provides for this role's Organization/Location(s) --></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>
  <
      Organization that regulates and issues the qualification</issuer>

  <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>

 <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
  "active" : <boolean>, // Whether this practitioner's record is in active use
  "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  on which the practitioner was born
  "photo" : [{ Attachment }], // Image of the person
  "practitionerRole" : [{ // Roles/organizations the practitioner is associated with
    "managingOrganization" : { Reference(Organization) }, // Organization where the roles are performed
    "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 provides for this role's Organization/Location(s)
  }],
  "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.3.4.1 5.4.4.1 Terminology Bindings

Path Definition Type Reference
Practitioner.gender The gender of a person used for administrative purposes purposes. Incomplete Required http://hl7.org/fhir/vs/administrative-gender AdministrativeGender
Practitioner.role Practitioner.practitionerRole.role The role a person plays representing an organization Example http://hl7.org/fhir/vs/practitioner-role PractitionerRole
Practitioner.specialty Practitioner.practitionerRole.specialty Specific specialty associated with the agency Example http://hl7.org/fhir/vs/practitioner-specialty PractitionerSpecialty
Practitioner.qualification.code Specific qualification the practitioner has to provide a service Example http://hl7.org/fhir/vs/anzsco-occupations ANZSCO -- Australian and New Zealand Standard Classification of Occupations, 2013, Version 1.2
Practitioner.communication A human language language. Incomplete Required IETF language tag

5.3.5 5.4.5 Notes:

  • Practitioner.organization is optional, so it can be used to represent self-employed professionals. 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.3.6 5.4.6 Search Parameters

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

Name Type Description Paths
_id address string An address in any kind of address/part Practitioner.address
address-city string A city specified in an address Practitioner.address.city
address-country string A country specified in an address Practitioner.address.country
address-postalcode string A postalCode specified in an address Practitioner.address.postalCode
address-state string A state specified in an address Practitioner.address.state
address-use token The logical resource id associated with the resource (must be supported by all servers) A use code specified in an address Practitioner.address.use
_language communication token The language One of the resource languages that the practitioner can communicate with Practitioner.communication
address email string token An address A value in any kind of address/part an email contact Practitioner.address Practitioner.telecom(system=email)
family string A portion of the family name Practitioner.name Practitioner.name.family
gender token Gender of the practitioner Practitioner.gender
given string A portion of the given name Practitioner.name Practitioner.name.given
identifier token A practitioner's Identifier Practitioner.identifier
location reference One of the locations at which this practitioner provides care Practitioner.practitionerRole.location
( Location )
name string A portion of either family or given name Practitioner.name
organization reference The identity of the organization the practitioner represents / acts on behalf of Practitioner.organization Practitioner.practitionerRole.managingOrganization
( Organization )
phone token A value in a phone contact Practitioner.telecom(system=phone)
phonetic string A portion of either family or given name using some kind of phonetic matching algorithm Practitioner.name
role token The practitioner can perform this role at for the organization Practitioner.practitionerRole.role
specialty token The practitioner has this specialty at an organization Practitioner.practitionerRole.specialty
telecom string token The value in any kind of contact Practitioner.telecom
var disqus_shortname = 'fhirdstu';(function() {var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true;dsq.src = '//' + disqus_shortname + '.disqus.com/embed.js';(document.getElementsByTagName('head')[0] || document.getElementsByTagName('body')[0]).appendChild(dsq); })(); Please enable JavaScript to view the comments powered by Disqus. comments powered by Disqus var _gaq = _gaq || []; _gaq.push(['_setAccount', 'UA-676355-1']); _gaq.push(['_setDomainName', '.hl7.org']); _gaq.push(['_trackPageview']); (function()