Alexander LuftVon Alexander Luft
JTL Service Partner Gold · Ahrensfelde bei Berlin · 14. Oktober 2025 · 9 Min. Lesezeit
PayPal-Zahlungsabgleich in JTL Wawi fehlt – Fehlerbehebung Schritt für Schritt

PayPal Zahlungsabgleich in JTL-Wawi fehlt: Was hinter dem Fehler steckt und wie du ihn behebst

Seit März 2025 melden viele Händler dasselbe Problem: PayPal-Zahlungen kommen beim Kunden an, tauchen aber nicht mehr unter den Kontobewegungen in JTL-Wawi auf. Der Abgleich bricht still ab oder wirft eine kryptische Datenbankfehlermeldung. Der Auftrag bleibt offen, obwohl das Geld längst da ist. Das ist kein Einzelfall und kein Bedienungsfehler. Es ist ein bekannter Bug mit einer klaren Ursache: PayPal hat das Format seiner Referenznummern geändert, und JTL-Wawi kam damit nicht zurecht.

Du siehst PayPal-Eingänge im PayPal-Konto, aber nichts davon landet in deinen JTL-Wawi-Kontobewegungen?

Dieser Beitrag erklärt dir, was auf technischer Ebene passiert, welche Wawi-Versionen betroffen sind und was du jetzt tun kannst, damit der PayPal Zahlungsabgleich in JTL-Wawi wieder sauber läuft.

Auf einen Blick

  • ✓Das Problem tritt seit März 2025 auf: PayPal hat das Format der Referenznummern geändert, sodass die Daten für das JTL-Wawi-Datenbankfeld zu lang wurden. Die Fehlermeldung lautet „Zeichenfolgen- oder Binärdaten würden abgeschnitten.“
  • ✓Unser Team sieht das Problem regelmäßig bei Bestandskunden. Betroffen sind alle Händler, die PayPal als Zahlungsanbieter direkt in JTL-Wawi angebunden haben und den automatischen Kontobewegungsimport nutzen.
  • ✓Die dauerhafte Lösung liegt in der Wawi-Aktualisierung. JTL hat das Datenbankfeld in einem Bugfix-Release erweitert. Bis zum Update gibt es einen manuellen Workaround über den CSV-Import.

Ein fehlender Zahlungsabgleich ist mehr als ein technisches Ärgernis. Er verzerrt deinen offene-Posten-Stand, belastet dein Mahnwesen mit falschen Daten und kostet dich täglich manuelle Nacharbeit. Den Fehler einfach liegenlassen ist keine Option. Wir haben Kunden gesehen, die wochenlang doppelt gemahnt haben, weil JTL-Wawi die Zahlungen nicht sah.

Was hinter dem PayPal-Zahlungsabgleich-Fehler steckt — die technischen Fakten

Das JTL-Forum-Ticket WAWI-78802 dokumentiert das Problem seit März 2025. Mehrere Händler berichten unabhängig voneinander vom gleichen Verhalten: PayPal-Zahlungen verschwinden aus dem Kontobewegungsimport, ohne Fehlermeldung im normalen Betrieb. Nur wer in der Datenbank nachschaut, sieht die Ursache. Die Lösung gibt es — du musst nur wissen, wo du ansetzen musst.

Aus eigenen Projektdaten: Der Fehler betrifft alle JTL-Wawi-Installationen, die PayPal über die integrierte Zahlungsanbieter-Schnittstelle angebunden haben und den automatischen Kontobewegungsimport nutzen. Ein Händler im JTL-Forum schreibt: „Seit dem 20. März tauchen PayPal-Zahlungen einfach nicht mehr auf. Der Kontenabgleich läuft durch, aber die Bewegungen fehlen komplett.“ Ticket WAWI-78802 im JTL-Forum.

