E-Directory
L'écran E-Directory permet de rechercher une société française dans le référentiel INSEE (recherche-entreprises.api.gouv.fr) et de vérifier si les SIREN / SIRET correspondants sont joignables sur l'annuaire PPF pour la réception de factures électroniques.
Utilisations courantes :
- Récupérer le SIREN / SIRET exact d'un client avant d'émettre une facture.
- Vérifier qu'un acheteur est bien enregistré sur la Plateforme Publique de Facturation (PPF) et prêt à recevoir une facture électronique.
- Diagnostiquer un rejet d'adressage (par ex.
REJ_ADR) en confirmant l'état dans l'annuaire pour un identifiant donné.
La page fonctionne quel que soit le système source — JD Edwards, SAP, NetSuite ou un ERP personnalisé.
Les deux recherches sous-jacentes sont indépendantes et jouent des rôles distincts :
- Recherche INSEE — confirme l'existence de la société et fournit raison sociale, adresse, état administratif. API publique gratuite, aucun identifiant requis.
- Contrôle annuaire PPF — vérifie que le SIREN / SIRET est inscrit comme destinataire sur la Plateforme Publique de Facturation. Utilise les identifiants configurés dans Configuration → Système → e-directory.
Voir la page Configuration → Système → e-directory pour le contexte global — identifiants, rôles de recherche et distinction PPF / INSEE.
Vue d'ensemble
Déroulement d'une recherche
Les deux requêtes s'enchaînent : INSEE d'abord pour remplir les sociétés, puis un seul appel annuaire PPF par société pour lister ses identifiants enregistrés. L'utilisateur voit les résultats se remplir en deux passes.
Section de recherche
Un seul champ et un bouton en haut de la page.
| Élément | Comportement |
|---|---|
| Champ de recherche | Texte libre : nom de société, nom partiel, SIREN, SIRET ou toute combinaison. Validation par Entrée ou par le bouton Rechercher. |
| Bouton Rechercher | Déclenche la recherche INSEE. Désactivé pendant l'exécution et quand le champ est vide. |
La requête est envoyée à recherche-entreprises.api.gouv.fr côté serveur ; l'API retourne les sociétés correspondantes avec leurs données complètes.
Résultats
Les résultats sont regroupés par société : une carte repliée par SIREN, avec la raison sociale, l'adresse du siège, l'état administratif INSEE et une synthèse des adresses électroniques — combien d'adresses électroniques le PPF détient pour la société et combien sont actives. Dépliez une carte pour révéler deux groupes :
Établissements (INSEE)
Une liste repliable des établissements de la société — chaque SIRET avec son adresse et son état administratif, issus du registre INSEE. La recherche par SIREN ou SIRET liste désormais tous les établissements de la société (une seconde interrogation INSEE par raison sociale complète ce que la recherche numérique omet).
Adresses électroniques
Chaque identifiant enregistré pour le SIREN sur le PPF, quelle que soit sa forme — un SIREN, un SIREN + SIRET, un code de routage ou un suffixe — avec son état actif / désactivé. Les identifiants à suffixe, comme 422250845_FGX, y figurent aussi — une forme que le contrôle ligne à ligne précédent ne savait pas faire apparaître.
Le listage passe par l'endpoint directory-check-siren du connecteur, qui renvoie les lignes complètes avec un mappage de réponse par endpoint (formats ATGP, Yooz et Esker pris en charge — y compris les indicateurs numériques comme le HasAssignedPlatform 1/0 d'Esker, en plus de true/false). Quand cet endpoint n'est pas configuré, la page l'indique au lieu de deviner — réglez-le sous Configuration → Système → e-directory. Le contrôle annuaire au moment du traitement est inchangé ; l'ancien endpoint directory-check-siret est obsolète.
Annuaire Peppol
Déplier une carte entreprise interroge aussi le réseau Peppol public — aucun compte requis. Un groupe Annuaire Peppol liste chaque participant enregistré pour le SIREN (les enregistrements français utilisent l'ICD 0225, identifiants par établissement compris), avec son nom, sa date d'enregistrement et la plateforme qui l'opère — la PA (par ex. Pennylane) avec son identifiant de siège Peppol, résolue via la découverte officielle SML/SMP. Les URLs du point d'accès et du SMP se trouvent dans l'infobulle de la plateforme.
| Colonne | Contenu |
|---|---|
| Participant | L'identifiant de participant Peppol (ICD + valeur, par ex. 0225:80320631700015). |
| Plateforme (PA) | La plateforme qui opère le participant, avec son identifiant de siège ; non résolu quand l'étape SMP n'a pas abouti. |
| Enregistré le | La date d'enregistrement Peppol du participant. |
La recherche ne s'exécute qu'au premier dépliage et est aussi exposée en POST /api/peppol-lookup pour les intégrations (voir la référence API). Un participant sans plateforme joignable affiche quand même son enregistrement et son nom — seule la cellule Plateforme indique non résolu.
Flux réseau (firewall)
Tous les appels externes de l'E-Directory sont faits côté serveur — depuis le serveur NomaUBL, pas le navigateur de l'utilisateur — les règles firewall portent donc sur le trafic sortant du serveur. Hormis le connecteur PA, les destinations sont :
| Objet | Destination | Port / Protocole |
|---|---|---|
| Recherche d'entreprise (INSEE) | recherche-entreprises.api.gouv.fr | HTTPS 443 |
| Annuaire Peppol (carte de visite) | directory.peppol.eu | HTTPS 443 |
| Résolution SML Peppol | Requêtes DNS NAPTR sur *.iso6523-actorid-upis.edelivery.tech.ec.europa.eu | DNS 53 (via le résolveur habituel du serveur) |
| SMP Peppol (résolution de la plateforme) | dynamique — le SMP de la plateforme de chaque participant (par ex. smp.pennylane.com) | HTTPS 443 |
Ce qui compte pour les règles :
- INSEE et
directory.peppol.eusont des noms d'hôte fixes — faciles à autoriser. L'entrée INSEE couvre aussi la recherche client de la modale facture et la recherche Corriger destinataire (même API). - L'étape SML est uniquement DNS — pas de HTTP. Si le serveur résout déjà le DNS public via le résolveur d'entreprise, il n'y a rien à ouvrir ; cela ne casse que si le DNS sortant est restreint aux zones internes.
- Le SMP ne peut pas être autorisé à l'avance — c'est le domaine de la plateforme de chaque acheteur (Pennylane, Esker, Yooz… un par participant) ; la résolution de la plateforme demande donc une autorisation large HTTPS 443 sortant pour fonctionner de façon générale. Si ce n'est pas acceptable, l'impact reste doux : la section Peppol affiche quand même le participant, son nom et sa date d'enregistrement depuis
directory.peppol.eu, et la colonne Plateforme indiquenon résolu.
Compteur de résultats
Au-dessus des résultats, un petit libellé indique le nombre de sociétés renvoyées par INSEE pour la requête (par ex. 12 résultats).
Conseils & bonnes pratiques
- Rechercher d'abord par nom, puis affiner. INSEE retourne l'entité juridique (SIREN) et ses établissements (SIRET) — sélectionner le bon SIRET évite l'erreur courante « bon SIREN, mauvais établissement » à l'émission d'une facture.
- Une ligne désactivée n'est pas toujours définitive. Un acheteur peut ne pas être encore enregistré, ou un identifiant précis pas encore activé ; lui demander de s'inscrire avant de retenter. L'état de l'annuaire évolue chaque jour à mesure que les sociétés s'inscrivent sur le PPF.
- Cibler l'identifiant exact, pas seulement le SIREN. Les lignes d'adresses électroniques montrent quelle forme est réellement joignable — un SIREN seul, un SIREN + SIRET ou un code à suffixe. Adressez la facture à une ligne active ; une société peut en avoir plusieurs, seules certaines actives.
- Vérifier l'état de l'établissement. Un établissement cessé ne peut pas recevoir de facture, même si la société apparaît dans l'annuaire. Contrôler l'état INSEE de l'établissement avant de se fier à un mapping d'adresse électronique.
- Si les lignes n'apparaissent pas, câbler l'endpoint. Une liste d'annuaire vide avec la note « non configuré » signale un connecteur sans endpoint
directory-check-siren— réglez-le sous Configuration → Système → e-directory, avec le mappage de réponse de votre plateforme (ATGP, Yooz).