Fehlerbehebung

Verbindungsprobleme

„Verbindung fehlgeschlagen" beim Verbinden

Mögliche Ursachen:

• Die Verbindungs-PIN ist ungültig oder bereits verwendet
• Die JTL Vouchers API ist nicht erreichbar
• Die API-Basis-URL in der Konfiguration ist falsch

Lösung:

1. Prüfen Sie, ob die PIN korrekt eingegeben wurde
2. Erstellen Sie ggf. eine neue PIN in Ihrem JTL Vouchers Konto
3. Prüfen Sie, ob die API-URL auf https://vouchers.api.jtl-software.com/v1/ gesetzt ist

Verbindung plötzlich getrennt

Ursache: Die OAuth2-Zugangsdaten sind ungültig geworden (z.B. durch Widerruf im JTL Vouchers Konto).

Lösung:

1. Trennen Sie die bestehende Verbindung
2. Erstellen Sie eine neue Verbindungs-PIN im JTL Vouchers Konto
3. Verbinden Sie erneut

Gutschein einlösen

„Gutscheincode ist ungültig oder abgelaufen"

Mögliche Ursachen:

• Der Code existiert nicht bei JTL Vouchers
• Der Gutschein ist deaktiviert
• Der Gutschein ist abgelaufen
• Der Gutschein hat kein Restguthaben mehr

Lösung:

1. Prüfen Sie den Gutschein in der Administration unter Marketing > JTL Vouchers
2. Stellen Sie sicher, dass der Status „Aktiv" ist
3. Prüfen Sie das Restguthaben und das Ablaufdatum

Gutscheinrabatt erscheint nicht im Warenkorb

Mögliche Ursachen:

• Die Währung des Gutscheins stimmt nicht mit dem Verkaufskanal überein
• Der Warenkorb ist leer
• Ein Cache-Problem

Lösung:

1. Prüfen Sie die Währung des Gutscheins und des Verkaufskanals
2. Leeren Sie den Shopware-Cache: bin/console cache:clear
3. Laden Sie die Warenkorbseite neu

E-Mail-Versand

Kunde erhält keinen Gutscheincode nach dem Kauf

Mögliche Ursachen:

• Keine E-Mail-Vorlage in der Plugin-Konfiguration hinterlegt
• Der Message-Queue-Worker ist nicht aktiv
• E-Mail-Versand in Shopware ist generell fehlerhaft

Lösung:

1. Prüfen Sie die E-Mail-Vorlage-Konfiguration
2. Starten Sie den Message-Queue-Worker:

   bin/console messenger:consume async

3. Prüfen Sie die Shopware-Logs auf Fehlermeldungen
4. Testen Sie den E-Mail-Versand über Einstellungen > System > Mailer

PDF-Generierung

PDF zeigt keinen Hintergrund

Ursache: Kein Hintergrundbild in der Plugin-Konfiguration hinterlegt.

Lösung: Laden Sie ein Hintergrundbild in der Plugin-Konfiguration hoch.

PDF-Download schlägt fehl

Mögliche Ursachen:

• Der Gutschein existiert nicht mehr bei JTL Vouchers
• Speicherprobleme auf dem Server

Lösung:

1. Prüfen Sie, ob der Gutschein in der JTL Vouchers API existiert
2. Prüfen Sie die PHP-Speicherlimits (memory_limit in php.ini)

Reservierungen

Gutscheinguthaben blockiert, obwohl nicht bestellt

Ursache: Eine Reservierung aus einem abgebrochenen Warenkorb wurde noch nicht bereinigt.

Lösung:

• Das eigentliche Guthaben wird von JTL automatisch freigegeben, sobald die Reservierung serverseitig abläuft. Der stündliche Bereinigungsjob entfernt lediglich den lokalen Reservierungs-Eintrag.
• Den Bereinigungsjob können Sie auch manuell auslösen, indem Sie die Fälligkeit vorziehen und den Scheduled-Task-Worker einmal laufen lassen:

  bin/console dbal:run-sql "UPDATE scheduled_task SET next_execution_time = '2000-01-01' WHERE name = 'i7_jtl_vouchers.reservation_cleanup'"
  bin/console messenger:consume scheduled_task --limit=1 -vv

Allgemein

Cache leeren

Nach Konfigurationsänderungen immer den Cache leeren:

bin/console cache:clear

Oder über die Administration: Einstellungen > System > Caches & Indizes > Cache leeren

Logs prüfen

# Aktuelle Fehlermeldungen anzeigen (eigene Log-Datei des Plugins)
tail -f var/log/I7JtlVouchers-$(date +%F).log