> For the complete documentation index, see [llms.txt](https://docs.momocode.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.momocode.de/shopware-6/prozentbasierte-erweiterte-preise/3.-konfiguration.md).

# 3. Konfiguration

Dieses Plugin hat keine systemweiten Einstellungen. Die Prozent-Funktion steht nach der Installation direkt in jedem Produkt unter **Erweiterte Preise** zur Verfügung.

## Prozentuale Preise definieren

### Schritt für Schritt

1. Öffnen Sie ein Produkt unter **Kataloge → Produkte**
2. Wechseln Sie zum Tab **Erweiterte Preise**
3. Klicken Sie auf **Preis hinzufügen** oder bearbeiten Sie einen bestehenden Preis
4. Geben Sie in der Spalte **Prozent** den gewünschten Wert ein:
   * Negativer Wert → Rabatt (z. B. `-10` für 10 % Rabatt)
   * Positiver Wert → Aufschlag (z. B. `5` für 5 % Aufschlag)
5. Der absolute Preis in der Spalte **Preis** wird automatisch berechnet
6. Klicken Sie auf **Speichern**

![Preiszeile mit ausgefülltem Prozent-Feld und berechnetem Preis](/files/wCGOaVIpXKo0j4YY1x2N)

### Hinweise zur Eingabe

* Prozentangaben werden als einfache Zahlen eingegeben, kein %-Zeichen erforderlich
* Positive Werte erhöhen den Preis, negative Werte senken ihn
* Bestehende erweiterte Preise ohne Prozentangabe bleiben unverändert
* Das Plugin rechnet mit allen konfigurierten Währungen

## Berechnungsbasis wählen

Für jeden der drei Preistypen (Preis, Listenpreis, Regulierungspreis) können Sie separat festlegen, ob die Prozentberechnung auf dem **Verkaufspreis** oder dem **Einkaufspreis** des Produkts basiert.

### So funktioniert die Basis-Auswahl

Neben jedem Prozent-Eingabefeld sehen Sie einen Umschalter mit zwei Optionen:

* **Verkaufspreis** (Standard) — die Berechnung basiert auf dem regulären Verkaufspreis des Produkts
* **Einkaufspreis** — die Berechnung basiert auf dem Einkaufspreis des Produkts

![Basis-Umschalter neben dem Prozent-Feld](/files/Wugr3xnJ3QrbtIxFMXIT)

### Anwendungsbeispiel

Sie möchten den Listenpreis als „Einkaufspreis + 20 %" definieren:

1. Wählen Sie beim Listenpreis-Prozent die Basis **Einkaufspreis**
2. Geben Sie `20` als Prozentwert ein
3. Der Listenpreis wird automatisch als Einkaufspreis + 20 % berechnet

### Hinweise

* Die Basis-Auswahl ist **immer sichtbar**, auch wenn noch kein Prozentwert eingegeben wurde
* Wenn Sie **Einkaufspreis** als Basis wählen, aber noch nie ein Einkaufspreis am Produkt hinterlegt wurde, wird die Berechnung übersprungen und der bestehende Preis bleibt erhalten. Hinweis: Sobald ein Einkaufspreis einmal gesetzt wurde, speichert Shopware beim Leeren des Feldes den Wert `0` — in diesem Fall wird die Berechnung normal mit `0` als Basis ausgeführt
* Ändert sich der Einkaufspreis eines Produkts, werden alle Prozentpreise mit Basis „Einkaufspreis" automatisch neu berechnet

## Listenpreis-Felder ein-/ausblenden

Wenn Sie im erweiterten Preise Grid den Schalter **Listenpreise anzeigen** deaktivieren, werden auch die Prozent-Eingabefelder für Listenpreis und Regulierungspreis automatisch ausgeblendet. Es wird dann nur das Prozent-Feld für den Standardpreis angezeigt.

Beim erneuten Aktivieren des Schalters erscheinen die Felder wieder mit den zuvor eingegebenen Werten — keine Daten gehen verloren.

## Mehrfachänderung (Bulk Edit)

Sie können Prozentpreise auch über Shopwares **Mehrfachänderung** für viele Produkte gleichzeitig anlegen:

1. Wählen Sie unter **Kataloge → Produkte** mehrere Produkte aus
2. Klicken Sie auf **Mehrfachänderung**
3. Öffnen Sie den Bereich **Erweiterte Preise**
4. Geben Sie die gewünschten Prozentwerte ein
5. Füllen Sie die absoluten Preisfelder mit einem Platzhalter-Wert aus (z. B. `0`)
6. Bestätigen Sie die Mehrfachänderung

Die absoluten Preise werden nach dem Speichern **automatisch serverseitig** für jedes Produkt individuell berechnet — basierend auf dem jeweiligen Grundpreis des Produkts. Sie müssen die Produkte nicht einzeln öffnen.

![Mehrfachänderung mit ausgefüllten Prozentwerten](/files/khOBEiLTbedPs23rb2II)

### Hinweise zur Mehrfachänderung

* Die automatische Sofortberechnung in der Oberfläche ist während der Mehrfachänderung deaktiviert, da kein einzelner Grundpreis zur Verfügung steht
* Die serverseitige Berechnung erfolgt unmittelbar nach dem Speichern
* Sie können Prozentwerte und Berechnungsbasis (Verkaufspreis/Einkaufspreis) auch in der Mehrfachänderung setzen

## Automatische Neuberechnung

In folgenden Situationen werden die absoluten Preise automatisch neu berechnet:

| Auslöser                                                        | Berechnung                                                           |
| --------------------------------------------------------------- | -------------------------------------------------------------------- |
| Verkaufspreis des Produkts ändert sich                          | Alle Prozentpreise mit Basis „Verkaufspreis" werden aktualisiert     |
| Einkaufspreis des Produkts ändert sich                          | Alle Prozentpreise mit Basis „Einkaufspreis" werden aktualisiert     |
| Prozentwert wird über die Mehrfachänderung oder API gespeichert | Absolute Preise werden sofort aus dem aktuellen Grundpreis berechnet |

## Massen-Neuberechnung (Konsolen-Befehl)

Falls Sie eine Neuberechnung aller prozentualen Preise erzwingen möchten – z. B. nach einem Datenimport oder einer Bulk-Preisänderung:

```bash
bin/console momo:percentage-prices:recalculate
```

Dieser Befehl berechnet alle prozentualen erweiterten Preise für alle Produkte neu und aktualisiert die absoluten Preise basierend auf den aktuellen Grundpreisen. Dabei wird auch die konfigurierte Berechnungsbasis (Verkaufspreis/Einkaufspreis) berücksichtigt.

**Wann ist das sinnvoll?**

* Nach einem Daten-Import, der Grundpreise geändert hat
* Wenn Sie sicherstellen möchten, dass alle Preise aktuell sind
* Nach einer Migration von einer anderen Shopware-Version

## Zusammenspiel mit bestehenden Preisen

Das Plugin ergänzt die bestehende Preisfunktion von Shopware:

* Erweiterte Preise ohne Prozentangabe funktionieren wie gewohnt
* Prozentangaben und absolute Preise können in derselben Preistabelle nebeneinander existieren
* Nur Zeilen mit einem Prozentwert werden automatisch neu berechnet


---

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

```
GET https://docs.momocode.de/shopware-6/prozentbasierte-erweiterte-preise/3.-konfiguration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
