JTL-eazyAuction mit JTL-Wawi 2: Kompatibilitätsprobleme erkennen, einkreisen und lösen

Auf einen Blick

• ✓Nach dem Update auf JTL-Wawi 2 greifen viele eazyAuction-Konfigurationen nicht mehr, weil Wawi 2 intern eine neue SCX-Kernbibliothek nutzt. Betroffen sind vor allem MediaMarktSaturn, Kaufland und Amazon MCF.
• ✓Der häufigste Fehler: Bestellungen kommen rein, aber ohne Kundendaten. Ursache ist eine geänderte DLL in der SCX-Schicht; wir lösen das über einen gezielten Bibliotheksaustausch.
• ✓Vor jedem Wawi-2-Update sollte eazyAuction auf Kompatibilität geprüft werden. Vlarom E-Commerce Agentur führt diesen Check systematisch als Pre-Update-Gate durch.

Wir sind die Vlarom E-Commerce Agentur, JTL Service Partner Gold aus Ahrensfelde bei Berlin. Multichannel-Händler mit eazyAuction-Anbindungen betreuen wir regelmäßig: von der Ersteinrichtung bis zu den Post-Update-Problemen, die nach größeren Wawi-Versionssprüngen entstehen. Das Wawi-2-Release hat gezeigt, wie tief die Änderungen in der Marktplatz-Schicht reichen: Wer nicht vorbereitet war, stand halt nach dem Update mit unterbrochenen Abgleichen da.

JTL-Wawi 2 ist kein normales Feature-Update: Das Datenbankschema wurde grundlegend umgebaut, interne Bibliotheken ausgetauscht und die SCX-Marktplatz-Kommunikationsschicht an mehreren Stellen geändert. Tools und Plugins, die direkt auf die Wawi-Datenbank oder interne DLLs zugreifen, funktionieren danach nicht mehr. Ein Servicepartner schrieb im JTL-Forum frühzeitig: „Sobald Anbindungen direkt auf die Datenbank zugreifen, besteht nach dem Update immer die Gefahr, dass diese nicht mehr funktionieren.“

Quelle: forum.jtl-software.de (Thread „Warnung vor Update“, 2026): Ein JTL Service Partner im Forum: „Niemals sofort updaten. Wenn es ein so großes Update ist, ist es doch wohl klar, dass es diverse Fehler geben wird.“ Das gilt besonders für eazyAuction-Setups mit mehr als zwei Marktplätzen.

Was sich mit Wawi 2 konkret geändert hat und warum das eazyAuction trifft:

• →Neue SCX-Kernbibliothek: eazyAuction kommuniziert intern über die SCX-Schicht (SalesChanneX). JTL hat für Wawi 2 eine neue Version der Kernbibliothek JTL.Wawi.Marktplatz.Scx.Core.dll ausgeliefert. Installationen mit der alten DLL zeigen nach dem Update Fehler beim Adressimport und beim TYPE_spkundeUpdate-Prozess.
• →Neues DotLiquid-Variablen-Schema: Wawi 2 nutzt ein neues Variablen-Schema für Vorlagen und Marktplatzfelder. Wer eigene DotLiquid-Vorlagen für Marktplatzkanäle gepflegt hat, muss diese auf die neuen Variablenpfade umstellen, zum Beispiel für die verantwortliche Person bei GPSR-Pflichtangaben (Felder wie Vorgang.Allgemein.Stammdaten.Verantwortliche_Person.Firma).
• →GPSR-Pflichtfelder für Kaufland: Ab Wawi 2 müssen Produktsicherheitsdaten (GPSR) für Kaufland Global Marketplace über neue eazyAuction-Felder übergeben werden. Dazu gehören Name, Adresse, E-Mail und Telefon des Herstellers oder der verantwortlichen Person. Wer diese Felder vor dem Update nicht befüllt hat, riskiert abgelehnte Angebote oder gesperrte Listings.
• →MCF Breaking Changes: Amazon MCF (Multi-Channel Fulfillment) hat mit Wawi 2 seine interne Anbindung geändert. Die Tracking-Übertragung zu anderen Marktplätzen hängt an einer neuen API-Schicht. In einigen Setups fehlen nach dem Update die Trackingnummern bei eBay oder Kaufland, obwohl sie in der Wawi korrekt stehen.
• →Pending-Auftragsverhalten bei SCX-Kanälen: Ein bekanntes Issue (WAWI-65536): SCX-Aufträge von Kanälen wie MediaMarktSaturn werden zunächst im Status Pending angelegt. Erst nach späteren Abgleichen kommen Adresse und Zahlung. Workflows, die beim ersten Import feuern, verarbeiten damit unvollständige Daten.
• →SWITCH_API_VERSION — SCX-Versionsumstellung im Log: Im Worker-Log taucht nach dem Wawi-2-Update bei einigen Setups das Ereignis SWITCH_API_VERSION auf: eazyAuction erkennt, dass die interne SCX-API-Schicht gewechselt hat, und bricht laufende Abgleiche ab. Das Ereignis selbst ist kein dauerhafter Fehler — es zeigt den Moment des Versionsübergangs. Wer es sieht, sollte prüfen, ob die SCX-Kernbibliothek bereits auf den neuen Stand gebracht wurde, bevor die Abgleiche erneut gestartet werden.

