Installationsanleitung
PHP-Konfiguration prüfen
Stelle sicher, dass in Deiner PHP-Konfiguration die Einstellung gesetzt ist: allow_url_fopen = on Hinweis: Sofern nicht anders angegeben, sind alle Felder Pflichtfelder.
Voraussetzungen
- Mindestens 1 GB Memory Limit
- PHP 8.0 oder höher
- Mindestens Shopware 6.4.9.0
Schritt 1 – Plugin aktivieren
- Installiere und aktiviere das Plugin im Shopware Admin.
Schritt 2 – Grundeinrichtung plentyONE Connector
Wechsle im Shopware-Adminbereich zu: Kataloge → Plenty Connector Damit die Synchronisation der Daten zwischen plentyONE und Shopware funktioniert, muss die Verbindung eingerichtet werden. Hierzu müssen im Unterpunkt Setup – plentymarkets Standard die folgenden Daten hinterlegt werden:
Plenty ID
Trage hier Deine plentyONE ID ein.
Beispiel: 59405
Plenty URL
Gib hier die Plenty URL Deiner plentyONE-WaWi an.
Beispiel: https://7zigb10abe6v.c01-16.plentymarkets.com
Die URL findest du indem Du oben rechts über die Plenty-ID mit der Maus fährst. Die Rest-API wird dir in dem kleinen Fenster angezeigt. Beachte, dass die Rest-API ohne "/rest/" in Shopware hinterlegt werden muss.
Plenty Benutzername
Trage hier Deinen plentyONE Benutzernamen ein.
Wichtig: Es muss ein Benutzer mit Adminrechten hinterlegt werden.
Plenty Passwort
Hinterlege hier Dein plentyONE 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 plentyONE verwendet. Mehrere Sprachen müssen durch Komma getrennt und ohne Leerzeichen eingegeben werden.
Beispiel: de,en
Standort ID
Hinterlege hier die Standort ID.
Der Connector nutzt die Standort ID, um Steuerangaben zu holen und diese zu hinterlegen. Besonders wichtig, wenn in plentyONE mehrere Standorte hinterlegt sind.
In plentyONE findest Du die ID unter: Einrichtung >> Mandant >> Kanal >> Standorte
Market ID
Setze hier die Market ID von Shopware 6 ein. In plentyONE findest Du die ID unter: Einrichtung >> Aufträge >> Auftragsherkunft
Achtung
Die Auftragsherkunft 1.00 ist speziell für den plentyONE Shop und sollte nicht verwendet werden, da sonst nicht eingeschränkt werden kann, welche Bilder in Shopware angezeigt werden sollen.
Vk-Preis-ID
Hier muss die ID des Verkaufspreises angegeben werden, damit der Connector die korrekten Preise zu Shopware überträgt.
In plentyONE 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 überträgt.
In plentyONE 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 plentyONE 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 plentyONE werden dieser Kategorie untergeordnet und bilden somit Dein Menü im Onlineshop.
Standard-Kategorie-CMS-Seite
Hinterlege hier das gewünschte Layout für Deine Kategorie-Seiten. Bei der ersten Synchronisation, wenn die Kategorien angelegt werden, wird dieses Layout automatisch verwendet. Änderst Du das Layout später, musst Du dies manuell anpassen.
Bestellungen synchronisieren ab (Pflichtfeld)
Falls Bestellungen im Shop vorhanden sind, die nicht zu plentyONE übermittelt werden sollen (z. B. durch einen anderen Connector), kannst Du hier einstellen, ab wann Bestellungen übertragen werden. Wenn hier nichts eingetragen ist, werden keine Bestellungen übertragen.
Synchronisations-Optionen
- Produktdatenabgleich aktiv → Aktivieren, wenn Produktdaten synchronisiert werden sollen.
- Lagerbestandabgleich aktiv → Aktivieren, wenn Lagerbestände synchronisiert werden sollen.
- Bestellabgleich aktiv → Aktivieren, wenn Bestellungen synchronisiert werden sollen.
Klicke abschließend auf „Konfiguration speichern“
Schritt 3 – Optional: Konfiguration der Bestellungen
Unter Kataloge → Plenty Connector im Bereich Konfiguration – Bestellungen kannst Du von plentyONE abweichende Bestellstatus, Zahlungsstatus und Versandstatus hinterlegen.
Verwendest Du die Standard-Status von plentyONE, musst Du hier keine Konfiguration vornehmen.
Schritt 4 – Produktdaten-Mapping
Gehe unter Erweiterungen → Meine Erweiterungen zur Erweiterung plentyONE Connector und wähle Konfigurieren.
Lege nun fest, welches Feld für den Produktnamen von plentyONE zu Shopware übertragen werden soll.
Zur Auswahl stehen:
Item-Text → Name 1Item-Text → Name 2Item-Text → Name 3Variation – Variantenname
Hier muss das korrekte Feld gewählt werden, damit die Artikel erfolgreich übertragen werden.
In der Konfiguration kannst Du außerdem einschränken, welche Produkteigenschaften übertragen werden sollen.
- Standard: Alle Eigenschaften werden übertragen.
- Eigenschaften vom Typ „Auswahl“ und „Mehrfachauswahl“ → werden in Shopware als Produkteigenschaften hinterlegt.
- Alle anderen Eigenschaften → werden als Zusatzfelder übertragen.
Schritt 5 – Shopware-Zahlungsarten zu plentyONE-Zahlungsarten zuordnen
- Wechsle im Shopware-Admin zu Einstellungen → Shop → Zahlungsarten und wähle die aktiven Zahlungsarten.
- Für jede aktive Zahlungsart kannst Du im Zusatzfeld „Plenty Connector – Zahlungsart“ die Plenty ID der Zahlungsart hinterlegen.
→ Dadurch wird die Zahlungsart aus der ausgelösten Shopware-Bestellung automatisch zu plentyONE übertragen. - Die Option „Zahlung in plentyONE anlegen, wenn Zahlstatus = Bezahlt“ kannst Du aktivieren, wenn die Bezahlung von Shopware übertragen werden soll und kein Zahlungsabgleich über plentyONE erfolgen soll.
Die Zahlungsarten-ID findest Du in plentyONE unter:
Einrichtung → Aufträge → Zahlung → Zahlungsarten
Schritt 6 – Shopware-Versandarten zu plentyONE-Versandarten zuordnen
- Wechsle im Shopware-Adminbereich zu Einstellungen → Shop → Versand und wähle die aktiven Versandarten.
- Für jede aktive Versandart kannst Du im Zusatzfeld „Plenty Connector – Versandart“ die Plenty ID der Versandart hinterlegen.
→ Dadurch wird die Versandart aus der ausgelösten Shopware-Bestellung automatisch zu plentyONE übertragen.
Die Versandarten-ID findest Du in plentyONE unter: Einrichtung → Aufträge → Versand → Optionen → Versandprofile
Wichtiger Hinweis zu Versandkosten:
Alle Versandkosten müssen vom Steuertyp auf „Höchster Satz“ gestellt werden.
Das ist eine Vorgabe von PlentyONE.
[...]
Das Thema wurde im Forum in der Vergangenheit auch bereits behandelt.
Für das korrekte Verfahren bezüglich der Besteuerung von Versandkosten gibt es mehrere Möglichkeiten, die ALLE korrekt sind.
Bei plenty wurde damals entschieden, dass immer der höchste Steuersatz genommen wird (was ein valides Vorgehen ist).
Das Thema gibt es wie gesagt schon seit mind. 10–15 Jahren und war damals eine Entscheidung, welche nicht geändert wird.
[...]
(Offizieller PlentyONE Support, 22.08.2025)
Schritt 7 – Sichtbarkeit im Verkaufskanal zuordnen
Du hast die Möglichkeit, in Shopware im Verkaufskanal die plentyONE Auftragsherkunft/Markt/Verkaufskanal-ID zu hinterlegen.
Dadurch werden Artikel, denen in plentyONE diese ID zugeordnet ist, auch nur in diesem Verkaufskanal sichtbar.
Du musst immer beide Felder ausfüllen:
- Mandant-ID
- Auftragsherkunft/Markt/Verkaufskanal-ID
Wichtig! Update 6.0.11
Mit diesem Update ist es Pflicht, dass Du die Mandant-ID und die Auftragsherkunft/Markt/Verkaufskanal-ID in jedem Verkaufskanal konfigurierst. Die Felder in der Pluginkonfiguration sind nur noch aus Kompatibilitätsgründen enthalten. Achte darauf, dass Du dies in allen Verkaufskanälen machst.
Schritt 8 – Optional: Währungen zuordnen
Sofern Du mehrere Währungen von plentyONE zu Shopware übertragen möchtest, musst Du unter Einstellungen → Währungen in den Zusatzfeldern die folgenden Angaben hinterlegen:
- plentyONE Preis-ID
- plentyONE Streich-Preis-ID
Schritt 9 – Cronjobs einrichten
Die Synchronisation wird im Hintergrund auf dem Server durchgeführt. Je nach Anzahl der Artikel kann dies mehrere Stunden dauern. Eine direkte Synchronisation im Shopware-Backend ist nicht möglich. Daher müssen immer Cronjobs eingerichtet werden. Bei allen von Shopware zertifizierten Hostern kann ein Cronjob angelegt werden.
Cronjob-Befehle für plentymarkets Connector (Shopware 6)
Artikelabgleich resetten
Empfohlen: 1x pro Tag – 1x pro Stunde (abhängig von der Artikelmenge)
Artikelabgleich ausführen
Empfohlen: jede Minute
Lagerbestandsabgleich
Empfohlen: jede Minute
Bestellabgleich
Empfohlen: alle 5 Minuten
Bestellstatus-Abgleich
Empfohlen: alle 5 Minuten
Bestellstatus storniert - Abgleich
Empfohlen: alle 5 Minuten
Wenn Du einen bestehenden Shopware 6 Shops mit unserem Connector an plentymarkets anbinden möchtest, haben wir Dir die wichtigsten Informationen zusammengestellt.
plentymarkets Connector: Anbindung eines bestehenden Shopware 6 Shops