eHealth Infrastructure (v2020.4)

StructureDefinition: ehealth-organization

Introduction

An Organizations is a formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, etc.

Scope and Usage

In scope of the eHealth infrastructure Organizations are limited to represent organizations in the Danish healthcare system as defined by the national health organization registry, SOR, and the joint municipalities IT community (KOMBIT) Support System Organisation, STS-ORG.

From these sources Organizations are automatically imported into the eHealth infrastructure. It is not the intention that users of the infrastructure should create any other Organization resources.

For SSL supplier organizations not maintained by the SOR or STS-ORG registries, it is possible to manually create and maintain these organizations.

Identifiers

Organizations are imported into the eHealth infrastructure from SOR and STS-ORG. This means that organisations can have different identifiers depending on the source system. For some organisations (for instance SSL suppliers), organizations can use a business registration number (CVR number) as identifier.

  • SOR-ID: “urn:oid:1.2.208.176.1.1”
  • KOMBIT STS-ORG-ID: “https://www.kombit.dk/sts/organisation”
  • CVR number: “urn:oid:2.16.840.1.113883.2.24.1.1”

Organizations created manually are not allowed to have identifiers of types SOR-ID or KOMBIT STS-ORG-ID.

Source

The origin of an Organization is maintained in the extension organization-source which currently has the following concepts:

  • SOR for an organisation imported from SOR
  • STS-ORG for an organisation imported from STS-ORG
  • manual for a manually created organisation

Import and merge

SOR supplies a list of updates each night. These updates will be merged into the existing organisation resources in the database.

STS-ORG provides a number of webservices where the newest organisation data can be fetched.

Contact information can be edited/added both in the integration platform and in the source systems. To ensure that no information is lost during merge, each ContactPoint will be tagged with a custodian element marking which system currently maintains it. When merging information from a given source, the ContactPoint elements with a different custodian will not be affected.

Relations to other organizations

It is possible to relate Organization resources to other Organization resources using the extension element relatedTo.

The intention with this element is to relate Organizations to other Organizations imported from another source. For instance to relate Organizations imported from SOR to similar Organizations imported from STS-ORG.

Hierarchical relations between Organizations imported from the same source are expressed using the partOf element.

Semantics of a relation between organizations

Relations between Organizations which are expressed using the extension element relatedTo have uni-directional semantics.

As an example this implies at that if two representations of the exact same Organization are imported from two different sources, then both could have a relatedTo element with the other Organization as target, and a relation type of e.g. “sameAs”.

Formal Views of Profile Content

The official URL for this profile is:

http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization

This profile builds on Organization.

This profile was published on Fri May 22 12:11:22 UTC 2020 as a draft by ehealth.sundhed.dk.

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization 0..*OrganizationA formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action.
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... ehealth-organization-relatedTo 0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... ehealth-organization-cvrNumber 0..1stringThe organization's identification code in the danish "Centrale Virksomhedsregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-cvrNumber
... ehealth-organization-regionCode 0..1stringThe organization's region code
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-regionCode
... ehealth-organization-municipalityCode 0..1stringThe organization's municipality code in the danish "Det Centrale Personregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-municipalityCode
... ehealth-organization-source 1..1CodeableConceptThe organization's source
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-source
... ehealth-organization-synchronizationStatus 1..1CodeableConceptThe organization's synchronization status
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-synchronizationStatus
... ehealth-organization-providerIdentifier 0..1stringThe organization's provider identifier
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-providerIdentifier
... ehealth-organization-specialty 0..*CodeableConceptThe organization's specialty
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-specialty
... type 0..*CodeableConceptKind of organization
Binding: Organization Type (required)
... name 1..1stringName used for the organization
... telecom 0..*ContactPointA contact detail for the organization.
.... system 0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPoint System (required)
.... value 1..1stringThe actual contact point details
... partOf 0..1Reference(eHealth Organization) {r}The organization of which this organization forms a part
... contact 0..*BackboneElementContact for the organization for a certain purpose.
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact.
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... ehealth-organization-telecomCustodian 0..*CodeableConceptThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
..... ehealth-organization-telecomSystem 1..1CodeableConceptType of communications system required to make use of the contact point: phone | fax | email | pager | url | sms | ean | other
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomSystem
..... ehealth-organization-telecomValue 1..1stringThe actual contact point details (i.e. phone number or email address)
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomValue
..... system 0..0
..... value 0..0
... endpoint 0..*Reference(Endpoint) {r}Technical endpoints providing access to services operated for the organization

