> 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.md).
# Bonus System
Ein vollständiges Punktesystem für Shopware 6: Kunden sammeln Bonus Punkte für ihre Einkäufe und lösen sie später als Gutschein oder gegen Prämien ein — verwaltet direkt in der Shopware Administration, ohne externen Dienst und ohne laufende Gebühren.
## Wie es funktioniert
Für jede Bestellung berechnet das Plugin ein Punkteguthaben und speichert es als Buchung. Wann diese Punkte nutzbar werden, entscheidest du: direkt nach der Bestellung, nach Zahlung, nach Versand, nach Abschluss, nach n Tagen — oder erst nach manueller Freigabe im Admin-Modul. Beim Einlösen entsteht im Warenkorb eine Rabattposition, oder der Kunde bestellt ein Bonus Produkt (eine Prämie) direkt mit Punkten.
## Kernfunktionen
* **Punkte sammeln** pro Umsatz, mit Umrechnungsfaktor bis zu fünf Dezimalstellen, optional ohne Versandkosten und mit wählbarer Rundung
* **Punkte einlösen** als Gutscheinposition im Warenkorb oder Checkout — per Slider, Zahlenfeld oder Button, optional automatisch bei jeder Bestellung
* **Bonus Produkte (Prämien)** mit festem Punktewert oder Umrechnungsfaktor, Maximalabnahme, Gültigkeitszeitraum und Verkaufskanal-Beschränkung
* **Bedingungen** für Aktionszeiträume, Kundengruppen, Kundennummern, Produkte, Produktgruppen, Kategorien und Shopware-Regeln — inklusive Faktor am Geburtstag und im Geburtsmonat
* **Punkte für mehr als Bestellungen**: Produktbewertungen, Newsletter-Anmeldung, manuelle Buchungen und Punkte je Produkt über ein Zusatzfeld
* **Freigabe und Verfall** frei steuerbar, mit Hinweis nach dem Login und automatischer E-Mail vor dem Ablauf
* **Flow Builder** mit Trigger „Bonus Punkte verändert“ und Aktion „Punktestand ändern“, plus drei Bedingungen für den Regel-Builder
* **Admin API**, CSV-Export der Buchungen und CLI-Befehle für Migration und Wartung
* **Pro Verkaufskanal** aktivierbar, mehrsprachig, mit eigenen Farben, Icon und Textbausteinen
## Wo anfangen?
* [Voraussetzungen](/plugins/bonus-system/voraussetzungen.md) — läuft das Plugin in deiner Umgebung?
* [Schnellstart](/plugins/bonus-system/schnellstart.md) — in zehn Minuten zum laufenden Punktesystem
* [Installation](/plugins/bonus-system/installation.md) — alle Konfigurationsfelder im Detail
* [Verwaltungs-Dashboard](/plugins/bonus-system/verwaltungs-dashboard.md) — der tägliche Arbeitsbereich
## Ergebnis
Du bekommst ein Kundenbindungsprogramm, das vollständig in Shopware lebt: Punktestände, Buchungen und Prämien liegen in deiner Datenbank, lassen sich per API an Warenwirtschaft und CRM anbinden und greifen in Warenkorb, Checkout, Rechnung und Kundenkonto.
---
# 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.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.