eBay-Fehlercodes in JTL-Wawi / JTL-eazyAuction: Bedeutung und Lösung – Nachschlagewerk

Ein Angebot bleibt in JTL-Wawi rot markiert, eBay meldet eine achtstellige Nummer und einen Text, der nicht immer verständlich ist. Fast jede dieser Meldungen hat eine klare Ursache: ein fehlendes Artikelmerkmal, ein zu kleines Bild, eine unzulässige Variante oder eine Richtlinie, die es im eBay-Konto nicht mehr gibt.

Dieses Nachschlagewerk sammelt 36 eBay-Fehlercodes, die Händler mit JTL-eazyAuction häufig sehen. Zu jedem Code finden Sie die Meldung sinngemäß auf Deutsch, die Ursache und den Weg zur Lösung in der Wawi. Jeder Code ist mit einer Quelle belegt, meist der offiziellen Fehlerliste von eBay.

Wo JTL-Wawi die eBay-Fehler anzeigt

Angebote, die eBay nicht annimmt, bleiben in JTL-Wawi in ihrem Ordner unter eBay > Angebote liegen, zum Beispiel unter Einzustellende Angebote oder Zu aktualisierende Angebote. Laut JTL-Guide gibt es dort mehrere Stellen für die Fehlermeldung:

Rote Markierung in der Listenansicht: Fehler bei der Bearbeitung des Angebots.
Registerkarte Angebotsfehler: Markieren Sie ein Angebot, um seine Fehler zu sehen.
Schaltfläche Fehleransicht: Öffnet ein Dialogfenster mit den Fehlern, die das Einstellen verhindern. Manche Einstellungen lassen sich dort über Zuordnen direkt korrigieren.
Filter: Sie können nach Angeboten mit oder ohne Fehler filtern und über das Filterfeld Fehler nach einem bestimmten Fehlertext suchen.

Nach der Korrektur überträgt die Schaltfläche Erneut übertragen das Angebot sofort an eBay. Ohne diesen Schritt geschieht das beim nächsten eBay-Abgleich.

So lesen Sie eine eBay-Meldung

Jede Meldung von eBay besteht aus drei Teilen:

Code: eine Nummer, etwa 21919303. Sie ist der zuverlässigste Suchbegriff, weil der Text je nach Sprache und Kategorie abweicht.
Meldungstext: eBay setzt darin oft den betroffenen Namen ein, zum Beispiel das fehlende Merkmal („Das Artikelmerkmal Marke fehlt“). Genau dieser Name ist der wichtigste Hinweis.
Schwere: Ein Fehler (in der eBay-Liste „Serious Error“) verhindert das Einstellen oder Ändern. Eine Warnung („Warning“) lässt das Angebot durch.

Häufig meldet eBay mehrere Codes auf einmal. Beheben Sie zuerst die Fehler, nicht die Warnungen. Ein einziger Fehler reicht, damit das ganze Angebot abgelehnt wird.

Artikelmerkmale (Item Specifics)

Artikelmerkmale sind die strukturierten Angaben wie Marke, Farbe, Material oder Produktart. eBay legt je Kategorie fest, welche Merkmale Pflicht sind, wie viele Werte erlaubt sind und wie lang ein Wert sein darf.

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`21919303`	Das Artikelmerkmal „…“ fehlt. Fügen Sie es hinzu und geben Sie einen gültigen Wert ein.	Die eBay-Kategorie verlangt ein Pflichtmerkmal, das im Angebot fehlt oder leer ist. Der Name steht in der Meldung (z. B. Marke, Herstellernummer, Produktart).	Merkmal mit gültigem Wert ergänzen. Im JTL-Forum nennt ein Moderator dafür die Angebotsvorlage, Reiter Kategorie; die Schaltfläche Kategorieattribute laden lädt alle Merkmale der gewählten Kategorie.
`21916519`	Dem Angebot fehlen erforderliche Artikelmerkmale: „…“.	Wie oben, mehrere Pflichtmerkmale fehlen.	Alle genannten Merkmale beim Artikel bzw. in der eBay-Vorlage ergänzen.
`21919305`	„…“ hat zu viele Werte.	Für dieses Merkmal sind weniger Werte erlaubt. Laut eBay liegt die Obergrenze meist bei 30, viele Merkmale erlauben nur einen Wert.	Werte des Merkmals in der Wawi auf das Zulässige reduzieren.
`21919308`	Der Wert „…“ für „…“ ist zu lang.	Ein Merkmals- oder Variantenwert überschreitet die zulässige Zeichenzahl.	Wert kürzen. Die Höchstlänge nennt die Meldung.
`21916626`	Varianten- und Artikelmerkmale müssen eindeutig sein.	Ein Artikelmerkmal heißt genauso wie eine Variante, z. B. Variation „Farbe“ und zusätzlich ein Kategoriemerkmal „Farbe“.	Laut JTL-Forum darf kein Kategoriemerkmal genauso heißen wie eine Variation. Doppeltes Merkmal entfernen; die Angabe bleibt nur in der Variante.

