Quick Fixes für Shop, Wawi, Plugins und E-Commerce Systeme

Problem

Nach einer Änderung im JTL-Shop Backend lädt der Adminbereich nicht mehr korrekt. Das Backend bleibt hängen, zeigt einen Timeout, lädt nur teilweise oder ist nach dem Speichern einer Einstellung nicht mehr erreichbar.

Kurzlösung

Prüfe zuerst, welche Einstellung zuletzt geändert wurde. Besonders nach Cache-, Template-, Plugin- oder Servereinstellungen sollte das Server-Error-Log kontrolliert werden, bevor weitere Änderungen vorgenommen werden.

Voraussetzungen

Zugriff auf das Hosting-Panel
Zugriff auf Server-Error-Logs
FTP-Zugang
aktuelles Backup
optional Datenbankzugang

Werkzeuge

Hosting-Panel
Server-Error-Log
FTP-Programm
Browser im privaten Modus
Datenbankverwaltung
Texteditor

Geschätzte Dauer

10 bis 30 Minuten

Schritte

1. Prüfe zuerst, ob nur das Backend oder auch das Frontend betroffen ist.

2. Notiere die letzte Änderung, zum Beispiel Cache, Template, Plugin, Versandart, Zahlungsart oder PHP-Einstellung.

3. Teste das Backend in einem privaten Browserfenster und lösche die Cookies für die Shopdomain.

4. Prüfe das Server-Error-Log auf Timeouts, PHP-Fatal-Errors, Redis-Fehler oder Rechteprobleme.

5. Mache keine weiteren Änderungen im Backend, solange die Ursache nicht eingegrenzt ist.

6. Stelle die zuletzt geänderte Einstellung nur mit Backup oder technischer Erfahrung zurück.

Warnhinweis: Keine Cache-, Plugin- oder Datenbankwerte blind ändern, wenn das Backend nach einer Änderung nicht mehr lädt. Besonders bei Redis, Datei-Cache, PHP-Versionen und Datenbankwerten kann eine falsche Korrektur den Fehler verschlimmern.

Support sinnvoll, wenn: Support ist sinnvoll, wenn Backend und Frontend gleichzeitig betroffen sind, das Backend nach einer Cache- oder Serveränderung nicht mehr lädt, Redis- oder PHP-Fehler im Error-Log stehen oder die zuletzt geänderte Einstellung nicht sicher zurückgesetzt werden kann.

Problem

Nach einem JTL-Shop Update tritt ein Datenbankfehler auf. Der Shop zeigt einen HTTP 500 Fehler, der DB-Updater bricht ab, das Backend ist nicht mehr erreichbar oder im Log erscheinen SQL-Fehler, fehlgeschlagene Migrationen, fehlende Tabellen, doppelte Tabellen oder abweichende Versionsstände zwischen Dateisystem und Datenbank.

Kurzlösung

Prüfe zuerst Backup, Shopversion, Datenbankversion und die genaue SQL-Fehlermeldung. Danach sollten Update-Log, Server-Error-Log und Datenbankzustand kontrolliert werden, ohne Tabellen oder Datenbankwerte vorschnell zu löschen.

Voraussetzungen

aktuelles Datenbankbackup
aktuelles Datei-Backup
Zugriff auf das Hosting-Panel
Zugriff auf Server-Error-Logs
Datenbankzugang
FTP-Zugang
Kenntnis der alten und neuen JTL-Shop Version

Werkzeuge

Datenbankverwaltung
Hosting-Panel
Server-Error-Log
JTL-Shop Updatebereich
FTP-Programm
Texteditor
Backupverwaltung

Geschätzte Dauer

30 bis 90 Minuten

Schritte

1. Prüfe zuerst, ob ein aktuelles und wiederherstellbares Datenbankbackup vorhanden ist.

2. Notiere die genaue SQL-Fehlermeldung aus DB-Updater, Server-Error-Log oder Shop-Log.

3. Vergleiche Dateiversion, Shopversion und Datenbankversion, wenn diese im Updatebereich angezeigt werden.

4. Prüfe, ob der Fehler bei einer konkreten Migration, Tabelle oder Spalte auftritt.

5. Führe keine manuellen SQL-Änderungen aus, solange Ursache und Versionsstand nicht eindeutig geklärt sind.

6. Sichere den aktuellen Stand und entscheide erst danach zwischen sauberer Fehlerbehebung, erneutem Updateversuch oder Rollback.

