Implementation Guide
Telematikinfrastruktur (TI) Common
Version 1.2.0 - release

Resource Profile: TI Organization

Official URL: https://gematik.de/fhir/ti/StructureDefinition/ti-organization Version: 1.1.1
Active as of 2025-09-12 Computable Name: TIOrganization

Copyright/Legal: gematik GmbH / Dieses Artefakt ist lizenziert unter Apache License, Version 2.0.

Definiert die Datenstruktur für medizinische, regulatorische und technische Organisationen

Usages:

  • This Profile is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: dom-2, dom-3, dom-4, dom-5, dom-6, org-1
... id SΣ 0..1 id Logical id of this artifact
... meta SΣ 0..1 Meta Metadata about the resource
.... versionId SΣ 0..1 id Version specific identifier
.... lastUpdated SΣ 0..1 instant When the resource version last changed
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
.... extension:ncpehCountryEx S 0..1 Coding National Contact Point of Health (NCPeH) Country Extension
URL: https://gematik.de/fhir/ti/StructureDefinition/ncpeh-country-extension
Binding: Iso3166-1-2 (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
Slice: Unordered, Open by value:url
... Slices for identifier SΣC 0..* Identifier Identifies this organization across multiple systems
Slice: Unordered, Open by pattern:system
.... identifier:TelematikID SΣC 0..1 IdentifierTelematikId Identifies this organization across multiple systems
.... identifier:BSNR SΣC 0..1 IdentifierBsnr Identifies this organization across multiple systems
.... identifier:KZVA SΣC 0..1 IdentifierKzva Identifies this organization across multiple systems
.... identifier:IKNR SΣC 0..* IdentifierIknr Identifies this organization across multiple systems
... active ?!SΣ 0..1 boolean Whether the organization's record is still in active use
... Slices for type SΣ 0..* CodeableConcept Kind of organization
Slice: Unordered, Open by pattern:$this
Binding: OrganizationType (example): Used to categorize the organization.
.... type:providerType SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Types (required)
.... type:profession SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Profession Type OIDs (required)
... name SΣC 1..1 string Name used for the organization
... alias S 0..* string A list of alternate names that the organization is known as, or was known as in the past
... telecom C 0..* ContactPoint A contact detail for the organization
Constraints: cpt-2, org-3
... address SC 0..* Address An address for the organization
Constraints: org-2
.... use ?!SΣ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
.... text SΣ 0..1 string Text representation of the address
Example General: 137 Nowhere Street, Erewhon 9132
.... line SΣ 0..* string Street name, number, direction & P.O. Box etc.
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
.... city SΣ 0..1 string Name of city, town etc.
Example General: Erewhon
.... state SΣ 0..1 string Sub-unit of country (abbreviations ok)
.... postalCode SΣ 0..1 string Postal code for area
Example General: 9132
.... country SΣ 0..1 string Country (e.g. can be ISO 3166 2 or 3 letter code)
... partOf SΣC 0..1 Reference(Organization) The organization of which this organization forms a part
Constraints: ref-1
... contact S 0..* BackboneElement Contact for the organization for a certain purpose
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.type Base example Organization type 📍4.0.1 FHIR Std.
Organization.type:providerType Base required TI Organization Types 📦1.0.7 TI Terminology v1.0
Organization.type:profession Base required TI Organization Profession Type OIDs 📦1.0.7 TI Terminology v1.0
Organization.address.​use Base required AddressUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cpt-2 error Organization.telecom A system is required if a value is provided. value.empty() or system.exists()
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization If 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-2 error Organization.address An address of an organization can never be of use 'home' where(use = 'home').empty()
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()
ref-1 error Organization.partOf SHALL have a contained resource if a local reference is provided reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization 0..* Organization A grouping of people or organizations with a common purpose
... id S 0..1 id Logical id of this artifact
... meta S 0..1 Meta Metadata about the resource
.... versionId S 0..1 id Version specific identifier
.... lastUpdated S 0..1 instant When the resource version last changed
... Slices for extension Content/Rules for all slices
.... extension:ncpehCountryEx S 0..1 Coding National Contact Point of Health (NCPeH) Country Extension
URL: https://gematik.de/fhir/ti/StructureDefinition/ncpeh-country-extension
Binding: Iso3166-1-2 (required)
.... identifier:TelematikID S 0..1 IdentifierTelematikId Identifies this organization across multiple systems
.... identifier:BSNR S 0..1 IdentifierBsnr Identifies this organization across multiple systems
.... identifier:KZVA S 0..1 IdentifierKzva Identifies this organization across multiple systems
.... identifier:IKNR S 0..* IdentifierIknr Identifies this organization across multiple systems
... active S 0..1 boolean Whether the organization's record is still in active use
... Slices for type S 0..* CodeableConcept Kind of organization
Slice: Unordered, Open by pattern:$this
.... type:providerType S 0..* CodeableConcept Kind of organization
Binding: TI Organization Types (required)
.... type:profession S 0..* CodeableConcept Kind of organization
Binding: TI Organization Profession Type OIDs (required)
... name S 1..1 string Name used for the organization
... alias S 0..* string A list of alternate names that the organization is known as, or was known as in the past
... address S 0..* Address An address for the organization
.... use S 0..1 code home | work | temp | old | billing - purpose of this address
.... text S 0..1 string Text representation of the address
.... line S 0..* string Street name, number, direction & P.O. Box etc.
.... city S 0..1 string Name of city, town etc.
.... state S 0..1 string Sub-unit of country (abbreviations ok)
.... postalCode S 0..1 string Postal code for area
.... country S 0..1 string Country (e.g. can be ISO 3166 2 or 3 letter code)
... partOf S 0..1 Reference(Organization) The organization of which this organization forms a part
... contact S 0..* BackboneElement Contact for the organization for a certain purpose

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Organization.type:providerType Base required TI Organization Types 📦1.0.7 TI Terminology v1.0
Organization.type:profession Base required TI Organization Profession Type OIDs 📦1.0.7 TI Terminology v1.0
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: dom-2, dom-3, dom-4, dom-5, dom-6, org-1
... id SΣ 0..1 id Logical id of this artifact
... meta SΣ 0..1 Meta Metadata about the resource
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... versionId SΣ 0..1 id Version specific identifier
.... lastUpdated SΣ 0..1 instant When the resource version last changed
.... source Σ 0..1 uri Identifies where the resource comes from
.... profile Σ 0..* canonical(StructureDefinition) Profiles this resource claims to conform to
.... security Σ 0..* Coding Security Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
.... tag Σ 0..* Coding Tags applied to this resource
Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:ncpehCountryEx S 0..1 Coding National Contact Point of Health (NCPeH) Country Extension
URL: https://gematik.de/fhir/ti/StructureDefinition/ncpeh-country-extension
Binding: Iso3166-1-2 (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
Slice: Unordered, Open by value:url
... Slices for identifier SΣC 0..* Identifier Identifies this organization across multiple systems
Slice: Unordered, Open by pattern:system
.... identifier:TelematikID SΣC 0..1 IdentifierTelematikId Identifies this organization across multiple systems
.... identifier:BSNR SΣC 0..1 IdentifierBsnr Identifies this organization across multiple systems
.... identifier:KZVA SΣC 0..1 IdentifierKzva Identifies this organization across multiple systems
.... identifier:IKNR SΣC 0..* IdentifierIknr Identifies this organization across multiple systems
... active ?!SΣ 0..1 boolean Whether the organization's record is still in active use
... Slices for type SΣ 0..* CodeableConcept Kind of organization
Slice: Unordered, Open by pattern:$this
Binding: OrganizationType (example): Used to categorize the organization.
.... type:providerType SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Types (required)
.... type:profession SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Profession Type OIDs (required)
... name SΣC 1..1 string Name used for the organization
... alias S 0..* string A list of alternate names that the organization is known as, or was known as in the past
... telecom C 0..* ContactPoint A contact detail for the organization
Constraints: cpt-2, org-3
... address SC 0..* Address An address for the organization
Constraints: org-2
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!SΣ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
.... type Σ 0..1 code postal | physical | both
Binding: AddressType (required): The type of an address (physical / postal).
Example General: both
.... text SΣ 0..1 string Text representation of the address
Example General: 137 Nowhere Street, Erewhon 9132
.... line SΣ 0..* string Street name, number, direction & P.O. Box etc.
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
.... city SΣ 0..1 string Name of city, town etc.
Example General: Erewhon
.... district Σ 0..1 string District name (aka county)
Example General: Madison
.... state SΣ 0..1 string Sub-unit of country (abbreviations ok)
.... postalCode SΣ 0..1 string Postal code for area
Example General: 9132
.... country SΣ 0..1 string Country (e.g. can be ISO 3166 2 or 3 letter code)
.... period ΣC 0..1 Period Time period when address was/is in use
Constraints: per-1
Example General: {"start":"2010-03-23","end":"2010-07-01"}
... partOf SΣC 0..1 Reference(Organization) The organization of which this organization forms a part
Constraints: ref-1
... contact S 0..* BackboneElement Contact for the organization for a certain purpose
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... purpose 0..1 CodeableConcept The type of contact
Binding: ContactEntityType (extensible): The purpose for which you would contact a contact party.
.... name 0..1 HumanName A name associated with the contact
.... telecom C 0..* ContactPoint Contact details (telephone, email, etc.) for a contact
Constraints: cpt-2
.... address 0..1 Address Visiting or postal addresses for the contact
... endpoint C 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the organization
Constraints: ref-1

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.meta.security Base extensible SecurityLabels 📍4.0.1 FHIR Std.
Organization.meta.tag Base example Common Tags 📍4.0.1 FHIR Std.
Organization.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Organization.type Base example Organization type 📍4.0.1 FHIR Std.
Organization.type:providerType Base required TI Organization Types 📦1.0.7 TI Terminology v1.0
Organization.type:profession Base required TI Organization Profession Type OIDs 📦1.0.7 TI Terminology v1.0
Organization.address.​use Base required AddressUse 📍4.0.1 FHIR Std.
Organization.address.​type Base required AddressType 📍4.0.1 FHIR Std.
Organization.contact.​purpose Base extensible Contact entity type 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cpt-2 error Organization.telecom, Organization.contact.telecom A system is required if a value is provided. value.empty() or system.exists()
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization If 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-2 error Organization.address An address of an organization can never be of use 'home' where(use = 'home').empty()
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()
per-1 error Organization.address.period If present, start SHALL have a lower value than end start.hasValue().not() or end.hasValue().not() or (start <= end)
ref-1 error Organization.partOf, Organization.endpoint SHALL have a contained resource if a local reference is provided reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

This structure is derived from Organization

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: dom-2, dom-3, dom-4, dom-5, dom-6, org-1
... id SΣ 0..1 id Logical id of this artifact
... meta SΣ 0..1 Meta Metadata about the resource
.... versionId SΣ 0..1 id Version specific identifier
.... lastUpdated SΣ 0..1 instant When the resource version last changed
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
.... extension:ncpehCountryEx S 0..1 Coding National Contact Point of Health (NCPeH) Country Extension
URL: https://gematik.de/fhir/ti/StructureDefinition/ncpeh-country-extension
Binding: Iso3166-1-2 (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
Slice: Unordered, Open by value:url
... Slices for identifier SΣC 0..* Identifier Identifies this organization across multiple systems
Slice: Unordered, Open by pattern:system
.... identifier:TelematikID SΣC 0..1 IdentifierTelematikId Identifies this organization across multiple systems
.... identifier:BSNR SΣC 0..1 IdentifierBsnr Identifies this organization across multiple systems
.... identifier:KZVA SΣC 0..1 IdentifierKzva Identifies this organization across multiple systems
.... identifier:IKNR SΣC 0..* IdentifierIknr Identifies this organization across multiple systems
... active ?!SΣ 0..1 boolean Whether the organization's record is still in active use
... Slices for type SΣ 0..* CodeableConcept Kind of organization
Slice: Unordered, Open by pattern:$this
Binding: OrganizationType (example): Used to categorize the organization.
.... type:providerType SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Types (required)
.... type:profession SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Profession Type OIDs (required)
... name SΣC 1..1 string Name used for the organization
... alias S 0..* string A list of alternate names that the organization is known as, or was known as in the past
... telecom C 0..* ContactPoint A contact detail for the organization
Constraints: cpt-2, org-3
... address SC 0..* Address An address for the organization
Constraints: org-2
.... use ?!SΣ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
.... text SΣ 0..1 string Text representation of the address
Example General: 137 Nowhere Street, Erewhon 9132
.... line SΣ 0..* string Street name, number, direction & P.O. Box etc.
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
.... city SΣ 0..1 string Name of city, town etc.
Example General: Erewhon
.... state SΣ 0..1 string Sub-unit of country (abbreviations ok)
.... postalCode SΣ 0..1 string Postal code for area
Example General: 9132
.... country SΣ 0..1 string Country (e.g. can be ISO 3166 2 or 3 letter code)
... partOf SΣC 0..1 Reference(Organization) The organization of which this organization forms a part
Constraints: ref-1
... contact S 0..* BackboneElement Contact for the organization for a certain purpose
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.type Base example Organization type 📍4.0.1 FHIR Std.
Organization.type:providerType Base required TI Organization Types 📦1.0.7 TI Terminology v1.0
Organization.type:profession Base required TI Organization Profession Type OIDs 📦1.0.7 TI Terminology v1.0
Organization.address.​use Base required AddressUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cpt-2 error Organization.telecom A system is required if a value is provided. value.empty() or system.exists()
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization If 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-2 error Organization.address An address of an organization can never be of use 'home' where(use = 'home').empty()
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()
ref-1 error Organization.partOf SHALL have a contained resource if a local reference is provided reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

Differential View

This structure is derived from Organization

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization 0..* Organization A grouping of people or organizations with a common purpose
... id S 0..1 id Logical id of this artifact
... meta S 0..1 Meta Metadata about the resource
.... versionId S 0..1 id Version specific identifier
.... lastUpdated S 0..1 instant When the resource version last changed
... Slices for extension Content/Rules for all slices
.... extension:ncpehCountryEx S 0..1 Coding National Contact Point of Health (NCPeH) Country Extension
URL: https://gematik.de/fhir/ti/StructureDefinition/ncpeh-country-extension
Binding: Iso3166-1-2 (required)
.... identifier:TelematikID S 0..1 IdentifierTelematikId Identifies this organization across multiple systems
.... identifier:BSNR S 0..1 IdentifierBsnr Identifies this organization across multiple systems
.... identifier:KZVA S 0..1 IdentifierKzva Identifies this organization across multiple systems
.... identifier:IKNR S 0..* IdentifierIknr Identifies this organization across multiple systems
... active S 0..1 boolean Whether the organization's record is still in active use
... Slices for type S 0..* CodeableConcept Kind of organization
Slice: Unordered, Open by pattern:$this
.... type:providerType S 0..* CodeableConcept Kind of organization
Binding: TI Organization Types (required)
.... type:profession S 0..* CodeableConcept Kind of organization
Binding: TI Organization Profession Type OIDs (required)
... name S 1..1 string Name used for the organization
... alias S 0..* string A list of alternate names that the organization is known as, or was known as in the past
... address S 0..* Address An address for the organization
.... use S 0..1 code home | work | temp | old | billing - purpose of this address
.... text S 0..1 string Text representation of the address
.... line S 0..* string Street name, number, direction & P.O. Box etc.
.... city S 0..1 string Name of city, town etc.
.... state S 0..1 string Sub-unit of country (abbreviations ok)
.... postalCode S 0..1 string Postal code for area
.... country S 0..1 string Country (e.g. can be ISO 3166 2 or 3 letter code)
... partOf S 0..1 Reference(Organization) The organization of which this organization forms a part
... contact S 0..* BackboneElement Contact for the organization for a certain purpose

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Organization.type:providerType Base required TI Organization Types 📦1.0.7 TI Terminology v1.0
Organization.type:profession Base required TI Organization Profession Type OIDs 📦1.0.7 TI Terminology v1.0

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Organization C 0..* Organization A grouping of people or organizations with a common purpose
Constraints: dom-2, dom-3, dom-4, dom-5, dom-6, org-1
... id SΣ 0..1 id Logical id of this artifact
... meta SΣ 0..1 Meta Metadata about the resource
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... versionId SΣ 0..1 id Version specific identifier
.... lastUpdated SΣ 0..1 instant When the resource version last changed
.... source Σ 0..1 uri Identifies where the resource comes from
.... profile Σ 0..* canonical(StructureDefinition) Profiles this resource claims to conform to
.... security Σ 0..* Coding Security Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
.... tag Σ 0..* Coding Tags applied to this resource
Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... extension:ncpehCountryEx S 0..1 Coding National Contact Point of Health (NCPeH) Country Extension
URL: https://gematik.de/fhir/ti/StructureDefinition/ncpeh-country-extension
Binding: Iso3166-1-2 (required)
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
Slice: Unordered, Open by value:url
... Slices for identifier SΣC 0..* Identifier Identifies this organization across multiple systems
Slice: Unordered, Open by pattern:system
.... identifier:TelematikID SΣC 0..1 IdentifierTelematikId Identifies this organization across multiple systems
.... identifier:BSNR SΣC 0..1 IdentifierBsnr Identifies this organization across multiple systems
.... identifier:KZVA SΣC 0..1 IdentifierKzva Identifies this organization across multiple systems
.... identifier:IKNR SΣC 0..* IdentifierIknr Identifies this organization across multiple systems
... active ?!SΣ 0..1 boolean Whether the organization's record is still in active use
... Slices for type SΣ 0..* CodeableConcept Kind of organization
Slice: Unordered, Open by pattern:$this
Binding: OrganizationType (example): Used to categorize the organization.
.... type:providerType SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Types (required)
.... type:profession SΣ 0..* CodeableConcept Kind of organization
Binding: TI Organization Profession Type OIDs (required)
... name SΣC 1..1 string Name used for the organization
... alias S 0..* string A list of alternate names that the organization is known as, or was known as in the past
... telecom C 0..* ContactPoint A contact detail for the organization
Constraints: cpt-2, org-3
... address SC 0..* Address An address for the organization
Constraints: org-2
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!SΣ 0..1 code home | work | temp | old | billing - purpose of this address
Binding: AddressUse (required): The use of an address.
Example General: home
.... type Σ 0..1 code postal | physical | both
Binding: AddressType (required): The type of an address (physical / postal).
Example General: both
.... text SΣ 0..1 string Text representation of the address
Example General: 137 Nowhere Street, Erewhon 9132
.... line SΣ 0..* string Street name, number, direction & P.O. Box etc.
This repeating element order: The order in which lines should appear in an address label
Example General: 137 Nowhere Street
.... city SΣ 0..1 string Name of city, town etc.
Example General: Erewhon
.... district Σ 0..1 string District name (aka county)
Example General: Madison
.... state SΣ 0..1 string Sub-unit of country (abbreviations ok)
.... postalCode SΣ 0..1 string Postal code for area
Example General: 9132
.... country SΣ 0..1 string Country (e.g. can be ISO 3166 2 or 3 letter code)
.... period ΣC 0..1 Period Time period when address was/is in use
Constraints: per-1
Example General: {"start":"2010-03-23","end":"2010-07-01"}
... partOf SΣC 0..1 Reference(Organization) The organization of which this organization forms a part
Constraints: ref-1
... contact S 0..* BackboneElement Contact for the organization for a certain purpose
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... purpose 0..1 CodeableConcept The type of contact
Binding: ContactEntityType (extensible): The purpose for which you would contact a contact party.
.... name 0..1 HumanName A name associated with the contact
.... telecom C 0..* ContactPoint Contact details (telephone, email, etc.) for a contact
Constraints: cpt-2
.... address 0..1 Address Visiting or postal addresses for the contact
... endpoint C 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the organization
Constraints: ref-1

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.meta.security Base extensible SecurityLabels 📍4.0.1 FHIR Std.
Organization.meta.tag Base example Common Tags 📍4.0.1 FHIR Std.
Organization.language Base preferred Common Languages 📍4.0.1 FHIR Std.
Organization.type Base example Organization type 📍4.0.1 FHIR Std.
Organization.type:providerType Base required TI Organization Types 📦1.0.7 TI Terminology v1.0
Organization.type:profession Base required TI Organization Profession Type OIDs 📦1.0.7 TI Terminology v1.0
Organization.address.​use Base required AddressUse 📍4.0.1 FHIR Std.
Organization.address.​type Base required AddressType 📍4.0.1 FHIR Std.
Organization.contact.​purpose Base extensible Contact entity type 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
cpt-2 error Organization.telecom, Organization.contact.telecom A system is required if a value is provided. value.empty() or system.exists()
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Organization If 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-5 error Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-2 error Organization.address An address of an organization can never be of use 'home' where(use = 'home').empty()
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()
per-1 error Organization.address.period If present, start SHALL have a lower value than end start.hasValue().not() or end.hasValue().not() or (start <= end)
ref-1 error Organization.partOf, Organization.endpoint SHALL have a contained resource if a local reference is provided reference.startsWith('#').not() or (reference.substring(1).trace('url') in %rootResource.contained.id.trace('ids'))

This structure is derived from Organization

 

Other representations of profile: CSV, Excel, Schematron