StructureDefinition-UKCore-Organization

Canonical_URLCurrent_VersionLast_UpdatedDescription
https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization2.4.02023-04-28

This profile defines the UK constraints and extensions on the International FHIR resource Organization.


Profile_Purpose

This profile allows exchange of a formally or informally recognised grouping of people or organisations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc.

mainLocationI0..*Extension(Reference(UK Core Location))
url1..1System.StringFixed Value
valuePeriodPeriod
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ1..1uriFixed Value
valueΣ1..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
activeΣ ?!0..1boolean
typeΣ0..*CodeableConceptBinding
nameΣ I0..1string
alias0..*string
telecomI0..*ContactPoint
addressI0..*Address
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string
purpose0..1CodeableConceptBinding
name0..1HumanName
telecomI0..*ContactPoint
address0..1Address
referenceΣ I0..1string
typeΣ0..1uriBinding
useΣ ?!0..1codeBinding
typeΣ0..1CodeableConceptBinding
systemΣ0..1uri
valueΣ0..1string
periodΣ I0..1Period
assignerΣ I0..1Reference(UK Core Organization)
displayΣ0..1string

Table View

Organization..
Organization.extension..
Organization.extensionExtension..
Organization.extensionExtension0..1
Organization.extension.value[x]..
Organization.identifier..
Organization.identifier..1
Organization.identifier.system1..
Organization.identifier.value1..
Organization.identifier.assignerReference(UK Core Organization)..
Organization.identifier..1
Organization.identifier.system1..
Organization.identifier.value1..
Organization.identifier.assignerReference(UK Core Organization)..
Organization.type..
Organization.partOfReference(UK Core Organization)..
Organization.partOf.identifier..
Organization.partOf.identifier.assignerReference(UK Core Organization)..
Organization.endpoint..
Organization.endpoint.identifier..
Organization.endpoint.identifier.assignerReference(UK Core Organization)..


XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="UKCore-Organization" />
    <url value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
    <version value="2.4.0" />
    <name value="UKCoreOrganization" />
    <title value="UK Core Organization" />
    <status value="active" />
    <date value="2023-04-28" />
    <publisher value="HL7 UK" />
    <contact>
        <name value="HL7 UK" />
        <telecom>
            <system value="email" />
            <value value="ukcore@hl7.org.uk" />
            <use value="work" />
            <rank value="1" />
        </telecom>
    </contact>
    <description value="This profile defines the UK constraints and extensions on the International FHIR resource [Organization](https://hl7.org/fhir/R4/Organization.html)." />
    <purpose value="This profile allows exchange of a formally or informally recognised grouping of people or organisations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc." />
    <copyright value="Copyright &#169; 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the &quot;License&quot;); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an &quot;AS IS&quot; BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7&#174; FHIR&#174; standard Copyright &#169; 2011+ HL7 The HL7&#174; FHIR&#174; standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html." />
    <fhirVersion value="4.0.1" />
    <mapping>
        <identity value="v2" />
        <uri value="http://hl7.org/v2" />
        <name value="HL7 v2 Mapping" />
    </mapping>
    <mapping>
        <identity value="rim" />
        <uri value="http://hl7.org/v3" />
        <name value="RIM Mapping" />
    </mapping>
    <mapping>
        <identity value="servd" />
        <uri value="http://www.omg.org/spec/ServD/1.0/" />
        <name value="ServD" />
    </mapping>
    <mapping>
        <identity value="w5" />
        <uri value="http://hl7.org/fhir/fivews" />
        <name value="FiveWs Pattern Mapping" />
    </mapping>
    <kind value="resource" />
    <abstract value="false" />
    <type value="Organization" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Organization" />
    <derivation value="constraint" />
    <differential>
        <element id="Organization.extension">
            <path value="Organization.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <rules value="open" />
            </slicing>
        </element>
        <element id="Organization.extension:mainLocation">
            <path value="Organization.extension" />
            <sliceName value="mainLocation" />
            <short value="Main location" />
            <definition value="The main location of the organisation." />
            <type>
                <code value="Extension" />
                <profile value="https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MainLocation" />
            </type>
        </element>
        <element id="Organization.extension:organizationPeriod">
            <path value="Organization.extension" />
            <sliceName value="organizationPeriod" />
            <short value="The date range that this organization SHOULD be considered available." />
            <definition value="The date range that this organization SHOULD be considered available." />
            <min value="0" />
            <max value="1" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/StructureDefinition/organization-period" />
            </type>
        </element>
        <element id="Organization.extension:organizationPeriod.value[x]">
            <path value="Organization.extension.value[x]" />
            <short value="The date range that this organization SHOULD be considered available." />
            <definition value="The date range that this organization SHOULD be considered available." />
        </element>
        <element id="Organization.identifier">
            <path value="Organization.identifier" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="system" />
                </discriminator>
                <ordered value="false" />
                <rules value="open" />
            </slicing>
        </element>
        <element id="Organization.identifier:odsOrganisationCode">
            <path value="Organization.identifier" />
            <sliceName value="odsOrganisationCode" />
            <short value="Organisation Data Service code" />
            <definition value="Identifier code supplier by the Organisation Data Service." />
            <max value="1" />
        </element>
        <element id="Organization.identifier:odsOrganisationCode.system">
            <path value="Organization.identifier.system" />
            <min value="1" />
            <fixedUri value="https://fhir.nhs.uk/Id/ods-organization-code" />
        </element>
        <element id="Organization.identifier:odsOrganisationCode.value">
            <path value="Organization.identifier.value" />
            <min value="1" />
        </element>
        <element id="Organization.identifier:odsOrganisationCode.assigner">
            <path value="Organization.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="Organization.identifier:odsSiteCode">
            <path value="Organization.identifier" />
            <sliceName value="odsSiteCode" />
            <short value="ODS Site code to identify the organisation at site level" />
            <definition value="ODS Site code to identify the organisation at site level." />
            <max value="1" />
        </element>
        <element id="Organization.identifier:odsSiteCode.system">
            <path value="Organization.identifier.system" />
            <min value="1" />
            <fixedUri value="https://fhir.nhs.uk/Id/ods-site-code" />
        </element>
        <element id="Organization.identifier:odsSiteCode.value">
            <path value="Organization.identifier.value" />
            <min value="1" />
        </element>
        <element id="Organization.identifier:odsSiteCode.assigner">
            <path value="Organization.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="Organization.type">
            <path value="Organization.type" />
            <binding>
                <strength value="extensible" />
                <description value="A set of concepts indicating the organisation type, derived from the base CodeSystem, and Genomics specific concepts" />
                <valueSet value="https://fhir.hl7.org.uk/ValueSet/UKCore-OrganizationType" />
            </binding>
        </element>
        <element id="Organization.partOf">
            <path value="Organization.partOf" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="Organization.partOf.identifier.assigner">
            <path value="Organization.partOf.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
        <element id="Organization.endpoint.identifier.assigner">
            <path value="Organization.endpoint.identifier.assigner" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization" />
            </type>
        </element>
    </differential>
