plentymarkets Connector für Shopware 6

Schritt 1 - Plugin aktivieren

Installiere und aktiviere das Plugin im Shopware Admin.

Schritt 2 - Grundeinrichtung plentymarkets Connector

Wechsle im Shopware-Adminbereich zu Kataloge → Plenty Connector.
Damit die Synchronisation der Daten zwischen plentymarkets und Shopware funktioniert, muss die Verbindung eingerichtet werden. Hierzu müssen im Unterpunkt "Setup - plentymarkets Standard" nachfolgende Daten hinterlegt werden.

Plenty ID
Hinterlege hier Deine plentymarkets ID.
Beispiel: 59405

Plenty URL
Gib hier die Plenty URL Deiner plentymarkets-WaWi an.
Beispiel: https://7zigb10abe6v.c01-16.plentymarkets.com

Die URL findest du unter Einrichtung >> Einstellung >> API Daten >> REST-API HTTP Endpunkt

 

Plenty Benutzername
Trage hier Deinen plentymarkets Benutzernamen ein.
Wichtig: Es muss ein Benutzer mit Adminrechten hinterlegt werden.

Plenty Passwort
Hinterlege hier Dein plentymarkets Passwort.

Sprachen
Lege hier die Sprache Deines Standard-Shops fest. Sollte Deine Standard-Sprache nicht „DE“ sein, findest Du über den Link die Codes für die Sprachen, die plentymarkets verwendet.
Mehreren Sprachen müssen getrennt durch ein Komma und ohne Leerzeichen eingeben werden.
Beispiel: de,en

Standort ID
Hinterlege hier die Standort ID. Der Connector nutzt die Standort ID um sich die Informationen für die benötigen Steuerangaben zu holen und diese zu hinterlegen. Dies ist besonders wichtig, wenn in plentymarkets mehrere Standorte hinterlegt sind.
In plentymarkets findest Du die ID unter Einrichtung >> Mandant >> Kanal >> Standorte.

Market ID
Setze hier die Market ID von Shopware 6 ein.
In plentymarkets findest Du die ID unter Einrichtung >> Aufträge >> Auftragsherkunft.

Vk-Preis-ID
Hier muss die ID des Verkaufspreises angegeben werden, damit der Connector die korrekten Preise zu Shopware übertragen kann.
In plentymarkets findest Du die ID unter Einrichtung >> Artikel >> Verkaufspreise.

UVP-Preis-ID
Hier muss die UVP-Preis-ID angegeben werden, damit der Connector die korrekten Preise zu Shopware übertragen kann.
In plentymarkets findest Du die ID unter Einrichtung >> Artikel >> Verkaufspreise.

Lager-IDs für Bestände verwenden (Standard: keine Einschränkung)
Die Hinterlegung der Lager-ID ist nötig, damit der Connector die Lagerbestände aus dem korrekten Lager an Shopware übermittelt.
In plentymarkets findest Du die ID unter Einrichtung >> Waren >> Lager.

Shopware übergeordnete Kategorie
Gib hier an welche Kategorie die übergeordnete Kategorie in Deinem Shopware Onlineshop ist. Die Kategorien aus plentymarkets werden dieser Kategorie untergeordnet und bilden somit Dein Menü im Onlineshop.

Standard-Kategorie-CMS-Seite
Hier kannst Du das gewünschte Layout für Deine Kategorie-Seiten hinterlegen. Bei der ersten Synchronisation, wenn die Kategorien angelegt werden, wird dieses Layout automatisch verwendet.
Solltest Du nach der ersten Synchronisation das Layout der Kategorien ändern wollen musst Du dies händisch vornehmen.

Bestellungen synchronisieren ab (Pflichtfeld)
Wenn im Shop Bestellungen vorhanden sind, die nicht zu plentymarkets übermittelt werden sollen da diese durch einen anderen Connector übertragen wurden, kannst Du hier einstellen ab wann die Bestellungen übertragen werden.
Sofern hier nichts eingetragen ist, werden keine Bestellungen übertragen.

Produktdatenabgleich aktiv
Aktiviere diese Option, wenn dieser Typ des Datenabgleichs gewünscht ist.

Lagerbestandabgleich aktiv
Aktiviere diese Option, wenn dieser Typ des Datenabgleichs gewünscht ist.

Bestellabgleich aktiv
Aktiviere diese Option, wenn dieser Typ des Datenabgleichs gewünscht ist.

Klicke abschließend auf "Konfiguration speichern".

Schritt 3 - Optional: Konfiguration-Bestellungen

Unter Kataloge → Plenty Connector im Bereich Konfiguration - Bestellungen kannst Du von plentymarkets abweichende Bestellstatus, Zahlungstatus und Versandstatus hinterlegen. Verwendest Du die Standard-Status von plentymarkets musst Du hier keine Konfiguration vornehmen.

Schritt 4 - Shopware Zahlungsarten zu plentymarkets Zahlungsarten zuordnen

Wechsle im Shopware-Admin zu Einstellungen → Shop → Zahlungsarten und hier in die aktive Zahlungsarten.
Für jede aktive Zahlungsart kann im Zusatzfeld „Plenty Connector – Zahlungsart“ die Plenty ID der Zahlungsart hinterlegt werden. Dadurch wird die Zahlungsart aus der ausgelösten Shopware-Bestellung automatisch zu plentymarkets übertragen.
Die Option "Zahlung in plentymarkets anlegen, wenn Zahlstatus = "Bezahlt" kannst Du aktivieren, wenn du möchtest, dass die Bezahlung von Shopware übertragen werden soll und der Zahlungsabgleich nicht über plentymarkets erfolgen soll.
In plentymarkets findest Du die ID unter Einrichtung >> Aufträge >> Zahlung >> Zahlungsarten.

