API Zugriff einrichten

Du hast bei Billbee die Möglichkeit eine API-Schnittstelle zu nutzen, mit der du Zugriff auf fast alle Daten und Funktionen innerhalb deines Billbee-Accounts hast. 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. Billbee wiederum übermittelt die neuen Bestände dann an die angebundenen Shops und Marktplätze. Wie du den API-Zugriff einrichtest, findest du im folgenden Artikel.

In diesem Artikel

Schritt-für-Schritt Anleitung zur Einrichtung

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. Als Entwickler:in einer Anwendung bekommst du von Billbee einen API-KEY, Der API-KEY gilt dabei für alle Billbee-Accounts, auf die diese Anbindung zugreifen sollen, deshalb bekommt nur der/die Entwickler:in einen API-KEY. Zusätzlich benötigt der/die Entwickler:in von dem/der Billbee-Nutzer:in ein API-Passwort, was diese selbst vergeben können. Nur so ist der Zugriff auf die Daten eines Billbee-Accounts möglich. Den API-Key benötigen lediglich die Entwickler:innen einer Schnittstelle (Flulfillment-Anbieter, Buchhaltungstools, CRM-Systeme etc.). Du als "normale:r" User:in, der/die einen Dienstleister anbinden möchte, benötigt in der Regel keinen Key. Den API Key können Entwickler:innen direkt bei uns anfordern über support@billbee.io.

Zum anderen benötigst du einen Nutzernamen und ein spezielles API-Passwort, welches dich als konkrete:n Händler:in identifiziert. Unter Einstellungen / Billbee API kannst du den API-Zugriff bei Billbee aktivieren. Im Reiter "Allgemeine Einstellungen" kannst die Aktivierung vornehmen und das Passwort festlegen, welches für die Aufrufe verwendet werden soll. Achte bitte darauf, dass du ein starkes Passwort vergibst, das min. 8 Zeichen lang ist und min. einen Groß- und einen Kleinbuchstaben sowie min. eine Zahl beinhaltet. Diese Passwortrichtlinie gilt auch für das Abändern von alten Passwörtern.

Beim Hauptaccount ist der Nutzernamen die Mailadresse auf die dein Billbee Account registriert ist. Soll der API Zugriff von einem Mitarbeiter Account erfolgen nutzt du den Nutzernamen welcher bei anlage des Mitarbeiteraccounts für diesen vergeben wurde.

Dein Billbee Login + dein vergebenes API Passwort sind also der Login für die Billbee API.

Neben dem Reiter "Allgemeine Einstellungen" findest du hier auch noch den Reiter "Rechnungserstellung". Hier kannst du festlegen, das beim Zugriff über die Billbee-API Rechnungen erzeugt werden dürfen. Standardmäßig ist diese Einstellung nicht aktiviert, kann aber von dir jederzeit aktiviert oder deaktiviert werden.

Hast du alle notwendigen Einstellungen für die API vorgenommen, dann kannst du mit dem Hauptnutzer deines Billbee-Accounts oder einem Mitarbeiteraccount auf die API zugreifen.


Wichtig / Zu beachten


  • Für die API gibt es keine Zugriffsbeschränkungen für Mitarbeiteraccounts. Die Rechte des Mitarbeiters beziehen sich nur auf die Nutzung der App, nicht auf die Nutzung der API.

  • Das Passwort wird einmalig für den Account festgelegt und ist sowohl für den Hauptaccount als auch für alle Mitarbeiteraccounts gleich.

API Dokumentation

Die aktuelle technische Dokumentation der Billbee API Schnittstelle kannst du hier einsehen.

SDKs zur einfachen Integration

Für .NET und PHP bieten wir jeweils ein SDK an. Hiermit gelingt die Integration in dein bestehendes Projekt ganz einfach.

War dieser Artikel hilfreich? Vielen Dank für dein Feedback Bei der Übermittlung deines Feedback gab es Probleme, bitte probiere es erneut.

Du brauchst weiterhin Hilfe? Support kontaktieren Support kontaktieren