Bestellstatus-Synchronisation

Sobald Mirakl-Bestellungen importiert sind, bearbeiten Sie sie wie jede andere Bestellung in Shopware: kommissionieren, packen, versenden, ablehnen, annehmen. Die Bestellstatus-Synchronisation übersetzt diese Shopware-Statuswechsel zurück in die passende Mirakl-Aktion, sodass der Betreiber und der Käufer immer denselben Status sehen wie Sie.

Wie das ausgelöst wird

Im Mirakl-Modul gibt es nichts manuell anzuklicken — die Synchronisation wird durch die Shopware-Statusautomatik gesteuert.

Öffnen Sie die Shopware-Bestellung über die normale Bestellliste oder über Importierte Bestellungen (Dashboard → Schnellstart → Bestellungen).
Ändern Sie den Status wie gewohnt (Bestellstatus, Versandstatus oder Zahlungsstatus — je nachdem, was Ihre Umgekehrte Status-Zuordnung vorsieht).
Das Plugin erkennt den Wechsel, sucht die verknüpfte Mirakl-Bestellung heraus und sendet die passende Aktion an den Betreiber.
Nach Bestätigung durch den Betreiber wird die Spalte Mirakl-Status auf Importierte Bestellungen aktualisiert, sodass Shopware und Mirakl denselben Status anzeigen.

Welcher Shopware-Status welche Mirakl-Aktion auslöst

Das konfigurieren Sie pro Verbindung im Editor Umgekehrte Status-Zuordnung — entweder über Mirakl → Einstellungen → Verbindungen → Zeilen-Kontextmenü → Umgekehrte Status-Zuordnung oder über Schritt 10 des Einrichtungsassistenten. Der Editor hat drei Abschnitte — Bestellstatus, Lieferstatus, Zahlungsstatus — die jeweils alle Shopware-Status mit einem Auswahlfeld daneben auflisten.

Jeder Shopware-Status kann auf eine der folgenden Optionen abgebildet werden:

— — keine Aktion (Standard; lassen Sie die meisten Zeilen so).
Akzeptieren (OR21) — Bestellung auf Mirakl annehmen.
Versenden (OR24) — Bestellung auf Mirakl als versendet markieren.
Tracking-Info setzen - ohne Versandbestätigung (OR23) — Tracking-Daten an Mirakl senden, ohne die Bestellung gleichzeitig als versendet zu markieren.
Ablehnen (OR29) — Bestellpositionen ablehnen.

Sinnvolle Standardwerte sind vorausgefüllt, Sie können sie aber pro Verbindung überschreiben — nützlich, wenn Sie auf mehreren Betreibern mit unterschiedlichen Abläufen verkaufen (automatische vs. manuelle Annahme).

Typische Konfiguration:

Mirakl-Aktion	Typischer Auslöser in Shopware
Akzeptieren (OR21)	Bestellstatus → In Bearbeitung
Tracking-Info setzen - ohne Versandbestätigung (OR23)	Lieferung → Teilweise versandt mit Tracking-Daten
Versenden (OR24)	Lieferung → Versandt
Ablehnen (OR29)	Bestellstatus → Storniert

Eine Bestellung ablehnen

Wenn Sie die Ablehnen-Aktion auslösen, teilt das Plugin dem Betreiber mit, dass jede Position der Bestellung abgelehnt wurde. Die aktuelle Implementierung fügt keinen Ablehnungsgrund und keinen Kommentar bei — nur das “nicht akzeptiert”-Kennzeichen pro Position. Wenn Ihr Betreiber einen Grund-Code verlangt, führen Sie die Ablehnung stattdessen manuell im Operator-Panel durch.

Tracking-Daten senden

Wenn Ihr Shopware-Statuswechsel Tracking-Daten enthält (Versender und Sendungsnummer), sendet das Plugin erst eine Tracking-Aktualisierung und anschließend die Versand-Aktion. Lösen Sie denselben Wechsel später mit denselben Tracking-Daten erneut aus, wird die Tracking-Aktualisierung übersprungen (nur die Versand-Aktion läuft); haben sich die Tracking-Daten geändert (Versand mit anderem Dienstleister), wird eine frische Tracking-Aktualisierung gesendet.

Warum doppelte Auslöser unkritisch sind

Vor jedem Aufruf prüft das Plugin den aktuellen Status der Mirakl-Bestellung:

Versenden / Tracking werden übersprungen, wenn die Bestellung bereits versandt, empfangen oder geschlossen ist.
Ablehnen wird übersprungen, wenn die Bestellung bereits abgelehnt oder storniert ist.
Akzeptieren ist nur zulässig, solange die Bestellung noch auf die Annahme wartet.

Liefert der Hintergrund-Worker also denselben Wechsel zweimal (was bei Wiederholungen vorkommen kann), passiert nichts Schlimmes — der zweite Aufruf wird als wirkungslos erkannt.

Aktualisierung nach der Aktion

Nach jedem erfolgreichen Statuswechsel holt das Plugin die Bestellung von Mirakl erneut ab, um den tatsächlichen Status nach der Aktion zu lesen. Das ist zuverlässiger als der Rückgabewert der API allein — Sie sehen immer, was der Betreiber wirklich mit Ihrer Anfrage gemacht hat.

Manuelle Aktualisierung

Wirkt der Mirakl-Status veraltet (zum Beispiel weil der Betreiber ihn auf seiner Seite verändert hat), holt die Aktion Bestellung aktualisieren frische Daten für eine einzelne Bestellung.