JTL eazyAuction Kaufland-Anbindung — Einrichtungsmaske mit API-Credentials und Länderselektion

JTL Kaufland anbinden: Einrichtung, 7 Länder, häufige Fehler und wie du sie löst

Kaufland hat sich vom Discounter zum ernsthaften Marktplatz entwickelt. Über den Kaufland Global Marketplace verkaufst du in sieben Ländern: Deutschland, Österreich, Tschechien, Slowakei, Polen, Frankreich und Italien. Alles läuft über ein einziges Händlerkonto. Die Anbindung an JTL läuft nativ über eazyAuction und ist ab der Start-Edition enthalten. Klingt einfach. Ist es auch, wenn man die drei häufigsten Stolperfallen kennt. Wer sie nicht kennt, sitzt nach dem ersten Abgleich fest und sieht keinen einzigen Artikel live.

Du hast eazyAuction eingerichtet, der Abgleich läuft durch — und trotzdem erscheinen keine Artikel auf Kaufland?

Wir zeigen dir den vollständigen Einrichtungsweg und erklären, warum Bildnamen, die Multishop-Lizenz und stille 0/1-Fehler die drei Punkte sind, an denen fast jeder Händler beim ersten Versuch hängenbleibt.

Auf einen Blick

  • ✓Vlarom-Erkenntnis aus der Praxis: Die häufigste Ursache für fehlende Artikel auf Kaufland ist kein Konfigurationsfehler in eazyAuction, sondern ein nicht konformer Bildname im Artikelstamm (Ticket WAWI-64147).
  • ✓Kaufland Global Marketplace deckt 7 Länder über ein Händlerkonto ab. Die Anbindung läuft nativ via JTL-eazyAuction, das ab JTL Start enthalten ist.
  • ✓Wer bereits einen JTL-Shop als Kanal aktiv hat und Kaufland hinzufügt, braucht in den meisten Fällen eine Multishop 2.0 Lizenz. Das überrascht viele Händler im falschen Moment.

Vlarom ist JTL Service Partner Gold und richtet Kaufland-Anbindungen regelmäßig ein. Die technische Konfiguration in eazyAuction ist schnell gemacht. Was danach Zeit kostet, ist die Fehlersuche, wenn der erste Abgleich durchläuft und trotzdem kein Artikel live geht. Wer die drei typischen Fehlerquellen vorher kennt, spart sich genau diesen Schritt.

Was hinter Kaufland Global Marketplace steckt — die Zahlen

Kaufland ist seit 2019 als Marktplatz aktiv (Quelle: Kaufland Global Marketplace, kaufland.de) und hat sich seitdem in mehrere europäische Länder ausgedehnt. Für JTL-Händler ist das relevant, weil ein einziges Händlerkonto ausreicht, um alle sieben Länderinstanzen zu bespielen. Die Reichweite ist real, die Einrichtungshürde überschaubar, wenn man weiß worauf man achtet. Kaufland nutzt EAN-Matching: Bei bekannten Produkten wird dein Angebot automatisch der bestehenden Produktseite zugeordnet. Das spart Datenpflege, setzt aber saubere EANs in JTL-Wawi voraus.

Quelle Vlarom-Projektdaten: In unseren Kaufland-Einrichtungsprojekten tritt der Bildname-Fehler (WAWI-64147) bei über der Hälfte aller Erstanbindungen auf. Der Grund ist banal: Bilder in JTL-Wawi werden üblicherweise mit Leerzeichen oder Umlauten benannt, und Kaufland lehnt genau das ab.

