Netherlands - Generic Functions for data exchange Implementation Guide
0.2.0 - ci-build Netherlands flag

Netherlands - Generic Functions for data exchange Implementation Guide, published by Stichting Nuts. This guide is not an authorized publication; it is the continuous build for version 0.2.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/nuts-foundation/nl-generic-functions-ig/ and changes regularly. See the Directory of published versions

Resource Profile: NL Generic Functions Endpoint Profile ( Experimental )

Official URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/nl-gf-endpoint Version: 0.2.0
Draft as of 2025-09-03 Computable Name: NlGfEndpoint

The technical details of an endpoint that can be used for electronic services, such as for web services providing access to FHIR resources.

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Endpoint 0..* Endpoint The technical details of an endpoint that can be used for electronic services
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:replacedBy 0..* Reference(Endpoint) Replaced By Endpoint
URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint
... status ?!Σ 1..1 code active | suspended | error | off | entered-in-error | test
Binding: EndpointStatus (required): The status of the endpoint.
... connectionType Σ 1..1 Coding Protocol/Profile/Standard to be used with this endpoint connection
Binding: EndpointConnectionType (extensible)
... payloadType Σ 1..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
Binding: NL GF Payload Types (required)
... address ΣC 1..1 url The technical base address for connecting to this endpoint
Constraints: address-immutable

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Endpoint.statusrequiredEndpointStatus
http://hl7.org/fhir/ValueSet/endpoint-status|4.0.1
From the FHIR Standard
Endpoint.connectionTypeextensibleEndpointConnectionType
http://hl7.org/fhir/ValueSet/endpoint-connection-type
From the FHIR Standard
Endpoint.payloadTyperequiredNLGfPayloadTypes
http://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types
From this IG

Constraints

IdGradePath(s)DetailsRequirements
address-immutableerrorEndpoint.addressThis address field must not be updated after creation of the Endpoint instance
:
dom-2errorEndpointIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEndpointIf 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-4errorEndpointIf 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-5errorEndpointIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEndpointA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from Endpoint

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Endpoint 0..* Endpoint The technical details of an endpoint that can be used for electronic services
... implicitRules 0..0
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:replacedBy 0..* Reference(Endpoint) Replaced By Endpoint
URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint
... modifierExtension 0..0
... payloadType 1..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
Binding: NL GF Payload Types (required)
... address C 1..1 url The technical base address for connecting to this endpoint
Constraints: address-immutable

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Endpoint.payloadTyperequiredNLGfPayloadTypes
http://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types
From this IG

Constraints

