type: resourceresource: OrganizationAffiliation

OrganizationAffiliation

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:

One organization may provide services to another organization
e.g. An agency service providing casual staff, a radiology service, a diagnostic lab, catering services, community care services etc.
Two or more organizations may form a partnership or joint venture
An organization may be a member of an association, but not owned by it
e.g. a hospital is a member the American Hospital Association, a hospital is a member of a health information exchange network
Spotless Cleaning Services (participatingOrganization) is a supplier (code) to General Hospital (organization)
General Hospital (participatingOrganization) is a member (code) of Eastern HIE (organization)

Boundaries and Relationships

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.

Background and Context

Notes

Notes:

Multiple instances of an OrganizationAffilitiation may exist between the same 2 organizations if a specific combination of the other related properties is required, or has a different period of usage.
Some systems record a collection of service values for a single location, others record the single service and the list of locations it is available. Both are acceptable options for representing this data.
If the HealthcareService contains more locations than specified in the Affilition, then only those in the Affiliation are relevant in the OrganizationAffiliation, it cannot introduce new locations not covered by the HealthcareService.
Conversely if no Locations are specified, then it can be assumed that all locations are available.
For some types of affiliation the HealthcareService might not be relevant and be empty, and location could be included.

Joint Ventures

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.

StructureDefinition

Elements (Simplified)

OrganizationAffiliation [0..*]: - Defines an affiliation/association/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.identifier [0..*]: Identifier Business identifiers that are specific to this role
OrganizationAffiliation.active [0..1]: boolean Whether this organization affiliation record is in active use
OrganizationAffiliation.period [0..1]: Period The period during which the participatingOrganization is affiliated with the primary organization
OrganizationAffiliation.organization [0..1]: Reference(Organization) Organization where the role is available
OrganizationAffiliation.participatingOrganization [0..1]: Reference(Organization) Organization that provides/performs the role (e.g. providing services or is a member of)
OrganizationAffiliation.network [0..*]: Reference(Organization) The network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
OrganizationAffiliation.code [0..*]: CodeableConcept example:organization-role Definition of the role the participatingOrganization plays
OrganizationAffiliation.specialty [0..*]: CodeableConcept example:c80-practice-codes Specific specialty of the participatingOrganization in the context of the role
OrganizationAffiliation.location [0..*]: Reference(Location) The location(s) at which the role occurs
OrganizationAffiliation.healthcareService [0..*]: Reference(HealthcareService) Healthcare services provided through the role
OrganizationAffiliation.contact [0..*]: ExtendedContactDetail Official contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint [0..*]: Reference(Endpoint) Technical endpoints providing access to services operated for this role

Mappings

OrganizationAffiliation Mappings — 17 mapping entries

Implementation Guide

implementationguide-OrganizationAffiliation-core.xml

<?xml version="1.0" encoding="UTF-8"?>

<ImplementationGuide xmlns="http://hl7.org/fhir">
  <id value="OrganizationAffiliation-core"/>
  <version value="0.01"/>
  <name value="OrganizationAffiliationHL7Extensions"/>
  <title value="Organization Affiliation  H L7  Extensions"/>
  <status value="draft"/>
  <date value="1970-01-01T10:00:00+10:00"/>
  <publisher value="HL7"/>
  <description value="Defines common extensions used with or related to the OrganizationAffiliation resource"/>
</ImplementationGuide>

Resource Packs

list-OrganizationAffiliation-packs.xml

<?xml version="1.0" encoding="UTF-8"?>

<List xmlns="http://hl7.org/fhir">
  <id value="OrganizationAffiliation-packs"/>
  <status value="current"/>
  <mode value="working"/>
  <entry>
    <item>
      <reference value="ImplementationGuide/OrganizationAffiliation-core"/>
    </item>
  </entry>
</List>

Search Parameters

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
email — 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
identifier — token — An organization affiliation's Identifier — OrganizationAffiliation.identifier
location — reference — The location(s) at which the role occurs — OrganizationAffiliation.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
participating-organization — reference — The organization that provides services to the primary organization — OrganizationAffiliation.participatingOrganization
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
role — token — Definition of the role the participatingOrganization plays — OrganizationAffiliation.code
service — reference — Healthcare services provided through the role — OrganizationAffiliation.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

Full Search Parameters

Examples

example — organizationaffiliation-example — HL7 Payer Network services for Acme Hospital
organizationaffiliation-example — organizationaffiliation-example
organizationaffiliation-examples-general — organizationaffiliation-examples-general
organizationaffiliation-examples-header — organizationaffiliation-examples-header
orgrole1 — orgrole-example-services — Provider of rehabilitation services
orgrole2 — orgrole-example-hie — Hospital member

Full Examples

FiveWs.status → OrganizationAffiliation.active

Unmapped Elements

FiveWs.what — Unknown
FiveWs.recorded — Unknown
FiveWs.author — Unknown
FiveWs.actor — Unknown
FiveWs.cause — Unknown
FiveWs.version — Unknown
FiveWs.witness — Unknown
FiveWs.class — Unknown
FiveWs.context — Unknown
FiveWs.init — Unknown
FiveWs.why — Unknown
FiveWs.source — Unknown
FiveWs.who — Unknown
FiveWs.grade — Unknown
FiveWs.planned — Unknown
FiveWs.subject — Unknown