Prüfen Sie bei Merkmalen auch Sonderzeichen. Im JTL-Forum wurde ein Fall vermutet, in dem ein „ß“ falsch übertragen wurde und eBay das Merkmal deshalb nicht erkannte.

Bilder

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`21919137`	Bitte laden Sie Fotos mit hoher Auflösung hoch, mindestens 500 Pixel an der längsten Seite.	Mindestens ein Bild ist an der längsten Seite kleiner als 500 Pixel. Das gilt für alle Bilder, auch Variantenbilder.	Größere Bilder beim Artikel bzw. bei den Varianten hinterlegen. Prüfen, ob die Bilder vor der Übertragung verkleinert werden (siehe unten).
`21919136`	Fügen Sie mindestens 1 Foto hinzu.	Das Angebot enthält kein Bild.	Mindestens ein Bild beim Artikel hinterlegen und für eBay freigeben.
`21916790`	Warnung: Bild kleiner als empfohlen.	Das Bild erfüllt die Mindestgröße, liegt aber unter der empfohlenen Größe.	Keine Pflicht. eBay empfiehlt Bilder um 1600 × 1600 Pixel.

Aus unserer Praxis zu 21919137: Der Fehler tritt auf, sobald auch nur ein Bild an der längsten Seite unter 500 Pixel liegt. Kleinere Bilder lehnt eBay ab, das Angebot wird dann gar nicht übertragen. Ersetzen Sie die betroffenen Bilder durch größere Dateien und übertragen Sie das Angebot erneut.

In älteren Beiträgen im JTL-Forum lag die Ursache nicht am Originalbild. Das Bild wurde vor der Übertragung auf eine zu kleine Größe skaliert, oder beim Angebotsimport wurden Bilder ab dem zweiten Bild auf 400 Pixel verkleinert. Ist das Original groß genug, prüfen Sie also die Bildeinstellungen für eBay.

Varianten

Variantenangebote sind die häufigste Fehlerquelle. eBay erlaubt je Kategorie nur bestimmte Merkmale als Variantenmerkmal und verlangt, dass alle Varianten eines Angebots einheitlich aufgebaut sind.

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`21920061`	„…“ ist nicht als Variantenmerkmal zulässig.	Der Name der Variation ist in dieser eBay-Kategorie nicht als Variantenmerkmal freigegeben. Bekannte Beispiele aus dem JTL-Forum: Hersteller, Modell, Ausführung, Farbe.	Variation in der Wawi umbenennen (siehe Abschnitt unten).
`21916587`	Fehlende Bezeichnung in den Variantenmerkmalen.	In der Liste der Variantenmerkmale fehlt ein Name, oder die Varianten nutzen nicht alle dieselben Merkmalsnamen.	Varianten prüfen: Jede Variante braucht dieselben Variationen mit Namen und Wert.
`21916578`	Wert in Variantenmerkmalen fehlt.	Eine Variante hat zu einer Variation keinen Wert.	Fehlenden Variationswert in der Wawi ergänzen.
`21916664`	Variantenmerkmale passen nicht zu den Varianten des Angebots.	Die Varianten nutzen unterschiedliche Sätze von Merkmalen, z. B. einige „Farbe/Größe“, andere zusätzlich „Material“.	Alle Varianten auf dieselben Variationen bringen.
`21916585`	Doppelte Variantenbezeichnung.	Zwei Varianten haben dieselbe SKU oder dieselbe Wertekombination (z. B. zweimal „Blau, L“).	Doppelte Kombination bzw. SKU in der Wawi bereinigen.
`21919420`	Warnung: Bei Variantenangeboten werden GTINs auf Variantenebene angegeben.	Am Vaterartikel ist eine GTIN (EAN) hinterlegt.	Warnung, kein Fehler. Die EAN gehört an die Kindartikel.

