Entitäten, Events & geplante Aufgaben
Referenz für die Daten, die Reward Engine speichert, die Business-Events, die sie an den Flow Builder sendet, und die Hintergrundaufgaben, die sie ausführt. Für die globalen Einstellungen siehe die Konfigurationsreferenz.
Entitäten
| Entität | In der Oberfläche | Zweck |
|---|---|---|
Sammel-Regel (ssd_reward_promo_rule) | Sammel-Möglichkeiten | Eine Regel, die Punkte oder eine Belohnung gewährt, wenn ihr Auslöser und ihre Bedingungen zutreffen. Übersetzbar; mit Rule-Builder-Bedingungen verknüpft. |
Einlöse-Regel (ssd_reward_spend_rule) | Einlöse-Möglichkeiten | Eine Regel, die Kunden Punkte in Wert umwandeln lässt. Übersetzbar; mit Rule-Builder-Bedingungen verknüpft. |
| Loyalty-Konto | Kunden-Tab Loyalty | Der Punktestand und Status eines Kunden. |
| Punkte-Aktivität | Punkte-Aktivität | Das Protokoll einzelner Punktebewegungen (sammeln, einlösen, anpassen, verfallen, erstatten). |
| Reward-Protokoll | (Audit) | Der erstattungssichere Datensatz gewährter Belohnungen, genutzt, um Punkte bei Erstattungen zurückzukehren. |
| Empfehlungslink | — | Der eindeutige Empfehlungscode/-link eines Kunden. |
| Empfehlungs-Einlösung | — | Ein Datensatz darüber, dass ein Freund einen Empfehlungslink genutzt hat. |
Business-Events (Flow Builder)
Diese erscheinen unter Einstellungen → Flow Builder als Auslöser, gruppiert unter Reward Engine. Nutze sie, um E-Mails zu versenden oder jede beliebige Flow-Aktion auszuführen. Die Event-Namen erscheinen in der Oberfläche auf Englisch:
| Event | Löst aus, wenn |
|---|---|
| Reward earned | Ein Kunde eine Belohnung aus einer Regel verdient. |
| Voucher issued | Ein Gutschein an einen Kunden ausgegeben wird. |
| Points credited from refund | Eine Erstattung zuvor gewährte Punkte zurückkehrt. |
| Admin notified customer of adjustment | Eine manuelle Punkteanpassung den Kunden benachrichtigt. |
| Points expired | Ein Punkte-Lot sein Verfallsdatum erreicht. |
| Points expiring soon | Ein Punkte-Lot innerhalb der konfigurierten Vorlaufzeit liegt. |
| Referral – Friend joined | Ein geworbener Freund ein Konto erstellt. |
| Referral – Friend's first order | Ein geworbener Freund seine erste Bestellung abschließt. |
Geplante Aufgaben
Werden von Shopwares Scheduler ausgeführt — stelle sicher, dass im Produktivbetrieb ein scheduled_task:run-Worker aktiv ist.
| Aufgabe | Zweck |
|---|---|
| Punkte verfallen lassen | Lässt fällige Punkte-Lots verfallen und erfasst die Bewegung. |
| Verfallswarnung für Punkte | Sendet Points expiring soon für Lots innerhalb der Warn-Vorlaufzeit. |
| Geburtstag | Löst Geburtstags-Belohnungen aus. |
| Jubiläum | Löst Jubiläums-Belohnungen aus. |
| Warenkorbabbruch | Löst Warenkorbabbruch-Belohnungen aus. |
Protokollierung
Das Plugin schreibt in einen eigenen, täglich rotierenden Log-Kanal ssd_reward_engine (Datei var/log/ssd_reward_engine-YYYY-MM-DD.log, 14 Tage Aufbewahrung) statt in das Haupt-Shopware-Log. Kunden-PII wird nie protokolliert — nur IDs, Beträge, Anzahlen und Entscheidungsgründe.