Erste Synchronisation

An diesem Punkt sollten Sie eine Verbindung mit dem Status connected und aufgefrischten Referenzdaten haben — Kategorien, Produktattribute, Angebotsfelder, Angebotsstatus und Grund-Codes. Diese Seite führt Sie durch den minimalen Ende-zu-Ende-Ablauf: Ordnen Sie einige Kategorien zu, ordnen Sie die zwingend nötigen Attribute zu, senden Sie eine kleine Produktauswahl an den Marktplatz und schalten Sie Bestandssynchronisation und Bestellimport ein.

Alle nachfolgend erwähnten Seiten erreichen Sie vom Dashboard (der Seite, die sich öffnet, wenn Sie Mirakl in der Gruppe Kataloge der Hauptnavigation anklicken). Die Karte Schnellstart auf dem Dashboard hat für jede Seite eine Kachel — in jedem Schritt wird die jeweils passende genannt.

Schritt 1 — Mindestens eine Kategorie zuordnen

Der Marktplatz lehnt Angebote in Kategorien ab, die Sie keiner Shopware-Kategorie zugeordnet haben — das ist also die erste harte Voraussetzung.

1. Klicken Sie auf dem Dashboard in der Karte Schnellstart auf die Kachel Kategorien. Es öffnet sich Mirakl → Mirakl Kategorien. Die Liste zeigt den Kategoriebaum des Marktplatzes (Spalten: Code, Name, Vollständiger Pfad, Ebene, Übergeordneter Code, Aktiv, Verbindungen).
2. Suchen Sie eine Marktplatz-Kategorie, in der Sie verkaufen möchten (über den Filter Name oder den Filter Nach Verbindung filtern in der Seitenleiste). Klicken Sie auf die Zeile, um die Seite Kategoriedetails zu öffnen.
3. Wechseln Sie auf den Reiter Zuordnung.
4. Wählen Sie im Feld Verbindung den passenden Marktplatz (er ist automatisch ausgewählt, wenn Sie nur eine Verbindung haben).
5. Klicken Sie auf Kategorie hinzufügen. Wählen Sie im Dialog Kategorie-Zuordnung hinzufügen die passende Shopware-Kategorie aus und speichern Sie. Die Zuordnung wird sofort gespeichert und gilt für jedes Produkt in dieser Shopware-Kategorie.

Die Zuordnung läuft vom Marktplatz aus: Eine Marktplatz-Kategorie kann mehreren Shopware-Kategorien zugeordnet werden, alles von derselben Marktplatz-Kategorie-Detailseite aus. Sie können weitere Kategorien später ergänzen — das Plugin bemängelt eine fehlende Zuordnung erst, wenn Sie versuchen, ein Produkt zu senden, das in eine nicht zugeordnete Kategorie gehört.

Tipp

Bei großen Marktplätzen (Zehntausende Kategorien) nutzen Sie die Schaltfläche Massenbearbeitung auf der Liste Mirakl Kategorien, um Kategorien zu deaktivieren, in denen Sie ohnehin nie verkaufen werden. Deaktivierte Kategorien verschwinden aus den Shopware-Kategorie-Auswahlfeldern an anderer Stelle des Plugins, sodass die Auswahl der richtigen Kategorie deutlich schneller geht.

Schritt 2 — Die Pflichtattribute zuordnen

Jede Marktplatz-Kategorie hat eine Reihe von Attributen, die der Marktplatz als Pflichtfeld markiert. Das Plugin hebt diese auf der Seite Attributzuordnungen hervor.

1. Klicken Sie auf dem Dashboard in der Karte Schnellstart auf die Kachel Attributzuordnungen. Es öffnet sich Mirakl → Attributzuordnungen.
2. Klicken Sie auf Auto-Zuordnung. Eine Hintergrundaufgabe versucht, Marktplatz-Produktattribute mit Shopware-Feldern, eigenen Feldern, Eigenschaftsgruppen und Kategorien über Namensähnlichkeit zu verknüpfen. Der Fortschritt erscheint in einem Dialog.
3. Prüfen Sie die vorgeschlagenen Zuordnungen. Pflichtattribute, für die die Auto-Zuordnung nichts gefunden hat, müssen Sie von Hand zuordnen — sonst lehnt der Marktplatz diese Produkte ab.
4. Wenn Ihre Shopware-Werte für ein Attribut nicht 1:1 zu den vom Marktplatz akzeptierten Werten passen, richten Sie in der entsprechenden Zeile eine Transformation ein (Details unter Mapping → Attributes).

Sie können Auto-Zuordnung jederzeit erneut ausführen — Attribute, die für die ausgewählte Verbindung bereits eine Zuordnung haben, werden übersprungen, sodass nichts überschrieben wird, was Sie selbst eingestellt haben.

Schritt 3 — Eine kleine Produktauswahl senden

