Annuaire B2Brouter

Le B2Brouter Directory est une liste organisée d’entités. Ces entités sont, pour la plupart, des destinataires de factures. B2Brouter utilise cet annuaire pour attribuer le bon type de document et le bon type de transport à un contact. La B2Brouter App intègre déjà l’annuaire lors de la création de contacts, mais pour l’utiliser dans votre application vous devez vous appuyer sur cette API.

L’API B2Brouter Directory ne permet pas l’énumération des entités. Vous pouvez uniquement interroger un destinataire si vous connaissez déjà son pays et son identifiant :

Country : le pays de l’entité. Vous pouvez lister tous les pays disponibles et leurs codes via l’API ici.
Scheme : l’EAS (Electronic Address Scheme) de l’entité. Pour lister les schémas d’entité dans B2Brouter, vous pouvez utiliser la Schemes API.
Id : l’identifiant de l’entité, qui peut être un numéro d’identification fiscale ou tout autre identifiant correspondant au schéma ou au pays.

Recherche d’entité

Pour obtenir des informations sur la méthode de transport et les types de documents qu’une entité peut recevoir, effectuez un Lookup dans notre annuaire. Si l’entité y figure, vous recevrez une réponse JSON contenant les détails de base de l’entité ainsi que des informations spécifiques sur la réception des documents.

La réponse inclura une clé pour chaque type de document, comme Invoice, Order, Despatch Advice, etc. Chaque document contiendra les détails suivants :

transport_type_code pour identifier le transport le plus couramment utilisé pour envoyer des documents à l’entité.
document_type_code pour identifier le type de document le plus approprié pour l’envoi des documents.
other_document_type_codes, un tableau d’autres types de documents que l’entité peut recevoir.

Pour les clients utilisant Peppol, vous pouvez effectuer un Lookup dans notre annuaire afin de lister tous les types de documents Peppol disponibles qu’utilise votre client. Gardez à l’esprit que, dans le cas du transport Peppol, la liste des autres codes de type de document peut contenir des types de documents que B2Brouter n’est pas capable de générer. Vous pouvez lister tous les types de documents pris en charge par B2Brouter ici.

Codes de routage spécifiques à certains pays

Certaines entités publiques disposant d’unités organisationnelles ou de bureaux peuvent avoir des codes spéciaux. Si vous souhaitez envoyer une facture à l’administration publique, il peut être nécessaire d’utiliser ces codes.

Différents pays utilisent un nombre différent de codes pour désigner les entités publiques et les bureaux. B2Brouter utilise les champs cinX_scheme et cinX_value pour les codes de routage, où X est un nombre pouvant aller de 1 à 5. La signification d’une valeur dépend de son schéma.

Remarque : les schémas 8xxx ne font pas partie de la liste de codes EAS. Cette plage est spécifique à B2Brouter.

Espagne (DIR3 / DIRe)

Les entités publiques espagnoles utilisent les codes de routage DIR3 (schéma 8014) :

cin1_value : bureau comptable (Oficina contable)
cin2_value : organe gestionnaire (Órgano gestor)
cin3_value : unité de traitement (Unidad tramitadora)
cin4_value : organe proposant (Órgano proponente)

Les entités privées espagnoles utilisent les codes de routage DIRe (schéma 8015) :

cin5_value : code DIRe (Código DIRe)

France

Les entreprises ou entités publiques françaises peuvent utiliser le code service (schéma 8017). En savoir plus

cin1_value : code service

Croatie

Les entités croates peuvent utiliser le Croatian internal code business unit (cicbu) (schéma 8016)

cin1_value : cicbu

Codes de routage EDIFACT

EDIFACT utilise des codes GLN (schéma 0088) :

cin1_value : acheteur (Comprador)
cin2_value : lieu de livraison (Lugar de entrega)
cin3_value : destinataire de la facture (Receptor de la factura)
cin4_value : payeur (Pagador)
cin5_value : destinataire final (Destinatario final)

Lookup depuis le Directory

Exemple de requête :

curl --request GET \
  --url https://api-staging.b2brouter.net/directory/es/ESB12345678 \
  --header 'X-B2B-API-Key: {YOUR_API_KEY}' \
  --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \
  --header 'accept: application/json'