Mirakl-Leitfaden: Einstellungen und Lösungen

Mirakl betreibt keinen eigenen Marktplatz. Stattdessen stellt es die Infrastruktur bereit, die andere nutzen, um ihren eigenen Marktplatz zu erstellen und zu verwalten.

Da viele Mirakl-Marktplätze dasselbe Setup verwenden, haben sie oft ähnliche Einstellungen, Verhaltensweisen und häufige Probleme.

Mirakl-Marktplätze in Channable

• Decathlon

• Fnac

• Leroy Merlin

• fonQ

• Darty

• Bricoman

• Mediamarkt

• Conforama

• Carrefour Frankreich/Spanien

• Manor

• PcComponentes

• Maxeda Brico&Praxis

• Leen Bakker

• ePrice

• Douglas

• Galeries Lafayette

• Home24

• Sprinter

• Showroomprive

• Hornbach

• Conrad

• Vtwonen

• Galeries Lafayette

---

Was ist der mirakl_unknown_error_code und wie behebst du ihn?

Wenn dieser Fehler auftritt, bedeutet das, dass das Produkt von Mirakl nicht erkannt wird. Mögliche Gründe sind:

1. Fehlende Produktdetails wie kategoriespezifische Attribute.

2. Produktinformationen stehen noch aus und werden als „Product - submission pending“ angezeigt.

3. Fehler in den übermittelten Daten, gekennzeichnet als „Product - data error“ oder „Product - integration error“.

Kurz gesagt: Es fehlt etwas, das der Marktplatz benötigt, oder es ist nicht korrekt ausgefüllt.

Auch wenn das kompliziert klingt, umfasst die Lösung oft nur wenige einfache Schritte:

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

• Aufbau: Überprüfe, ob der Build-Schritt deiner API korrekt eingerichtet ist. Ein falsch verknüpftes EAN-Feld kann hier zum Beispiel Fehler verursachen. Passe Abweichungen entsprechend an.

• Attribute: Im Attribut-Schritt der APIverknüpfst du jedes Feld mit dem richtigen Gegenstück und stellst sicher, dass die Werte für die ausgewählte Kategorie geeignet sind.

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

Sobald Kategorien und Attribute in deiner API ausgefüllt sind, geh zur Übersicht der APIs und starte die API, indem du auf den blauen Button „Jetzt ausführen“ klickst.

Best Practices und Einstellungen für Mirakl

Mehrere Attributwerte hinzufügen

Wenn du für ein einzelnes Attributfeld in einem Mirakl-Marktplatz mehrere Werte eingeben musst, trenne die einzelnen Werte mit dem Pipe-Symbol „|“. Diese Formatierung stellt sicher, dass Mirakl jeden einzelnen Eintrag korrekt erkennt und verarbeitet.

Häufige Mirakl-Fehler und wie du sie behebst

Angebot - Produkt nicht gefunden

Dieser Fehler tritt auf, wenn die EAN eines Produkts in der Mirakl-Datenbank nicht erkannt wird.

Das passiert meist, wenn:

• Das Produkt wird noch von Mirakl verarbeitet (angezeigt als Product - submission pending).

• Der Produktimport ist fehlgeschlagen, weil erforderliche Daten fehlen oder ungültig sind (zum Beispiel kategoriespezifische Attribute). Das wird meist angezeigt als Product - data error oder Product - integration error.

So behebst du das

1. Im Resultat Schritt deines Mirakl-Marktplatzkanals, geh zum Feedback Tab.

2. Prüfe andere gelistete produktbezogene Fehler.

3. Prüfe das Fehler-Feedback in der Fehler Spalte. Passe deine Daten bei Bedarf mit Regeln.

4. Überprüfe und ordne Attribute neu zu, die im Aufbau Schritt als erforderlich markiert sind. Prüfe das Symbol und die Tooltips, um die akzeptierten Werte zu sehen.

5. Klicke Aktualisieren , um deinen Kanal erneut auszuführen.

Product - submission pending

Dieser Fehler tritt auf, wenn der Marktplatz deine Produktinformationen noch verarbeitet.

Für die neuesten Statusinformationen lade in Mirakl einen Bericht über nicht integrierte Produkte herunter.

1000: Erforderliches Attribut ist leer

Ein für diesen Marktplatz erforderliches Attribut wurde nicht zugeordnet oder hat keinen Wert.

So behebst du das:

1. Im Feedback Tab im Resultat Schritt, klicke auf den Fehler.

2. Klicke auf die verknüpfte ID in der ID Spalte.

3. Scrolle, um Felder zu sehen, die markiert sind als Fehlendes Mapping für [Attribut einfügen].

4. Klicke Im Aufbau-Schritt anzeigen. Dadurch gelangst du zum betroffenen Attribut im Aufbau Schritt.

5. Ordne das fehlende Feld zu. Wenn du kein Feld mit akzeptierten Werten hast, kannst du ein neues Feld erstellen und es mit Regeln.

