Katalog-Export

Bevor der Marktplatz Ihre Produkte annehmen kann, muss der Betreiber wissen, wie er sie liest — welche CSV-Spalte den Produkttitel trägt, welche die Marke, die EAN, die Kategorie und so weiter. Mirakl löst das über einen Mapping-Assistenten im Betreiber-Panel: Sie laden eine repräsentative CSV-Datei hoch, ordnen per Klick Spalten zu Betreiber-Attributen, speichern das Ergebnis.

Diese Seite erzeugt diese einmalige Muster-CSV. Sobald der Assistent auf Mirakl-Seite eingerichtet ist, laufen weitere Produktergänzungen über Katalog und brauchen diese Seite nicht mehr.

Wo zu finden

Öffnen Sie im Dashboard die Karte Quick Start und klicken Sie die Kachel Catalog Export. Dies öffnet die Seite Katalog-Export.

Was angezeigt wird

Das Raster listet Shopware-Produkte, die für den Export in Frage kommen. Spalten:

Spalte	Bedeutung
Produkt	Name (mit Vorschaubild, sofern vorhanden).
Produktnummer	Die Shopware-Produktnummer.
EAN	EAN / GTIN, sofern gesetzt.
Hersteller	Herstellername.
Aktiv	Ob das Produkt in Shopware aktiv ist.
Auf Lager	Verfügbarer Bestand.
Verfügbar	Ob das Produkt aktuell verkäuflich ist.

Die Seitenleiste bietet:

Verkaufskanal — gesperrt auf den mit der Verbindung verbundenen Verkaufskanal (nur Produkte, die in diesem Kanal sichtbar sind, können exportiert werden).
Aktiv — gesperrt auf ja (nur aktive Produkte werden gesendet).
Name, Produktnummer, EAN / GTIN — freie Filter zum Eingrenzen.

Die vier Schritte

Die Seite zeigt sie inline unter dem Infofeld Katalog-Mapping:

Mit den Filtern auswählen, welche Produkte in die Katalog-Datei gehen.
Auf CSV generieren klicken, um die Datei zu erzeugen.
Die generierte CSV-Datei herunterladen.
In Ihrem Mirakl-Panel zu Einstellungen → Catalog mapping gehen und den Mapping-Assistenten starten, dabei die gerade heruntergeladene CSV-Datei hochladen.

Der Assistent ist ein Mirakl-seitiges Werkzeug — sobald Sie dort Ihre CSV-Spalten zu Betreiber-Attributen zugeordnet haben, wird die Konfiguration auf Betreiberseite gespeichert und gilt für jeden weiteren Produktupload.

Generierung im Hintergrund

Die CSV-Generierung läuft im Hintergrund — das Plugin stellt den Export in die Warteschlange und zeigt einen Fortschrittsdialog. Während der Generierung können Sie:

Auf der Seite bleiben und den Fortschritt verfolgen (Hier bleiben).
Auf Zu den Aufgaben klicken, um die Aufgabenfortschritt-Seite zu öffnen, wo jeder Export eine eigene Zeile mit einer Datei herunterladen-Aktion hat, sobald die CSV fertig ist.

Die Schaltfläche Aufgaben in der Symbolleiste ist eine Abkürzung dorthin.

Fehlende Felder pro Zeile

Wenn ein Produkt erforderliche Attribute oder erforderliche Angebotsfelder vermissen lässt, zeigt die Zeile ein Warnsymbol. Beim Klicken öffnet sich ein Dialog mit genau den fehlenden Produktattributen und Angebotsfeldern. Korrigieren Sie das Produkt in Shopware (oder die entsprechende Zuordnung) und erzeugen Sie die CSV erneut.

Ein Produkt mit fehlenden Pflichtfeldern wird nicht in die CSV aufgenommen — der Betreiber würde es ohnehin ablehnen.

Verifikation der Export-Konfiguration

Vor dem Start läuft eine Verifying export configuration-Prüfung, die bestätigt, dass die Verbindungseinstellungen und Attribut-Zuordnungen eine brauchbare CSV erzeugen können. Fehlt etwas, zeigt der Dialog das Hindernis und der Export startet nicht. Ursache beheben und erneut versuchen.

Tipps & Fallstricke

Verwandt

Katalog — laufende Ergänzungen von Shopware-Produkten in den Mirakl-Katalog
Vorhandene Mirakl-Produkte verknüpfen — bereits beim Betreiber existierende Katalogprodukte verbinden
Aufgaben — wo die generierte CSV heruntergeladen wird
Mapping → Attribute — welche Spalten in der CSV landen
Mapping → Kategorien — wie Shopware-Kategorien zu Betreiber-Kategorien gemappt werden