Bestellimport

Der Bestellimport ist die eingehende Seite der Integration. Er prüft beim Betreiber neue und geänderte Bestellungen, erzeugt sie als Shopware-Bestellungen und holt beim allerersten Lauf außerdem alles mit, was an diesen Bestellungen hängt (Nachrichten, Dokumente, Rechnungen, Transaktionsprotokolle).

Zeitgesteuerter Import (Standard)

Im Normalbetrieb müssen Sie nichts tun. Standardmäßig prüft das Plugin jede aktive Verbindung alle 30 Minuten auf neue Bestellungen (einstellbar: 2, 5, 10, 15, 30 oder 60 Minuten unter Bestellimport-Intervall in Mirakl → Einstellungen → Sync).

Bei jedem Lauf, für jede Verbindung mit aktivem Bestellimport:

1. Das Plugin fragt den Betreiber nach Bestellungen, die sich seit der letzten erfolgreichen Prüfung geändert haben.
2. Jede zurückgegebene Mirakl-Bestellung wird in eine Shopware-Bestellung umgesetzt:
   • Wenn die passende Shopware-Bestellung noch nicht existiert, wird sie im Verkaufskanal der Verbindung angelegt.
   • Wenn sie schon existiert, werden ihr Mirakl-Status und die gespeicherten Daten aufgefrischt.
3. Die nächste Prüfung setzt da fort, wo diese aufgehört hat, sodass dieselben Bestellungen nicht erneut verarbeitet werden.

Manueller Vollimport

Aus Dashboard → Schnellaktionen → Bestellungen jetzt importieren — startet einen einmaligen Import für die gewählte Verbindung sofort. Praktisch, wenn Sie gerade Zuordnungen geändert haben und das Ergebnis prüfen möchten oder wenn Sie die Startdatum-Vorgabe zurückgesetzt haben.

Erster Lauf: zugehörige Daten werden mitimportiert

Beim ersten Bestellimport einer Verbindung kettet das Plugin automatisch vier Folge-Importe an:

• Bestellnachrichten — alle Nachrichtenstränge zu den importierten Bestellungen.
• Bestelldokumente — alle an diesen Bestellungen hängenden Dokumente.
• Rechnungen — alle Betreiberrechnungen im Zeitraum.
• Transaktionsprotokolle — alle Transaktionseinträge.

Jeder Folge-Import läuft im Hintergrund mit eigener Fortschrittsanzeige. Nach diesem ersten Durchlauf wird jedes Thema von seiner eigenen geplanten Aufgabe weitergeführt (siehe Bestellnachrichten, Bestelldokumente, Rechnungen, Transaktionsprotokolle).

Wie weit zurück importiert wird — das Startdatum

Sie legen pro Verbindung fest, wie weit zurück der erste Bestellimport reichen soll:

• Setup-Assistent, Schritt 12 (Bestellungen importieren) — wählen Sie Alle historischen Bestellungen importieren (ohne Datumsfilter) oder Bestellungen ab einem bestimmten Datum importieren mit Datumsauswahl. Mit Weiter wird die Wahl auf der Verbindung gespeichert und der erste Import sofort gestartet.
• Später anpassen? Öffnen Sie den Assistenten aus Mirakl → Einstellungen → Verbindungen → Zeilen-Kontextmenü → Setup-Assistent starten und springen Sie zum Schritt Bestellungen importieren.

Die sicherste Wahl ist der Tag vor dem Go-Live Ihres Kontos beim Betreiber. Frühere Datumsangaben holen unter Umständen Bestellungen aus mehreren Jahren herein, die der Betreiber im Entwurfsstatus belassen hat — diese lassen sich meist nicht sauber importieren, weil ihre Produktreferenzen heute nichts mehr in Ihrem Shop treffen.

Wo Sie es konfigurieren

Mirakl → Einstellungen → Sync, Karte Synchronisierungseinstellungen:

• Bestellimport aktivieren — Hauptschalter. Standard: ein.
• Bestellimport-Intervall — wie oft die zeitgesteuerte Prüfung läuft. Standard: 30 Minuten.

Wie die importierte Shopware-Bestellung aussieht

• Bestellpositionen stammen aus den Mirakl-Daten, abgebildet auf Shopware-Produkte über die Produktreferenzen des Betreibers.
• Liefer- und Rechnungsadresse werden eins zu eins aus der Mirakl-Bestellung übernommen.
• Der Bestellstatus entspricht dem Status beim Betreiber, übersetzt über die Bestellstatus-Zuordnung, die Sie auf der Verbindung konfiguriert haben (Schritt 9 des Assistenten oder Zeilen-Kontextmenü → Bestellstatus-Zuordnung). Wenn Sie später den Status der Shopware-Bestellung ändern, gelangt die Änderung über die Umgekehrte Status-Zuordnung (Schritt 10 des Assistenten) zurück an Mirakl — siehe Bestellstatus-Synchronisation.

Importierte Mirakl-Bestellungen sehen Sie unter Dashboard → Schnellstart → Bestellungen (Liste Importierte Bestellungen).

Tipps & Hinweise

Tipp

Setzen Sie das Startdatum auf den Tag vor dem Go-Live Ihres Kontos beim Betreiber. Frühere Datumsangaben ziehen historische Bestellungen heran, die der Betreiber unter Umständen jahrelang im Entwurfsstatus belassen hat — diese importieren meist nicht sauber, weil ihre Produktreferenzen nicht mehr auflösbar sind.

Achtung

Wenn Sie eine Verbindung löschen, werden die Datensätze entfernt, die ihre Mirakl-Bestellungen mit Shopware verbinden. Die Shopware-Bestellungen selbst bleiben erhalten, verlieren aber den Bezug zu Mirakl — Statusänderungen werden nicht mehr an den Betreiber gemeldet. Sobald eine Verbindung Bestellungen importiert hat, pausieren oder benennen Sie sie um statt zu löschen.

Hinweis

Die initialen Folge-Importe (Nachrichten, Dokumente, Rechnungen, Transaktionsprotokolle) laufen pro Verbindung nacheinander, nicht parallel — jeder spricht seinen eigenen Endpunkt beim Betreiber an. Auf einer Verbindung mit langer Historie kann das dauern. Die Importe laufen im Hintergrund, sodass Sie den Assistenten direkt nach dem letzten Schritt schließen können.

Achtung

Bremst der Betreiber Sie mit einem Rate-Limit aus, beendet der laufende Durchgang sich vorzeitig mit einem Vermerk im Protokoll (“Rate limited, will resume on next scheduled run”). Die nächste geplante Prüfung setzt da fort, wo der vorherige Lauf gestoppt hat — ohne Ihr Zutun.

Verwandte Themen

• Bestellstatus-Synchronisation — Versand / Ablehnung / Tracking / Annahme aus Shopware an Mirakl
• Bestellnachrichten — beim ersten Import automatisch geholt
• Bestelldokumente — beim ersten Import automatisch geholt
• Rechnungen — beim ersten Import automatisch geholt
• Transaktionsprotokolle — beim ersten Import automatisch geholt
• Bestellung aktualisieren — einzelne Bestellung auf Anforderung aktualisieren
• Hintergrundaufgaben — wie geplante Prüfungen entscheiden, was ausgeführt wird