Schieben Sie nicht gleich am ersten Tag den kompletten Katalog hinaus. Wählen Sie 5–10 repräsentative Produkte aus und beobachten Sie den vollständigen Ablauf.

1. Klicken Sie auf dem Dashboard in der Karte Schnellstart auf die Kachel Katalog. Es öffnet sich Mirakl → Produktkatalog.
2. Engen Sie die Liste über die Filter in der Seitenleiste (Status, Verbindung, Name, Produktnummer, EAN / GTIN) auf eine Handvoll Produkte aus der in Schritt 1 zugeordneten Kategorie ein.
3. Setzen Sie in jeder Zeile, die Sie senden möchten, das Häkchen, und klicken Sie dann in der Werkzeugleiste auf Ausgewählte exportieren.
4. Wenn Sie mehr als eine Verbindung haben, fragt der Dialog Verbindung auswählen, an welchen Marktplatz dieses Paket gehen soll. Wählen Sie die Verbindung aus und klicken Sie auf Weiter.
5. Ein Fortschrittsdialog zeigt die Hintergrundaufgabe. Jedes ausgewählte Produkt wandert in die Warteschlange, und sein Exportstatus durchläuft Ausstehend → In Warteschlange → Verarbeitung → Exportiert (oder landet bei Problemen in Wiederholung oder Fehler).

Der Marktplatz verarbeitet das Paket auf seiner Seite; eventuelle Fehler pro Produkt erscheinen im Exportstatus der jeweiligen Zeile, sobald der Marktplatz die Prüfung des Uploads abgeschlossen hat.

Bei Produkten, die der Marktplatz abgelehnt hat, beheben Sie die Ursache (meist ein fehlendes Pflichtattribut oder eine Kategorie, in der der Marktplatz Ihren Produkttyp nicht akzeptiert) und stoßen den Export erneut an.

Schritt 4 — Bestandssynchronisation einschalten

Sobald Produkte auf dem Marktplatz aktiv sind, soll jede Bestandsänderung in Shopware automatisch dorthin übertragen werden.

1. Öffnen Sie Mirakl → Einstellungen → Synchronisierungseinstellungen.
2. Stellen Sie sicher, dass die Bestandssynchronisation aktiv ist (standardmäßig eingeschaltet).
3. Mit den Standardeinstellungen prüft das Plugin alle 15 Minuten, ob bei Produkten der Bestand verändert wurde, und überträgt den neuen Wert an den Marktplatz.

Sie müssen die vollen 15 Minuten nicht abwarten, wenn es eine einzelne Änderung gibt — das Plugin erkennt die Bestandsänderung in dem Moment, in dem sie in Shopware passiert, und markiert das passende Angebot, damit der nächste planmäßige Lauf es mitnimmt.

Schritt 5 — Bestellimport einschalten

Damit Marktplatz-Bestellungen in Shopware landen, schalten Sie den Bestellimport für die Verbindung ein.

1. Das früheste Datum, ab dem Bestellungen geholt werden, ist an der Verbindung hinterlegt — es ist die Auswahl, die Sie in Schritt 12 des Einrichtungs-Assistenten getroffen haben, und Sie können es später im Dialog Verbindung bearbeiten ändern. Nur Bestellungen, die jünger als dieses Datum sind, werden importiert (damit nicht jahrelange Historie hereinrollt).
2. Stellen Sie sicher, dass der Bestellimport unter Mirakl → Einstellungen → Synchronisierungseinstellungen aktiv ist (standardmäßig eingeschaltet).
3. Mit den Standardeinstellungen prüft das Plugin alle 30 Minuten auf neue Marktplatz-Bestellungen, legt für jede eine Shopware-Bestellung an und listet sie auf der Seite Bestellungen (über die Karte Schnellstart auf dem Dashboard → Bestellungen).
4. Aus der Shopware-Bestellung heraus können Sie versenden, ablehnen und mit dem Kunden in Shopware schreiben — die entsprechenden Shopware-Statuswechsel werden automatisch an den Marktplatz zurückgespielt (siehe Schritt 10 des Einrichtungs-Assistenten — Umgekehrte Status-Zuordnung).

Wenn der Bestellimport zum ersten Mal für eine Verbindung läuft, stößt er außerdem automatisch die Importe von Nachrichten-Threads, Dokumenten, Rechnungen und Transaktionsprotokollen für diesen Marktplatz an — Details stehen auf den jeweiligen feature-spezifischen Seiten.

Was kommt als Nächstes

• Katalog-Export — einmalige CSV für den Mirakl-Mapping-Assistenten erzeugen (nur bei der Ersteinrichtung).
• Katalog — laufende Katalogverwaltung (Zum Katalog hinzufügen, Ausgewählte exportieren, Statusverfolgung).
• Bestellungsimport — verkettete Importe für Nachrichten, Dokumente und Rechnungen.
• Sync-Logs — wo Sie nachschauen, wenn etwas schiefgegangen ist.
• Troubleshooting — häufige Fehler und ihre Behebung.