Flow Builder und Regeln

Das Bonus System bringt eigene Bausteine für den Flow Builder und den Regel-Builder mit. Damit lassen sich Punkte automatisiert buchen und Punktestände als Bedingung in Shopware verwenden.

Flow Builder: Trigger „Bonus Punkte verändert“

Technischer Name: bonus_system.customer_points_changed

Der Trigger wird ausgelöst, sobald sich das Punktekonto eines Kunden ändert — durch eine Bestellung, eine manuelle Buchung, eine Flow-Aktion, den Verfall von Punkten oder über die Admin API. Er stellt Kunden- und Mail-Daten bereit und lässt sich daher direkt mit der Aktion E-Mail versenden kombinieren, zum Beispiel für eine Nachricht „Du hast neue Punkte gesammelt“.

Der Trigger wird auch dann ausgelöst, wenn die Buchung 0 Punkte umfasst.

Flow Builder: Aktion „Punktestand ändern“

Technischer Name: action.change.bonus.points

Die Aktion schreibt eine sofort freigegebene Buchung auf das Punktekonto des Kunden.

Feld	Beschreibung
Punkte	Anzahl der Punkte. Negative Werte ziehen Punkte ab.
Grund	Buchungstext, der dem Kunden im Punktekonto und im Admin-Modul angezeigt wird. Pflichtangabe.

Voraussetzungen:

Der Flow muss von einem Trigger mit Kundenbezug ausgehen, zum Beispiel Kunde registriert sich oder Bestellung wurde bezahlt.
Beide Felder müssen gefüllt sein — ohne Grund oder mit 0 Punkten führt die Aktion nichts aus.
Die Aktion ist verzögerbar und lässt sich hinter der Shopware-Aktion Verzögerung einsetzen.

Typische Anwendungsfälle: Willkommenspunkte nach der Registrierung, Punkte als Entschädigung nach einer Reklamation oder eine Aktionsgutschrift für eine Kundengruppe.

Regeln für den Regel-Builder

Unter Einstellungen → Regeln stehen drei zusätzliche Bedingungen zur Verfügung:

Bedingung	Bedeutung
Kunde hat Bonus Punkte	Prüft, ob der eingeloggte Kunde ein Punkteguthaben besitzt (Ja/Nein).
Bonus Punkte Kunde	Vergleicht das Punkteguthaben mit einem Wert (gleich, größer, kleiner …).
Anzahl der eingelösten Punkte im Warenkorb	Vergleicht die im aktuellen Warenkorb eingelösten Punkte mit einem Wert.

Die Bedingungen greifen nur bei eingeloggten Kunden. Verwenden lassen sie sich überall, wo Shopware Regeln auswertet — etwa für Versand- und Zahlungsartverfügbarkeit, Rabatte oder Aktionen — und zusätzlich in den Bedingungen des Bonus Systems über die Konditionsart Regel + Alle Produkte beziehungsweise Regel + Produkte / Produkt Gruppen.

E-Mail-Vorlagen

Bei der Installation wird die Vorlage Bonuspunkte Ablaufbenachrichtigung angelegt (Typ prems.bonus_system.points_expiration_notification_type). Sie wird verwendet, wenn unter Verfall der Punkte die automatische E-Mail aktiviert ist, und kann unter Einstellungen → E-Mail-Vorlagen angepasst werden. Im Template steht die Entität bonusPoints (das Punktekonto des Kunden) zur Verfügung.

Alle weiteren E-Mails bauen Sie über den Flow Builder: Trigger Bonus Punkte verändert plus Aktion E-Mail versenden mit einer eigenen Vorlage.