Aktionen & Gutscheine
Überblick
Zwei verwandte, aber verschiedene Dinge:
- Eine Aktion ist ein Zeitraum mit einem Namen — darunter werden Artikel und Kategorien
billiger. Sie wirkt automatisch für alle, die in dieser Zeit kaufen.
- Ein Gutschein ist ein Rabattcode, der einen Auftrag günstiger macht. Er wirkt nur, wenn ihn
jemand einlöst.
Der Unterschied ist keine Wortklauberei: Eine Aktion braucht niemanden, der etwas eingibt; ein Gutschein braucht genau das.
Kernaufgaben
Aktion anlegen. Name, Zeitraum und die betroffenen Artikel oder Kategorien. Nach Ablauf endet die Aktion von selbst — das ist der Sinn des Zeitraums.
Gutscheine ausgeben. Rabattcodes mit ihren Bedingungen. Eingelöst wird am Auftrag, nicht hier.
Die Steuer-Regel kennen. Die Anwendung sagt es selbst: Eine Gutschein-Zeile je Steuersatz — damit die Umsatzsteuer stimmt. Ein Rabatt auf einen Auftrag mit 7 % und 19 % lässt sich nicht in einer Zeile abbilden, ohne dass die Steuer falsch wird. Deshalb entstehen mehrere Zeilen; das ist korrekt und kein Anzeigefehler.
Felder im Detail
Aktion
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Name name | ja | Text, max. 160 Zeichen | Wie die Aktion heißt. Sie erscheint als eigene Position auf dem Beleg — der Kunde liest diesen Namen. |
Beschreibung description | nein | Text | Wofür die Aktion gedacht ist. |
Regeln rules | ja | Bedingungen und Nachlass | Wann sie greift und was sie gewährt — etwa „ab 3 Stück 10 % auf die Kategorie". |
Kundengruppe customerGroupId | nein | bestehende Gruppe | Für wen die Aktion gilt. Leer heißt: für alle. |
Rang priority | nein | Zahl | Was gewinnt, wenn mehrere Aktionen passen. |
Gültig von / bis validFrom, validTo | nein | Datum | Der Aktionszeitraum. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke. |
Aktiv active | nein | Ja/Nein | Ob die Aktion greift. |
Ein gewährter Nachlass wird als Beleg-Position je Steuersatz ausgewiesen. Das ist kein Schönheitsfehler, sondern Voraussetzung dafür, dass die Steuerausweisung stimmt, wenn ein Warenkorb mehrere Steuersätze enthält.
Gutschein
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Code code | nein | Text, max. 40 Zeichen | Der Einlösecode. Leer gelassen erzeugt das System welche. |
Anzahl Codes codeCount | nein | 1 bis 500 | Wie viele Einzelcodes erzeugt werden. Einzelcodes lassen sich je Empfänger nachverfolgen; ein gemeinsamer Code nicht. |
Bezeichnung label | nein | Text, max. 160 Zeichen | Wie der Gutschein auf dem Beleg heißt. |
Gutscheinart kind | nein | Rabatt oder Guthaben | Ein Rabatt mindert die Bemessungsgrundlage — die Umsatzsteuer sinkt anteilig mit. Ein Guthaben ist ein verkaufter Wertgutschein und wirkt bei der Einlösung wie eine Zahlung; die Steuer entsteht erst beim Verkauf der Ware. Rabatte gelten nur am Beleg, Guthaben nur an der Kasse. Ohne Angabe: Rabatt. Nach der ersten Einlösung nicht mehr änderbar. |
Art rateType | ja | Betrag oder Prozent | Ob ein fester Betrag oder ein Anteil abgezogen wird. Ein Guthaben ist immer ein Betrag. |
Wert valueAmount | ja | größer als 0 | Wie viel. |
Höchstnachlass maxDiscountAmount | nein | Betrag, 0 oder mehr | Deckelt einen Prozent-Gutschein. Ohne diese Grenze kostet ein 20-%-Gutschein bei einem großen Auftrag ein Vielfaches des Gedachten. |
Mindestbestellwert minOrderAmount | nein | Betrag, 0 oder mehr | Ab welchem Wert er einlösbar ist. |
Kunde customerId | nein | bestehender Kunde | Bindet den Gutschein an eine Person. Leer heißt: jeder mit dem Code. |
Einlösungen höchstens maxRedemptions | nein | Zahl, 0 oder mehr | Wie oft er insgesamt eingelöst werden darf. Der zweite Schutz gegen einen weitergereichten Code. |
Gültig von / bis validFrom, validTo | nein | Datum | Einlösezeitraum. |
Marke brandId | nein | eine Ihrer Marken | Für welche Marke. |
Aktiv active | nein | Ja/Nein | Ob der Gutschein einlösbar ist. |
Einstellungen & Rechte
- Modul
module.promotions. promotions.campaign.view/.managefür Aktionen,promotions.voucher.view/.manage
für Gutscheine.
- Aktionen greifen in die Preisfindung ein, siehe Preise & Einheiten.
- Gerechnet wird im Kern, siehe Commerce-Kernel.
FAQ & Fehlerbilder
Der Aktionspreis erscheint nicht. Prüfen Sie den Zeitraum — und ob Artikel oder Kategorie wirklich zur Aktion gehören.
Ein Auftrag zeigt mehrere Gutschein-Zeilen. So gewollt: eine Zeile je Steuersatz. Alles andere ergäbe eine falsche Umsatzsteuer.
Der Gutschein wirkt nicht. Er muss am Auftrag eingelöst werden. Ausgeben allein genügt nicht.
Aktion oder Gutschein? Soll es für alle in einem Zeitraum gelten: Aktion. Soll es an eine Person oder Kampagne gebunden sein: Gutschein.