Warnhinweis: Keine Tabellen löschen, keine Migrationen manuell als erledigt markieren und keine SQL-Befehle aus Forenbeiträgen übernehmen, solange nicht klar ist, ob sie exakt zur eigenen Shopversion, Datenbankversion und Fehlermeldung passen. Datenbankfehler nach Updates können den Shop dauerhaft beschädigen, wenn ohne Backup gearbeitet wird.

Support sinnvoll, wenn: Support ist sinnvoll, wenn der DB-Updater abbricht, SQLSTATE-Fehler erscheinen, Tabellen fehlen oder doppelt vorhanden sind, Frontend und Backend nicht erreichbar sind, die Datenbankversion nicht zur Shopversion passt oder kein getestetes Backup für einen sauberen Rollback vorhanden ist.

Problem

Nach einer Migration, einem Domainumzug, einem Datenbankimport oder einem Shop-Update werden Umlaute, Sonderzeichen oder HTML-Entities falsch dargestellt. Statt ä, ö, ü oder ß erscheinen kryptische Zeichen, Fragezeichen, doppelt kodierte Zeichen oder abgeschnittene Inhalte.

Kurzlösung

Prüfe zuerst, ob der Fehler aus der Datenbank, aus importierten Daten, aus Template-Ausgaben oder aus einer falschen Server- beziehungsweise Datenbankkodierung stammt. Vor jeder Zeichensatzkorrektur müssen Datenbankbackup, Exportformat, Kollation und tatsächliche Datendarstellung geprüft werden.

Voraussetzungen

aktuelles Datenbankbackup
aktuelles Datei-Backup
Datenbankzugang
Zugriff auf das Hosting-Panel
Zugriff auf das JTL-Shop Backend
Kenntnis des ursprünglichen Shopsystems oder der alten Datenbank
Kenntnis des verwendeten Export- und Importformats

Werkzeuge

Datenbankverwaltung
Hosting-Panel
JTL-Shop Backend
Texteditor mit UTF-8 Unterstützung
Datenbankexport
Browser
optional Tabellenprogramm

Geschätzte Dauer

30 bis 120 Minuten

Schritte

1. Prüfe zuerst an mehreren Beispielen, ob Umlaute überall oder nur in bestimmten Bereichen falsch dargestellt werden.

2. Vergleiche betroffene Inhalte in Frontend, Backend und Datenbank, um Ausgabeproblem und Speicherproblem zu unterscheiden.

3. Kontrolliere Exportformat, Importformat, Datenbankzeichensatz und Kollation der betroffenen Tabellen.

4. Erstelle vor jeder Korrektur ein vollständiges Datenbankbackup und teste Änderungen nicht direkt auf der Live-Datenbank.

5. Prüfe, ob Inhalte bereits doppelt kodiert wurden oder ob nur die Ausgabe beziehungsweise Verbindungskodierung falsch ist.

6. Führe Zeichensatzkorrekturen erst nach eindeutiger Diagnose und idealerweise in einer Testumgebung durch.

Warnhinweis: Keine globale Zeichensatzumstellung, kein Suchen-und-Ersetzen und keine SQL-Konvertierung direkt auf der Live-Datenbank durchführen, solange nicht eindeutig klar ist, ob die Daten falsch gespeichert oder nur falsch ausgegeben werden. Eine falsche Korrektur kann Zeichen dauerhaft doppelt kodieren oder Inhalte beschädigen.

Support sinnvoll, wenn: Support ist sinnvoll, wenn viele Artikel, Kategorien, CMS-Seiten oder Kundendaten betroffen sind, der Fehler nach einem Shop-Update oder Datenbankimport auftritt, unterschiedliche Tabellen verschiedene Kollationen nutzen oder unklar ist, ob latin1, utf8, utf8mb3 oder utf8mb4 korrekt verwendet wurde.

Problem

Nach einem JTL-Shop Update treten Fehler auf, obwohl die Dateien hochgeladen und das Update scheinbar abgeschlossen wurde. Der Shop zeigt HTTP 500, einzelne Backend-Menüpunkte laden nicht, Plugins funktionieren nicht mehr oder der DB-Updater startet nicht sauber. Eine mögliche Ursache ist eine nicht passende PHP-Version oder eine fehlende PHP-Erweiterung.

Kurzlösung