Das Problem hat drei technische Dimensionen, die du kennen musst:

  • →Die Datenbankfeld-Begrenzung: JTL-Wawi speichert die PayPal-Referenznummer im Datenbankparameter @cReferenz als NVARCHAR(50) — also maximal 50 Zeichen. PayPal sendet seit Anfang 2025 Referenznummern mit JSON-Objekten und Transaktions-IDs, die bis zu 54 Zeichen lang sind.
  • →Die stille Fehlermeldung: Der SQL-Server bricht den Import ab mit der Meldung: ‚Zeichenfolgen- oder Binärdaten würden abgeschnitten.‘ Diese Meldung taucht nur im Datenbankprotokoll auf, nicht in der JTL-Wawi-Oberfläche. Im Tagesgeschäft siehst du nur: Zahlungen fehlen.
  • →Der betroffene Import-Pfad: Betroffen ist ausschließlich der automatische PayPal-Kontobewegungsimport über die JTL-Wawi-Zahlungsanbieter-Schnittstelle. Der manuelle CSV-Import aus dem PayPal-Portal funktioniert weiterhin als Workaround.

Kernaussage: PayPal hat sein Datenformat geändert, ohne JTL vorab zu informieren. JTL hat den Bug dokumentiert (WAWI-78802) und mit einem Bugfix-Release das Datenbankfeld auf die nötige Länge angepasst. Wer noch auf einer älteren Version läuft, ist weiterhin betroffen.

Zwei Situationen — zwei unterschiedliche Ausgangspunkte

Nicht alle Händler, die diesen Fehler sehen, sind in der gleichen Ausgangslage. Je nachdem, ob du den automatischen Import oder den manuellen CSV-Import nutzt, sieht die Lösung anders aus:

1

Automatischer Kontobewegungsimport via Zahlungsanbieter

Du hast PayPal direkt in JTL-Wawi unter Zahlungen > Zahlungsanbieter angebunden und JTL-Wawi importiert Kontobewegungen automatisch. Genau hier greift der Bug: Das Datenbankfeld ist für die neuen langen PayPal-Referenzen zu kurz.

Der Import bricht still ab. Du siehst keine Fehlermeldung im Tagesgeschäft. Erst wenn du die Kontobewegungsliste prüfst und merkst, dass seit März 2025 keine PayPal-Buchungen mehr ankommen, fällt das Problem auf. Laut JTL-Forum sind alle nicht aktualisierten Installationen betroffen.

2

Manueller CSV-Import aus PayPal

Du lädst Kontobewegungen als CSV aus dem PayPal-Händlerportal herunter und importierst sie manuell in JTL-Wawi. Dieser Weg ist vom Bug nicht betroffen. Hier kontrollierst du selbst, welche Felder importiert werden.

Viele Händler sind nach Bekanntwerden des Bugs auf den manuellen Weg umgeschwenkt als Übergangslösung. Das kostet täglich ein paar Minuten mehr, aber der Zahlungsabgleich läuft zuverlässig. Die Beschreibung dieses Imports findest du in der JTL-Wawi Dokumentation zu Zahlungsanbietern.

Was du durch den Fix zurückgewinnst

Sauberer offene-Posten-Stand

Wenn der PayPal Zahlungsabgleich in JTL-Wawi wieder läuft, ist der offene-Posten-Stand sofort wieder korrekt. Kein manuelles Abgleichen mehr, kein Risiko, dass Kunden versehentlich gemahnt werden, obwohl das Geld längst da ist. In unseren Projekten sehen wir nach dem Fix oft 20 bis 40 nicht zugeordnete Zahlungen, die im Rückstand stecken und dann auf einmal aufgelöst werden.

Automatisierter Ablauf ohne täglichen Kontrollaufwand

Der manuelle CSV-Import ist ein Workaround, keine Dauerlösung. Nach dem Update auf die bereinigte Wawi-Version läuft der Kontobewegungsimport wieder vollautomatisch. Nichts muss täglich angestoßen werden, nichts manuell hochgeladen. Unser Team hat den Fix bei mehreren betroffenen Kunden eingespielt und den Rückstand an nicht zugeordneten PayPal-Zahlungen nachträglich bereinigt.

Die Lektion

Erkenntnis aus dem Kundenbetrieb: PayPal-Änderungen am Datenformat passieren ohne Ankündigung. Wer den Zahlungsabgleich nicht regelmäßig kontrolliert — mindestens wöchentlich — merkt solche Fehler oft erst Wochen später. Ein einfacher Check: Stimmt die Anzahl der PayPal-Zahlungen im PayPal-Händlerportal mit den Kontobewegungen in JTL-Wawi überein?

