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 Gutscheine
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:

• Warten Sie auf den nächsten Bereinigungslauf (stündlich)
• Oder passen Sie den Bereinigungszeitraum an
• Der Bereinigungsjob kann auch manuell ausgelöst werden:

  bin/console scheduled-task:run i7_jtl_voucher_reservation_cleanup

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
tail -f var/log/prod.log | grep -i voucher