Die wichtigsten Eckdaten zur Kaufland-Anbindung via JTL:

  • →7 Länder, 1 Konto: DE, AT, CZ, SK, PL, FR und IT sind über den Kaufland Global Marketplace erreichbar. Du schaltest Länder pro Artikel frei. Alles läuft über dasselbe Händlerkonto.
  • →Nativ ab JTL Start: eazyAuction ist seit dem 01.09.2024 im JTL-Start-Paket enthalten. Kaufland zählt als separate Kanal-Lizenz im JTL-Kundencenter und kostet keine Zusatzgebühr, wenn du eazyAuction schon nutzt.
  • →EAN-Matching: Kaufland gleicht Artikel automatisch über EAN/GTIN ab. Produkte ohne EAN landen nicht auf bestehenden Produktseiten, sondern müssen als neue Produkte vollständig angelegt werden. Das ist deutlich aufwendiger.
  • →Multishop 2.0 Pflicht: Wenn bereits ein JTL-Shop als Kanal aktiv ist, zählt Kaufland als zweiter Kanal. Das löst die Multishop-2.0-Pflicht aus, unabhängig davon ob du einen zweiten physischen Shop betreibst oder nicht.

Die Einrichtung ist technisch kein großes Projekt. Das eigentliche Risiko liegt im Datenstamm. Bilder, EANs und Pflichtfelder müssen sauber sein, bevor der erste Abgleich startet. Wer das vorab prüft, hat beim Go-Live keine bösen Überraschungen.

Warum die Einrichtung trotzdem hängt — die zwei Hauptursachen

Fast alle Kaufland-Einrichtungsprobleme, die wir sehen, lassen sich auf zwei Bereiche zurückführen: Datenstamm-Qualität und Lizenz-Konfiguration. Beide sind lösbar. Beide tauchen bei der ersten Anbindung regelmäßig auf.

1

Bildnamen mit Sonderzeichen

Kaufland akzeptiert für Produktbilder ausschließlich Dateinamen nach dem Muster ^[A-z\d\-]+.(png|jpg|gif). Das heißt: nur Buchstaben, Ziffern und Bindestriche. Kein Leerzeichen, kein Umlaut, kein Unterstrich.

Bilder, die direkt aus Lieferanten-Daten oder vom Windows-Desktop kommen, haben fast immer problematische Namen. Der Abgleich läuft scheinbar sauber durch, der Artikel landet aber nie auf Kaufland. Im eazyAuction-Logbuch steht dann: ‚offerList[x].mainPicture: Picture filename must match the following pattern‘. Quelle: Ticket WAWI-64147.

2

Multishop-Lizenz nicht gebucht

Wer bereits einen JTL-Shop als Kanal in eazyAuction aktiv hat und Kaufland hinzufügen will, bekommt die Fehlermeldung: ‚Sie müssen eine Multishop 2.0 Lizenz besitzen, um mehr als einen Shop anzubinden.‘

Das ist für viele Händler nicht intuitiv, weil Kaufland kein ‚Shop‘ im eigentlichen Sinn ist. JTL behandelt aber jeden Verkaufskanal (JTL-Shop, Kaufland, OTTO usw.) gleichwertig im Lizenzmodell. Die Lösung: Multishop 2.0 im JTL-Kundencenter hinzubuchen. Mehr zur grundsätzlichen Einrichtung von JTL-Wawi findest du unter JTL-Wawi einrichten. Wer ausschließlich Kaufland ohne eigenen JTL-Shop nutzt, hat dieses Problem nicht.

Was du mit einer sauberen Kaufland-Anbindung gewinnst

Europaweite Reichweite ohne Mehraufwand

Mit einer einzigen Anbindung erreichst du Käufer in sieben Ländern. Die Preis- und Bestandspflege läuft zentral über JTL-Wawi. Du pflegst deinen Artikelstamm einmal und steuerst per Kanal-Einstellung, welche Länder aktiv sind. Wer das sauber eingerichtet hat, braucht keine separate Datenpflege pro Land. Einen Überblick über alle Marktplatz-Anbindungen via JTL findest du in unserem Marktplatz-Anbindungs-Überblick.

EAN-Matching spart Kategorisierungsarbeit

Bei bekannten Markenprodukten ordnet Kaufland dein Angebot automatisch der richtigen Produktseite zu. Das heißt: keine manuelle Kategorisierung, keine eigene Produktseite anlegen, direkter Einstieg in eine bestehende Käufer-Nachfrage. Voraussetzung ist eine saubere EAN in JTL-Wawi für jeden Artikel.

Die Lektion

