Mirakl Anleitung: Einstellungen und Lösungen

Mirakl ist ein Unternehmen, das eine Plattform für Online-Marktplätze bereitstellt. Es betreibt keinen eigenen Marktplatz, sondern stellt die Infrastruktur zur Verfügung, auf der verschiedene Marktplätze aufgebaut werden können.

Marktplätze, die auf Mirakls Plattform aufgebaut sind, teilen einen gemeinsamen Rahmen. Das bedeutet, sie haben oft ähnliche Verhaltensweisen, Einstellungen und ähnliche Probleme.

Dieser Leitfaden erklärt, wie man häufige Hindernisse behebt und welche Best Practices gelten, wenn man einen auf Mirakl aufgebauten Marktplatz mit Channable betreibt.

---

Unsere unterstützten Mirakl-Marktplätze

Decathlon	Fnac	Blokker Connect!
Leroy Merlin	fonQ	Darty
Bricoman	Mediamarkt	Conforama
Carrefour Frankreich/Spanien	Manor	PcComponentes
Maxeda Brico&Praxis	Leen Bakker	ePrice
Douglas	Galeries Lafayette	Home24

Best Practices und Einstellungen für Mirakl

Wie man mehrere Attributwerte hinzufügt

Wenn du mehrere Werte für ein einzelnes Attributfeld für einen Mirakl-Marktplatz eingeben musst, trenne jeden Wert mit einem senkrechten Strich "|". Dieses Format sorgt dafür, dass Mirakl jeden einzelnen Eintrag korrekt erkennt und verarbeitet.

Mirakl-Fehler

Was ist der mirakl_unknown_error_code und wie löst man ihn?

Ein Fehler, dem du begegnen kannst, ist der mirakl_unknown_error_code. Dieser Fehler steht für eine Gruppe von Problemen, die typischerweise auftreten, wenn die EAN eines Produkts nicht in der Mirakl-Datenbank erkannt wird — das kann darauf hinweisen, dass das Produkt neu auf dem Marktplatz ist oder erforderliche Attribute fehlen.

Kurz gesagt: Etwas, das vom Marktplatz verlangt wird, fehlt oder ist nicht korrekt ausgefüllt.

Auch wenn das komplex wirkt, besteht die Lösung oft aus ein paar einfachen Schritten:

• Kategorien: Stelle sicher, dass deine Produktkategorien im Kategorien-Schritt deiner API korrekt zugeordnet sind. Falls nicht, mappe sie genau.

• Der Build-: Überprüfe, dass der Build-Schritt deiner API korrekt konfiguriert ist. Ein falsch verknüpftes EAN-Feld kann beispielsweise Fehler verursachen. Passe alle Unstimmigkeiten an.

• Attribute: Im Attribute-Schritt der APIverknüpfe jedes Feld mit dem richtigen Gegenstück und stelle sicher, dass die Werte für die gewählte Kategorie passend sind.

• Regeln: Nutze Regeln, um deine Daten weiter zu verfeinern. Sieh dir den Support-Artikel zum Attribut-Builder an, um den Attribute-Schritt in deiner API zu verbessern.

Sobald Kategorien und Attribute in deiner API ausgefüllt sind, gehe zur APIs-Übersicht und führe die API aus, indem du auf den blauen "Aktualisieren"-Button klickst.

Fehler 1004: Die Kategorie konnte nicht identifiziert werden

Fehler 1004 zeigt an, dass Artikel mit falscher Kategorienzuordnung gesendet werden, die nicht mit den Kategorien des Marktplatzes auf Mirakl übereinstimmen. Dies wird oft durch eine bereits bestehende manuelle Kategorienzuordnung in deinem Mirakl-Marktplatz verursacht.

Wie du das Problem löst:

Gehe in der linken Leiste zu Einstellungen und klicke auf 'Settings' > 'Catalog mapping'. Du siehst die Zuordnung. Das orange eingerahmte Feld (Category) wurde möglicherweise manuell hinzugefügt. Wähle das orange eingerahmte 'category' aus und die Zuordnung wird rechts angezeigt. Klicke erneut auf 'Category' (das ist sicher zu löschen, da Channable es nicht dort abgelegt hat), und klicke dann auf 'Remove mapping'. Nachdem du die manuelle Zuordnung entfernt hast, gehe zurück zur Mirakl-API in Channable und führe die API erneut aus. Das aktualisiert die Kategorienzuordnungen und sollte den Kategorien-Mismatch-Fehler beheben.