Aus unserer Praxis: `21920061` bei „Größe“

Bei uns trat 21920061 auf, weil eine Variation in der Wawi „Größe“ hieß. In der gewählten eBay-Kategorie ist „Größe“ nicht als Variantenmerkmal freigegeben. Das passt zur offiziellen Meldung: Nicht jedes Merkmal einer Kategorie darf als Variantenmerkmal verwendet werden. Welche erlaubt sind, legt eBay je Kategorie fest.

Die Lösung war, die Variation umzubenennen, und zwar in einen fachlich passenden Namen, der beschreibt, worin sich die Varianten tatsächlich unterscheiden. Danach ließ sich das Angebot einstellen.

Eine umbenannte Variation heißt auch in Ihrem Onlineshop und auf anderen Marktplätzen anders. Prüfen Sie vorher, wo der Artikel noch gelistet ist.

Bei laufenden Angeboten ist das Umbenennen schwieriger, weil die Wawi die Änderung der Variantenstruktur bei laufenden Angeboten nicht ohne Weiteres zulässt. Im JTL-Forum wird eine Empfehlung des JTL-Supports aus dem Jahr 2020 zitiert: das Angebot in der Wawi löschen (nicht bei eBay beenden), die Variationswerte gleichlautend zu eBay anpassen und das Angebot über den Angebotsimport neu laden. Ob dieser Weg in Ihrer Wawi-Version noch nötig ist, sollten Sie vorher prüfen.

Kategorie und Artikelzustand

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`107`	Die Kategorie ist ungültig, wählen Sie eine andere Kategorie.	Die gespeicherte eBay-Kategorie gibt es nicht mehr oder sie ist nicht zulässig.	Neue eBay-Kategorie im Angebot bzw. in der Vorlage wählen und die Merkmale der neuen Kategorie prüfen.
`87`	Die gewählte Kategorie ist keine unterste Kategorie.	Es wurde eine Oberkategorie gewählt. Angebote müssen in einer untersten Kategorie liegen.	Die passende Unterkategorie auswählen.
`21916884`	Der Artikelzustand ist für diese Kategorie erforderlich.	Es ist kein Zustand gesetzt oder der Wert wird in der Kategorie nicht unterstützt.	Zustand (z. B. Neu) im Angebot bzw. in der Vorlage setzen. Erlaubte Zustände hängen von der Kategorie ab.

Angebot doppelt, beendet oder nicht änderbar

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`21919067`	Das Angebot verstößt gegen den Grundsatz zu doppelten Angeboten.	Für denselben Artikel läuft vom selben Verkäufer bereits ein Angebot. Die Meldung nennt dessen Artikelnummer.	Prüfen, ob der Artikel doppelt angelegt oder zweimal eingestellt wurde. Statt eines zweiten Angebots die Menge im bestehenden Angebot erhöhen.
`21916750`	Festpreisangebot beendet: Ein beendetes Angebot kann nicht geändert werden.	Die Wawi will ein Angebot ändern, das bei eBay bereits beendet ist.	Angebot in der Wawi abgleichen. Bei Bedarf neu einstellen statt ändern.
`10029`	Titel oder Untertitel können nicht geändert werden.	Bei Auktionen mit Gebot oder unter zwölf Stunden Restlaufzeit, bei Festpreisangeboten mit Verkauf oder offenem Preisvorschlag sperrt eBay diese Felder.	Änderung zurückstellen oder Angebot beenden und neu einstellen.
`240`	Das Angebot kann nicht eingestellt oder geändert werden.	Unzulässige Begriffe in Titel oder Beschreibung, Verstoß gegen eBay-Grundsätze oder erreichte Verkaufslimits.	Titel und Beschreibung prüfen. Laut eBay-Entwicklerdokumentation zeigt My eBay unter „Verkaufen“ die monatlichen Verkaufslimits; dort prüfen und ggf. Anhebung bei eBay anfragen.