Wawi 2 ist kein Drop-in-Upgrade für komplexe eazyAuction-Setups. Wer mehr als zwei Marktplätze angebunden hat oder eigene Vorlagen pflegt, braucht eben vor dem Update eine Kompatibilitätsprüfung. Kein großes Projekt — aber ohne sie sucht man nach dem Update im Dunkeln.

Nicht jeder Fehler nach einem Wawi-Update liegt an Wawi selbst. Manchmal ist es eine veraltete DLL, manchmal eine geänderte Variablensyntax, manchmal ein Workflow-Timing-Problem. Das sind die sechs Muster, die wir nach dem Wawi-2-Release in der Projektarbeit am häufigsten sehen.

Häufigste Ursache

Fehlende Kundendaten bei MediaMarktSaturn-Bestellungen

Nach dem Update auf Wawi 2.0.0.0 werden Bestellungen von MediaMarktSaturn zwar in der Wawi angezeigt, aber ohne Kundendaten. Im Log steht: Error UpdateOrderAddresses — Object reference not set to an instance of an object. Der Auftrag lässt sich nicht normal weiterverarbeiten. Ein Händler im JTL-Forum beschrieb es so: ‚Bestellungen werden importiert, Kundendaten fehlen komplett — ein Datensatz nach dem anderen mit leerem Adressfeld.‘

Ursache ist eine veraltete SCX-Kernbibliothek, die mit Wawi 2 nicht mehr kompatibel ist. JTL hat als Lösung den Austausch der Datei JTL.Wawi.Marktplatz.Scx.Core.dll bereitgestellt. Vor dem Austausch müssen alle Abgleiche deaktiviert werden. Ein Workaround über manuelle SQL-Einträge direkt in der Datenbank funktioniert zwar kurzfristig, ist aber kein dauerhafter Zustand.

Kritischer API-Fehler

TYPE_spkundeUpdate-Bug nach Wawi-2-Migration

Händler die von eazybusiness 1.11.x auf Wawi 2.0.1 gewechselt haben, berichten von einem TYPE_spkundeUpdate-Fehler: Der Kundendaten-Update-Prozess in der alten eazybusiness-Schicht ist mit der neuen Wawi-2-API nicht kompatibel. Die Meldung erscheint beim Kundenabgleich und blockiert die Auftragsverarbeitung.

Der Fehler entsteht, weil eazybusiness 1.11.x eine ältere API v1-Route nutzt, die mit Wawi 2 entfernt oder verändert wurde (verwandt mit Issue WAWI-87918 TaxRate/Discount-API-Änderungen). Die Lösung ist die Migration auf eazybusiness 2.x, das die neuen API-Endpunkte von Wawi 2 unterstützt. Ein Update nur auf Wawi ohne passendes eazybusiness-Update erzeugt genau dieses Muster.

