Zum Hauptinhalt springen
Billbee

Die Billbee API aus Odoo: Key, API-Passwort, Kontingent und was bei Fehlern passiert

Um mit der Billbee API zu sprechen, brauchen Sie drei Dinge: den Key der Integration, Ihren Billbee-Benutzernamen und ein API-Passwort. Mit dem Odoo-Konnektor stellt FlexigoTech den Key, und Ihr Benutzername und Ihr Passwort gehen einmal, verschlüsselt, an FlexigoTech Cloud.

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

Das Wichtigste

Modul
Billbee
Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Connectors, Version 20.0 · in den Quellen am Ende
Lesezeit
5 Min.

Was Billbee verlangt

Laut seiner Hilfe braucht die Billbee API den API-Key der Anwendung und dazu «deinen Billbee-Nutzernamen und ein spezielles API-Passwort, welches dich als konkrete:n Händler:in identifiziert.» Außerdem gilt: «Passwörter müssen mindestens 12 Zeichen lang sein», und das API-Passwort darf keinen Doppelpunkt enthalten. Billbee ergänzt: «Für den API Zugriff gibt es keine Zugriffsbeschränkungen.»

Seit dem 1. November 2025 gilt laut seiner Seite zu den API-Preisen: «Die ersten 100.000 API-Calls pro Monat bleiben pro Anbindung/Tool weiterhin kostenlos.» Und: «Pro Tool/Anbindung ist genau ein API-Key zulässig.» Die Rechnung geht immer an den Inhaber der Schnittstelle.

Der Key gehört FlexigoTech, Ihre Zugangsdaten gehen an FlexigoTech Cloud

Weil Billbee einen Key pro Tool vergibt, gehört der Key des Konnektors FlexigoTech. Jeder Aufruf von Ihrem Odoo an Billbee läuft über FlexigoTech Cloud, auf unseren Servern in Deutschland. Dort kommen Ihr Benutzername und Ihr API-Passwort, verschlüsselt gespeichert, zusammen mit diesem Key dazu. Ein Aufruf geht nur raus, wenn es eine aktive Testphase oder ein aktives Abonnement von FlexigoTech Cloud gibt.

Das API-Passwort ist nur beschreibbar und wird nicht in Odoo gespeichert. Wenn Sie es im Konto unter Billbee › Konfiguration › Konten speichern, gehen Ihr Benutzername, der im Datensatz bleibt, und das Passwort zusammen an FlexigoTech Cloud. Vorher bestätigen Sie per Häkchen, dass FlexigoTech Cloud Ihre Billbee-Zugangsdaten aufbewahrt und die Aufrufe darüber laufen. Die Hilfe des Feldes erinnert daran, dass es das API-Passwort ist, getrennt vom Login-Passwort, mindestens 12 Zeichen lang und ohne Doppelpunkt.

Das Billbee-Konto in Odoo
Billbee › Konfiguration › Konten: das verbundene Konto, mit den in FlexigoTech Cloud gespeicherten Zugangsdaten und dem Datum des letzten Tests.

Die Verbindung testen

Verbindung testen liest eine Seite mit einer einzigen Bestellung aus Billbee. Antwortet Billbee, steht das Konto auf Verbunden, speichert das Testdatum, und der Datensatz lädt sich von selbst neu. Antwortet es mit 401 oder 403, steht das Konto auf Authentifizierungsfehler und bittet Sie, Benutzernamen und API-Passwort zu prüfen.

Nur ein Odoo-Administrator kann Billbee mit diesen Zugangsdaten aufrufen. Die geplanten Aufgaben, die Bestellbenachrichtigung und die Sendung, die beim Validieren einer Lieferung rausgeht, rufen als System auf. Wenn Sie das Konto archivieren, ruft Odoo Billbee damit nicht mehr auf: Es ist der Schalter, der alles stoppt.

Das Kontingent an Aufrufen: nur fragen, was sich geändert hat

Um wenige Aufrufe zu verbrauchen, fragt jeder Bestelllauf nur nach den Bestellungen, die sich seit dem vorigen geändert haben, und die Bestandsaufgabe sendet nur die Produkte, deren Zahl sich geändert hat, bis zu 100 pro Aufruf. Der Konnektor zählt die Aufrufe nicht: Der Nutzungsaufruf von Billbee steht in seinem Code, aber keine Ansicht und keine Aufgabe verwendet ihn. Die Aufrufe werden trotzdem in Billbee › Sync-Protokoll geschrieben, mit der Methode, dem Pfad, dem Antwortcode und den Millisekunden.

Wenn etwas schiefgeht

Antwortet Billbee mit 429, zu viele Aufrufe, versucht Odoo es bis zu 5 Mal erneut und wartet so lange, wie Billbee verlangt, oder eine Zeit, die sich bei jedem Versuch verdoppelt, jedes Mal höchstens 300 Sekunden. Ein 5xx-Fehler von Billbee wird bis zu 3 Mal wiederholt. Eine Pause von FlexigoTech Cloud wird nicht wiederholt.

Odoo folgt keinen Weiterleitungen: Antwortet Billbee mit einer, wird der Aufruf mit einem Fehler abgelehnt, damit die Zugangsdaten nicht woandershin gehen.