Prüfe zuerst, welche PHP-Version für die installierte JTL-Shop Version und die aktiven Plugins vorgesehen ist. Danach sollten PHP-Erweiterungen, ionCube, Server-Error-Log und Plugin-Kompatibilität kontrolliert werden.

Voraussetzungen

Zugriff auf das Hosting-Panel
Kenntnis der installierten JTL-Shop Version
Kenntnis der aktiven PHP-Version
Zugriff auf Server-Error-Logs
aktuelles Backup
optional Zugriff auf das JTL-Shop Backend

Werkzeuge

Hosting-Panel
JTL-Shop Backend
Server-Error-Log
PHP-Info
Plugin-Manager
Herstellerdokumentation der Plugins

Geschätzte Dauer

10 bis 30 Minuten

Schritte

1. Prüfe im Hosting-Panel, welche PHP-Version für die Shopdomain aktiv ist.

2. Vergleiche die aktive PHP-Version mit den Anforderungen der installierten JTL-Shop Version.

3. Kontrolliere, ob wichtige PHP-Erweiterungen und bei Bedarf ionCube aktiv sind.

4. Öffne das Server-Error-Log und suche nach PHP-Fatal-Errors, ionCube-Meldungen oder Pluginpfaden.

5. Prüfe im Plugin-Manager oder in der Plugin-Dokumentation, ob alle aktiven Plugins zur PHP-Version passen.

6. Teste Änderungen an der PHP-Version nur kontrolliert und dokumentiere vorher den aktuellen funktionierenden Stand.

Warnhinweis: Die PHP-Version nicht mehrfach hin und her wechseln, ohne die Fehlermeldungen zu dokumentieren. Eine zu alte oder zu neue PHP-Version kann Shop, Backend, Plugins, ionCube-Erweiterungen oder den Datenbank-Updater beeinflussen.

Support sinnvoll, wenn: Support ist sinnvoll, wenn nach einer PHP-Umstellung HTTP 500 Fehler auftreten, einzelne Backendbereiche nicht mehr laden, der DB-Updater nicht startet, ionCube- oder Pluginfehler im Error-Log stehen oder unklar ist, welche PHP-Version zur installierten Shopversion passt.

Problem

Eine Marktplatz-Schnittstelle liefert keine Daten an JTL-Wawi oder den Shop. Der Abgleich startet zwar, aber Bestellungen, Angebote, Artikel, Versandregeln, Profile oder Produktdaten werden nicht importiert oder aktualisiert. Teilweise erscheinen im Log nur Meldungen mit 0 importierten Datensätzen oder unklare API-Fehler.

Kurzlösung

Prüfe zuerst, ob die Schnittstelle grundsätzlich verbunden ist und ob der betroffene Marktplatz aktuell erreichbar ist. Danach sollten Zugangsdaten, Token, API-Version, Marktplatzstatus, Abgleichlog und Plattformänderungen kontrolliert werden.

Voraussetzungen

Zugriff auf JTL-Wawi
Zugriff auf den betroffenen Marktplatz-Account
Zugriff auf eazyAuction oder die genutzte Schnittstelle
Zugriff auf Abgleichprotokolle
Kenntnis des betroffenen Marktplatzes
optional Zugriff auf den Schnittstellenanbieter

Werkzeuge

JTL-Wawi
eazyAuction
Marktplatz-Backend
Abgleichlog
Schnittstellenlog
Browser
Support- oder Statusseite des Marktplatzes

Geschätzte Dauer

15 bis 60 Minuten

Schritte

1. Prüfe, ob nur ein Marktplatz oder mehrere Schnittstellen keine Daten liefern.

2. Kontrolliere im Marktplatz-Backend, ob Zugang, API-Freigabe, Token oder Berechtigungen noch gültig sind.

3. Starte einen gezielten Abgleich und notiere die genaue Meldung aus dem Abgleichlog.

4. Prüfe, ob der Marktplatz eine Störung, API-Änderung oder neue Schnittstellenversion angekündigt hat.

5. Kontrolliere, ob Bestellungen, Angebote, Produktdaten oder Versandinformationen einzeln betroffen sind.

6. Ändere keine Zuordnungen und richte die Schnittstelle nicht neu ein, bevor Log, Token und Marktplatzstatus geprüft wurden.

