> ## 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.

# Einlösen im Shop

> Kupon-Feld, Kupon-Links, Buttons und automatische Kupons, dazu die Anzeige im Warenkorb

## Wege zum Einlösen

> [tab] Kupon-Feld
>
> Deine Kunden nutzen das normale Kupon-Feld in Warenkorb und Checkout, es gibt kein zusätzliches Formular. Der Code wird sofort geprüft und bei Bedarf mit Hinweis abgelehnt, zum Beispiel wenn kein passender Artikel im Warenkorb liegt.
>
> In NIU Plus funktioniert das Kupon-Feld auch im Sidebar-Warenkorb. Dafür brauchst du den NIU Plus Companion ab 6.18.0 (Shop 5.7) bzw. 7.18.0 (Shop 5.8).
>
> Codes, die nicht zum Plugin gehören, gehen unverändert an den Shop und an andere Plugins weiter, zum Beispiel Geschenkgutscheine oder noch nicht importierte JTL-Kupons.

> [tab] Kupon-Link
>
> Hänge `?coupon=CODE` an eine beliebige Shop-URL, zum Beispiel in einem Newsletter:
>
> ```
> https://dein-shop.de/?coupon=HERBST10
> ```
>
> Der Code wird vorgemerkt und die Seite ohne den Parameter neu geladen. Den fertigen Link kopierst du je Code in der Code-Liste des Kupons.

> [tab] Button
>
> Ein Klick auf ein Element mit dem Attribut `data-dzm-promo-apply` löst den Code ohne Neuladen der Seite ein:
>
> ```html theme={null}
> <a href="?coupon=HERBST10" data-dzm-promo-apply="HERBST10">Jetzt 10 % sichern</a>
> ```
>
> Alternativ funktioniert die CSS-Klasse `dzm-promo-apply` an einem Link, dessen Adresse `coupon=` enthält. Im OPC trägst du die Klasse bei einem Button im Tab **Styles** als eigene CSS-Klasse ein und setzt den Kupon-Link als Ziel.
>
> Ohne JavaScript greift der normale Link. Mehrfaches Klicken löst den Code nur einmal ein.

> [tab] Automatisch
>
> Kupons mit Einlösung **Automatisch** gelten ohne Eingabe, sobald alle Bedingungen erfüllt sind. Beim ersten Anwenden bekommt der Kunde den Hinweis „Die Aktion … wurde automatisch angewendet“.

### Vormerken

Ein per Link oder Button eingelöster Code wird vorgemerkt, auch wenn der Warenkorb leer ist oder noch nicht passt. Er wirkt, sobald passende Artikel im Warenkorb liegen. Der Kunde bekommt den Hinweis „Der Gutschein „Herbstaktion“ ist vorgemerkt und wird im Warenkorb angewendet.“

Das Kupon-Feld prüft dagegen sofort und lehnt einen Code ab, der gerade nicht passt.

## Kupon-Links

Je Code gibt es zwei Links:

| Link | Beispiel | Wofür |
| - | - | - |
| Klartext | `?coupon=HERBST10` | gut lesbar, zum Beispiel für Social Media |
| Kryptisch | `?coupon=a8F…` (24 Zeichen) | verrät den Code nicht, zum Beispiel für personalisierte Einmalcodes |

