Zum Hauptinhalt springen
B2Brouter

B2Brouter API aus Odoo: Umgebungen, Schlüssel, Version und Webhooks

Die B2Brouter API arbeitet mit einem Schlüssel pro Umgebung und einer datierten Version bei jedem Aufruf. Wenn Sie mit Odoo fakturieren, löst der B2Brouter-Konnektor das bereits: Sie wählen die Umgebung, fügen den Schlüssel ein, und Odoo sendet die Rechnungen und empfängt die Meldungen. Hier steht, was die API verlangt und wo Sie es in Odoo sehen.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 12. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0
Lesezeit
3 Min.

Was die B2Brouter API verlangt

Für die B2Brouter API brauchen Sie ein B2Brouter-Konto und dessen API-Schlüssel. Sie kopieren den Schlüssel aus dem Reiter Developers derselben B2Brouter-Umgebung, in der Sie arbeiten. Ein Testschlüssel gilt nicht in der Produktion und umgekehrt.

Jeder Aufruf trägt außerdem die API-Version. Der Konnektor setzt sie bei allen Anfragen fest: „X-B2B-API-Version: 2026-06-26“. Wenn Sie diesen Wert in Odoo ändern, muss er ein Datum im Format JJJJ-MM-TT sein. Ein anderes Format speichert Odoo nicht.

Die drei Umgebungen und ihre Adressen

B2Brouter hat drei Umgebungen. Produktion und Sandbox nutzen dieselbe Adresse, https://api.b2brouter.net. Welche erreicht wird, entscheidet das Präfix des Schlüssels. Staging hat eine eigene Adresse, https://api-staging.b2brouter.net.

Der Konnektor prüft das Präfix beim Speichern und noch einmal vor jeder Anfrage:

  • In der Produktion akzeptiert er Schlüssel mit prod_ und ältere Schlüssel ohne Präfix.
  • In der Sandbox akzeptiert er nur Schlüssel mit test_.
  • In Staging akzeptiert er stag_ und test_.

Der Grund ist einfach. Ein Produktionsschlüssel in der Sandbox würde echte Rechnungen senden, ohne dass es jemand merkt. Der Konnektor stoppt das vorher.

In der Sandbox werden Sendungen simuliert, Zahlungen sind abgeschaltet und PDF-Vorschauen tragen das Wasserzeichen „test invoice“. Dort testen Sie Ihre Einrichtung, ohne etwas wirklich zu senden.

So verbindet sich Odoo mit der API

Der Konnektor bringt einen Assistenten unter B2Brouter › Mit B2Brouter verbinden mit. Seine Schritte heißen Willkommen, Umgebung, Holen Sie sich Ihren API-Schlüssel, Verbinden und Fertig.

  1. Installieren Sie den Konnektor in Odoo 17, 18, 19 oder 20 und aktivieren Sie das Abonnement FlexigoTech Cloud. Der Konnektor braucht es, um zu funktionieren.
  2. Wählen Sie die Umgebung: Produktion, Sandbox oder Staging.
  3. Kopieren Sie den API-Schlüssel aus dem Reiter Developers derselben Umgebung und fügen Sie ihn ein.
  4. Geben Sie als Administrator Ihre Zustimmung. FlexigoTech Cloud speichert den Schlüssel verschlüsselt und erhält ihn erst nach dieser Zustimmung.
  5. Testen Sie die Verbindung. Fehlt der Schlüssel, meldet Odoo das, bevor B2Brouter aufgerufen wird.
B2Brouter-Verbindung in Odoo über FlexigoTech Cloud
Die Verbindung über FlexigoTech Cloud: Umgebung, Konto, Einwilligung und der in der Cloud gespeicherte Schlüssel (Demodaten).

Signierte Webhooks und geplante Aufgaben

B2Brouter meldet Änderungen per Webhook. Der Konnektor empfängt sie unter einer eigenen Adresse pro Registrierung, mit einem Token, das niemand erraten kann. Außerdem prüft er die HMAC-SHA256-Signatur jeder Meldung mit dem Geheimnis dieser Registrierung. Was ankommt, sehen Sie unter B2Brouter › Dokumente › Webhook-Ereignisse.

Webhooks ersetzen die regelmäßigen Abfragen nicht. Der Konnektor führt diese Aufgaben aus:

  • Die Dokumentenwarteschlange senden, alle 5 Minuten.
  • Die Webhook-Ereignisse verarbeiten, alle 5 Minuten.
  • Den Status der Rechnungen abfragen, alle 15 Minuten.
  • Die Codelisten aktualisieren, jede Woche.

Die Codelisten kommen aus der API selbst: Schemata, Dokumenttypen, Länder, Währungen, Rechnungsstatus, Sprachen und Transportarten.

Wenn etwas schiefgeht: die Anfrage-ID

Jede Antwort von B2Brouter enthält eine Anfrage-Kennung. Der Konnektor speichert die letzte im Feld Letzte Anfrage-ID der Verbindung. Wenn Sie beim B2Brouter-Support nachfragen, geben Sie diesen Wert an. So findet der Support Ihren Aufruf, ohne dass Sie den Fehler nachstellen müssen.

B2Brouter-Verbindungsassistent in Odoo
Der Verbindungsassistent am Ende: das mit seiner Steuernummer verknüpfte Konto, die Nutzung des Tarifs und die nächsten Schritte (Demodaten).

Was Sie brauchen und was nicht enthalten ist

Sie brauchen ein eigenes B2Brouter-Konto und dessen API-Schlüssel. Die Gebühren von B2Brouter sind nicht enthalten. Den Konnektor gibt es in Odoo Apps für Odoo 17, 18, 19 und 20, und er funktioniert mit dem Abonnement FlexigoTech Cloud. Die Details der Integration stehen auf der Seite des Konnektors.

Kann ich die B2Brouter API testen, ohne echte Rechnungen zu senden?

Ja. Wählen Sie die Sandbox und einen Schlüssel mit test_. Sendungen werden simuliert, und die PDFs tragen das Wasserzeichen für Testrechnungen.

Wo finde ich die Spezifikation der API?

Der Konnektor arbeitet mit der Version 2026-06-26. Ihre OpenAPI-Spezifikation ist auf app.b2brouter.net veröffentlicht.

Speichert Odoo meinen B2Brouter-Schlüssel?

Gespeichert wird er verschlüsselt in FlexigoTech Cloud, und erst nachdem ein Administrator für diese Verbindung zugestimmt hat.

Muss ich für die API etwas programmieren?

Nein. Der Konnektor übernimmt die Aufrufe mit Signatur und Version. Sie wählen die Umgebung und fügen den Schlüssel ein.

Weiterlesen

Geprüft im Quellcode des Connectors (Version 20.0)

Quellen

  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): __manifest__.py
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): static/description/index.html
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): README.md
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): models/fgt_cloud.py
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): models/b2brouter_backend.py
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): wizards/b2brouter_setup_wizard.py
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): views/b2brouter_menus.xml
  • Quellcode des Moduls: b2brouter_connector 20.0 (dc5ea5d4): data/ir_cron.xml