R5 Final QA

This page is part of the FHIR Specification (v5.0.0-draft-final: Final QA Preview for R5 - see ballot notes). 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

Patient Administration icon Work GroupMaturity Level: 0 Trial UseSecurity Category: Business Compartments: Not linked to any defined compartments

Detailed Descriptions for the elements in the OrganizationAffiliation resource.

OrganizationAffiliation
Element IdOrganizationAffiliation
Definition

Defines an affiliation/association/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship.

Short DisplayDefines an affiliation/association/relationship between 2 distinct organizations, that is not a part-of relationship/sub-division relationship
Cardinality0..*
TypeDomainResource
Requirements

Need to define relationships between organizations that are not sub-divisions of the same organization (part-of relationships).

Summaryfalse
OrganizationAffiliation.identifier
Element IdOrganizationAffiliation.identifier
Definition

Business identifiers that are specific to this role.

Short DisplayBusiness identifiers that are specific to this role
NoteThis is a business identifier, not a resource identifier (see discussion)
Cardinality0..*
TypeIdentifier
Requirements

Often, specific identities are assigned for the agent.

Summarytrue
OrganizationAffiliation.active
Element IdOrganizationAffiliation.active
Definition

Whether this organization affiliation record is in active use.

Short DisplayWhether this organization affiliation record is in active use
Cardinality0..1
Typeboolean
Meaning if MissingThis resource is generally assumed to be active if no value is provided for the active element
Requirements

Need to be able to mark an organization affiliation record as not to be used because it was created in error, or otherwise no longer in active use.

Summarytrue
Comments

If this value is false, you may refer to the period to see when the role was in active use. If there is no period specified, no inference can be made about when it was active.

OrganizationAffiliation.period
Element IdOrganizationAffiliation.period
Definition

The period during which the participatingOrganization is affiliated with the primary organization.

Short DisplayThe period during which the participatingOrganization is affiliated with the primary organization
Cardinality0..1
TypePeriod
Requirements

An affiliation may be created ahead of time and only be active for a defined period of time. Once the affiliation is complete, the fact that it existed may still be required.

Summarytrue
OrganizationAffiliation.organization
Element IdOrganizationAffiliation.organization
Definition

Organization where the role is available (primary organization/has members).

Short DisplayOrganization where the role is available
Cardinality0..1
TypeReference(Organization)
Summarytrue
Comments

For example, a Spotless Cleaning Services (participatingOrganization) is a supplier (code) to General Hospital (organization). Similarly, General Hospital (participatingOrganization) is a member (code) of Eastern HIE (organization). If there are two organizations that do not have a directional relationship, there would normally be a third organization that represents the joint partnership, and the two organizations would have a relationship to that joint Organization via two OrganizationAffiliations.

OrganizationAffiliation.participatingOrganization
Element IdOrganizationAffiliation.participatingOrganization
Definition

The Participating Organization provides/performs the role(s) defined by the code to the Primary Organization (e.g. providing services or is a member of).

Short DisplayOrganization that provides/performs the role (e.g. providing services or is a member of)
Cardinality0..1
TypeReference(Organization)
Summarytrue
Comments

See comments for OrganizationAffiliation.organization above.

OrganizationAffiliation.network
Element IdOrganizationAffiliation.network
Definition

The network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined).

Short DisplayThe network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
Cardinality0..*
TypeReference(Organization)
Summarytrue
Comments

e.g. Commonly used for Health Insurance provider networks.

OrganizationAffiliation.code
Element IdOrganizationAffiliation.code
Definition

Definition of the role the participatingOrganization plays in the association.

Short DisplayDefinition of the role the participatingOrganization plays
Cardinality0..*
Terminology BindingOrganization Affiliation Role (Example)
TypeCodeableConcept
Summarytrue
OrganizationAffiliation.specialty
Element IdOrganizationAffiliation.specialty
Definition

Specific specialty of the participatingOrganization in the context of the role.

Short DisplaySpecific specialty of the participatingOrganization in the context of the role
Cardinality0..*
Terminology BindingPractice Setting Code Value Set (Preferred)
TypeCodeableConcept
Summarytrue
OrganizationAffiliation.location
Element IdOrganizationAffiliation.location
Definition

The location(s) at which the role occurs.

Short DisplayThe location(s) at which the role occurs
Cardinality0..*
TypeReference(Location)
Summarytrue
OrganizationAffiliation.healthcareService
Element IdOrganizationAffiliation.healthcareService
Definition

Healthcare services provided through the role.

Short DisplayHealthcare services provided through the role
Cardinality0..*
TypeReference(HealthcareService)
Summaryfalse
OrganizationAffiliation.contact
Element IdOrganizationAffiliation.contact
Definition

The contact details of communication devices available at the participatingOrganization relevant to this Affiliation.

Short DisplayOfficial contact details at the participatingOrganization relevant to this Affiliation
Cardinality0..*
TypeExtendedContactDetail
Requirements

Sometimes a participating organization provides dedicated contacts to handle enquiries specifically for the role provided to the affiliated organization.

Summaryfalse
Invariants
Defined on this element
org-3Rule The telecom of an organization can never be of use 'home'telecom.where(use = 'home').empty()
org-4Rule The address of an organization can never be of use 'home'address.where(use = 'home').empty()
OrganizationAffiliation.endpoint
Element IdOrganizationAffiliation.endpoint
Definition

Technical endpoints providing access to services operated for this role.

Short DisplayTechnical endpoints providing access to services operated for this role
Cardinality0..*
TypeReference(Endpoint)
Summaryfalse