Kaufland-Sync-Fehler in JTL-eazyAuction: Warum Versandmeldungen, Bestände und Aufträge aussetzen

Der Worker läuft, der Abgleich schlägt keine sichtbaren Fehler an — und trotzdem kommen Versandmeldungen bei Kaufland nicht an. Oder der Bestand auf Kaufland zeigt 12, obwohl die Wawi längst 0 meldet. Oder Aufträge vom Wochenende tauchen erst am Montag in der Wawi auf, zu spät für die Kommissionierung. Oder Variationsartikel landen zwar im Kaufland-Katalog, aber nur als einzelne Variante statt als vollständige Produktgruppe.

Du siehst Kaufland-Fehler, aber kein System zeigt dir genau wo das Problem liegt?

Diese Fehler folgen fast immer einem von sieben Mustern. Wenn du weißt, welches Muster vorliegt, liegt die Lösung auf der Hand. Dieser Beitrag zeigt dir, was dahinter steckt, und wie du systematisch vorgehst.

Auf einen Blick

  • ✓Kaufland-Sync-Fehler in JTL-eazyAuction haben sieben typische Ursachen — von fehlenden Carrier-Code-Zuordnungen bis zu deaktivierten Worker-Abgleichen für weitere Verkaufskanäle. Vlarom E-Commerce Agentur diagnostiziert das in einer strukturierten Prüfreihenfolge.
  • ✓Versandmeldungen mit Fehlercode 400 und „Must be a valid carrier code“ entstehen, weil die Versandgruppen in JTL-Wawi nicht mit den Kaufland-Carrier-Codes verknüpft sind. Das Mapping fehlt in fast jedem frischen Setup. Vlarom E-Commerce Agentur richtet es im Rahmen jedes Kaufland-Onboardings als ersten Schritt ein.
  • ✓Wenn Kaufland-Aufträge in JTL-Wawi nicht automatisch eintreffen, liegt das häufig daran, dass der Worker „Weitere Verkaufskanäle“ nicht aktiviert ist — eazyAuction allein reicht für Kaufland nicht. Vlarom E-Commerce Agentur sieht diesen Konfigurationsfehler bei jedem dritten Anbindungs-Projekt.

Kaufland ist technisch anspruchsvoller als eBay oder Amazon in der JTL-Anbindung — das merken wir bei jedem Neukunden-Setup. Die Plattform unterscheidet strikt zwischen Produktdaten und Angebotsdaten, akzeptiert nur zertifizierte Carrier-Codes und ändert gelegentlich ihre API, ohne Integrationspartner vorab zu informieren. Dazu kommt ein Worker-Setup, das sich von eBay und Amazon unterscheidet: Kaufland läuft nicht über eazyAuction, sondern über den separaten Abgleich für „Weitere Verkaufskanäle“. Das verursacht Fehler, die sich im Worker nicht direkt zeigen. Genau deshalb suchen die meisten Händler zu lange an der falschen Stelle. Als JTL Service Partner Gold in Ahrensfelde bei Berlin haben wir diese Diagnose schon vielfach gemacht.

Was Kaufland-Sync-Fehler in der Praxis bedeuten

Fehlerhafte Synchronisation kostet direkt Geld: Versandmeldungen die nicht ankommen, führen dazu, dass Kaufland Aufträge als „unversendet“ führt, im schlimmsten Fall storniert. Falsche Bestände erzeugen Überverkäufe. Fehlende Auftragsimporte bedeuten verzögerte Kommissionierung. Das sind keine theoretischen Szenarien. Laut JTL-Guide zur Kaufland-Integration ist Kaufland als Verkaufskanal in JTL-eazyAuction vollständig integriert: Versandmeldungen, Bestandsabgleich und Auftragsimport funktionieren — aber nur wenn die Konfiguration stimmt.