doco Documentation for this format

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization I0..*OrganizationA formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action.
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
Max Binding: All Languages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... ehealth-organization-relatedTo I0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... ehealth-organization-cvrNumber I0..1stringThe organization's identification code in the danish "Centrale Virksomhedsregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-cvrNumber
... ehealth-organization-regionCode I0..1stringThe organization's region code
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-regionCode
... ehealth-organization-municipalityCode I0..1stringThe organization's municipality code in the danish "Det Centrale Personregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-municipalityCode
... ehealth-organization-source I1..1CodeableConceptThe organization's source
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-source
... ehealth-organization-synchronizationStatus I1..1CodeableConceptThe organization's synchronization status
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-synchronizationStatus
... ehealth-organization-providerIdentifier I0..1stringThe organization's provider identifier
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-providerIdentifier
... ehealth-organization-specialty I0..*CodeableConceptThe organization's specialty
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-specialty
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..*IdentifierIdentifies this organization across multiple systems
... active ?!Σ0..1booleanWhether the organization's record is still in active use
... type Σ0..*CodeableConceptKind of organization
Binding: Organization Type (required)
... name ΣI1..1stringName used for the organization
... alias 0..*stringA list of alternate names that the organization is known as, or was known as in the past
... telecom I0..*ContactPointA contact detail for the organization.
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... system ΣI0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPoint System (required)
.... value Σ1..1stringThe actual contact point details
.... use ?!Σ0..1codehome | work | temp | old | mobile - purpose of this contact point
Binding: ContactPointUse (required)
.... rank Σ0..1positiveIntSpecify preferred order of use (1 = highest)
.... period Σ0..1PeriodTime period when the contact point was/is in use
... address I0..*AddressAn address for the organization
org-2: An address of an organization can never be of use 'home'
... partOf Σ0..1Reference(eHealth Organization) {r}The organization of which this organization forms a part
... contact I0..*BackboneElementContact for the organization for a certain purpose.
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible)
.... name 0..1HumanNameA name associated with the contact
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact.
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... ehealth-organization-telecomCustodian 0..*CodeableConceptThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
..... ehealth-organization-telecomSystem 1..1CodeableConceptType of communications system required to make use of the contact point: phone | fax | email | pager | url | sms | ean | other
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomSystem
..... ehealth-organization-telecomValue 1..1stringThe actual contact point details (i.e. phone number or email address)
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomValue
..... use ?!Σ0..1codehome | work | temp | old | mobile - purpose of this contact point
Binding: ContactPointUse (required)
..... rank Σ0..1positiveIntSpecify preferred order of use (1 = highest)
..... period Σ0..1PeriodTime period when the contact point was/is in use
.... address 0..1AddressVisiting or postal addresses for the contact
... endpoint 0..*Reference(Endpoint) {r}Technical endpoints providing access to services operated for the organization

doco Documentation for this format

