Directori de B2Brouter

El Directori B2Brouter és una llista curada d’entitats. Les entitats són principalment receptors de factures. B2Brouter utilitza aquest directori per assignar el tipus de document i el tipus de transport correctes a un Contacte. L’App B2Brouter ja té el directori integrat per a la creació de contactes, però per utilitzar el directori a la vostra aplicació heu de fer servir aquesta API.

L’API del Directori B2Brouter no permet l’enumeració d’entitats. Només podeu consultar un receptor si ja coneixeu el seu país i identificador:

País: El país de l’entitat. Podeu llistar tots els països disponibles i els seus codis a través de l’API aquí.
Esquema: L’EAS (Electronic Address Scheme) de l’entitat. Per llistar els esquemes d’entitats a B2Brouter podeu utilitzar l’API d’Esquemes.
Id: L’identificador de l’entitat que pot ser un número d’identificació fiscal o qualsevol altre identificador corresponent a l’esquema o país.

Cerca d’entitats

Per obtenir informació sobre el mètode de transport i els tipus de documents que una entitat pot rebre, feu una Cerca al nostre directori. Si l’entitat hi figura, rebreu una resposta JSON amb els detalls bàsics de l’entitat i informació específica sobre la recepció de documents.

La resposta inclourà una clau per a cada tipus de document, com ara Factura, Comanda, Albarà, etc. Cada document tindrà els detalls següents:

transport_type_code per identificar el transport més habitual per enviar documents a l’entitat.
document_type_code per identificar el tipus de document més adequat per enviar documents.
other_document_type_codes, una matriu d’altres tipus de documents que l’entitat pot rebre.

Per als clients que utilitzen Peppol, podeu fer una Cerca al nostre directori per llistar tots els tipus de documents Peppol disponibles que utilitza el vostre client. Tingueu en compte que en el cas del tipus de transport Peppol, la llista d’altres codis de tipus de document pot contenir tipus de documents que B2Brouter no pot generar. Podeu llistar tots els tipus de documents que B2Brouter admet aquí.

Codis d’encaminament per país

Algunes entitats públiques que tenen unitats organitzatives o oficines poden tenir codis especials. Si voleu enviar una factura a l’administració pública, pot ser que hàgiu d’utilitzar aquests codis.

Diferents països utilitzen un nombre diferent de codis per designar entitats públiques i oficines. B2Brouter utilitza els camps cinX_scheme i cinX_value per als codis d’encaminament, on X és un nombre que pot anar de 1 a 5. El significat d’un valor depèn del seu esquema.

Nota: Els esquemes 8xxx no formen part de la llista de codis EAS. Aquest rang és específic de B2Brouter.

Espanya (DIR3 / DIRe)

Les entitats públiques espanyoles utilitzen els codis d’encaminament DIR3 (esquema 8014):

cin1_value: Oficina comptable (Oficina contable)
cin2_value: Òrgan gestor (Órgano gestor)
cin3_value: Unitat tramitadora (Unidad tramitadora)
cin4_value: Òrgan proponent (Órgano proponente)

Les entitats privades espanyoles utilitzen els codis d’encaminament DIRe (esquema 8015):

cin5_value: Codi DIRe (Código DIRe)

França

Les empreses o entitats públiques franceses poden utilitzar code service (esquema 8017). Més informació

cin1_value: Code service

Croàcia

Les entitats croates poden utilitzar Croatian internal code business unit (cicbu) (esquema 8016)

cin1_value: cicbu

Codis d’encaminament EDIFACT

EDIFACT utilitza codis GLN (esquema 0088):

cin1_value: Comprador (Comprador)
cin2_value: Lloc de lliurament (Lugar de entrega)
cin3_value: Receptor de la factura (Receptor de la factura)
cin4_value: Pagador (Pagador)
cin5_value: Destinatari final (Destinatario final)

Cerca al Directori

Exemple de petició:

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'