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)…🔍 RechercherNOM · SIREN · SIRET · ADRESSE · ÉTAT · ANNUAIRE PPFACME Manufacturing123 456 789 · 12345678900012 · 12 rue de Rivoli, 75001 ParisActive✓ JoignableACME Logistics123 456 789 · 12345678900037 · 8 av. du Général Leclerc, 92100 BoulogneActiveNon joign.ACME Old SARL123 456 789 · 12345678900029 · 4 rue Lafayette, 75009 ParisFermée— ignorée3 résultats · registre INSEELe registre INSEE est interrogé en premier (API publique gratuite). La vérification dans l'annuaire PPF s'exécute sur chaque résultat avec les identifiants configurés sous Configuration → Système → e-directory.Un seul champ de recherchenom · SIREN · SIRET — auto-détectéBadge Joignable PPFJoignable / Non / FerméeÉtat administratif INSEEActive / Fermée — fermées ignorées

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 lignes, puis le contrôle PPF en parallèle, ligne par ligne. L'utilisateur voit le tableau se remplir en deux passes.

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.

Tableau des résultats​

Après la recherche, le tableau se remplit à raison d'une ligne par correspondance. Chaque ligne correspond soit à un SIREN (entité juridique), soit à un SIRET (établissement spécifique).

ColonneDescription
TypeBadge coloré — SIREN (bleu, entité juridique) ou SIRET (gris, établissement).
IdentifiantSIREN à 9 chiffres ou SIRET à 14 chiffres.
NomRaison sociale (nom_raison_sociale).
AdresseAdresse postale complète de l'établissement.
ÉtatActif (vert) quand l'établissement est administrativement actif ; C (rouge) quand il est cessé.
AnnuaireRésultat du contrôle annuaire PPF — voir ci-dessous.

États du contrôle annuaire​

La colonne Annuaire se remplit automatiquement dès la fin de la recherche — un appel PPF par ligne. Pendant l'exécution, les lignes affichent un spinner. Chaque ligne aboutit ensuite à l'un de ces états :

✓Joignable— Inscrit sur le PPF, prêt à recevoir des factures électroniques.
✗Introuvable— Absent de l'annuaire PPF ; une facture serait retournée avec une erreur de routage (REJ_ADR).
⚠Erreur— L'appel PPF a échoué (réseau, identifiants). Le message de l'API s'affiche à côté de l'icône.
⟳Chargement— Appel PPF en cours ; la ligne aboutira à l'un des états ci-dessus.

Compteur de résultats​

Au-dessus du tableau, un petit libellé indique le nombre de résultats renvoyés 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.
  • Un Introuvable rouge n'est pas toujours définitif. Un acheteur peut ne pas être encore enregistré sur le PPF ; 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.
  • Vérifier l'état actif. Un établissement cessé ne peut pas recevoir de facture, même s'il apparaît dans l'annuaire PPF. Toujours contrôler la colonne État avant de se fier à un mapping d'adresse électronique.
  • Pour des recherches en lot, préférer l'API. Cette page traite une requête à la fois. Pour valider un annuaire de clients en une passe, appeler directement /api/insee-search et /api/check-directory — voir References → API Reference pour les schémas.
  • Une erreur d'annuaire indique souvent un problème d'identifiants. Des Erreur répétées sur des lignes qui devraient répondre viennent typiquement d'identifiants PPF mal configurés dans Configuration → Système → e-directory — corriger là avant de relancer la recherche.