Bei Verkaufslimits zählt die Stückzahl, nicht die Zahl der Angebote. Ein Angebot mit 500 Stück zählt laut eBay als 500 Artikel, bei Variantenangeboten zählt die Menge jeder Variante.

Versand, Zahlung und Rücknahme

Versand, Zahlung und Rücknahme werden bei eBay über Richtlinien im eBay-Konto gesteuert. Die Wawi verweist darauf. Wird eine Richtlinie bei eBay gelöscht oder geändert, passt der Verweis im Angebot nicht mehr.

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`21915469`	Es wurde keine Versandart angegeben.	Im Angebot fehlt eine gültige Versandoption.	Laut JTL-Forum muss eine Versandart auch dann angegeben werden, wenn Versandkostentabellen genutzt werden. Versandart in der Vorlage, Reiter Versand/Zahlung, prüfen.
`21917100`	Es wurde keine Versandkostentabelle erstellt.	Das Angebot verweist auf eine Versandkostentabelle, die im eBay-Konto fehlt.	Tabelle im eBay-Konto anlegen und anschließend den eBay-Abgleich starten.
`21917327`	Ungültige Versandrichtlinie.	Die im Angebot hinterlegte Versandrichtlinie gibt es im eBay-Konto nicht (mehr).	Versandeinstellungen neu importieren: Plattformen > Abgleich starten > eBay, Option Versandregeln in JTL-Wawi importieren/aktualisieren. Dann im Angebot bzw. in der Vorlage die gültige Versandregel wählen.
`21917328`	Ungültige Zahlungsrichtlinie.	Die angegebene Zahlungsrichtlinie ist im eBay-Konto nicht gültig.	Richtlinie im eBay-Konto prüfen, Daten abgleichen und im Angebot bzw. in der Vorlage eine gültige Zahlungsrichtlinie zuordnen.
`21917329`	Ungültige Rücknahmerichtlinie.	Die angegebene Rücknahmerichtlinie ist im eBay-Konto nicht gültig.	Wie oben, für die Rücknahmerichtlinie.

eBay-Konto und Token

JTL-eazyAuction greift über einen Token auf Ihr eBay-Konto zu. Läuft er ab oder wird er widerrufen, scheitern alle Aufrufe.

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`931`	Der Authentifizierungs-Token ist ungültig.	Die Prüfung des Tokens ist fehlgeschlagen, z. B. nach Änderung der eBay-Zugangsdaten.	Token im JTL-Kundencenter erneuern (siehe unten).
`932`	Der Authentifizierungs-Token ist abgelaufen.	Die Gültigkeit des Tokens ist abgelaufen. Laut eBay muss ein neuer Token erzeugt werden.	Token im JTL-Kundencenter erneuern.
`16110`	Der Token wurde vom Benutzer widerrufen.	Die Berechtigung für die Anwendung wurde im eBay-Konto entzogen.	Verknüpfung im JTL-Kundencenter neu herstellen.

Laut JTL-Guide erneuern Sie den Token im JTL-Kundencenter unter Bestellungen & Lizenzen > Marktplätze > eBay-Kontenverwaltung. Klicken Sie neben dem Konto auf Verknüpfung erneuern, melden Sie sich bei eBay an und bestätigen Sie den Zugriff. Danach kann es laut JTL bis zu vier Stunden dauern, bis eBay-Aufträge wieder in der Wawi ankommen.