Tipp: Schau dir hier auch alle übrigen Fehler an, die als Erforderlich laut Marktplatz markiert sind (erkennbar an einem blauen Punkt). Klicke auf das Symbol, um mehr Informationen bzw. ein Beispiel für akzeptierte Werte zu sehen.

1. Klicke Speichern.

2. Klicke Aktualisieren.

1001: Unbekannte Kategorie angegeben

Der angegebene Kategorienwert stimmt nicht mit einer Kategorie des Marktplatzes überein oder es wurde statt des Codes ein Label angegeben.

So behebst du das:

1. Im Feedback Tab im Resultat Schritt, klicke auf den Fehler.

2. Klicke auf die verknüpfte ID in der ID Spalte.

3. Klicke Im Aufbau-Schritt anzeigen. Dadurch gelangst du zum betroffenen Attribut im Aufbau Schritt.

4. Ordne das fehlende Feld zu. Wenn du kein Feld mit akzeptierten Werten hast, kannst du ein neues Feld erstellen und es mit Regeln.

Tipp: Schau dir hier auch alle übrigen Fehler an, die als Erforderlich laut Marktplatz markiert sind (erkennbar an einem blauen Punkt). Klicke auf das Symbol, um mehr Informationen bzw. ein Beispiel für akzeptierte Werte zu sehen.

1. Klicke Speichern.

2. Klicke Aktualisieren.

2004: Ein Attribut hat einen zu langen Wert

Das zugeordnete Feld für dieses Attribut muss unter dem angegebenen Zeichenlimit liegen.

So behebst du das:

1. Im Feedback Tab im Resultat Schritt, klicke auf den Fehler 2004.

2. Merke dir das betroffene Attribut, das in der Fehler Spalte und das Zeichenlimit angegeben ist.

3. Gehe zum Aufbau Schritt und prüfe, welches Feld du dem betroffenen Attribut zugeordnet hast.

Tipp: Schau dir hier auch alle übrigen Fehler an, die als Erforderlich laut Marktplatz markiert sind (erkennbar an einem blauen Punkt). Klicke auf das Symbol, um mehr Informationen bzw. ein Beispiel für akzeptierte Werte zu sehen.

1. Gehe zum Regel Schritt.

2. Erstelle eine Regel für maximale Länge für das Feld, das du verwendest, damit es das Zeichenlimit einhält. Klicke unbedingt auf Speichern um die Änderungen anzuwenden.

3. Klicke Aktualisieren.

2006: Ein Attribut hat einen Wert, der nicht zu den zulässigen Werten gehört

Dieser Fehler tritt auf, wenn das Feld, das du zugeordnet hast, einen nicht akzeptierten Wert enthält.

So behebst du das:

1. Im Feedback Tab im Resultat Schritt, klicke auf den Fehler 2006.

2. Klicke auf die verknüpfte ID in der ID Spalte.

3. Scrolle, um Felder zu sehen, die markiert sind als Ungültiger Wert für [Attributname]. Klicke daneben auf Im Aufbau-Schritt anzeigen. Dadurch gelangst du zum betroffenen Attribut im Aufbau Schritt.

4. Merke dir das Feld, das du dem betroffenen Attribut zugeordnet hast.

Tipp: Schau dir hier auch alle übrigen Fehler an, die als Erforderlich laut Marktplatz (erkennbar an einem blauen Punkt).

1. Klicke auf Symbol neben dem betroffenen Attribut, um Beispiel und mögliche Werte anzuzeigen.

2. Verwende Regeln , um ein neues Projektfeld mit den akzeptierten Werten zu aktualisieren oder zu erstellen. Klicke unbedingt auf Speichern um die Änderungen anzuwenden.

   1. Wenn du ein neues Projektfeld erstellst, ordne es im Aufbau Schritt diesem neuen Feld neu zu.

3. Klicke Aktualisieren.

2007: Ein Attributwert stimmt nicht mit einem regulären Ausdruck überein

Dieser Fehler tritt auf, wenn der Wert im Attribut nicht dem erwarteten Format entspricht.

So behebst du das:

1. Im Feedback Tab im Resultat Schritt, klicke auf den Fehler 2007.

2. Klicke auf die verknüpfte ID in der ID Spalte.

3. Scrolle, um Felder zu sehen, die markiert sind als Ungültiger Wert für [Attributname]. Klicke daneben auf Im Aufbau-Schritt anzeigen. Dadurch gelangst du zum betroffenen Attribut im Aufbau Schritt.

4. Merke dir das Feld, das du dem betroffenen Attribut zugeordnet hast.

Tipp: Schau dir hier auch alle übrigen Fehler an, die als Erforderlich laut Marktplatz (erkennbar an einem blauen Punkt).

1. Klicke auf Symbol neben dem betroffenen Attribut, um Beispiel und mögliche Werte anzuzeigen.

