Directory Service

Ressources SANDBOX

➡️ Swagger Tenant Public API
➡️ Télécharger bcs-tenant-public-api
➡️ Ouvrir dans Postman ↗

Dans Postman, utilisez le folder Directory service (AFNOR). Les exemples y sont regroupés en quatre sous-folders :

• SIREN ;
• SIRET ;
• Routing code ;
• Directory line.

Le Directory Service permet au SI d'un fournisseur de consulter l'annuaire réglementaire afin de vérifier l'existence d'un destinataire et de déterminer l'adresse de facturation électronique à utiliser pour router une facture.

À quel moment utiliser le Directory Service ?

Le Directory Service ne doit pas être utilisé uniquement au moment du dépôt d'une facture.

Il est particulièrement utile au moment où le SI du fournisseur crée ou met à jour la fiche de facturation d'un client :

1. l'utilisateur saisit ou sélectionne un SIREN, un SIRET ou une adresse de facturation électronique ;
2. le SI vérifie la donnée avec le Directory Service ;
3. le SI enregistre l'adresse validée dans son référentiel client ;
4. avant l'émission d'une facture, le SI peut vérifier à nouveau que l'adressage est toujours utilisable.

Cette vérification est importante car l'adressage peut évoluer : création d'une nouvelle ligne, désactivation, date d'effet future ou mobilité vers une autre Plateforme Agréée.

Usage strictement ciblé

Le Directory Service est une API de vérification nécessaire à la facturation électronique.

Les usages attendus sont notamment :

• vérifier l'existence d'un SIREN ;
• vérifier l'existence d'un SIRET ;
• retrouver les établissements d'une unité légale connue ;
• vérifier un code de routage lorsque le destinataire en utilise un ;
• vérifier l'existence et l'état d'une adresse de facturation électronique dans l'annuaire.

Il ne doit pas être utilisé pour :

• aspirer ou télécharger l'annuaire ;
• parcourir systématiquement les entreprises, établissements ou lignes d'adressage ;
• reconstituer une copie exhaustive de l'annuaire ;
• alimenter une base de prospection ou d'enrichissement commercial.

La pagination n'est pas un mécanisme d'export : elle sert uniquement à parcourir les résultats d'une recherche ciblée.

Exemples disponibles dans la collection Postman

Ressource	Exemples
SIREN	recherche par SIREN, recherche par raison sociale, recherche des unités légales administrativement actives par raison sociale, consultation directe par SIREN
SIRET	recherche par SIRET, recherche des établissements d'un SIREN, recherche par nom, recherche des établissements actifs par nom + code postal, consultation directe par SIRET
Code routage	recherche par SIRET, vérification par SIRET + identifiant de routage, recherche par SIRET + libellé du code
Ligne d'annuaire	recherche par SIREN, par SIRET, par SIRET + identifiant de routage, par addressingIdentifier, consultation directe par addressingIdentifier

Contrat OpenAPI

La collection Postman fournit des exemples d'utilisation. Le Swagger/OpenAPI de l'environnement reste la référence contractuelle pour les routes, champs et opérateurs effectivement exposés.

Quel endpoint choisir ?

Je connais...	Appel conseillé
le SIREN exact	GET /v1/siren/code-insee:{siren}
une raison sociale	POST /v1/siren/search
le SIREN et je cherche ses établissements	POST /v1/siret/search avec filtre siren
le SIRET exact	GET /v1/siret/code-insee:{siret}
le nom ou le code postal d'un établissement	POST /v1/siret/search
le SIRET et je dois identifier un service / code de routage	POST /v1/routing-code/search
le SIREN ou le SIRET et je dois retrouver les lignes d'adressage	POST /v1/directory-line/search
l'adresse électronique 0225:... exacte	POST /v1/directory-line/search avec addressingIdentifier, ou GET /v1/directory-line/code:{addressing-identifier}

Lorsque vous connaissez l'identifiant exact et qu'une route directe existe, privilégiez-la. Les routes /search servent aux recherches ciblées nécessitant des critères, des champs sélectionnés ou plusieurs résultats.

➡️ Entreprises et établissements
➡️ Codes routage
➡️ Lignes d'annuaire et adresses électroniques
➡️ Recherche, filtres et pagination