Preise und Produktkennzeichnung (EAN)

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`73`	Der Preis ist ungültig oder liegt unter dem Mindestpreis.	Der übertragene Preis ist leer, ungültig oder zu niedrig. Im JTL-Forum wurde ein Fall mit einem Preis unter 1 EUR beschrieben.	eBay-Preis beim Artikel bzw. im Angebot prüfen. Bei sehr niedrigen Preisen Angebotsart prüfen.
`21919301`	Das Feld „…“ fehlt.	Die Kategorie verlangt eine bestimmte Produktkennzeichnung (EAN, UPC oder ISBN). Bei Variantenangeboten gilt das je Variante.	EAN beim Artikel bzw. bei jedem Kindartikel hinterlegen.
`21919302`	Die EAN hat einen ungültigen Wert.	Die EAN ist falsch, z. B. ein Platzhalter wie „0000000000000“.	Korrekte EAN aus Verpackung oder Herstellerdaten beim Artikel eintragen.

Grundpreis: Einen eigenen eBay-Fehlercode für einen fehlenden Grundpreis konnten wir nicht belegen. Laut eBay-Hilfe geben gewerbliche Verkäufer die Anzahl der Einheiten und die Einheit (z. B. kg) über Artikelmerkmale an; eBay berechnet den Grundpreis daraus automatisch. Fehlt der Grundpreis im Angebot, prüfen Sie diese Merkmale.

Rechtliche Pflichtangaben (GPSR, Energielabel)

Seit Geltung der EU-Produktsicherheitsverordnung (GPSR) prüft eBay Hersteller- und Sicherheitsangaben. Die zugehörigen Fehlercodes sind entsprechend neu.

Code	Meldung (sinngemäß)	Ursache	Lösung in JTL
`21920424`	Die Adresse des Herstellers ist unvollständig.	Bei der Herstelleradresse fehlt Straße, Ort, Postleitzahl oder Land.	Herstelleradresse vollständig pflegen: laut JTL-Guide unter Artikel > Hersteller, Registerkarte Kontakt.
`21920429`	Weder Hersteller noch verantwortliche Person haben ihren Sitz in der EU.	Mindestens einer von beiden muss in der EU ansässig sein.	Verantwortliche Person mit Sitz in der EU anlegen (Artikel > Verantwortliche Person) und in den Artikelstammdaten zuweisen.
`21920423`	Angaben zur Produktsicherheit unvollständig.	Das Angebot muss Sicherheitspiktogramme oder Sicherheitshinweise enthalten.	Sicherheitshinweise bzw. Piktogramme zum Artikel ergänzen und für eBay übertragen.
`21920387`	Das Angebot braucht sowohl ein Energieeffizienzlabel als auch ein Produktdatenblatt.	Für energieverbrauchsrelevante Produkte fehlt das Label oder das Datenblatt.	Label und Produktdatenblatt bereitstellen. Wie diese in Ihrer Wawi-Version übertragen werden, sollten Sie vorher prüfen.

Laut JTL-Guide überträgt die Wawi die Herstellerdaten ab Version 1.9.6.5 immer; ist zusätzlich eine verantwortliche Person zugewiesen, werden beide übertragen. Sind die Daten unvollständig, wird nichts übertragen. Bei laufenden Angeboten, deren Daten Sie nachträglich ergänzt haben, nutzen Sie unter Plattformen > Laufende Angebote die Funktion Angebote vollständig aktualisieren. Laut JTL dauert das etwa eine Minute je Angebot.

Fehlen Herstellerangaben, kann eBay die Angebote laut eigener Mitteilung vorübergehend ausblenden. Unabhängig von eBay können fehlende Herstellerangaben auch abgemahnt werden.

Allgemeine Vorgehensweise bei unbekannten Fehlern

Taucht ein Code auf, der hier nicht steht, hilft diese Reihenfolge:

