Netherlands - Generic Functions for data exchange Implementation Guide
0.1.0 - ci-build

Netherlands - Generic Functions for data exchange Implementation Guide, published by Ministerie van Volksgezondheid, Welzijn en Sport. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/minvws/generiekefuncties-docs/ and changes regularly. See the Directory of published versions

## Resource Profile: NL Generic Functions Organization Profile

Official URL: http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-organization | Version: 0.1.0
Draft as of 2026-03-05 | Computable Name: NlGfOrganization

The organizational hierarchy and details for healthcare organizations.

Usages:

- Refer to this Profile: NL Generic Functions HealthcareService Profile, NL Generic Functions Location Profile, NL Generic Functions Organization Profile and NL Generic Functions PractitionerRole Profile
- Examples for this Profile: example Care Institution, example General Practice, example Hospital, example General Practice... Show 10 more, Nursing department at Organization 3, example General Practice, example Hospital, example Care Institution, Nursing department at Organization 3, example Hospital, example Care Institution, example General Practice, example Hospital and example Care Institution
- CapabilityStatements using this Profile: Administration Directory for Administration Client, Administration Directory for Update Client, Query Directory for Query Client for only Read operations and Query Directory for Query Client

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.

- Key Elements Table
- Differential Table
- Snapshot Table
- Statistics/References
- All

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | NlcoreHealthcareProviderOrganization | HealthcareProvider This profile also complies with the profile mCSD Organization Constraints: org-1, ura-identifier-or-partof
Slices for identifier | Σ C | 0..* | Identifier | HealthcareProviderIdentificationNumber Slice: Unordered, Open by value:$this
identifier:ura | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/ura
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
identifier:agb | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/agb-z
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | ?!Σ | 0..1 | boolean | Whether the organization's record is still in active use
Slices for type | Σ | 1..* | CodeableConcept | Kind of organization Slice: Unordered, Open by value:$this Binding: OrganizationType (example): Used to categorize the organization.
type:departmentSpecialty | Σ | 0..1 | CodeableConcept | DepartmentSpecialty Binding: AfdelingSpecialismeCodelijst (required): Used to categorize the organization.
type:organizationType | Σ | 0..1 | CodeableConcept | OrganizationType Binding: OrganisatieTypeCodelijst (required): Used to categorize the organization.
type:SBI | Σ | 0..1 | CodeableConcept | SBI Binding: NL GF Organization Types ValueSet (extensible) Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-2025-cs
version |  | 0..1 | string | Version of the system - if relevant
code |  | 0..1 | code | Symbol in syntax defined by the system
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
name | Σ C | 1..1 | string | OrganizationName
Slices for telecom | C | 0..* | ContactPoint | A contact detail for the organization Slice: Unordered, Open by profile:$this Constraints: org-3
telecom:telephoneNumbers | C N | 0..* | NlcoreContactInformationTelephoneNumbers | TelephoneNumbers Constraints: org-3, cpt-2
telecom:emailAddresses | C N | 0..* | NlcoreContactInformationEmailAddresses | EmailAddresses Constraints: org-3, cpt-2
address | C | 0..* | NlcoreAddressInformation | AddressInformation Constraints: org-2
partOf | Σ | 0..1 | Reference(NL Generic Functions Organization Profile) | The organization of which this organization forms a part
endpoint |  | 0..* | Reference(NL Generic Functions Endpoint Profile) | Technical endpoints providing access to services operated for the organization
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:departmentSpecialty | Base | required | AfdelingSpecialismeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:organizationType | Base | required | OrganisatieTypeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:SBI | Base | extensible | NL GF Organization Types ValueSet | 📦0.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
cpt-2 | error | Organization.telecom:telephoneNumbers, Organization.telecom:emailAddresses | 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())`
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()`
org-3 | error | Organization.telecom:telephoneNumbers, Organization.telecom:emailAddresses | The telecom of an organization can never be of use 'home' | `where(use = 'home').empty()`
ura-identifier-or-partof | error | Organization | an Organization instance must either have an URA-identifier or must be 'partOf' some other instance that is an nl-gf-organization instance. | `identifier.where(system='http://fhir.nl/fhir/NamingSystem/ura').exists() or identifier.where(system='http://fhir.nl/fhir/NamingSystem/kvk').exists() or partOf.exists()`

