Billbee-API aktivieren: Zugangsdaten richtig einrichten
· 3 Minuten Lesezeit

Die Billbee-API aktivierst du in den Einstellungen unter „Billbee API“, indem du dort ein eigenes API-Passwort vergibst. Für eine eigene Anbindung brauchst du zusätzlich einen API-Key, den du separat bei Billbee anforderst. Dieser Beitrag erklärt, welche Zugangsdaten es laut Billbee gibt, wer sie vergibt und wie du sie einrichtest und sicher aufbewahrst.
Wofür brauchst du die Billbee-API?
Über die Billbee-API greift eine angebundene Software auf die Daten und Funktionen deines Billbee-Kontos zu, etwa Bestellungen, Artikel und Versandlabel, ohne dass du im Browser eingeloggt sein musst. Die Billbee-Hilfe nennt als Beispiel ein eigenes System für den Wareneingang: Es aktualisiert die Lagerbestände in Billbee, und Billbee gibt sie an die angeschlossenen Shops und Marktplätze weiter. Auch Packtisch-Software für Billbee arbeitet über die API, einen Überblick gibt der Vergleich der Packtisch-Software für Billbee.
Welche Zugangsdaten brauchst du für die Billbee-API?
Für die API sind zwei unterschiedliche Zugangsdaten nötig: ein API-Key, der die Anwendung selbst identifiziert, und ein Benutzername mit API-Passwort, die dich als Nutzer:in identifizieren. Den API-Key vergibt Billbee an die Entwickler:innen einer Anbindung, das API-Passwort vergibst du selbst in deinem Billbee-Konto. Für den Login an der API brauchst du beides zusammen: deinen Billbee-Benutzernamen und das von dir vergebene API-Passwort. Dein normales Billbee-Kontopasswort funktioniert dafür nicht.
Wie aktivierst du den API-Zugriff und vergibst das API-Passwort?
- Öffne in Billbee die Einstellungen und wähle „Billbee API“.
- Wechsle zum Reiter „Allgemeine Einstellungen“.
- Aktiviere den API-Zugriff.
- Vergib dabei ein API-Passwort: mindestens 12 Zeichen, mit einem Groß- und einem Kleinbuchstaben, einer Zahl und einem Sonderzeichen (!@$%^&*+#); ein Doppelpunkt (:) ist nicht erlaubt.
- Speichere die Einstellung.
Als Benutzername für die API gilt beim Hauptaccount die Mailadresse, auf die dein Billbee-Konto registriert ist; bei einem Mitarbeiter-Account der Benutzername, der bei dessen Anlage vergeben wurde. Für Mitarbeiter-Accounts gibt es laut Billbee keine eigenen Zugriffsbeschränkungen auf die API: Die Rechte eines Mitarbeiters gelten nur für die Nutzung der App, nicht für die API.
Wie bekommst du einen API-Key für eine eigene Anbindung?
Den API-Key fordert die Entwickler:in einer Anbindung über das API-Key-Anfrageformular bei Billbee an. Der Key gilt für alle Billbee-Konten, die diese Anbindung später nutzen, und ist nicht an dein eigenes Konto gebunden.
Was tust du, wenn du das API-Passwort vergisst oder den Mac verkaufst?
Ändere in diesem Fall das API-Passwort in deinem Billbee-Konto, nicht den API-Key. Der Key gehört zur Anwendung, nur das Passwort identifiziert dich als Nutzer:in. Ein gespeichertes API-Passwort kannst du nicht mehr einsehen, auch der Billbee-Support nicht. Leg es deshalb gleich beim Vergeben in einem Passwortmanager ab. Hast du es vergessen oder willst es erneuern, etwa weil du einen Mac verkaufst, auf dem es gespeichert war, vergibst du ein neues und trägst es überall nach, wo das alte genutzt wurde, zum Beispiel in Packhummel. Das Passwort gilt für Hauptaccount und Mitarbeiter-Accounts gleichermaßen: Änderst du es in einem Mitarbeiter-Account, ändert es sich auch im Hauptaccount.
Woran erkennst du, dass Zugangsdaten oder Aktivierung nicht stimmen?
Meldet eine angebundene Software beim Laden von Bestellungen einen Fehler, gibt der Fehlercode laut Billbee einen Hinweis: Der Code 401 („Unauthorized“) bedeutet meist falsche Zugangsdaten: Prüfe Benutzername und API-Passwort, nicht dein normales Kontopasswort. Der Code 403 („Forbidden“) bedeutet, dass die API im Konto nicht aktiviert ist, der Account selbst nicht aktiv ist oder der API-Key gesperrt wurde.
Checkliste zur API-Einrichtung
- Einstellungen → „Billbee API“ geöffnet
- Reiter „Allgemeine Einstellungen“ ausgewählt
- API-Zugriff aktiviert
- API-Passwort vergeben (mind. 12 Zeichen, Groß-/Kleinbuchstabe, Zahl, Sonderzeichen, kein „:“) und sicher aufbewahrt
- API-Key für eigene Anbindungen bei Bedarf über das Anfrageformular bei Billbee angefordert
- Bei Mac-Verkauf oder Verdacht auf Kompromittierung: API-Passwort neu vergeben, nicht den API-Key
Mehr zum Zusammenspiel von Billbee und Mac allgemein steht im Beitrag Billbee auf dem Mac nutzen. Worauf du bei angebundener Software sonst achten solltest, zeigt der Beitrag zur Packtisch-Software für Billbee.
Wo Packhummel dabei hilft
Packhummel ist eine native macOS-App für den Packtisch: Sie zeigt Billbee-Bestellungen eine nach der anderen an, kauft das Porto-Label über Billbee und druckt es per Tastendruck auf dem Etikettendrucker. Für die Anbindung an dein Billbee-Konto braucht Packhummel deine Zugangsdaten zur Billbee-API und speichert sie im macOS-Schlüsselbund statt in einer Datei. Funktionen von Packhummel.