2. Verwende Regeln , um ein neues Projektfeld mit den akzeptierten Werten zu aktualisieren oder zu erstellen. Klicke unbedingt auf Speichern um die Änderungen anzuwenden.

   1. Wenn du ein neues Projektfeld erstellst, ordne es im Aufbau Schritt diesem neuen Feld neu zu.

3. Klicke Aktualisieren.

Mirakl-Fehlerberichte

Du kannst in Mirakl verschiedene Fehlerberichte herunterladen, um unterschiedliche Fehler zu untersuchen. Du findest sie alle unter Katalog > Produktimporte.

• Fehlerbericht der Quelldatei: Zeigt, was in deiner Quelldatei oder deinem Format falsch ist. Die angezeigten Daten enthalten genau dasselbe Feedback, das auch in deinem Marktplatzkanal in Channable erscheint.

• Bericht über nicht integrierte Produkte (empfohlen): Zeigt dir, was der Marktplatz nach der Verarbeitung deiner Übermittlung abgelehnt oder gerade prüft.

  • Verwenden, wenn: Du deinen Kanal erfolgreich ausgeführt hast, aber die Fehlermeldung „Product - submission pending“ angezeigt wird.

• Bericht über hinzugefügte Produkte: Bestätigt, welche Produkte/Zeilen erfolgreich integriert wurden

  • Verwenden, wenn: Du einen Nachweis darüber willst, was live ist, oder prüfen möchtest, was erstellt statt gesendet wurde.

So lädst du einen Bericht über nicht integrierte Produkte herunter

Hinweis: Das ist ein ausführlicher Bericht, dessen Erstellung in Mirakl mehrere Tage dauern kann. Bei dringenden Fällen kontaktiere bitte den Support von Mirakl.

1. Melde dich in deinem Mirakl-Account an.

2. Gehe zu Katalog > Produktimporte.

1. Finde in der Spalte „Dateiname“ heraus, welche Artikel von Channable importiert wurden, und ihre Zeitstempel.

2. Klicke bei diesen Artikeln auf Details anzeigen um die neuesten Importinformationen zu sehen.

1. Klicke Herunterladen neben Bericht über nicht integrierte Produkte um den Fehlerbericht automatisch herunterzuladen.

Hinweis: Die Datei ist eine CSV. Wenn du Microsoft Excel oder Google Sheets verwendest, musst du die Datei möglicherweise transformieren/importieren, um sie ansehen zu können.

1. Öffne die Datei in deiner Software.

2. Prüfe die Fehler Spalte, um die konkreten Fehler für jeden Artikel zu sehen.

3. Behebe, was du anhand der Fehlerbeschreibung beheben kannst. Mirakl erhält dieses Feedback vom Marktplatz.

Wenn du nicht sicher bist, was die Beschreibung bedeutet, kontaktiere den Marktplatz für weitere Informationen.

Produktstatus in Mirakl prüfen

Produkte auf der Plattform haben drei Hauptstatus:

• Validierung

• Akzeptanz

• Synchronisierung

Kombinationen daraus ergeben verschiedene Meta-Status.

1. Geh in deinem Mirakl-Backend zu Katalog > Katalog-Manager. Dort siehst du eine Übersicht aller deiner Artikel.

2. Im Neue Features Spalte, klicke auf um mehr Informationen darüber zu sehen, was ein bestimmter Status bedeutet.

3. Um eine detailliertere Beschreibung zu sehen, öffne die Produktseite und klicke auf .

Tipp: Nutze die Filter, um Status gesammelt anzuzeigen.

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

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.
	Ausstehende Medien	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 akzeptieren oder ablehnen.
	Änderungen erforderlich	Dein Marktplatz hat das Produkt aufgrund von Problemen mit der Datenqualität abgelehnt. Du musst deine Produkte aktualisieren, bevor dein Marktplatz das Produkt erneut prüft. Du kannst den Ablehnungsgrund sehen, wenn du mit der Maus über das Fragezeichen (?) fährst
	Ausstehende Prüfung	Du wurdest aufgefordert, ein Produkt oder mehrere Produkte zu aktualisieren. Die Änderungen wurden vorgenommen. Die Marktplätze müssen nun entscheiden, ob sie das Produkt bzw. die Produkte akzeptieren oder ablehnen.
	Akzeptiert	Dein Marktplatz hat das Produkt akzeptiert.
	Abgelehnt	Dein Marktplatz hat das Produkt abgelehnt. Du kannst den Ablehnungsgrund sehen, wenn du mit der Maus über das Fragezeichen (?) fährst
Synchronisierung	Synchronisiert	Das Produkt ist in die Marktplatzplattform integriert.
	Nicht synchronisiert	Das Produkt ist nicht in die Marktplatzplattform integriert.
	Synchronisierungsfehler	Bei der Integration des Produkts ist ein Fehler aufgetreten.

Für weitere Informationen zu Mirakl-Status kannst du das Hilfe-Center besuchen.