Netherlands - Generic Functions for data exchange Implementation Guide
0.2.0 - ci-build
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
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
Description of Profiles, Differentials, Snapshots and how the different presentations work.
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
0..* | Endpoint | The technical details of an endpoint that can be used for electronic services | |
![]() ![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() |
0..* | Reference(Endpoint) | Replaced By Endpoint URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint | |
![]() ![]() ![]() |
?!Σ | 1..1 | code | active | suspended | error | off | entered-in-error | test Binding: EndpointStatus (required): The status of the endpoint. |
![]() ![]() ![]() |
Σ | 1..1 | Coding | Protocol/Profile/Standard to be used with this endpoint connection Binding: EndpointConnectionType (extensible) |
![]() ![]() ![]() |
Σ | 1..1 | Reference(Organization) | Organization that manages this endpoint (might not be the organization that exposes the endpoint) |
![]() ![]() ![]() |
Σ | 1..* | CodeableConcept | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) Binding: NL GF Payload Types (required) |
![]() ![]() ![]() |
ΣC | 1..1 | url | The technical base address for connecting to this endpoint Constraints: address-immutable |
![]() |
Path | Conformance | ValueSet | URI |
Endpoint.status | required | EndpointStatushttp://hl7.org/fhir/ValueSet/endpoint-status|4.0.1 From the FHIR Standard | |
Endpoint.connectionType | extensible | EndpointConnectionTypehttp://hl7.org/fhir/ValueSet/endpoint-connection-type From the FHIR Standard | |
Endpoint.payloadType | required | NLGfPayloadTypeshttp://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types From this IG |
Id | Grade | Path(s) | Details | Requirements |
address-immutable | error | Endpoint.address | This address field must not be updated after creation of the Endpoint instance : | |
dom-2 | error | Endpoint | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | Endpoint | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() | |
dom-4 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() | |
dom-5 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | Endpoint | A resource should have narrative for robust management : text.`div`.exists() | |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |
This structure is derived from Endpoint
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
0..* | Endpoint | The technical details of an endpoint that can be used for electronic services | |
![]() ![]() ![]() |
0..0 | |||
![]() ![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() |
0..* | Reference(Endpoint) | Replaced By Endpoint URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint | |
![]() ![]() ![]() |
0..0 | |||
![]() ![]() ![]() |
1..1 | Reference(Organization) | Organization that manages this endpoint (might not be the organization that exposes the endpoint) | |
![]() ![]() ![]() |
1..* | CodeableConcept | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) Binding: NL GF Payload Types (required) | |
![]() ![]() ![]() |
C | 1..1 | url | The technical base address for connecting to this endpoint Constraints: address-immutable |
![]() |
Path | Conformance | ValueSet | URI |
Endpoint.payloadType | required | NLGfPayloadTypeshttp://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types From this IG |
Id | Grade | Path(s) | Details | Requirements |
address-immutable | error | Endpoint.address | This address field must not be updated after creation of the Endpoint instance : |
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||
---|---|---|---|---|---|---|---|---|
![]() ![]() |
0..* | Endpoint | The technical details of an endpoint that can be used for electronic services | |||||
![]() ![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() ![]() |
Σ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
![]() ![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() ![]() |
0..* | Reference(Endpoint) | Replaced By Endpoint URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint | |||||
![]() ![]() ![]() |
Σ | 0..* | Identifier | Identifies this endpoint across multiple systems | ||||
![]() ![]() ![]() |
?!Σ | 1..1 | code | active | suspended | error | off | entered-in-error | test Binding: EndpointStatus (required): The status of the endpoint. | ||||
![]() ![]() ![]() |
Σ | 1..1 | Coding | Protocol/Profile/Standard to be used with this endpoint connection Binding: EndpointConnectionType (extensible) | ||||
![]() ![]() ![]() |
Σ | 0..1 | string | A name that this endpoint can be identified by | ||||
![]() ![]() ![]() |
Σ | 1..1 | Reference(Organization) | Organization that manages this endpoint (might not be the organization that exposes the endpoint) | ||||
![]() ![]() ![]() |
0..* | ContactPoint | Contact details for source (e.g. troubleshooting) | |||||
![]() ![]() ![]() |
Σ | 0..1 | Period | Interval the endpoint is expected to be operational | ||||
![]() ![]() ![]() |
Σ | 1..* | CodeableConcept | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) Binding: NL GF Payload Types (required) | ||||
![]() ![]() ![]() |
Σ | 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. | ||||
![]() ![]() ![]() |
ΣC | 1..1 | url | The technical base address for connecting to this endpoint Constraints: address-immutable | ||||
![]() ![]() ![]() |
0..* | string | Usage depends on the channel type | |||||
![]() |
Path | Conformance | ValueSet | URI | |||
Endpoint.language | preferred | CommonLanguageshttp://hl7.org/fhir/ValueSet/languages From the FHIR Standard
| ||||
Endpoint.status | required | EndpointStatushttp://hl7.org/fhir/ValueSet/endpoint-status|4.0.1 From the FHIR Standard | ||||
Endpoint.connectionType | extensible | EndpointConnectionTypehttp://hl7.org/fhir/ValueSet/endpoint-connection-type From the FHIR Standard | ||||
Endpoint.payloadType | required | NLGfPayloadTypeshttp://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types From this IG | ||||
Endpoint.payloadMimeType | required | Mime Types(a valid code from urn:ietf:bcp:13 )http://hl7.org/fhir/ValueSet/mimetypes|4.0.1 From the FHIR Standard |
Id | Grade | Path(s) | Details | Requirements |
address-immutable | error | Endpoint.address | This address field must not be updated after creation of the Endpoint instance : | |
dom-2 | error | Endpoint | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | Endpoint | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() | |
dom-4 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() | |
dom-5 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | Endpoint | A resource should have narrative for robust management : text.`div`.exists() | |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |
This structure is derived from Endpoint
Key Elements View
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
0..* | Endpoint | The technical details of an endpoint that can be used for electronic services | |
![]() ![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() |
0..* | Reference(Endpoint) | Replaced By Endpoint URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint | |
![]() ![]() ![]() |
?!Σ | 1..1 | code | active | suspended | error | off | entered-in-error | test Binding: EndpointStatus (required): The status of the endpoint. |
![]() ![]() ![]() |
Σ | 1..1 | Coding | Protocol/Profile/Standard to be used with this endpoint connection Binding: EndpointConnectionType (extensible) |
![]() ![]() ![]() |
Σ | 1..1 | Reference(Organization) | Organization that manages this endpoint (might not be the organization that exposes the endpoint) |
![]() ![]() ![]() |
Σ | 1..* | CodeableConcept | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) Binding: NL GF Payload Types (required) |
![]() ![]() ![]() |
ΣC | 1..1 | url | The technical base address for connecting to this endpoint Constraints: address-immutable |
![]() |
Path | Conformance | ValueSet | URI |
Endpoint.status | required | EndpointStatushttp://hl7.org/fhir/ValueSet/endpoint-status|4.0.1 From the FHIR Standard | |
Endpoint.connectionType | extensible | EndpointConnectionTypehttp://hl7.org/fhir/ValueSet/endpoint-connection-type From the FHIR Standard | |
Endpoint.payloadType | required | NLGfPayloadTypeshttp://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types From this IG |
Id | Grade | Path(s) | Details | Requirements |
address-immutable | error | Endpoint.address | This address field must not be updated after creation of the Endpoint instance : | |
dom-2 | error | Endpoint | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | Endpoint | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() | |
dom-4 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() | |
dom-5 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | Endpoint | A resource should have narrative for robust management : text.`div`.exists() | |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |
Differential View
This structure is derived from Endpoint
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() |
---|---|---|---|---|
![]() ![]() |
0..* | Endpoint | The technical details of an endpoint that can be used for electronic services | |
![]() ![]() ![]() |
0..0 | |||
![]() ![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |
![]() ![]() ![]() ![]() |
0..* | Reference(Endpoint) | Replaced By Endpoint URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint | |
![]() ![]() ![]() |
0..0 | |||
![]() ![]() ![]() |
1..1 | Reference(Organization) | Organization that manages this endpoint (might not be the organization that exposes the endpoint) | |
![]() ![]() ![]() |
1..* | CodeableConcept | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) Binding: NL GF Payload Types (required) | |
![]() ![]() ![]() |
C | 1..1 | url | The technical base address for connecting to this endpoint Constraints: address-immutable |
![]() |
Path | Conformance | ValueSet | URI |
Endpoint.payloadType | required | NLGfPayloadTypeshttp://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types From this IG |
Id | Grade | Path(s) | Details | Requirements |
address-immutable | error | Endpoint.address | This address field must not be updated after creation of the Endpoint instance : |
Snapshot View
Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||
---|---|---|---|---|---|---|---|---|
![]() ![]() |
0..* | Endpoint | The technical details of an endpoint that can be used for electronic services | |||||
![]() ![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||
![]() ![]() ![]() |
Σ | 0..1 | Meta | Metadata about the resource | ||||
![]() ![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (preferred): A human language.
| |||||
![]() ![]() ![]() |
0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||
![]() ![]() ![]() |
0..* | Resource | Contained, inline Resources | |||||
![]() ![]() ![]() |
0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||
![]() ![]() ![]() ![]() |
0..* | Reference(Endpoint) | Replaced By Endpoint URL: http://nuts-foundation.github.io/nl-generic-functions-ig/StructureDefinition/replaced-by-endpoint | |||||
![]() ![]() ![]() |
Σ | 0..* | Identifier | Identifies this endpoint across multiple systems | ||||
![]() ![]() ![]() |
?!Σ | 1..1 | code | active | suspended | error | off | entered-in-error | test Binding: EndpointStatus (required): The status of the endpoint. | ||||
![]() ![]() ![]() |
Σ | 1..1 | Coding | Protocol/Profile/Standard to be used with this endpoint connection Binding: EndpointConnectionType (extensible) | ||||
![]() ![]() ![]() |
Σ | 0..1 | string | A name that this endpoint can be identified by | ||||
![]() ![]() ![]() |
Σ | 1..1 | Reference(Organization) | Organization that manages this endpoint (might not be the organization that exposes the endpoint) | ||||
![]() ![]() ![]() |
0..* | ContactPoint | Contact details for source (e.g. troubleshooting) | |||||
![]() ![]() ![]() |
Σ | 0..1 | Period | Interval the endpoint is expected to be operational | ||||
![]() ![]() ![]() |
Σ | 1..* | CodeableConcept | The type of content that may be used at this endpoint (e.g. XDS Discharge summaries) Binding: NL GF Payload Types (required) | ||||
![]() ![]() ![]() |
Σ | 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. | ||||
![]() ![]() ![]() |
ΣC | 1..1 | url | The technical base address for connecting to this endpoint Constraints: address-immutable | ||||
![]() ![]() ![]() |
0..* | string | Usage depends on the channel type | |||||
![]() |
Path | Conformance | ValueSet | URI | |||
Endpoint.language | preferred | CommonLanguageshttp://hl7.org/fhir/ValueSet/languages From the FHIR Standard
| ||||
Endpoint.status | required | EndpointStatushttp://hl7.org/fhir/ValueSet/endpoint-status|4.0.1 From the FHIR Standard | ||||
Endpoint.connectionType | extensible | EndpointConnectionTypehttp://hl7.org/fhir/ValueSet/endpoint-connection-type From the FHIR Standard | ||||
Endpoint.payloadType | required | NLGfPayloadTypeshttp://nuts-foundation.github.io/nl-generic-functions-ig/ValueSet/nl-gf-payload-types From this IG | ||||
Endpoint.payloadMimeType | required | Mime Types(a valid code from urn:ietf:bcp:13 )http://hl7.org/fhir/ValueSet/mimetypes|4.0.1 From the FHIR Standard |
Id | Grade | Path(s) | Details | Requirements |
address-immutable | error | Endpoint.address | This address field must not be updated after creation of the Endpoint instance : | |
dom-2 | error | Endpoint | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
dom-3 | error | Endpoint | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource : contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty() | |
dom-4 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty() | |
dom-5 | error | Endpoint | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
dom-6 | best practice | Endpoint | A resource should have narrative for robust management : text.`div`.exists() | |
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children : hasValue() or (children().count() > id.count()) | |
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both : extension.exists() != value.exists() |
This structure is derived from Endpoint
Other representations of profile: CSV, Excel, Schematron