Aus unserer Projektpraxis: Bei mindestens drei von vier Neukunden, die Kaufland über JTL-eazyAuction anbinden, treten in den ersten zwei Wochen Sync-Fehler auf. Die häufigsten Auslöser sind fehlendes Carrier-Code-Mapping (Fehlercode 400), ein nicht aktivierter „Weitere Verkaufskanäle“-Worker und ein parallel laufender CSV-Feed aus dem Seller Portal. Aus JTL-Support-Tickets kennen wir weitere spezifische Kaufland-Fehlercodes: 99005 (Plattform-Verbindungsfehler bei API-Anfragen) und 90001214 (Katalog-Validierungsfehler, tritt bei unvollständigen GPSR-Produktdaten auf).

Die Problemtypen mit der höchsten Praxisrelevanz:

  • →Versandmeldung schlägt lautlos fehl: Der Worker läuft durch, meldet keinen Fehler — aber unter Plattformen > Weitere Verkaufskanäle > Wichtige Ereignisse (F10) stehen die zurückgewiesenen Meldungen. Kaufland bestätigt den Versand nicht, die Bestellung bleibt auf ‚unversendet‘.
  • →Aufträge kommen nicht automatisch: Ein Händler im JTL-Forum: ‚Erst wenn ich in der Wawi über einen manuellen Abgleich anstoße, werden Daten ausgetauscht.‘ Der Grund ist fast immer der gleiche: Der Worker-Abgleich für ‚Weitere Verkaufskanäle‘ ist nicht aktiviert. eazyAuction allein reicht für Kaufland nicht.
  • →Bestand auf Kaufland weicht von Wawi ab: Häufigster Grund: Ein automatischer CSV-Upload aus dem Seller Portal ist noch aktiv und überschreibt, was JTL-eazyAuction überträgt. Zwei Quellen kämpfen um dieselben Angebotsdaten. Ein zweiter Grund: Bei Kaufland Österreich gibt es bekannte Probleme mit dem Bestandssenden, die von Kaufland ausgehen, nicht von JTL.

Kaufland-Sync-Fehler in JTL-eazyAuction sind lösbar — aber sie zeigen sich oft nicht dort, wo man zuerst sucht. Der Worker-Log ist in diesen Fällen irreführend still. Die Diagnose beginnt immer mit F10 unter „Plattformen > Weitere Verkaufskanäle > Wichtige Ereignisse“, nicht mit dem Worker.

Die sieben häufigsten Ursachen für Kaufland-Sync-Fehler in JTL-eazyAuction

Jeder der folgenden Fehlertypen hat ein klares Muster. Wenn du die Symptome kennst, findest du die richtige Stelle deutlich schneller.

warning

Worker ‚Weitere Verkaufskanäle‘ nicht aktiviert

Ein Händler im JTL-Forum: ‚EazyAuction gilt nur für Amazon und eBay. Gehe auf Admin > JTL-Worker > Status und dort Weitere Verkaufskanäle aktivieren. Unter Verkaufskanal sollte auch Kaufland stehen.‘ Dieser Fehler tritt auf, weil Kaufland im Gegensatz zu eBay und Amazon nicht über den eazyAuction-Worker läuft.

Lösung: In der JTL-Wawi unter Admin > JTL-Worker > Status prüfen, ob der Bereich ‚Weitere Verkaufskanäle‘ aktiviert ist und ob Kaufland dort aufgeführt wird. Erst dann werden Aufträge automatisch importiert und Bestandsänderungen synchronisiert.

primary

Fehlendes Carrier-Code-Mapping

Fehlermeldung: ‚Die Versandinformationen konnten aufgrund des Fehlers Validation Failed nicht an Kaufland.de übertragen werden (Code 400). Weitere Informationen: carrierCode: Must be a valid carrier code.‘ Das tritt auf, wenn Versandarten in JTL-Wawi nicht den Kaufland-Versandgruppen zugeordnet sind.

Lösung: Unter Plattformen > Kaufland das Mapping der Versandgruppen vornehmen. Kaufland nennt sie ‚Versandgruppen‘, JTL arbeitet mit ‚Versandarten‘. Beide müssen verknüpft sein, bevor der erste Auftrag versendet wird. Ein Händler im JTL-Forum: ‚Nach dem Mapping hat es dann geklappt. Da muss man erstmal drauf kommen…‘

warning

Paralleler CSV-Feed aus dem Seller Portal