Warnhinweis: Keine Marktplatz-Anbindung löschen oder neu einrichten, solange nicht geprüft wurde, ob Zugangsdaten, Token, API-Version oder eine temporäre Marktplatzstörung die Ursache sind. Eine vorschnelle Neueinrichtung kann Zuordnungen, Angebotsdaten oder laufende Abgleiche zusätzlich verkomplizieren.

Support sinnvoll, wenn: Support ist sinnvoll, wenn die Schnittstelle trotz korrekter Zugangsdaten keine Daten liefert, der Abgleich dauerhaft 0 Datensätze importiert, API-Fehler im Log stehen, Bestellungen nicht abgeholt werden oder der Marktplatz kurzfristig API-Versionen, Authentifizierung oder Datenformate geändert hat.

Problem

Nach einem Shopumzug, Domainwechsel oder Systemwechsel wurden Weiterleitungen eingerichtet, aber alte URLs leiten nicht korrekt weiter. Mögliche Symptome sind 404 Fehler, Weiterleitung auf die falsche Zielseite, Weiterleitungsketten, Weiterleitungsschleifen, alte URLs in der Sitemap oder unterschiedliche Ergebnisse zwischen http, https, www und nicht-www.

Kurzlösung

Prüfe zuerst, ob wichtige alte URLs mit dem richtigen Statuscode auf fachlich passende neue Ziele weiterleiten. Danach sollten Weiterleitungsketten, Schleifen, Sitemap, Canonicals und die Serverkonfiguration kontrolliert werden.

Voraussetzungen

Zugriff auf das JTL-Shop Backend
Liste alter URLs
Zugriff auf die aktuelle Sitemap
Zugriff auf Google Search Console
optional Zugriff auf Hosting-Panel oder .htaccess
optional Zugriff auf Server-Logs
aktuelles Backup bei technischen Änderungen

Werkzeuge

JTL-Shop Backend
Weiterleitungsverwaltung
Google Search Console
Sitemap
Redirect-Checker
Crawler
Hosting-Panel
Browser

Geschätzte Dauer

30 bis 90 Minuten

Schritte

1. Prüfe eine Liste wichtiger alter URLs aus Search Console, alter Sitemap, Backlinkdaten oder Server-Logs.

2. Teste jede wichtige URL auf Statuscode, Zielseite und fachliche Passgenauigkeit.

3. Kontrolliere, ob 301 Weiterleitungen ohne unnötige Weiterleitungsketten oder Schleifen ausgegeben werden.

4. Prüfe http, https, www und nicht-www auf ein einheitliches Endziel.

5. Kontrolliere, ob die aktuelle Sitemap nur gültige neue Ziel-URLs enthält.

6. Prüfe nach der Umstellung Search Console und Crawlingdaten auf neue 404 Fehler, Soft-404 Hinweise oder unerwartete Redirects.

Warnhinweis: Weiterleitungen nicht gleichzeitig im JTL-Shop Backend, in der .htaccess, im Hosting-Panel und bei einem CDN doppelt pflegen, wenn die Reihenfolge nicht klar ist. Das kann Weiterleitungsketten, Schleifen oder falsche Zielseiten verursachen.

Support sinnvoll, wenn: Support ist sinnvoll, wenn nach dem Shopumzug wichtige alte URLs nicht sauber weiterleiten, Weiterleitungsschleifen entstehen, alte URLs weiterhin in der Sitemap stehen, http/https oder www/nicht-www uneinheitlich reagieren oder unklar ist, ob JTL-Shop, .htaccess, Hosting oder CDN die Weiterleitung ausführt.

Problem

Der Shop zeigt einen HTTP 500 Fehler oder die Meldung Internal Server Error. Je nach Ursache kann nur das Frontend, nur das Backend oder der gesamte Shop betroffen sein. Häufig tritt der Fehler nach einem Shop-Update, einer Plugin-Änderung, einer PHP-Umstellung oder einer fehlerhaften Serverkonfiguration auf.

Kurzlösung

Prüfe zuerst, ob der Fehler nach einer konkreten Änderung aufgetreten ist. Danach sollte das Server-Error-Log ausgewertet werden, bevor Plugins, Dateien oder Datenbankeinträge verändert werden.

Voraussetzungen

Voraussetzungen:
Zugriff auf das Hosting-Panel
Zugriff auf Server-Error-Logs
FTP-Zugang
aktuelles Backup
optional Zugriff auf das JTL-Shop Backend

Werkzeuge

Hosting-Panel
Server-Error-Log
FTP-Programm
JTL-Shop Backend
Texteditor

