--- id: ehealth-addressbook type: Platform type_label: Platform of dienst title: eHealth Addressbook aliases: - Addressbook - AddressBook - Adresboek - eHealth Address book - eHealth Addressbook Consultation Webservice - Addressbook REST names: nl: eHealth Addressbook (adresboek) fr: eHealth Addressbook en: eHealth Addressbook jurisdiction: - belgie themes: - identiteit-en-toegang - architectuur-en-infrastructuur lifecycle: productie lifecycle_note: In productie als SOAP (AddressBook v1.2) en REST (Addressbook REST v1.2; eerste REST-versie volgens de servicehistoriek 07/02/2024, cookbook v1.3 van 24/03/2026). Volgens de REST-cookbook evolueert enkel REST nog functioneel; SOAP blijft voor compatibiliteit bestaan. Een einddatum voor SOAP is niet gevonden. De gegevens komen uit CoBRHA, waarvan de migratie naar CoBRHA+ in 2026 gepland is (planning, januari 2026). version: AddressBook SOAP v1.2; Addressbook REST v1.2 (cookbook v1.3, 24/03/2026) summary: Het eHealth Addressbook is de raadplegingsdienst van het eHealth-platform waarmee zorgactoren en hun software op elk moment de meest accurate contactgegevens van andere zorgverleners en zorginstellingen opvragen, inclusief de eHealthBox-identificatie, om het geschikte communicatiekanaal te kiezen. De gegevens komen uit CoBRHA. De dienst bestaat als SOAP-webservice en als REST-dienst (I.AM Connect; eerste REST-versie volgens de servicehistoriek 07/02/2024); beide gebruiken dezelfde backend, maar volgens de REST-cookbook krijgt enkel REST nog functionele verbeteringen. De release notes van R20252.1 (december 2025) kondigden nog nieuwe zoekcombinaties voor beide varianten aan. last_verified: '2026-09-28' relations: - type: operatedBy direction: uit target: ehealth-platform target_url: https://ehealth-atlas.be/ehealth-platform/ status: established - type: dependsOn direction: uit target: cobrha target_url: https://ehealth-atlas.be/cobrha/ status: established - type: dependsOn direction: uit target: i-am-connect target_url: https://ehealth-atlas.be/i-am-connect/ status: established - type: seeAlso direction: uit target: ehealthbox target_url: https://ehealth-atlas.be/ehealthbox/ status: established - type: about direction: in target: ehealth-basisdiensten target_url: https://ehealth-atlas.be/ehealth-basisdiensten/ status: established - type: about direction: in target: ehealth-diensten target_url: https://ehealth-atlas.be/ehealth-diensten/ status: established release: 2026.10.05-1 url: https://ehealth-atlas.be/ehealth-addressbook/ license: CC BY 4.0 --- # eHealth Addressbook Het eHealth Addressbook is de raadplegingsdienst van het eHealth-platform waarmee zorgactoren en hun software op elk moment de meest accurate contactgegevens van andere zorgverleners en zorginstellingen opvragen, inclusief de eHealthBox-identificatie, om het geschikte communicatiekanaal te kiezen. De gegevens komen uit CoBRHA. De dienst bestaat als SOAP-webservice en als REST-dienst (I.AM Connect; eerste REST-versie volgens de servicehistoriek 07/02/2024); beide gebruiken dezelfde backend, maar volgens de REST-cookbook krijgt enkel REST nog functionele verbeteringen. De release notes van R20252.1 (december 2025) kondigden nog nieuwe zoekcombinaties voor beide varianten aan. ## Wat is het? Het eHealth Addressbook (Consultation Webservice) laat op elk moment de meest accurate contactinformatie over andere zorgactoren opvragen, om zo efficiënt mogelijk elektronisch te communiceren tussen zorgverleners en zorginstellingen[^1]. Die informatie bevindt zich in [CoBRHA](https://ehealth-atlas.be/cobrha/)[^1]. Het Addressbook bevat alle gekende individuele zorgverleners (aanwezig in CoBRHA) en alle gekende instellingen met een eHealth-certificaat[^1]. Het is een dienst van het [eHealth-platform](https://ehealth-atlas.be/ehealth-platform/), gekoppeld aan de [eHealthBox](https://ehealth-atlas.be/ehealthbox/)-webservices[^2]. ## Welk probleem lost het op? Wie elektronisch wil communiceren, moet weten hoe de bestemmeling bereikbaar is. Het Addressbook geeft voor zorgverleners en zorginstellingen ook de eHealthBox-identificatie terug (box-ID en type INSZ/NIHII/CBE)[^3]. Op basis van het antwoord kiest de zorgactor het meest geschikte communicatiekanaal; de eHealthBox wordt als voorbeeld van zo'n kanaal genoemd[^1]. ## Wie beheert het en waar wordt het toegepast? Status: **productie**. Het eHealth-platform biedt zowel een SOAP-vorm (eHealthBox v3) als een REST-vorm van de eHealthBox-webservice aan, telkens met een gekoppelde AddressBook-dienst voor de opzoeking van contactgegevens van zorgverleners en -instellingen[^2]. De REST-vorm heet in de onboardingprocedure van mei 2024 'eHealthBox REST v.1'[^2]; in de catalogus van 28/09/2026 staat ehBox REST v1.2 (register van de Atlas). De gegevens worden niet door het Addressbook zelf beheerd: ze komen uit CoBRHA[^1], waarin enkel partner-authentieke bronnen publiceren[^4]. ## Gegevens en koppelvlakken - **SOAP**: de AddressBook Consultation-webservice[^1]. - **REST**: de dienstpagina omschrijft de Addressbook REST-cookbook (v1.3, 24/03/2026) als een REST-implementatie van de AddressBook SOAP Consultation om contactgegevens van zorgverleners op te zoeken[^1]. Versie 1.0 van Addressbook REST (07/02/2024 volgens de servicehistoriek, kolom 'previous release date') was de eerste release van de REST-implementatie, gebaseerd op de bestaande SOAP-webservice[^5]. - **Authenticatie**: voor de REST-variant is een aparte onboarding via [I.AM Connect](https://ehealth-atlas.be/i-am-connect/) vereist, met een keuze tussen de client-registratieformulieren 'Healthcare' (individuele zorgverlener of applicatie) en 'M2M' (organisatie)[^2]. Voor de SOAP-diensten volstaat een basiscertificaat (eHealth-certificaat)[^2]. - **Backend**: volgens de REST-cookbook v1.3 gebruiken de SOAP- en de REST-variant dezelfde backend en bronnen[^5]. ### API's in de catalogus van het eHealth-platform | API | Interface | Versie | Omgevingen | Documentatie | |---|---|---|---|---| | AddressBook | SOAP | 1.2 | productie, acceptatie | Consultation WS cookbook v1.11 (31/08/2023) | | Addressbook REST | REST | 1.2 | productie, acceptatie | REST-cookbook v1.3 (24/03/2026) | Stand van de catalogus op 28/09/2026 (register van de Atlas). De REST-cookbook v1.3 is gedateerd 24/03/2026[^1]. ## Versie, status en roadmap - **07/02/2024** (volgens de servicehistoriek): eerste release van Addressbook REST (v1.0)[^5]. - **17/04/2025** (volgens de servicehistoriek): Addressbook REST v1.1 voegde ondersteuning voor de taalcode 'und' toe en introduceerde 8 nieuwe zoekcombinaties, 4 voor organisaties en 4 voor zorgverleners[^5]. - **12/09/2025** (volgens de servicehistoriek): Addressbook REST v1.2 voegde paginering toe en verwijderde het element 'total'[^5]. - **09/12/2025**: de release notes van R20252.1 kondigden nieuwe zoekcombinaties aan voor de Addressbook-webservice, zowel in de SOAP- als in de REST-versie[^6]. Voor de REST-kant dateert de servicehistoriek van de REST-cookbook de nieuwe zoekcombinaties al op 17/04/2025 (v1.1)[^5]. - **24/03/2026**: volgens de REST-cookbook v1.3 krijgt enkel REST nog functionele verbeteringen; SOAP blijft bestaan voor compatibiliteit, zonder functionele evolutie[^5]. - **2026 (planning, januari 2026)**: voor de onderliggende gegevensbank CoBRHA is een migratie naar CoBRHA+ gepland[^4], met start in het tweede semester[^7]; daarbij zouden bepaalde CoBRHA-diensten uit dienst gaan, met een planning die nog in voorbereiding was[^7]. Wat dat voor het Addressbook betekent, is niet gevonden. ## Praktische betekenis voor ziekenhuizen - **Adressering**: ziekenhuissoftware die eHealthBox-berichten verstuurt, kan de bestemmeling en diens eHealthBox-identificatie via het Addressbook opzoeken[^3]. - **Onboarding**: wie eHealthBox REST integreert, vraagt in dezelfde procedure ook Addressbook REST aan[^2]. - **Paginering**: sinds REST v1.2 zijn zoekresultaten gepagineerd en is het element 'total' verdwenen[^5]; oudere REST-integraties moeten daarop aangepast zijn (interpretatie). - **Vindbaarheid**: instellingen staan in het Addressbook als ze gekend zijn en een eHealth-certificaat hebben[^1]; de gegevens zelf komen uit CoBRHA[^1]. - **Aanbeveling** (eigen): kies bij nieuwe integraties de REST-variant, omdat enkel die nog functioneel evolueert, en vraag leveranciers met een SOAP-integratie naar hun migratieplan. ## Implementatievoorwaarden en beperkingen Voor de REST-variant is een I.AM Connect-onboarding nodig[^2]; voor SOAP volstaat een basiscertificaat[^2]. De eHealthBox- en Addressbook-diensten zijn volgens de onboardingprocedure van mei 2024 ontwikkeld voor zorginstellingen en zorgverleners met een RIZIV-nummer[^2]. Integratoren die eHealthBox REST aanvragen, moeten normaal ook rechten voor Addressbook REST aanvragen: het is één gezamenlijke onboardingprocedure[^2]. De juistheid van het antwoord hangt af van de gegevens in CoBRHA, die enkel partner-authentieke bronnen publiceren[^4]. ## Onzekerheden en tegenstrijdige informatie - **Bevriezing van SOAP**: de REST-cookbook v1.3 (24/03/2026) stelt dat SOAP functioneel niet meer evolueert[^5], terwijl de release notes van R20252.1 (09/12/2025) nog nieuwe zoekopties voor zowel SOAP als REST aankondigden[^6]. **Interpretatie:** mogelijk gold de bevriezing pas na R20252.1, of beschrijven de release notes een uitrol van zoekopties die voor REST al in v1.1 (17/04/2025) in de servicehistoriek stonden[^5]. Een einddatum voor SOAP is niet gevonden (hiaat). - **Inhoud**: de formulering 'alle gekende instellingen met een eHealth-certificaat' komt uit de dienstpagina[^1]; of instellingen zonder eigen certificaat (bv. via een certificaat van een koepel) ook opgenomen zijn, is niet gevonden. - **Impact CoBRHA+**: niet gepubliceerd in de verwerkte bronnen. ## Relaties - wordt uitgebaat door: [eHealth-platform](https://ehealth-atlas.be/ehealth-platform/) (vastgesteld)[^1][^2] - hangt technisch af van: [CoBRHA](https://ehealth-atlas.be/cobrha/) (vastgesteld)[^1]. De contactgegevens komen uit CoBRHA. - hangt technisch af van: [I.AM en I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/i-am-connect/) (vastgesteld)[^2]. Enkel voor de REST-variant. - zie ook: [eHealthBox](https://ehealth-atlas.be/ehealthbox/) (vastgesteld)[^3][^1][^2]. Het Addressbook geeft de eHealthBox-identificatie van zorgverleners en instellingen terug en hoort bij de eHealthBox-webservices. - gaat over (inkomend): [Basisdiensten van het eHealth-platform](https://ehealth-atlas.be/ehealth-basisdiensten/) (vastgesteld)[^1][^5] - gaat over (inkomend): [Diensten en API's van het eHealth-platform](https://ehealth-atlas.be/ehealth-diensten/) (vastgesteld)[^1] ## Open vragen - Krijgt AddressBook SOAP v1.2 een einddatum? De REST-cookbook v1.3 zegt enkel dat SOAP functioneel niet meer evolueert. - Gold de functionele bevriezing van SOAP pas na release R20252.1, die nog nieuwe zoekopties voor SOAP en REST bracht? - Wat verandert er voor het Addressbook bij de migratie van CoBRHA naar CoBRHA+ (start tweede semester 2026)? - Welke zoekcombinaties bracht R20252.1 voor SOAP precies, en gaat het bij de data in de servicehistoriek van de REST-cookbook (v1.1 op 17/04/2025, v1.2 op 12/09/2025) om acceptatie of productie? - Geldt de doelgroep 'zorginstellingen en zorgverleners met een RIZIV-nummer' uit de onboardingprocedure van mei 2024 nog, en hoe raken zorgactoren zonder RIZIV-nummer aan eHealthBox- of Addressbook-gegevens? ## Bronnen [^1]: [eHealth Addressbook Consultation Webservice](https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-addressbook-consultation-webservice). eHealth-platform. Opgehaald 2026-09-26, sha256 ea0c8c20c9a70ef4… (SRC-87a6ea79ec) [^2]: [Procedure: Onboarding IAM Connect eHealthBox - Addressbook v2.0](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/c519e44be8f41c3a3534de725dc9b2e7e906bce7/onboarding-iam-connect-ehbox-addressbook-v2-0-dd-29052024.pdf). eHealth-platform, 2024-05-29. Opgehaald 2026-09-26, sha256 cf046c0e6e61e6b2… (SRC-771a066b18) [^3]: [eHealthBox](https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealthbox). eHealth-platform. Opgehaald 2026-09-26, sha256 5cfa6cfb5085560b… (SRC-71c7c4bb9f) [^4]: [CoBRHA - Common Base Registry for HealthCare Actor](https://www.ehealth.fgov.be/ehealthplatform/nl/service-cobrha-common-base-registry-for-healthcare-actor). eHealth-platform. Opgehaald 2026-09-26, sha256 69a51829d10e1f76… (SRC-37d012b912) [^5]: [Addressbook REST - Cookbook v1.3](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/36a8fbb0eec93cd882ed27ba5dda6743ac68b888/ehealth-addressbook-rest-v1-3-cookbook.pdf). eHealth-platform, 2026-03-24. Opgehaald 2026-09-28, sha256 ac9a3d67810eee69… (SRC-80cc27a3f6) [^6]: [eHealth Release Notes Minor Release R20252.1](https://www.ehealth.fgov.be/ehealthplatform/file/cc73d96153bbd5448a56f19d925d05b1379c7f21/f3248b765388d8547b40163fb2c17db6dff67f8a/release-notes-r20252-1-v-1.pdf). eHealth-platform, 2025-09-30. Opgehaald 2026-09-28, sha256 4d1ab32dbdcb2ce8… (SRC-e24045a475) [^7]: [Réalisations 2025 – Perspectives 2026 (Plate-forme eHealth)](https://www.frankrobben.be/wp-content/uploads/2026/01/20260130a.pptx). Frank Robben / eHealth-platform (publieke presentatie op frankrobben.be), 2026-01-30. Opgehaald 2026-09-26, sha256 b58fc6b2201308cb… (SRC-88e226b672)