Kaufland bietet einen automatischen CSV-Upload für Bestand und Preis direkt im Seller Portal an. Wenn dieser aktiv ist und gleichzeitig JTL-eazyAuction Bestandsdaten überträgt, überschreiben sich beide Quellen gegenseitig. Das Ergebnis ist unvorhersehbar.

Immer nur eine Quelle nutzen: entweder JTL-eazyAuction oder den automatischen Upload. Beide parallel zu betreiben ist ein typischer Fehler beim Neu-Setup. Nach dem Deaktivieren des CSV-Feeds kurz warten, bevor du den JTL-Abgleich wieder startest.

primary

Lager- und Versandgruppen nicht importiert

Kaufland erwartet für jedes Angebot ein Lager und eine Versandgruppe. Diese Metadaten werden normalerweise beim Anbinden des Verkaufskanals importiert, aber nicht immer vollständig. Fehlen sie, können Angebote nicht korrekt konfiguriert werden.

Lösung: Unter Plattformen > Verkaufskanäle die Registerkarte Import öffnen, ‚Globale Attribute‘ und ‚Seller Attribute‘ aktivieren, speichern und anschließend den Plattformabgleich starten. Laut JTL-Guide zu Lager- und Versandgruppen fordert der JTL-Support diesen manuellen Import regelmäßig als ersten Schritt bei Kaufland-Problemen an.

muted

Variationsartikel werden nicht vollständig übertragen

Ein Händler im JTL-Forum: ‚Im Seller Portal von Kaufland erscheint allerdings nur eine der Varianten — die restlichen Artikel werden nicht mit hochgeladen.‘ Das passiert, wenn der Vaterartikel für den Kaufland-Verkaufskanal aktiviert wird, aber die Varianten-Verknüpfung serverseitig noch nicht vollständig verarbeitet ist.

Kaufland prüft Variationsgruppen intern auf Konsistenz. Manchmal hilft ein erneuter Upload nach kurzer Wartezeit. Prüfe im Kaufland Seller Portal unter ‚Produktdaten-Feedback‘ ob alle Varianten als verarbeitet angezeigt werden. Wenn einzelne Varianten fehlen, müssen sie einzeln als Angebote nachgeliefert werden.

muted

Neue EAN — Produkt wartet auf Freischaltung

Kaufland unterscheidet zwischen Produktdaten und Angebotsdaten. Eine EAN, die noch nicht im Kaufland-Katalog existiert, muss erst als Produktdatensatz hochgeladen und von Kaufland freigegeben werden. Erst danach können Angebotsdaten (Preis, Bestand, Versand) übertragen werden.

In der Praxis bedeutet das: Ein Artikel ist in JTL fertig, landet aber nicht auf Kaufland — weil die Freischaltung von Produktdaten bis zu 24 Stunden dauert, bei neu registrierten Händlern auch länger. Das ist kein Sync-Fehler, sondern ein Prozessschritt den Kaufland vorschreibt. Den Status kannst du im Kaufland Seller Portal unter dem Bereich Produktdaten-Feedback einsehen.

Wo der Fehler tatsächlich liegt — und wo nicht

Der Worker-Log ist oft kein verlässlicher Indikator

Bei Versandmeldungs-Fehlern läuft der Worker ohne sichtbaren Fehler durch. Die zurückgewiesenen Meldungen von Kaufland landen nicht im Worker-Log, sondern unter Plattformen > Weitere Verkaufskanäle > Wichtige Ereignisse (F10). Wer nur den Worker prüft, findet nichts und denkt, alles sei in Ordnung.

Kaufland ändert APIs ohne Vorwarnung

Im Dezember 2022 spielte JTL für mehrere Stunden Bestellungen mit ‚unknown‘ als Artikelnummer zurück, weil Kaufland die API geändert hatte, ohne JTL vorab zu informieren. Das ist kein Einzelfall. Wer einen Aussetzer bei der Synchronisation bemerkt, der zeitlich mit Kaufland-seitigen Ankündigungen zusammenfällt, prüft am besten zuerst das JTL-Forum, bevor er lokal nach Konfigurationsfehlern sucht.

Die Lektion