Geschätzte Dauer

10 bis 30 Minuten

Schritte

1. Prüfe, ob Frontend, Backend oder beide Bereiche vom HTTP 500 Fehler betroffen sind.

2. Notiere die letzte Änderung, zum Beispiel Update, Plugin-Aktivierung, Template-Anpassung oder PHP-Umstellung.

3. Öffne das Server-Error-Log im Hosting-Panel und suche nach PHP-Fatal-Errors, Pluginpfaden oder Datenbankfehlern.

4. Deaktiviere das zuletzt geänderte Plugin nur dann, wenn das Error-Log oder der zeitliche Zusammenhang darauf hinweist.

5. Leere danach den Template- und Objektcache, falls das Backend noch erreichbar ist.

6. Teste den Shop erneut und ändere nichts weiter, wenn der Fehler weiterhin unklar bleibt.

Warnhinweis: Keine Plugin-Tabellen, Shop-Dateien oder Datenbankeinträge löschen, solange kein aktuelles Backup vorhanden ist. Bei einem HTTP 500 sollte zuerst die konkrete Fehlermeldung im Server-Error-Log geprüft werden.

Support sinnvoll, wenn: Support ist sinnvoll, wenn Frontend und Backend gleichzeitig nicht erreichbar sind, der Fehler direkt nach einem Shop-Update auftritt, das Error-Log PHP-Fatal-Errors oder Datenbankfehler zeigt oder kein aktuelles Backup vorhanden ist.

Interne Links

• Remote Support
• JTL Support
• JTL Shop Erstellung & Wawi Anbindung
• Preise

Problem

Das Frontend des Shops zeigt nur eine weiße Seite. Es erscheint keine sichtbare Fehlermeldung, obwohl der Shop nicht korrekt geladen wird. Das Backend kann weiterhin erreichbar sein, kann aber je nach Ursache ebenfalls betroffen sein.

Kurzlösung

Prüfe zuerst, ob nur das Frontend oder auch das Backend betroffen ist. Danach sollte das Server-Error-Log kontrolliert werden, weil eine weiße Seite häufig durch einen nicht sichtbaren PHP-Fatal-Error, ein Pluginproblem oder einen Templatefehler ausgelöst wird.

Voraussetzungen

Zugriff auf das Hosting-Panel
Zugriff auf Server-Error-Logs
FTP-Zugang
aktuelles Backup
optional Zugriff auf das JTL-Shop Backend

Werkzeuge

Hosting-Panel
Server-Error-Log
FTP-Programm
JTL-Shop Backend
Browser im privaten Modus
Texteditor

Geschätzte Dauer

10 bis 30 Minuten

Schritte

1. Prüfe, ob nur das Frontend weiß bleibt oder ob auch das Backend betroffen ist.

2. Teste den Shop in einem privaten Browserfenster, um Browsercache und Cookies als Ursache auszuschließen.

3. Notiere die letzte Änderung, zum Beispiel Update, Plugin-Aktivierung, Template-Anpassung oder PHP-Umstellung.

4. Öffne das Server-Error-Log und suche nach PHP-Fatal-Errors, Templatepfaden, Pluginpfaden oder Datenbankfehlern.

5. Leere Template- und Objektcache nur dann im Backend, wenn das Backend noch stabil erreichbar ist.

6. Stelle bei einem Templateverdacht testweise auf ein Standardtemplate zurück oder deaktiviere die letzte Anpassung.

Warnhinweis: Keine Template-Dateien, Pluginordner oder Datenbankeinträge löschen, solange kein aktuelles Backup vorhanden ist. Wenn Frontend und Backend weiß bleiben, sollte nicht weiter getestet werden, bevor das Server-Error-Log geprüft wurde.

Support sinnvoll, wenn: Support ist sinnvoll, wenn Frontend und Backend gleichzeitig betroffen sind, der Whitescreen direkt nach einem Update auftritt, das Error-Log auf PHP-Fatal-Errors verweist oder unklar ist, welche Änderung den Fehler ausgelöst hat.

Problem

Nach einem JTL-Shop Update ist das Backend nicht mehr erreichbar. Je nach Ursache erscheint ein HTTP 500 Fehler, eine leere Seite, eine Weiterleitung, ein hängendes Datenbankupdate oder der Adminbereich lädt nicht vollständig.

Kurzlösung

