Què demana l'API de B2Brouter
Per fer servir l'API de B2Brouter necessites un compte de B2Brouter i la seva clau API. La clau es copia de la pestanya Developers del mateix entorn de B2Brouter on treballaràs. Una clau de proves no serveix a producció, i al revés tampoc.
Cada crida porta també la versió de l'API. El connector la fixa a totes les peticions: «X-B2B-API-Version: 2026-06-26». Si canvies aquest valor a Odoo, ha de ser una data amb el format AAAA-MM-DD. Amb un altre format, Odoo no el desa.
Els tres entorns i les seves adreces
B2Brouter té tres entorns. Producció i sandbox fan servir la mateixa adreça, https://api.b2brouter.net. El que decideix on arriba la crida és el prefix de la clau. Staging té la seva pròpia adreça, https://api-staging.b2brouter.net.
El connector comprova el prefix quan deses la clau i un altre cop abans de cada petició:
- A producció accepta claus que comencen per prod_ i les antigues sense prefix.
- A sandbox només accepta claus que comencen per test_.
- A staging accepta stag_ i test_.
El motiu és senzill. Una clau de producció enganxada a sandbox enviaria factures reals sense que ningú se n'adonés. El connector ho atura abans.
A sandbox els enviaments són simulats, els pagaments estan desactivats i les previsualitzacions en PDF porten la marca «test invoice». És el lloc per provar la configuració sense enviar res de debò.
Com es connecta Odoo amb l'API
El connector porta un assistent a B2Brouter › Connectar amb B2Brouter. Els seus passos són Benvinguda, Entorn, Obtén la teva clau API, Connectar i Fet.
- Instal·la el connector al teu Odoo 17, 18, 19 o 20 i activa la subscripció a FlexigoTech Cloud. El connector la necessita per funcionar.
- Tria l'entorn: producció, sandbox o staging.
- Copia la clau API de la pestanya Developers d'aquell mateix entorn i enganxa-la.
- Com a administrador, dona el teu consentiment. FlexigoTech Cloud guarda la clau xifrada i només la rep després d'aquest consentiment.
- Prova la connexió. Si falta la clau, Odoo t'ho diu abans de cridar B2Brouter.

Webhooks signats i tasques programades
B2Brouter avisa dels canvis amb webhooks. El connector els rep en una adreça pròpia de cada registre, amb un token que no es pot endevinar. A més, comprova la signatura HMAC-SHA256 de cada avís amb el secret d'aquell registre. El que arriba ho veus a B2Brouter › Documents › Esdeveniments de webhook.
Els webhooks no substitueixen les comprovacions periòdiques. El connector té aquestes tasques:
- Enviar la cua de documents, cada 5 minuts.
- Processar els esdeveniments de webhook, cada 5 minuts.
- Consultar l'estat de les factures, cada 15 minuts.
- Actualitzar les llistes de codis, cada setmana.
Les llistes de codis surten de la mateixa API: esquemes, tipus de document, països, monedes, estats de factura, idiomes i tipus de transport.
Quan alguna cosa falla: l'ID de la petició
Cada resposta de B2Brouter porta un identificador de petició. El connector desa l'últim al camp Últim ID de petició de la connexió. Si obres una consulta amb el suport de B2Brouter, dona'ls aquest número. Així troben la teva crida sense que hagis de reproduir l'error.

El que necessites i el que no inclou
Necessites el teu propi compte de B2Brouter i la seva clau API. Les tarifes de B2Brouter no hi són incloses. El connector és a Odoo Apps per a Odoo 17, 18, 19 i 20, i funciona amb la subscripció a FlexigoTech Cloud. Els detalls de la integració són a la pàgina del connector.
Puc provar l'API de B2Brouter sense enviar factures reals?
Sí. Tria l'entorn sandbox i fes servir una clau que comenci per test_. Els enviaments se simulen i els PDF porten la marca de factura de prova.
On és l'especificació de l'API?
El connector treballa amb la versió 2026-06-26. La seva especificació OpenAPI està publicada a app.b2brouter.net.
Odoo desa la meva clau de B2Brouter?
La desa FlexigoTech Cloud, xifrada, i només després que un administrador doni el seu consentiment en aquella connexió.
He de programar res per fer servir l'API?
No. El connector fa les crides, amb la signatura i la versió incloses. Tu tries l'entorn i enganxes la clau.
Continua llegint
Comprovat al codi del connector (versió 20.0)
Fonts
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): README.md
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
- Codi del mòdul: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml
