Saltar al contenido principal
B2Brouter

B2Brouter API desde Odoo: entornos, claves, versión y webhooks

La API de B2Brouter trabaja con una clave por entorno y con una versión fechada en cada llamada. Si facturas con Odoo, el conector de B2Brouter ya lo trae resuelto: eliges el entorno, pegas la clave y Odoo envía las facturas y recibe los avisos. Aquí tienes lo que pide la API y dónde lo ves dentro de Odoo.

FlexigoTech · Responsable: Víctor Gómez · Actualizado el 12 de noviembre de 2026

Lo esencial

Módulo
B2Brouter
Versiones
Odoo 17, 18, 19 y 20
Comprobado
en el código del conector, versión 20.0
Lectura
4 min

Qué pide la API de B2Brouter

Para usar la API de B2Brouter necesitas una cuenta de B2Brouter y su clave API. La clave se copia de la pestaña Developers del mismo entorno de B2Brouter en el que vas a trabajar. Una clave de pruebas no vale en producción, y al revés tampoco.

Cada llamada lleva además la versión de la API. El conector la fija en todas las peticiones: «X-B2B-API-Version: 2026-06-26». Si cambias ese valor en Odoo, tiene que ser una fecha con el formato AAAA-MM-DD. Con otro formato, Odoo no lo guarda.

Los tres entornos y sus direcciones

B2Brouter tiene tres entornos. Producción y sandbox usan la misma dirección, https://api.b2brouter.net. Lo que decide a cuál llega la llamada es el prefijo de la clave. Staging tiene su propia dirección, https://api-staging.b2brouter.net.

El conector comprueba el prefijo al guardar la clave y otra vez antes de cada petición:

  • En producción acepta claves que empiezan por prod_ y las antiguas sin prefijo.
  • En sandbox solo acepta claves que empiezan por test_.
  • En staging acepta stag_ y test_.

La razón es sencilla. Una clave de producción pegada en sandbox enviaría facturas reales sin que nadie se diera cuenta. El conector lo para antes.

En sandbox los envíos son simulados, los pagos están desactivados y las vistas previas en PDF llevan la marca «test invoice». Es el sitio para probar tu configuración sin enviar nada de verdad.

Cómo se conecta Odoo con la API

El conector trae un asistente en B2Brouter › Conectar con B2Brouter. Sus pasos son Bienvenida, Entorno, Obtén tu clave API, Conectar y Hecho.

  1. Instala el conector en tu Odoo 17, 18, 19 o 20 y activa la suscripción a FlexigoTech Cloud. El conector la necesita para funcionar.
  2. Elige el entorno: producción, sandbox o staging.
  3. Copia la clave API de la pestaña Developers de ese mismo entorno y pégala.
  4. Como administrador, da tu consentimiento. FlexigoTech Cloud guarda la clave cifrada y solo la recibe después de ese consentimiento.
  5. Prueba la conexión. Si falta la clave, Odoo te lo dice antes de llamar a B2Brouter.
Conexión de B2Brouter en Odoo por FlexigoTech Cloud
La conexión por FlexigoTech Cloud: entorno, cuenta, consentimiento y la clave guardada en la nube (datos de demostración).

Webhooks firmados y tareas programadas

B2Brouter avisa de los cambios con webhooks. El conector los recibe en una dirección propia de cada registro, con un token que no se puede adivinar. Además comprueba la firma HMAC-SHA256 de cada aviso con el secreto de ese registro. Lo que llega lo ves en B2Brouter › Documentos › Eventos de webhook.

Los webhooks no sustituyen a las comprobaciones periódicas. El conector tiene estas tareas:

  • Enviar la cola de documentos, cada 5 minutos.
  • Procesar los eventos de webhook, cada 5 minutos.
  • Consultar el estado de las facturas, cada 15 minutos.
  • Actualizar las listas de códigos, cada semana.

Las listas de códigos salen de la propia API: esquemas, tipos de documento, países, monedas, estados de factura, idiomas y tipos de transporte.

Cuando algo falla: el ID de la petición

Cada respuesta de B2Brouter trae un identificador de petición. El conector guarda el último en el campo Último ID de petición de la conexión. Si abres una consulta con el soporte de B2Brouter, dales ese número. Así encuentran tu llamada sin que tengas que reproducir el error.

Asistente de conexión de B2Brouter en Odoo
El asistente de conexión al terminar: la cuenta enlazada con su NIF, el uso del plan y los siguientes pasos (datos de demostración).

Lo que necesitas y lo que no incluye

Necesitas tu propia cuenta de B2Brouter y su clave API. Las tarifas de B2Brouter no están incluidas. El conector está en Odoo Apps para Odoo 17, 18, 19 y 20, y funciona con la suscripción a FlexigoTech Cloud. Los detalles de la integración están en la página del conector.

¿Puedo probar la API de B2Brouter sin enviar facturas reales?

Sí. Elige el entorno sandbox y usa una clave que empiece por test_. Los envíos se simulan y los PDF llevan la marca de factura de prueba.

¿Dónde está la especificación de la API?

El conector trabaja con la versión 2026-06-26. Su especificación OpenAPI está publicada en app.b2brouter.net.

¿Odoo guarda mi clave de B2Brouter?

La guarda FlexigoTech Cloud, cifrada, y solo después de que un administrador dé su consentimiento en esa conexión.

¿Tengo que programar algo para usar la API?

No. El conector hace las llamadas, firma y versión incluidas. Tú eliges el entorno y pegas la clave.

Sigue leyendo

Comprobado en el código del conector (versión 20.0)

Fuentes

  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): README.md
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
  • Código del módulo: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml