# 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… - Seite: - Sprache: de - Aktualisiert am: 2026-07-01 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/migration-shopify-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/migration-shopify-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/migration-shopify-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/migration-shopify-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/migration-shopify-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/migration-shopify-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/migration-shopify-prestashop/index.md) - Index: ## Ü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_`). Shopify zeigt den Token nur einmal an. Bewahren Sie ihn sicher auf. ## 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. Jeder Schritt kann gefahrlos neu gestartet werden: die Mapping-Tabelle verhindert Duplikate. Bei Unterbrechung einfach erneut auf den Button klicken — die Migration fährt dort fort, wo sie gestoppt wurde. ## 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).