🎟️ Backswing Gutschein-Aktion mit chayns.codes

Diese Anleitung zeigt, wie Du mit chayns.codes eine automatische Gutschein-Aktion umsetzt, bei der Gäste auf Basis ihrer Bestellungen vom Vortag einen Gutschein erhalten.

Der Fokus liegt auf einer einfachen, nachvollziehbaren Umsetzung, die sich für Aktionen wie Neujahr, Jubiläen oder Dankeschön-Kampagnen eignet.

🧩 Was macht der Code?

Der bereitgestellte chayns.codes-Job erledigt automatisch folgende Schritte:

  • Lädt alle Bestellungen des Vortags

  • Ermittelt pro Bestellung die zugehörige Person und den Bestellwert

  • Summiert die Bestellwerte pro Person

  • Erstellt genau einen Gutschein pro Person in Höhe der Gesamtausgabe der Vortages

  • Speichert die Herausgabe, damit der Gutschein nicht doppelt vergeben werden kann

⚙️ Voraussetzungen

Bevor Du den Code einsetzen kannst, benötigst Du:

  • einen aktiven chayns-Shop

  • eine angelegten Gutschein

  • Zugriff auf chayns.codes für Deine Site

Zusätzlich brauchst Du zwei IDs, die im Code verwendet werden:

🧠 Wo trage ich die IDs ein?

Im Code findest Du am Anfang folgende Konstanten:

Diese beiden Werte musst du durch Deine eigenen IDs ersetzen.

⏱️ Ausführung des Jobs

Der Code ist dafür gedacht, automatisch um 00:00 Uhr ausgeführt zu werden.

Beim Anlegen des chayns.codes-Backends kann als Trigger „Zeit“ ausgewählt werden. Unter „Erweitert“ lässt sich anschließend eine Cron-Expression hinterlegen.

Beispiel: Ausführung an Neujahr

Für eine einmalige Gutschein-Aktion am 01. Januar um 00:00 Uhr kann folgende Cron-Expression verwendet werden:

Diese Cron-Expression bedeutet:

  • 0  → Minute 0

  • 0  → Stunde 0 (Mitternacht)

  • 1 → erster Tag des Monats

  • 1 → Januar

  • * → jedes Jahr

Der Job wird damit jedes Jahr am 01.01. um 00:00 Uhr ausgeführt.

💻 Code

Zum Kopieren 😊 

🔁 Schutz vor doppelten Gutscheinen

Damit ein Gutschein nicht mehrfach vergeben wird:

  • wird pro Person und Tag ein eindeutiger Key gespeichert

  • existiert dieser Key bereits, wird kein weiterer Gutschein erstellt

So ist der Job:

  • sicher bei erneuter Ausführung

  • unkritisch bei manuellen Tests

  • robust gegenüber Wiederholungen

🧪 Testen & Nachvollziehen

Während der Ausführung werden aussagekräftige Logs geschrieben, z. B.:

  • wie viele Bestellungen gefunden wurden

  • wie viele Personen berücksichtigt wurden

  • für wen ein Gutschein erstellt wurde

So kannst Du jederzeit nachvollziehen, was der Job gemacht hat.

✅ Zusammenfassung

Mit diesem chayns.codes-Job kannst du:

  • automatische Gutschein-Aktionen umsetzen

  • Gäste gezielt für ihre Bestellungen belohnen

  • Aktionen sicher, nachvollziehbar und ohne Doppelvergaben durchführen

Die Lösung ist bewusst einfach gehalten und kann leicht an andere Aktionen oder Zeiträume angepasst werden.