Shopify mit Workspace verbinden
Shopify bleibt Storefront und Checkout. Workspace ergänzt strukturierte Produktdaten, Auftragsbearbeitung, Fulfillment, Dokumente und Reporting. Diese Seite hilft Integratoren, eine Shopify-Anbindung so zu planen, dass jedes Datenobjekt eine klare Richtung, ein führendes System und einen prüfbaren Betriebspfad hat.
Direkt zu:
- Datenflüsse festlegen
- Technische Voraussetzungen prüfen
- Integration umsetzen
- Betrieb und Fehlerfälle absichern
Wenn Shopify vollständig abgelöst werden soll, nutzen Sie stattdessen Von Shopify zu Workspace wechseln.
Ergebnis nach der Planung
Nach der Planung ist festgelegt:
- welche Prozesse in Shopify bleiben,
- welche Prozesse Workspace ergänzt,
- welches System pro Datentyp führend ist,
- welche Ereignisse oder Abgleiche Daten übertragen,
- wie Fehler, Wiederholungen und Monitoring laufen,
- welche Kundendaten wirklich übertragen werden müssen.
Datenflüsse festlegen
Legen Sie für jeden Datentyp Richtung, führendes System und Status fest. Ohne diese Entscheidung entsteht leicht eine scheinbare Synchronisation, bei der beide Systeme dieselben Felder überschreiben.
| Bereich | Typische Richtung | Führendes System | Übertragung | Unterstützungsstatus |
|---|---|---|---|---|
| Produkte und Varianten | Workspace zu Shopify | meist Workspace | Initialimport plus Änderungen | Standardmuster |
| Medien und Inhalte | Workspace zu Shopify | meist Workspace | API oder geplanter Abgleich | Projektabhängig |
| Bestellungen | Shopify zu Workspace | Shopify für Checkout | Webhooks plus Kontrollabgleich | Standardmuster |
| Kunden und Firmen | Shopify zu Workspace | projektabhängig | Event oder Import | Projektabhängig |
| Lagerbestände | projektabhängig | ERP, Workspace oder Shopify | Event oder Intervall | Projektabhängig |
| Fulfillment und Tracking | Workspace zu Shopify | Workspace oder Fulfillment-System | ereignisbasiert | Standardmuster |
| Rückerstattungen | projektabhängig | vorher festlegen | expliziter Prozess | Projektabhängig |
| Metafelder | beide Richtungen möglich | je Feld festlegen | Mapping erforderlich | Projektabhängig |
Nutzen Sie Shop-Systeme anbinden, wenn Sie zuerst entscheiden möchten, ob Shopify, ein anderes Shopsystem oder Workspace den Shopprozess führen soll.
Architektur der Anbindung
Die Integration sollte eine eigene Mapping- und Betriebsschicht haben. Sie nimmt Ereignisse an, normalisiert Daten, protokolliert Entscheidungen und wiederholt fehlgeschlagene Übertragungen kontrolliert.
Für neue Entwicklungen sollte die Shopify GraphQL Admin API im Mittelpunkt stehen. Der aktuell geprüfte Shopify-Stand ist 2026-04; diese Version ist in der Shopify-Dokumentation am 20.06.2026 als latest ausgewiesen.
Technische Voraussetzungen prüfen
| Voraussetzung | Klärung |
|---|---|
| Shopify-App oder Admin-Zugang | Richten Sie einen technischen Zugang ein und vergeben Sie nur die Scopes, die der Datenfluss wirklich benötigt. |
| Workspace-Zugang | Legen Sie Mandant, technische Identität und Zielressourcen fest. Starten Sie mit Integration. |
| API-Version | Konfigurieren Sie die Shopify-Admin-API-Version explizit und planen Sie regelmäßige Aktualisierung ein. |
| Webhooks | Prüfen Sie Signatur, Zustell-ID, Wiederholungen und Deduplizierung, bevor produktive Events verarbeitet werden. |
| Initialimport | Definieren Sie, welche Produkte, Kunden, Bestellungen, Medien und Metafelder als Startbestand übertragen werden. |
| Kontrollabgleich | Planen Sie zusätzlich zu Events einen periodischen Abgleich für kritische Daten. |
| Datenschutz | Minimieren Sie Kundendaten und prüfen Sie Shopify-Regeln zu geschützten Kundendaten, bevor Namen, Adressen, E-Mail-Adressen oder Telefonnummern übertragen werden. |
| Testumgebung | Trennen Sie Test- und Produktionszugänge, Tokens, Webhooks und Zielmandanten strikt. |
Shopify veröffentlicht API-Versionen quartalsweise. Stabile Versionen werden laut Shopify mindestens zwölf Monate unterstützt. Planen Sie deshalb einen regelmäßigen Versionscheck und dokumentieren Sie den geprüften Stand.
Integration umsetzen
- Zielprozess festlegen
Entscheiden Sie, welche Aufgaben Shopify übernimmt und welche Aufgaben in Workspace laufen.
- Datenhoheit bestimmen
Definieren Sie für Produkte, Preise, Lager, Kunden, Bestellungen und Fulfillment jeweils ein führendes System.
- Shopify-Zugang konfigurieren
Richten Sie App-Zugang oder eine geeignete technische App ein. Begrenzen Sie Berechtigungen auf die benötigten Scopes.
- Workspace-Zugang einrichten
Legen Sie technische Identität, Mandant und Zielressourcen fest. Nutzen Sie CLI und API und Integration für Discovery, Authentifizierung und API-Zugriff.
- Feldmapping erstellen
Ordnen Sie Produktkennungen, Varianten, Status, Steuern, Adressen, Metafelder und Fulfillment-Informationen zu.
- Testdaten übertragen
Verwenden Sie zuerst wenige repräsentative Produkte, Kunden und Bestellungen. Prüfen Sie IDs, Pflichtfelder, Steuern, Status und Folgeprozesse.
- Events und Abgleich aktivieren
Verarbeiten Sie Webhooks idempotent und ergänzen Sie für kritische Daten einen periodischen Kontrollabgleich.
- Go-live und Monitoring starten
Aktivieren Sie Fehlerqueue, Wiederholungen, Alarmierung und fachliche Verantwortlichkeiten, bevor produktive Datenflüsse laufen.
Mapping-Beispiel
| Workspace | Shopify | Entscheidung |
|---|---|---|
| Produktkennung | Product ID oder Metafield | Shopify-ID nicht als fachlichen Schlüssel verwenden. |
| Artikelnummer | Variant SKU | Eindeutigkeit vorab prüfen. |
| Produktname | Product title | Sprache und Kanal beachten. |
| Variantenattribute | Options | Reihenfolge und Werte vereinheitlichen. |
| Zusatzattribute | Metafields | Namespace und Datentyp festlegen. |
| Medien | Product media | Reihenfolge und Alt-Texte definieren. |
| Bestellreferenz | Order ID oder Name | Technische und sichtbare Nummer getrennt halten. |
| Versandstatus | Fulfillment | Teilversand berücksichtigen. |
| Trackingnummer | Fulfillment tracking | Carrier-Mapping erforderlich. |
Für größere Startbestände kann ein Initialimport sinnvoll sein. Danach sollten Änderungen über Webhooks, Delta-Abgleiche oder bewusst geplante Exporte laufen.
Betrieb und Fehlerfälle absichern
- Speichern Sie Tokens und Secrets nicht in Logs, Screenshots oder Fehlermeldungen.
- Prüfen Sie Shopify-Webhook-Signaturen vor der Verarbeitung.
- Verarbeiten Sie Webhooks idempotent. Nutzen Sie Zustell-IDs zur Deduplizierung und Event-IDs zur Korrelation zusammengehöriger Zustellungen.
- Machen Sie fehlgeschlagene Datensätze einzeln wiederholbar.
- Protokollieren Sie Mapping-Entscheidungen, nicht nur technische Fehler.
- Konfigurieren Sie die Shopify-API-Version explizit und aktualisieren Sie sie regelmäßig.
- Trennen Sie Test- und Produktionszugänge strikt.
- Übertragen Sie personenbezogene Kundendaten nur, wenn der Zielprozess sie wirklich benötigt.
- Prüfen Sie Rückerstattungen, Teilversand und Stornos als eigene Prozesse.
Häufige Fragen
| Frage | Antwort |
|---|---|
| Warum werden Produkte nicht zugeordnet? | Meist fehlt eine stabile gemeinsame Kennung, zum Beispiel eine eindeutige SKU oder externe Referenz. Prüfen Sie zuerst Produktkennung, Varianten-SKU und Metafelder. |
| Werden Änderungen sofort übertragen? | Das hängt vom Datenfluss ab. Ereignisse können über Webhooks verarbeitet werden; für bestimmte Daten sind Intervall- oder Kontrollabgleiche sinnvoll. |
| Können historische Bestellungen importiert werden? | Ja, wenn Umfang, benötigte Details und Zielmodell vorher festgelegt werden. Für große Datenmengen sollte ein separater Initialimport vorgesehen werden. |
| Unterstützt die Integration mehrere Shopify-Shops? | Behandeln Sie mehrere Shops als eigenen Architekturfall. Shop-Zuordnung, Produktidentitäten, Lagerorte und Preise dürfen nicht implizit zusammengeführt werden. |
| Was geschieht bei einem Fehler? | Der Datensatz sollte mit Ursache protokolliert und gezielt wiederholt werden können, ohne bereits erfolgreich verarbeitete Vorgänge zu duplizieren. |
| Ist das eine fertige Shopify-App? | Nein. Diese Seite beschreibt eine projektbezogene API- oder Middleware-Anbindung. |
Technischer Stand
| Punkt | Stand |
|---|---|
| Integrationsart | API- oder Middleware-Anbindung |
| Native Shopify-App | nein |
| Geprüfte Shopify Admin API | 2026-04 |
| Primäre Shopify-Schnittstelle | GraphQL Admin API |
| Ereignisse | Shopify-Webhooks mit Signaturprüfung und Deduplizierung |
| Workspace-Zielbereiche | PIM, Auftrag, Fulfillment, Dokumente, Reporting |
Weiterführende Quellen:
- Shopify GraphQL Admin API
- Shopify-Webhooks verifizieren
- Shopify API-Versionierung
- Shopify Protected Customer Data
Nächste Schritte
- Ordnen Sie den Commerce-Zielprozess mit Handel- und Commerce-Fähigkeiten ein.
- Lesen Sie Datenaustausch für Integrationen für Formate, Übertragungswege und Mapping.
- Nutzen Sie Integration für die technische Workspace-Anbindung.
- Nutzen Sie Von Shopify zu Workspace wechseln, wenn Shopify abgelöst werden soll.
Hinweis zu Marken
Genannte Marken, Produktnamen und Unternehmensnamen sind Eigentum der jeweiligen Rechteinhaber. Sie werden hier nur zur eindeutigen Identifikation des jeweiligen Quellsystems verwendet. Workspace ist nicht mit Shopify verbunden, wird nicht von Shopify gesponsert, autorisiert oder empfohlen und ist kein offizielles Angebot von Shopify.