Differential View

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization 0..*OrganizationA formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action.
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... ehealth-organization-relatedTo 0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... ehealth-organization-cvrNumber 0..1stringThe organization's identification code in the danish "Centrale Virksomhedsregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-cvrNumber
... ehealth-organization-regionCode 0..1stringThe organization's region code
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-regionCode
... ehealth-organization-municipalityCode 0..1stringThe organization's municipality code in the danish "Det Centrale Personregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-municipalityCode
... ehealth-organization-source 1..1CodeableConceptThe organization's source
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-source
... ehealth-organization-synchronizationStatus 1..1CodeableConceptThe organization's synchronization status
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-synchronizationStatus
... ehealth-organization-providerIdentifier 0..1stringThe organization's provider identifier
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-providerIdentifier
... ehealth-organization-specialty 0..*CodeableConceptThe organization's specialty
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-specialty
... type 0..*CodeableConceptKind of organization
Binding: Organization Type (required)
... name 1..1stringName used for the organization
... telecom 0..*ContactPointA contact detail for the organization.
.... system 0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPoint System (required)
.... value 1..1stringThe actual contact point details
... partOf 0..1Reference(eHealth Organization) {r}The organization of which this organization forms a part
... contact 0..*BackboneElementContact for the organization for a certain purpose.
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact.
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... ehealth-organization-telecomCustodian 0..*CodeableConceptThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
..... ehealth-organization-telecomSystem 1..1CodeableConceptType of communications system required to make use of the contact point: phone | fax | email | pager | url | sms | ean | other
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomSystem
..... ehealth-organization-telecomValue 1..1stringThe actual contact point details (i.e. phone number or email address)
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomValue
..... system 0..0
..... value 0..0
... endpoint 0..*Reference(Endpoint) {r}Technical endpoints providing access to services operated for the organization

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization I0..*OrganizationA formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action.
... id Σ0..1idLogical id of this artifact
... meta Σ0..1MetaMetadata about the resource
... implicitRules ?!Σ0..1uriA set of rules under which this content was created
... language 0..1codeLanguage of the resource content
Binding: Common Languages (extensible)
Max Binding: All Languages
... text I0..1NarrativeText summary of the resource, for human interpretation
... contained 0..*ResourceContained, inline Resources
... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
... ehealth-organization-relatedTo I0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... ehealth-organization-cvrNumber I0..1stringThe organization's identification code in the danish "Centrale Virksomhedsregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-cvrNumber
... ehealth-organization-regionCode I0..1stringThe organization's region code
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-regionCode
... ehealth-organization-municipalityCode I0..1stringThe organization's municipality code in the danish "Det Centrale Personregister"
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-municipalityCode
... ehealth-organization-source I1..1CodeableConceptThe organization's source
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-source
... ehealth-organization-synchronizationStatus I1..1CodeableConceptThe organization's synchronization status
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-synchronizationStatus
... ehealth-organization-providerIdentifier I0..1stringThe organization's provider identifier
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-providerIdentifier
... ehealth-organization-specialty I0..*CodeableConceptThe organization's specialty
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-specialty
... modifierExtension ?!0..*ExtensionExtensions that cannot be ignored
... identifier ΣI0..*IdentifierIdentifies this organization across multiple systems
... active ?!Σ0..1booleanWhether the organization's record is still in active use
... type Σ0..*CodeableConceptKind of organization
Binding: Organization Type (required)
... name ΣI1..1stringName used for the organization
... alias 0..*stringA list of alternate names that the organization is known as, or was known as in the past
... telecom I0..*ContactPointA contact detail for the organization.
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
.... system ΣI0..1codephone | fax | email | pager | url | sms | other
Binding: ContactPoint System (required)
.... value Σ1..1stringThe actual contact point details
.... use ?!Σ0..1codehome | work | temp | old | mobile - purpose of this contact point
Binding: ContactPointUse (required)
.... rank Σ0..1positiveIntSpecify preferred order of use (1 = highest)
.... period Σ0..1PeriodTime period when the contact point was/is in use
... address I0..*AddressAn address for the organization
org-2: An address of an organization can never be of use 'home'
... partOf Σ0..1Reference(eHealth Organization) {r}The organization of which this organization forms a part
... contact I0..*BackboneElementContact for the organization for a certain purpose.
.... id 0..1stringxml:id (or equivalent in JSON)
.... extension 0..*ExtensionAdditional Content defined by implementations
.... modifierExtension ?!Σ0..*ExtensionExtensions that cannot be ignored
.... purpose 0..1CodeableConceptThe type of contact
Binding: ContactEntityType (extensible)
.... name 0..1HumanNameA name associated with the contact
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact.
..... id 0..1stringxml:id (or equivalent in JSON)
..... extension 0..*ExtensionExtension
Slice: Unordered, Open by value:url
..... ehealth-organization-telecomCustodian 0..*CodeableConceptThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
..... ehealth-organization-telecomSystem 1..1CodeableConceptType of communications system required to make use of the contact point: phone | fax | email | pager | url | sms | ean | other
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomSystem
..... ehealth-organization-telecomValue 1..1stringThe actual contact point details (i.e. phone number or email address)
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomValue
..... use ?!Σ0..1codehome | work | temp | old | mobile - purpose of this contact point
Binding: ContactPointUse (required)
..... rank Σ0..1positiveIntSpecify preferred order of use (1 = highest)
..... period Σ0..1PeriodTime period when the contact point was/is in use
.... address 0..1AddressVisiting or postal addresses for the contact
... endpoint 0..*Reference(Endpoint) {r}Technical endpoints providing access to services operated for the organization

doco Documentation for this format

 

Terminology Bindings

PathConformanceValueSet
Organization.languageextensibleCommon Languages
Max Binding: All Languages
Organization.typerequiredOrganizationType
Organization.telecom.systemrequiredContactPointSystem
Organization.telecom.userequiredContactPointUse
Organization.contact.purposeextensibleContactEntityType
Organization.contact.telecom.userequiredContactPointUse

Constraints

IdPathDetailsRequirements
dom-2OrganizationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-1OrganizationIf the resource is contained in another resource, it SHALL NOT contain any narrative
: contained.text.empty()
dom-4OrganizationIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-3OrganizationIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource
: contained.where(('#'+id in %resource.descendants().reference).not()).empty()
org-1OrganizationThe organization SHALL at least have a name or an id, and possibly more than one
: (identifier.count() + name.count()) > 0
ele-1Organization.extension:relatedToAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:relatedToMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:cvrNumberAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:cvrNumberMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:regionCodeAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:regionCodeMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:municipalityCodeAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:municipalityCodeMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:sourceAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:sourceMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:synchronizationStatusAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:synchronizationStatusMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:providerIdentifierAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:providerIdentifierMust have either extensions or value[x], not both
: extension.exists() != value.exists()
ele-1Organization.extension:specialtyAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
ext-1Organization.extension:specialtyMust have either extensions or value[x], not both
: extension.exists() != value.exists()
org-3Organization.telecomThe telecom of an organization can never be of use 'home'
: where(use = 'home').empty()
org-2Organization.addressAn address of an organization can never be of use 'home'
: where(use = 'home').empty()
ele-1Organization.contactAll FHIR elements must have a @value or children
: hasValue() | (children().count() > id.count())
.