Konfiguration

Öffnen Sie die Plugin-Konfiguration unter Erweiterungen > Meine Erweiterungen > JTL Gutscheine > Konfiguration.

Einstellungen

API-Basis-URL

Feld	API-Basis-URL
Standard	https://vouchers.api.jtl-software.com/v1/
Beschreibung	Die Basis-URL der JTL Vouchers API. Ändern Sie diesen Wert nur, wenn Sie eine andere API-Instanz verwenden (z.B. Staging).

TIP

In der Regel müssen Sie diesen Wert nicht ändern.

E-Mail-Vorlage für Gutscheinversand

Feld	E-Mail-Vorlage Gutscheinversand
Standard	— (nicht gesetzt)
Beschreibung	Wählen Sie die Mail-Vorlage, die beim Versand von gekauften Gutscheincodes an Kunden verwendet wird.

So richten Sie die E-Mail-Vorlage ein:

1. Navigieren Sie zu Einstellungen > Shop > E-Mail-Vorlagen
2. Erstellen Sie eine neue Vorlage oder bearbeiten Sie eine bestehende
3. Verwenden Sie folgende Variablen in der Vorlage:

Variable	Beschreibung
	Array der Gutscheincodes
	Name des Kunden
	Bestellnummer

4. Wählen Sie diese Vorlage in der Plugin-Konfiguration aus

PDF-Hintergrundbild

Feld	PDF-Hintergrundbild
Standard	— (nicht gesetzt)
Beschreibung	Laden Sie ein Bild (PNG, JPG) oder PDF hoch, das als Hintergrund für generierte Gutschein-PDFs verwendet wird.

Empfohlene Größe

Verwenden Sie ein Bild im Format DIN A4 Hochformat (210 × 297 mm) mit einer Auflösung von mindestens 150 DPI. Weitere Hinweise zu Layout und CSS-Anpassung finden Sie unter PDF-Gutscheine.

Gutschein-Code nach Zahlungseingang sofort erstellen und versenden

Feld	Gutschein-Code nach Zahlungseingang sofort erstellen und versenden
Standard	An
Beschreibung	Wenn aktiv, erstellt das Plugin den Gutscheincode automatisch bei Zahlungseingang und versendet ihn per E-Mail an den Kunden. Wenn deaktiviert, passiert nach der Zahlung nichts — die Code-Erstellung und der Versand müssen manuell erfolgen (z.B. direkt in JTL WaWi).

Wann deaktivieren?

Deaktivieren Sie diese Option, wenn Sie Gutschein-Produkte verkaufen, aber die Auslieferung der Codes zentral über JTL WaWi steuern möchten — z.B. bei manueller Prüfung vor Versand oder bei Codes aus einem separaten Kontingent.

Eingabefeld für Pins anzeigen

Feld	Eingabefeld für Pins anzeigen
Standard	Aus
Beschreibung	Zeigt ein PIN-Eingabefeld im Warenkorb an. Wird benötigt, falls Sie PIN-geschützte Gutscheincodes verwenden.

INFO

Die meisten Shops benötigen diese Option nicht. Aktivieren Sie sie nur, wenn Sie in Ihrem JTL Vouchers-Konto Gutscheine mit PIN-Schutz verwenden.

Gekaufte Voucher und Guthaben in Kundenmenü anzeigen

Feld	Gekaufte Voucher und Guthaben in Kundenmenü anzeigen
Standard	Aus
Beschreibung	Aktiviert die Seite „Meine Gutscheine" im Kundenkonto. Kunden können dort ihre eingelösten und gekauften Gutscheine mit Restguthaben einsehen.

Datenschutzhinweis

Wenn Kunden Gutscheine verschenken, könnte die Anzeige des Restguthabens datenschutzrechtlich problematisch sein, da der Käufer das Nutzungsverhalten des Beschenkten einsehen kann. Aktivieren Sie diese Option nur, wenn dies für Ihren Anwendungsfall unbedenklich ist.

---

Gültigkeitsdauer

Das Plugin berechnet automatisch ein Ablaufdatum, wenn ein neuer Gutschein erstellt wird. Je nach Entstehungskontext (Kauf im Shop, Geschenk via Newsletter, manuelle Anlage im Admin) gelten unterschiedliche Regeln.