Prüfe zuerst, ob das Update vollständig abgeschlossen wurde und ob die PHP-Version zur Shop-Version passt. Danach sollten Server-Error-Log, Datenbankupdate und zuletzt geänderte Plugins kontrolliert werden.

Voraussetzungen

aktuelles Backup
Zugriff auf das Hosting-Panel
Zugriff auf Server-Error-Logs
FTP-Zugang
Datenbankzugang
Kenntnis der vorherigen und neuen Shop-Version

Werkzeuge

Hosting-Panel
Server-Error-Log
FTP-Programm
Datenbankverwaltung
JTL-Shop Updatebereich
Texteditor

Geschätzte Dauer

15 bis 60 Minuten

Schritte

1. Prüfe, ob Frontend, Backend oder beide Bereiche nach dem Update betroffen sind.

2. Kontrolliere im Hosting, ob die aktive PHP-Version zur installierten JTL-Shop Version passt.

3. Öffne das Server-Error-Log und suche nach PHP-Fatal-Errors, Pluginfehlern oder Datenbankfehlern.

4. Prüfe, ob ein Datenbankupdate noch offen ist oder während des Updates abgebrochen wurde.

5. Deaktiviere keine Plugins und ändere keine Datenbankwerte, bevor ein Backup geprüft wurde.

6. Setze die Fehlersuche mit Update-Log, Error-Log und Versionsstand fort, statt weitere Updates darüber zu installieren.

Warnhinweis: Ein abgebrochenes oder unvollständiges Shop-Update kann Datenbank, Plugins und Template betreffen. Keine Dateien überschreiben, keine Datenbankwerte ändern und kein weiteres Update starten, solange Backup, PHP-Version und Error-Log nicht geprüft wurden.

Support sinnvoll, wenn: Support ist sinnvoll, wenn das Backend nach einem Shop-Update nicht erreichbar ist, das Datenbankupdate hängt, Frontend und Backend gleichzeitig betroffen sind, PHP-Fatal-Errors im Error-Log stehen oder kein sicherer Rückweg über ein aktuelles Backup vorhanden ist.

Problem

Nach dem Hochladen der JTL-Shop Update-Dateien startet das Datenbankupdate nicht. Der Shop leitet zwar zum DB-Updater weiter, bleibt aber bei „Starte Update“ hängen, zeigt keine Reaktion oder das Backend ist nach dem Datei-Upload nicht mehr sauber nutzbar.

Kurzlösung

Prüfe zuerst, ob alle Update-Dateien vollständig hochgeladen wurden und ob PHP-Version, Speicherlimit und Server-Error-Log unauffällig sind. Starte kein weiteres Update darüber, solange nicht klar ist, warum der DB-Updater nicht läuft.

Voraussetzungen

aktuelles Backup
FTP-Zugang
Zugriff auf das Hosting-Panel
Zugriff auf Server-Error-Logs
Datenbankzugang
Kenntnis der alten und neuen Shop-Version

Werkzeuge

FTP-Programm
Hosting-Panel
Server-Error-Log
Datenbankverwaltung
Texteditor
JTL-Shop Backend

Geschätzte Dauer

15 bis 60 Minuten

Schritte

1. Prüfe, ob die Update-Dateien vollständig und ohne FTP-Abbruch hochgeladen wurden.

2. Kontrolliere, ob die aktive PHP-Version zur Zielversion des JTL-Shops passt.

3. Erhöhe bei Bedarf PHP memory_limit und max_execution_time im Hosting, wenn das Error-Log auf Speicher- oder Laufzeitprobleme hinweist.

4. Öffne das Server-Error-Log und suche nach PHP-Fatal-Errors, Rechteproblemen, Pluginpfaden oder Datenbankfehlern.

5. Prüfe, ob Sicherheitsregeln, .htaccess oder Serverrechte den Adminbereich oder DB-Updater blockieren.

6. Stoppe die Updateversuche, wenn der Fehler unklar bleibt, und sichere den aktuellen Dateistand sowie die Datenbank vor weiteren Änderungen.

Warnhinweis: Ein nicht gestartetes oder hängendes Datenbankupdate ist ein kritischer Update-Zustand. Keine weiteren Update-Dateien hochladen, keine Datenbankwerte ändern und keine Plugin-Tabellen löschen, solange Backup, PHP-Version, Dateistand und Error-Log nicht geprüft wurden.

