> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/artikel-konfigurator/preise-und-multiplikator.md).

# Preisaufschläge & Multiplikator

Felder können den Preis eines Produkts beeinflussen – entweder über einen **festen Preisaufschlag** je Option oder über einen **Multiplikator (Faktor)** auf den Verkaufspreis.

## Preise aktivieren

Die Preisfunktion wird global in der [Plugin-Konfiguration](/artikel-konfigurator/plugin-konfiguration.md) aktiviert:

**Einstellungen > System > Plugins > Artikel Konfigurator … > Konfiguration**

* **Preisaufschlag für Optionsfelder aktivieren** (`enablePrices`) – Erst wenn diese Option aktiv ist, können Sie für Optionen einen Wert (Preis bzw. Faktor) hinterlegen.

Solange die Option deaktiviert ist, geben Sie Auswahlmöglichkeiten einfach **kommasepariert** ein (z. B. `Tee, Kaffee, Wasser`). Mit aktivierten Preisen pflegen Sie pro Option stattdessen **Name + Wert**.

## Optionen mit Preis (Dropdown, Einzel- & Mehrfachauswahl)

Bei aktivierten Preisen erscheint in den Feldtypen **Dropdown**, **Einzelauswahl** und **Mehrfachauswahl** eine Liste von Optionen mit jeweils zwei Eingaben:

| Eingabe             | Bedeutung                                                                          |
| ------------------- | ---------------------------------------------------------------------------------- |
| **Name der Option** | Anzeigetext der Option, z. B. `Schwarz`.                                           |
| **Wert**            | Der Preisaufschlag (z. B. `10`) oder – bei aktiviertem Multiplikator – der Faktor. |

Über **Option hinzufügen** legen Sie weitere Optionen an, über das Löschen-Symbol entfernen Sie eine Option.

### Fester Preisaufschlag

Ist der Schalter **Multiplikator** deaktiviert, wird der **Wert** als fester Aufschlag auf den Produktpreis addiert. Wählt der Kunde z. B. eine Option mit dem Wert `10`, erhöht sich der Stückpreis um 10.

### Multiplikator (Faktor auf den Verkaufspreis)

Ist der Schalter **Multiplikator** aktiviert, wird der hinterlegte **Wert** der gewählten Option **mit dem Verkaufspreis multipliziert**. So lassen sich preisabhängige Aufschläge umsetzen (z. B. ein prozentualer Zuschlag für eine bestimmte Ausführung).

## Zahlenfeld als Multiplikator

Auch ein **Zahlenfeld** kann als Multiplikator dienen. Aktivieren Sie dazu bei aktivierten Preisen den Schalter **Multiplikator** im Zahlenfeld. Es stehen folgende Parameter zur Verfügung:

| Parameter        | Bedeutung                                 |
| ---------------- | ----------------------------------------- |
| **Wert**         | Basiswert für die Multiplikation.         |
| **Schrittweite** | Schrittweite für die Eingabe im Frontend. |
| **Min**          | Kleinster zulässiger Wert.                |
| **Max**          | Größter zulässiger Wert.                  |

Die vom Kunden eingegebene Zahl wird zur Preisberechnung herangezogen – ideal z. B. für Maße oder Mengen, bei denen der Preis mit der Eingabe skaliert.

## Anzeige der Faktoren im Warenkorb

Über die [Plugin-Konfiguration](/artikel-konfigurator/plugin-konfiguration.md) steuern Sie mit **Faktoren im Warenkorb anzeigen** (`displayMarkupFactors`), ob die zugrunde liegenden Faktoren im Warenkorb dargestellt werden. Diese Option ist nur relevant, wenn Sie mit **Multiplikatoren** arbeiten.

## Berechnung & Ausgabe

Die Preisaufschläge und Faktoren werden serverseitig im Warenkorb verrechnet und fließen in den Gesamtpreis der Position ein. In der Bestellung, im Warenkorb und auf Belegen werden die gewählten Optionen samt zugehörigem Preis ausgewiesen – siehe [Ausgabe in Bestellung & Belegen](/artikel-konfigurator/ausgabe-bestellung-belege.md).

> **Hinweis:** Die Option **Getrennte Menge für Attribut mit Preisen** (`separatedQuantity`) ist für eine zukünftige Version vorgesehen und in der aktuellen Konfiguration deaktiviert.