IdGradePath(s)DetailsRequirements
address-immutableerrorEndpoint.addressThis address field must not be updated after creation of the Endpoint instance
:
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Endpoint 0..* Endpoint The technical details of an endpoint that can be used for electronic services
... 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 BindingsPurpose
AllLanguages Max Binding
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:replacedBy 0..* Reference(Endpoint) Replaced By Endpoint
URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint
... identifier Σ 0..* Identifier Identifies this endpoint across multiple systems
... status ?!Σ 1..1 code active | suspended | error | off | entered-in-error | test
Binding: EndpointStatus (required): The status of the endpoint.
... connectionType Σ 1..1 Coding Protocol/Profile/Standard to be used with this endpoint connection
Binding: EndpointConnectionType (extensible)
... name Σ 0..1 string A name that this endpoint can be identified by
... managingOrganization Σ 1..1 Reference(Organization) Organization that manages this endpoint (might not be the organization that exposes the endpoint)
... contact 0..* ContactPoint Contact details for source (e.g. troubleshooting)
... period Σ 0..1 Period Interval the endpoint is expected to be operational
... payloadType Σ 1..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
Binding: NL GF Payload Types (required)
... payloadMimeType Σ 0..* code Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this)
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.
... address ΣC 1..1 url The technical base address for connecting to this endpoint
Constraints: address-immutable
... header 0..* string Usage depends on the channel type

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Endpoint.languagepreferredCommonLanguages
http://hl7.org/fhir/ValueSet/languages
From the FHIR Standard
Additional Bindings Purpose
AllLanguages Max Binding
Endpoint.statusrequiredEndpointStatus
http://hl7.org/fhir/ValueSet/endpoint-status|4.0.1
From the FHIR Standard
Endpoint.connectionTypeextensibleEndpointConnectionType
http://hl7.org/fhir/ValueSet/endpoint-connection-type
From the FHIR Standard
Endpoint.payloadTyperequiredNLGfPayloadTypes
http://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types
From this IG
Endpoint.payloadMimeTyperequiredMime Types(a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
address-immutableerrorEndpoint.addressThis address field must not be updated after creation of the Endpoint instance
:
dom-2errorEndpointIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEndpointIf 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-4errorEndpointIf 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-5errorEndpointIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEndpointA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from Endpoint

Summary

Mandatory: 1 element
Prohibited: 2 elements

Extensions

This structure refers to these extensions:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Endpoint 0..* Endpoint The technical details of an endpoint that can be used for electronic services
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:replacedBy 0..* Reference(Endpoint) Replaced By Endpoint
URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint
... status ?!Σ 1..1 code active | suspended | error | off | entered-in-error | test
Binding: EndpointStatus (required): The status of the endpoint.
... connectionType Σ 1..1 Coding Protocol/Profile/Standard to be used with this endpoint connection
Binding: EndpointConnectionType (extensible)
... payloadType Σ 1..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
Binding: NL GF Payload Types (required)
... address ΣC 1..1 url The technical base address for connecting to this endpoint
Constraints: address-immutable

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Endpoint.statusrequiredEndpointStatus
http://hl7.org/fhir/ValueSet/endpoint-status|4.0.1
From the FHIR Standard
Endpoint.connectionTypeextensibleEndpointConnectionType
http://hl7.org/fhir/ValueSet/endpoint-connection-type
From the FHIR Standard
Endpoint.payloadTyperequiredNLGfPayloadTypes
http://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types
From this IG

Constraints

IdGradePath(s)DetailsRequirements
address-immutableerrorEndpoint.addressThis address field must not be updated after creation of the Endpoint instance
:
dom-2errorEndpointIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEndpointIf 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-4errorEndpointIf 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-5errorEndpointIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEndpointA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Differential View

This structure is derived from Endpoint

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Endpoint 0..* Endpoint The technical details of an endpoint that can be used for electronic services
... implicitRules 0..0
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:replacedBy 0..* Reference(Endpoint) Replaced By Endpoint
URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint
... modifierExtension 0..0
... payloadType 1..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
Binding: NL GF Payload Types (required)
... address C 1..1 url The technical base address for connecting to this endpoint
Constraints: address-immutable

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSetURI
Endpoint.payloadTyperequiredNLGfPayloadTypes
http://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types
From this IG

Constraints

IdGradePath(s)DetailsRequirements
address-immutableerrorEndpoint.addressThis address field must not be updated after creation of the Endpoint instance
:

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Endpoint 0..* Endpoint The technical details of an endpoint that can be used for electronic services
... 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 BindingsPurpose
AllLanguages Max Binding
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:replacedBy 0..* Reference(Endpoint) Replaced By Endpoint
URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint
... identifier Σ 0..* Identifier Identifies this endpoint across multiple systems
... status ?!Σ 1..1 code active | suspended | error | off | entered-in-error | test
Binding: EndpointStatus (required): The status of the endpoint.
... connectionType Σ 1..1 Coding Protocol/Profile/Standard to be used with this endpoint connection
Binding: EndpointConnectionType (extensible)
... name Σ 0..1 string A name that this endpoint can be identified by
... managingOrganization Σ 1..1 Reference(Organization) Organization that manages this endpoint (might not be the organization that exposes the endpoint)
... contact 0..* ContactPoint Contact details for source (e.g. troubleshooting)
... period Σ 0..1 Period Interval the endpoint is expected to be operational
... payloadType Σ 1..* CodeableConcept The type of content that may be used at this endpoint (e.g. XDS Discharge summaries)
Binding: NL GF Payload Types (required)
... payloadMimeType Σ 0..* code Mimetype to send. If not specified, the content could be anything (including no payload, if the connectionType defined this)
Binding: Mime Types (required): The mime type of an attachment. Any valid mime type is allowed.
... address ΣC 1..1 url The technical base address for connecting to this endpoint
Constraints: address-immutable
... header 0..* string Usage depends on the channel type

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
Endpoint.languagepreferredCommonLanguages
http://hl7.org/fhir/ValueSet/languages
From the FHIR Standard
Additional Bindings Purpose
AllLanguages Max Binding
Endpoint.statusrequiredEndpointStatus
http://hl7.org/fhir/ValueSet/endpoint-status|4.0.1
From the FHIR Standard
Endpoint.connectionTypeextensibleEndpointConnectionType
http://hl7.org/fhir/ValueSet/endpoint-connection-type
From the FHIR Standard
Endpoint.payloadTyperequiredNLGfPayloadTypes
http://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types
From this IG
Endpoint.payloadMimeTyperequiredMime Types(a valid code from urn:ietf:bcp:13)
http://hl7.org/fhir/ValueSet/mimetypes|4.0.1
From the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
address-immutableerrorEndpoint.addressThis address field must not be updated after creation of the Endpoint instance
:
dom-2errorEndpointIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEndpointIf 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-4errorEndpointIf 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-5errorEndpointIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEndpointA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from Endpoint

Summary

Mandatory: 1 element
Prohibited: 2 elements

Extensions

This structure refers to these extensions:

 

Other representations of profile: CSV, Excel, Schematron