JTL MediaMarktSaturn anbinden: Einrichtung, eazyAuction und die häufigsten Fehler mit Lösung

Auf einen Blick

• ✓MediaMarktSaturn läuft nativ über JTL-eazyAuction — keine separate SCX-Lizenz nötig. Die technische Basis ist Mirakl, das gleiche Plattformsystem das auch Conrad und Voelkner nutzen.
• ✓Die drei häufigsten Fehler: product-id-type falsch gesetzt (führt zu SKU-Zusammenführungsproblemen), GPSR-Felder werden abgelehnt (Feld Manufacturer Is EU Established wird nicht per DotLiquid befüllt), und veraltete Mirakl-API-Route bei Bestandsmeldungen. Ticket EA-6539 im JTL Issue-Tracker dokumentiert den API-Routen-Bug — inzwischen per Update behoben.
• ✓Wawi mindestens Version 2.0 ist Pflicht für vollständige GPSR-Übertragung an MMS. Ältere Versionen übertragen die GPSR-Pflichtfelder nicht korrekt.

Wir sind Vlarom, JTL Service Partner Gold mit Standort in Ahrensfelde bei Berlin (Quelle: JTL-Software Partnerverzeichnis). Inhaber Alexander Luft betreut Händler bei der Anbindung an MediaMarktSaturn und andere Mirakl-Marktplätze. MMS gehört zu den technisch fordernderen Anbindungen im JTL-Ökosystem — nicht wegen der API selbst, sondern wegen der Qualitätsanforderungen an Produktdaten, Kategorisierung und GPSR. Fehler zeigen sich oft erst nach den ersten Abgleichen.

MediaMarktSaturn betreibt den Marktplatz auf Mirakl. Gleiche technische Basis wie Conrad und Voelkner. Die Einrichtung läuft komplett über eazyAuction, direkt in JTL-Wawi integriert. Eine separate SCX-Lizenz brauchst du nicht. Offizielle Dokumentation: MediaMarktSaturn auf guide.jtl-software.com.

Aus unserer Projektpraxis: MMS-Anbindungen scheitern selten an der Verbindung selbst. Der Fehler liegt fast immer in der Datenqualität. Fehlende EAN, unvollständige GPSR-Daten oder ein product-id-type der nicht zur Sortimentsstruktur passt. Wer das vor der ersten Synchronisation klärt, spart sich viel Fehlersuche. (Alexander Luft, Vlarom — JTL Service Partner Gold, Ahrensfelde bei Berlin)

Das sind die wichtigsten technischen Grundlagen für die MMS-Anbindung:

