PLUGIN
0.0.2-ci - ci-build NL

PLUGIN - Local Development build (v0.0.2-ci) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: PluginOrganization - Detailed Descriptions

Draft as of 2025-09-02

Definitions for the plugin-organization resource profile.

Guidance on how to interpret the contents of this table can be foundhere

0. Organization
Definition

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, payer/insurer, etc.

ShortHealthcareProviderA grouping of people or organizations with a common purpose
Comments

The zib HealthcareProvider is mapped to this Organization profile and a profile on Location (http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider). The Location profile acts as the focal resource of the HealthcareProvider because most references to this zib are concerned about the recording of the physical location where the care to patient/client takes place rather than the organizational information. Often there's no clear distinction between an organizational structure and a physical location. As a rule of thumb, locations are always used for recording where a service occurs, and hence where encounters and observations take place.

Healthcare providers usually consist of multiple organizational levels and physical locations. The hierarchical structure may be captured by using multiple instances of this profile, using the Organization.partOf element to refer to their parent organization. The physical location is captured using the nl-core-HealthcareProvider profile, which refers this profile at the appropriate level in the hierarchy.

Control0..*
Is Modifierfalse
Summaryfalse
Alternate NamesZorgaanbieder, nl-core-HealthcareProvider-Organization
Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
dom-3: 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: 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: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
dom-6: A resource should have narrative for robust management (text.`div`.exists())
org-1: The organization SHALL at least have a name or an identifier, and possibly more than one ((identifier.count() + name.count()) > 0)
org-1: The organization SHALL at least have a name or an identifier, and possibly more than one ((identifier.count() + name.count()) > 0)
2. Organization.implicitRules
Definition

A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

ShortA set of rules under which this content was created
Comments

Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

Control0..1
Typeuri
Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
Summarytrue
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
4. Organization.modifierExtension
Definition

May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

ShortExtensions that cannot be ignored
Comments

There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

Control0..*
TypeExtension
Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
Summaryfalse
Requirements

Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

Alternate Namesextensions, user content
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
6. Organization.identifier
Definition

The organization’s identification number. For Dutch healthcare providers, the URA number or the AGB number is used, if possible. Depending on the context other ID's are also possible. For foreign or non-affiliated healthcare providers, another unique identification number can be used. This must be accompanied by the name and/or code of the issuing organization.


Identifier for the organization that is used to identify the organization across multiple disparate systems.

ShortHealthcareProviderIdentificationNumberIdentifies this organization across multiple systems
NoteThis is a business identifier, not a resource identifier (see discussion)
Control10..*
This element is affected by the following invariants: org-1
TypeIdentifier
Is Modifierfalse
Summarytrue
Requirements

Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