Neue Anforderung

GPSR-Pflichtfelder für Kaufland nicht befüllt

Ab Wawi 2 müssen Produktsicherheitsdaten (GPSR) für Kaufland Global Marketplace über neue Felder in eazyAuction übergeben werden. Wer diese Felder vor dem Update nicht kannte oder nicht befüllt hat, bekommt beim nächsten Listing-Abgleich Fehlermeldungen oder abgelehnte Angebote.

JTL hat dafür neue DotLiquid-Variablen eingeführt, zum Beispiel Vorgang.Allgemein.Stammdaten.Verantwortliche_Person.Firma für den Namen der verantwortlichen Person. Diese Variablen haben sich mit Wawi 2 geändert und müssen in bestehenden Vorlagen angepasst werden. Die aktuellen Variablennamen stehen in der JTL-Guide-Dokumentation unter guide.jtl-software.com/jtl-eazyauction/.

Bekanntes Issue

Workflows feuern auf Pending-Aufträge

SCX-Kanäle wie MediaMarktSaturn liefern Bestellungen zunächst im Status Pending. Die vollständigen Kundendaten und Zahlungsinformationen kommen erst in späteren Abgleich-Runden nach. Wer einen Workflow konfiguriert hat, der bei neu erstellten Aufträgen feuert, verarbeitet dann unvollständige Daten.

Das entspricht dem bekannten Issue WAWI-65536. Prüfe nach dem Wawi-2-Update alle Auftrags-Workflows darauf, ob sie einen Statusfilter haben, der Pending-Aufträge ausspart. Sonst sendet der Workflow Bestätigungen, Rechnungen oder Versandbenachrichtigungen mit leeren Adressfeldern.

MCF-Breaking-Change

Amazon MCF ohne Tracking nach Update

Amazon MCF (Multi-Channel Fulfillment) überträgt nach dem Wawi-2-Update in manchen Setups keine Trackingnummern mehr an andere Marktplätze. Die Sendungsverfolgungsdaten landen nicht bei eBay oder Kaufland, obwohl sie in der Wawi korrekt gespeichert sind.

Das ist ein bekanntes Muster bei SCX-Kanälen nach dem MCF-API-Breaking-Change in Wawi 2: Die Trackingnummer-Übertragung hängt an einer internen Schnittstelle, die sich mit dem Update geändert hat. Prüfe, ob die Sendungsverfolgungsdaten im Wawi-Auftrag korrekt hinterlegt sind, und dann ob eazyAuction den korrekten Versandkanal für den jeweiligen Marktplatz zugeordnet hat.

Konfigurationsproblem

Kanalname-Duplikate in der Verkaufskanalverwaltung

Händler mit mehreren Kanälen desselben Marktplatzes (zum Beispiel MediaMarktSaturn.de und MediaMarktSaturn.at) sehen nach dem Update in der Verkaufskanalverwaltung den Kanalnamen doppelt ohne erkennbare Unterscheidung. Das führt bei Aktionen wie Textübernahme zu falschen Zuordnungen.

Das entspricht dem Issue WAWI-74587. Seit einer neueren Version ist der Kanalname (Sellername) im Abschnitt Kanalstatus änderbar. Trenne die Kanäle durch eigene Namen, zum Beispiel MMS-DE und MMS-AT, damit Aktionen in eazyAuction immer eindeutig zugeordnet sind.

Was funktioniert

SCX-DLL auf den aktuellen Stand bringen, bevor der Abgleich wieder gestartet wird. eazybusiness auf die Wawi-2-kompatible Version aktualisieren. Workflows auf Pending-Filter prüfen. Kaufland-GPSR-Felder befüllen. Kanalnamenduplikate trennen. Diese fünf Schritte lösen in unserer Praxis die meisten Post-Update-Probleme: ohne Datenverlust, ohne Neuanlage der Kanalverbindung.

