# 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.
:shop: 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. [![](https://content.gitbook.com/content/F8GepmoSonQRG6RnHOxJ/blobs/IE9hp5pWJka6o7jGhIo3/19168742250514)](https://helpcenter.channable.com/hc/article_attachments/19168742250514) Auch wenn das kompliziert klingt, umfasst die Lösung oft nur wenige einfache Schritte: * **Kategorien**: Stelle sicher, dass deine Produktkategorien im [Kategorien-Schritt](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/categorize-products) 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 API](https://helpcenter.channable.com/list-advertise/list-and-advertise-de/auf-marktplatzen-verkaufen/erste-schritte-mit-marktplatzen/marktplatze-build-schritt)verknü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](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). 4. Überprüfe und ordne Attribute neu zu, die im **Aufbau** Schritt als erforderlich markiert sind. Prüfe das :circle-info: 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](#how-to-download-a-non-integrated-products-report).
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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) und es mit [Regeln](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Tipp: Schau dir hier auch alle übrigen Fehler an, die als **Erforderlich laut Marktplatz** markiert sind (erkennbar an einem blauen Punkt). Klicke auf das :circle-info: Symbol, um mehr Informationen bzw. ein Beispiel für akzeptierte Werte zu sehen. {% endhint %} 6. Klicke **Speichern**. 7. 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](https://app.gitbook.com/s/UAGSVlvcNsqEqVUgr0tD/getting-started/fields-in-channable/map-and-add-fields) und es mit [Regeln](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/rules-in-channable). {% hint style="success" %} Tipp: Schau dir hier auch alle übrigen Fehler an, die als **Erforderlich laut Marktplatz** markiert sind (erkennbar an einem blauen Punkt). Klicke auf das :circle-info: Symbol, um mehr Informationen bzw. ein Beispiel für akzeptierte Werte zu sehen. {% endhint %} 5. Klicke **Speichern**. 6. 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. {% hint style="success" %} Tipp: Schau dir hier auch alle übrigen Fehler an, die als **Erforderlich laut Marktplatz** markiert sind (erkennbar an einem blauen Punkt). Klicke auf das :circle-info: Symbol, um mehr Informationen bzw. ein Beispiel für akzeptierte Werte zu sehen. {% endhint %} 4. Gehe zum **Regel** Schritt. 5. Erstelle eine [Regel für maximale Länge](https://helpcenter.channable.com/manage-improve-product-data/rules-bulk-edit-and-enrich/how-to-use-actions-then-in-rules/rule-action-maximum-length) für das Feld, das du verwendest, damit es das Zeichenlimit einhält. Klicke unbedingt auf **Speichern** um die Änderungen anzuwenden. 6. 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. {% hint style="success" %} Tipp: Schau dir hier auch alle übrigen Fehler an, die als **Erforderlich laut Marktplatz** (erkennbar an einem blauen Punkt). {% endhint %} 4. Klicke auf :circle-info: Symbol neben dem betroffenen Attribut, um Beispiel und mögliche Werte anzuzeigen. 5. Verwende [Regeln](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) , 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. 6. 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. {% hint style="success" %} Tipp: Schau dir hier auch alle übrigen Fehler an, die als **Erforderlich laut Marktplatz** (erkennbar an einem blauen Punkt). {% endhint %} 4. Klicke auf :circle-info: Symbol neben dem betroffenen Attribut, um Beispiel und mögliche Werte anzuzeigen. 5. Verwende [Regeln](https://app.gitbook.com/s/u8whzIfip72Kvn3M1bsc/rules-bulk-edit-and-enrich/using-rules) , 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. 6. 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.
:download: So lädst du einen Bericht über nicht integrierte Produkte herunter {% hint style="info" %} 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. {% endhint %} 1. Melde dich in deinem Mirakl-Account an. 2. Gehe zu **Katalog** > **Produktimporte**.
3. Finde in der Spalte „Dateiname“ heraus, welche Artikel von Channable importiert wurden, und ihre Zeitstempel. 4. Klicke bei diesen Artikeln auf **Details anzeigen** um die neuesten Importinformationen zu sehen.
5. Klicke **Herunterladen** neben **Bericht über nicht integrierte Produkte** um den Fehlerbericht automatisch herunterzuladen.
{% hint style="info" %} **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. {% endhint %} 6. Öffne die Datei in deiner Software. 7. Prüfe die **Fehler** Spalte, um die konkreten Fehler für jeden Artikel zu sehen. 8. 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 :circle-info: 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 :circle-question:.
{% hint style="success" %} Tipp: Nutze die Filter, um Status gesammelt anzuzeigen. {% endhint %} 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](https://help.mirakl.net/bundle/sellers/page/topics/Mirakl/mcm/seller/mcm_statuses_provider.htm).