> For the complete documentation index, see [llms.txt](https://docs.premsoft.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.premsoft.de/plugins/bonus-system/verwaltungs-dashboard/bonus-produkte-pramien.md).
# Bonus Produkte / Prämien
Bonus Produkte sind Prämien: bestehende Produkte deines Katalogs, die Kunden mit Punkten bestellen können — entweder ausschließlich mit Punkten oder alternativ mit Geld.
> Damit Prämien in der Storefront erscheinen, muss in der [Konfiguration](/plugins/bonus-system/installation.md) die Option **Bonus Produkte aktivieren** eingeschaltet sein. Optional legst du dort einen Mindest-Warenkorbwert, die Slider-Einstellungen und ein Header-Bild für die Prämien-Liste fest.
## Übersicht
Die Liste zeigt die angelegten Bonus Produkte mit den Spalten **Name**, **Aktiv**, **Gültig von** und **Gültig bis**. Die Reihenfolge in der Storefront entspricht der Reihenfolge in dieser Liste (Standardsortierung); Kunden können in der Storefront zusätzlich nach Preis oder Name sortieren.
## Ein Bonus Produkt anlegen
Klicke auf **Neues Produkt** und fülle die Felder der Detailseite aus. **Speichern** übernimmt die Einstellungen.
| Feld | Typ | Beschreibung |
| ------------------------------ | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Produkt | Auswahl | Bestehendes Produkt aus dem Katalog. |
| Aktiv | Schalter | Nur aktive Bonus Produkte erscheinen in der Storefront. |
| Gültig von / Gültig bis | Datum | Zeitraum, in dem die Prämie angeboten wird. |
| Kosten | Auswahl | *Umrechnungsfaktor Punkte einlösen von Plugin Einstellungen* — die Punktekosten ergeben sich aus Produktpreis und Umrechnungsfaktor. Oder *Fester Punktewert* — du gibst die Punkte direkt vor. Pflichtangabe. |
| Anzahl Punkte | Zahl | Punktekosten bei *Fester Punktewert*. |
| Nur mit Punkten erwerbbar | Schalter | Das Produkt ist ausschließlich mit Punkten bestellbar. Ist die Option aus, kann der Kunde zwischen Geld und Punkten wählen. |
| Maximalabnahme | Zahl | Maximale Menge, die ein Kunde von dieser Prämie bestellen kann. |
| Beschränkung für Verkaufskanal | Mehrfachauswahl | Verkaufskanäle, in denen die Prämie angeboten wird. Ohne Auswahl gilt sie in allen Kanälen. |
> Nutzt du *Umrechnungsfaktor Punkte einlösen von Plugin Einstellungen*, muss in der Konfiguration ein Umrechnungsfaktor für das Einlösen gesetzt sein — sonst ergibt die Berechnung keine Punktekosten.
## In der Storefront
* Die Prämien-Liste liegt unter `/bonus-products` und ist über das Bonus-System-Menü im Kundenkonto erreichbar. Über **Bonus Produkte Menü Eintrag deaktivieren** kannst du sie ausblenden.
* Auf Wunsch erscheinen verfügbare Prämien zusätzlich als Slider im Warenkorb und im Checkout.
* Reicht das Guthaben nicht oder ist der Mindest-Warenkorbwert nicht erreicht, erhält der Kunde einen entsprechenden Hinweis.
* Nicht eingeloggte Kunden sehen den Hinweis, dass sie sich für den Kauf mit Punkten anmelden müssen.
## Alternative: jedes Produkt als Prämie
Soll grundsätzlich jedes Produkt mit Punkten bezahlbar sein, aktiviere in der Konfiguration **Aktivieren Sie die Bonusproduktfunktion für jedes Produkt**. Einzelne Bonus Produkte musst du dann nicht anlegen; die Punktekosten ergeben sich aus dem Umrechnungsfaktor für das Einlösen.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.premsoft.de/plugins/bonus-system/verwaltungs-dashboard/bonus-produkte-pramien.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.