Mirakl-Produktimport: Fehler in Vorlage, Werten und Mapping finden
Deine Produktdaten sind im PIM gepflegt, doch beim Händler fehlen Angaben oder ein vorhandener Wert wird nicht angenommen. Für die Korrektur ist entscheidend, wo die Ursache liegt: im Produktstamm, in der Kategorievorlage oder in der Zuordnung zwischen beiden.
Dieser Leitfaden zeigt einen systematischen Prüfablauf für Mirakl-basierte Partner wie home24 Marketplace und XXXLutz Marketplace. Er nutzt fiktive Möbeldaten, keine Original-Fehlercodes. Die konkreten Attribute, Wertelisten und Prüfprozesse bleiben vom jeweiligen Händler und seiner Kategorie abhängig.
Zuerst Partner, Kategorie und Vorlagenstand festhalten
Die shopvibes-Anleitungen beschreiben Kategorievorlage und API-Schlüssel des jeweiligen Partnerkontos als Grundlage für die automatische Produktdatenverteilung. Die Vorlage erzeugst du im Mirakl-Portal für die benötigten Kategorien und stellst sie für die Einrichtung bereit.
Halte für die Fehlersuche mindestens diese Angaben zusammen:
| Grundlage | Warum sie für die Diagnose wichtig ist |
|---|---|
| Händler und Partnerkonto | Eine Zuordnung für einen anderen Partner kann andere Anforderungen enthalten |
| Produktkategorie | Sie bestimmt, welche Zielangaben und Werte für den Artikel zu prüfen sind |
| Vorlage und Erstellungsdatum | Eine alte Vorlage kann vom aktuell vereinbarten Stand abweichen |
| Artikelnummer und Ausführung | Die Rückmeldung muss dem tatsächlich übertragenen Produkt zugeordnet werden |
| Betroffener Lauf | Du musst erkennen können, welche Ausgabe vor oder nach einer Korrektur entstanden ist |
Dass zwei Händler Mirakl einsetzen, bedeutet nicht, dass dieselbe Vorlage, dieselben Werte oder derselbe Freigabeablauf gelten. Prüfe die home24-Anbindung und die XXXLutz-Marketplace-Anbindung jeweils im passenden Kontext.
Vier Fragen grenzen die Fehlerquelle ein
- Ist die Information im zentralen Datensatz vorhanden? Prüfe den konkreten Artikel und seine Ausführung. Ein Wert auf einem ähnlichen Produkt hilft diesem Datensatz nicht automatisch.
- Verwendet das Mapping die richtige Quelle? Ein vorhandener Wert kann fehlen, wenn eine andere oder leere Eigenschaft zugeordnet ist.
- Entspricht die Ausgabe der Zielanforderung? Werteliste, Einheit, Format oder Kategorie können eine andere Darstellung verlangen.
- Was wurde beim Händler tatsächlich verarbeitet? Unterscheide die erzeugte beziehungsweise übertragene Ausgabe von den Rückmeldungen und der veröffentlichten Darstellung.
Diese Reihenfolge verhindert, dass du fehlende Produktinformationen durch einen festen Text für das gesamte Sortiment ersetzt. Ein Fixwert ist nur dann passend, wenn er fachlich für alle betroffenen Artikel gilt.
Fehlender Wert und unzulässiger Wert unterscheiden
Ein fehlender Wert und ein vorhandener, aber unpassender Wert brauchen unterschiedliche Korrekturen. Die folgenden Beobachtungen sind fiktive Diagnosebeispiele, keine wörtlichen Meldungen eines Händlers.
| Beobachtung | Prüfung | Mögliche Korrektur | Erneute Kontrolle |
|---|---|---|---|
| Die Farbangabe fehlt | Ist die Farbe an genau dieser Ausführung gepflegt und zugeordnet? | Variantenwert ergänzen oder die richtige Quelle zuordnen | Ausgabe der betroffenen SKU prüfen |
| „Nachtblau“ wird für eine Auswahl nicht angenommen | Welche Werte erlaubt die aktuelle Zielkategorie? | Fachlich passende Wertzuordnung einrichten | Ausgegebenen Wert mit der erlaubten Liste vergleichen |
| Die Breite ist um Faktor zehn falsch | Stimmen Quelle, Einheit und eingerichtete Umrechnung überein? | Quelle oder passende Multiplikator-Zuordnung korrigieren | Erwarteten Zahlenwert nachrechnen und Ausgabe prüfen |
| Ein Bett erhält die Maße der anderen Größe | Liegen die Maße am Modell oder an der Variante? | Ausführungsspezifische Quelle verwenden | Beide Größen nebeneinander vergleichen |
| Das Bild zeigt eine andere Farbe | Gehört das Medium zur übertragenen SKU? | Produkt- und Variantenbezug berichtigen | Bild, Titel und Datensatz gemeinsam prüfen |
| Die Übertragung ist abgeschlossen, der Artikel noch nicht sichtbar | Welcher Verarbeitungs- beziehungsweise Freigabestand liegt beim Partner vor? | Offene Datenhinweise bearbeiten oder den Partnerprozess klären | Tatsächliche Darstellung und Angebotszustand kontrollieren |
Ein scheinbar ähnlicher Begriff ist nicht immer eine passende Wertezuordnung. Prüfe etwa Materialbezeichnungen fachlich: Eine Holzoptik macht aus einer Spanplatte kein Massivholz.
Ein eigener Möbel-Test macht Zuordnungsfehler sichtbar
Wir betrachten zwei fiktive Bettrahmen. Die Angaben beschreiben ein internes Datenmodell und kein offizielles Händler-Schema.
| Artikelnummer | Liegefläche (B × L) | Außenmaß (B × L) | Lieferumfang |
|---|---|---|---|
| DEMO-BED-160-GREY | 160 × 200 cm | 170 × 210 cm | Bettrahmen ohne Matratze und Lattenrost |
| DEMO-BED-180-GREY | 180 × 200 cm | 190 × 210 cm | Bettrahmen ohne Matratze und Lattenrost |
Erhält die kleinere Ausführung das Außenmaß 190 × 210 cm, prüfst du zuerst die verwendete Quelle. Vielleicht wurde ein gemeinsamer Serienwert statt des Variantenwerts zugeordnet. Die Lösung besteht dann darin, die Zuordnung zu korrigieren und beide Ausführungen erneut auszugeben.
Danach prüfst du die Bedeutung des Zielfelds. Eine korrekte Zahl bleibt falsch, wenn sie die Liegefläche beschreibt, das Ziel aber das Produktaußenmaß verlangt. Verpackungsangaben sind nochmals getrennt zu betrachten. Der Leitfaden zu Möbelmaßen und Packstücken führt diese Unterschiede aus.
Zuordnungen in shopvibes gezielt bearbeiten
Der dokumentierte Mapping Editor unterstützt Attributzuordnungen, feste Werte und Wertezuordnungen. Im eingerichteten Mapping legst du damit fest, aus welcher Information eine Zielangabe entsteht und wie interne Werte zum erlaubten Zielwert passen.
Für die Fehlersuche hilft eine kleine Zuordnungsliste:
| Zielangabe im Beispiel | Quelle im internen Modell | Regel |
|---|---|---|
| Artikelnummer | SKU der gewählten Ausführung | Direkt übernehmen |
| Liegebreite | Liegebreite der Variante | Einheit mit der Zielanforderung abgleichen |
| Farbe | Interner Farbwert | Freigegebene Wertzuordnung verwenden |
| Beschreibung | Produktinformationen und passende Variantenangaben | Fachlich zum verkauften Artikel formulieren |
Der Complex Editor verbindet Attributwerte mit festem Text. Eine mathematische Umrechnung beschreibst und prüfst du über eine dafür eingerichtete Multiplikator-Zuordnung. Aus einer Textkombination solltest du keine beliebige Berechnung ableiten. Welche Bearbeitung im Konto verfügbar ist, hängt von Vorlage und Berechtigungen ab.
Rückmeldungen und Ausgabe zusammen prüfen
Ordne jede Auffälligkeit der Artikelnummer und dem betroffenen Datenbereich zu. Halte den Ausgangswert, die verwendete Quelle und deine Änderung fest. So kann dein Team erkennen, ob mehrere Artikel dieselbe Ursache haben oder unterschiedliche Produktinformationen fehlen.
Bei vielen Schnittstellen lässt sich in shopvibes die zuletzt übertragene Datei zur Kontrolle herunterladen. Diese Möglichkeit ist partnerabhängig. Der Inhalt einer Übertragungsdatei bestätigt außerdem noch nicht, dass der Händler alle Angaben bereits veröffentlicht hat.
Bei XXXLutz Marketplace beschreibt die Hilfe nach der automatischen Datenprüfung eine weitere manuelle Händlerprüfung. Diesen Ablauf und eine mögliche Bearbeitungszeit kannst du nicht pauschal auf jeden anderen Mirakl-Partner übertragen. Prüfe den jeweiligen Status im vorgesehenen Partnerprozess.
In sechs Schritten zu einem wiederholbaren Test
- Kleine Auswahl festlegen. Nutze zwei Varianten und, falls relevant, einen eigenen Setartikel. So deckst du unterschiedliche Datenfälle ab.
- Aktuelle Grundlage vergleichen. Prüfe Kategorievorlage und Mapping gegen die geplante Ausgabe.
- Ursachen einzeln korrigieren. Ergänze fehlende Werte im Produktstamm; ändere falsche Quellen und Wertzuordnungen im Mapping.
- Ausgabe kontrollieren. Vergleiche Zahlen, Einheiten, erlaubte Werte und Medien je Artikel. Rechne Umwandlungen anhand eines erwarteten Ergebnisses nach.
- Erneut übertragen. Nutze die eingerichtete Anbindung und halte den neuen Lauf fest.
- Ergebnis beim Partner prüfen. Kontrolliere Rückmeldungen, Inhalte und Angebotszustand, bevor du das übrige Sortiment ausrollst.
Prüfliste für dein Team
- Stimmen Händlerkonto, Kategorie und Vorlagenstand?
- Gehören alle Hinweise zur tatsächlich übertragenen Ausführung?
- Sind benötigte Angaben an der richtigen Quelle vorhanden?
- Entsprechen Werte und Einheiten den aktuellen Zielanforderungen?
- Stimmen Maße, Lieferumfang und Bilder miteinander überein?
- Ist die Korrektur in der neuen Ausgabe erkennbar?
- Wurde der Verarbeitungs- und Freigabestand beim Partner geprüft?
Mit einem gemeinsamen Produktstamm kannst du eine fachliche Korrektur für weitere passende Ausgaben wiederverwenden. Die jeweilige Partnerzuordnung bleibt dabei eigenständig. Unser Leitfaden zu Händler-Templates zeigt den grundlegenden Ablauf; der home24-Möbeldaten-Leitfaden vertieft das Bett-Beispiel.
Bring einen betroffenen Artikel und deine aktuelle Kategorievorlage zur Demo mit. Wir besprechen damit, wie du Datenquelle, Zuordnung und Ergebnisprüfung für deinen Partner nachvollziehbar aufbaust.
Quellen und Prüfstand
Stand: 3. November 2026.
- shopvibes: Kategorievorlagen von Mirakl-Partnern
- shopvibes: API-Schlüssel für Mirakl-Partner
- shopvibes: Mapping und Wertezuordnung
- shopvibes: Übertragene Daten kontrollieren
- shopvibes: XXXLutz-Anbindung und Freigabe
Über den Autor
Autor
Tim Hoffmann
Chief Product Officer, shopvibes
Tim Hoffmann ist Chief Product Officer bei shopvibes. Er beschäftigt sich mit Produktdatenmanagement, Marktplatzanbindungen und der Automatisierung von E-Commerce-Prozessen.
