JTL Wawi 2.0: Verbindungstest zum Shop schlägt bei der Ersteinrichtung fehl

Auf einen Blick

• ✓Aus unseren Projekten: Eine erreichbare `dbeS/mytest.php`-URL im Browser ist kein Erfolgsnachweis. Erst eine kurze Antwortzeile im Format „Schnittstellenversion Shop-Version“ bestätigt, dass die Schnittstelle korrekt funktioniert. Eine leere oder weiße Seite ist bereits das Fehlersymptom.
• ✓Eine fehlende oder auskommentierte RewriteBase in der `.htaccess` und ein falsch eingestellter PHP-Handler (nginx statt Apache) sind die im JTL-Forum am häufigsten dokumentierten Ursachen für einen fehlschlagenden Verbindungstest, belegt in drei unabhängigen Forumsfällen über mehrere Jahre.
• ✓Bei JTL-Wawi 2.0.4.0 in Kombination mit JTL-Shop 5.7.1 meldet der Verbindungstest „Es wurden keine Daten vom Shop gesendet“. Im dokumentierten Forumsfall hat nicht das zunächst empfohlene Shop-Update auf 5.7.2 den Test gelöst, sondern derselbe PHP-Handler-Fehler wie bei den anderen Ursachen in diesem Beitrag. Das Update bleibt aus Sicherheitsgründen trotzdem sinnvoll.

Wir kennen diesen Moment aus eigenen Projekten: Die Ersteinrichtung läuft, bis der letzte Schritt, der Verbindungstest, mit einer wenig aussagekräftigen Fehlermeldung abbricht. Als JTL Service Partner Gold in Ahrensfelde bei Berlin bearbeiten wir seit über 10 Jahren Projekte im JTL-Ökosystem und haben über 120 Migrationen begleitet. Die Ersteinrichtung der Wawi-Shop-Verbindung gehört dabei zu den Schritten, bei denen kleine Server-Konfigurationsdetails den größten Ausschlag geben. Der offizielle JTL-Guide zur Shop-Anbindung (guide.jtl-software.com) beschreibt den Ablauf so: Shop-URL und Sync-Zugangsdaten in der Verkaufskanalverwaltung eintragen, dann auf „Verbindung testen“ klicken: „Sie erhalten eine Meldung darüber, ob die Verbindung erfolgreich getestet werden konnte.“ Was der Guide nicht zeigt: was eigentlich hinter dieser Meldung serverseitig passiert, wenn sie negativ ausfällt. Ein Nutzer im JTL-Forum beschrieb genau dieses Fehlerbild: Der Verbindungstest brach mit der Meldung „(InternalServerError) Es ist ein serverinterner Fehler aufgetreten.“ ab. Die Ursache lag in einer auskommentierten Zeile in der `.htaccess` (`#RewriteBase /`) — nach deren Aktivierung funktionierte der Test sofort. Genau diese Art von Server-Detail ziehen wir in diesem Beitrag zusammen.

Diese Muster stammen aus vier dokumentierten JTL-Forumsfällen, teils mit Moderator-Beteiligung, verteilt über mehrere Jahre — sie lassen sich auf drei wiederkehrende Ursachen zurückführen. Sie haben eine Gemeinsamkeit: In keinem der Fälle war JTL Wawi oder JTL Shop selbst defekt, die Ursache lag jedes Mal in einer Server- oder Konfigurationseinstellung.

primary

.htaccess-RewriteBase fehlt oder ist deaktiviert

Das ist das am häufigsten dokumentierte Muster. In einem gelösten Forumsfall lautete die Fehlermeldung wörtlich: „(InternalServerError) Es ist ein serverinterner Fehler aufgetreten.“ Ursache war eine auskommentierte Zeile in der `.htaccess`: `#RewriteBase /`. Nach Aktivierung der Zeile funktionierte der Verbindungstest sofort.

Aktiviere diese Zeile zuerst und teste danach erneut (Schritt 2 im Prüfplan unten) — das lässt sich in wenigen Minuten prüfen, bevor du dich an aufwendigere Ursachen wie den PHP-Handler machst.

warning

PHP läuft über den falschen Handler: nginx statt Apache

Bei manchen Hosting-Panels ist die PHP-Ausführungsart standardmäßig auf „FPM-Anwendung (nginx)“ statt „FPM-Anwendung (Apache)“ gestellt. Dann greifen die `.htaccess`-Rewrite-Regeln nicht, selbst wenn sie korrekt gesetzt sind: `dbeS/mytest.php` wird nicht richtig verarbeitet. Ein Forumsfall mit Moderator-Beteiligung zeigt die Fehlermeldung dazu wörtlich: „Synchronisation mit Webshop nicht möglich! Die Shop-URL verweist nicht auf einen gültigen Shop!

Diese Ursache ist unabhängig von der fehlenden RewriteBase aus dem vorigen Fall — beide betreffen zwar dieselbe `.htaccess`-Logik, aber unterschiedliche Fehlerquellen. Prüfe deshalb beide Punkte einzeln, nicht automatisch als ein gemeinsames Problem. Wie hartnäckig allein der PHP-Handler sein kann, zeigt der Fall im nächsten Abschnitt: Dort trat dieselbe Ursache noch einmal auf, diesmal bei einer neueren Wawi-Version.

highlight

Auch dieser Fall führt zurück zum PHP-Handler

