Organizational structure

Chaining

Building a hierarchy

The Organization.partOf element is used to create a chain of organizational units. The reference element SHALL be used with a relative reference in the format "Organization/" with logical ID being the logical ID of the organization if the organizational unit is directly under the organization, otherwise of the parent organizational unit.

{
    "resourceType": "Organization",
    "id": "13458e22-bb24-4879-b537-7833680c5f34",
    "partOf": {
        "reference": "Organization/b948f8fb-5f8e-40de-9b9a-6e92a61148f7"
    },
    [...]
}

The partOf element SHALL only reference the closest parent organizational unit or organization. An organization or organizational unit can have multiple organizational units as direct children.

Modifying a hierarchy

Certain changes to an organization or an organizational unit must imply changes to other organizational units of the hierarchy, if there are any, in order to maintain a valid organizational hierarchy. These types of changes SHALL not be allowed to be requested using PUT operations on instances as it risks introducing inconsistent data.

Inactivate organization or organizational unit

When inactivating an organization or an organizational unit, any organizational units below it shall also become inactive. The picture below illustrates that when inactivating organizational unit "Vaccinationskliniken", also the child units "Mottagning Norra" and "Mottagning Södra" must be inactivated. This shall be done using the Set End Date For Organization Hierarchy operation.

Move organizational unit

Type markers

An instance of Organization cannot conform to both HVOOrganization and HVOOrganizationalUnit profiles - i.e. one instance cannot be marked as e.g. both healthcare provider and healthcare unit. A healthcare provider that is also a healthcare unit should be expressed using two instances - one with the healthcare provider marker and one with the healthcare unit marker.

Marking a Organization - HVOOrganization as a healthcare provider is done by using the Snomed CT code 143591000052106.

{
    "resourceType": "Organization",
    "type": [
        {
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "143591000052106"
                }
            ]
        }
    ],
    [...]
}

Note that a HVOOrganization can have multiple type markings, if the organization is for example a provider of both healthcare and social services (all permitted values are found in the value set Typ av organisation (hvo-organization-type)). Multiple type markings SHALL be expressed as multiple values of Organization.type, as seen below, and not as multiple values of Organization.type.coding.

{
    "resourceType": "Organization",
    "type": [
        {
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "143591000052106"
                }
            ]
        },
            "coding": [
                {
                    "system": "http://snomed.info/sct",
                    "code": "654081000052102"
                }
            ]
    ],
    [...]
}

Healthcare unit

In a branch of organizational units, only one can have the healthcare unit marker. Nested healthcare units SHALL not be allowed.