eHealth Addressbook

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^[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, couplé aux webservices eHealthBox^[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].

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

État du catalogue au 28/09/2026 (registre de l'Atlas). Le cookbook REST v1.3 est daté du 24/03/2026^[1].

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

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

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