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.
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.