Code und vollständigen Text notieren. Der Name in Anführungszeichen (Merkmal, Feld, Variation) ist meist der entscheidende Hinweis.
Fehler von Warnungen trennen. Nur Fehler verhindern das Einstellen.
Offizielle Bedeutung nachschlagen. Suchen Sie den Code in der eBay-Fehlerliste der Trading API (Link unten). Viele Einträge enthalten einen Abschnitt zur Fehlerbehebung.
Prüfen, ob sich bei eBay etwas geändert hat. Neue Pflichtmerkmale, gesperrte Variantenmerkmale oder geänderte Richtlinien betreffen oft viele Angebote gleichzeitig, auch solche, die lange liefen.
Ein Angebot korrigieren und einzeln testen. Mit Erneut übertragen sehen Sie sofort, ob der Fehler weg ist, bevor Sie Dutzende Angebote ändern.
Im JTL-Forum nach dem Code suchen. Viele Codes wurden dort bereits besprochen. Achten Sie auf das Datum der Beiträge, denn Menüs und Abläufe in der Wawi ändern sich.
Bei Bedarf JTL-Support einbinden, wenn der Fehler auf eine Schnittstellenfunktion zeigt, die Sie in der Wawi nicht selbst steuern können.

Ändern Sie Variationen, Kategorien oder Merkmale nicht für viele Angebote gleichzeitig, solange Sie die Ursache nicht kennen. Änderungen am Artikel wirken auch auf Onlineshop und andere Marktplätze.

Sie möchten eBay-Fehler nicht selbst eingrenzen oder viele Angebote auf einmal bereinigen? Als zertifizierter JTL-Servicepartner unterstützt PC-Mixx Sie bei der Analyse und Korrektur Ihrer eBay-Anbindung.

Hängt es bei Ihnen gerade?Wir schauen uns das per Fernwartung an und finden die Ursache.

Support anfragen

Häufige Fragen

Wo sehe ich in JTL-Wawi, warum eBay ein Angebot ablehnt?

In den Ordnern unter eBay > Angebote, etwa Einzustellende Angebote oder Zu aktualisierende Angebote. Fehlerhafte Angebote sind rot markiert. Markieren Sie das Angebot und öffnen Sie die Registerkarte Angebotsfehler oder die Schaltfläche Fehleransicht.

Muss ich jede eBay-Warnung beheben?

Nein. eBay unterscheidet zwischen Fehlern (Serious Error) und Warnungen (Warning). Ein Fehler verhindert das Einstellen oder Ändern. Eine Warnung lässt das Angebot durch, weist aber darauf hin, dass eBay etwas angepasst oder ignoriert hat. Warnungen sollten Sie trotzdem lesen.

Warum taucht ein Fehler plötzlich bei Angeboten auf, die jahrelang liefen?

eBay ändert regelmäßig die Anforderungen je Kategorie, zum Beispiel Pflicht-Artikelmerkmale oder die erlaubten Variantenmerkmale. Spätestens beim nächsten Ändern des Angebots greift dann die neue Regel. Auch neue gesetzliche Pflichtangaben wie die Herstellerdaten nach GPSR führen zu neuen Fehlern.

Wo finde ich die offizielle Bedeutung eines eBay-Fehlercodes?

eBay veröffentlicht für die Trading API eine Liste aller Fehlercodes mit Kurz- und Langtext, teils mit Hinweisen zur Fehlerbehebung. Den Link finden Sie in der Quellenliste am Ende dieses Artikels. Die Liste ist englisch und technisch, die Codes sind aber identisch mit denen in JTL-Wawi.

Quellen

eBay (offiziell)

eBay Developers Program: Trading API – Errors by Number – Kurz- und Langtexte sowie Hinweise zur Fehlerbehebung zu allen Codes in diesem Artikel
eBay Developers Program: Knowledge Base 2038 – ErrorCode 240 because of seller limits
eBay-Hilfe: Grundsatz zu den eBay-Bilderstandards
eBay-Hilfe: Bilder zu Angeboten hinzufügen
eBay-Hilfe: Grundpreis
eBay Verkäuferportal: Energieeffizienzklasse
eBay-Community: Erinnerung zur Verordnung über die allgemeine Produktsicherheit (GPSR)

Weitere

JTL-Guide

JTL-Forum