Angebotssynchronisation

Die Angebotssynchronisation hält Ihre Mirakl-Preise und Angebotsfelder mit Shopware abgeglichen. Während der Katalogexport das Produkt auf Mirakl anlegt, erzeugt und aktualisiert die Angebotssynchronisation das Angebot — den verkäuferspezifischen Eintrag mit Preis, Lieferzeit, Zustand (Condition) und so weiter.

Seiten

Offer Mappings (Schnellstart → Offers) — alle Verknüpfungen zwischen Shopware-Produkt und Mirakl-Angebot. Spalten: Produkt, Auf Lager, Verfügbar, Mirakl Preis, Mirakl Angebots-ID, Mirakl Produkt SKU, Katalogstatus, Status, Zuletzt synchronisiert, Verbindung. Die Liste lässt sich nach Status, Verbindung, Name, Produktnummer, EAN / GTIN filtern.
Product Catalog (Schnellstart → Catalog) — derselbe Auswahlmechanismus, nur von der Produktseite. Praktisch, wenn Sie gerade neue Produkte angelegt haben und Katalogexport und Angebot in einem Rutsch erledigen möchten.

Angebote hinzufügen

Auf Offer Mappings öffnet die Schaltfläche Angebote hinzufügen in der Symbolleiste ein Menü mit zwei Optionen:

Produkte hinzufügen — öffnet die Seite Add Products to Mirakl. Wählen Sie die Verbindung und haken Sie Shopware-Produkte an, die als neue Angebote angefügt werden sollen. Produkte, die noch nicht im Katalog liegen, sind mit einem Tooltip markiert — sie müssen erst durch den Katalog laufen.
Bestehende verknüpfen — öffnet die Seite Mirakl Offers. Listet Angebote auf, die auf der Betreiberseite bereits existieren, und lässt Sie sie nachträglich mit passenden Shopware-Produkten verbinden (nützlich nach Migrationen oder wenn Angebote außerhalb dieses Plugins erzeugt wurden).

Manuelle Synchronisation

Aus Offer Mappings:

Zeilen-Kontextmenü → Jetzt synchronisieren — synchronisiert diese eine Zuordnung sofort.
Zeilen auswählen + Symbolleiste → Ausgewählte synchronisieren — synchronisiert mehrere Zuordnungen auf einmal. Die Liste bestätigt anschließend, dass die Synchronisierung für die gewählte Anzahl in die Warteschlange gestellt wurde.

Aus Dashboard → Schnellaktionen → Alle Angebote synchronisieren — synchronisiert alle wartenden Zuordnungen für die gewählte Verbindung.

Automatische Synchronisation

Im Normalbetrieb müssen Sie nichts anklicken. Wenn Sie ein Shopware-Produkt speichern, prüft das Plugin, ob die Änderung ein Feld betroffen hat, das auf ein Mirakl-Angebotsfeld abgebildet ist (Preis, Bestand, ein Zusatzfeld, das in ein Angebotsfeld einfließt). Wenn ja, wird die zugehörige Angebotszuordnung als aktualisierungsbedürftig markiert und die Synchronisation läuft binnen Sekunden nach dem Speichern im Hintergrund.

Eine periodische Neusynchronisation von allem (etwa nach Bearbeitung einer globalen Wert-Transformation) erledigen Sie über die Schaltfläche Dashboard → Schnellaktionen → Alle Angebote synchronisieren.

Was die Spalte Status bedeutet

Die Spalte Status auf Offer Mappings durchläuft:

Ausstehend — neu angelegt, wartet auf den ersten Versand.
Eingereiht — an den Hintergrund-Worker übergeben, wartet auf die Ausführung.
In Bearbeitung — der Upload läuft.
Synchronisiert — der letzte Upload wurde von Mirakl angenommen.
Wiederholung — der letzte Versuch ist vorübergehend fehlgeschlagen (Netzwerk-Aussetzer, Betreiberauslastung); das Plugin versucht es erneut.
Fehler — der letzte Versuch ist fehlgeschlagen und braucht Ihre Aufmerksamkeit.

Fehlgeschlagene Entfernungen haben eigene Zustände in der Zeile: Wird von Mirakl entfernt, solange die Rücknahme läuft, und Entfernung fehlgeschlagen, wenn die Rücknahme nicht abgeschlossen werden konnte. In diesem Fall stehen zwei Aktionen zur Verfügung:

Entfernung wiederholen — versucht die Rücknahme erneut.
Zuordnung zurücksetzen — löscht den Fehlerstatus und stellt die Zuordnung wieder auf Ausstehend. Das Angebot wird nicht aus Mirakl entfernt — bei der nächsten Synchronisation wird es erneut gesendet. Verwenden Sie das, wenn die Entfernung fehlgeschlagen ist, Sie das Angebot aber doch aktiv halten möchten.

Wo Sie es konfigurieren

Mirakl → Einstellungen → Sync, Karte Synchronisierungseinstellungen:

Angebotssynchronisation-Batch-Größe — wie viele Angebote pro Upload zusammengefasst werden. Standard: 50. Zulässiger Bereich 1–500. Niedrigere Werte sparen Speicher und verringern das Timeout-Risiko; höhere Werte beschleunigen große Kataloge.

Die Angebotssynchronisation hat in den aktuellen Einstellungen keinen Hauptschalter — sie läuft automatisch beim Speichern von Produkten und manuell über die oben genannten Schaltflächen. Reine Bestandsänderungen haben eine eigene geplante Aufgabe (siehe Bestandssynchronisation).