</StructureDefinition>

JSON View

{
    "resourceType": "StructureDefinition",
    "id": "UKCore-Organization",
    "url": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization",
    "version": "2.4.0",
    "name": "UKCoreOrganization",
    "title": "UK Core Organization",
    "status": "active",
    "date": "2023-04-28",
    "publisher": "HL7 UK",
    "contact":  [
        {
            "name": "HL7 UK",
            "telecom":  [
                {
                    "system": "email",
                    "value": "ukcore@hl7.org.uk",
                    "use": "work",
                    "rank": 1
                }
            ]
        }
    ],
    "description": "This profile defines the UK constraints and extensions on the International FHIR resource [Organization](https://hl7.org/fhir/R4/Organization.html).",
    "purpose": "This profile allows exchange of a formally or informally recognised grouping of people or organisations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc.",
    "copyright": "Copyright © 2021+ HL7 UK Licensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at  http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. HL7® FHIR® standard Copyright © 2011+ HL7 The HL7® FHIR® standard is used under the FHIR license. You may obtain a copy of the FHIR license at  https://www.hl7.org/fhir/license.html.",
    "fhirVersion": "4.0.1",
    "mapping":  [
        {
            "identity": "v2",
            "uri": "http://hl7.org/v2",
            "name": "HL7 v2 Mapping"
        },
        {
            "identity": "rim",
            "uri": "http://hl7.org/v3",
            "name": "RIM Mapping"
        },
        {
            "identity": "servd",
            "uri": "http://www.omg.org/spec/ServD/1.0/",
            "name": "ServD"
        },
        {
            "identity": "w5",
            "uri": "http://hl7.org/fhir/fivews",
            "name": "FiveWs Pattern Mapping"
        }
    ],
    "kind": "resource",
    "abstract": false,
    "type": "Organization",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Organization",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Organization.extension",
                "path": "Organization.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "rules": "open"
                }
            },
            {
                "id": "Organization.extension:mainLocation",
                "path": "Organization.extension",
                "sliceName": "mainLocation",
                "short": "Main location",
                "definition": "The main location of the organisation.",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/Extension-UKCore-MainLocation"
                        ]
                    }
                ]
            },
            {
                "id": "Organization.extension:organizationPeriod",
                "path": "Organization.extension",
                "sliceName": "organizationPeriod",
                "short": "The date range that this organization SHOULD be considered available.",
                "definition": "The date range that this organization SHOULD be considered available.",
                "min": 0,
                "max": "1",
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/StructureDefinition/organization-period"
                        ]
                    }
                ]
            },
            {
                "id": "Organization.extension:organizationPeriod.value[x]",
                "path": "Organization.extension.value[x]",
                "short": "The date range that this organization SHOULD be considered available.",
                "definition": "The date range that this organization SHOULD be considered available."
            },
            {
                "id": "Organization.identifier",
                "path": "Organization.identifier",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "system"
                        }
                    ],
                    "ordered": false,
                    "rules": "open"
                }
            },
            {
                "id": "Organization.identifier:odsOrganisationCode",
                "path": "Organization.identifier",
                "sliceName": "odsOrganisationCode",
                "short": "Organisation Data Service code",
                "definition": "Identifier code supplier by the Organisation Data Service.",
                "max": "1"
            },
            {
                "id": "Organization.identifier:odsOrganisationCode.system",
                "path": "Organization.identifier.system",
                "min": 1,
                "fixedUri": "https://fhir.nhs.uk/Id/ods-organization-code"
            },
            {
                "id": "Organization.identifier:odsOrganisationCode.value",
                "path": "Organization.identifier.value",
                "min": 1
            },
            {
                "id": "Organization.identifier:odsOrganisationCode.assigner",
                "path": "Organization.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Organization.identifier:odsSiteCode",
                "path": "Organization.identifier",
                "sliceName": "odsSiteCode",
                "short": "ODS Site code to identify the organisation at site level",
                "definition": "ODS Site code to identify the organisation at site level.",
                "max": "1"
            },
            {
                "id": "Organization.identifier:odsSiteCode.system",
                "path": "Organization.identifier.system",
                "min": 1,
                "fixedUri": "https://fhir.nhs.uk/Id/ods-site-code"
            },
            {
                "id": "Organization.identifier:odsSiteCode.value",
                "path": "Organization.identifier.value",
                "min": 1
            },
            {
                "id": "Organization.identifier:odsSiteCode.assigner",
                "path": "Organization.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Organization.type",
                "path": "Organization.type",
                "binding": {
                    "strength": "extensible",
                    "description": "A set of concepts indicating the organisation type, derived from the base CodeSystem, and Genomics specific concepts",
                    "valueSet": "https://fhir.hl7.org.uk/ValueSet/UKCore-OrganizationType"
                }
            },
            {
                "id": "Organization.partOf",
                "path": "Organization.partOf",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Organization.partOf.identifier.assigner",
                "path": "Organization.partOf.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Organization.endpoint.identifier.assigner",
                "path": "Organization.endpoint.identifier.assigner",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Organization"
                        ]
                    }
                ]
            }
        ]
    }
}

