eHealth Addressbook

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^[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, gekoppeld aan de eHealthBox-webservices^[2].

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].

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].

• 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 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

Stand van de catalogus op 28/09/2026 (register van de Atlas). De REST-cookbook v1.3 is gedateerd 24/03/2026^[1].

• 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.

• 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.

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].

• 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.