Schritt 5 - Shopware Versandarten zu plentymarkets Versandarten zuordnen

Wechsle im Shopware-Adminbereich zu Einstellungen → Shop → Versand und hier in die aktiven Versandarten.
Für jede aktive Versandart kann im Zusatzfeld „Plenty Connector – Versandart“ die Plenty ID der Versandart hinterlegt werden. Dadurch wird die Versandart aus der ausgelösten Shopware-Bestellung automatisch zu plentymarkets übertragen.
In plentymarkets findest Du die ID unter Einrichtung >> Aufträge >> Versand >> Optionen >> Versandprofile.

Schritt 6 - Optional: Sichtbarkeit im Verkaufskanal zuordnen

Du hast die Möglichkeit in Shopware im Verkaufskanal die plentymarkets Auftragsherkunft/Markt/Verkaufskanal-ID zu hinterlegen. Dadurch werden Artikel, denen im plentymarkets diese ID zugeordnet ist, auch nur in diesem Verkaufskanal sichtbar. Hast Du keine Einschränkung bezüglich der Sichtbarkeit Deiner Artikel musst Du die ID nicht hinterlegen.

Damit die Synchronisation zwischen dem Connector und plentymarkets reibungslos funktioniert müssen nachfolgende Cronjobs eingerichtet werden. Bei allen von Shopware zertifizierten Hostern kann ein Cronjob angelegt werden.

Welche Ursachen kann es haben, dass ein Artikel nicht übertragen wird?
Ein Artikel wird übertragen, wenn folgende Voraussetzungen erfüllt sind:

• Artikel ist aktiv
• Passender Mandant zugewiesen
• Passender Markt zugewiesen

Die Bestellungen werden nicht von Shopware zu plentymarkets übertragen. Was kann die Ursache sein?
Damit die Bestellungen von Shopware zu plentymarkets übertragen werden können, muss der folgende Command als Cronjob eingerichtet sein und regelmäßig ausgeführt werden:
bin/console lenz-platform-plenty-connector:order-sync
Für alle angegebenen Cronjobs im Bezug auf den plentymarkets Connector von Shopware 6 gilt, dass die angegebenen Zeiten für die Ausführung der Cronjobs eingehalten werden sollten.

Sind die jeweiligen plenty OrderIds auch in Shopware verfügbar?
Ja, die plenty OrderId wird über ein Zusatzfeld bei der jeweiligen Bestellung angezeigt.

Können die Bestellungen beim Import zu plentymarkets nach Herkunft (Verkaufskanal/Mandat) getrennt werden?
Ja, im Verkaufskanal kann über ein Zusatzfeld die Auftragsherkunft/Markt/Verkaufskanal hinterlegt werden um dies zu steuern.

Wird Multilingualität vom plentymarkets Connector unterstützt?
Ja.

Werden auch Artikel zu Shopware synchronisiert, welche nicht den entsprechenden Mandanten zugeordnet sind?
Nein. Es werden nur Artikel zu Shopware synchronisiert, welche den entsprechenden Mandaten zugordnet sind.

Müssen Kategorien, die in Shopware rein für CMS oder Blog-Seiten verwendet werden, in plenty zwangsweise vorhanden sein?
Diese Kategorien müssen nicht zwangsweise vorhanden sein, es wird aber empfohlen diese anzulegen.

Welche Attributgruppen-Typen (Text, Bild, Select) werden von plentymarkets zu Shopware übertragen?
Aktuell ist es nur möglich den Typ "Select" zu übertragen.

Welches ist das führende System?
plentymarkets ist das führende System.

Wie hoch ist voraussichtlich der Verbrauch der REST API Calls?
Dazu können wir keine genauen Angaben machen, da wir darüber keine Auswertung haben. Sollten die Limits erreicht werden, versucht die API es danach erneut und arbeitet weiter, sobald es wieder geht. Die Häufigkeit des Komplettsyncs kann aber limitiert werden, um API-Calls zu sparen. Zum Beispiel die Festlegung, dass der Komplettsync nur 1x täglich ausgeführt wird.

Wird ein Shopware Plan vorausgesetzt oder ist die Community Edition ausreichend?
Die Shopware Community Edition ist ausreichend.

Wenn sich in Shopware der Bezahlstatus ändert, wird dieser dann an plentymarkets gesendet?
Ja, der Bestellstatus in Shopware wird an plentymarkets übermittelt, auch bei Paypal.

Es erscheint ein "allowed Memory size"-Fehler beim Abruf der Daten. Was kann ich tun?
Fehlermeldung:
Wrong status code returned. Status code: 500, Body: {„error“:{„message“:„Allowed memory size of 1073741824 bytes exhausted (tried to allocate 8192 bytes)“,„code“:0}}
Lösung:
Der Fehler entsteht dadurch, dass die Datenmenge beim Abruf der Artikeldaten zu hoch ist und daher von plentymarkets der Fehler geworfen wird, dass das memory Limit zu niedrig ist. Dies kann passieren, wenn viele Daten bei den Artikeln verknüpft sind. Um das Problem zu lösen, kann die Menge der Artikel, die pro API-Request abgerufen werden heruntergesetzt werden.
Bitte führe dazu folgenden Befehl in der Datenbank aus: