Wat de B2Brouter API vraagt
Voor de B2Brouter API heb je een B2Brouter-account en de API-sleutel daarvan nodig. Je kopieert de sleutel uit het tabblad Developers van dezelfde B2Brouter-omgeving waarin je gaat werken. Een testsleutel werkt niet in productie, en andersom ook niet.
Elke aanroep bevat ook de API-versie. De koppeling zet die vast bij alle verzoeken: ‘X-B2B-API-Version: 2026-06-26’. Wijzig je die waarde in Odoo, dan moet het een datum zijn in de vorm JJJJ-MM-DD. Een ander formaat slaat Odoo niet op.
De drie omgevingen en hun adressen
B2Brouter heeft drie omgevingen. Productie en sandbox gebruiken hetzelfde adres, https://api.b2brouter.net. Het prefix van de sleutel bepaalt waar de aanroep terechtkomt. Staging heeft een eigen adres, https://api-staging.b2brouter.net.
De koppeling controleert het prefix bij het opslaan van de sleutel en nog eens vóór elk verzoek:
- In productie accepteert ze sleutels die met prod_ beginnen en oudere sleutels zonder prefix.
- In sandbox accepteert ze alleen sleutels die met test_ beginnen.
- In staging accepteert ze stag_ en test_.
De reden is eenvoudig. Een productiesleutel in de sandbox zou echte facturen versturen zonder dat iemand het merkt. De koppeling houdt dat vooraf tegen.
In de sandbox worden verzendingen gesimuleerd, staan betalingen uit en dragen pdf-voorbeelden het watermerk ‘test invoice’. Daar test je je instellingen zonder echt iets te versturen.
Zo koppelt Odoo met de API
De koppeling heeft een wizard onder B2Brouter › Verbinden met B2Brouter. De stappen heten Welkom, Omgeving, Haal je API-sleutel op, Verbinden en Voltooid.
- Installeer de koppeling op Odoo 17, 18, 19 of 20 en activeer het abonnement op FlexigoTech Cloud. De koppeling heeft het nodig om te werken.
- Kies de omgeving: productie, sandbox of staging.
- Kopieer de API-sleutel uit het tabblad Developers van diezelfde omgeving en plak hem.
- Geef als beheerder je toestemming. FlexigoTech Cloud bewaart de sleutel versleuteld en ontvangt hem pas na die toestemming.
- Test de verbinding. Ontbreekt de sleutel, dan meldt Odoo dat voordat B2Brouter wordt aangeroepen.

Ondertekende webhooks en geplande taken
B2Brouter meldt wijzigingen via webhooks. De koppeling ontvangt ze op een eigen adres per registratie, met een token dat niemand kan raden. Ze controleert ook de HMAC-SHA256-handtekening van elke melding met het geheim van die registratie. Wat binnenkomt, zie je onder B2Brouter › Documenten › Webhookgebeurtenissen.
Webhooks vervangen de periodieke controles niet. De koppeling voert deze taken uit:
- De documentwachtrij versturen, elke 5 minuten.
- De webhookgebeurtenissen verwerken, elke 5 minuten.
- De status van facturen opvragen, elke 15 minuten.
- De codelijsten bijwerken, elke week.
De codelijsten komen uit de API zelf: schema's, documenttypen, landen, valuta, factuurstatussen, talen en transportsoorten.
Als er iets misgaat: de verzoek-ID
Elk antwoord van B2Brouter bevat een verzoek-ID. De koppeling bewaart de laatste in het veld Laatste verzoek-ID van de verbinding. Neem je contact op met de support van B2Brouter, geef dan die waarde door. Zo vinden ze je aanroep zonder dat je de fout opnieuw hoeft te veroorzaken.

Wat je nodig hebt en wat niet inbegrepen is
Je hebt een eigen B2Brouter-account met API-sleutel nodig. De kosten van B2Brouter zijn niet inbegrepen. De koppeling staat in Odoo Apps voor Odoo 17, 18, 19 en 20 en werkt met het abonnement op FlexigoTech Cloud. De details van de integratie staan op de pagina van de koppeling.
Kan ik de B2Brouter API testen zonder echte facturen te versturen?
Ja. Kies de sandbox-omgeving en gebruik een sleutel die met test_ begint. Verzendingen worden gesimuleerd en de pdf's dragen het watermerk voor testfacturen.
Waar staat de specificatie van de API?
De koppeling werkt met versie 2026-06-26. De OpenAPI-specificatie daarvan staat op app.b2brouter.net.
Bewaart Odoo mijn B2Brouter-sleutel?
FlexigoTech Cloud bewaart hem, versleuteld, en pas nadat een beheerder voor die verbinding toestemming heeft gegeven.
Moet ik iets programmeren om de API te gebruiken?
Nee. De koppeling doet de aanroepen, met handtekening en versie. Jij kiest de omgeving en plakt de sleutel.
Lees verder
Gecontroleerd in de broncode van de connector (versie 20.0)
Bronnen
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): README.md
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
- Broncode van de module: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml
