Plugin-Dokumentation · JTL-Shop 5
Bonuspunkte – Kundenbindungsprogramm — Konfiguration & Bedienung
Alle Einstellungen im Detail sowie Gutschrift-Logik, Einlösung und ehrliche Grenzen.
Einstellungen
Zu finden unter Plugins → Bonuspunkte → Einstellungen:
| Einstellung | Standard | Wirkung |
|---|---|---|
| Plugin aktivieren | Aktiviert | Schaltet Frontend und Abgleich an/aus. |
| Punkte je 1 Euro Warenwert | 1 | Wie viele Punkte gibt es je 1 Euro Warenwert (ohne Versand)? Dezimalwerte erlaubt, Punkte werden abgerundet. Beispiel: 1 = 49,90 Euro Bestellung ergibt 49 Punkte. |
| Gutschrift ab Bestellstatus | Versendet (empfohlen) | Punkte werden erst gutgeschrieben, wenn die Bestellung diesen Status erreicht (Statuswechsel kommt per Wawi-Sync; der Abgleich läuft alle 6 Stunden). Optionen: Versendet / Versendet oder teilversendet / Bezahlt (oder später). |
| Willkommenspunkte bei Registrierung | 0 | Einmalige Punkte für neue Kundenkonten (0 = aus). Gilt nur für Registrierungen nach der Plugin-Installation. |
| Einlöse-Block: Punkte | 100 | Punkte je Einlöse-Block. Zusammen mit dem Blockwert ergibt sich die Rate, z. B. 100 Punkte = 5 Euro. |
| Einlöse-Block: Gutscheinwert in Euro | 5 | Gutscheinwert in Euro je Einlöse-Block (z. B. 5 bedeutet: 100 Punkte = 5 Euro Gutschein). |
| Mindestpunktzahl für Einlösung | 100 | Erst ab diesem Punktestand kann der Kunde einlösen. |
| Mindestbestellwert des Gutscheins (Euro) | 0 | Mindestbestellwert, ab dem der erzeugte Gutschein im Checkout einlösbar ist (0 = kein Mindestwert). |
| Gültigkeitsdauer des Gutscheins (Tage) | 365 | So viele Tage ab Erstellung ist der erzeugte Gutschein gültig. |
| Punkteverfall (Monate) | 0 | Punkte verfallen so viele Monate nach Gutschrift (0 = nie). Der Verfall wird als eigener Historieneintrag gebucht. |
| Punkte-Hinweis am Artikel anzeigen | Ja | Zeigt auf der Produktseite nahe dem Preis, wie viele Punkte der Artikel bringt. |
Wie funktioniert die Gutschrift? (wichtig zu verstehen)
Der Bestellstatus wechselt in JTL-Shop durch den Wawi-Abgleich, nicht durch Shop-Hooks. Es gibt daher keinen zuverlässigen „wurde soeben versendet"-Hook. Das Plugin nutzt stattdessen einen periodischen Abgleich alle 6 Stunden (deterministischer Time-Lock in der Tabelle wplp_state, ausgelöst durch Shop-Traffic):
- Alle Bestellungen im Zielstatus seit Plugin-Installation, die noch keine Punktebuchung haben, werden gutgeschrieben. Idempotenz über einen UNIQUE-Key — ein zweiter Lauf bucht garantiert nicht doppelt.
- Stornierte (Status -1) oder gelöschte bepunktete Bestellungen erhalten eine Gegenbuchung (keine Löschung — die Historie bleibt vollständig).
- Optional: Willkommenspunkte und Verfall.
Im Admin-Dashboard kann der Abgleich jederzeit sofort ausgeführt werden. Der Punktestand ist stets die Summe aller Buchungen (SUM über das Punkte-Journal) — es gibt kein separates Saldo-Feld, das driften könnte.
Beispielrechnung
Einstellung: 1 Punkt je Euro, Einlöse-Block 100 Punkte = 5 Euro, Mindestpunktzahl 100.
- Bestellung über 149,90 Euro Warenwert (ohne Versand) → 149 Punkte nach Versand.
- Bei 300 Punkten kann der Kunde 1–3 Blöcke einlösen: 100 P = 5 €, 200 P = 10 €, 300 P = 15 €.
- Der erzeugte Gutschein ist an das Kundenkonto gebunden, genau 1x verwendbar und standardmäßig 365 Tage gültig.
Einlösung Schritt für Schritt
- Kunde meldet sich an und öffnet Punktekonto (Link auf „Mein Konto" oder direkt
/punktekonto). - Punkte-Anzahl (in Blöcken) wählen → Gutschein erstellen.
- Der Gutschein-Code (Format
WP-XXXX-XXXX) erscheint sofort und steht in der Historie. - Im Warenkorb/Checkout als normalen Gutschein eingeben.
Technisch laufen Punkte-Abbuchung und Kupon-Anlage in einer DB-Transaktion. Schlägt die Kupon-Anlage fehl, wird die Abbuchung zurückgerollt und der Fehler geloggt — Punkte gehen nie verloren. Der Kupon wird als additiver Einzelcode-Insert in die Kern-Kupontabellen (tkupon + tkuponsprache) angelegt; bestehende Kupons werden nie verändert.
Manuelle Korrekturen
Im Dashboard unter Bonuspunkte: Kundennummer, Punkte (+/-) und Pflicht-Grund eingeben. Typische Fälle: rückwirkende Punkte für Bestandskunden, Kulanz, Korrektur. Der Grund erscheint in der Kunden-Historie.
Admin-Dashboard
Unter Bonuspunkte: Programm-KPIs (vergebene/eingelöste/offene Punkte, Gutscheine), Kunden-Suche mit Punktestand, manuelle Gutschrift/Korrektur mit Pflicht-Grund, Abgleich-Status sowie ein Sofort-Abgleich-Button.
Ehrliche Grenzen
- Der Abgleich braucht Shop-Traffic. Ohne Besucher läuft er erst beim nächsten Seitenaufruf. Gutschriften erscheinen dadurch bis zu ~6 Stunden (plus Wawi-Sync-Intervall) nach dem Statuswechsel — nicht in Echtzeit.
- Kein automatischer Rückwirkend-Import: Bestellungen und Registrierungen vor der Installation werden nicht automatisch bepunktet (bewusst — sonst würden Alt-Bestellungen massenhaft Punkte erzeugen). Bestandskunden können per manueller Buchung Punkte erhalten.
- Status-Rücksprünge (z. B. von „versendet" zurück auf „in Bearbeitung") werden nicht verrechnet — nur echte Stornos (Status -1) und gelöschte Bestellungen erzeugen eine Gegenbuchung.
- Gastbestellungen sammeln keine Punkte (kein Konto, keine Einlösung möglich).
- Der Punkte-Hinweis am Artikel zeigt den Wert auf Basis des aktuellen Bruttopreises; der tatsächliche Punktwert richtet sich nach dem Warenwert der späteren Bestellung (z. B. nach Rabatten).
- Währung: Die Rechnung basiert auf den Shop-Werten in Standardwährung. Für Multi-Currency-Shops ist das Plugin nicht ausgelegt.
- Teilstornos werden nicht anteilig verrechnet (nur Komplett-Storno).
Häufige Fragen
Warum kommt die Gutschrift nicht sofort nach dem Versand?
Der Abgleich läuft alle 6 Stunden und braucht Shop-Traffic. Im Dashboard kann er jederzeit sofort ausgeführt werden.
Was passiert bei der Deinstallation?
Bereits erzeugte Gutscheine bleiben gültig. Bei „Daten löschen" werden Punktestände und Historie entfernt.
Bekommen Bestandskunden rückwirkend Punkte für alte Bestellungen?
Nicht automatisch — nur per manueller Buchung im Dashboard.
Support
webpowers UG (haftungsbeschränkt) · Hillenbrandstr. 9, 86156 Augsburg · E-Mail: max@webpowers.org