Dein Action-Plan: PayPal Zahlungsabgleich in JTL-Wawi wieder zum Laufen bringen

Dieser Plan gilt für Händler, die den automatischen PayPal-Kontobewegungsimport in JTL-Wawi nutzen und seit März 2025 fehlende Zahlungen in den Kontobewegungen bemerken. Arbeite die Schritte der Reihe nach ab.

Betroffenheit prüfen

„Geh in JTL-Wawi unter Zahlungen > Kontobewegungen und prüfe, ob PayPal-Buchungen seit März 2025 vorhanden sind. Parallel: Log dich in dein PayPal-Händlerportal ein und prüfe, wie viele Transaktionen dort im gleichen Zeitraum vorhanden sind. Wenn die Zahlen deutlich abweichen, bist du betroffen. Häufigster Fehler bei diesem Schritt: nur auf den Gesamtbetrag schauen statt auf die Anzahl der Einzelbuchungen.“

Sofort-Workaround — CSV-Import aktivieren

„Lade aus dem PayPal-Händlerportal unter Berichte > Transaktionen einen CSV-Export für den betroffenen Zeitraum herunter. Importiere die CSV in JTL-Wawi über Zahlungen > Kontobewegungen > Importieren. Dieser Weg umgeht das fehlerhafte Datenbankfeld und bringt alle fehlenden Zahlungen nach. Die genaue Vorgehensweise für den CSV-Import ist in der JTL-Wawi Dokumentation zu Kontobewegungen beschrieben.“

JTL-Wawi-Version prüfen

„Der Datenbankfeld-Bug wurde von JTL in einem Bugfix-Release nach Bekanntwerden des Tickets WAWI-78802 behoben. Prüfe deine aktuell installierte Wawi-Version unter Hilfe > Über JTL-Wawi. Vergleiche die Version mit den aktuellen Release Notes auf guide.jtl-software.com. Wenn du auf einer Version vor dem Fix läufst, ist das Update der einzige dauerhafte Weg.“

Update einspielen oder einspielen lassen

„Lies die JTL-Wawi Update-Checkliste, bevor du das Update startest. Besonders relevant: Datenbankbackup, offene Aufträge prüfen, Plugin-Kompatibilität sicherstellen. Updates sollten grundsätzlich nicht während des Tagesgeschäfts eingespielt werden. Ein guter Zeitpunkt ist nach Feierabend. Falls du dir beim Update unsicher bist, meld dich bei uns. Wir übernehmen das.“

Rückstand nachträglich bereinigen

„Nach dem Update läuft der automatische Import wieder. Die Zahlungen aus dem Rückstandszeitraum sind aber nicht automatisch drin. Mach einen CSV-Import für den kompletten Zeitraum seit März 2025. Gleiche danach unter Zahlungen > Offene Posten ab und prüfe, ob alle PayPal-Zahlungen korrekt den Aufträgen zugeordnet sind. Nicht zugeordnete Zahlungen musst du manuell matchen.“

Häufige Fragen zum PayPal-Zahlungsabgleich in JTL-Wawi

Seit wann tritt das Problem mit dem PayPal-Zahlungsabgleich in JTL-Wawi auf?

Das Problem tritt seit März 2025 auf. Zu diesem Zeitpunkt hat PayPal das Format der Referenznummern in seinen Transaktionsdaten geändert. Die neuen Referenznummern enthalten JSON-Strukturen und Transaktions-IDs und sind damit länger als das JTL-Wawi-Datenbankfeld @cReferenz (NVARCHAR(50)) aufnehmen kann. Die ersten Meldungen im JTL-Forum stammen aus dem gleichen Zeitraum.

Die Fehlermeldung lautet: ‚Zeichenfolgen- oder Binärdaten würden abgeschnitten.‘ Sie taucht nur im SQL-Server-Protokoll auf, nicht in der JTL-Wawi-Oberfläche. Im normalen Tagesbetrieb fehlen die Kontobewegungen einfach, ohne erklärenden Hinweis. Deshalb fällt der Fehler vielen Händlern erst auf, wenn gezielt nachgeschaut wird.

