Nutzung der Billbee API
-
Wofür benötige ich die Billbee API?
Mittels der API Schnittstelle von Billbee hast du externen Zugriff auf fast alle Daten und Funktionen innerhalb deines Billbee-Accounts. Ein Beispiel für die Nutzung der API ist, wenn du ein selbst entwickeltes System an Billbee anbindest, welches die Erfassung von Wareneingängen in deinem Lager übernimmt und mit der API die Lagerbestände der bereits vorhandenen Artikel in Billbee aktualisiert. Außerdem können externe Dienstleister, wie bspw. ein Fulfillment via API an Billbee angebunden werden.
-
Kostet die API Nutzung etwas?
Seit dem 1. November 2025 haben wir ein Freemium-Modell für die API-Nutzung eingeführt:
➡️ Kostenfreie Nutzung: Die ersten 100.000 API-Calls pro Monat bleiben pro Anbindung/Tool weiterhin kostenlos.
➡️ Kostenpflichtige Nutzung: Für jeden weiteren API-Call, der über die 100.000er-Marke hinausgeht, fallen Kosten in Höhe von 0,0005 EUR pro API-Call an.
Beispiel: Über den API-Key deiner Lösung werden in einem Kalendermonat 120.000 Calls an die Billbee API getätigt. So fällt nach Abzug der Freigrenze von 100.000 API-Calls für die restlichen 20.000 API-Calls eine Gebühr von 10,00 € für den Kalendermonat an.
-
Was benötige ich zur Nutzung der Billbee API?
Für die Nutzung der API sind grundsätzlich zwei Dinge erforderlich. Zum einen benötigst du einen API Key, der die konkrete Anwendung (unabhängig von dem/der Billbee Nutzer:in) identifiziert. Zum anderen benötigst du deinen Billbee-Nutzernamen und ein spezielles API-Passwort, welches dich als konkrete:n Händler:in identifiziert.
Als Entwickler:in einer Anwendung bekommst du von Billbee einen API-Key. Der API-Key gilt dabei für alle Billbee-Accounts, die deine Anbindung später nutzen sollen. Deshalb ist der API-Key auch nur für dich als Entwickler:in der Schnittstelle (z.B. für Fulfillment-Anbieter, Buchhaltungstools, CRM-Systeme etc.) gedacht.
Den API-Key kannst du ganz einfach über dieses Formular bei uns anfordern: Formular API Key Anfrage".
-
Wo finde ich das Billbee API Passwort?
Das API-Passwort kannst du unter Einstellungen / Billbee API in deinem Billbee-Account aktivieren und festlegen. Hast du es vergessen, kannst du dort auch ein neues Passwort hinterlegen. Bitte beachte bei der Passwortvergabe unsere Passwortlinien (siehe unten).
-
Ich habe mein API-Passwort vergessen. Wie kann ich es mir im Klartext anzeigen lassen?
Das ist aus Sicherheitsgründen leider nicht möglich. Du musst ein neues API-Passwort vergeben. Das kannst du unter Einstellungen / Billbee API machen. Klicke einfach in die Zeile, tippe ein neues Passwort ein und speichere dieses. Bitte beachte hierbei auch unsere Passwortrichtlinien (siehe unten).
-
Muss ich mich an bestimmte Passwortrichtlinien halten?
Bei der Vergabe eines neuen oder Änderung eines alten API Passwortes solltest du darauf achten, ein starkes Passwort zu vergeben. Passwörter müssen mindestens 12 Zeichen lang sein und mindestens einen Groß- und einen Kleinbuchstaben, eine Zahl und ein Sonderzeichen (!@$%^&*+#) beinhalten.
Wichtig: Das API Passwort darf nicht ":" enthalten. Dieses Sonderzeichen führt zu Problemen und Fehlermeldungen in der Anbindung.
-
Kann ich bestimmte Rollen / Rechte für den API Zugriff festlegen?
Für den API Zugriff gibt es keine Zugriffsbeschränkungen. Mittels der API kann man auf alle Daten des Accounts zugreifen, auch wenn es sich um einen Mitarbeiteraccount handelt.
-
Was muss ich als (Service-)Partner tun?
Fülle den Partnervertrag mit deinen Daten, akzeptiere die Nutzungsbedingungen und sende ihn uns unterschrieben an partner@comrce.io. Wir melden uns bei dir bezüglich des "verified by billbee" Siegels, insofern relevant.
So funktioniert es:
1. Seite: 1 Ausfüllen des Feldes auf Seite 1 (Unternehmen)
2. Seite: 11 Haken setzen bei: "Schnittstellenpartner, der sich selbstständig anbindet"
3. Seite 11: Haken setzen bei: "Partner ist berechtigt zur API Nutzung - Ja"
4. Seite 11: Haken setzen bei: "verified by Billbee"* -> sofern ihr eure Lösung verifizieren lassen wollt*
5. Seite 12: Informationen zur Rechnungsstellung, Ort, Datum und Unterschrift ausfüllen
*Mit "verified by Billbee" werden wir ein neues Siegel ins Leben rufen. Eure geschaffene Lösung wird in einem Verifizierungsprozess von uns geprüft und nach erfolgreichem Durchlaufen aktiv an unsere Kund:innen weiterempfohlen. Marketingmaßnahmen, Platzierung auf der Website, Nutzung unseres Logos und alle weiteren Maßnahmen, die mit uns in Verbindung stehen, werden nur möglich sein, wenn eure Lösung entsprechend von uns verifiziert wurde.