Examples

General Practice - Example to illustrate a General Practice organisation.
Example UKCore-Organization-WhiteRoseMedicalCentre

Hospital - Example to illustrate a Hospital organisation.
Example UKCore-Organization-LeedsTeachingHospital

Main Location - Example to illustrate the mainLocation extension.
Example UKCore-Extension-MainLocation

Organization Period - Example to illustrate the core-defined organization-period extension.
Example UKCore-Extension-OrganizationPeriod

Example Usage Scenarios

  • Query for organisation information using the query parameter identifier Organization.identifier for a known ODS code.
  • Exchange organisation information within a FHIR document or message.

Profile Specific Implementation Guidance:

Minimum Viable Content

A minimum viable content that all provider and consumer systems SHALL support are the following elements.

Element Reason
Organization.identifier Identifies this organization across multiple systems
Organization.identifier.system a URL that describes a set values that are unique.
Organization.identifier.value The value that is unique
Organization.active Whether the organization's record is still in active use
Organization.name A name associated with the organization.
Organization.telecom A contact detail for the organization.
Organization.address An address for the organization.

Extensions

More information about the extensions can be found using the links below.

Extension Context Link Comment
mainLocation Organization Extension UKCore-MainLocation
organizationPeriod Organization Core-defined Extension organization-period

Bindings (differential)

More information about the bindings to UK Core ValueSets can be found below.

Context Strength Link
Organization.type Extensible ValueSet UKCore-OrganizationType

identifier

It is recommended that the Organization.identifier value is odsOrganisationCode, but another identifier can be used.

The organisation ODS code

Element Description
Organization.identifier:odsOrganisationCode.use usual | official | temp | secondary | old (If known)
Organization.identifier:odsOrganisationCode.type This is not required with ODS
Organization.identifier:odsOrganisationCode.system The url is https://fhir.nhs.uk/Id/ods-organisation-code
Organization.identifier:odsOrganisationCode.value The ODS code
Organization.identifier:odsOrganisationCode.period The period for which the code is valid - MAY be omitted
Organization.identifier:odsOrganisationCode.assigner Implicit for ODS codes - SHOULD be omitted

The ODS site code for a specific site in the organisation

Element Description
Organization.identifier:odsSiteCode.use usual | official | temp | secondary | old (If known)
Organization.identifier:odsSiteCode.type This is not required with ODS
Organization.identifier:odsSiteCode.system The url is https://fhir.nhs.uk/Id/ods-site-code
Organization.identifier:odsSiteCode.value The ODS site code
Organization.identifier:odsSiteCode.period The period for which the code is valid - MAY be omitted
Organization.identifier:odsSiteCode.assigner Implicit for ODS site codes - SHOULD be omitted

telecom

A contact detail (e.g. a telephone number or an email address) by which the organisation may be contacted.

Telecom uses the ContactPoint datatype.


address

The address of the organisation using the Address datatype.


partOf

The resource being referenced SHALL conform to the Profile UKCore-Organization.