This structure is derived from NlcoreHealthcareProviderOrganization

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | NlcoreHealthcareProviderOrganization | HealthcareProvider This profile also complies with the profile mCSD Organization Constraints: ura-identifier-or-partof
implicitRules |  | 0..0 |  | A set of rules under which this content was created
modifierExtension |  | 0..0 |  | Extension
type |  | 1..* | CodeableConcept | Kind of organization
Slices for type |  |  |  | Content/Rules for all slices
type:SBI |  | 0..1 | CodeableConcept | SBI Binding: NL GF Organization Types ValueSet (extensible) Required Pattern: At least the following
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-2025-cs
name |  | 1..1 | string | OrganizationName
partOf |  | 0..1 | Reference(NL Generic Functions Organization Profile) | The organization of which this organization forms a part
endpoint |  | 0..* | Reference(NL Generic Functions Endpoint Profile) | Technical endpoints providing access to services operated for the organization
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Organization.type:SBI | Base | extensible | NL GF Organization Types ValueSet | 📦0.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
ura-identifier-or-partof | error | Organization | an Organization instance must either have an URA-identifier or must be 'partOf' some other instance that is an nl-gf-organization instance. | `identifier.where(system='http://fhir.nl/fhir/NamingSystem/ura').exists() or identifier.where(system='http://fhir.nl/fhir/NamingSystem/kvk').exists() or partOf.exists()`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | NlcoreHealthcareProviderOrganization | HealthcareProvider This profile also complies with the profile mCSD Organization Constraints: org-1, ura-identifier-or-partof
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
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
extension |  | 0..* | Extension | Additional content defined by implementations
Slices for identifier | Σ C | 0..* | Identifier | HealthcareProviderIdentificationNumber Slice: Unordered, Open by value:$this
identifier:ura | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/ura
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
identifier:agb | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/agb-z
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | ?!Σ | 0..1 | boolean | Whether the organization's record is still in active use
Slices for type | Σ | 1..* | CodeableConcept | Kind of organization Slice: Unordered, Open by value:$this Binding: OrganizationType (example): Used to categorize the organization.
type:departmentSpecialty | Σ | 0..1 | CodeableConcept | DepartmentSpecialty Binding: AfdelingSpecialismeCodelijst (required): Used to categorize the organization.
type:organizationType | Σ | 0..1 | CodeableConcept | OrganizationType Binding: OrganisatieTypeCodelijst (required): Used to categorize the organization.
type:SBI | Σ | 0..1 | CodeableConcept | SBI Binding: NL GF Organization Types ValueSet (extensible) Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-2025-cs
version |  | 0..1 | string | Version of the system - if relevant
code |  | 0..1 | code | Symbol in syntax defined by the system
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
name | Σ C | 1..1 | string | OrganizationName
alias |  | 0..* | string | A list of alternate names that the organization is known as, or was known as in the past
Slices for telecom | C | 0..* | ContactPoint | A contact detail for the organization Slice: Unordered, Open by profile:$this Constraints: org-3
telecom:telephoneNumbers | C N | 0..* | NlcoreContactInformationTelephoneNumbers | TelephoneNumbers Constraints: org-3, cpt-2
telecom:emailAddresses | C N | 0..* | NlcoreContactInformationEmailAddresses | EmailAddresses Constraints: org-3, cpt-2
address | C | 0..* | NlcoreAddressInformation | AddressInformation Constraints: org-2
partOf | Σ | 0..1 | Reference(NL Generic Functions Organization Profile) | The organization of which this organization forms a part
contact |  | 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
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 | C | 0..1 | NlcoreNameInformation | NameInformation Constraints: zib-NameInformation-1, zib-NameInformation-2, nl-core-NameInformation-01
Slices for telecom |  | 0..* | ContactPoint | Contact details (telephone, email, etc.) for a contact Slice: Unordered, Open by profile:$this
telecom:telephoneNumbers | C N | 0..* | NlcoreContactInformationTelephoneNumbers | TelephoneNumbers Constraints: cpt-2
telecom:emailAddresses | C N | 0..* | NlcoreContactInformationEmailAddresses | EmailAddresses Constraints: cpt-2
address |  | 0..1 | NlcoreAddressInformation | AddressInformation
endpoint |  | 0..* | Reference(NL Generic Functions Endpoint Profile) | Technical endpoints providing access to services operated for the organization
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Organization.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Organization.type | Base | example | Organization type | 📦4.0.1 | FHIR Std.
Organization.type:departmentSpecialty | Base | required | AfdelingSpecialismeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:organizationType | Base | required | OrganisatieTypeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:SBI | Base | extensible | NL GF Organization Types ValueSet | 📦0.1.0 | This IG
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:telephoneNumbers, Organization.telecom:emailAddresses, Organization.contact.telecom:telephoneNumbers, Organization.contact.telecom:emailAddresses | 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()`
nl-core-NameInformation-01 | warning | Organization.contact.name | If parts of the name are specified using one or more of the structured elements, the `.text` element SHOULD be populated with a rendered version of the full name. This ensures compatibility with common FHIR usage. | `(family.exists() or given.extension.where(url = 'http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier').where(value != 'IN').exists()) implies text.hasValue()`
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()`
org-3 | error | Organization.telecom:telephoneNumbers, Organization.telecom:emailAddresses | The telecom of an organization can never be of use 'home' | `where(use = 'home').empty()`
ura-identifier-or-partof | error | Organization | an Organization instance must either have an URA-identifier or must be 'partOf' some other instance that is an nl-gf-organization instance. | `identifier.where(system='http://fhir.nl/fhir/NamingSystem/ura').exists() or identifier.where(system='http://fhir.nl/fhir/NamingSystem/kvk').exists() or partOf.exists()`
zib-NameInformation-1 | error | Organization.contact.name | If a prefix for a family name is specified, the family name is expected as well | `family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty().not() implies family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty().not()`
zib-NameInformation-2 | error | Organization.contact.name | If the prefix for a partner family name is specified, the partner family name is expected as well | `family.extension('http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix').empty().not() implies family.extension('http://hl7.org/fhir/StructureDefinition/humanname-partner-name').empty().not()`

