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

Netherlands - Generic Functions for data exchange Implementation Guide - Local Development build (v0.2.0-ballot) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Artifacts Summary

This page provides a list of the FHIR artifacts defined as part of this implementation guide.

Behavior: Capability Statements

The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.

Directory capability [ITI-130-NL] for a Data Source actor

ITI-130-NL; Dutch profile of the IHE ITI-130 endpoint

Directory capability [ITI-90-NL] for a Query Client actor

ITI-90-NL; Dutch profile of the IHE ITI mCSD ITI-90 endpoint. Note that this CapabilityStatement excludes nearly all search parameters. This search interaction SHOULD only be used to retrieve the latest state of all resources of a specific type.

Directory capability [ITI-91-NL] for an Update Client actor

ITI-91-NL; Dutch profile of the IHE ITI mCSD ITI-91 endpoint.

Localization Service (List)

Dutch profile of the CapabilityStatement for a Localization Service using the List resource.

Structures: Logical Models

These define data models that represent the domain covered by this implementation guide in more business-friendly terms than the underlying FHIR resources.

KVK Basisprofiel

Logical model representing the KVK (Kamer van Koophandel) Basisprofiel API response structure as defined in the KVK API v1.4.0.

KVK Vestigingsprofiel

Logical model representing the KVK (Kamer van Koophandel) Vestigingsprofiel API response structure as defined in the KVK API v1.4.0.

Structures: Resource Profiles

These define constraints on FHIR resources for systems conforming to this implementation guide.

NL Generic Functions Device Profile

The details of a device, such as a software application, used in the context of healthcare data exchange.

NL Generic Functions Endpoint Profile

Endpoint profile for electronic services, aligned with IHE mCSD Endpoint constraints and extended with a value set constraint on payloadType and connectionType.

NL Generic Functions HealthcareService Profile

HealthcareService profile aligned with IHE mCSD HealthcareService constraints, with required value set bindings on type and specialty, support for ActivityDefinition/PlanDefinition references on type, and a required custodian-assigned identifier.

NL Generic Functions Localization List Profile

A List profile for registering the availability of patient data at healthcare organizations for localization services. This profile is used to indicate that certain patient data is available at a specific organization and can be accessed for localization purposes.

NL Generic Functions Location Profile

Location profile based on NL Core Location and aligned with IHE mCSD Location constraints, with a required custodian-assigned identifier.

NL Generic Functions Organization Profile

Organization profile based on NL Core Healthcare Provider Organization and aligned with IHE mCSD Organization constraints, extended with CBS Standaard Bedrijfsindeling (SBI) typing.

NL Generic Functions OrganizationAffiliation Profile

OrganizationAffiliation profile aligned with IHE mCSD OrganizationAffiliation constraints, with a required custodian-assigned identifier and extended with a value set constraint on code and support for device identifiers in extensions.

NL Generic Functions Practitioner Profile

Practitioner profile based on NL Core HealthProfessional Practitioner and aligned with IHE mCSD Practitioner constraints.

NL Generic Functions PractitionerRole Profile

PractitionerRole profile based on NL Core HealthProfessional PractitionerRole and aligned with IHE mCSD PractitionerRole constraints, with a required custodian-assigned identifier.

NL Generic Functions Task Profile for FHIR STU3

A task to be performed, such as a referral or order, with additional details specific to FHIR STU3.

Structures: Data Type Profiles

These define constraints on FHIR data types for systems conforming to this implementation guide.

Custodian Assigned Identifier

Data objects are frequently copied, federated, or accessed through intermediary platforms, which complicates provenance tracking, authenticity verification, and long-term traceability to the original source. To preserve provenance and avoid uncontrolled duplication, each original object SHALL be assigned an identifier by its original custodian (the accountable source). The custodian-assigned identifier uniquely identifies the resource and enables resolution to the originating organization when copies are stored in other systems. This pattern is used throughout this IG, including NL-GF-Organization and NL-GF-HealthcareService, and in example resources such as Organization (department), Condition, and Task.

Custodian Assigned URN Identifier