Vlarom-Erkenntnis aus der Praxis: Der Kaufland-Kanal bringt am schnellsten Ergebnisse bei Händlern, die bereits einen sauberen Artikelstamm mit vollständigen EANs haben. Wer die Bildnamen vor dem ersten Abgleich bereinigt, geht ohne Fehlersuche live.

JTL Kaufland anbinden in 5 Schritten

Dieser Plan basiert auf unseren Kaufland-Einrichtungsprojekten. Die Reihenfolge ist wichtig: Erst Datenstamm prüfen, dann Lizenz klären, dann Credentials eintragen. Wer den Datenstamm überspringt und direkt konfiguriert, verliert nach dem ersten Abgleich Zeit mit Fehlersuche.

Datenstamm prüfen (vor der Einrichtung)

„Prüfe alle Produktbilder auf konforme Dateinamen: nur Buchstaben, Ziffern, Bindestriche. Kein Leerzeichen, kein Umlaut. Außerdem: EAN/GTIN bei jedem Kaufland-Artikel vorhanden? Bestand > 0? Preis gesetzt? Das sind die Pflichtfelder. Ohne sie erscheint kein Artikel. Dieser Schritt klingt trivial und ist trotzdem der häufigste Grund, warum die erste Anbindung scheitert.“

Lizenz im JTL-Kundencenter klären (vor der Einrichtung)

„Prüfe im JTL-Kundencenter unter Lizenzübersicht, wie viele Kanäle aktiv sind. Hast du bereits einen JTL-Shop als Kanal? Dann brauchst du die Multishop 2.0 Lizenz. Wenn nicht, reicht die Standard-eazyAuction-Lizenz. Diesen Punkt vorher zu klären spart den Frust einer Fehlermeldung mitten in der Einrichtung. Weitere Details zur Lizenzstruktur findest du in der offiziellen JTL-eazyAuction-Dokumentation.“

API-Credentials aus dem Kaufland-Händlerportal holen (Schritt 1 in eazyAuction)

„Melde dich im Kaufland-Händlerportal an. Unter Einstellungen > API findest du deinen Client-Key und Secret. Kopiere beide Werte direkt von dort. Manuelle Eingabe mit Tippfehlern ist ein häufiger Stolperstein. In eazyAuction gehst du dann zu Plattformen > Kaufland > Neuen Kanal anlegen und trägst die Credentials dort ein. Nach dem Speichern führt eazyAuction einen Verbindungstest durch.“

Verkaufskanalverwaltung konfigurieren (Schritt 2 in eazyAuction)

„Nach erfolgreicher Verbindung legst du unter Verkaufskanalverwaltung die DotLiquid-Felder für Kaufland fest: Titel, Beschreibung, Preis, Bestand, Kategorie, Versandprofil. Kaufland hat pro Kategorie spezifische Pflichtfelder. Prüfe die Kaufland-FAQ im JTL-Guide für die aktuellen Anforderungen. Teste die Konfiguration mit 2-3 Artikeln, bevor du alle Produkte hochlädst.“

Ersten Abgleich mit Fehleranalyse starten (Schritt 3 in eazyAuction)

„Starte den Abgleich und prüfe danach sofort das Logbuch in eazyAuction mit Filter ‚Fehler‘. Zeigt der Zähler ‚(0/1)‘ oder eine ungewöhnlich niedrige Zahl, liegt ein stiller Fehler vor. Typische Ursachen: Bildname nicht konform, Pflichtfeld leer, DotLiquid-Feld nicht gemappt. Mit dem Filter ‚Mit Fehlern‘ im Abgleich-Dialog siehst du die betroffenen Artikel direkt. Erst wenn die ersten 5-10 Testartikel sauber live gehen, lohnt sich der Massendurchlauf.“

Häufige Fragen zur JTL-Kaufland-Anbindung

Brauche ich für Kaufland eine separate Lizenz in JTL?

