> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreizack-medien.de/llms.txt
> Use this file to discover all available pages before exploring further.

# So wird gerechnet

> Verteilung auf die Artikel, Cent-Rest, Kaufe N erhalte M, mehrere Codes, Versandkostenfrei und Neukunden

## Grundregeln

* **Der Rabatt senkt den Artikelpreis.** Es entsteht keine negative Rabattposition.
* **Jede Position bleibt eine Zeile.** Der Zeilenbetrag stimmt immer auf den Cent, in Warenkorb, Rechnung und Warenwirtschaft.
* **Festbetrag und Höchstbetrag werden exakt getroffen**, begrenzt nur durch den Wert der rabattfähigen Artikel.
* **Kein Preis wird negativ.** Ein Rabatt kann einen Artikel bis 0,00 € senken. Solche Positionen bleiben im Warenkorb, auch wenn „Artikel mit Preis 0 kaufbar“ in JTL aus ist.
* **Geschützte Artikel** (Funktionsattribut `dzm_promo_excluded`) und Gutscheinartikel von JTL bleiben immer unberührt, auch kein Anteil eines Festbetrags.
* **Beträge sind brutto**, wie in JTL. Bei Kundengruppen mit Nettopreisen rechnet das Plugin mit den Nettopreisen (siehe [Händler mit Nettopreisen](#händler-mit-nettopreisen)).

Grundlage ist immer der Preis, den der Shop ohne Kupon berechnet: mit Kundengruppenrabatt, Staffelpreis, Sonderpreis und Variationsaufpreisen. Versandkosten, Zahlungsgebühren und Gutscheine sind nie Grundlage.

## Prozent und Festbetrag

> [accordion] Prozent
>
> Der Rabatt ist genau der Prozentsatz der rabattfähigen Summe, wie bei JTL-Kupons. Jeder Stückpreis sinkt um den Prozentsatz, auf den Cent gerundet; die Rundung gleicht das Plugin aus, höchstens 1 Cent je Stück, ein Rest bleibt auf einer Position (siehe [Cent-Rest](#cent-rest)). Ist ein Höchstbetrag gesetzt und wird er überschritten, wird der Höchstbetrag wie ein Festbetrag verteilt.

> [accordion] Festbetrag
>
> Der Betrag wird anteilig nach Wert auf die rabattfähigen Positionen verteilt. Ist der Warenwert der rabattfähigen Artikel kleiner als der Betrag, wird höchstens dieser Warenwert abgezogen (bis 0,00 €). Der Rest verfällt, es entsteht kein Guthaben.

## Cent-Rest

Ein Festbetrag, Höchstbetrag oder Prozentsatz lässt sich nicht immer in glatten Cent je Stück verteilen: Bei 12 Stück ist der Abzug einer Position mit glatten Stückpreisen immer ein Vielfaches von 12 Cent. Den Rest trägt dann **eine** Position als Abzug auf die ganze Zeile. Ihr Stückpreis hat dadurch mehr als zwei Nachkommastellen, der Zeilenbetrag stimmt auf den Cent.

**Beispiel:** 12 Stück zu 11,90 €, Kupon 10 % mit Höchstbetrag 5 €.

| Menge | Stückpreis vorher | Stückpreis nachher | Zeile | Abzug |
| - | - | - | - | - |
| 12 | 11,90 € | 11,4833 € (angezeigt 11,48 €) | 137,80 € | 5,00 € |

* Den Rest trägt höchstens eine Position je Kupon, und zwar die mit der größten Menge. In den meisten Warenkörben bleibt kein Rest, dann sind alle Stückpreise glatt.
* Weil der Shop den Stückpreis auf zwei Stellen gerundet anzeigt, ergibt „angezeigter Stückpreis × Menge“ an dieser Zeile ein paar Cent mehr oder weniger als der Zeilenbetrag (hier 12 × 11,48 € = 137,76 €). Das zeigt JTL genauso bei Kundengruppen- und Kategorierabatten.
* Das Badge zeigt an dieser Zeile den Abzug für die ganze Zeile, zum Beispiel „HERBST10 −5,00 € für 12 Stück“.
* Ändert der Kunde die Menge oder entfernt den Code, rechnet das Plugin sofort neu.

## Kaufe N, erhalte M

* Je volle Gruppe aus N + M Stück werden M Stück rabattiert, immer die günstigsten. Wie gezählt wird (über alle zutreffenden Artikel, je Artikel, Varianten zusammen oder einzeln), stellst du am Kupon ein, siehe [Kupons](https://docs.dreizack-medien.de/DZM-Promo-Plus/kupons.md#kaufe-n-erhalte-m).
* Kosten mehrere Stücke gleich viel, wird das mit dem niedrigeren Steuersatz rabattiert.
* Der Abzug liegt auf der Zeile. Bei 3 für 2 zu je 10,00 € kostet jedes der drei Stücke rechnerisch 6,666… €, der Zeilenbetrag ist genau 20,00 €. An der Position steht „1 Stück gratis“.
* **Mehrere solche Aktionen:** Jedes Stück zählt für höchstens eine. Treffen zwei bis vier Aktionen auf dieselben Artikel, wählt das Plugin die Aufteilung mit dem höchsten Rabatt, bei Gleichstand gilt die Reihenfolge der Eingabe. Ab fünf Aktionen gilt immer die Reihenfolge der Eingabe. Bleibt für eine Aktion kein Stück übrig, wird sie nicht angewendet und der Kunde bekommt den Hinweis „Der Gutschein … gilt für dieselben Artikel wie … Je Artikel gilt nur eine Mengenaktion.“
* Festbetrag und Prozent dürfen auf die Stücke einer solchen Aktion zusätzlich wirken, sie rechnen auf den bereits reduzierten Preis.
* Kappt das Plugin den Rabatt, damit der [Mindestbestellwert des Shops](#mindestbestellwert) erreicht bleibt, wird er neu verteilt. Die Anzeige „1 Stück gratis“ stimmt dann nicht mehr genau.

## Mehrere Codes

* Jeder Kupon ist **kombinierbar** oder **nicht kombinierbar**. Trifft ein neuer Code auf einen nicht kombinierbaren (oder ist der neue nicht kombinierbar), wird der **neue** Code abgelehnt. Der Kunde kann den alten per X entfernen.
* **Reihenfolge:** zuerst „Kaufe N, erhalte M“, dann alle Festbeträge (untereinander in der Reihenfolge, in der die Kupons angelegt wurden), danach die Prozent-Rabatte auf den bereits reduzierten Preis, egal in welcher Reihenfolge der Kunde die Codes eingibt. Die Badges an der Position stehen in derselben Reihenfolge wie die Liste der eingelösten Kupons.
* **Prozente addieren sich nicht.** Zwei Prozent-Codes wirken nacheinander: 20 % und 10 % ergeben 28 %, nicht 30 %. 10 € und 10 % auf 100 € ergeben 19 €, nicht 20 €.
* **Automatische Aktionen** treten hinter eingelöste Codes zurück: Lässt sich eine automatische Aktion mit einem eingelösten Code nicht kombinieren, fällt sie weg, auch wenn sie für den Kunden günstiger wäre (etwa ein Mitarbeiterrabatt). Der Kunde bekommt den Hinweis „… wurde entfernt, weil sich … nicht mit anderen Gutscheinen kombinieren lässt.“ Entfernt er den Code, kommt die Aktion zurück. Umgekehrt verdrängt ein Code auch eine nicht kombinierbare automatische Aktion.
* **Zwei nicht kombinierbare automatische Aktionen:** Es gilt die zuerst angelegte, nicht unbedingt die günstigere.
* **Ein Kupon gilt nur einmal je Warenkorb.** Ein zweiter Code desselben Kupons (zum Beispiel FB10 und IG10) wird mit „bereits aktiv“ abgelehnt.
* **Versandkostenfrei** ist immer mit Rabatt-Codes kombinierbar. Exklusiv lässt sich ein Versandkostenfrei-Kupon nicht machen, der Schalter „kombinierbar“ wirkt dort nicht.
* **Gratisartikel** lassen sich an jede Kupon-Art hängen, auch zusätzlich zu einem Rabatt desselben Kupons. Für die Kombination mit anderen Kupons gilt der Schalter „kombinierbar“ wie bei jedem Rabatt.

### Beispiele

| Kombination | Warenkorb | Rechnung | Ersparnis |
| - | - | - | - |
| Prozent + Prozent | 20 % + 10 % auf 100 € | 100 → 80 → 72 € | 28 € |
| Festbetrag + Prozent | 10 € + 10 % auf 100 € | 100 → 90 → 81 € | 19 € |
| Festbetrag + Festbetrag | 5 € + 10 € auf 100 € | 100 → 85 € | 15 € |
| 3 für 2 + Prozent | 3 × 10 € mit 10 % | 30 → 20 → 18 € | 12 € |
| 3 für 2 + Festbetrag | 3 × 10 € mit 5 € | 30 → 20 → 15 € | 15 € |
| Automatisch + Code | automatisch 5 % + Code 10 € auf 100 € | 100 → 90 → 85,50 € | 14,50 € |
| Rabatt + Versandkostenfrei | 10 % + Gratisversand auf 100 € | 100 → 90 €, Versand 0 € statt 5,99 € | 15,99 € |

**Drei Aktionen auf einmal:** 3 Liquids zu je 6 € und ein Gerät zu 40 € (58 €), dazu 3 für 2 auf Liquids, 10 % auf alles und versandkostenfrei ab 39 €. Zuerst wird das günstigste Liquid gratis (−6,00 €, 52,00 €), dann gehen 10 % ab (−5,20 €, 46,80 €). Der Versand ist frei, weil die Grenze von 39 € vor Rabatt erreicht ist. Ersparnis: 11,20 € plus Versand.

### Staffeln

* **Mit Festbeträgen** gelingen Staffeln über zwei automatische Kupons: 5 € ab 50 € und 5 € ab 100 € ergeben bei 100 € einen Rabatt von 10 €. Beide Mindestbestellwerte werden vor Rabatt geprüft, die zweite Stufe fällt also nicht weg, weil die erste den Warenwert senkt.
* **Mit Prozenten** wirken beide Stufen nacheinander: 5 % ab 100 € und 5 % ab 200 € ergeben bei 200 € 9,75 % (190 → 180,50 €), nicht 10 %. Eine Stufe, die die vorige ersetzt, gibt es nicht.

### Was es nicht gibt

Bedingungen nach Zahlungsart, Versandart, Wochentag, Uhrzeit, Sprache oder Verkaufskanal kennt Promo Plus nicht. Das Zusammenspiel mit anderen Rabatt-Plugins ist nicht geprüft. Bestehende JTL-Kupons solltest du [übernehmen](https://docs.dreizack-medien.de/DZM-Promo-Plus/jtl-import.md), statt beide Systeme parallel laufen zu lassen.

## Mindestbestellwert

**Mindestbestellwert des Kupons:** Geprüft wird der Warenwert **vor** Rabatt. Ausgenommene und geschützte Artikel zählen mit.

**Mindestbestellwert des Shops** (Kundengruppe): Standardmäßig kappt das Plugin den Rabatt so, dass der Mindestbestellwert erreicht bleibt und der Kunde bestellen kann. Das lässt sich unter [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md) abschalten.

## Versandkostenfrei

* Die Versandkosten entfallen, schon bevor der Kunde Adresse und Versandart wählt. Mit **Zuschläge erlassen** entfallen auch Versandzuschläge.
* Sind Lieferländer gesetzt und passt das Lieferland im Checkout nicht, wird der Code mit Hinweis entfernt.
* Im Warenkorb steht statt „Zzgl. Versandkosten ab 0,00 €“ der Hinweis „Versandkostenfrei bei Lieferung nach …“.

**Schwelle „versandkostenfrei ab …“ deiner Versandarten:** Standardmäßig zählt der Warenwert **vor** Rabatt. Ein Kunde verliert den Gratisversand also nicht, nur weil er einen Kupon einlöst. Auch der Hinweis „Noch X € bis zur versandkostenfreien Lieferung“ rechnet so. Das lässt sich unter [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md) umstellen.

## Neukunden

Ein Neukunde ist wie in JTL ein Kunde ohne bisherige Bestellung, dessen E-Mail-Adresse noch keinen Neukunden-Kupon genutzt hat. Auch Neukunden-Kupons, die vor dem Import mit JTL eingelöst wurden, zählen dabei mit.

* **Gäste** bekommen Neukunden-Kupons nur, wenn die Shop-Einstellung **Unregistrierten Neukundenkupon zulassen** aktiv ist. Sonst lautet der Hinweis „Der Gutschein … gilt nur für Neukunden mit Kundenkonto.“
* **Automatisch:** Der Kupon greift, sobald die E-Mail-Adresse bekannt ist, also nach dem Login oder der Adresseingabe. Gibt es mehrere automatische Neukunden-Kupons, gilt nur einer: der mit dem höchsten Zahlenwert, unabhängig von der Rabattart (wie in JTL). 15 € schlagen also 10 %, auch bei 300 € Warenwert. Gratisartikel zählen dabei nicht mit.
* **Per Code:** Der Code wird sofort angewendet. Stellt sich mit der E-Mail-Adresse heraus, dass der Kunde kein Neukunde ist, wird er mit Hinweis entfernt.

## Händler mit Nettopreisen

Bei Kundengruppen mit Nettopreisen rechnet das Plugin auf den Nettopreisen, ohne vorher auf den Cent zu runden. So fehlen keine Bruchteile eines Cents, zum Beispiel bei mehreren Stücken mit krummem Nettopreis. Der Mindestbestellwert eines Kupons gilt weiter brutto und wird gegen den Bruttowert des Warenkorbs geprüft. Rabatt und Bestellwert solcher Einlösungen stehen in der [Statistik](https://docs.dreizack-medien.de/DZM-Promo-Plus/statistik.md) netto und getrennt.

## Konfigurationsartikel

* Ob ein Paket rabattiert wird, entscheidet der Hauptartikel (Kategorien, Hersteller, Ausschlüsse).
* Rabattiert wird jede Position des Pakets mit einem Preis über 0 €.
* Ein Bestandteil mit dem Funktionsattribut `dzm_promo_excluded` bleibt ausgenommen.

## Limits

Limits werden beim Einlösen geprüft, bei jedem Aufruf der Warenkorbseite erneut und beim Absenden der Bestellung verbindlich gebucht. Löst ein anderer Kunde gleichzeitig den letzten verfügbaren Einmalcode ein, bekommt genau eine Bestellung den Rabatt. Der andere Kunde landet mit Hinweis im Warenkorb und sieht den neuen Preis, bevor er bestellt.

> [!NOTE]
>
> Bei Zahlarten, bei denen der Kunde schon während der Bestellung bezahlt (zum Beispiel PayPal Checkout), prüft das Plugin die Limits beim Absenden ebenfalls und entfernt einen verbrauchten Code mit Hinweis. Gebucht wird hier erst, wenn die Bestellung nach der Zahlung angelegt ist. Wird ein Limit genau in diesem kurzen Zeitfenster erschöpft, bleibt die Bestellung mit Rabatt bestehen, damit Bestellwert und bezahlter Betrag übereinstimmen, und das Plugin hält das im Protokoll fest.

Wird eine Bestellung storniert, zählt die Einlösung standardmäßig nicht mehr gegen die Limits.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.