Directorio de B2Brouter

El Directorio de B2Brouter es una lista curada de entidades. Las entidades son principalmente receptoras de facturas. B2Brouter utiliza este directorio para asignar el tipo de documento y el tipo de transporte correctos a un Contact. La app de B2Brouter tiene el directorio ya integrado para la creación de Contacts, pero para usar el directorio en tu aplicación debes apoyarte en esta API.

La API del Directorio de B2Brouter no permite la enumeración de entidades. Solo puedes consultar un receptor si ya conoces su país e identificador:

País: El país de la entidad. Puedes listar todos los países disponibles y sus códigos a través de la API aquí.
Scheme: El EAS (Electronic Address Scheme) de la entidad. Para listar los schemes de entidades en B2Brouter puedes usar la API de Schemes.
Id: El identificador de la entidad, que puede ser un número de identificación fiscal o cualquier otro identificador correspondiente al scheme o país.

Búsqueda de entidades

Para obtener información sobre el método de transporte y los tipos de documento que una entidad puede recibir, realiza una Búsqueda en nuestro directorio. Si la entidad está registrada, recibirás una respuesta JSON con los datos básicos de la entidad e información específica sobre la recepción de documentos.

La respuesta incluirá una clave para cada tipo de documento, como Factura, Pedido, Aviso de expedición, etc. Cada documento tendrá los siguientes detalles:

transport_type_code para identificar el transporte más utilizado habitualmente para enviar documentos a la entidad.
document_type_code para identificar el tipo de documento más apropiado para enviar documentos.
other_document_type_codes, un array con otros tipos de documento que la entidad puede recibir.

Para clientes que usan Peppol, puedes realizar una Búsqueda en nuestro directorio para listar todos los tipos de documento Peppol disponibles que usa tu cliente. Ten en cuenta que, en el caso del tipo de transporte Peppol, la lista de otros códigos de tipo de documento puede contener tipos de documento que B2Brouter no es capaz de generar. Puedes listar todos los tipos de documento que B2Brouter admite aquí.

Códigos de enrutamiento específicos por país

Algunas entidades públicas que tienen unidades organizativas u oficinas pueden tener códigos especiales. Si quieres enviar una factura a la administración pública, es posible que necesites usar esos códigos.

Los distintos países usan diferentes números de códigos para designar entidades públicas y oficinas. B2Brouter utiliza los campos cinX_scheme y cinX_value para los códigos de enrutamiento, donde X es un número que puede ir del 1 al 5. El significado de un valor depende de su scheme.

Nota: los schemes 8xxx no forman parte de la lista de códigos EAS. Este rango es específico de B2Brouter.

España (DIR3 / DIRe)

Las entidades públicas españolas usan códigos de enrutamiento DIR3 (scheme 8014):

cin1_value: Oficina contable
cin2_value: Órgano gestor
cin3_value: Unidad tramitadora
cin4_value: Órgano proponente

Las entidades privadas españolas usan códigos de enrutamiento DIRe (scheme 8015):

cin5_value: Código DIRe

Francia

Las empresas o entidades públicas francesas pueden usar code service (scheme 8017). Más información

cin1_value: Code service

Croacia

Las entidades croatas pueden usar el código interno de unidad de negocio croata (cicbu) (scheme 8016)

cin1_value: cicbu

Códigos de enrutamiento EDIFACT

EDIFACT usa códigos GLN (scheme 0088):

cin1_value: Comprador
cin2_value: Lugar de entrega
cin3_value: Receptor de la factura
cin4_value: Pagador
cin5_value: Destinatario final

Búsqueda en el Directorio

Ejemplo de solicitud:

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'