Shopware 6 mit Billbee verbinden

Neben der Version 4 und 5 von Shopware unterstützt Billbee auch die Version 6 des Shopware-Shops. Wie du deinen Shopware-Shop an Billbee anbindest und was du beachten musst, findest du in diesem Artikel.

In diesem Artikel

Schritt-für-Schritt Anleitung zur Anbindung

Voreinstellungen bei Shopware

Damit du deinen Shopware-Shop an Billbee anbinden kannst, benötigst du Zugangsdaten. Gehe dafür in Shopware 6 Adminbereich auf "Einstellungen" und dort auf den Menüpunkt "System" und anschließend auf "Benutzer & Rechte" (*). Jetzt kannst du unter "Rollen" auf den Button "Neue Rolle" klicken.

Hier vergibst du als Namen "Billbee" und vergibst nachfolgende Berechtigungen. Hier ist es wichtig, dass du die Berechtigungen genau so vergibst, wie in der Tabelle dargestellt, da sonst die Anbindung nicht funktioniert.

Berechtigung	Ansehen	Bearbeiten
Andere
Verkaufskanäle	✓
Bestellungen
Bestellungen	✓	✓
Einstellungen
Anreden	✓
Länder	✓
Lieferzeiten	✓
Maßeinheiten	✓
Sprachen	✓
Steuern	✓
Wesentliche Merkmale	✓
Zahlungsarten	✓
Zusatzfelder	✓
Kataloge(*)
Produkte	✓	✓
Kunden(*)
Kunden(*)	✓
Marketing
Rabatte & Aktionen	✓

Auf der gleichen Seite musst du jetzt oben im Reiter "Detaillierte Privilegien" noch folgende Berechtigungen aktivieren.

Berechtigung	Lesen	Schreiben
order_delivery_position	✓
order_tag	✓
product_translation	✓
product_price	✓

Klicke jetzt oben auf Speichern, um die Rolle von Billbee zu speichern. Jetzt musst du unter "Benutzer" eine:n neue:n Benutzer:in mit dem Button "Neuer Benutzer" (*) anlegen und das Formular entsprechend ausfüllen. Wichtig hierbei ist, dass bei "Rollen" die gerade erzeugte Billbee-Rolle ausgewählt wird. Die Felder "Benutzername" und "Passwort" sind die Zugangsdaten, die später dann bei der Anbindung in deinem Billbee-Account hinterlegt werden müssen.

Voreinstellungen bei Shopware Cloud Nutzung

Nutzt du Shopware Cloud ist es notwendig, in deinem Shopware 6 Account Billbee als Integration anzulegen.

Gehe hierfür in Shopware zu "Einstellungen" - "Integrationen". Anschließend klickst du oben rechts auf den Button "Integration anlegen".

Jetzt öffnet sich ein Pop-Up Fenster in welchem du einen Namen für die Integration hinterlegen musst (bspw. Billbee). Außerdem muss der Schieberegler für „Administrator“ aktiviert sein.

Die dir angezeigten Daten der Zugangs-ID und des Sicherheitsschlüssels musst du dir kopieren, da du sie im Nachgang in Billbee hinterlegen musst.

Speichere die Integration und gehe anschließend zu Billbee, um die Anbindung vorzunehmen.

Anbindung von Shopware 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 "Shopware 6". Anschließend öffnen sich ein weiteres Pop-Up Fenster in welchem du die Zugangsdaten hinterlegen musst:

Verbindung mit Benutzername und Passwort

1: Name: Vergib einen internen Namen für deine Shopanbindung.

2: URL: Gib hier die URL deines Shopware-Shops ein. Die URL sollte eine HTTPs URL unter Shopware > Domains sein.

3: Benutzername und Passwort: Hinterlege hier den Benutzernamen und das Passwort, was du zuvor in deinem Shopware-Adminbereich für Billbee vergeben hast. (siehe hier)

4: PayPal Client ID und Secret: Du hast die Möglichkeit, dass Rechnungsinformationen von PayPal Plus für Bestellungen von diesem Shopware-Shop eingelesen werden können. Gib hierfür die gleiche PayPal Client ID und der dazugehörige Client Secret in diese Felder ein, die du auch in deinem Shopware-Shop hinterlegt hast.

Verbindung mit Shopware Integration (Shopware 6 Cloud)

1: Name: Vergib einen internen Namen für deine Shopanbindung.

2: URL: Gib hier die URL deines Shopware-Shops ein. Die URL sollte eine HTTPs URL unter Shopware > Domains sein.

3: Zugangs-ID / Sicherheitsschlüssel: Hinterlege hier die Zugangs-ID und den Sicherheitsschlüssel der Integration, welche du zuvor in deinem Shopware 6 Account angelegt hast. (siehe hier)

4: PayPal Client ID und Secret: Du hast die Möglichkeit, dass Rechnungsinformationen von PayPal Plus für Bestellungen von diesem Shopware-Shop eingelesen werden können. Gib hierfür die gleiche PayPal Client ID und der dazugehörige Client Secret in diese Felder ein, die du auch in deinem Shopware-Shop hinterlegt hast.

Allgemein

Hast du deine Zugangsdaten erfolgreich hinterlegt, öffnen sich die Einstellungen deiner Shopware 6 Anbindung. Gehe in den Reiter 'Allgemein', um weitere Einstellungen vorzunehmen:

1: Mindestalter der Bestellung in Minuten: Mit dieser Option legst du fest, wie alt eine Bestellung beim Shopabruf mindestens sein muss, damit sie importiert wird. Da Shopware 6 keine Webhooks unterstützt ist diese Option für dich nicht relevant, da Bestellungen immer importiert werden, sobald ein Shopabruf gestartet wird.