Was nicht funktioniert

Kundendaten direkt in SQL setzen, um Bestellungen zu retten. Das ist ein Notbehelf für Einzelfälle, kein Dauerzustand. Wer die DLL nicht austauscht und eazybusiness nicht auf den aktuellen Stand bringt, repariert dieselben Aufträge manuell weiter. Und wer Workflows nicht anpasst, sendet weiterhin Benachrichtigungen mit leeren Adressfeldern.

Bevor du irgendetwas an eazyAuction oder den Abgleich-Einstellungen änderst, halte alle Abgleiche an. Laufende Abgleiche während einer DLL-Änderung hinterlassen die Datenbank inkonsistent — das kostet eben später mehr Zeit als der Fix selbst. Die Diagnose-Reihenfolge unten führt vom häufigsten zum selteneren Problem. Technische Details zur eazyAuction-Grundeinrichtung findest du in der offiziellen Dokumentation unter [guide.jtl-software.com/jtl-eazyauction/](https://guide.jtl-software.com/jtl-eazyauction/).

Deaktiviere als erstes alle automatischen Abgleiche in eazyAuction. Öffne dann das Wawi-Verzeichnis und suche die Log-Dateien im Unterordner Logs. Suche nach den Begriffen UpdateOrderAddresses, NullReferenceException, TYPE_spkundeUpdate und SCX. Notiere welche Kanäle in den Fehlermeldungen auftauchen, das gibt dir die Priorität für die nächsten Schritte. Wenn du im Log Object reference not set to an instance of an object siehst, ist der DLL-Austausch der erste Schritt.

Prüfe, welche Version von eazybusiness installiert ist. Wawi 2.0.x setzt eine kompatible eazybusiness-Version voraus: eazybusiness 1.11.x arbeitet mit der neuen Wawi-2-API-Schicht nicht korrekt zusammen. Der TYPE_spkundeUpdate-Bug tritt genau in dieser Konstellation auf. Die Mindestanforderung für die Wawi-2-Kompatibilität findest du in der JTL-Versionstabelle unter guide.jtl-software.com/unterstuetzte-produktversionen/. Führe das eazybusiness-Update im selben Wartungsfenster durch wie den DLL-Austausch.

Fordere beim JTL-Support die aktuelle Version der Datei JTL.Wawi.Marktplatz.Scx.Core.dll an, entweder direkt oder über einen JTL Service Partner. Benenne die alte DLL im Wawi-Verzeichnis um (zum Beispiel mit dem Zusatz .bak) bevor du die neue Datei kopierst. Starte danach einen Test-Abgleich für einen einzigen Kanal und prüfe, ob die Kundendaten jetzt vollständig übernommen werden. Erst wenn das klappt, alle weiteren Abgleiche wieder aktivieren.

Öffne die Workflow-Verwaltung und prüfe alle Workflows, die auf Auftrag erstellt oder Auftrag aktualisiert reagieren: jeder davon braucht einen Statusfilter, der Pending-Aufträge ausspart. Fülle anschließend in eazyAuction die Kaufland-GPSR-Pflichtfelder aus: Name, Adresse, E-Mail und Telefon der verantwortlichen Person. Wenn du eigene DotLiquid-Vorlagen pflegst, ersetze veraltete Variablen durch die neuen Wawi-2-Pfade.

Vergib für mehrere Kanäle desselben Marktplatzes (zum Beispiel MediaMarktSaturn.de und .at) eindeutige Namen wie MMS-DE und MMS-AT. Aktiviere danach die Abgleiche schrittweise, einen Kanal nach dem anderen, und prüfe das Log nach jedem Kanal für mindestens zwei Abgleich-Zyklen. Für Amazon MCF: prüfe nach dem Testlauf, ob Trackingnummern bei anderen Marktplätzen ankommen. So erkennst du kanalspezifische Restprobleme, bevor sie sich ausbreiten.

Autor

Alexander Luft

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