This structure is derived from NlcoreHealthcareProviderOrganization

Summary

Mandatory: 2 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

- NL Generic Functions Organization Profile (http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-organization)
- NL Generic Functions Endpoint Profile (http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-endpoint)

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | NlcoreHealthcareProviderOrganization | HealthcareProvider This profile also complies with the profile mCSD Organization Constraints: org-1, ura-identifier-or-partof
Slices for identifier | Σ C | 0..* | Identifier | HealthcareProviderIdentificationNumber Slice: Unordered, Open by value:$this
identifier:ura | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/ura
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
identifier:agb | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/agb-z
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | ?!Σ | 0..1 | boolean | Whether the organization's record is still in active use
Slices for type | Σ | 1..* | CodeableConcept | Kind of organization Slice: Unordered, Open by value:$this Binding: OrganizationType (example): Used to categorize the organization.
type:departmentSpecialty | Σ | 0..1 | CodeableConcept | DepartmentSpecialty Binding: AfdelingSpecialismeCodelijst (required): Used to categorize the organization.
type:organizationType | Σ | 0..1 | CodeableConcept | OrganizationType Binding: OrganisatieTypeCodelijst (required): Used to categorize the organization.
type:SBI | Σ | 0..1 | CodeableConcept | SBI Binding: NL GF Organization Types ValueSet (extensible) Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-2025-cs
version |  | 0..1 | string | Version of the system - if relevant
code |  | 0..1 | code | Symbol in syntax defined by the system
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
name | Σ C | 1..1 | string | OrganizationName
Slices for telecom | C | 0..* | ContactPoint | A contact detail for the organization Slice: Unordered, Open by profile:$this Constraints: org-3
telecom:telephoneNumbers | C N | 0..* | NlcoreContactInformationTelephoneNumbers | TelephoneNumbers Constraints: org-3, cpt-2
telecom:emailAddresses | C N | 0..* | NlcoreContactInformationEmailAddresses | EmailAddresses Constraints: org-3, cpt-2
address | C | 0..* | NlcoreAddressInformation | AddressInformation Constraints: org-2
partOf | Σ | 0..1 | Reference(NL Generic Functions Organization Profile) | The organization of which this organization forms a part
endpoint |  | 0..* | Reference(NL Generic Functions Endpoint Profile) | Technical endpoints providing access to services operated for the organization
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:departmentSpecialty | Base | required | AfdelingSpecialismeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:organizationType | Base | required | OrganisatieTypeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:SBI | Base | extensible | NL GF Organization Types ValueSet | 📦0.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
cpt-2 | error | Organization.telecom:telephoneNumbers, Organization.telecom:emailAddresses | 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())`
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()`
org-3 | error | Organization.telecom:telephoneNumbers, Organization.telecom:emailAddresses | The telecom of an organization can never be of use 'home' | `where(use = 'home').empty()`
ura-identifier-or-partof | error | Organization | an Organization instance must either have an URA-identifier or must be 'partOf' some other instance that is an nl-gf-organization instance. | `identifier.where(system='http://fhir.nl/fhir/NamingSystem/ura').exists() or identifier.where(system='http://fhir.nl/fhir/NamingSystem/kvk').exists() or partOf.exists()`