Support sinnvoll, wenn: Support ist sinnvoll, wenn der DB-Updater nicht startet, bei „Starte Update“ hängen bleibt, das Backend nach dem Datei-Upload nicht mehr erreichbar ist, PHP-Fatal-Errors im Error-Log stehen oder kein getestetes Backup für eine Wiederherstellung vorhanden ist.

Problem

Der Abgleich zwischen JTL-Wawi und JTL-Shop bricht immer an derselben Stelle ab. Häufig werden zunächst einige Daten übertragen, danach stoppt der Abgleich mit einer Fehlermeldung, einem Timeout, einem 503-Fehler oder einem Eintrag im Connector- oder Shop-Log.

Kurzlösung

Prüfe zuerst, bei welchem Datentyp der Abgleich abbricht, zum Beispiel Artikel, Bilder, Kategorien, Merkmale oder Bestellungen. Danach sollten Wawi-Log, Shop-Log, Server-Error-Log und mögliche Serverlimits kontrolliert werden.

Voraussetzungen

Zugriff auf JTL-Wawi
Zugriff auf den Webshop-Abgleich
Zugriff auf das JTL-Shop Backend
Zugriff auf Shop-Logs
Zugriff auf Server-Error-Logs
optional Zugriff auf das Hosting-Panel
aktuelles Backup bei größeren Abgleich- oder Datenänderungen

Werkzeuge

JTL-Wawi
Webshop-Abgleich
JTL-Worker
Shop-Logbuch
Server-Error-Log
Hosting-Panel
Browser

Geschätzte Dauer

15 bis 60 Minuten

Schritte

1. Notiere die genaue Stelle, an der der Abgleich stoppt, zum Beispiel Artikel, Bilder, Kategorien, Merkmale oder Bestellungen.

2. Speichere die genaue Fehlermeldung aus JTL-Wawi, JTL-Worker oder dem Webshop-Abgleich.

3. Prüfe Shop-Logbuch, Connector-Log und Server-Error-Log auf passende Einträge zum Abbruchzeitpunkt.

4. Teste keinen wiederholten Komplettabgleich, bevor die Ursache eingegrenzt wurde.

5. Prüfe bei Timeouts oder 503-Fehlern Serverlimits, PHP-Laufzeit, Speicherlimit und Erreichbarkeit des Shops.

6. Grenze bei wiederholtem Abbruch einzelne Datensätze, Bilder oder Merkmale ein, bevor größere Datenänderungen durchgeführt werden.

Warnhinweis: Keinen wiederholten Komplettabgleich starten, wenn der Abgleich immer an derselben Stelle abbricht. Dadurch kann die Fehlersuche erschwert werden und bei Serverlimits, Timeouts oder fehlerhaften Datensätzen wird der gleiche Fehler meist nur erneut ausgelöst.

Support sinnvoll, wenn: Support ist sinnvoll, wenn der Abgleich immer an derselben Stelle stoppt, bestimmte Artikel oder Bilder den Abbruch auslösen, nach einem Shop-Update kein Abgleich mehr möglich ist, 503- oder Timeout-Fehler auftreten oder Bestellungen nicht mehr zuverlässig aus dem Shop abgeholt werden.

Problem

Ein Kunde hat bezahlt, aber die Bestellung wird im JTL-Shop nicht angelegt oder erscheint nicht in der Wawi. Teilweise ist die Zahlung im PayPal-Konto oder beim Zahlungsanbieter sichtbar, während im Shop keine passende Bestellung, keine Bestellbestätigung oder keine saubere Bestellnummer vorhanden ist.

Kurzlösung

Prüfe zuerst, ob die Zahlung beim Zahlungsanbieter wirklich abgeschlossen wurde und ob im Shop eine passende Bestellung, ein Zahlungslog oder eine abgebrochene Bestellung existiert. Danach sollten Zahlungsplugin, Webhooks, Shop-Log und Wawi-Abgleich kontrolliert werden.

Voraussetzungen

Zugriff auf das JTL-Shop Backend
Zugriff auf den Zahlungsanbieter
Zugriff auf Shop-Logs und Zahlungslogs
Zugriff auf JTL-Wawi
aktuelles Backup bei Pluginänderungen
optional Zugriff auf Server-Error-Logs

Werkzeuge

JTL-Shop Backend
JTL-Wawi
Shop-Logbuch
Zahlungslog
PayPal Händlerkonto oder anderer Zahlungsanbieter
Server-Error-Log
Plugin-Manager