• →Mirakl-Plattform — gleiche Basis wie Conrad und Voelkner: MediaMarktSaturn nutzt Mirakl als Marktplatz-Infrastruktur. Das bedeutet: gleiche API-Route, ähnliche Fehlerbilder, gleiche Anforderungen an strukturierte Produktdaten. Wer Conrad oder Voelkner bereits angebunden hat, kann seine Erfahrungen direkt übertragen.
• →product-id-type ist konfigurierbar: Seit Wawi 1.9.x kannst du den product-id-type selbst festlegen statt auf die automatische SKU-Vergabe zu vertrauen. Laut JTL-Issue-Tracker hat sich für MMS bewährt: product-id-type auf EAN setzen und zu jeder SKU genau eine EAN hinterlegen. Ticket EA-7108 (JTL Issue-Tracker) dokumentiert diesen Bug — er tritt auf wenn mehrere SKUs dieselbe oder keine EAN tragen, weil MMS sie dann fälschlich zusammenführt.
• →GPSR ab Wawi 2.0 vollständig übertragbar: Produktsicherheitsdaten (GPSR) lassen sich erst ab Wawi 2.0 vollständig an MMS übermitteln. Besonders kritisch ist das Feld Manufacturer Is EU Established. Es wird nicht per DotLiquid befüllt, sondern direkt als Dropdown-Wert Ja oder Nein gesetzt. Anleitung: [GPSR an MediaMarktSaturn übermitteln](https://guide.jtl-software.com/jtl-eazyauction/verkaufskanalspezifische-informationen/produktsicherheitsdaten-gpsr-an-mediamarktsaturn-uebermitteln/).
• →Sehr hohe Kategorisierungsanforderungen: MMS verlangt präzise Kategorie-Zuordnungen und vollständige Pflichtattribute pro Kategorie. Ein Artikel der bei Amazon mit minimalen Daten durchläuft, wird bei MMS abgelehnt sobald Pflichtfelder fehlen. Vor der ersten Synchronisation immer das Kategorie-Mapping vollständig prüfen.

Ein häufig übersehenes Problem: MMS kann durch hohe Event-Mengen andere SCX-Kanäle blockieren. Wenn nach der MMS-Anbindung plötzlich Bestellungen von anderen Marktplätzen fehlen, den MMS-Kanal vorübergehend deaktivieren und das SCX-Protokoll im JTL-Kundencenter prüfen.

Diese drei Fehler tauchen in Kundenprojekten und im JTL-Forum immer wieder auf. Wir haben die Lösungswege zusammengefasst.

1

product-id-type falsch gesetzt — SKU-Zusammenführungsproblem

Symptom: MMS führt mehrere SKUs zusammen obwohl es eigenständige Artikel sind. Angebote verlieren ihre Produktzuordnung. Das zeigt sich oft erst nach dem zweiten oder dritten Abgleich.

Ursache: Der automatisch vergebene product-id-type passt nicht zur eigenen Artikelstruktur. Lösung: In Verkaufskanal MMS unter Globale Felder den product-id-type manuell auf EAN setzen. Zu jeder SKU genau eine eindeutige EAN hinterlegen. Ticket EA-7108 (JTL Issue-Tracker) beschreibt den Bug: MMS erkennt Artikel ohne oder mit nicht-eindeutiger EAN als Dubletten und führt sie zusammen. Betroffen sind vor allem Händler die mit Sammel-EANs oder ganz ohne EAN arbeiten.

2

GPSR-Daten werden von MMS abgelehnt — Manufacturer Is EU Established falsch

Symptom: MMS-Abgleich schlägt bei GPSR-Pflichtfeldern fehl. Insbesondere Manufacturer Is EU Established wird nicht korrekt übermittelt. Artikel werden nicht aktiviert oder mit GPSR-Fehler zurückgewiesen.

Ursache: Das Feld Manufacturer Is EU Established nimmt keine DotLiquid-Variable an. Es erwartet den festen Dropdown-Wert Ja oder Nein direkt. Lösung: In den Artikelstammdaten für jeden Hersteller prüfen ob er EU-ansässig ist. Wert direkt setzen, keine Variable verwenden. Bei Herstellern ohne EU-Sitz individuelle Ausnahme in den Stammdaten hinterlegen. Pflicht: Wawi mindestens Version 2.0. Anleitung: GPSR an MMS übermitteln.

Nativ in eazyAuction — keine Extra-Lizenz

MMS ist direkt in JTL-eazyAuction integriert. Keine separate SCX-Lizenz, keine Drittanbieter-Software. Wer eazyAuction schon für Amazon oder eBay nutzt, richtet MMS in der gleichen Oberfläche ein. Das spart Lizenzkosten und macht die Einrichtung übersichtlicher.

EAN-basierte Zuordnung funktioniert zuverlässig

Sobald product-id-type auf EAN gesetzt und sauber gepflegt ist, läuft der Abgleich stabil. Bestandsaktualisierungen, Preisänderungen und Auftragsimport laufen im Regelbetrieb ohne manuelle Eingriffe. Ein Händler im JTL-Forum, der regelmäßig Tech-Zubehör über MMS verkauft, berichtete: nach dem EAN-Fix traten keine weiteren Abgleichprobleme mehr auf. (Quelle: JTL-Community-Forum, anonymisiert)

So gehen wir bei Vlarom die MMS-Anbindung in Kundenprojekten an. Kein Schritt-für-Schritt-Tutorial das jeden Klick beschreibt, sondern eine Übersicht der Phasen und worauf es ankommt.

„Wawi mindestens Version 2.0 für vollständige GPSR-Übertragung. eazyAuction in aktueller Version. MMS-Händlerkonto vorhanden und genehmigt. MMS nimmt nicht jeden Händler auf, sondern prüft Sortiment und Qualität. Ohne aktives Händlerkonto keine Anbindung möglich.“

„Vor der Einrichtung: EAN für alle Artikel prüfen und vervollständigen. GPSR-Pflichtdaten in den Artikelstammdaten eintragen (Hersteller, Verantwortliche Person, EU-Ansässigkeit). Kategorie-Mapping mit MMS-Kategoriebaum abgleichen. Das ist der aufwändigste Schritt. Er bestimmt die Qualität aller späteren Abgleiche.“

„Verkaufskanal MMS in eazyAuction anlegen. product-id-type auf EAN setzen. MMS-Zugangsdaten hinterlegen. Erste Test-Synchronisation mit einem kleinen Artikel-Set (5 bis 10 Artikel) durchführen, bevor das gesamte Sortiment hochgeladen wird. Offizielle Dokumentation: MediaMarktSaturn-Marktplatz auf guide.jtl-software.com.“

„Nach dem ersten Abgleich: SCX-Protokoll im JTL-Kundencenter prüfen, nicht nur das lokale Log. Angebote im MMS-Backend prüfen ob EAN-Zuordnungen korrekt sind. GPSR-Status für Pflichtartikel kontrollieren. Erst nach sauberem Pilot das gesamte Sortiment freigeben.“

„Im Regelbetrieb eazyAuction-Updates zeitnah einspielen — Mirakl-API-Änderungen werden regelmäßig ausgeliefert. Bei Abgleichfehlern zuerst das SCX-Protokoll prüfen. MMS-Kanal im OPC-Dashboard beobachten. Hohe Event-Zahlen können andere SCX-Kanäle blockieren.“