PrestaShop mit Billbee verbinden

Du kannst deinen PrestaShop (bis Version 1.7.0, aber mind. Version 1.6.0) an Billbee anbinden. Der Datenabgleich funktioniert über die integrierte API von Presta. Um eine sichere Datenübertragung zu gewährleisten, sollte dein Shop über ein SSL Zertifikat verfügen. Nach der Anbindung deines PrestaShops an Billbee können deine Bestelldaten automatisch im Hintergrund an Billbee übertragen werden und Billbee kann einen geänderten Bestellstatus inklusive Informationen zu Sendungen an PrestaShop übertragen. Wie du die Anbindung einrichtest, findest du in diesem Artikel.

Schritt-für-Schritt Anleitung zur Anbindung

Voreinstellungen bei PrestaShop

Damit du deinen PrestaShop an Billbee anbinden kannst, benötigst du einen Webservice Schlüssel von Presta, welchen du in deinem Presta-Backend erzeugen kannst. Du kannst dafür der Anleitung (auf Englisch) von PrestaShop folgen, die du hier findest, oder befolge die nachfolgenden Schritte, die als Kurzanleitung dienen:

Logge dich in deinem PrestaShop ein und klicke im Menü auf den Bereich „Erweiterte Einstellungen“. Dort wählst du "Webservice" aus.

Klicke jetzt auf "Webservice-Schlüssel hinzufügen".

Jetzt kannst du dir über den Button „Generieren“ deinen Webservice Schlüssel generieren lassen. Optional kannst du auch noch eine Beschreibung einfügen, damit du nachvollziehen kannst, für welche Anwendung der Schlüssel gilt. Jetzt musst du bei den Berechtigungen noch alle Berechtigungen aktivieren und auf "Speichern" klicken.

Anbindung von PrestaShop an Billbee

Um eine neue Shopverbindung bei Billbee einzurichten, klicke unter Einstellungen / Kanäle auf die Kachel "Shop hinzufügen".

Jetzt öffnet sich ein Pop-Up Fenster, in dem dir alle Shop- und Marktplatzverbindungen angezeigt werden, die an Billbee angebunden werden können. Klicke hier auf "PrestaShop".  Anschließend öffnet sich ein Pop-Up Fenster in welchem du folgende Daten eintragen musst:

• Name: Vergib einen beliebigen Namen für deine Anbindung. Dieser Name wird zur Wiedererkennung innerhalb von Billbee genutzt.
• URL: Gib hier die vollständige URL deines Shops ein. Wichtig ist, dass hinter die URL noch das Segment /api gestellt werden muss. So kann dann z. B. so aussehen: http://www.meinprestashop.de/api
• API Key: Gib hier den API-Schlüssel ein, den du zuvor in deinem Presta Backend generiert und mit allen Rechten versehen hast.

Sind alle Daten korrekt hinterlegt, wirst du nach dem Speichern zu den Einstellungen deiner Anbindung geleitet:

2

Bearbeiten von Auftragspositionen verbieten / Erzeugen von Rechnungen mit Billbee verbieten: Du kannst die Bestellpositionen, die mit einer Bestellung aus PrestaShop übermittelt werden, quasi "sperren". Das bedeutet, dass die Auftragspositionen einer Bestellung in Billbee, die von PrestaShop übertragen wurde, dann nicht mehr manuell bearbeitet werden können. Außerdem kannst du Billbee verbieten, dass Rechnungen erstellt werden sollen für Bestellungen, die aus deinem Presta-Shop eingelesen wurden. Dann werden für alle Bestellungen, die von PrestaShop übermittelt werden, keine Rechnungen in Billbee erstellt. Das bedeutet aber auch, dass du generell keine Rechnungen (weder manuell noch automatisch) für Bestellungen erstellen kannst, die dieser Shopverbindung zugeordnet sind.

3

SMTP Server: Hast du bereits einen SMTP Server angelegt bei Billbee, kannst du diesen hier über das Dropdown-Menü auswählen.

4

Zahlung fällig nach X Tagen: Hier kannst du die Anzahl an Tagen angeben, ab wann die Zahlung fällig sein soll. Der angegebene Wert wird dann dem Ausstellungsdatum der Rechnung hinzugefügt. Er wird beim Import von Bestellungen übernommen und in das entsprechende Feld in den Bestelldetails eingetragen (wenn die Zahlart einer Bestellung "Rechnung" ist). Hast du hier keinen individuellen Wert angegeben, erfolgt ein Fallback auf das Ausstellungsdatum der Rechnung +30 Tage.

Wichtig / zu beachten

Statusübertragungen zu PrestaShop

Die Rückübertragung von Statusänderungen erfolgt automatisch. Der PrestaShop-Käufer wird automatisch informiert, wenn du bei Billbee den Status der Bestellung auf bezahlt oder versendet setzt. Die Rückübertragung des Status an PrestaShop kannst du in deiner PrestaShop-Shopverbindung bei Billbee deaktivieren oder auch wieder aktivieren. Das ist dann sinnvoll, wenn du z. B. deine Benachrichtigungen mithilfe der Automatisierung von Billbee versenden möchtest. Du kannst z. B. automatisierte Versandbenachrichtigungen senden oder deine Kund:innen bei Zahlungseingang benachrichtigen. 

Besonderheit bei PrestaShop Version 7

Folgendes muss in die .htaccess Datei von PrestaShop als Zeile eingefügt werden: AuthBasicAuthoritative On

Die PHP Version muss mindestens auf 7.2. aktualisiert werden und PrestaShop am besten auch auf 1.7.6. updaten, dann funktioniert die Verbindung.

Besonderheiten bei selbst gehosteten Shops

Wenn PrestaShop auf eigenen Servern selbst gehostet wird, muss darauf geachtet werden, dass kein altes Datenbank-Backup mit Bestellungen eingespielt wird, die bereits zu Billbee importiert wurden. Der Shop vergibt dann IDs für Bestellungen, die bei Billbee mit dieser ID schon existieren, weshalb diese dann nicht mehr importiert werden. Das kann dazu führen, dass gar keine Bestellungen mehr zu Billbee importiert werden.

Mögliche Fehlercodes & ihre Bedeutung