Data objects are identified by an identifier that was assigned by the original custodian. The custodian is 'The entity that is accountable for maintaining a true an accurate copy of the original record'. I.e. this custodian is responsible for the 'single source of truth' for this data object. The 'custodian-assigned-identifier' is the unambiguous and persistent identifier for both the data object and the custodian.

NVI Identifier

Identifier for pseudonymized Dutch citizen service numbers (BSN).

Structures: Extension Definitions

These define constraints on FHIR data types for systems conforming to this implementation guide.

HealthcareService for Task in STU3

The healthcare service where the task is performed.

Location for Task in STU3

The location where the task is performed.

NL Generic Functions Device Endpoint

A reference to an endpoint associated with this device.

NL Generic Functions Device Identifier

An identifier for a device, such as a software application.

NL Generic Functions Localization Custodian

The organization responsible for the localization record, identified by URA number.

Supported ActivityDefinitions and PlanDefinitions by HealthcareServices

ActivityDefinitions or PlanDefinitions to specify the codeable concepts in HealthcareService.type.

Terminology: Value Sets

These define sets of codes used by systems conforming to this implementation guide.

AORTA Data Categories ValueSet

The data categories defined in the AORTA code system.

NL GF Authorization Type ValueSet

Authorization types supported by NL Generic Functions.

NL GF Connection Types ValueSet

Authorization and endpoint connection type codes supported by NL Generic Functions.

NL GF Data exchange capabilities

The data exchange capabilities supported

NL GF Organization Types ValueSet

The Organization Types supported by the NL Generic Functions.

NL GF Patient Information Data Categories ValueSet

Data categories (a.k.a. zorgcontext) that map to FHIR resource types containing patient-related clinical or personal health information.

NL GF Service Types ValueSet

The Service Types supported by the NL Generic Functions.

Terminology: Code Systems

These define new code systems used by systems conforming to this implementation guide.

AORTA Data Categories CodeSystem

Local code system for data categories in AORTA.

NL GF Authorization Server CodeSystem

Local code system for authorization and security protocol flavors used on endpoints in NL Generic Functions. Inspired by endpoint-connection-type style coding.

NL GF Authorization Type CodeSystem

Local code system for authorization types used in NL Generic Functions for managing authorization and access control

NL GF Data Categories CodeSystem

Local code system for data categories in NL Generic Functions.

NL GF Standaard Bedrijfsindeling 2025

Standaard Bedrijfsindeling (SBI) 2025 codes. Based on the Dutch SBI 2025 classification system, which is used to classify business activities in the Netherlands. The codes and descriptions are derived from the official SBI 2025 documentation provided by the Dutch government.

Terminology: Naming Systems

These define identifier and/or code system identities used by systems conforming to this implementation guide.

kvk-nummer

This identifier system represents KvK identifiers.

kvk-vestigingsnummer

This identifier system represents KvK vestigingsnummers.

nvi-identifier

This Patient identifier is specific for the NVI and represents a pseudonymized BSN.

Terminology: Structure Maps

These define transformations to convert between data structures used by systems conforming to this implementation guide.

KVK Basisprofiel naar FHIR Organization

StructureMap die een KVK Basisprofiel API response transformeert naar een FHIR Organization resource.

KVK Vestigingsprofiel naar FHIR Location

StructureMap die een KVK Vestigingsprofiel API response transformeert naar een FHIR Location resource.

Terminology: Concept Maps

These define transformations to convert between codes by systems conforming with this implementation guide.

AORTA to NL GF Data Categories

Concept map defining the equivalence between AORTA (Architecture for Organizing Trusted and Reliable Access) data categories and NL Generic Functions (NL-GF) data categories. This mapping enables interoperability between systems using the AORTA terminology and those conforming to the NL-GF framework for healthcare data exchange in the Netherlands.

Example: Example Instances

These are example instances that show what data produced and consumed by systems conforming with this implementation guide might look like.

Authorization: Organization 1 authorizes PharmaPartners

Example: Authorization: Organization 1 authorizes PharmaPartners

Authorization: Organization 2 authorizes Nedap

Example: Authorization: Organization 2 authorizes Nedap