Den Mirakl-Fehlerbericht erhalten

Da Marktplätze auf der Mirakl-Plattform aufgebaut sind, erfolgt das Abrufen eines Fehlerberichts auf allen Marktplätzen nach demselben Verfahren.

1. Melde dich in deinem Mirakl-Konto an und gehe zu Katalog > Product Imports.

1. Finde die von Channable durchgeführten Importe und ihre Zeitstempel. Klicke auf die Schaltfläche „See details“ für den neuesten Import.

1. Wähle „Non-integrated products report“, um den Fehlerbericht automatisch herunterzuladen.

Hinweis: Die Datei ist eine CSV. Bei Verwendung von Microsoft Excel musst du die Datei möglicherweise transformieren/importieren.

Nach dem Herunterladen und Konvertieren der Datei suche in der Spalte „Status“ nach den spezifischen Fehler(n) für jeden Artikel.

Was sind die Status in Mirakl?

Um den Produktstatus zu sehen, gehe zum Catalog Manager für eine Übersicht über alle deine Produkte.

• Um einen übergeordneten Status zu verstehen, klicke auf das Fragezeichen (?) neben dem Produkt.

• Um den Meta-Status (detailliert) zu sehen, öffne die Produktseite und klicke auf (? ).

• Verwende die Filter im Catalog Manager, um Status in großer Menge anzuzeigen.

Produkte auf der Plattform haben drei Hauptstatus: Validierung, Akzeptanz und Synchronisation. Kombinationen daraus ergeben verschiedene Meta-Statuses.

Die Status im Mirakl Catalog Manager

Status	Meta-Status	Beschreibung
Validierung	Gültige Daten	Die Produktdaten entsprechen den Anforderungen des Marktplatzes.
	Ungültige Daten	Die Produktdaten entsprechen nicht den Anforderungen des Marktplatzes.
	Medien ausstehend	Die Medien (Bilder, Videos, Dokumente) der Produktdaten wurden von der Mirakl-Plattform noch nicht verarbeitet.
	Nicht berechnet	Wenn der Marktplatz die Produktdatenvalidierung für einen Kanal aktiviert, werden die Validierungsstatus der Produkte nicht automatisch neu berechnet. In diesem Fall erhalten diese Produkte für den jeweiligen Kanal den Status ‚Nicht berechnet‘. Mehrere Aktionen können die Neuberechnung des Validierungsstatus eines Produkts auslösen: - Nach dem Neuaufbau der Product Data Sheets - wenn du das Source Product Data Sheet änderst und diese Änderungen im Master Product Data Sheet übernommen werden - wenn du ein Master Product Data Sheet änderst Alle neuen Produkte erhalten den passenden Validierungsstatus für jeden aktivierten Kanal.
Akzeptanz	Neu	Das Produkt ist neu und der Marktplatz muss es annehmen oder ablehnen.
	Änderungen erforderlich	Dein Marktplatz hat das Produkt aufgrund von Datenqualitätsproblemen abgelehnt. Du musst deine Produkte aktualisieren, bevor der Marktplatz das Produkt erneut prüft. Du kannst den Ablehnungsgrund sehen, indem du mit der Maus über das Fragezeichen (?) fährst.
	Überprüfung ausstehend	Du wurdest gebeten, ein Produkt oder mehrere Produkte zu aktualisieren. Änderungen wurden vorgenommen. Die Marktplätze müssen nun entscheiden, das/die Produkt(e) anzunehmen oder abzulehnen.
	Akzeptiert	Dein Marktplatz hat das Produkt akzeptiert.
	Abgelehnt	Dein Marktplatz hat das Produkt abgelehnt. Du kannst den Ablehnungsgrund sehen, indem du mit der Maus über das Fragezeichen (?) fährst.
Synchronisation	Synchronisiert	Das Produkt ist in die Marktplatz-Plattform integriert.
	Nicht synchronisiert	Das Produkt ist nicht in die Marktplatz-Plattform integriert.
	Synchronisationsfehler	Bei der Integration des Produkts ist ein Fehler aufgetreten.

Für weitere Informationen zu Mirakl-Status kannst du ihr Help Center besuchen.