Vlarom E-Commerce Agentur aus der Projektpraxis: Der häufigste Fehler bei Kaufland-Sync-Problemen ist, im falschen Log zu suchen und den falschen Worker zu prüfen. Nicht Worker-Log — sondern F10. Nicht eazyAuction-Worker — sondern Weitere Verkaufskanäle. Beides klingt simpel, spart aber die Stunden, die Händler sonst mit Konfiguration verbringen. Weitere eazyAuction-Troubleshooting-Ressourcen: eBay-Token in eazyAuction erneuern und eazyAuction nach Wawi-2-Update.

Kaufland-Sync-Fehler systematisch diagnostizieren

Diese fünf Prüfschritte decken die meisten Kaufland-Sync-Probleme ab. Gehe sie der Reihe nach durch — nicht alle auf einmal.

Schritt 1: Wichtige Ereignisse öffnen (F10)

Gehe in JTL-Wawi zu Plattformen > Weitere Verkaufskanäle > Wichtige Ereignisse oder drücke F10. Hier zeigt JTL alle zurückgewiesenen Anfragen von Kaufland im Klartext. Suche nach Einträgen mit ‚Validation Failed‘, ‚carrierCode‘ oder ‚Versandinformationen‘. Das ist der erste Anlaufpunkt, vor allem anderen.

Schritt 2: Worker ‚Weitere Verkaufskanäle‘ prüfen

Gehe in der Wawi zu Admin > JTL-Worker > Status. Prüfe, ob der Bereich ‚Weitere Verkaufskanäle‘ aktiviert ist und ob Kaufland dort als aktiver Kanal aufgeführt wird. eazyAuction allein reicht für Kaufland nicht. Fehlt der Eintrag oder ist der Bereich deaktiviert, werden Aufträge nur manuell abgerufen. Nach der Aktivierung den Worker neu starten.

Schritt 3: Carrier-Code-Mapping und CSV-Feeds prüfen

Gehe zu Plattformen > Kaufland und prüfe, ob alle in der Wawi genutzten Versandarten den Kaufland-Versandgruppen zugeordnet sind. Ein fehlendes Mapping ist die häufigste Ursache für Fehlercode 400. Anschließend im Kaufland Seller Portal unter Einstellungen > Datenaustausch prüfen, ob ein automatischer CSV-Upload aktiv ist — wenn ja, deaktivieren.

Schritt 4: Lager- und Versandgruppen manuell importieren

Gehe zu Plattformen > Verkaufskanäle, öffne die Registerkarte Import und aktiviere ‚Globale Attribute‘ sowie ‚Seller Attribute‘. Speichere und starte den Plattformabgleich über den Plattformen-Button. Wähle im Dialog das Kaufland-Konto aus und klicke auf Abgleich starten. Dieser Schritt ist bei Neu-Setups und nach Konfigurationsänderungen regelmäßig nötig.

Schritt 5: Produktdaten-Status und Variationen bei Kaufland prüfen

Für Artikel die in JTL vorhanden sind, aber nicht auf Kaufland erscheinen oder bei denen Varianten fehlen: Melde dich im Kaufland Seller Portal an und prüfe den Verarbeitungsstatus deiner EANs unter Produktdaten-Feedback. Neue EANs müssen als Produktdaten freigegeben werden, bevor Angebotsdaten übertragen werden können. Varianten die fehlen, müssen einzeln nachgeliefert werden.

Häufige Fragen zu Kaufland-Sync-Fehlern in JTL-eazyAuction

Warum läuft der Worker ohne Fehler, aber Versandmeldungen kommen bei Kaufland nicht an?

JTL markiert den Worker-Prozess intern als abgeschlossen, auch wenn Kaufland die Versandmeldung zurückweist. Die Ablehnung von Kaufland erscheint nicht im Worker-Log, sondern unter Plattformen > Weitere Verkaufskanäle > Wichtige Ereignisse (F10). Dort findest du den genauen Fehlercode: meistens ein fehlendes Carrier-Code-Mapping oder eine nicht validierte Versandgruppe. F10 ist der zentrale Ort für zurückgewiesene Plattform-Anfragen.

