eHealth Infrastructure (v2019.5.3)

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 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.

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”

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 Jun 07 11:10:06 UTC 2019 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..*A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action.
... extension 0..*ExtensionSlice: Unordered, Open by value:url
... ehealth-organization-relatedTo 0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... type 0..*CodeableConceptBinding: OrganizationType (required)
... name 1..1string
... telecom 0..*ContactPointA contact detail for the organization.
.... system 0..1codeBinding: ContactPointSystem (required)
.... value 1..1string
... partOf 0..1Reference(eHealth Organization) {r}
... contact 0..*BackboneElementContact for the organization for a certain purpose.
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact.
..... extension 0..*ExtensionSlice: Unordered, Open by value:url
..... ehealth-organization-telecomCustodian 0..*codeThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
Binding: ContactPointCustodian (required)
..... ehealth-organization-telecomSystem 1..1codeType 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
Binding: ContactPointSystem (required)
..... 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}

doco Documentation for this format

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization I0..*A 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)
... 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 0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... 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: OrganizationType (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: ContactPointSystem (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..*codeThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
Binding: ContactPointCustodian (required)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... url 1..1uriidentifies the meaning of the extension
...... value[x] 0..1base64Binary, boolean, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference(), SampledData, Signature, Timing, MetaValue of extension
..... ehealth-organization-telecomSystem 1..1codeType 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
Binding: ContactPointSystem (required)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... url 1..1uriidentifies the meaning of the extension
...... value[x] 0..1base64Binary, boolean, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference(), SampledData, Signature, Timing, MetaValue of extension
..... 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
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... url 1..1uriidentifies the meaning of the extension
...... value[x] 0..1base64Binary, boolean, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference(), SampledData, Signature, Timing, MetaValue of extension
..... 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..*A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action.
... extension 0..*ExtensionSlice: Unordered, Open by value:url
... ehealth-organization-relatedTo 0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... type 0..*CodeableConceptBinding: OrganizationType (required)
... name 1..1string
... telecom 0..*ContactPointA contact detail for the organization.
.... system 0..1codeBinding: ContactPointSystem (required)
.... value 1..1string
... partOf 0..1Reference(eHealth Organization) {r}
... contact 0..*BackboneElementContact for the organization for a certain purpose.
.... telecom 0..*ContactPointContact details (telephone, email, etc.) for a contact.
..... extension 0..*ExtensionSlice: Unordered, Open by value:url
..... ehealth-organization-telecomCustodian 0..*codeThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
Binding: ContactPointCustodian (required)
..... ehealth-organization-telecomSystem 1..1codeType 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
Binding: ContactPointSystem (required)
..... 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}

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Organization I0..*A 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)
... 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 0..*(Complex)Relations to other Organizations
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-relatedTo
... 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: OrganizationType (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: ContactPointSystem (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..*codeThe custodian that maintains the contact point: SOR | ORG | MAN
URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-organization-telecomCustodian
Binding: ContactPointCustodian (required)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... url 1..1uriidentifies the meaning of the extension
...... value[x] 0..1base64Binary, boolean, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference(), SampledData, Signature, Timing, MetaValue of extension
..... ehealth-organization-telecomSystem 1..1codeType 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
Binding: ContactPointSystem (required)
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... url 1..1uriidentifies the meaning of the extension
...... value[x] 0..1base64Binary, boolean, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference(), SampledData, Signature, Timing, MetaValue of extension
..... 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
...... id 0..1stringxml:id (or equivalent in JSON)
...... extension 0..*ExtensionAdditional Content defined by implementations
Slice: Unordered, Open by value:url
...... url 1..1uriidentifies the meaning of the extension
...... value[x] 0..1base64Binary, boolean, code, date, dateTime, decimal, id, instant, integer, markdown, oid, positiveInt, string, time, unsignedInt, uri, Address, Age, Annotation, Attachment, CodeableConcept, Coding, ContactPoint, Count, Distance, Duration, HumanName, Identifier, Money, Period, Quantity, Range, Ratio, Reference(), SampledData, Signature, Timing, MetaValue of extension
..... 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

PathNameConformanceValueSet
Organization.languageCommon LanguagesextensibleCommon Languages
Organization.typeOrganizationTyperequiredOrganizationType
Organization.telecom.systemContactPointSystemrequiredContactPointSystem
Organization.telecom.useContactPointUserequiredContactPointUse
Organization.contact.purposeContactEntityTypeextensibleContactEntityType
Organization.contact.telecom.useContactPointUserequiredContactPointUse

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
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())
.