Aller au contenu principal

Lignes d'annuaire

La ligne d'annuaire représente le point d'adressage publié pour la réception des factures électroniques.

Pour un fournisseur, c'est la ressource essentielle à vérifier avant d'enregistrer ou d'utiliser une adresse de facturation électronique dans son SI.

Rechercher une ligne d'annuaire​

POST /v1/directory-line/search​

Le sous-folder Postman Directory line illustre plusieurs manières de retrouver le bon niveau d'adressage.

Cas 1 — rechercher les lignes d'une unité légale par SIREN​

{
  "filters": {
    "siren": {
      "op": "strict",
      "value": "329048938"
    }
  },
  "fields": [
    "addressingIdentifier",
    "siren",
    "siret",
    "routingIdentifier",
    "addressingSuffix"
  ],
  "limit": 20,
  "ignore": 0
}

Ce cas permet d'identifier les lignes publiées pour une unité légale lorsque le SIREN est connu mais pas encore l'adresse précise à utiliser.

Cas 2 — rechercher les lignes d'un établissement par SIRET​

{
  "filters": {
    "siret": {
      "op": "strict",
      "value": "32904893800172"
    }
  },
  "fields": [
    "addressingIdentifier",
    "siren",
    "siret",
    "routingIdentifier",
    "addressingSuffix"
  ],
  "limit": 20,
  "ignore": 0
}

Ce cas est adapté lorsque le fournisseur a déjà sélectionné l'établissement destinataire.

Cas 3 — rechercher une ligne par SIRET et identifiant de routage​

{
  "filters": {
    "siret": {
      "op": "strict",
      "value": "70204275500240"
    },
    "routingIdentifier": {
      "op": "strict",
      "value": "SERVICE-COMPTA"
    }
  },
  "fields": [
    "addressingIdentifier",
    "siren",
    "siret",
    "routingIdentifier",
    "addressingSuffix"
  ],
  "limit": 20,
  "ignore": 0
}

Utilisez cette recherche lorsque la facture doit être adressée à un service identifié à l'intérieur d'un établissement.

Cas 4 — vérifier une adresse de facturation électronique connue​

Lorsque l'adresse électronique est déjà connue du SI :

{
  "filters": {
    "addressingIdentifier": {
      "op": "strict",
      "value": "0225:007350101"
    }
  },
  "fields": [
    "addressingIdentifier",
    "siren",
    "siret",
    "routingIdentifier",
    "addressingSuffix"
  ],
  "limit": 20,
  "ignore": 0
}

Cet appel répond directement à la question :

L'adresse de facturation électronique que je souhaite enregistrer ou utiliser existe-t-elle dans l'annuaire ?

Le même principe s'applique aux différentes formes d'adresse publiées, par exemple :

0225:<SIREN>
0225:<SIREN>_<SIRET>
0225:<SIREN>_<libellé_de_service>

Utilisez la valeur exacte de l'adresse que le client souhaite utiliser.

Consulter directement une ligne d'annuaire​

GET /v1/directory-line/code:{addressing-identifier}​

Lorsque l'identifiant d'adressage exact est déjà connu, la collection Postman fournit également une consultation directe.

GET /v1/directory-line/code:{{addressing_identifier}}?fields=siren&fields=siret&fields=routingCode

Cette route évite une recherche lorsqu'il s'agit simplement de revalider une adresse déjà enregistrée dans le SI fournisseur.

Création vs revalidation

Lors de la création d'une fiche client, une recherche par SIREN ou SIRET peut aider l'utilisateur à choisir la bonne ligne.

Lors d'une revalidation ultérieure, si addressingIdentifier est déjà connu, la consultation directe est plus adaptée.

Exemple de réponse​

Une ligne d'annuaire active peut notamment exposer les informations suivantes :

{
  "search": {
    "filters": {
      "siret": {
        "op": "strict",
        "value": "55210055400013"
      },
      "routingIdentifier": {
        "op": "strict",
        "value": "DEFAULT"
      }
    },
    "limit": 20,
    "ignore": 0
  },
  "totalNumberOfResults": 1,
  "results": [
    {
      "addressingIdentifier": "55210055400013-DEFAULT",
      "platformType": "WK",
      "directoryLineStatus": "Enabled",
      "siren": "552100554",
      "siret": "55210055400013",
      "routingCode": {
        "routingIdentifier": "DEFAULT",
        "routingIdentifierType": "CODE",
        "routingCodeName": "Service facturation",
        "managesLegalCommitment": false,
        "administrativeStatus": "A"
      },
      "legalUnit": {
        "siren": "552100554",
        "businessName": "BCSOLUTIONS DEMO",
        "entityType": "PrivateVatRegistered",
        "administrativeStatus": "A"
      },
      "facility": {
        "siret": "55210055400013",
        "siren": "552100554",
        "name": "BCSOLUTIONS DEMO",
        "facilityType": "P",
        "administrativeStatus": "A"
      }
    }
  ]
}

Les champs exacts retournés dépendent des fields et include demandés ainsi que du contrat de l'environnement.

Contrôler directoryLineStatus​

Ne considérez pas qu'une adresse est utilisable uniquement parce qu'une ligne est retournée.

Le champ directoryLineStatus doit être contrôlé avant l'utilisation de l'adressage :

ValeurSignificationConséquence
EnabledLigne active et rattachée à une plateformePeut être utilisée pour préparer le routage
DisabledLigne désactivée ou sans plateforme activeNe pas utiliser pour router une facture
UpcomingPlateforme définie avec une date d'effet futureUtilisable seulement à partir de sa date d'effet

Utilisation lors de l'enregistrement de l'adresse dans le SI fournisseur​

La bonne pratique est de vérifier l'adresse au moment où elle est associée au client :

Conservez dans le référentiel client :

  • l'adresse de facturation électronique validée ;
  • le SIREN/SIRET associé si utile ;
  • le code routage éventuel ;
  • la date de dernière vérification.

Avant une émission, une nouvelle vérification peut être nécessaire lorsque l'adresse est ancienne ou susceptible d'avoir évolué.

Ne pas synchroniser l'annuaire

N'utilisez pas POST /v1/directory-line/search pour extraire toutes les lignes de l'annuaire ou maintenir un miroir local. La recherche doit toujours être rattachée à un destinataire ou une adresse métier identifiée.

➡️ Comprendre l'adresse de facturation électronique
➡️ Recherche et pagination