2: Bearbeiten von Auftragspositionen oder Erzeugen von Rechnungen mit Billbee verbieten: Du kannst die Bestellpositionen, die mit einer Bestellung aus Shopware 6 übermittelt werden, quasi "sperren". Das bedeutet, dass die Auftragspositionen einer Bestellung in Billbee, die von Shopware 6 ü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 Shopware 6-Shop eingelesen wurden. Dann werden für alle Bestellungen, die von Shopware 6 ü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: Zahlungen 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.

5: Versand aus: Lege hier optional das Land fest, aus dem der Versand erfolgt.

6: Anonymisierung von Kundendaten: Mit dieser Option hast du die Möglichkeiten Kundendaten aus deinen Bestellungen zu anonymisieren. Du kannst als Zeitspanne zwischen 1 - 730 Tagen wählen und weiterhin, ob die Bestellungen bei der Anonymisierung einen von dir hinterlegten Status erhalten sollen. Weitere Informationen zur Anonymisierung findest du Hier

7: Aufträge einlesen: Klicke auf den Playbutton, um das Einlesen von Bestellungen zu aktivieren. Diese Option ist beim Anlegen der Verbindung standardmäßig deaktiviert und muss zwingend aktiviert sein, damit Bestellungen von Shopware 6 zu Billbee übertragen werden können.

8: Synchronisierungsintervall: Hier kannst du sehen, wie oft die Bestellungen in den gesetzten Intervallen bereits abgerufen wurden. Um die Intervalle zu ändern, klicke bitte auf das Symbol. Anschließend öffnet sich ein Pop Up Fenster, in dem du die aktuellen Einstellungen ändern kannst.

9: Aufträge ab diesem Datum importieren: Hier kannst du wählen, ab welchem Datum deine Bestellungen eingelesen werden sollen. Diese Einstellung ist nur sichtbar, wenn du den Abruf der Bestellungen aktiviert hast.

10: Statusänderungen an Bestellungen synchronisieren: Durch das Setzen des Häckchens kannst du auswählen, ob Statusänderungen an Bestellungen zwischen Shopware 6 und Billbee synchronisiert werden sollen. Über den Button darunter wählst du aus, in welche Richtung die Änderungen abgefragt werden sollen. Du kannst zwischen Shopware 6 zu Billbee, Billbee zu Shopware 6 oder beidseitig wählen. Standardmäßig ist beidseitig ausgewählt (Shopware 6 ↔ Billbee).

Alle weiteren Einstellungen in der Anbindung kannst du hier nachlesen.

Wichtig / zu beachten

Steuersätze bei Shopware

Es wird geprüft, ob die Steuersätze mit den Steuersätzen bei Billbee übereinstimmen. Falls nicht, wird von der Shopware-Schnittstelle nichts als Steuersatz übergeben und Billbee übernimmt die Steuern aus den Artikeldaten.

Einstellungen für den automatischen Bestandsabgleich

Damit der Bestandsabgleich funktioniert, müssen die Rechte in deinem Shopware-Account folgendermaßen eingestellt sein (alle rot umrandeten Kästchen müssen aktiviert sein):

Keine Differenzierung nach Subshops

Die Shopware 6 Anbindung unterstützt keine Differenzierung nach Subshops. Vor allem, wenn du einen Shopware 5 Shop mit mehreren Subshops hast und überlegst, auf Shopware 6 umzustellen, solltest du diesen Punkt unbedingt mit bedenken. In diesem Fall raten wir von einer Umstellung ab.

Mögliche Fehlercodes & ihre Bedeutung

Fehlercode/-meldung	Mögliche Bedeutung	Lösung
invalid_client - Client Authentication failed	Tritt beim Abruf der PayPal Informationen zu einer Bestellung bei Shopabruf auf. Hier sind falsche Zugangsdaten hinterlegt.	Überprüfe deine hinterlegten Zugangsdaten. Damit Billbee die Zahlungshinweise aus dem Shop abrufen kann, müssen in den Einstellungen der Shopverbindung die gleichen Zugangsdaten für PayPal hinterlegt sein, die auch im PayPal Modul im Shop verwendet werden.
Could not convert string to DateTime: -0001-11-30T00:00:00.000+00:00	Der Shop liefert einen ungültigen Datumswert für das createdAT- Datum eines Artikels (das Jahr ist auf -0001 gesetzt). Es kommt zum Abbruch der Synchronisation. Der Fehler kann z. B. bei Verwendung des Migrationsassistenten auftreten.	Das ungültige Datum muss im Shop korrigiert werden.
The resource owner or authorization server denied the request.: Access token could not be verified	Der Zugriffstoken wird von Zeit zu Zeit erneuert. Klappt dies nicht automatisch im Hintergrund wird die Fehlermeldung ausgegeben.	Öffne die Einstellungen der Shopanbindung in Billbee. Klicke nun auf den Button "Verbindung testen" und anschließend auf "Speichern". Wenn du jetzt in der Bestellübersicht den Abruf manuell startest sollte dieser wieder fehlerfrei durchlaufen.

(*) Wie du vielleicht schon gesehen hast, gendern wir auf unserer Webseite, unserer Hilfeseite und in unserer Außenkommunikation, da Billbee für mehr Vielfalt im E-Commerce stehen soll – und das auf allen Ebenen. Die Namen für Bereiche/Buttons/Einstellungen kommen direkt aus der Softwarelösung, wo aktuell nicht gegendert wird. Um hier keine Verwirrung aufkommen zu lassen, haben wir uns dazu entschieden, dass wir die direkten Namen aus der Software auf der Hilfeseite in diesem Fall übernehmen.