Jeder Fehler im Protokoll erstellt eine Aktivität für den Verantwortlichen des Kontos (gibt es keinen, für die Person, die gerade arbeitete). Die tägliche Bereinigung löscht Protokollzeilen, die älter als 90 Tage sind.

Odoo mit FlexigoTech Cloud verbunden
Der Bereich FlexigoTech Cloud in den Odoo-Einstellungen: die verbundene Datenbank und der Billbee-Konnektor in seiner Testphase.

Die Bestellbenachrichtigung

Mit Webhook bei Billbee registrieren (bestmöglich) im Konto registriert Odoo die Benachrichtigung über neue Bestellungen in Billbee. Bevor Billbee sie annimmt, prüft es die Adresse, und Odoo antwortet nur dann mit demselben Text, wenn die Adresse das Geheimnis des Kontos trägt. Danach lässt jede Benachrichtigung Odoo diese Bestellung lesen oder, wenn es sie nicht findet, sofort den Bestelllauf starten. Auch wenn die Benachrichtigung fehlt, kommen die Bestellungen mit der Aufgabe alle 15 Minuten an.

Was jeder Lauf mit den Bestellungen macht, steht in Billbee-Bestellungen in Odoo, und die Begriffe von Billbee in Billbee, was ist das.

Wir haben es mit einem Billbee-Konto getestet

Am 17-11-2026 haben wir mit einem Billbee-Testkonto für Händler und dem Testdienst von FlexigoTech Cloud die Verbindung, den Bestand, die Bestellungen und den Versand von Anfang bis Ende auf Odoo 20 getestet, ohne Fehler. Am 18-11-2026 haben wir mit Version 1.2.11 auf Odoo 17, 18, 19 und 20 die Bestellbenachrichtigung registriert, und Billbee prüfte zuerst die Adresse. Auf Odoo 17, 18 und 20 kam eine danach in Billbee erstellte Bestellung in Odoo an.

Fragen zur Billbee API und Odoo

Brauche ich einen eigenen Billbee-API-Key?

Nein. Der Key gehört zur Integration, und er ist von FlexigoTech. Sie geben Ihren Billbee-Benutzernamen und ein API-Passwort ein, das Sie in Billbee getrennt von Ihrem Login-Passwort anlegen.

Wo wird mein API-Passwort gespeichert?

In FlexigoTech Cloud, verschlüsselt. In Ihrem Odoo ist das Feld nur beschreibbar: Sie können es ändern, aber nicht lesen.

Was kostet es?

Das Modul kostet 9 € pro Odoo-Version in Odoo Apps. Es läuft mit FlexigoTech Cloud, ab 49 €/Monat: Plan Konnektor Standard für 49 €/Monat oder 490 €/Jahr, oder Pro für 98 €/Monat oder 980 €/Jahr, ohne MwSt. Die Testphase dauert 14 Tage, kostenlos und ohne Karte. Enthalten sind 2 Monate Support für die Inbetriebnahme und, solange Sie Abonnent bleiben, Updates und Support, wie es die Verkaufsbedingungen 2.2 vorsehen. Alles steht auf der Seite des Billbee-Konnektors.

Mit welchen Odoo-Versionen funktioniert es?

Mit Odoo 17, 18, 19 und 20, auf Odoo.sh oder auf Ihrem eigenen Server. Auf Odoo Online funktioniert es nicht. Ihr Billbee-Konto mit Benutzernamen und API-Passwort und sein Tarif kommen separat.

Weiterlesen

Billbee Bestellungen in Odoo importieren: mit Kunde, Zeilen per SKU und der richtigen MwSt.Wie der Konnektor Billbee-Bestellungen in Odoo Verkauf bringt: alle 15 Minuten, mit Kunde, Lieferadresse, Zeilen per SKU, MwSt. inklusive und Automatisierung.Billbee Lagerbestand aus Odoo: die Zahl, die ankommt, wie oft, und was passiert, wenn sie nicht stimmtWelchen Bestand der Odoo-Konnektor an Billbee sendet, warum er unbestätigte Billbee-Bestellungen abzieht und was der sechsstündliche Abgleich macht.Billbee Versand aus Odoo: eine Bestellung, die in zwei Lieferungen rausgeht, und was Billbee bei jeder siehtWas Odoo beim Validieren jeder Lieferung an Billbee sendet: die Sendungsnummer, den Zusteller, den Status versendet erst am Ende und das Etikett.Billbee, was ist das, und was jeder seiner Begriffe in Odoo istWas Billbee ist, wer es nutzt und was seine Begriffe bedeuten (Status, Reklamation, Freier Provider, API-Passwort), wenn Sie es mit Odoo verbinden.
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen

Quellen

  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:172
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:103
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:110
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_account.py:541
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:230
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:215
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:196
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:153
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:148
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:265
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:76
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_sync_log.py:117
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:144
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): controllers/main.py:96
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_order.py:582
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:237
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_product.py:124
  • Quellcode des Moduls: flexigobe_billbee_connector 20.0 (a5ae481e): models/billbee_api_client.py:342
  • hilfe.billbee.io/article/1505-nutzung-der-billbee-api
  • hilfe.billbee.io/article/1506-preisgestaltung-der-billbee-api
  • Echter Test von FlexigoTech mit einem Billbee-Testkonto (17. und 18.11.2026)
  • flexigotech.com/de/billbee-odoo-anbindung.html
  • www.billbee.io/
  • www.billbee.io/en