Appearance
Shopify konfigurieren
Shop-Adapter
Diese Seite beschreibt nur Shopify-spezifische API- und Shop-Einstellungen. Generischer Ablauf: Verbindungen · Adapter-Übersicht.
Die Shopify-Konfiguration verbindet ReadySync mit Ihrem Shopify-Shop über die Admin GraphQL API. Produkte, Varianten, Bestand, Bilder, Kollektionen und Bestellungen laufen über dasselbe Token.
Voraussetzungen
- Shopify-Shop (Admin-Zugriff)
- Eine Custom App im Shopify-Admin mit Admin-API-Zugriffstoken
- Die unten genannten API-Berechtigungen (Scopes)
Custom App und Zugriffstoken anlegen
- Öffnen Sie im Shopify-Admin Einstellungen → Apps und Vertriebskanäle → Apps entwickeln.
- Legen Sie eine App an, z. B. „ReadySync“.
- Unter API-Berechtigungen konfigurieren mindestens diese Scopes setzen:
| Scope | Wofür |
|---|---|
read_products, write_products | Produkte, Varianten, Kollektionen |
read_inventory, write_inventory | Bestand am Lagerort |
read_locations | Lagerorte auflisten |
read_orders, write_orders | Bestellungen lesen, Tags setzen, stornieren |
read_merchant_managed_fulfillment_orders, write_merchant_managed_fulfillment_orders | Fulfillment inkl. Tracking |
read_files, write_files | Bild-Upload |
- App installieren und unter API-Zugangsdaten das Admin-API-Zugriffstoken einmalig kopieren (
shpat_…).
Token nur einmal sichtbar
Shopify zeigt das Token nur einmal. Speichern Sie es direkt in ReadySync. Bei Verlust: Token rotieren und in der Verbindung ersetzen.
Konfiguration in ReadySync
Öffnen Sie die Verbindung und wechseln Sie zum Tab Shop.
| Feld | Beschreibung |
|---|---|
| Shop-Domain | z. B. mein-shop.myshopify.com. Eine volle URL wird auf die Domain gekürzt. |
| Admin-API-Zugriffstoken | Das Token der Custom App. |
| API-Version | Quartalsversion, Standard 2026-04. Nur ändern, wenn Shopify das verlangt. |
| Lagerort-ID | GID oder Zahl des Lagers für Bestände. Leer = erster aktiver Ort mit Online-Bestellungen. |
| Bestandspolitik | Nicht ohne Bestand verkaufen (DENY) oder weiter verkaufen (CONTINUE). |
Bildimport
Bilder laufen über denselben Admin-Token (Staged Upload + Produktdateien). Ein zweites Passwort wie bei WooCommerce ist nicht nötig. Ohne Bildspalte im Mapping bleibt der Produktdaten-Import davon unberührt.
Bestellexport
Shopify hat keine WooCommerce-artigen Statuswerte. ReadySync filtert und markiert so:
| Feld | Beschreibung |
|---|---|
| Zahlungsstatus | Standard paid. |
| Fulfillment-Status | Standard unfulfilled, damit bereits versendete Aufträge nicht erneut exportiert werden. |
| Tag nach Export | Standard readysync-exported. Verhindert Doppel-Export. |
Versandkosten kommen aus den Shopify-Shipping-Lines und landen als kanonische shipping_costs – das ERP (z. B. HQS VERSAND) bleibt shop-agnostisch.
Status-Updates aus dem ERP
Die Statusdatei muss einen Shopify-verständlichen Wert liefern:
| Wert in der Datei | Wirkung |
|---|---|
fulfilled, shipped, completed | Fulfillment anlegen |
| Trackingnummer gesetzt | Fulfillment inkl. Sendungsnummer |
cancelled, canceled | Bestellung stornieren |
Andere Werte werden übersprungen und im Job-Protokoll vermerkt.
Mapping
Der Mapping-Katalog zeigt nur Felder, die dieser Adapter schreibt: SKU (auf der Variante), Name, Beschreibung, Vendor, EAN/Barcode, Verkaufs- und Streichpreis, Bestand, Aktiv, Bilder, Varianten, Kollektionen, Gewicht, SEO-Titel/Beschreibung und Tags.
Bewusst nicht: Staffelpreise, Grundpreis, Shopware-Verkaufskanäle.
Nächste Schritte
- Mapping einrichten – Quellfelder den Shopify-Produktfeldern zuordnen
- Import starten – Delta- oder Vollimport
- Verbindung testen – Shop-Verbindung prüfen