Aller au contenu principal

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​

E-DirectoryRecherche d'entrepriseRaison sociale, SIREN (9 chiffres) ou SIRET (14 chiffres)…🔍 RechercherRésultats — une carte par société (SIREN)▾ACME ManufacturingSIREN 123 456 789 · 12 rue de Rivoli, 75001 ParisActive5 lignes · 4 activesÉtablissements (INSEE)12345678900012 — 12 rue de Rivoli, 75001 Paris · Active12345678900037 — 8 av. du Général Leclerc, 92100 Boulogne · ActiveAdresses électroniques123456789 · SIREN✓ actif12345678900012 · SIREN+SIRET✓ actif123456789_FGX · code routage✕ désactivé1 société · 2 établissements · 5 adresses électroniquesINSEE est interrogé en premier (API publique gratuite) ; un seul appel annuaire PPF par société liste ensuite chaque identifiant enregistré, avec les identifiants configurés sous Configuration → Système → e-directory.Un seul champ de recherchenom · SIREN · SIRET — auto-détectéSynthèse annuairelignes · combien activesAdresses électroniqueschaque identifiant · actif / désactivé

Déroulement d'une recherche​

👤 Requêtenom · SIREN · SIRET🔍 INSEErecherche-entreprises.api.gouv.fr📋 Tableau résultatsLignes SIREN / SIRET📡 Annuaire PPF/api/check-directoryRecherchercorresp.par ligne✓ joignablepuce verte⚠ non trouvépuce orange✕ erreurpuce rouge

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. Les résultats s'affichent en deux temps. Déplier ensuite une carte entreprise lance la recherche Peppol pour cette entreprise.

Section de recherche​

Un seul champ et un bouton en haut de la page.

ÉlémentComportement
Champ de rechercheTexte libre : nom de société, nom partiel, SIREN, SIRET ou toute combinaison. Validation par Entrée ou par le bouton Rechercher.
Bouton RechercherDé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 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.

✓Actif— Enregistré et joignable sur le PPF ; une facture adressée à cet identifiant est distribuée.
✕Désactivé— Enregistré mais pas joignable actuellement ; l'adresser renverrait une erreur de routage (REJ_ADR).

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 l'entreprise, 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 URL du point d'accès et du SMP se trouvent dans l'infobulle de la plateforme.

Les participants sont trouvés de deux façons :

  • les fiches de l'annuaire Peppol qui correspondent au SIREN ;
  • des interrogations directes du SML pour chaque identifiant qu'une entreprise française peut détenir — publier une fiche dans l'annuaire est facultatif, et certaines plateformes ne le font pas. Sont interrogés le SIREN sous les schémas 0225 et 0002, chaque adresse inscrite dans l'annuaire PPF (simple, suffixée, SIRET, routée) sous 0225, et le SIRET de chaque établissement sous 0009. Un participant trouvé de cette façon affiche sans fiche annuaire à la place de sa date d'enregistrement.
ColonneContenu
ParticipantL'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. Quand le certificat du SMP ne peut pas être lu, l'hôte SMP suivi de SMP non joignable, la raison dans l'infobulle ; non résolu avec la raison quand le SML n'a donné aucun SMP. Avec Resolve platform via SMP = N, l'hôte SMP.
Enregistré leLa date d'enregistrement Peppol du participant — sans fiche annuaire pour un participant trouvé uniquement par le SML.

La recherche s'exécute une fois pour chaque carte entreprise ouverte — y compris une carte restée ouverte depuis une recherche précédente — et elle est aussi disponible 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. Le journal serveur liste chaque participant non résolu avec sa raison. Une indisponibilité de l'annuaire Peppol ne masque plus les participants trouvés par le SML.

La page entière est aussi accessible en un seul appel : GET /api/e-directory/search?q=… (ou POST avec {q, peppol}) renvoie les entreprises INSEE qui correspondent à un nom, un SIREN ou un SIRET, avec siège et établissements, les lignes de l'annuaire PPF de chaque entreprise et, avec peppol=true, ses participants Peppol.

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 :

Serveur NomaUBLtrafic sortant uniquementfirewallRecherche d'entreprise (INSEE)recherche-entreprises.api.gouv.frHTTPS 443Annuaire Peppol — fichesdirectory.peppol.euHTTPS 443SML — zone principale (OpenPeppol)*.participant.sml.prod.tech.peppol.orgDNS 53 · NAPTRSML — zone de repli (ancien SML de la CE)*.edelivery.tech.ec.europa.euDNS 53 · NAPTRRésolveurs publics — sur option (Public DNS fallback = Y)8.8.8.8 · 1.1.1.1DNS 53 · UDP/TCPSMP de la plateforme de chaque participant — Resolve platform via SMP = Yhôte dynamique, par ex. smp.pennylane.comHTTPS 443
ObjetDestinationPort / Protocole
Recherche d'entreprise (INSEE)recherche-entreprises.api.gouv.frHTTPS 443
Annuaire Peppol (fiches)directory.peppol.euHTTPS 443
Résolution SML Peppol — zone principale (OpenPeppol)Requêtes DNS NAPTR sur *.iso6523-actorid-upis.participant.sml.prod.tech.peppol.orgDNS 53 via le résolveur du serveur
Résolution SML Peppol — zone de repli (ancien SML de la Commission européenne)Requêtes DNS NAPTR sur *.iso6523-actorid-upis.edelivery.tech.ec.europa.euDNS 53 via le résolveur du serveur
Résolveurs DNS publics — uniquement avec Public DNS fallback = Y, quand le résolveur du serveur ne répond pas8.8.8.8, 1.1.1.1DNS 53 (UDP et TCP)
SMP Peppol (résolution de la plateforme) — uniquement avec Resolve platform via SMP = Ydynamique — 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.eu sont 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).
  • Le SML a changé de zone en 2026. OpenPeppol a repris le Service Metadata Locator, et les enregistrements des participants se trouvent désormais dans la zone participant.sml.prod.tech.peppol.org. NomaUBL l'interroge en premier et garde l'ancienne zone edelivery.tech.ec.europa.eu en repli. Une politique DNS qui n'autorisait que l'ancienne zone doit ajouter la nouvelle — sinon la plupart des participants ne sont plus trouvés.
  • 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. Certains résolveurs d'entreprise bloquent ou altèrent les requêtes NAPTR : laisser le résolveur d'entreprise relayer les requêtes NAPTR des deux zones, ou passer Public DNS fallback à Y dans les réglages e-directory et autoriser le DNS sortant (port 53, UDP et TCP) vers 8.8.8.8 et 1.1.1.1. Ce repli est désactivé par défaut. Une réponse nom inexistant du résolveur du serveur est définitive — un identifiant non enregistré n'est pas réessayé ailleurs — et un résolveur public défaillant est écarté pour le reste de la recherche.
  • 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, passer Resolve platform via SMP à N : la recherche s'arrête à la réponse du SML et la colonne Plateforme affiche l'hôte SMP (smp.pennylane.com), qui désigne déjà la plateforme — seuls son nom officiel et son identifiant de siège manquent.
  • Diagnostic. Quand directory.peppol.eu est injoignable, les participants trouvés par les interrogations SML restent affichés. Si rien n'est trouvé du tout, la section Peppol indique Peppol Directory unreachable (directory.peppol.eu) — check outbound HTTPS/firewall.

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égler dans Configuration → Système → e-directory, avec le mappage de réponse de la plateforme (ATGP, Yooz, Esker). La liste est lue dans le Response field de l'endpoint (records pour Esker, results…).