Differential View

This structure is derived from NlcoreHealthcareProviderOrganization

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | NlcoreHealthcareProviderOrganization | HealthcareProvider This profile also complies with the profile mCSD Organization Constraints: ura-identifier-or-partof
implicitRules |  | 0..0 |  | A set of rules under which this content was created
modifierExtension |  | 0..0 |  | Extension
type |  | 1..* | CodeableConcept | Kind of organization
Slices for type |  |  |  | Content/Rules for all slices
type:SBI |  | 0..1 | CodeableConcept | SBI Binding: NL GF Organization Types ValueSet (extensible) Required Pattern: At least the following
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-2025-cs
name |  | 1..1 | string | OrganizationName
partOf |  | 0..1 | Reference(NL Generic Functions Organization Profile) | The organization of which this organization forms a part
endpoint |  | 0..* | Reference(NL Generic Functions Endpoint Profile) | Technical endpoints providing access to services operated for the organization
Documentation for this format

#### Terminology Bindings (Differential)

Path | Status | Usage | ValueSet | Version | Source
Organization.type:SBI | Base | extensible | NL GF Organization Types ValueSet | 📦0.1.0 | This IG

#### Constraints

Id | Grade | Path(s) | Description | Expression
ura-identifier-or-partof | error | Organization | an Organization instance must either have an URA-identifier or must be 'partOf' some other instance that is an nl-gf-organization instance. | `identifier.where(system='http://fhir.nl/fhir/NamingSystem/ura').exists() or identifier.where(system='http://fhir.nl/fhir/NamingSystem/kvk').exists() or partOf.exists()`

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Organization | C | 0..* | NlcoreHealthcareProviderOrganization | HealthcareProvider This profile also complies with the profile mCSD Organization Constraints: org-1, ura-identifier-or-partof
id | Σ | 0..1 | id | Logical id of this artifact
meta | Σ | 0..1 | Meta | Metadata about the resource
language |  | 0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
Additional Bindings | Purpose
AllLanguages | Max Binding
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
extension |  | 0..* | Extension | Additional content defined by implementations
Slices for identifier | Σ C | 0..* | Identifier | HealthcareProviderIdentificationNumber Slice: Unordered, Open by value:$this
identifier:ura | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/ura
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
identifier:agb | Σ C | 0..* | Identifier | Identifies this organization across multiple systems Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
use |  | 0..1 | code | usual | official | temp | secondary | old (If known)
type |  | 0..1 | CodeableConcept | Description of identifier
system |  | 1..1 | uri | The namespace for the identifier value Fixed Value: http://fhir.nl/fhir/NamingSystem/agb-z
value |  | 0..1 | string | The value that is unique
period |  | 0..1 | Period | Time period when id is/was valid for use
assigner |  | 0..1 | Reference(Organization) | Organization that issued id (may be just text)
active | ?!Σ | 0..1 | boolean | Whether the organization's record is still in active use
Slices for type | Σ | 1..* | CodeableConcept | Kind of organization Slice: Unordered, Open by value:$this Binding: OrganizationType (example): Used to categorize the organization.
type:departmentSpecialty | Σ | 0..1 | CodeableConcept | DepartmentSpecialty Binding: AfdelingSpecialismeCodelijst (required): Used to categorize the organization.
type:organizationType | Σ | 0..1 | CodeableConcept | OrganizationType Binding: OrganisatieTypeCodelijst (required): Used to categorize the organization.
type:SBI | Σ | 0..1 | CodeableConcept | SBI Binding: NL GF Organization Types ValueSet (extensible) Required Pattern: At least the following
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
coding |  | 1..* | Coding | Code defined by a terminology system Fixed Value: (Complex)
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations
system |  | 1..1 | uri | Identity of the terminology system Fixed Value: http://minvws.github.io/generiekefuncties-docs/CodeSystem/nl-gf-sbi-2025-cs
version |  | 0..1 | string | Version of the system - if relevant
code |  | 0..1 | code | Symbol in syntax defined by the system
display |  | 0..1 | string | Representation defined by the system
userSelected |  | 0..1 | boolean | If this coding was chosen directly by the user
text |  | 0..1 | string | Plain text representation of the concept
name | Σ C | 1..1 | string | OrganizationName
alias |  | 0..* | string | A list of alternate names that the organization is known as, or was known as in the past
Slices for telecom | C | 0..* | ContactPoint | A contact detail for the organization Slice: Unordered, Open by profile:$this Constraints: org-3
telecom:telephoneNumbers | C N | 0..* | NlcoreContactInformationTelephoneNumbers | TelephoneNumbers Constraints: org-3, cpt-2
telecom:emailAddresses | C N | 0..* | NlcoreContactInformationEmailAddresses | EmailAddresses Constraints: org-3, cpt-2
address | C | 0..* | NlcoreAddressInformation | AddressInformation Constraints: org-2
partOf | Σ | 0..1 | Reference(NL Generic Functions Organization Profile) | The organization of which this organization forms a part
contact |  | 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
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 | C | 0..1 | NlcoreNameInformation | NameInformation Constraints: zib-NameInformation-1, zib-NameInformation-2, nl-core-NameInformation-01
Slices for telecom |  | 0..* | ContactPoint | Contact details (telephone, email, etc.) for a contact Slice: Unordered, Open by profile:$this
telecom:telephoneNumbers | C N | 0..* | NlcoreContactInformationTelephoneNumbers | TelephoneNumbers Constraints: cpt-2
telecom:emailAddresses | C N | 0..* | NlcoreContactInformationEmailAddresses | EmailAddresses Constraints: cpt-2
address |  | 0..1 | NlcoreAddressInformation | AddressInformation
endpoint |  | 0..* | Reference(NL Generic Functions Endpoint Profile) | Technical endpoints providing access to services operated for the organization
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Organization.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Organization.type | Base | example | Organization type | 📦4.0.1 | FHIR Std.
Organization.type:departmentSpecialty | Base | required | AfdelingSpecialismeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:organizationType | Base | required | OrganisatieTypeCodelijst | 📦2020-09-01T00:00:00 | FHIR implementation of zibs 2020 v0.12
Organization.type:SBI | Base | extensible | NL GF Organization Types ValueSet | 📦0.1.0 | This IG
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:telephoneNumbers, Organization.telecom:emailAddresses, Organization.contact.telecom:telephoneNumbers, Organization.contact.telecom:emailAddresses | 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()`
nl-core-NameInformation-01 | warning | Organization.contact.name | If parts of the name are specified using one or more of the structured elements, the `.text` element SHOULD be populated with a rendered version of the full name. This ensures compatibility with common FHIR usage. | `(family.exists() or given.extension.where(url = 'http://hl7.org/fhir/StructureDefinition/iso21090-EN-qualifier').where(value != 'IN').exists()) implies text.hasValue()`
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()`
org-3 | error | Organization.telecom:telephoneNumbers, Organization.telecom:emailAddresses | The telecom of an organization can never be of use 'home' | `where(use = 'home').empty()`
ura-identifier-or-partof | error | Organization | an Organization instance must either have an URA-identifier or must be 'partOf' some other instance that is an nl-gf-organization instance. | `identifier.where(system='http://fhir.nl/fhir/NamingSystem/ura').exists() or identifier.where(system='http://fhir.nl/fhir/NamingSystem/kvk').exists() or partOf.exists()`
zib-NameInformation-1 | error | Organization.contact.name | If a prefix for a family name is specified, the family name is expected as well | `family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-prefix').empty().not() implies family.extension('http://hl7.org/fhir/StructureDefinition/humanname-own-name').empty().not()`
zib-NameInformation-2 | error | Organization.contact.name | If the prefix for a partner family name is specified, the partner family name is expected as well | `family.extension('http://hl7.org/fhir/StructureDefinition/humanname-partner-prefix').empty().not() implies family.extension('http://hl7.org/fhir/StructureDefinition/humanname-partner-name').empty().not()`

This structure is derived from NlcoreHealthcareProviderOrganization

Summary

Mandatory: 2 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

- NL Generic Functions Organization Profile (http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-organization)
- NL Generic Functions Endpoint Profile (http://minvws.github.io/generiekefuncties-docs/StructureDefinition/nl-gf-endpoint)

Other representations of profile: CSV, Excel, Schematron