Gekaufte Gutscheine

Gutscheine, die Kunden als Produkt im Storefront kaufen und nach Zahlungseingang automatisch per E-Mail erhalten.

Feld	Standard	Beschreibung
Gültigkeit in Monaten	36	Basislaufzeit ab Kaufdatum
Gültig bis Jahresende	Ja	Verlängert automatisch bis zum 31.12. des Zieljahres

Rechtlicher Hintergrund: § 195 BGB sieht eine Verjährungsfrist von 3 Jahren vor, die erst zum Ende des Jahres zu laufen beginnt, in dem der Gutschein ausgestellt wurde. Mit der Option „Gültig bis Jahresende" wird diese gesetzeskonforme Berechnung automatisch angewendet.

Beispiele mit aktivierter Option:

Kaufdatum	Basislaufzeit	Ablaufdatum
15.03.2024	36 Monate	31.12.2027
01.11.2024	36 Monate	31.12.2027
01.01.2024	36 Monate	31.12.2027

Empfehlung

Lassen Sie „Gültig bis Jahresende" aktiviert. Die Verlängerung ist für Kunden positiv und entspricht der gesetzlichen Regelung.

Geschenk-Gutscheine

Gutscheine, die das Plugin automatisch an Kunden verschickt — z.B. als Geburtstagsgutschein über den Flow Builder oder als Willkommensgutschein nach der Newsletter-Anmeldung.

Feld	Standard	Beschreibung
Gültigkeit in Monaten	3	Laufzeit ab Ausstellungsdatum

Da Geschenk-Gutscheine kurzfristig eingelöst werden sollen, gibt es hier keine Jahresende-Option.

Sonstige Gutscheine

Gutscheine, die manuell im Admin angelegt werden — z.B. als Kulanzgutschein für einen Kunden oder für Marketingaktionen.

Feld	Standard	Beschreibung
Gültigkeit in Monaten	36	Basislaufzeit ab Erstellungsdatum
Gültig bis Jahresende	Nein	Verlängert auf 31.12. des Zieljahres, falls aktiviert

Die Jahresende-Option ist hier standardmäßig deaktiviert, da nicht alle manuell angelegten Gutscheine diese Logik benötigen. Aktivieren Sie sie, wenn Sie auch für diese Gutscheine die gesetzeskonforme BGB-Berechnung wünschen.

---

Geburtstags-Gutschein

Feld	Standard-Betrag (EUR)
Standard	10
Beschreibung	Gutscheinwert in EUR für automatisch versendete Geburtstagsgutscheine. Dieser Wert wird verwendet, wenn im Flow Builder kein abweichender Betrag konfiguriert ist.

Weitere Informationen zur Einrichtung des Geburtstags-Triggers finden Sie unter Geburtstags-Gutschein.

---

Reservierungs-Bereinigung

Feld	Bereinigung nach (Stunden)
Standard	24
Beschreibung	Zeitraum in Stunden, nach dem nicht abgeschlossene Gutschein-Reservierungen automatisch storniert werden.

Wenn ein Kunde einen Gutschein im Warenkorb hat, wird eine Reservierung bei der JTL Vouchers API erstellt. Falls der Kunde die Bestellung nicht abschließt (z.B. Warenkorbabbruch), bleibt diese Reservierung bestehen. Der Bereinigungsjob läuft stündlich und storniert Reservierungen, die älter als der konfigurierte Zeitraum sind.

Berechtigungen (ACL)

Das Plugin bringt eigene Berechtigungsrollen mit, die Sie Ihren Administratoren zuweisen können:

Rolle	Berechtigung
Betrachter	Gutscheine ansehen, Verbindungsstatus prüfen
Bearbeiter	Gutscheine bearbeiten, Status ändern, Verbindung verwalten
Ersteller	Neue Gutscheine anlegen (beinhaltet Bearbeiter-Rechte)
Löscher	Gutscheine löschen (beinhaltet Bearbeiter-Rechte)

So weisen Sie Rollen zu:

1. Navigieren Sie zu Einstellungen > System > Benutzer & Rechte
2. Bearbeiten Sie die gewünschte Rolle
3. Aktivieren Sie unter JTL Gutscheine die gewünschten Berechtigungen