Shopify zu PrestaShop Migration — Komplette Anleitung

Überblick

dfmigrateshopify importiert einen kompletten Shopify-Shop in PrestaShop 8 oder 9: Produkte mit Varianten und Bildern, Kunden mit Adressen, historische Bestellungen, Collections als Kategorien, 301-Weiterleitungen und Kundenbewertungen. Das Modul ist auf Shopify-Seite nur lesend: null Schreibvorgänge, null Änderungen am Quell-Shop.

Installation

1. PrestaShop-Backoffice → Module → Modul-Manager → Modul hochladen.
2. Wählen Sie die Datei dfmigrateshopify.zip und installieren Sie.
3. Ein neuer Bildschirm erscheint unter Erweiterte Einstellungen → Shopify-Migration.

Die Installation erstellt 4 Tabellen mit dem Präfix dfmigshop_: mapping (Zuordnungen Shopify ↔ PrestaShop), log, redirect und job.

Shopify-Token erstellen

Im Admin Ihres Shopify-Quell-Shops:

1. Settings → Apps and sales channels → Develop apps → Create an app.
2. Tab Configuration → Admin API integration → Configure.
3. Aktivieren Sie die Scopes: read_products, read_inventory, read_product_listings, read_customers, read_orders, read_content.
4. Installieren Sie die App im Shop und kopieren Sie den Admin API access token (beginnt mit shpat_).

Verbindung

Im Tab Verbindung des Moduls: geben Sie die Domain ein (mein-shop.myshopify.com, ohne https://), den Token und die API-Version (Standard 2024-10). Klicken Sie auf Verbindung testen: der Shop-Name muss grün angezeigt werden.

Konfiguration

• Stapelgröße — Anzahl der pro AJAX-Aufruf verarbeiteten Elemente (Standard 50, max. 250). Reduzieren Sie den Wert bei langsamem Hosting.
• Bilder herunterladen — deaktivieren für eine schnelle Testmigration ohne Bilder.
• Entwürfe — Shopify-Produkte im Status draft importieren oder überspringen.
• Standard-Stammkategorie — Shopify-Collections werden unter dieser Kategorie erstellt.
• Versanddienstleister und Zahlungsmodul — werden den importierten Bestellungen zugewiesen.
• Status-Mapping — ordnen Sie jeden Shopify-Status (pending, paid, fulfilled, delivered, cancelled, refunded) einem PrestaShop-Bestellstatus zu.

Migration starten

Im Tab Migration, beachten Sie die Reihenfolge:

1. Zählen — prüft die Verbindung und zeigt die Volumina an.
2. Custom-Collections dann Smart-Collections — erstellt die Kategorien.
3. Produkte + Varianten + Bilder — der längste Schritt. Shopify-Varianten werden zu Attributkombinationen; jede Variante erhält ihr Bild; Hersteller werden aus dem Vendor-Feld erstellt.
4. Kunden — automatische Deduplizierung per E-Mail. Ein Zufallspasswort wird vergeben: laden Sie Ihre Kunden ein, „Passwort vergessen“ zu verwenden.
5. Bestellungen — erst nach Produkten und Kunden. Referenzformat SH-{Nummer}.
6. 301-Weiterleitungen — holt die Shopify URL Redirects. Produkt-/Collection-Weiterleitungen wurden bereits automatisch in den vorherigen Schritten erstellt.

Bewertungen importieren

Shopify hat keine native API für Bewertungen. Exportieren Sie als CSV aus Ihrer App (Judge.me, Loox, Yotpo, Product Reviews app…) und importieren Sie die Datei im Tab Bewertungen. Das Modul erkennt automatisch Ihr Backend: dfreviews (Priorität) oder productcomments.

Erwartete Spalten (Groß-/Kleinschreibung egal, Trennzeichen , oder ;): product_handle oder shopify_product_id oder sku, email, reviewer_name, rating, title, body, created_at, verified.

301-Weiterleitungen

Jede Frontend-Anfrage wird vom Hook actionDispatcherBefore abgefangen: entspricht die angeforderte URL einer gespeicherten Quelle (z. B. /products/mein-produkt), wird der Besucher per 301 auf die entsprechende PrestaShop-URL weitergeleitet. Keine Apache- oder Nginx-Konfiguration nötig. Der Tab 301-Weiterleitungen erlaubt den Export der kompletten Liste als CSV.

Zuordnungen und Neustart

Der Tab Zuordnungen zeigt die Anzahl der importierten Elemente pro Ressourcentyp. Der Button Leeren entfernt die Zuordnungen eines Typs: die Elemente bleiben in PrestaShop, aber eine neue Migration importiert sie als neu (mögliche Duplikate — bewusst einsetzen).

Fehlerbehebung

• Fehler 429 oder 503 — das Modul behandelt das Shopify-Rate-Limit automatisch (Retry unter Beachtung des Retry-After-Headers). Keine Aktion erforderlich.
• Langsame Migration — reduzieren Sie die Stapelgröße oder deaktivieren Sie den Bild-Download für einen ersten Testdurchlauf.
• Fehler im Protokoll — der Tab Protokolle zeigt jeden Fehler mit der betroffenen Ressource und der Shopify-ID. Beheben Sie die Ursache und starten Sie den Schritt neu: nur fehlgeschlagene Elemente werden erneut verarbeitet.
• Preise historischer Bestellungen — Bestellungen werden als Buchhaltungsarchiv importiert; Shopify-Summen bleiben unverändert, ohne PrestaShop-Steuerneuberechnung.

Deinstallation

Die Deinstallation entfernt die 4 Tabellen des Moduls und die Hooks. Importierte Produkte, Kunden, Bestellungen und Kategorien bleiben erhalten. Die 301-Weiterleitungen funktionieren nicht mehr (sie werden vom Modul bereitgestellt).