In einem dokumentierten Forumsfall trat bei JTL-Wawi 2.0.4.0 zusammen mit JTL-Shop 5.7.1 die Meldung „Es wurden keine Daten vom Shop gesendet“ auf, obwohl der Shop erreichbar war, das Backend funktionierte und die Sync-Zugangsdaten korrekt eingetragen waren. Ein Servicepartner im Thread empfahl sofort das Update auf Shop 5.7.2, auch wegen einer bekannten Sicherheitslücke. Nach dem Update blieb `mytest.php` aber zunächst weiterhin eine leere Seite, statt der erwarteten kurzen Antwortzeile im Format „Schnittstellenversion Shop-Version“.

Erst die Umstellung des PHP-Handlers von „FPM-Anwendung (nginx)“ auf „FPM-Anwendung (Apache)“ in der Hosting-Verwaltung hat die Verbindung tatsächlich hergestellt, dieselbe Ursache wie im vorherigen Fall, nur diesmal in Kombination mit einer neueren Wawi-Version. Das Shop-Update auf 5.7.2 bleibt trotzdem sinnvoll: Es schließt unabhängig davon eine dokumentierte Sicherheitslücke. Details dazu haben wir in unserem Beitrag zum JTL-Shop-Sicherheitsupdate 5.7.1 auf 5.7.2 zusammengefasst. Eine offizielle, tabellarische Kompatibilitätsmatrix zwischen Wawi-2.0.x- und Shop-5.x-Versionen veröffentlicht JTL nach unserer Recherche nicht. Die 2.0.x-Reihe erhält seit dem Stable-Release im März 2026 im Wochentakt Patches, Versionsangaben sollten deshalb immer mit Datum genannt werden.

muted

Sync-Zugangsdaten falsch oder Domain nicht im Lizenzcenter registriert

Laut dem offiziellen JTL-Guide lassen sich Sync-Benutzername und Sync-Kennwort direkt im Backend des JTL-Shops neu festlegen, falls sie nicht mehr bekannt oder falsch in der Verkaufskanalverwaltung hinterlegt sind. Das ist die einfachste der drei Ursachen in diesem Beitrag zu prüfen und sollte vor den serverseitigen Ursachen (RewriteBase, PHP-Handler) als Erstes ausgeschlossen werden.

Ein weiterer dokumentierter Fall zeigt eine zweite mögliche Ursache: Die Fehlermeldung „Beim Testen der Verbindung ist ein Fehler aufgetreten: (Not Found) Die für den Abgleich benötigten Dateien wurden auf Ihrem Webspace nicht gefunden“ ging dort auf zwei gleichzeitige Gründe zurück: fehlerhafte `.htaccess`-Rewrite-Regeln und eine Domain, die nicht neben dem Lizenzschlüssel im JTL-Kundencenter registriert war. Erst nach Korrektur beider Punkte lief der Test durch.

Die Reihenfolge orientiert sich an dem, was in den vier dokumentierten Forumsfällen tatsächlich zur Lösung geführt hat: erst der genaue Diagnoseschritt, dann Server-Konfiguration, dann Zugangsdaten und Version. Der offizielle Ablauf für Shop-URL und Sync-Zugangsdaten steht im JTL-Guide zur Wawi-Shop-Anbindung.

Rufe `/dbeS/mytest.php` direkt im Browser auf und rufe zusätzlich `/dbeS/index.php?id=mytest` auf. Liefert die zweite URL eine kurze Antwortzeile im Format „Schnittstellenversion Shop-Version“, die erste dagegen eine leere oder weiße Seite, ist das ein starkes Indiz für eine `.htaccess`-RewriteBase- oder PHP-Handler-Fehlkonfiguration, nicht für ein Problem bei JTL Wawi oder JTL Shop selbst. Zeigen beide URLs eine leere Seite oder einen Serverfehler, ist der Shop grundsätzlich nicht erreichbar; das ist ein anderes, vorgelagertes Problem.

Öffne die `.htaccess` im Shop-Wurzelverzeichnis. Prüfe, ob die Zeile `RewriteBase /` aktiv ist (kein führendes `#`). Fehlt sie oder ist sie auskommentiert, aktiviere sie. Das allein hat in einem dokumentierten Forumsfall den Verbindungstest sofort funktionsfähig gemacht.

Prüfe im Hoster- oder Panel-Backend, über welchen Handler PHP für die Domain ausgeführt wird. Steht dort „FPM-Anwendung (nginx)“ statt „FPM-Anwendung (Apache)“, greifen die `.htaccess`-Regeln nicht zuverlässig. Stelle die Ausführung auf Apache-FPM um und teste danach erneut mit Schritt 1.

Lege Sync-Benutzername und Sync-Kennwort im Shop-Backend neu fest und trage sie in der Verkaufskanalverwaltung erneut ein. Prüfe zusätzlich im JTL-Kundencenter, ob die Domain neben deinem Lizenzschlüssel registriert ist. Ein einzelner fehlender Eintrag reicht, um den Test mit der Meldung „(Not Found) Die für den Abgleich benötigten Dateien wurden auf Ihrem Webspace nicht gefunden.“ abbrechen zu lassen.

Notiere deine genaue Wawi-2.0-Patchversion und deine Shop-Version. Ist dein Shop noch auf 5.7.1, aktualisiere auf 5.7.2, aus Sicherheitsgründen ohnehin empfehlenswert. Löst das allein den Verbindungstest noch nicht, prüfe direkt im Anschluss noch einmal Schritt 3 (PHP-Handler): In einem dokumentierten Fall mit exakt dieser Versionskombination war am Ende nicht das Update, sondern die Umstellung von nginx- auf Apache-FPM die tatsächliche Lösung. Für den vollständigen Update-Ablauf von JTL-Wawi 2.0 haben wir eine vollständige Update-Checkliste für JTL-Wawi 2.0 zusammengestellt.