PractitionerFacilityAffiliation
An affiliation between a practitioner and a healthcare facility. Links practitioners to the facilities and departments where they practice, with role and time period information.
Overview
PractitionerFacilityAffiliation represents the working relationship between a healthcare provider and a facility. Practitioners often work at multiple facilities - a cardiologist might have privileges at several hospitals and clinics. Each affiliation specifies the facility, department, role, time period, and whether it's the practitioner's primary location. This enables accurate scheduling, credentialing, and provider directory functionality.
Key Concepts
Affiliation Components
Each affiliation record contains:
| Field | Purpose | Example |
|---|---|---|
practitioner | The affiliated provider | Dr. Michael Chen |
facility | Healthcare facility | City General Hospital |
department | Department within facility | Cardiology Department |
role | Role at this location | Physician |
period | Active dates | 2015-06-01 to present |
isPrimary | Main practice location | true |
Multiple Affiliations
Practitioners commonly have multiple affiliations:
Hospital Staff
- Primary hospital affiliation
- Consulting privileges at other hospitals
- Clinic or ambulatory locations
Multi-Site Clinics
- Main clinic location
- Satellite offices
- Telehealth coverage
Role at Location
The role field via HealthReferencePractitionerRole may vary by location:
- Physician at one facility, Medical Director at another
- Staff nurse at hospital, Nurse Practitioner at clinic
Primary Affiliation
The isPrimary flag indicates:
- Main practice location for scheduling
- Primary contact point for referrals
- Default facility for documentation
Only one affiliation should be marked primary at a time.
Active Period
The period via Period:
startDate- When affiliation beganendDate- When affiliation ended (empty if current)
Historical affiliations are retained for record-keeping.
Calculated Field
isActive - Computed boolean:
- True if current date is within period
- False if affiliation has ended
Use Cases
Provider Directory
For patient-facing search:
- Query affiliations by facility
- Filter by active affiliations only
- Show practitioners available at location
- Display role and department info
Scheduling
When booking appointments:
- Find practitioner's active affiliations
- Show available facilities
- Check department-specific availability
- Book at selected location
Credentialing
For privilege management:
- Track where practitioner has privileges
- Verify credentials at each facility
- Monitor privilege expirations
- Document privilege changes
Referral Routing
When routing referrals:
- Identify practitioner's affiliated facilities
- Route to facility matching patient location
- Consider primary affiliation preference
- Document receiving facility
Staff Management
For facility administration:
- Query all practitioners at facility
- Filter by department
- Track staffing levels by role
- Plan coverage schedules
Historical Records
For audit and compliance:
- Retain ended affiliations
- Document affiliation history
- Track facility changes
- Support credentialing audits
Related Entities
| Entity | Relationship | Description |
|---|---|---|
| Practitioner | References | The affiliated healthcare provider |
| Facility | References | The healthcare facility |
| FacilityDepartment | References | Department within the facility |
| HealthReferencePractitionerRole | References | Role at this affiliation |
| Period | Contains | Time period of affiliation |
Calculated Fields
| Field | Type | Description |
|---|---|---|
isActive | boolean | True if current date is within the affiliation period |
Properties
| Property | Type | Mode | Description | Required |
|---|---|---|---|---|
| practitioner | Practitioner | stored | Practitioner affiliated with the facility | Required |
| facility | Facility | stored | Healthcare facility where the practitioner practices | Required |
| department | FacilityDepartment | stored | Department within the facility | Optional |
| role | HealthReferencePractitionerRole | stored | Role at this facility/department | Required |
| period | Period | stored | Period during which this affiliation is active | Optional |
| isPrimary | boolean | stored | Whether this is the practitioner's primary facility Example: | Optional |
| isActive | boolean | calculated | Whether the affiliation is currently active | Optional |
Examples
Example 1
{
"@type": "PractitionerFacilityAffiliation",
"practitioner": {
"@type": "Practitioner",
"givenName": "Michael",
"familyName": "Chen"
},
"facility": {
"@type": "Facility",
"name": "City General Hospital"
},
"department": {
"@type": "FacilityDepartment",
"name": "Cardiology Department",
"type": {
"@type": "HealthReferenceDepartmentType",
"code": "CARDIO",
"label": "Cardiology"
}
},
"role": {
"@type": "HealthReferencePractitionerRole",
"code": "PHYSICIAN",
"label": "Physician"
},
"period": {
"@type": "Period",
"startDate": "2015-06-01"
},
"isPrimary": true
}Example 2
{
"@type": "PractitionerFacilityAffiliation",
"practitioner": {
"@type": "Practitioner",
"givenName": "Michael",
"familyName": "Chen"
},
"facility": {
"@type": "Facility",
"name": "Downtown Medical Clinic"
},
"department": {
"@type": "FacilityDepartment",
"name": "Cardiology Unit",
"type": {
"@type": "HealthReferenceDepartmentType",
"code": "CARDIO",
"label": "Cardiology"
}
},
"role": {
"@type": "HealthReferencePractitionerRole",
"code": "PHYSICIAN",
"label": "Physician"
},
"period": {
"@type": "Period",
"startDate": "2020-01-15"
},
"isPrimary": false
}Example 3
{
"@type": "PractitionerFacilityAffiliation",
"practitioner": {
"@type": "Practitioner",
"givenName": "Sarah",
"familyName": "Johnson"
},
"facility": {
"@type": "Facility",
"name": "City General Hospital"
},
"department": {
"@type": "FacilityDepartment",
"name": "Emergency Department",
"type": {
"@type": "HealthReferenceDepartmentType",
"code": "ER",
"label": "Emergency"
}
},
"role": {
"@type": "HealthReferencePractitionerRole",
"code": "NURSE",
"label": "Nurse"
},
"period": {
"@type": "Period",
"startDate": "2018-09-01"
},
"isPrimary": true
}Example 4
{
"@type": "PractitionerFacilityAffiliation",
"practitioner": {
"@type": "Practitioner",
"givenName": "Sarah",
"familyName": "Johnson"
},
"facility": {
"@type": "Facility",
"name": "City General Hospital"
},
"department": {
"@type": "FacilityDepartment",
"name": "ICU",
"type": {
"@type": "HealthReferenceDepartmentType",
"code": "ICU",
"label": "Intensive Care Unit"
}
},
"role": {
"@type": "HealthReferencePractitionerRole",
"code": "NURSE_PRACTITIONER",
"label": "Nurse Practitioner"
},
"period": {
"@type": "Period",
"startDate": "2022-01-01"
},
"isPrimary": false
}