Kryptische Links funktionieren immer. Ob Klartext-Links erlaubt sind, stellst du unter [Einstellungen](https://docs.dreizack-medien.de/DZM-Promo-Plus/einstellungen.md) ein.

> [!NOTE]
>
> Ein Link ist nicht mächtiger als die Eingabe des Codes: Alle Bedingungen und Limits werden genauso geprüft.

## Anzeige im Warenkorb

In Warenkorb und Checkout zeigt das Plugin in NOVA und NIU Plus:

* **an jeder rabattierten Position** den durchgestrichenen Originalpreis und je Kupon ein Badge mit dem Abzug, zum Beispiel „Herbstaktion −2,00 €“,
* **beim Kupon-Feld** die Liste der eingelösten Kupons mit ihrem Rabatt, der gesamten Ersparnis und einem X zum Entfernen. Automatische Kupons haben kein X, sie gelten, solange ihre Bedingungen erfüllt sind.

Im Shop steht überall der **Anzeigename** des Kupons (siehe [Kupons](https://docs.dreizack-medien.de/DZM-Promo-Plus/kupons.md)), in Warenwirtschaft, Protokoll und Statistik der Code.

Bei Konfigurationsartikeln steht das Badge am Hauptartikel und zeigt den Paketpreis je Stück, den Originalpreis des Pakets und den Abzug je Code.

Bei „Kaufe N, erhalte M“ steht an der Position statt eines Betrags zum Beispiel „1 Stück gratis“. Ist eine Gruppe noch nicht voll, steht unter der Liste der Kupons „Noch 1 Stück, dann gibt es 1 gratis.“

Steht am Badge „für 12 Stück“, gilt der Abzug für die ganze Zeile: Dort wurde ein Cent-Rest verteilt, damit der Betrag genau stimmt. Mehr dazu unter [So wird gerechnet](https://docs.dreizack-medien.de/DZM-Promo-Plus/berechnung.md#cent-rest).

Gratisartikel stehen als eigene Position zu 0,00 € mit „Gratis zu …“ im Warenkorb, bei **Kunde wählt einen** mit Auswahl und „Anderes Geschenk wählen“ (siehe [Kupons](https://docs.dreizack-medien.de/DZM-Promo-Plus/kupons.md#gratisartikel)). Fehlt für einen Kupon nur noch Bestellwert, zeigt ein Fortschrittsbalken den Rest (siehe [Im Shop bewerben](https://docs.dreizack-medien.de/DZM-Promo-Plus/bewerben.md#fortschrittsbalken)).

Artikelseite und Artikellisten zeigen weiter den normalen Preis. Kupons kannst du dort über Rabattbox und Ribbon bewerben.

Wie du Farben und Radien dieser Anzeigen änderst oder eine Vorlage ersetzt, steht unter [Optik anpassen](https://docs.dreizack-medien.de/DZM-Promo-Plus/bewerben.md#optik-anpassen).

## Hinweise an den Kunden

Das Plugin meldet jede Ablehnung und jedes Entfernen mit Grund. Fällt ein Code später weg, steht im Hinweis „… wurde entfernt, weil …“. Beispiele:

| Situation | Hinweis |
| - | - |
| Kupon inaktiv | Der Gutschein „Herbstaktion“ ist nicht gültig. (Einen unbekannten Code meldet der Shop selbst.) |
| Noch nicht gültig oder abgelaufen | Der Gutschein „Herbstaktion“ ist noch nicht gültig. / … ist abgelaufen. |
| Kein passender Artikel im Warenkorb | Der Gutschein „Herbstaktion“ gilt für keinen Artikel in deinem Warenkorb. |
| Mindestbestellwert nicht erreicht | Der Gutschein „Herbstaktion“ gilt ab einem Bestellwert von 100,00 €. |
| Bedingung „Nur wenn der Warenkorb enthält“ nicht erfüllt | Der Gutschein „Herbstaktion“ gilt nur zusammen mit bestimmten Artikeln in deinem Warenkorb. |
| Falsche Kundengruppe oder anderer Kunde | Der Gutschein „Herbstaktion“ gilt nicht für deine Kundengruppe. / … ist nicht für dein Kundenkonto freigegeben. |
| Nicht kombinierbar | Der Gutschein „Herbstaktion“ lässt sich nicht mit „Sommeraktion“ kombinieren. |
| Schon eingelöst | Der Gutschein „Herbstaktion“ ist bereits aktiv. |
| Limit erreicht | Der Gutschein „Herbstaktion“ ist leider nicht mehr verfügbar. / Du hast den Gutschein „Herbstaktion“ bereits eingelöst. |
| Kein Neukunde | Der Gutschein „Herbstaktion“ gilt nur für Neukunden. / … gilt nur für Neukunden mit Kundenkonto. (Gast, wenn der Shop Neukunden-Kupons für Gäste nicht zulässt) |
| Lieferland passt nicht | Der Gutschein „Herbstaktion“ gilt nicht für das gewählte Lieferland. |
| Später kein passender Artikel mehr | Der Gutschein „Herbstaktion“ wurde entfernt, weil er für keinen Artikel in deinem Warenkorb mehr gilt. |
| Mengenaktion trifft auf dieselben Artikel wie eine andere | Der Gutschein „Herbstaktion“ gilt für dieselben Artikel wie „Sommeraktion“. Je Artikel gilt nur eine Mengenaktion. |
| Zu viele ungültige Codes (10 in 10 Minuten von derselben Adresse) | Zu viele ungültige Gutscheincodes. Bitte versuche es in 10 Minuten erneut. |
| Warenkorb in einem anderen Tab geändert | Dein Warenkorb hat sich geändert. Bitte prüfe deine Gutscheine und Preise. |

Limits prüft das Plugin beim Einlösen, bei jedem Aufruf der Warenkorbseite und beim Absenden. Ist ein Code inzwischen verbraucht, etwa weil ein anderer Kunde den letzten Einmalcode bestellt hat, fällt er schon auf der Warenkorbseite mit Hinweis weg. Fällt ein Code später weg, etwa weil der Kunde Artikel entfernt, wird er aus dem Warenkorb genommen und nicht automatisch wieder aktiviert. Ändert sich der Warenkorb ohne Neuladen der Seite, zum Beispiel im Sidebar-Warenkorb, erscheinen die Hinweise sofort: in NIU Plus als Toast des Templates, sonst unten rechts. Fällt ein automatischer Kupon weg, bekommt der Kunde ebenfalls einen Hinweis, zum Beispiel wenn ein nicht kombinierbarer Code ihn verdrängt („Herbstaktion“ wurde entfernt, weil sich „Sommeraktion“ nicht mit anderen Gutscheinen kombinieren lässt.) oder wenn du ihn deaktivierst (Die Aktion „Herbstaktion“ ist nicht mehr verfügbar.).

> [!TIP]
>
> Alle Texte sind Sprachvariablen in Deutsch und Englisch. Du passt sie in der Plugin-Verwaltung von JTL unter **Sprachvariablen** an.


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