Authorization: Organization 3 authorizes Gerimedica

Example: Authorization: Organization 3 authorizes Gerimedica

Bundle of personal health information in HIS of Organization 1

This bundle contains all personal health information for Patient Jaantje Merkens in Organization 1

Condition hypercalciëmie
Example NL Generic Functions Localization List

Example instance of the NlGfLocalizationList profile. It expresses an Organization with identifier (URA) 22222222 having a Medication request of a patient with a pseudonymised identifier (BSN)

Gerimedica Device for Organization 3

Example: Gerimedica Device for Organization 3

LRZa - Organization 1 - Organization

Example: LRZa - Organization 1 - Organization

LRZa - Organization 2 - Organization

Example: LRZa - Organization 2 - Organization

LRZa - Organization 3 - Organization

Example: LRZa - Organization 3 - Organization

Nedap Device for Organization 2

Example: Nedap Device for Organization 2

Organisation 2 - ServiceRequest Nursing

Request from Organization 2 for nursing care

Organization 1 - Endpoint

Example: Organization 1 - Endpoint

Organization 1 - PractitionerRole Harry Arts

Example: Organization 1 - PractitionerRole Harry Arts

Organization 2 - Endpoint DICOM-WADO-RS

Example: Organization 2 - Endpoint DICOM-WADO-RS

Organization 2 - Endpoint FHIR R4

Example: Organization 2 - Endpoint FHIR R4

Organization 2 - Endpoint FHIR STU3

Example: Organization 2 - Endpoint FHIR STU3

Organization 2 - HealthcareService Geriatrie

Example: Organization 2 - HealthcareService Geriatrie

Organization 2 - HealthcareService Interne Geneeskunde

Example: Organization 2 - HealthcareService Interne Geneeskunde

Organization 2 - HealthcareService Neurochirurgie

Example: Organization 2 - HealthcareService Neurochirurgie

Organization 2 - HealthcareService Orthopedie

Example: Organization 2 - HealthcareService Orthopedie

Organization 2 - HealthcareService Polikliniek 't Vaatje

Example consultation healthcare service named Polikliniek 't Vaatje at Organization 2.

Organization 2 - HealthcareService Urologie

Example: Organization 2 - HealthcareService Urologie

Organization 2 - PractitionerRole Cardioloog Caroline van Dijk at Organization 2

Example: Organization 2 - PractitionerRole Cardioloog Caroline van Dijk at Organization 2

Organization 2 - Task for ServiceRequest Nursing

Task created by Organization 2 to fulfill the ServiceRequest for nursing care at Nursing department at Organization 3

Organization 3 - Endpoint FHIR R4

Example: Organization 3 - Endpoint FHIR R4

Organization 3 - Endpoint FHIR STU3

Example: Organization 3 - Endpoint FHIR STU3

Organization 3 - HealthcareService Geriatrie

Example: Organization 3 - HealthcareService Geriatrie

Organization 3 - HealthcareService Verpleging

Example: Organization 3 - HealthcareService Verpleging

Organization 3 - Location Main Building

Example: Organization 3 - Location Main Building

Organization 3 - Location Verpleeghuis Weltevree

Example location Verpleeghuis Weltevree managed by the nursing department of Organization 3.

Organization 3 - Organization Nursing department

Nursing department at Organization 3

Organization 3 - PractitionerRole Klinisch Geriater John Doe

Example: Organization 3 - PractitionerRole Klinisch Geriater John Doe

Patient Jaantje Merkens

Patient Jaantje Merkens in EHR of Organization 2

PharmaPartners Device for Organization 1

Example: PharmaPartners Device for Organization 1

Practitioner Caroline van Dijk at Organization 2

Example practitioner for Organization 2

Practitioner Harry Arts at Organization 1

Example practitioner for Organization 1

Practitioner John Doe at Organization 3

Example practitioner for Organization 3

Software Vendor - Gerimedica

Example: Software Vendor - Gerimedica

Software Vendor - Nedap

Example: Software Vendor - Nedap

Software Vendor - PharmaPartners

Example: Software Vendor - PharmaPartners