XXXLutz Marketplace Logo
Marktplätze

XXXLutz Marketplace: Produktdaten per API anbinden

Bereite deine Produktdaten für XXXLutz Marketplace mit shopvibes auf. Die direkte Mirakl-API-Anbindung benötigt den API-Schlüssel deines Partnerkontos und die passende Kategorievorlage. Darauf baut das Mapping für deine Möbel- und Wohnsortimente auf.

Aktualisiert:

Zentraler Katalog
Datenbasis
Partner-Mapping
Aufbereitung
API
Übertragung

Welcher XXXLutz-Prozess ist gemeint?

Diese Seite beschreibt die Anbindung an XXXLutz Marketplace über die Mirakl-API. Sie verbindet deine zentral gepflegten Produktdaten mit dem Kategorie-Mapping für den Marktplatz. Lege zuerst fest, welches Partnerkonto und welches Sortiment du über diesen Weg bedienen möchtest.

Der klassische XXXLutz-Lieferantenprozess wird gesondert behandelt. Aus einer Marketplace-Anbindung folgt keine automatische Freischaltung weiterer Konzernmarken, Länder oder Lieferantenprozesse.

Zugang und Kategorievorlage vorbereiten

Das shopvibes-Hilfezentrum dokumentiert für die Einrichtung den XXXLutz-API-Schlüssel und das kategoriespezifische Template. Die aktuelle Vorlage bestimmt, welche Angaben und erlaubten Werte für deine Produkte zugeordnet werden müssen.

Pflege die Produktinformationen zentral und richte die Ausgabe passend für den Partner ein. Halte den Vorlagenstand, die gewählte Kategorie und die zuständige Person für spätere Änderungen fest. Auch bei einem weiteren Mirakl-Händler prüfst du dessen Anforderungen erneut.

VorbereitungFrage für dein Team
PartnerkontoGehören Zugang und API-Schlüssel zum vorgesehenen Marktplatzkonto?
KategoriePasst die Vorlage zur konkreten Produktgruppe?
DatenquelleWelche Angaben liegen an der Serie, welche an der einzelnen Ausführung?
TitelLassen sich Varianten und Set-Inhalte eindeutig erkennen?
AusgabeWelche Produkt- und Medienfelder sind im vereinbarten Mapping enthalten?

Titel für Varianten und Sets nachvollziehbar aufbauen

Die shopvibes-Anleitung beschreibt, dass der Händler die Marke voranstellt. Sie soll deshalb in der übertragenen Titelangabe nicht zusätzlich enthalten sein. Verwende einen verständlichen Produkttyp und passende Unterscheidungsmerkmale. Bei Sets muss der zutreffende Set-Inhalt erkennbar sein. Prüfe den Aufbau mit den aktuellen Vorgaben deiner Kategorie.

Ein fiktives Beispiel zeigt drei Artikel aus einem internen Datenmodell. Die Tabelle ist keine verbindliche Händler-Vorlage; die Zulässigkeit eines Sets als Teil einer Variantengruppe wird separat geprüft.

ArtikelnummerVerkaufte AusführungBeispiel für den übertragenen Titel
DEMO-CHAIR-BLEin blauer StuhlSTUHL MIRA blau
DEMO-CHAIR-GREin grüner StuhlSTUHL MIRA grün
DEMO-CHAIR-BL-2SETZwei blaue StühleSTUHL MIRA blau 2er-Set

Wie du die Angaben aus Attributen ableitest und die Ausgaben kontrollierst, zeigt unser Leitfaden zu XXXLutz-Produkttiteln.

In fünf Schritten zum geprüften Listing

  1. Konto und Kategorie festlegen. Wähle den vorgesehenen Marketplace-Prozess und eine überschaubare Produktgruppe für den Start.
  2. Aktuelle Vorlage bereitstellen. Stimme die Kategorieanforderungen mit dem shopvibes-Team ab und richte den Partnerzugang ein.
  3. Mapping kontrollieren. Ordne Attribute und Werte zu. Prüfe Titel, Produktmaße, Lieferumfang und Medien je Ausführung.
  4. Unterschiedliche Testartikel übertragen. Nimm beispielsweise beide Farbvarianten eines Stuhls und einen eigenen Setartikel auf, sofern er zum Sortiment gehört.
  5. Rückmeldungen und Freigabe prüfen. Bearbeite Hinweise an Produktdaten oder Mapping und kontrolliere den Stand im Händlerprozess.

Was bedeutet eine erfolgreiche Übermittlung?

Nach der Übermittlung sieht die shopvibes-Anleitung zunächst eine automatische Datenprüfung und anschließend eine manuelle Prüfung durch das XXXLutz-Team vor. Eine angenommene Übertragung bedeutet deshalb noch keine sofortige Veröffentlichung. Plane eine eigene Kontrolle nach der Händlerprüfung ein; eine feste Bearbeitungsdauer lässt sich daraus nicht ableiten.

BeobachtungWas du prüfen kannst
Varianten tragen denselben TitelWerden unterscheidende Werte aus der jeweiligen Ausführung verwendet?
Im Titel erscheint die Marke doppeltWird sie bereits im übertragenen Text mitgeschickt?
Ein Set wirkt wie ein EinzelartikelSind Stückzahl und Lieferumfang in Daten, Titel und Bildern nachvollziehbar?
Ein Wert wird abgelehntEntspricht die Ausgabe der aktuellen Kategorie und deren Werteliste?
Die Übertragung ist abgeschlossen, der Artikel noch nicht veröffentlichtLiegt eine offene Daten- oder Händlerprüfung vor?

Für die systematische Fehlersuche nutze den Mirakl-Leitfaden zu Vorlage, Werten und Mapping. Die Diagnosebeispiele dort sind Erklärungen, keine Originalmeldungen des Händlers.

Prüfliste für den nächsten Sortimentslauf

  • Sind Partnerkonto, Kategorie und Vorlagenstand geklärt?
  • Erkennen Käufer anhand des Titels die jeweilige Ausführung?
  • Stimmen Set-Angaben und tatsächlich verkaufter Lieferumfang überein?
  • Zeigen die Medien den zutreffenden Artikel?
  • Wurden offene Hinweise korrigiert und der Händlerstatus geprüft?
  • Ist der Umfang späterer Inhalts-, Preis- und Bestandsupdates ausdrücklich vereinbart?

Die Möbel-Lösung erklärt die gemeinsame Datenbasis für mehrere Kanäle. Unser Template-Leitfaden zeigt das Prinzip wiederverwendbarer Zuordnungen.

Quellen und Prüfstand

Stand: 3. November 2026.

Suchst du den XXXLutz-Lieferantenprozess?

Die XXXLutz-Übersicht mit Auswahl des Anbindungswegs erklärt, wie du die passende Anleitung findest. Für die automatische Befüllung des Lieferantenportals nutze die XXXLutz-Frontend-Integration.

Deine Produktdaten für XXXLutz Marketplace

Bring deine Partneranforderungen mit. In der Demo besprechen wir den passenden Datenprozess für dein Sortiment.