Codes routage

Un code routage permet de préciser le service ou le circuit destinataire à l'intérieur d'un établissement.

Il peut correspondre à un code service, un GLN, un code ODETTE ou un identifiant interne de gestion publié par le destinataire.

Rechercher un code routage

POST /v1/routing-code/search

Le sous-folder Postman Routing code illustre plusieurs niveaux de précision.

Cas 1 — lister les codes routage d'un SIRET

Utilisez ce cas lorsque l'établissement est connu mais que le code de routage doit encore être sélectionné.

{
  "filters": {
    "siret": {
      "op": "strict",
      "value": "32904893800156"
    }
  },
  "include": [
    "siren",
    "siret"
  ],
  "fields": [
    "siret",
    "routingIdentifierType",
    "routingCodeName",
    "routingIdentifier",
    "administrativeStatus",
    "address"
  ],
  "limit": 20,
  "ignore": 0
}

Cas 2 — vérifier un identifiant de routage connu

Lorsque le SI dispose déjà du SIRET et de l'identifiant de routage :

{
  "filters": {
    "siret": {
      "op": "strict",
      "value": "32904893800156"
    },
    "routingIdentifier": {
      "op": "strict",
      "value": "{{routing_identifier}}"
    }
  },
  "include": [
    "siren",
    "siret"
  ],
  "fields": [
    "siret",
    "routingIdentifierType",
    "routingCodeName",
    "routingIdentifier",
    "administrativeStatus",
    "address"
  ],
  "limit": 20,
  "ignore": 0
}

Ce cas est adapté à la validation d'un code déjà enregistré dans le référentiel client.

Cas 3 — rechercher par libellé du code routage

Lorsque l'utilisateur connaît le service recherché mais pas son identifiant technique :

{
  "filters": {
    "siret": {
      "op": "strict",
      "value": "32904893800156"
    },
    "routingCodeName": {
      "op": "contains",
      "value": "comptabilite"
    }
  },
  "include": [
    "siren",
    "siret"
  ],
  "fields": [
    "siret",
    "routingIdentifierType",
    "routingCodeName",
    "routingIdentifier",
    "administrativeStatus",
    "address"
  ],
  "limit": 20,
  "ignore": 0
}

Le SIRET limite la recherche à l'établissement concerné ; routingCodeName permet ensuite de rechercher un libellé métier.

Pourquoi appeler cette API ?

Utilisez-la lorsque la facture doit être adressée à un service ou un circuit particulier, par exemple :

• service facturation ;
• service achats ;
• entité portant un code d'engagement ;
• circuit spécifique publié par le destinataire.

Exemple de réponse

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

Champs utiles

Champ	Usage
routingIdentifier	Identifiant de routage
routingIdentifierType	Type d'identifiant
routingCodeName	Libellé métier
siret	Établissement de rattachement
administrativeStatus	Statut administratif
managesLegalCommitmentCode	Indique si un numéro d'engagement juridique est géré

Une fois le code approprié identifié, utilisez-le pour rechercher la ligne d'annuaire correspondante.

➡️ Lignes d'annuaire
➡️ Recherche et pagination

Pas d'énumération exhaustive

Ne parcourez pas les SIRET ou les codes de routage pour reconstruire l'annuaire. Cette route doit être appelée à partir d'un contexte client connu et pour un besoin de routage identifié.

Consultation directe

Pour une consultation directe d'un code routage, utilisez uniquement une route confirmée par le Swagger de l'environnement. Les exemples ci-dessus documentent les recherches POST /v1/routing-code/search présentes et cohérentes dans la collection Postman.