FAQ

Allgemein

Was ist JTL Vouchers?

JTL Vouchers ist ein Gutscheinsystem von JTL Software, das über eine API angebunden wird. Es ermöglicht das Erstellen, Verwalten und Einlösen von Gutscheinen über verschiedene Verkaufskanäle hinweg.

Kann ich das Plugin mit mehreren Shops verwenden?

Ja. JTL Vouchers ist ein zentrales System — Gutscheine können in mehreren Shops eingelöst werden, die an dasselbe JTL Vouchers Konto angebunden sind. Das Guthaben wird zentral verwaltet.

Unterstützt das Plugin mehrere Währungen?

Gutscheine werden in einer bestimmten Währung erstellt. Ein EUR-Gutschein kann nur in einem Verkaufskanal mit EUR-Währung eingelöst werden.

Gutscheine einlösen

Kann ein Kunde mehrere Gutscheine gleichzeitig verwenden?

Ja, es können beliebig viele Gutscheine in einer Bestellung kombiniert werden.

Was passiert bei Teileinlösung?

Wenn der Gutscheinwert höher ist als der Bestellwert, wird nur der benötigte Betrag abgezogen. Das Restguthaben bleibt erhalten.

Kann ein Gutschein zusammen mit einem Aktionscode verwendet werden?

Ja. Das Eingabefeld im Warenkorb akzeptiert sowohl Gutscheincodes als auch Shopware-Aktionscodes. Beide können gleichzeitig verwendet werden.

Wofür ist die PIN?

Manche Gutscheine haben eine zusätzliche PIN als Sicherheitsmerkmal. Wenn eine PIN gesetzt ist, muss diese bei der Einlösung angegeben werden. Das PIN-Feld ist standardmäßig ausgeblendet und kann in der Plugin-Konfiguration unter Eingabefeld für Pins anzeigen aktiviert werden.

Gutschein-Produkte

Wie erhält der Kunde seinen Gutscheincode?

Nach Zahlungseingang wird der Code automatisch per E-Mail versendet — inklusive PDF-Anhang. Der Versand erfolgt erst, wenn die Transaktion als bezahlt markiert wird (nicht bereits bei Bestellabschluss).

Falls die Option „Gekaufte Voucher und Guthaben in Kundenmenü anzeigen" aktiviert ist, ist der Code zusätzlich im Kundenkonto unter „Meine Gutscheine" sichtbar.

Kann ich den Gutscheinbetrag variabel gestalten?

Ja. Markieren Sie das Produkt als Gutschein-Produkt mit deaktiviertem „Fester Betrag". Der Kunde kann dann den Betrag selbst wählen, bis zum konfigurierten Maximalbetrag.

Werden Versandkosten berechnet?

Nein. Gutschein-Produkte werden automatisch als digitale Produkte behandelt und lösen keine Versandkosten aus.

Stornierung

Was passiert bei einer Stornierung?

Bei einer vollständigen Bestellstornierung wird das Gutscheinguthaben automatisch zurückgebucht. Gekaufte Gutschein-Produkte werden deaktiviert.

Werden Teilstornierungen unterstützt?

Aktuell werden nur vollständige Stornierungen automatisch verarbeitet. Bei Teilstornierungen muss das Guthaben manuell über JTL Vouchers angepasst werden.

Technisch

Muss die Message Queue aktiv sein?

Ja. Die Gutscheinbuchung und der E-Mail-Versand laufen asynchron über die Shopware Message Queue. Ohne aktiven Worker werden diese Aufgaben nicht verarbeitet.

bin/console messenger:consume async

Wie oft läuft die Reservierungs-Bereinigung?

Stündlich. Der Bereinigungszeitraum ist in der Plugin-Konfiguration einstellbar (Standard: 24 Stunden).

Wo finde ich Fehlermeldungen?

Fehlermeldungen werden in den Shopware-Logs gespeichert:

# Produktivumgebung
var/log/prod.log

# Entwicklungsumgebung
var/log/dev.log