Nein. Der Bug betrifft nur den direkten PayPal-Kontobewegungsimport über die Zahlungsanbieter-Schnittstelle in JTL-Wawi. Wer PayPal über den JTL-Shop oder einen externen Connector anbindet und Zahlungen dort verarbeitet, nutzt einen anderen Import-Pfad. In dem Fall sollte geprüft werden, ob der Zahlungsabgleich über den Connector-Weg funktioniert.

WAWI-78802 ist das offizielle Bug-Ticket im JTL-Tracking-System für dieses Problem. JTL hat das Ticket nach Meldungen aus dem Forum angelegt und das Problem als Datenbankfeld-Begrenzung dokumentiert. Das Ticket bestätigt, dass JTL den Fehler offiziell anerkannt und in einem Release-Fix behoben hat.

Ja. Lade aus dem PayPal-Händlerportal einen CSV-Export für den betroffenen Zeitraum herunter und importiere ihn manuell in JTL-Wawi über Zahlungen > Kontobewegungen > Importieren. Dieser manuelle CSV-Import ist vom Bug nicht betroffen und bringt alle fehlenden Zahlungen nach. Danach müssen die importierten Zahlungen den offenen Aufträgen zugeordnet werden.

Das liegt an der Datenbankbegrenzung. JTL-Wawi versucht, die PayPal-Referenznummer zu speichern, scheitert aber daran, dass das Datenbankfeld zu kurz ist. Der Import-Prozess bricht dann still ab. Die Zahlung steht im PayPal-Portal, wird aber nie in die Wawi-Kontobewegungen geschrieben. Das PayPal-Portal zeigt direkt die PayPal-Buchhaltung, während JTL-Wawi eine eigene Kopie dieser Daten anlegt.

Für eine dauerhafte automatische Lösung ja. JTL hat das Datenbankfeld in einem Bugfix-Release auf die nötige Länge angepasst. Als Übergangsmaßnahme funktioniert der manuelle CSV-Import aus PayPal weiterhin. Einen Workaround ohne Update gibt es für den automatischen Import nicht, weil das Problem in der Datenbankstruktur liegt.

Nein. Zahlungen gehen nicht verloren. Alle Transaktionen existieren weiterhin vollständig im PayPal-Konto. Was fehlt, ist die Kopie in den JTL-Wawi-Kontobewegungen, die für den Zahlungsabgleich mit den Aufträgen gebraucht wird. Alle fehlenden Zahlungen lassen sich jederzeit über den CSV-Import nachholen.

Prüfe die letzte PayPal-Kontobewegung in JTL-Wawi unter Zahlungen > Kontobewegungen. Das Datum der letzten erfassten PayPal-Buchung zeigt, ab wann keine Daten mehr ankommen. Vergleiche das mit den PayPal-Kontoauszügen im Händlerportal. Die Lücke zwischen dem letzten JTL-Eintrag und heute ist der Zeitraum, den du per CSV nachholen musst.

Das ist leider bei einigen Händlern passiert. Wenn nach dem Fix Zahlungen für gemahnte Aufträge schon länger vorhanden waren, sollten die betroffenen Kunden aktiv kontaktiert werden. Es gibt kein automatisches Mahnungs-Rollback in JTL-Wawi. Das muss manuell bereinigt werden. Genau dieses Szenario zeigt, wie wichtig ein regelmäßiger manueller Abgleich ist, auch wenn der automatische Import läuft.

Nein. Der Fehler liegt in der Datenbankstruktur, nicht in einem flüchtigen Prozesszustand. Ein Neustart des JTL-Workers oder der JTL-Wawi-Anwendung ändert nichts an der Feldlängen-Begrenzung. Der Import wird nach dem Neustart erneut versucht und bricht erneut ab. Die einzigen Lösungen sind der manuelle CSV-Import als Workaround oder das Update auf eine Version mit dem Datenbankfix.

Hilf dir selbst — oder lass uns ran.

PayPal-Zahlungsabgleich wieder sauber? Wir kümmern uns darum.

Wir sind JTL Service Partner Gold mit Sitz in Ahrensfelde bei Berlin. Wir haben diesen Fehler bei mehreren Kunden behoben — inklusive Rückstand bereinigen, CSV-Nachimport und Update einspielen. Ruf uns direkt an unter +49 30 91473862, schreib an info@vlarom.de oder nutze unser Kontaktformular.