> 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/bedingungen.md).

# Bedingungen

Bedingungen ergänzen die globale Konfiguration: Sie gelten für einen Zeitraum und für eine bestimmte Auswahl an Produkten, Kunden oder Regeln. Damit baust du Aktionen wie „doppelte Punkte im September“ oder „keine Punkte auf Sale-Artikel“.

<figure><img src="/files/RApceAHQLTyoEqgU2c3r" alt=""><figcaption></figcaption></figure>

## Die sechs Bedingungstypen

* **Produkte für Bonus Punkte ausschließen** — für die ausgewählten Produkte, Produktgruppen oder Kategorien werden keine Punkte gesammelt beziehungsweise keine Punkte eingelöst.
* **Produkte für Bonus Punkte einschließen** — das Gegenstück: zusammen mit der Konfigurationsoption **Bonus Punkte nach Bedingungen** sind nur die hier definierten Produkte für Punkte freigegeben.
* **Individueller Bonus Faktor für Kunde oder Kundengruppe** — eigener Umrechnungsfaktor für einzelne Kundennummern oder Kundengruppen.
* **Individueller Bonus Faktor** — eigener Umrechnungsfaktor für Produkte, Produktgruppen, Kategorien oder eine Regel.
* **Individueller Bonus Faktor im Geburtsmonat des Kunden** — gilt im gesamten Geburtsmonat.
* **Individueller Bonus Faktor am Geburtstag des Kunden** — gilt nur am Geburtstag.

## Basis Einstellungen

| Feld                                 | Typ      | Beschreibung                                                                                                                                                                                                                                                                                                      |
| ------------------------------------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                                 | Text     | Sprechender Name der Bedingung, z. B. „September-Aktion“.                                                                                                                                                                                                                                                         |
| Aktiv                                | Schalter | Nur aktive Bedingungen werden ausgewertet.                                                                                                                                                                                                                                                                        |
| Gültig von / Gültig bis              | Datum    | Zeitraum, in dem die Bedingung greift.                                                                                                                                                                                                                                                                            |
| Bedingung Typ                        | Auswahl  | Einer der sechs Typen oberhalb dieser Tabelle.                                                                                                                                                                                                                                                                    |
| Typ der Änderung                     | Auswahl  | Beim Ausschluss: *Ausschließen für das Punkte sammeln* oder *Ausschließen für das Punkte einlösen*. Beim Einschließen: *Einschließen für das Punkte sammeln* oder *Einschließen für das Punkte einlösen*. Beim individuellen Faktor: *Umrechnungsfaktor Punkte sammeln* oder *Umrechnungsfaktor Punkte einlösen*. |
| Umrechnungsfaktor (1 EUR = ? Punkte) | Zahl     | Faktor, mit dem gerechnet wird, solange die Bedingung greift. Bei den Ausschluss-Typen wird das Feld nicht benötigt.                                                                                                                                                                                              |
| Position                             | Zahl     | Reihenfolge der Auswertung, wenn mehrere Bedingungen gleichzeitig zutreffen. Die Liste zeigt die Position und lässt sich sortieren.                                                                                                                                                                               |

## Regeln

In der Karte **Regeln** legst du fest, worauf die Bedingung angewendet wird. Welche Felder erscheinen, hängt vom gewählten Bedingungstyp ab.

| Feld            | Typ             | Beschreibung                                                                                                  |
| --------------- | --------------- | ------------------------------------------------------------------------------------------------------------- |
| Typ             | Auswahl         | Art der Zuordnung — siehe *Konditionsart* unten.                                                              |
| Produkte        | Mehrfachauswahl | Einzelne Produkte.                                                                                            |
| Produkt Gruppen | Mehrfachauswahl | Dynamische Produktgruppen (Product Streams).                                                                  |
| Kategorien      | Mehrfachauswahl | Kategorien; Produkte in diesen Kategorien sind betroffen.                                                     |
| Kundengruppen   | Mehrfachauswahl | Nur bei Bedingungen für Kunden oder Kundengruppen.                                                            |
| Kundennummern   | Text            | Einzelne Kundennummern, nur bei Bedingungen für Kunden oder Kundengruppen.                                    |
| Regel           | Auswahl         | Eine Shopware-Regel aus **Einstellungen → Regeln**. Über **Neue Regel anlegen** erstellst du sie direkt hier. |

### Konditionsart

Das Feld **Typ** in der Karte *Regeln* entscheidet, wie die Auswahl ausgewertet wird:

* **Produkte / Produkt Gruppen** — klassische Zuordnung über Produkte, Produktgruppen und Kategorien.
* **Regel + Alle Produkte** — die Bedingung greift für alle Produkte, sobald die gewählte Shopware-Regel zutrifft. Damit lassen sich Warenkorbwerte, Länder, Zahlungsarten, Punktestände und alles andere nutzen, was der Regel-Builder kennt.
* **Regel + Produkte / Produkt Gruppen** — beide Bedingungen müssen erfüllt sein: Die Regel trifft zu **und** das Produkt ist in der Auswahl enthalten.

> Das Bonus System bringt eigene Regel-Bedingungen mit (Punkteguthaben, eingelöste Punkte im Warenkorb). Siehe [Flow Builder und Regeln](/plugins/bonus-system/flow-builder-und-regeln.md).

## Hinweise

* Bedingungen greifen erst nach dem Speichern und nur innerhalb ihres Gültigkeitszeitraums.
* Der Faktor einer Bedingung ersetzt den globalen Faktor aus der [Konfiguration](/plugins/bonus-system/installation.md) — er wird nicht zusätzlich angewendet.
* Treffen mehrere Bedingungen zu, entscheidet die **Position** über die Reihenfolge.
* Punkte, die über das Produkt-Zusatzfeld *Bonus Punkte bei Kauf des Produktes* vergeben werden, sind unabhängig von Bedingungen.


---

# 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/bedingungen.md?ask=<question>&goal=<endgoal>
```

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