--- id: ehealth-addressbook type: Platform type_label: Plateforme ou service 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: En production comme SOAP v1.2 et REST v1.2. Depuis le cookbook du 24 mars 2026, seul REST évolue sur le plan fonctionnel; SOAP subsiste pour la compatibilité, sans date de fin connue. version: AddressBook SOAP v1.2 ; Addressbook REST v1.2 (cookbook v1.3, 24/03/2026) summary: L'eHealth Addressbook est le service de consultation avec lequel un logiciel de soins recherche les coordonnées et les adresses eHealthBox des prestataires de soins et des établissements de soins. Les informations proviennent de CoBRHA et aident un expéditeur à choisir le bon canal de communication électronique. La plate-forme eHealth propose le service via SOAP et REST, avec les mêmes sources de données mais une authentification différente. Pour les hôpitaux, c'est surtout une brique pour un adressage fiable; pour de nouvelles intégrations, REST est la variante tournée vers l'avenir, car seule celle-ci est encore étendue sur le plan fonctionnel. links: - soort: website url: https://www.ehealth.fgov.be/ehealthplatform/nl/service-ehealth-addressbook-consultation-webservice label: eHealth Addressbook (eHealth-platform) taal: nl last_verified: '2026-10-05' relations: - type: operatedBy direction: uit target: ehealth-platform target_url: https://ehealth-atlas.be/fr/plate-forme-ehealth/ status: established - type: dependsOn direction: uit target: cobrha target_url: https://ehealth-atlas.be/fr/cobrha/ status: established - type: dependsOn direction: uit target: i-am-connect target_url: https://ehealth-atlas.be/fr/i-am-identity-access-management/ status: established - type: seeAlso direction: uit target: ehealthbox target_url: https://ehealth-atlas.be/fr/ehealthbox-boite-aux-lettres-electronique-securisee/ status: established - type: about direction: in target: ehealth-basisdiensten target_url: https://ehealth-atlas.be/fr/services-de-base-de-la-plate-forme-ehealth/ status: established - type: about direction: in target: ehealth-diensten target_url: https://ehealth-atlas.be/fr/services-et-api-de-la-plate-forme-ehealth/ status: established release: 2026.11.12-3 url: https://ehealth-atlas.be/fr/ehealth-addressbook/ license: CC BY 4.0 --- # eHealth Addressbook L'eHealth Addressbook est le service de consultation avec lequel un logiciel de soins recherche les coordonnées et les adresses eHealthBox des prestataires de soins et des établissements de soins. Les informations proviennent de CoBRHA et aident un expéditeur à choisir le bon canal de communication électronique. La plate-forme eHealth propose le service via SOAP et REST, avec les mêmes sources de données mais une authentification différente. Pour les hôpitaux, c'est surtout une brique pour un adressage fiable ; pour de nouvelles intégrations, REST est la variante tournée vers l'avenir, car seule celle-ci est encore étendue sur le plan fonctionnel. ## Qu'est-ce que c'est ? L'eHealth Addressbook (Consultation Webservice) permet d'obtenir à tout moment les informations de contact les plus exactes sur d'autres acteurs de soins, afin de communiquer par voie électronique de la manière la plus efficace possible entre prestataires de soins et institutions de soins[^1]. Ces informations se trouvent dans [CoBRHA](https://ehealth-atlas.be/fr/cobrha/)[^1]. L'Addressbook contient tous les prestataires de soins individuels connus (présents dans CoBRHA) et toutes les institutions connues qui disposent d'un certificat eHealth[^1]. Il s'agit d'un service de la [Plate-forme eHealth](https://ehealth-atlas.be/fr/plate-forme-ehealth/), couplé aux webservices [eHealthBox](https://ehealth-atlas.be/fr/ehealthbox-boite-aux-lettres-electronique-securisee/)[^2]. ### Quel problème résout-il ? Celui qui veut communiquer par voie électronique doit savoir comment le destinataire est joignable. Pour les prestataires de soins et les institutions de soins, l'Addressbook renvoie aussi l'identification eHealthBox (box-ID et type INSZ/NIHII/CBE)[^3]. Sur la base de la réponse, l'acteur de soins choisit le canal de communication le plus approprié ; l'eHealthBox est citée comme exemple d'un tel canal[^1]. ## Quels services l'Addressbook offre-t-il ? | Service | Quoi | Pour qui | Page | |---|---|---|---| | AddressBook SOAP | rechercher des données de contact via le webservice Consultation[^1] | logiciels de soins existants avec certificat eHealth | cette page | | Addressbook REST | implémentation REST pour les mêmes données de contact[^1] | intégrations nouvelles et migrées | [I.AM et I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/fr/i-am-identity-access-management/) | | Adressage eHealthBox | renvoyer le box-ID et le type d'identification du destinataire[^3] | expéditeurs de messages de soins | [eHealthBox](https://ehealth-atlas.be/fr/ehealthbox-boite-aux-lettres-electronique-securisee/) | ### Données et interfaces techniques - **SOAP** : le webservice AddressBook Consultation[^1]. - **REST** : la page du service décrit le cookbook Addressbook REST (v1.3, 24/03/2026) comme une implémentation REST de l'AddressBook SOAP Consultation permettant de rechercher les données de contact de prestataires de soins[^1]. La version 1.0 d'Addressbook REST (07/02/2024 selon l'historique du service, colonne « previous release date ») était la première release de l'implémentation REST, basée sur le webservice SOAP existant[^4]. - **Authentification** : pour la variante REST, un onboarding distinct via [I.AM Connect](https://ehealth-atlas.be/fr/i-am-identity-access-management/) est requis, avec un choix entre les formulaires d'enregistrement de client « Healthcare » (prestataire de soins individuel ou application) et « M2M » (organisation)[^2]. Pour les services SOAP, un certificat de base (certificat eHealth) suffit[^2]. - **Backend** : selon le cookbook REST v1.3, la variante SOAP et la variante REST utilisent le même backend et les mêmes sources[^4]. ### API dans le catalogue de la plate-forme eHealth | API | Interface | Version | Environnements | Documentation | |---|---|---|---|---| | AddressBook | SOAP | 1.2 | production, acceptation | Consultation WS cookbook v1.11 (31/08/2023)[^1] | | Addressbook REST | REST | 1.2 | production, acceptation | cookbook REST v1.3 (24/03/2026)[^1] | État du catalogue au 28/09/2026 (registre de l'Atlas). Le cookbook REST v1.3 est daté du 24/03/2026[^1]. ## Où en est-il et qui l'utilise ? Statut : **production**. La plate-forme eHealth propose à la fois une forme SOAP (eHealthBox v3) et une forme REST du webservice eHealthBox, chaque fois avec un service AddressBook couplé pour la recherche des données de contact de prestataires et d'institutions de soins[^2]. Dans la procédure d'onboarding de mai 2024, la forme REST s'appelle « eHealthBox REST v.1 »[^2] ; dans le catalogue du 28/09/2026 figure ehBox REST v1.2 (registre de l'Atlas). Les données ne sont pas gérées par l'Addressbook lui-même : elles proviennent de CoBRHA[^1], dans lequel seules des sources authentiques partenaires publient[^5]. ### Version, statut et feuille de route - **07/02/2024** (selon l'historique du service) : première release d'Addressbook REST (v1.0)[^4]. - **17/04/2025** (selon l'historique du service) : Addressbook REST v1.1 a ajouté la prise en charge du code de langue « und » et a introduit 8 nouvelles combinaisons de recherche, 4 pour les organisations et 4 pour les prestataires de soins[^4]. - **12/09/2025** (selon l'historique du service) : Addressbook REST v1.2 a ajouté la pagination et a supprimé l'élément « total »[^4]. - **09/12/2025** : les release notes de R20252.1 annonçaient de nouvelles combinaisons de recherche pour le webservice Addressbook, aussi bien dans la version SOAP que dans la version REST[^6]. Du côté REST, l'historique du service du cookbook REST date ces nouvelles combinaisons de recherche déjà du 17/04/2025 (v1.1)[^4]. - **24/03/2026** : selon le cookbook REST v1.3, seul REST reçoit encore des améliorations fonctionnelles ; SOAP continue d'exister pour la compatibilité, sans évolution fonctionnelle[^4]. - **2026 (planification, janvier 2026)** : pour la banque de données sous-jacente CoBRHA, une migration vers CoBRHA+ est prévue[^5], avec un début au deuxième semestre[^7] ; à cette occasion, certains services CoBRHA seraient mis hors service, selon un calendrier encore en préparation[^7]. Ce que cela signifie pour l'Addressbook n'a pas été trouvé. ## Qu'est-ce que cela signifie pour un hôpital ? - **Adressage** : un logiciel hospitalier qui envoie des messages eHealthBox peut rechercher le destinataire et son identification eHealthBox via l'Addressbook[^3]. - **Onboarding** : celui qui intègre eHealthBox REST demande aussi Addressbook REST dans la même procédure[^2]. - **Pagination** : depuis REST v1.2, les résultats de recherche sont paginés et l'élément « total » a disparu, de sorte que les intégrations REST plus anciennes doivent en tenir compte[^4]. - **Repérabilité** : les institutions figurent dans l'Addressbook si elles sont connues et disposent d'un certificat eHealth[^1] ; les données elles-mêmes proviennent de CoBRHA[^1]. - **Recommandation** (propre) : pour de nouvelles intégrations, choisissez la variante REST, parce que seule celle-ci évolue encore sur le plan fonctionnel, et demandez leur plan de migration aux fournisseurs qui ont une intégration SOAP. ### Conditions préalables et limites Pour la variante REST, un onboarding I.AM Connect est nécessaire[^2] ; pour SOAP, un certificat de base suffit[^2]. Selon la procédure d'onboarding de mai 2024, les services eHealthBox et Addressbook ont été développés pour les institutions de soins et les prestataires de soins qui disposent d'un numéro INAMI[^2]. Les intégrateurs qui demandent eHealthBox REST doivent normalement aussi demander des droits pour Addressbook REST : il s'agit d'une seule procédure d'onboarding commune[^2]. L'exactitude de la réponse dépend des données présentes dans CoBRHA, que seules des sources authentiques partenaires publient[^5]. ## Incertitudes et informations contradictoires - **Gel de SOAP** : le cookbook REST v1.3 (24/03/2026) affirme que SOAP n'évolue plus sur le plan fonctionnel[^4], alors que les release notes de R20252.1 (09/12/2025) annonçaient encore de nouvelles options de recherche pour SOAP comme pour REST[^6]. **Interprétation :** le gel ne s'appliquait peut-être qu'après R20252.1, ou bien les release notes décrivent un déploiement d'options de recherche qui, pour REST, figuraient déjà dans l'historique du service en v1.1 (17/04/2025)[^4]. Aucune date de fin pour SOAP n'a été trouvée. - **Contenu** : la formulation « toutes les institutions connues avec un certificat eHealth » provient de la page du service[^1] ; savoir si les institutions sans certificat propre (p. ex. via un certificat d'une fédération) sont également reprises n'a pas été trouvé. - **Impact de CoBRHA+** : non publié dans les sources traitées. ## Relaties - est exploité par: [Plate-forme eHealth](https://ehealth-atlas.be/fr/plate-forme-ehealth/) (établi)[^1][^2] - dépend de: [CoBRHA](https://ehealth-atlas.be/fr/cobrha/) (établi)[^1]. De contactgegevens komen uit CoBRHA. - dépend de: [I.AM et I.AM Connect (Identity & Access Management)](https://ehealth-atlas.be/fr/i-am-identity-access-management/) (établi)[^2]. Enkel voor de REST-variant. - voir aussi: [eHealthBox](https://ehealth-atlas.be/fr/ehealthbox-boite-aux-lettres-electronique-securisee/) (établi)[^3][^1][^2]. Het Addressbook geeft de eHealthBox-identificatie van zorgverleners en instellingen terug en hoort bij de eHealthBox-webservices. - porte sur (entrant): [Services de base de la plate-forme eHealth](https://ehealth-atlas.be/fr/services-de-base-de-la-plate-forme-ehealth/) (établi)[^1][^4] - porte sur (entrant): [Services et API de la plate-forme eHealth](https://ehealth-atlas.be/fr/services-et-api-de-la-plate-forme-ehealth/) (établi)[^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]: [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) [^5]: [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) [^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). eHealth-platform (publieke presentatie op de persoonlijke website van de administrateur-generaal), 2026-01-30. Opgehaald 2026-09-26, sha256 b58fc6b2201308cb… (SRC-88e226b672)