This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions
Patient Administration ![]() | Maturity Level: 1 | Trial Use | Security Category: Business | Compartments: No defined compartments |
Defines an affiliation/association/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship.
A relationship between 2 organizations over a period of time, where the entities are separate business entities. The relationship can optionally include details of locations/services from the participating organization.
The OrganizationAffiliation enables defining non-hierarchical relationships between organizations. For example:
The Organization.partOf is used to form a hierarchical relationships within an organization which eventually resolves
to a single organization. Each child in the tree is a subdivision of the parent.
The OrganizationAffiliation is used to describe the relationship between two distinct organizations. It does not require
a hierarchical relationship. A resource instance is for a singular linkage between 2 organizations (it does not contain all members),
to create multiple affiliations, create additional resources for the other relationship between other organizations.
Each instance contains its own period, and optionally links to specific related services/locations that are available.
These referenced locations/services should be associated with the participating organization, and are available to the
primary organization.
This resource should not be used when the affiliates are part of a single organization.
No references for this Resource.
Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions, the spreadsheet version & the dependency analysis
Path | ValueSet | Type | Documentation |
---|---|---|---|
OrganizationAffiliation.code | OrganizationAffiliationRole | Example | This example value set defines a set of codes that can be used to indicate the role of one Organization in relation to another. |
OrganizationAffiliation.specialty | PracticeSettingCodeValueSet | Preferred | This is the code representing the clinical specialty of the clinician or provider who interacted with, treated, or provided a service to/for the patient. The value set used for clinical specialty has been limited by HITSP to the value set reproduced from HITSP C80 Table 2-149 Clinical Specialty Value Set Definition. |
UniqueKey | Level | Location | Description | Expression |
![]() | Rule | OrganizationAffiliation.contact | The telecom of an organization can never be of use 'home' | telecom.where(use = 'home').empty() |
![]() | Rule | OrganizationAffiliation.contact | The address of an organization can never be of use 'home' | address.where(use = 'home').empty() |
With a joint venture between multiple organizations, a seperate Organization is created which represents the Venture. Each Organization in the venture is created through a seperate OrganizationAffiliation resource with the telecom details provided in each being the contact point to call for enquiries relating to their affiliation in the venture.
Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
active | token | Whether this organization affiliation record is in active use | OrganizationAffiliation.active | |
date | date | The period during which the participatingOrganization is affiliated with the primary organization | OrganizationAffiliation.period | |
token | A value in an email contact | OrganizationAffiliation.contact.telecom.where(system='email') | ||
endpoint | reference | Technical endpoints providing access to services operated for this role | OrganizationAffiliation.endpoint (Endpoint) |
|
identifier | token | An organization affiliation's Identifier | OrganizationAffiliation.identifier | |
location | reference | The location(s) at which the role occurs | OrganizationAffiliation.location (Location) |
|
network | reference | Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined) | OrganizationAffiliation.network (Organization) |
|
participating-organization | reference | The organization that provides services to the primary organization | OrganizationAffiliation.participatingOrganization (Organization) |
|
phone | token | A value in a phone contact | OrganizationAffiliation.contact.telecom.where(system='phone') | |
primary-organization | reference | The organization that receives the services from the participating organization | OrganizationAffiliation.organization (Organization) |
|
role | token | Definition of the role the participatingOrganization plays | OrganizationAffiliation.code | |
service | reference | Healthcare services provided through the role | OrganizationAffiliation.healthcareService (HealthcareService) |
|
specialty | token | Specific specialty of the participatingOrganization in the context of the role | OrganizationAffiliation.specialty | |
telecom | token | The value in any kind of contact | OrganizationAffiliation.contact.telecom |