Geschätzte Dauer

15 bis 60 Minuten

Schritte

1. Prüfe beim Zahlungsanbieter, ob die Zahlung abgeschlossen, offen, abgelehnt oder zurückgebucht wurde.

2. Suche im JTL-Shop Backend nach Kunde, Betrag, E-Mail-Adresse, Zahlungsreferenz und Zeitraum.

3. Kontrolliere Shop-Logbuch und Zahlungslog auf Fehler bei Rückleitung, Webhook, Capture oder Bestellanlage.

4. Prüfe in JTL-Wawi, ob die Bestellung übertragen wurde oder beim Webshop-Abgleich hängen bleibt.

5. Kontrolliere, ob Zahlungsplugin, Webhooks, Shopversion und PHP-Version zusammenpassen.

6. Lege die Bestellung nur nach sauberer Prüfung manuell nach und dokumentiere Zahlungsreferenz, Kundendaten und Ursache.

Warnhinweis: Zahlungen ohne passende Bestellung dürfen nicht ignoriert werden. Keine Bestellung doppelt anlegen, keine Zahlung manuell zuordnen und kein Zahlungsplugin neu installieren, bevor Zahlungsstatus, Shop-Logs, Bestellnummern und Wawi-Abgleich geprüft wurden.

Support sinnvoll, wenn: Support ist sinnvoll, wenn Zahlungen beim Zahlungsanbieter sichtbar sind, aber im Shop oder in der Wawi keine passende Bestellung existiert, Bestellnummern Lücken zeigen, keine Bestellbestätigung versendet wurde oder das Zahlungslog auf Webhook-, Capture- oder Rückleitungsfehler hinweist.

Problem

Im Checkout treten Fehler mit PayPal auf. Die Zahlungsart wird nicht angezeigt, der PayPal-Button fehlt, der Checkout lädt endlos, Kunden werden nicht zu PayPal weitergeleitet oder nach der Rückkehr von PayPal erscheint eine Fehlermeldung. In manchen Fällen wird die Zahlung ausgelöst, aber die Bestellung nicht sauber im Shop verarbeitet.

Kurzlösung

Prüfe zuerst, ob PayPal grundsätzlich im Plugin, bei den Zahlungsarten und für die passenden Versandarten aktiv ist. Danach sollten Shop-Log, PayPal-Log, Pluginversion, Webhooks und Cache kontrolliert werden.

Voraussetzungen

Zugriff auf das JTL-Shop Backend
Zugriff auf den Plugin-Manager
Zugriff auf Zahlungsarten und Versandarten
Zugriff auf Shop-Logs und Zahlungslogs
PayPal Händlerzugang
aktuelles Backup bei Pluginänderungen

Werkzeuge

JTL-Shop Backend
PayPal Checkout Plugin
Plugin-Manager
Shop-Logbuch
PayPal Zahlungslog
PayPal Händlerkonto
Browser im privaten Modus

Geschätzte Dauer

10 bis 45 Minuten

Schritte

1. Prüfe, ob PayPal im Plugin aktiv und vollständig konfiguriert ist.

2. Kontrolliere, ob PayPal bei den Zahlungsarten und für die passenden Versandarten freigegeben ist.

3. Teste den Checkout in einem privaten Browserfenster mit einem einfachen Testwarenkorb.

4. Prüfe Shop-Logbuch und PayPal-Zahlungslog auf konkrete Fehlermeldungen.

5. Kontrolliere Pluginversion, Shopversion, PHP-Version und eingerichtete PayPal-Webhooks.

6. Deaktiviere PayPal nur temporär oder biete eine alternative Zahlungsart an, wenn Kunden den Checkout nicht abschließen können.

Warnhinweis: PayPal nicht mehrfach neu installieren oder manuell aus der Datenbank entfernen, solange die Ursache nicht geprüft wurde. Zahlungsfehler sind geschäftskritisch, weil Kunden den Kauf abbrechen oder Zahlungen ohne saubere Bestellverarbeitung entstehen können.

Support sinnvoll, wenn: Support ist sinnvoll, wenn PayPal im Checkout nicht zuverlässig funktioniert, Kunden Bestellungen nicht abschließen können, Zahlungen ohne passende Bestellung auftauchen, Webhooks fehlen oder das PayPal-Log Fehler wie capture failed, OrderCaptureResponseFailed oder fehlende Bestellzuordnung zeigt.