So migrierst du vom Shopware-6-Plugin zur Shopware-6-App

Wir haben eine eigene Shopware-6‑App entwickelt, die das von Response GmbH entwickelte Shopware‑6‑Plugin ersetzen wird. Dieses Plugin wird nicht mehr aktiv gepflegt oder aktualisiert. Bitte installiere stattdessen die App und migriere deine bestehenden Projekte.

Hinweis: Dieser Artikel behandelt die Migration deiner Produkte vom Shopware‑6‑Plugin zur Shopware‑6‑App. Wenn du versuchst, eine neue Shopware‑App‑Verbindung einzurichten, sieh dir bitte den Artikel auf dieser Seite. Wenn du Shopware 5 verwendest, folge stattdessen den Schritten aus dem Artikel auf dieser Seite .

Tipp: Kontaktiere unser Support‑Team um eine Kopie deines/ deiner Projekte erstellen zu lassen und die folgenden Schritte in einem kopierten Projekt durchzuführen. So kannst du das Originalprojekt mit der Kopie vergleichen und sicherstellen, dass alle Felder korrekt gemappt sind.

Installiere die App

Siehe diese Anleitung für Anweisungen zum Herunterladen und Installieren der Channable‑App für Shopware 6.

Migriere deine bestehenden Projekte

Wenn du deine Produkte mit der App statt mit dem Plugin importierst, kannst du bei einigen Feldern kleine Unterschiede erwarten (siehe „Welche Unterschiede kannst du erwarten“ weiter unten). Diese Unterschiede müssen deine Projekte nicht beeinflussen; in diesem Fall kannst du deine Verbindungen über die Schritte unter „Importverbindung ändern“ und „Bestellverbindung ändern“ wechseln. Falls die Unterschiede potenziell Auswirkungen haben, empfehlen wir zusätzliche Schritte, die am Ende des Artikels beschrieben sind, damit keine Probleme entstehen.

Hinweis: Beim Plugin hatte jede Kombination aus Verkaufskanal und Sprache eine eigene Verbindung. Bei der App erstellst du hingegen nur eine Verbindung pro Verkaufskanal, sodass du dieselbe Verbindung für mehrere Sprachen wiederverwenden kannst.

Importverbindung ändern

1

Ändere die Importverbindung — wähle die neue App‑Verbindung aus

• Gehe zu „Setup > Setup Import“.

• Finde deinen Shopware‑6‑Import und klicke auf „Einstellungen“.

• Klicke auf „Import ändern“.

• Wähle in den Import‑Optionen die neue App‑Verbindung aus.

• Achte darauf, die richtige Sprache aus dem Dropdown auszuwählen (die gleiche wie zuvor für diesen Import) und klicke auf „Speichern“.

• Du wirst nun zur Import‑Zuordnung weitergeleitet. Klicke auf „Speichern & Importieren“.

2

Mapping überprüfen und aktualisieren

Feldnamen können unterschiedlich sein. Bevor du fortfährst, stelle sicher, dass deine neuen Import‑Felder korrekt den bestehenden Projektfeldern zugeordnet sind. Befolge dazu diese Schritte:

• Gehe zu „Setup > Mapping bearbeiten“ deiner neuen Verbindung.

• Vergleiche das neue Mapping mit dem Mapping im Originalprojekt und stelle sicher, dass alle Felder korrekt zugeordnet sind. Felder, die im Import nicht mehr vorhanden sind, können bedenkenlos gelöscht werden.

• Wenn du fertig bist, klicke auf „Speichern & Importieren“.

Bestellverbindung ändern

Wir können die Plattformverbindung in einer Bestellverbindung nicht ändern. Du musst deshalb die alte Bestellverbindung für das Plugin deaktivieren und eine neue für die App erstellen.

1

Deaktiviere die alte(n) Bestellverbindung(en)

• Gehe zu „Setup > Setup orders“.

• Klicke für jede aktive Bestellverbindung, die das Shopware‑6‑Plugin verwendet, auf „Einstellungen“.

• Klicke auf „Bestellverbindung deaktivieren“ und dann auf „Speichern“.

• Stelle sicher, dass du das für alle aktiven Bestellverbindungen machst!

2

Erstelle neue Bestellverbindung(en) für die App

• Füge neue Bestellverbindungen über die Schaltfläche „Setup orders“ hinzu.

• Wähle bei der Plattformverbindung die neue Shopware‑App‑Verbindung aus. Für alle anderen Einstellungen wähle einfach die Werte, die du in der alten, gerade deaktivierten Bestellverbindung hattest.

• Aktiviere die Bestellverbindung und klicke auf „Speichern“.

Welche Unterschiede kannst du erwarten?

• Wenn ein Feldname ein Sonderzeichen enthält, kann sich der Feldname leicht ändern. Zum Beispiel: Wenn du ein Feld namens properties_grössehast, würde der Plugin‑Importer dies als properties_groesse importieren, aber der neue App‑Importer importiert dieses Feld als. Du kannst das im Importer‑Mapping beheben. Zum Beispiel:

1

Beispiel: Mapping von Feldnamen mit Sonderzeichen

• Das Feld properties_groesse wurde über das Plugin importiert und dem Projektfeld properties_groesse

• zugewiesen. aber der neue App‑Importer importiert dieses Feld alsDie App importiert dieses Feld jetzt als properties_groesse. Indem du es auf

• mapst, stellst du sicher, dass keine Feldnamen geändert werden. properties_groesse Das alte

• Feld aus dem Plugin kann dann bedenkenlos gelöscht werden.

• Das Plugin hat einige Preise nicht gerundet. Der neue App‑Importer rundet alle Preise auf zwei Dezimalstellen. Wenn du ein benutzerdefiniertes Feld mit einem True/False Wert hast, importieren wir diese als 1 (fürTrue ) und 0 (fürFalse Wenn du ein benutzerdefiniertes Feld mit einem ). Falls erforderlich, kannst du diese mit einer (Master‑)Regel wieder in

• transformieren. link und Das Plugin erlaubte es, eine benutzerdefinierte Verkaufs‑Kanal‑Domain in den Plugin‑Einstellungen festzulegen. Diese Domain wurde zum Aufbau der shopware_url

• Felder für jedes Produkt verwendet. Die App hat diese Option nicht; sie verwendet die Verkaufs‑Kanal‑Domain aus den Verkaufskanal‑Einstellungen: Wenn price_net Wenn in deinem Backend 0 ist, wird es auch in Channable 0 sein. Das Plugin hätte es selbst berechnet, die App macht das nicht mehr. Du kannst das beheben, indem du sicherstellst, dass Wenn immer einen Wert in deinem Backend hat, oder indem du den Wenn mit einer Regel berechnest, wobei du den price_gross und den tax_rate.

• verwendest. Wenn du benutzerdefinierte Felder vom TypMedia field hast, rufen wir nicht mehr automatisch die URL des Mediums ab. Das würde zusätzliche Last auf deinem Server verursachen, da wir pro Produkt eine zusätzliche Anfrage machen müssten. Deshalb möchten wir das nur bei Bedarf tun. Wenn du feststellst, dass einige benutzerdefinierte Felder in Channable eine ID statt einer erwarteten URL enthalten, kannst du uns kontaktieren

um die Funktion zu aktivieren, die die URLs stattdessen abruft. Hinweis: Das funktioniert nur für Medientyp‑Felder!