--- id: fhir-bulk-data type: Specification type_label: Standaard of specificatie title: FHIR Bulk Data Access ($export) aliases: - Bulk Data - Flat FHIR - Bulk FHIR - $export - hl7.fhir.uv.bulkdata names: nl: FHIR Bulk Data Access fr: FHIR Bulk Data Access en: FHIR Bulk Data Access (Flat FHIR) de: FHIR Bulk Data Access jurisdiction: - internationaal themes: - secundair-gebruik - architectuur-en-infrastructuur - standaardisatie-en-governance lifecycle: trial-use lifecycle_note: 'Trial use: versie 3.0.0 (STU 3) van 11 december 2025 is de officiële versie; de STU 4-ballot van 7 augustus 2026 is een voorpublicatie, geen release.' version: 3.0.0 (STU 3, FHIR R4); 4.0.0-ballot (STU 4) summary: FHIR Bulk Data Access, ook 'Flat FHIR', is een HL7-specificatie om grote hoeveelheden FHIR-gegevens in één keer van een server naar een vooraf geautoriseerde client te halen, waar gewone FHIR-verzoeken honderdduizenden aanroepen zouden vragen. De operatie $export maakt asynchroon NDJSON-bestanden aan voor alle patiënten, een groep of de hele server; toegang verloopt bij voorkeur via SMART Backend Services. Het dient onder meer om EPD-gegevens naar een onderzoeksdatabank te halen. Een ballot voor versie 4 voegt Bulk Submit en Bulk Publish toe. links: - soort: documentatie url: https://hl7.org/fhir/uv/bulkdata/ label: FHIR Bulk Data Access (HL7) taal: en - soort: repository url: https://github.com/HL7/bulk-data label: HL7/bulk-data (GitHub) taal: en last_verified: '2026-11-12' relations: - type: ownedBy direction: uit target: hl7-international target_url: https://ehealth-atlas.be/hl7-international/ status: established - type: dependsOn direction: uit target: fhir target_url: https://ehealth-atlas.be/fhir/ status: established - type: recommends direction: uit target: smart-on-fhir target_url: https://ehealth-atlas.be/smart-on-fhir/ status: established release: 2026.11.13-2 url: https://ehealth-atlas.be/fhir-bulk-data/ license: CC BY 4.0 --- # FHIR Bulk Data Access ($export) FHIR Bulk Data Access, ook 'Flat FHIR', is een HL7-specificatie om grote hoeveelheden FHIR-gegevens in één keer van een server naar een vooraf geautoriseerde client te halen, waar gewone FHIR-verzoeken honderdduizenden aanroepen zouden vragen. De operatie $export maakt asynchroon NDJSON-bestanden aan voor alle patiënten, een groep of de hele server; toegang verloopt bij voorkeur via SMART Backend Services. Het dient onder meer om EPD-gegevens naar een onderzoeksdatabank te halen. Een ballot voor versie 4 voegt Bulk Submit en Bulk Publish toe. ## Wat is het? FHIR Bulk Data Access, ook 'Flat FHIR' genoemd, is een implementatiegids van [HL7 International](https://ehealth-atlas.be/hl7-international/) op basis van [FHIR](https://ehealth-atlas.be/fhir/) R4[^1]. Ze bestaat omdat de gewone FHIR-API's goed werken voor kleine hoeveelheden gegevens, maar voor grote exports honderdduizenden verzoeken kunnen vragen; de gids standaardiseert het exporteren van bulkgegevens van een FHIR-server naar een vooraf geautoriseerde client[^1]. Een typisch gebruik is een zorgorganisatie die periodiek bijgewerkte klinische gegevens uit een EPD naar een onderzoeksdatabank haalt[^1]. ## Hoe is het opgebouwd? **De exportoperatie.** De operatie `$export` start asynchroon de aanmaak van een exportbestand voor alle patiënten, voor een gedefinieerde groep patiënten of voor alle FHIR-gegevens op de server[^2]. 'Asynchroon' betekent dat de client de export aanvraagt en de bestanden later ophaalt, in plaats van op een antwoord te wachten. De server moet de uitvoer minstens als Newline Delimited JSON (NDJSON, één FHIR-resource per regel) kunnen leveren en mag daarnaast andere formaten aanbieden[^2]. **Toegang.** Voor de toegangscontrole raadt de gids (SHOULD, dus geen verplichting) OAuth 2.0 aan volgens het SMART Backend Services-profiel[^2]. Dat profiel uit [SMART App Launch](https://ehealth-atlas.be/smart-on-fhir/) is ontworpen om met Bulk Data samen te werken, maar dient ook voor andere FHIR-API's[^3]; het autoriseert een geautomatiseerde toepassing zonder gebruiker[^4]. **Versie en status.** De huidige gepubliceerde versie is 3.0.0 (STU 3)[^1]. In de publicatiehistoriek staat ze als trial use, op basis van FHIR 4.0.1, met datum 11 december 2025, en gemarkeerd als huidige versie[^5]. ### STU 4-ballot: Bulk Submit en Bulk Publish Op 7 augustus 2026 verscheen een ballotversie 4.0.0-ballot (STU 4), eveneens op FHIR 4.0.1[^5]. Dat is een voorpublicatie; de officiële versie blijft 3.0.0[^6]. De ballot definieert drie bulkoperaties, elk voor een andere verhouding tussen het systeem dat de gegevens heeft en het systeem dat ze nodig heeft: Bulk Export, Bulk Submit en Bulk Publish[^6]. Met **Bulk Submit** duwt een gegevensleverancier een vooraf afgesproken dataset naar één specifieke ontvanger[^6]. Een juridisch kader voor het delen van gegevens (zoals verwerkings- of gegevensgebruiksovereenkomsten) en realtime-uitwisseling vallen buiten de scope[^6]. ## Waar wordt het gebruikt? De gids richt zich op uitwisseling in bulk voor analyse, onderzoek en rapportering, zoals de periodieke export van EPD-gegevens naar een onderzoeksdatabank[^1] of een datawarehouse dat een patiëntenpopulatie analyseert[^3]. In Belgische specificaties of diensten, waaronder de Belgische FHIR-gidsen ([Belgische FHIR-implementatiegidsen](https://ehealth-atlas.be/be-fhir-igs/)), werd geen gebruik van Bulk Data gevonden; de hiaat staat in het register. Of Belgische registers of in België gebruikte EPD's `$export` ondersteunen, werd evenmin gevonden. ## Wat betekent het voor een ziekenhuis? Bulk Data is relevant voor een ziekenhuis dat gegevens uit het EPD naar een datawarehouse of onderzoeksdatabank wil halen zonder per patiënt verzoeken te sturen[^1]. Bulk Submit, nog in ballot, beschrijft het omgekeerde: een vooraf afgesproken dataset naar één ontvanger duwen[^6]. De juridische afspraken voor zo'n gegevensdeling regelt de gids niet[^6]. Er is geen Belgische verplichting gevonden. **Aanbeveling:** vraag bij een EPD-keuze of `$export` (systeem-, patiënt- en groepsniveau) met SMART Backend Services wordt aangeboden, en behandel Bulk Submit en Bulk Publish als ballot tot STU 4 gepubliceerd is. ## Onzekerheden en tegenstrijdige informatie - De STU 4-ballot is geen release; inhoud en planning van de definitieve STU 4 kunnen nog wijzigen[^6]. - Of Belgische registers of in België gebruikte ziekenhuis-EPD's `$export` aanbieden, werd niet gevonden; leveranciersdocumentatie is niet onderzocht. ## Relaties - valt onder verantwoordelijkheid van: [HL7 International](https://ehealth-atlas.be/hl7-international/) (vastgesteld)[^1]. Gepubliceerd als HL7-implementatiegids op hl7.org. - hangt technisch af van: [HL7 FHIR](https://ehealth-atlas.be/fhir/) (vastgesteld)[^1]. Gebaseerd op FHIR R4. - beveelt aan: [SMART App Launch (SMART on FHIR)](https://ehealth-atlas.be/smart-on-fhir/) (vastgesteld)[^2][^3]. SMART Backend Services is de aanbevolen autorisatie (SHOULD), geen verplichting. ## Open vragen - Ondersteunen Belgische registers of in België gebruikte ziekenhuis-EPD's de operatie $export? - Wanneer wordt Bulk Data STU 4, met Bulk Submit en Bulk Publish, definitief gepubliceerd? - Kan Bulk Submit een rol spelen in verplichte Belgische registratie of rapportering, of blijft die bij eigen kanalen? ## Bronnen [^1]: [FHIR Bulk Data Access (Flat FHIR) - Home](https://hl7.org/fhir/uv/bulkdata/en/). HL7 International. Opgehaald 2026-11-12, sha256 cfabdbd478661bc9… (SRC-e3bf06d5aa) [^2]: [FHIR Bulk Data Access - Bulk Data Export](https://hl7.org/fhir/uv/bulkdata/en/export.html). HL7 International. Opgehaald 2026-11-12, sha256 c36bb7ece0de9b7d… (SRC-d4ea422d02) [^3]: [SMART App Launch - Backend Services](https://hl7.org/fhir/smart-app-launch/backend-services.html). HL7 International. Opgehaald 2026-11-12, sha256 20ed28915344311f… (SRC-5b357ff62a) [^4]: [SMART App Launch Implementation Guide - Home](https://hl7.org/fhir/smart-app-launch/). HL7 International. Opgehaald 2026-11-12, sha256 b50fe78d4bedeb9f… (SRC-cb5a8034c5) [^5]: [FHIR Bulk Data Access - package-list.json (publicatiehistoriek)](https://hl7.org/fhir/uv/bulkdata/package-list.json). HL7 International. Opgehaald 2026-11-12, sha256 91fd392001d2d561… (SRC-a5e343ac8f) [^6]: [FHIR Bulk Data Access - STU 4 Ballot - Home](https://hl7.org/fhir/uv/bulkdata/4.0.0-202609-ballot/en/). HL7 International. Opgehaald 2026-11-12, sha256 6205a20f1c90e149… (SRC-c02ed723fb)