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 Beleg — Angebot, Auftrag oder Rechnung — 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 Beleg, nicht hier: in der Karte „Gutschein" am Angebot, am Auftrag oder an der Rechnung (nur im Entwurf).
Gutschein weitergeben. Wird aus dem Angebot ein Auftrag, wandert der eingelöste Gutschein mit — zurücknehmen lässt er sich danach am Auftrag. Endet ein Beleg ohne Geschäft (Angebot abgelehnt, abgelaufen oder neu gefasst, Auftrag oder Rechnung storniert), bekommt der Gutschein seinen Wert zurück. Eine Neufassung oder Erneuerung übernimmt die Gutschein-Zeile nicht; der Code wird dort neu eingelöst.
Wie viel ein Gutschein deckt. Ein Wertgutschein deckt den Gesamtbetrag des Belegs: Warenwert abzüglich Belegrabatt plus Zuschlag auf Beleg-Ebene (etwa ein Eilzuschlag am Angebot). Reicht das Guthaben, zahlt der Kunde also auch den Zuschlag nicht. Ein Prozent-Gutschein rechnet dagegen nur auf den Warenwert — der Zuschlag ist keine Ware. Mehr als der Beleg hergibt, wird nie angerechnet; der Rest bleibt auf dem Gutschein.
Wenn der Beleg danach kleiner wird. Senken Sie nach dem Einlösen eine Position, entfernen Sie eine oder senken den Zuschlag, sinkt der Abzug automatisch auf den neuen Gesamtbetrag — die Belegsumme wird nie negativ. Der Unterschied geht als Guthaben zurück auf den Gutschein, und die Karte „Gutschein" am Beleg zeigt den Hinweis, um wie viel gekürzt wurde. Sind mehrere Gutscheine eingelöst, wird der zuletzt eingelöste zuerst gekürzt. Ein Belegrabatt weicht dem eingelösten Gutschein: reicht der Beleg nicht mehr für beide, wird zuerst der Rabatt gedeckelt, der Gutschein erst, wenn Warenwert und Zuschlag allein nicht mehr reichen. Die Gutschein-Zeilen je Steuersatz folgen dabei den neuen Anteilen; ein Steuersatz ohne Positionen verliert seine Gutschein-Zeile. Wird der Beleg später wieder größer, wächst der Abzug nicht von selbst mit — nehmen Sie den Gutschein zurück und lösen ihn neu ein.
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 Beleg eingelöst werden. Ausgeben allein genügt nicht. An einer Gutschrift oder einem Kostenbeleg (Mahn- oder Rücklastschriftkosten) gibt es keine Einlösung.
Die Gutschein-Zeile lässt sich nicht löschen. So gewollt: Betrag und Steuersatz stammen aus der Einlösung. Entfernt wird sie über „Zurücknehmen" in der Karte „Gutschein" — dann bekommt auch der Gutschein seinen Wert zurück.
Aktion oder Gutschein? Soll es für alle in einem Zeitraum gelten: Aktion. Soll es an eine Person oder Kampagne gebunden sein: Gutschein.