Alternate NamesZorgaanbiederIdentificatienummer
Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
SlicingThis element introduces a set of slices on Organization.identifier. The slices areUnordered and Open, and can be differentiated using the following discriminators:
  • value @ $this
  • 8. Organization.identifier:ura
    Slice Nameura
    Definition

    Identifier for the organization that is used to identify the organization across multiple disparate systems.

    ShortIdentifies this organization across multiple systems
    NoteThis is a business identifier, not a resource identifier (see discussion)
    Control0..*
    This element is affected by the following invariants: org-1
    TypeIdentifier
    Is Modifierfalse
    Summarytrue
    Requirements

    Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

    Pattern Value{
      "system" : "http://fhir.nl/fhir/NamingSystem/ura"
    }
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    10. Organization.identifier:agb
    Slice Nameagb
    Definition

    Identifier for the organization that is used to identify the organization across multiple disparate systems.

    ShortIdentifies this organization across multiple systems
    NoteThis is a business identifier, not a resource identifier (see discussion)
    Control10..*
    This element is affected by the following invariants: org-1
    TypeIdentifier
    Is Modifierfalse
    Must Supporttrue
    Summarytrue
    Requirements

    Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

    Pattern Value{
      "system" : "http://fhir.nl/fhir/NamingSystem/agb-z"
    }
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    12. Organization.active
    Definition

    Whether the organization's record is still in active use.

    ShortWhether the organization's record is still in active use
    Comments

    This active flag is not intended to be used to mark an organization as temporarily closed or under construction. Instead the Location(s) within the Organization should have the suspended status. If further details of the reason for the suspension are required, then an extension on this element should be used.

    This element is labeled as a modifier because it may be used to mark that the resource was created in error.

    Control0..1
    Typeboolean
    Is Modifiertrue because This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid
    Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
    Summarytrue
    Requirements

    Need a flag to indicate a record is no longer to be used and should generally be hidden for the user in the UI.

    Meaning if MissingThis resource is generally assumed to be active if no value is provided for the active element
    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    14. Organization.type
    Definition

    The kind(s) of organization that this is.

    ShortKind of organization
    Comments

    Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes

    When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center.

    We expect that some jurisdictions will profile this optionality to be a single cardinality.

    Control0..*
    BindingFor example codes, see OrganizationTypehttp://hl7.org/fhir/ValueSet/organization-type
    (example to http://hl7.org/fhir/ValueSet/organization-type)

    Used to categorize the organization.

    TypeCodeableConcept
    Is Modifierfalse
    Summarytrue
    Requirements

    Need to be able to track the kind of organization that this is - different organization types have different uses.

    Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
    SlicingThis element introduces a set of slices on Organization.type. The slices areUnordered and Open, and can be differentiated using the following discriminators:
    • value @ $this
    • 16. Organization.type:departmentSpecialty
      Slice NamedepartmentSpecialty
      Definition

      The specialty of the healthcare provider’s department. The departmental specialty can be filled in if further indication of the healthcare provider is needed. This refers to the recognized medical specialties as stated in the BIG Act.


      The kind(s) of organization that this is.

      ShortDepartmentSpecialtyKind of organization
      Comments

      Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes

      When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center.

      We expect that some jurisdictions will profile this optionality to be a single cardinality.

      Control0..1*
      BindingThe codes SHALL be taken from For example codes, see AfdelingSpecialismeCodelijsthttp://hl7.org/fhir/ValueSet/organization-type
      (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.2.4--20200901000000)

      Used to categorize the organization.

      TypeCodeableConcept
      Is Modifierfalse
      Summarytrue
      Requirements

      Need to be able to track the kind of organization that this is - different organization types have different uses.

      Alternate NamesAfdelingSpecialisme
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      18. Organization.type:organizationType
      Slice NameorganizationType
      Definition

      The type of healthcare provider, such as general hospital, or nursing home. If this field is filled in and an AGB code is used for the HealthcareProviderIdentificationNumber, the type must match the type implicitly contained in the AGB code.


      The kind(s) of organization that this is.

      ShortOrganizationTypeKind of organization
      Comments

      Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes

      When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center.

      We expect that some jurisdictions will profile this optionality to be a single cardinality.

      Control0..1*
      BindingThe codes SHALL be taken from For example codes, see OrganisatieTypeCodelijsthttp://hl7.org/fhir/ValueSet/organization-type
      (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.2.3--20200901000000)

      Used to categorize the organization.

      TypeCodeableConcept
      Is Modifierfalse
      Summarytrue
      Requirements

      Need to be able to track the kind of organization that this is - different organization types have different uses.

      Alternate NamesOrganisatieType
      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      20. Organization.telecom
      Definition

      A contact detail for the organization.

      ShortA contact detail for the organization
      Comments

      The use code 'home' is not to be used. Note that these contacts are not the contact details of people who are employed by or represent the organization, but official contacts for the organization itself.

      Control0..*
      This element is affected by the following invariants: org-3
      TypeContactPoint
      Is Modifierfalse
      Summaryfalse
      Requirements

      Human contact for the organization.

      Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
      org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
      SlicingThis element introduces a set of slices on Organization.telecom. The slices areUnordered and Open, and can be differentiated using the following discriminators:
      • profile @ $this
      • 22. Organization.telecom:telephoneNumbers
        Slice NametelephoneNumbers
        Definition

        Details for all kinds of technology mediated contact points for a person or organization, including telephone, email, etc.


        A contact detail for the organization.

        ShortTelephoneNumbersA contact detail for the organization
        Comments

        Implementation of the "TelephoneNumbers" concept of zib ContactInformation.

        Please note that, although the zib concepts TelecomType and NumberType are functionally equivalent to the FHIR concepts ContactPoint.system and ContactPoint.use respectively, a mismatch occurs on the concept of mobile phone numbers; the zib uses the first concept and FHIR the second. For this reason, the ValueSet on ContactPoint.system is too narrow and the zib code will need to be communicated using the ext-CodeSpecification extension.


        The use code 'home' is not to be used. Note that these contacts are not the contact details of people who are employed by or represent the organization, but official contacts for the organization itself.

        Control0..*
        This element is affected by the following invariants: org-3, ele-1
        TypeContactPoint(nl core ContactInformation TelephoneNumbers)
        Is Modifierfalse
        Standard StatusNormative (from Trial Use)
        Summaryfalse
        Requirements

        Human contact for the organization.

        Alternate NamesTelefoonnummers, nl-core-ContactInformation-TelephoneNumbers
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
        cpt-2: A system is required if a value is provided. (value.empty() or system.exists())
        org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
        24. Organization.telecom:emailAddresses
        Slice NameemailAddresses
        Definition

        Details for all kinds of technology mediated contact points for a person or organization, including telephone, email, etc.


        A contact detail for the organization.

        ShortEmailAddressesA contact detail for the organization
        Comments

        Implementation of the "EmailAddresses" concept of zib ContactInformation.


        The use code 'home' is not to be used. Note that these contacts are not the contact details of people who are employed by or represent the organization, but official contacts for the organization itself.

        Control0..*
        This element is affected by the following invariants: org-3, ele-1
        TypeContactPoint(nl core ContactInformation EmailAddresses)
        Is Modifierfalse
        Standard StatusNormative (from Trial Use)
        Summaryfalse
        Requirements

        Human contact for the organization.

        Alternate NamesEmailAdressen, nl-core-ContactInformation-EmailAddresses
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
        cpt-2: A system is required if a value is provided. (value.empty() or system.exists())
        org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
        26. Organization.address
        Definition

        An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations which might not be valid for mail delivery. There are a variety of postal address formats defined around the world.


        An address for the organization.

        ShortAddressInformationAn address for the organization
        Comments

        This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Dutch addresses specifically, according to the zib AddressInformation v1.1 (2020). A Dutch Address still is a proper FHIR Address, which means that systems that cannot interpret the extensions will still be able to render and work with this datatype.

        To have true compatibility an implementer SHOULD use the core Address parts as intended. To have addresses work for Dutch context, the implementer SHOULD in addition use the extension elements.

        Separate address parts

        The first addition is that Dutch addresses make certain address parts separately communicable. These parts are required for use in true Dutch systems when dealing with Dutch addresses, but may not have value for international systems when information gets sent abroad.

        Custom address types

        The second addition is that the zib defines its own ValueSet for address types, which can only be partially expressed using the FHIR Address datatype and requires a mapping to multiple elements. The table below explains how the zib concepts are mapped to the various FHIR elements (see the ConceptMaps http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse and http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType as well). The code from the zib should also be included using the extension on Address.extension:addressType.

        zib .ext:addressType .use .type
        Postal Address/Postadres PST postal
        Primary Home/Officieel adres HP home both
        Visit Address/Woon-/verblijfadres PHYS home physical
        Temporary Address/Tijdelijk adres TMP temp
        Work Place/Werkadres WP work
        Vacation Home/Vakantie adres HV temp

        If Address.type is both then this is to be understood as a dual purpose address (postal and physical), unless a specific postal type address is added. Systems that support importing it like this are encouraged to do so, otherwise they may need to import this as two separate addresses.

        Note: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the zib ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.


        Organization may have multiple addresses with different uses or applicable periods. The use code 'home' is not to be used.

        Control0..*
        This element is affected by the following invariants: org-2, ele-1
        TypeAddress(nl core AddressInformation)
        Is Modifierfalse
        Summaryfalse
        Requirements

        May need to keep track of the organization's addresses for contacting, billing or reporting requirements.

        Alternate NamesAdresgegevens, nl-core-AddressInformation
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        org-2: An address of an organization can never be of use 'home' (where(use = 'home').empty())
        org-2: An address of an organization can never be of use 'home' (where(use = 'home').empty())

        Guidance on how to interpret the contents of this table can be foundhere

        0. Organization
        2. Organization.identifier
        NoteThis is a business identifier, not a resource identifier (see discussion)
        Control1..?
        4. Organization.identifier:agb
        Slice Nameagb
        NoteThis is a business identifier, not a resource identifier (see discussion)
        Control1..?
        Must Supporttrue

        Guidance on how to interpret the contents of this table can be foundhere

        0. Organization
        Definition

        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, payer/insurer, etc.

        ShortHealthcareProvider
        Comments

        The zib HealthcareProvider is mapped to this Organization profile and a profile on Location (http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider). The Location profile acts as the focal resource of the HealthcareProvider because most references to this zib are concerned about the recording of the physical location where the care to patient/client takes place rather than the organizational information. Often there's no clear distinction between an organizational structure and a physical location. As a rule of thumb, locations are always used for recording where a service occurs, and hence where encounters and observations take place.

        Healthcare providers usually consist of multiple organizational levels and physical locations. The hierarchical structure may be captured by using multiple instances of this profile, using the Organization.partOf element to refer to their parent organization. The physical location is captured using the nl-core-HealthcareProvider profile, which refers this profile at the appropriate level in the hierarchy.

        Control0..*
        Is Modifierfalse
        Summaryfalse
        Alternate NamesZorgaanbieder, nl-core-HealthcareProvider-Organization
        Invariantsdom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources (contained.contained.empty())
        dom-3: 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: 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: If a resource is contained in another resource, it SHALL NOT have a security label (contained.meta.security.empty())
        dom-6: A resource should have narrative for robust management (text.`div`.exists())
        org-1: The organization SHALL at least have a name or an identifier, and possibly more than one ((identifier.count() + name.count()) > 0)
        2. Organization.id
        Definition

        The logical id of the resource, as used in the URL for the resource. Once assigned, this value never changes.

        ShortLogical id of this artifact
        Comments

        The only time that a resource does not have an id is when it is being submitted to the server using a create operation.

        Control0..1
        Typeid
        Is Modifierfalse
        Summarytrue
        4. Organization.meta
        Definition

        The metadata about the resource. This is content that is maintained by the infrastructure. Changes to the content might not always be associated with version changes to the resource.

        ShortMetadata about the resource
        Control0..1
        TypeMeta
        Is Modifierfalse
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        6. Organization.implicitRules
        Definition

        A reference to a set of rules that were followed when the resource was constructed, and which must be understood when processing the content. Often, this is a reference to an implementation guide that defines the special rules along with other profiles etc.

        ShortA set of rules under which this content was created
        Comments

        Asserting this rule set restricts the content to be only understood by a limited set of trading partners. This inherently limits the usefulness of the data in the long term. However, the existing health eco-system is highly fractured, and not yet ready to define, collect, and exchange data in a generally computable sense. Wherever possible, implementers and/or specification writers should avoid using this element. Often, when used, the URL is a reference to an implementation guide that defines these special rules as part of it's narrative along with other profiles, value sets, etc.

        Control0..1
        Typeuri
        Is Modifiertrue because This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summarytrue
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        8. Organization.language
        Definition

        The base language in which the resource is written.

        ShortLanguage of the resource content
        Comments

        Language is provided to support indexing and accessibility (typically, services such as text to speech use the language tag). The html language tag in the narrative applies to the narrative. The language tag on the resource may be used to specify the language of other presentations generated from the data in the resource. Not all the content has to be in the base language. The Resource.language should not be assumed to apply to the narrative automatically. If a language is specified, it should it also be specified on the div element in the html (see rules in HTML5 for information about the relationship between xml:lang and the html lang attribute).

        Control0..1
        BindingThe codes SHOULD be taken from CommonLanguages
        (preferred to http://hl7.org/fhir/ValueSet/languages)

        A human language.

        Additional BindingsPurpose
        AllLanguagesMax Binding
        Typecode
        Is Modifierfalse
        Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
        Summaryfalse
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        10. Organization.text
        Definition

        A human-readable narrative that contains a summary of the resource and can be used to represent the content of the resource to a human. The narrative need not encode all the structured data, but is required to contain sufficient detail to make it "clinically safe" for a human to just read the narrative. Resource definitions may define what content should be represented in the narrative to ensure clinical safety.

        ShortText summary of the resource, for human interpretation
        Comments

        Contained resources do not have narrative. Resources that are not contained SHOULD have a narrative. In some cases, a resource may only have text with little or no additional discrete data (as long as all minOccurs=1 elements are satisfied). This may be necessary for data from legacy systems where information is captured as a "text blob" or where text is additionally entered raw or narrated and encoded information is added later.

        Control0..1
        TypeNarrative
        Is Modifierfalse
        Summaryfalse
        Alternate Namesnarrative, html, xhtml, display
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        12. Organization.contained
        Definition

        These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.

        ShortContained, inline Resources
        Comments

        This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.

        Control0..*
        TypeResource
        Is Modifierfalse
        Summaryfalse
        Alternate Namesinline resources, anonymous resources, contained resources
        14. Organization.extension
        Definition

        May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

        ShortAdditional content defined by implementations
        Comments

        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

        Control0..*
        TypeExtension
        Is Modifierfalse
        Summaryfalse
        Alternate Namesextensions, user content
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        16. Organization.modifierExtension
        Definition

        May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

        Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

        ShortExtensions that cannot be ignored
        Comments

        There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

        Control0..*
        TypeExtension
        Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
        Summaryfalse
        Requirements

        Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

        Alternate Namesextensions, user content
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
        18. Organization.identifier
        Definition

        The organization’s identification number. For Dutch healthcare providers, the URA number or the AGB number is used, if possible. Depending on the context other ID's are also possible. For foreign or non-affiliated healthcare providers, another unique identification number can be used. This must be accompanied by the name and/or code of the issuing organization.

        ShortHealthcareProviderIdentificationNumber
        NoteThis is a business identifier, not a resource identifier (see discussion)
        Control1..*
        This element is affected by the following invariants: org-1
        TypeIdentifier
        Is Modifierfalse
        Summarytrue
        Requirements

        Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

        Alternate NamesZorgaanbiederIdentificatienummer
        Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
        SlicingThis element introduces a set of slices on Organization.identifier. The slices areUnordered and Open, and can be differentiated using the following discriminators:
        • value @ $this
        • 20. Organization.identifier:ura
          Slice Nameura
          Definition

          Identifier for the organization that is used to identify the organization across multiple disparate systems.

          ShortIdentifies this organization across multiple systems
          NoteThis is a business identifier, not a resource identifier (see discussion)
          Control0..*
          This element is affected by the following invariants: org-1
          TypeIdentifier
          Is Modifierfalse
          Summarytrue
          Requirements

          Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

          Pattern Value{
            "system" : "http://fhir.nl/fhir/NamingSystem/ura"
          }
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          22. Organization.identifier:agb
          Slice Nameagb
          Definition

          Identifier for the organization that is used to identify the organization across multiple disparate systems.

          ShortIdentifies this organization across multiple systems
          NoteThis is a business identifier, not a resource identifier (see discussion)
          Control1..*
          This element is affected by the following invariants: org-1
          TypeIdentifier
          Is Modifierfalse
          Must Supporttrue
          Summarytrue
          Requirements

          Organizations are known by a variety of ids. Some institutions maintain several, and most collect identifiers for exchange with other organizations concerning the organization.

          Pattern Value{
            "system" : "http://fhir.nl/fhir/NamingSystem/agb-z"
          }
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          24. Organization.active
          Definition

          Whether the organization's record is still in active use.

          ShortWhether the organization's record is still in active use
          Comments

          This active flag is not intended to be used to mark an organization as temporarily closed or under construction. Instead the Location(s) within the Organization should have the suspended status. If further details of the reason for the suspension are required, then an extension on this element should be used.

          This element is labeled as a modifier because it may be used to mark that the resource was created in error.

          Control0..1
          Typeboolean
          Is Modifiertrue because This element is labelled as a modifier because it is a status element that can indicate that a record should not be treated as valid
          Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
          Summarytrue
          Requirements

          Need a flag to indicate a record is no longer to be used and should generally be hidden for the user in the UI.

          Meaning if MissingThis resource is generally assumed to be active if no value is provided for the active element
          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          26. Organization.type
          Definition

          The kind(s) of organization that this is.

          ShortKind of organization
          Comments

          Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes

          When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center.

          We expect that some jurisdictions will profile this optionality to be a single cardinality.

          Control0..*
          BindingFor example codes, see OrganizationType
          (example to http://hl7.org/fhir/ValueSet/organization-type)

          Used to categorize the organization.

          TypeCodeableConcept
          Is Modifierfalse
          Summarytrue
          Requirements

          Need to be able to track the kind of organization that this is - different organization types have different uses.

          Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
          SlicingThis element introduces a set of slices on Organization.type. The slices areUnordered and Open, and can be differentiated using the following discriminators:
          • value @ $this
          • 28. Organization.type:departmentSpecialty
            Slice NamedepartmentSpecialty
            Definition

            The specialty of the healthcare provider’s department. The departmental specialty can be filled in if further indication of the healthcare provider is needed. This refers to the recognized medical specialties as stated in the BIG Act.

            ShortDepartmentSpecialty
            Comments

            Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes

            When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center.

            We expect that some jurisdictions will profile this optionality to be a single cardinality.

            Control0..1
            BindingThe codes SHALL be taken from AfdelingSpecialismeCodelijst
            (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.2.4--20200901000000)

            Used to categorize the organization.

            TypeCodeableConcept
            Is Modifierfalse
            Summarytrue
            Requirements

            Need to be able to track the kind of organization that this is - different organization types have different uses.

            Alternate NamesAfdelingSpecialisme
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            30. Organization.type:organizationType
            Slice NameorganizationType
            Definition

            The type of healthcare provider, such as general hospital, or nursing home. If this field is filled in and an AGB code is used for the HealthcareProviderIdentificationNumber, the type must match the type implicitly contained in the AGB code.

            ShortOrganizationType
            Comments

            Organizations can be corporations, wards, sections, clinical teams, government departments, etc. Note that code is generally a classifier of the type of organization; in many applications, codes are used to identity a particular organization (say, ward) as opposed to another of the same type - these are identifiers, not codes

            When considering if multiple types are appropriate, you should evaluate if child organizations would be a more appropriate use of the concept, as different types likely are in different sub-areas of the organization. This is most likely to be used where type values have orthogonal values, such as a religious, academic and medical center.

            We expect that some jurisdictions will profile this optionality to be a single cardinality.

            Control0..1
            BindingThe codes SHALL be taken from OrganisatieTypeCodelijst
            (required to http://decor.nictiz.nl/fhir/ValueSet/2.16.840.1.113883.2.4.3.11.60.40.2.17.2.3--20200901000000)

            Used to categorize the organization.

            TypeCodeableConcept
            Is Modifierfalse
            Summarytrue
            Requirements

            Need to be able to track the kind of organization that this is - different organization types have different uses.

            Alternate NamesOrganisatieType
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            32. Organization.name
            Definition

            Name of the organization. If an identification number is given, the name must match the name that corresponds to the identification number.

            ShortOrganizationName
            Comments

            If the name of an organization changes, consider putting the old name in the alias column so that it can still be located through searches.

            Control0..1
            This element is affected by the following invariants: org-1
            Typestring
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summarytrue
            Requirements

            Need to use the name as the label of the organization.

            Alternate NamesOrganisatieNaam
            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            34. Organization.alias
            Definition

            A list of alternate names that the organization is known as, or was known as in the past.

            ShortA list of alternate names that the organization is known as, or was known as in the past
            Comments

            There are no dates associated with the alias/historic names, as this is not intended to track when names were used, but to assist in searching so that older names can still result in identifying the organization.

            Control0..*
            Typestring
            Is Modifierfalse
            Primitive ValueThis primitive element may be present, or absent, or replaced by an extension
            Summaryfalse
            Requirements

            Over time locations and organizations go through many changes and can be known by different names.

            For searching knowing previous names that the organization was known by can be very useful.

            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            36. Organization.telecom
            Definition

            A contact detail for the organization.

            ShortA contact detail for the organization
            Comments

            The use code 'home' is not to be used. Note that these contacts are not the contact details of people who are employed by or represent the organization, but official contacts for the organization itself.

            Control0..*
            This element is affected by the following invariants: org-3
            TypeContactPoint
            Is Modifierfalse
            Summaryfalse
            Requirements

            Human contact for the organization.

            Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
            org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
            SlicingThis element introduces a set of slices on Organization.telecom. The slices areUnordered and Open, and can be differentiated using the following discriminators:
            • profile @ $this
            • 38. Organization.telecom:telephoneNumbers
              Slice NametelephoneNumbers
              Definition

              Details for all kinds of technology mediated contact points for a person or organization, including telephone, email, etc.

              ShortTelephoneNumbers
              Comments

              Implementation of the "TelephoneNumbers" concept of zib ContactInformation.

              Please note that, although the zib concepts TelecomType and NumberType are functionally equivalent to the FHIR concepts ContactPoint.system and ContactPoint.use respectively, a mismatch occurs on the concept of mobile phone numbers; the zib uses the first concept and FHIR the second. For this reason, the ValueSet on ContactPoint.system is too narrow and the zib code will need to be communicated using the ext-CodeSpecification extension.

              Control0..*
              This element is affected by the following invariants: org-3, ele-1
              TypeContactPoint(nl core ContactInformation TelephoneNumbers)
              Is Modifierfalse
              Standard StatusNormative (from Trial Use)
              Summaryfalse
              Requirements

              Human contact for the organization.

              Alternate NamesTelefoonnummers, nl-core-ContactInformation-TelephoneNumbers
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
              cpt-2: A system is required if a value is provided. (value.empty() or system.exists())
              40. Organization.telecom:emailAddresses
              Slice NameemailAddresses
              Definition

              Details for all kinds of technology mediated contact points for a person or organization, including telephone, email, etc.

              ShortEmailAddresses
              Comments

              Implementation of the "EmailAddresses" concept of zib ContactInformation.

              Control0..*
              This element is affected by the following invariants: org-3, ele-1
              TypeContactPoint(nl core ContactInformation EmailAddresses)
              Is Modifierfalse
              Standard StatusNormative (from Trial Use)
              Summaryfalse
              Requirements

              Human contact for the organization.

              Alternate NamesEmailAdressen, nl-core-ContactInformation-EmailAddresses
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              org-3: The telecom of an organization can never be of use 'home' (where(use = 'home').empty())
              cpt-2: A system is required if a value is provided. (value.empty() or system.exists())
              42. Organization.address
              Definition

              An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations which might not be valid for mail delivery. There are a variety of postal address formats defined around the world.

              ShortAddressInformation
              Comments

              This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Dutch addresses specifically, according to the zib AddressInformation v1.1 (2020). A Dutch Address still is a proper FHIR Address, which means that systems that cannot interpret the extensions will still be able to render and work with this datatype.

              To have true compatibility an implementer SHOULD use the core Address parts as intended. To have addresses work for Dutch context, the implementer SHOULD in addition use the extension elements.

              Separate address parts

              The first addition is that Dutch addresses make certain address parts separately communicable. These parts are required for use in true Dutch systems when dealing with Dutch addresses, but may not have value for international systems when information gets sent abroad.

              Custom address types

              The second addition is that the zib defines its own ValueSet for address types, which can only be partially expressed using the FHIR Address datatype and requires a mapping to multiple elements. The table below explains how the zib concepts are mapped to the various FHIR elements (see the ConceptMaps http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse and http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType as well). The code from the zib should also be included using the extension on Address.extension:addressType.

              zib .ext:addressType .use .type
              Postal Address/Postadres PST postal
              Primary Home/Officieel adres HP home both
              Visit Address/Woon-/verblijfadres PHYS home physical
              Temporary Address/Tijdelijk adres TMP temp
              Work Place/Werkadres WP work
              Vacation Home/Vakantie adres HV temp

              If Address.type is both then this is to be understood as a dual purpose address (postal and physical), unless a specific postal type address is added. Systems that support importing it like this are encouraged to do so, otherwise they may need to import this as two separate addresses.

              Note: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the zib ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

              Control0..*
              This element is affected by the following invariants: org-2, ele-1
              TypeAddress(nl core AddressInformation)
              Is Modifierfalse
              Summaryfalse
              Requirements

              May need to keep track of the organization's addresses for contacting, billing or reporting requirements.

              Alternate NamesAdresgegevens, nl-core-AddressInformation
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              org-2: An address of an organization can never be of use 'home' (where(use = 'home').empty())
              44. Organization.partOf
              Definition

              The organization of which this organization forms a part.

              ShortThe organization of which this organization forms a part
              Control0..1
              TypeReference(Organization, nl core HealthcareProvider Organization)
              Is Modifierfalse
              Summarytrue
              Requirements

              Need to be able to track the hierarchy of organizations within an organization.

              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              46. Organization.contact
              Definition

              Contact for the organization for a certain purpose.

              ShortContact for the organization for a certain purpose
              Comments

              Where multiple contacts for the same purpose are provided there is a standard extension that can be used to determine which one is the preferred contact to use.

              Control0..*
              TypeBackboneElement
              Is Modifierfalse
              Summaryfalse
              Requirements

              Need to keep track of assigned contact points within bigger organization.

              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              48. Organization.contact.id
              Definition

              Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.

              ShortUnique id for inter-element referencing
              Control0..1
              Typestring
              Is Modifierfalse
              XML FormatIn the XML format, this property is represented as an attribute.
              Summaryfalse
              50. Organization.contact.extension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.

              ShortAdditional content defined by implementations
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Is Modifierfalse
              Summaryfalse
              Alternate Namesextensions, user content
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
              52. Organization.contact.modifierExtension
              Definition

              May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.

              Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).

              ShortExtensions that cannot be ignored even if unrecognized
              Comments

              There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.

              Control0..*
              TypeExtension
              Is Modifiertrue because Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
              Summarytrue
              Requirements

              Modifier extensions allow for extensions that cannot be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the definition of modifier extensions.

              Alternate Namesextensions, user content, modifiers
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              ext-1: Must have either extensions or value[x], not both (extension.exists() != value.exists())
              54. Organization.contact.purpose
              Definition

              Indicates a purpose for which the contact can be reached.

              ShortThe type of contact
              Control0..1
              BindingUnless not suitable, these codes SHALL be taken from ContactEntityType
              (extensible to http://hl7.org/fhir/ValueSet/contactentity-type)

              The purpose for which you would contact a contact party.

              TypeCodeableConcept
              Is Modifierfalse
              Summaryfalse
              Requirements

              Need to distinguish between multiple contact persons.

              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              56. Organization.contact.name
              Definition

              This slice represents the person's official name information, including given names, last name and possibly the partner's last name.

              ShortNameInformation
              Comments

              This .name element accomodates the official parts of a Dutch name according to common international usage and optionally to the zib NameInformation v1.1 (2020). An official Dutch name is represented in FHIR as an ordinary international name, optionally augmented using extensions to specify how the last name is built up according to the Dutch rules if conformance to the zib is required. See the guidance on .family and on .extension:nameUsage for more information.

              Systems that need to work in a Dutch context SHOULD support the extensions as specified in .given, .family and .extension:nameUsage. In addition, systems SHOULD use the core elements according to the FHIR specifications to provide compatibility outside Dutch contexts. This means that:

              • 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.
              • If parts of the family name are specified using the extensions in .family, the .family element SHOULD be populated with the full family name.

              Note 1: The zib cannot be represented straightforward in FHIR. Especially note the guidance on .given on how to map the FirstNames and Initials concepts, and on .prefix/.suffix on how to map the Titles concept.

              Note 2: This element should only contain a person's official names. The GivenName concept is represented in another .name element with .name.use = usual.

              Note 3: The examples illustrate how the zib is mapped to FHIR.

              Control0..1
              This element is affected by the following invariants: ele-1
              TypeHumanName(nl core NameInformation)
              Is Modifierfalse
              Summaryfalse
              Requirements

              Need to be able to track the person by name.

              Alternate NamesNaamgegevens, nl-core-NameInformation
              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              zib-NameInformation-1: 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: 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())
              nl-core-NameInformation-01: 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())
              58. Organization.contact.telecom
              Definition

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

              ShortContact details (telephone, email, etc.) for a contact
              Control0..*
              TypeContactPoint
              Is Modifierfalse
              Summaryfalse
              Requirements

              People have (primary) ways to contact them in some way such as phone, email.

              Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
              SlicingThis element introduces a set of slices on Organization.contact.telecom. The slices areUnordered and Open, and can be differentiated using the following discriminators:
              • profile @ $this
              • 60. Organization.contact.telecom:telephoneNumbers
                Slice NametelephoneNumbers
                Definition

                Details for all kinds of technology mediated contact points for a person or organization, including telephone, email, etc.

                ShortTelephoneNumbers
                Comments

                Implementation of the "TelephoneNumbers" concept of zib ContactInformation.

                Please note that, although the zib concepts TelecomType and NumberType are functionally equivalent to the FHIR concepts ContactPoint.system and ContactPoint.use respectively, a mismatch occurs on the concept of mobile phone numbers; the zib uses the first concept and FHIR the second. For this reason, the ValueSet on ContactPoint.system is too narrow and the zib code will need to be communicated using the ext-CodeSpecification extension.

                Control0..*
                This element is affected by the following invariants: ele-1
                TypeContactPoint(nl core ContactInformation TelephoneNumbers)
                Is Modifierfalse
                Standard StatusNormative (from Trial Use)
                Summaryfalse
                Requirements

                People have (primary) ways to contact them in some way such as phone, email.

                Alternate NamesTelefoonnummers, nl-core-ContactInformation-TelephoneNumbers
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                cpt-2: A system is required if a value is provided. (value.empty() or system.exists())
                62. Organization.contact.telecom:emailAddresses
                Slice NameemailAddresses
                Definition

                Details for all kinds of technology mediated contact points for a person or organization, including telephone, email, etc.

                ShortEmailAddresses
                Comments

                Implementation of the "EmailAddresses" concept of zib ContactInformation.

                Control0..*
                This element is affected by the following invariants: ele-1
                TypeContactPoint(nl core ContactInformation EmailAddresses)
                Is Modifierfalse
                Standard StatusNormative (from Trial Use)
                Summaryfalse
                Requirements

                People have (primary) ways to contact them in some way such as phone, email.

                Alternate NamesEmailAdressen, nl-core-ContactInformation-EmailAddresses
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                cpt-2: A system is required if a value is provided. (value.empty() or system.exists())
                64. Organization.contact.address
                Definition

                An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations which might not be valid for mail delivery. There are a variety of postal address formats defined around the world.

                ShortAddressInformation
                Comments

                This datatype defines a common basis for expressing all addresses around the world, but adds extensions to express Dutch addresses specifically, according to the zib AddressInformation v1.1 (2020). A Dutch Address still is a proper FHIR Address, which means that systems that cannot interpret the extensions will still be able to render and work with this datatype.

                To have true compatibility an implementer SHOULD use the core Address parts as intended. To have addresses work for Dutch context, the implementer SHOULD in addition use the extension elements.

                Separate address parts

                The first addition is that Dutch addresses make certain address parts separately communicable. These parts are required for use in true Dutch systems when dealing with Dutch addresses, but may not have value for international systems when information gets sent abroad.

                Custom address types

                The second addition is that the zib defines its own ValueSet for address types, which can only be partially expressed using the FHIR Address datatype and requires a mapping to multiple elements. The table below explains how the zib concepts are mapped to the various FHIR elements (see the ConceptMaps http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressUse and http://nictiz.nl/fhir/ConceptMap/AdresSoortCodelijst-to-AddressType as well). The code from the zib should also be included using the extension on Address.extension:addressType.

                zib .ext:addressType .use .type
                Postal Address/Postadres PST postal
                Primary Home/Officieel adres HP home both
                Visit Address/Woon-/verblijfadres PHYS home physical
                Temporary Address/Tijdelijk adres TMP temp
                Work Place/Werkadres WP work
                Vacation Home/Vakantie adres HV temp

                If Address.type is both then this is to be understood as a dual purpose address (postal and physical), unless a specific postal type address is added. Systems that support importing it like this are encouraged to do so, otherwise they may need to import this as two separate addresses.

                Note: FHIR core defines the AD-use extension to further specify the postal address type. However, the ValueSet used in that extension doesn't completely match the zib ValueSet. Therefore, a custom extension has been made. This doesn't preclude the use of the AD-use extension.

                Control0..1
                This element is affected by the following invariants: ele-1
                TypeAddress(nl core AddressInformation)
                Is Modifierfalse
                Summaryfalse
                Requirements

                May need to keep track of a contact party's address for contacting, billing or reporting requirements.

                Alternate NamesAdresgegevens, nl-core-AddressInformation
                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))
                66. Organization.endpoint
                Definition

                Technical endpoints providing access to services operated for the organization.

                ShortTechnical endpoints providing access to services operated for the organization
                Control0..*
                TypeReference(Endpoint)
                Is Modifierfalse
                Summaryfalse
                Requirements

                Organizations have multiple systems that provide various services and need to be able to define the technical connection details for how to connect to them, and for what purpose.

                Invariantsele-1: All FHIR elements must have a @value or children (hasValue() or (children().count() > id.count()))