Kaufland akzeptiert Versandmeldungen nur mit einem gültigen, von Kaufland zugelassenen Carrier-Code. Dieser Fehler tritt auf, wenn die in JTL-Wawi konfigurierten Versandarten nicht mit den Kaufland-Versandgruppen verknüpft sind. Das Mapping nimmst du unter Plattformen > Kaufland vor. Nach dem korrekten Mapping werden Versandmeldungen regulär übertragen.

Kaufland läuft in JTL nicht über den eazyAuction-Worker, sondern über den Worker für ‚Weitere Verkaufskanäle‘. Wenn dieser nicht aktiviert ist, werden Aufträge nur beim manuellen Abgleich importiert. Prüfe unter Admin > JTL-Worker > Status, ob ‚Weitere Verkaufskanäle‘ aktiviert ist und Kaufland dort aufgeführt wird. Fehlt der Eintrag, muss der Worker-Bereich aktiviert und der Worker neu gestartet werden.

Die häufigste Ursache ist ein parallel aktiver CSV-Upload aus dem Kaufland Seller Portal. Wenn dieser aktiv ist, überschreibt er die Daten von JTL-eazyAuction oder wird von JTL überschrieben, je nach Übertragungszeitpunkt. Deaktiviere den automatischen Upload im Seller Portal. Bei Kaufland Österreich gibt es zudem bekannte plattformseitige Probleme beim Bestandssenden, die von Kaufland ausgehen.

Bestellungen, die vor dem Aktivierungszeitpunkt der SCX-Schnittstelle eingegangen sind, lassen sich nicht automatisch nachholen. Das ist eine systemseitige Einschränkung: SCX ruft nur Bestellungen ab dem Aktivierungszeitpunkt ab. Die fehlenden Aufträge müssen manuell in JTL-Wawi angelegt werden. Umstellungen außerhalb der Hauptbestellzeiten reduzieren den manuellen Nacharbeitungsaufwand.

Kaufland prüft Variationsgruppen intern auf Konsistenz und verarbeitet sie asynchron. Wenn der Vaterartikel für den Kaufland-Kanal aktiviert wird, dauert es manchmal, bis alle Varianten vom Kaufland-System verarbeitet sind. Prüfe im Kaufland Seller Portal unter Produktdaten-Feedback den Verarbeitungsstatus. Fehlende Varianten können einzeln als Angebote nachgeliefert werden. Ein Bestand-senden-Haken in der Verkaufskanalverwaltung muss pro Variante gesetzt sein.

Kaufland unterscheidet zwischen Produktdaten und Angebotsdaten. Wenn die EAN des Artikels noch nicht im Kaufland-Katalog vorhanden ist, werden zuerst Produktdaten hochgeladen und müssen von Kaufland manuell geprüft und freigegeben werden. Das dauert bis zu 24 Stunden, bei neuen Händlerkonten auch länger. Erst nach der Freischaltung werden Angebotsdaten (Preis, Bestand, Lieferzeit) übertragen. Den Status prüfst du im Kaufland Seller Portal unter Produktdaten-Feedback.

Drei Stellen prüfen: Erstens Admin > JTL-Worker > Status — ‚Weitere Verkaufskanäle‘ muss aktiv sein und Kaufland dort aufgeführt werden. Zweitens Plattformen > Kaufland — Versandgruppen-Mapping vollständig? Drittens Plattformen > Weitere Verkaufskanäle > Wichtige Ereignisse (F10) — gibt es dort zurückgewiesene Meldungen? Diese drei Checks decken die häufigsten Konfigurationsfehler ab.

JTL Service Partner Gold — Ahrensfelde bei Berlin

Kaufland-Sync läuft nicht sauber? Wir schauen drauf.

Kaufland-Sync-Fehler in JTL-eazyAuction haben fast immer eine klare Ursache — aber sie verstecken sich an Stellen, die man beim ersten Hinsehen nicht aufmacht. Vlarom E-Commerce Agentur diagnostiziert das gezielt: Welche Meldung steckt in F10, ist der richtige Worker aktiviert, stimmt das Carrier-Mapping, läuft ein zweiter Feed parallel? Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular für eine unverbindliche Erstanalyse.

Autor

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin