Shopify-Produktsynchronisierung
So werden Produkte, Bestellungen und Kollektionen zwischen Shopify und Umbrella synchronisiert.
Shopify-Produktsynchronisierung
Umbrella nutzt Shopify-Webhooks, um Ihre Produkte, Kollektionen, Bestellungen, Kunden und Versanddaten automatisch in Echtzeit zu synchronisieren. Wenn sich in Ihrem Shopify-Shop etwas ändert, aktualisiert Umbrella Garantieberechtigung, Preise und Policendaten automatisch.
Was synchronisiert wird
Produkte
Umbrella synchronisiert Produkttitel, Handle, Typ, Anbieter, Tags, Varianten (ID, Titel, Preis, SKU), Bilder und Kollektionszugehörigkeit. Diese Daten steuern die Zuordnungsregeln der Garantiepläne (z. B. „auf alle Produkte mit dem Tag ‚electronics‘ anwenden“).
Bestellungen
Umbrella verarbeitet Bestellnummer, Positionen, Kundeninformationen, Zahlungsstatus, Versandstatus sowie Erstattungs- und Stornierungsdaten. Darauf basieren die Erstellung und Aktivierung von Garantiepolicen und die Berechnung der Anspruchszeiträume.
Weitere Daten
- Kollektionen — Für kollektionsbasierte Berechtigungsregeln von Garantien
- Kunden — Mit Garantiepolicen verknüpft, für kontobasierte Abfragen
- Versandvorgänge — Werden erfasst, um den Beginn der Anspruchszeiträume zu bestimmen (falls der Start beim Versand konfiguriert ist)
Manuelle Neuverarbeitung
Wenn Daten nicht synchron wirken, starten Sie eine manuelle Neuverarbeitung unter Dashboard → Einstellungen → Integrationen → Shopify:
- Produkte neu verarbeiten — Ruft alle Produkte erneut ab und aktualisiert den lokalen Cache
- Bestellungen neu verarbeiten — Ruft aktuelle Bestellungen erneut ab und gleicht die Garantiepolicen ab
- Kollektionen neu verarbeiten — Ruft Kollektionen erneut ab und aktualisiert die Berechtigungsregeln
Bei großen Katalogen kann das einige Minuten dauern.
Zuverlässigkeit der Webhooks
- Shopify liefert Webhooks mindestens einmal aus (Duplikate werden sicher behandelt)
- Ist der Webhook-Endpunkt vorübergehend nicht erreichbar, wiederholt Shopify die Zustellung mit exponentiellem Backoff bis zu 48 Stunden lang
- Nutzen Sie die manuelle Neuverarbeitung, um verpasste Daten wiederherzustellen
Fehlerbehebung
| Problem | Lösung |
|---|---|
| Neue Produkte erscheinen nicht in den Garantieregeln | 1–2 Minuten auf die Webhook-Verarbeitung warten, dann den Synchronisierungsstatus der Produkte prüfen |
| Bestellung erzeugt keine Garantiepolice | Prüfen, ob die Bestellung eine Garantieposition enthält und bezahlt wurde |
| Anspruchszeitraum beginnt nicht | Sicherstellen, dass die Bestellung versendet wurde |
| Produkte nach einem Massenimport nicht synchron | Mit der manuellen Neuverarbeitung alle Produktdaten aktualisieren |
Verwandte Themen
- Shopify-Integration — Grundeinrichtung der Shopify-Verbindung
- Shopify-Checkout-Erweiterungen — Garantieanzeige im Checkout
- Garantiepläne erstellen — Regeln zur Produktberechtigung
