> For the complete documentation index, see [llms.txt](https://docs.pixeleyes.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pixeleyes.de/anleitungen-instructions/deutsch/dokumentation-unserer-shopware-6-plugins/bonuspunkte-and-treueprogramm/funktionen/pramien-einlosen.md).

# Prämien einlösen

## Prämien einlösen

Kunden können ihre gesammelten Punkte im Kundenkonto gegen Prämien einlösen.

### Ablauf

1. Der Kunde öffnet **Mein Konto → Bonuspunkte & Prämien**
2. Auf der Übersichtsseite sind alle aktiven Prämien sichtbar
3. Für jede Prämie wird angezeigt:
   * Name und Beschreibung
   * Benötigte Punkte
   * Ob der Kunde genug Punkte hat (Schaltfläche aktiv oder gesperrt)
4. Klick auf **Einlösen** öffnet ggf. eine Produktauswahl (bei Gratis-Produkt-Prämien)
5. Der Voucher-Code wird sofort generiert und angezeigt

### Gutschein-Code kopieren

Nach erfolgreicher Einlösung wird der Code in der **Einlösungshistorie** angezeigt:

* Der Code kann per Klick in die Zwischenablage kopiert werden
* Bei bereits verwendeten Codes (Status: **Eingelöst**) ist der Copy-Button ausgeblendet und der Code erscheint halbtransparent

### Gratis-Produkt auswählen

Enthält die Prämie einen Product Stream, öffnet sich ein Produktauswahl-Modal:

* Es werden nur wählbare Artikel angezeigt (bei Variantenartikeln: nur die Varianten, nicht das übergeordnete Produkt)
* Jede Variante zeigt ihre Eigenschaften an (z. B. Größe: M, Farbe: Rot)
* Nach Auswahl und Bestätigung wird der Gratis-Code generiert

### Einlösungshistorie

Unter **Eingelöste Prämien** sieht der Kunde alle bisherigen Einlösungen mit:

| Spalte  | Inhalt                              |
| ------- | ----------------------------------- |
| Datum   | Zeitpunkt der Einlösung             |
| Prämie  | Name der Prämie                     |
| Produkt | Bei Gratis-Produkt: Name + Variante |
| Code    | Voucher-Code (kopierbar)            |
| Punkte  | Eingesetzte Punkte                  |
| Status  | offen / eingelöst                   |

### Punkt-Rückgabe bei Stornierung

Wenn eine Bestellung storniert wird, für die eine Gratis-Produkt-Prämie genutzt wurde, werden die Punkte automatisch zurückgebucht – sofern die Prämie noch nicht eingelöst wurde.
