HealthReferencePractitionerRole

Reference data entity for professional roles and position types of healthcare practitioners. Defines the job function a practitioner performs regardless of their medical specialty.

Overview

HealthReferencePractitionerRole categorizes healthcare workers by their professional function. While HealthReferencePractitionerSpecialty defines clinical expertise areas, this entity defines the type of position (physician, nurse, pharmacist, technician). A cardiologist has specialty "Cardiology" but role "Physician". This distinction enables proper credentialing, scope of practice, and workforce management.

Key Concepts

Role vs Specialty

Understanding the distinction:

ConceptEntityExamples
RolePractitionerRolePhysician, Nurse, Pharmacist
SpecialtyPractitionerSpecialtyCardiology, Pediatrics, Oncology

A practitioner has one primary role but may have multiple specialties.

Role Categories

Roles are grouped by professional domain:

CategoryDescriptionExample Roles
medicalLicensed physiciansPhysician, Surgeon, Radiologist
nursingNursing professionalsNurse, Nurse Practitioner, Midwife
allied-healthOther clinical professionalsPharmacist, Physiotherapist, Psychologist
technicalTechnical support staffLab Technician, Radiology Tech
administrativeNon-clinical staffMedical Coder, Administrator

Standard Roles

Medical Roles

  • PHYSICIAN - Licensed medical doctor (MD/DO)
  • SURGEON - Physician specializing in surgery
  • RADIOLOGIST - Physician specializing in imaging

Nursing Roles

  • NURSE - Registered Nurse (RN)
  • NURSE_PRACTITIONER - Advanced practice nurse (APRN)
  • MIDWIFE - Certified nurse-midwife

Allied Health Roles

  • PHARMACIST - Licensed pharmacist
  • PHYSIOTHERAPIST - Physical therapist
  • PSYCHOLOGIST - Licensed psychologist

Technical Roles

  • LAB_TECHNICIAN - Medical laboratory technologist

Role Identification

Each role record contains:

  • code - Unique role code (e.g., "PHYSICIAN", "NURSE")
  • label - Human-readable name
  • category - Professional domain
  • description - Role details and scope

Use Cases

Credentialing

When verifying practitioner credentials:

  1. Identify practitioner's role type
  2. Verify appropriate licensure for role
  3. Check role-specific certifications
  4. Validate scope of practice
  5. Document credential verification

Order Authorization

When validating clinical orders:

  1. Check ordering provider's role
  2. Verify role can place this order type
  3. Apply role-based ordering rules
  4. Require co-signature if needed
  5. Route for appropriate approval

Scheduling

For appointment scheduling:

  1. Match patient need to appropriate role
  2. Filter available providers by role
  3. Consider role-specific visit durations
  4. Apply role-based scheduling rules

Workforce Planning

For staffing decisions:

  1. Track staff counts by role category
  2. Identify role coverage gaps
  3. Plan recruitment by role needs
  4. Monitor role ratios (nurse-to-patient)

Access Control

For system permissions:

  1. Assign base permissions by role
  2. Apply role-specific feature access
  3. Restrict sensitive data by role
  4. Audit access by role category

Related Entities

EntityRelationshipDescription
PractitionerReferenced byPractitioners assigned this role
HealthReferencePractitionerSpecialtyComplementsMedical specialties (separate from role)

Enums

category

ValueDescription
medicalLicensed physicians and surgeons (MD, DO, MBBS)
nursingNursing professionals at all levels (RN, LPN, NP, CNM)
allied-healthNon-physician clinical professionals (pharmacists, therapists, psychologists)
technicalClinical technical and laboratory staff
administrativeNon-clinical administrative and support roles
otherRoles not fitting other categories
4 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
codestring
stored

Unique code identifying the role

Example: "PHYSICIAN"

Required
labelstring
stored

Human-readable name of the role

Example: "Physician"

Required
categorystring
stored

Category of practitioner role

Values: medical, nursing, allied-health, technical, administrative, other

Example: "medical"

Required
descriptionstring
stored

Additional details about the role

Optional

Examples

Example 1

{
  "@type": "HealthReferencePractitionerRole",
  "code": "PHYSICIAN",
  "label": "Physician",
  "category": "medical",
  "description": "Licensed medical doctor"
}

Example 2

{
  "@type": "HealthReferencePractitionerRole",
  "code": "SURGEON",
  "label": "Surgeon",
  "category": "medical",
  "description": "Physician specialized in surgical procedures"
}

Example 3

{
  "@type": "HealthReferencePractitionerRole",
  "code": "NURSE",
  "label": "Nurse",
  "category": "nursing",
  "description": "Registered nursing professional"
}

Example 4

{
  "@type": "HealthReferencePractitionerRole",
  "code": "NURSE_PRACTITIONER",
  "label": "Nurse Practitioner",
  "category": "nursing",
  "description": "Advanced practice registered nurse"
}

Example 5

{
  "@type": "HealthReferencePractitionerRole",
  "code": "PHARMACIST",
  "label": "Pharmacist",
  "category": "allied-health",
  "description": "Licensed pharmacy professional"
}

Example 6

{
  "@type": "HealthReferencePractitionerRole",
  "code": "PHYSIOTHERAPIST",
  "label": "Physiotherapist",
  "category": "allied-health",
  "description": "Physical therapy professional"
}

Example 7

{
  "@type": "HealthReferencePractitionerRole",
  "code": "PSYCHOLOGIST",
  "label": "Psychologist",
  "category": "allied-health",
  "description": "Mental health professional"
}

Example 8

{
  "@type": "HealthReferencePractitionerRole",
  "code": "RADIOLOGIST",
  "label": "Radiologist",
  "category": "medical",
  "description": "Medical imaging specialist"
}

Example 9

{
  "@type": "HealthReferencePractitionerRole",
  "code": "LAB_TECHNICIAN",
  "label": "Laboratory Technician",
  "category": "technical",
  "description": "Medical laboratory professional"
}

Example 10

{
  "@type": "HealthReferencePractitionerRole",
  "code": "MIDWIFE",
  "label": "Midwife",
  "category": "nursing",
  "description": "Childbirth and maternal care specialist"
}