Nein. Kaufland läuft als Kanal über eazyAuction, und eazyAuction ist seit dem 01.09.2024 im JTL-Start-Paket enthalten. Was du aber brauchst, wenn du bereits einen JTL-Shop als aktiven Kanal hast: die Multishop 2.0 Lizenz. Ohne sie blockiert das System die zweite Kanal-Anlage. Prüfe das im JTL-Kundencenter unter Lizenzübersicht, bevor du mit der Einrichtung beginnst.

Kaufland Global Marketplace deckt 7 Länder ab (DE, AT, CZ, SK, PL, FR, IT), alle über ein Händlerkonto. Du richtest in eazyAuction einen Kanal ein und steuerst die Länder-Freigabe pro Artikel oder als globale Kanaleinstellung. Separate Kanäle pro Land sind nicht nötig. Preise kannst du länderspezifisch hinterlegen oder einen einheitlichen Preis pro Kaufland-Kanal setzen.

Der häufigste Grund ist ein nicht konformer Bildname. Kaufland erlaubt ausschließlich Buchstaben, Ziffern und Bindestriche im Dateinamen. Kein Leerzeichen, kein Umlaut, kein Sonderzeichen. Der Abgleich läuft trotzdem durch und gibt keinen deutlichen Fehler aus. Prüfe im eazyAuction-Logbuch mit dem Filter ‚Fehler‘, ob dort ‚mainPicture: Picture filename must match the following pattern‘ steht. Weitere mögliche Ursachen: fehlende EAN, Bestand 0, Preis nicht gesetzt oder DotLiquid-Felder nicht konfiguriert.

Kaufland prüft beim Upload, ob die EAN deines Artikels bereits auf der Plattform existiert. Wenn ja, wird dein Angebot automatisch der bestehenden Produktseite zugeordnet. Das nennt sich EAN-Matching. Du profitierst von vorhandenen Produktfotos und Beschreibungen und brauchst diese nicht selbst zu pflegen. Gibt es keine passende EAN auf Kaufland, musst du die komplette Produktseite selbst befüllen, inklusive aller Pflichtfelder und Bilder.

Das 0/1-Muster bedeutet: eazyAuction hat versucht, den Artikel hochzuladen, Kaufland hat ihn abgelehnt, aber keine ausführliche Fehlermeldung zurückgegeben. Das passiert typischerweise bei fehlenden Pflichtfeldern oder nicht konformen Bildnamen. Öffne das Logbuch in eazyAuction, setze den Filter auf ‚Fehler‘ und starte den Abgleich erneut mit der Option ‚Mit Fehlern anzeigen‘. Für ein systematisches Debugging prüfe zuerst Bild-Dateinamen, dann EAN, dann DotLiquid-Felder.

Ja. Wer nur über eazyAuction auf Kaufland verkauft und keinen eigenen JTL-Shop als Kanal aktiviert hat, braucht keine Multishop 2.0 Lizenz. Die Multishop-Pflicht entsteht erst, wenn du zwei oder mehr Kanäle kombinierst, zum Beispiel JTL-Shop plus Kaufland. Wer ausschließlich Kaufland nutzt (und ggf. Amazon oder eBay), bleibt im Standard-Lizenzrahmen von eazyAuction.

Die reine technische Einrichtung in eazyAuction ist überschaubar: API-Credentials holen, Kanal anlegen, DotLiquid-Felder konfigurieren, ersten Test-Abgleich starten. Die Gesamtzeit hängt davon ab, wie sauber dein Artikelstamm ist. Wenn Bildnamen bereinigt werden müssen oder EANs fehlen, ist das oft der größere Aufwand. Eine konkrete Einschätzung ergibt sich aus der Anzahl der Artikel, dem Zustand des Datenstamms und der vorhandenen Kanal-Konfiguration. Wir klären das im Erstgespräch.

Kaufland anbinden ohne Fehlersuche. Wir übernehmen Einrichtung und Datenstamm-Check.

Mit Vlarom die Kaufland-Anbindung sauber aufsetzen.

Als JTL Service Partner Gold richten wir Kaufland-Anbindungen regelmäßig ein und kennen die typischen Fehlerquellen. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für eine unverbindliche Einschätzung deiner Situation.