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.
- 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.
- Elige el entorno: producción, sandbox o staging.
- Copia la clave API de la pestaña Developers de ese mismo entorno y pégala.
- Como administrador, da tu consentimiento. FlexigoTech Cloud guarda la clave cifrada y solo la recibe después de ese consentimiento.
- Prueba la conexión. Si falta la clave, Odoo te lo dice antes de llamar a B2Brouter.

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.

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
