> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Preisberechnung

> So berechnet Fynn die verschiedenen Preistypen im Detail

Fynn unterstützt sechs verschiedene Preistypen, die jeweils einer festen Berechnungslogik folgen. Dieser Guide erklärt, wie die Berechnung für jeden Typ funktioniert und wie Zusatzfunktionen wie freie Einheiten, Mindestabnahme und Basisgebühren einbezogen werden.

## Berechnungsreihenfolge

Bevor die eigentliche Preisberechnung startet, werden zwei optionale Anpassungen auf die Menge angewendet:

<Steps>
  <Step title="Mindestabnahme anwenden">
    Ist eine Mindestabnahme konfiguriert, wird die Menge auf mindestens diesen Wert gesetzt.

    `Menge = max(Menge, Mindestabnahme)`
  </Step>

  <Step title="Freie Einheiten abziehen">
    Sind freie Einheiten konfiguriert, werden diese von der Menge abgezogen. Die Menge kann nicht negativ werden.

    `Menge = max(Menge − freie Einheiten, 0)`
  </Step>

  <Step title="Preisberechnung">
    Die bereinigte Menge wird an die Berechnungslogik des jeweiligen Preistyps übergeben.
  </Step>
</Steps>

<Note>
  Die Mindestabnahme wird **vor** den freien Einheiten angewendet. Dadurch ist sichergestellt, dass die Mindestabnahme die Basis bildet, von der anschließend die freien Einheiten abgezogen werden.
</Note>

**Beispiel:** 5 Benutzer, Mindestabnahme 10, freie Einheiten 3

1. Mindestabnahme: max(5, 10) = **10**
2. Freie Einheiten: max(10 − 3, 0) = **7**
3. Es werden 7 Einheiten berechnet.

***

## Pauschale (Flat Fee)

Ein fester Betrag pro Abrechnungsperiode, unabhängig von der Menge.

| Eingabe | Wert    |
| ------- | ------- |
| Preis   | 29,00 € |

**Berechnung:** 29,00 € (fest, keine Mengenabhängigkeit)

<Tip>
  Pauschale eignet sich für Basispakete, Grundgebühren oder einmalige Setup-Gebühren.
</Tip>

***

## Pro Einheit (Per Unit)

Der Stückpreis wird mit der bereinigten Menge multipliziert.

| Eingabe    | Wert        |
| ---------- | ----------- |
| Stückpreis | 5,00 €      |
| Menge      | 10 Benutzer |

**Berechnung:** 10 × 5,00 € = **50,00 €**

**Mit freien Einheiten:** 10 Benutzer, 3 frei → 7 × 5,00 € = **35,00 €**

***

## Staffelpreis (Tiered)

Jeder Mengenbereich hat seinen eigenen Stückpreis. Die Bereiche werden **nacheinander** abgerechnet — jede Einheit erhält den Preis der Stufe, in die sie fällt.

### Stufenkonfiguration

| Stufe | Ab Menge | Stückpreis |
| ----- | -------- | ---------- |
| 1     | 0        | 10,00 €    |
| 2     | 10       | 8,00 €     |
| 3     | 50       | 6,00 €     |

Eine Stufe deckt die Menge von ihrem `Ab Menge`-Wert bis zum `Ab Menge`-Wert der nächsten Stufe ab. Die erste Stufe beginnt immer bei 0.

### Berechnungsbeispiel

**25 Einheiten:**

| Stufe     | Einheiten | Stückpreis | Zwischensumme |
| --------- | --------- | ---------- | ------------- |
| 1 (0–9)   | 10        | 10,00 €    | 100,00 €      |
| 2 (10–24) | 15        | 8,00 €     | 120,00 €      |

**Gesamt: 220,00 €**

**60 Einheiten:**

| Stufe     | Einheiten | Stückpreis | Zwischensumme |
| --------- | --------- | ---------- | ------------- |
| 1 (0–9)   | 10        | 10,00 €    | 100,00 €      |
| 2 (10–49) | 40        | 8,00 €     | 320,00 €      |
| 3 (50–59) | 10        | 6,00 €     | 60,00 €       |

**Gesamt: 480,00 €**

<Info>
  Bei Staffelpreisen mit freien Einheiten werden die freien Einheiten **vor** der Stufenzuordnung abgezogen. Die bereinigte Menge durchläuft dann die Stufen von vorne.
</Info>

**Mit freien Einheiten:** 25 Einheiten, 5 frei → 20 bereinigte Einheiten

| Stufe     | Einheiten | Stückpreis | Zwischensumme |
| --------- | --------- | ---------- | ------------- |
| 1 (0–9)   | 10        | 10,00 €    | 100,00 €      |
| 2 (10–19) | 10        | 8,00 €     | 80,00 €       |

**Gesamt: 180,00 €**

***

## Volumenpreis (Volume)

Der Stückpreis wird anhand der **Gesamtmenge** bestimmt. Alle Einheiten erhalten dann denselben Preis.

### Stufenkonfiguration

| Stufe | Ab Menge | Stückpreis |
| ----- | -------- | ---------- |
| 1     | 0        | 10,00 €    |
| 2     | 10       | 8,00 €     |
| 3     | 50       | 6,00 €     |

### Berechnungsbeispiel

**25 Einheiten:** Stufe 2 greift (25 ≥ 10) → 25 × 8,00 € = **200,00 €**

**60 Einheiten:** Stufe 3 greift (60 ≥ 50) → 60 × 6,00 € = **360,00 €**

**8 Einheiten:** Stufe 1 greift (8 ≥ 0) → 8 × 10,00 € = **80,00 €**

<Warning>
  Beim Volumenpreis mit freien Einheiten wird die Stufe anhand der **Gesamtmenge** (vor Abzug der freien Einheiten) bestimmt. Die Preisberechnung erfolgt dann mit der **bereinigten Menge** (nach Abzug).
</Warning>

**Mit freien Einheiten:** 25 Einheiten, 5 frei

1. Stufenbestimmung: Gesamtmenge 25 → Stufe 2 (8,00 €)
2. Berechnung: (25 − 5) × 8,00 € = 20 × 8,00 € = **160,00 €**

***

## Stufenpreis (Stair Step)

Ein **fester Betrag** pro Mengenstufe. Der Preis ist unabhängig von der genauen Menge innerhalb der Stufe.

### Stufenkonfiguration

| Stufe | Ab Menge | Festpreis |
| ----- | -------- | --------- |
| 1     | 0        | 50,00 €   |
| 2     | 10       | 150,00 €  |
| 3     | 50       | 300,00 €  |

### Berechnungsbeispiel

**8 Einheiten:** Stufe 1 greift (8 ≥ 0) → **50,00 €**

**25 Einheiten:** Stufe 2 greift (25 ≥ 10) → **150,00 €**

**60 Einheiten:** Stufe 3 greift (60 ≥ 50) → **300,00 €**

<Info>
  Beim Stufenpreis bestimmt — wie beim Volumenpreis — die **Gesamtmenge** (vor Abzug der freien Einheiten) die Stufe.
</Info>

***

## Prozentual (Percentage)

Ein Prozentsatz wird auf den gemeldeten Wert angewendet.

| Eingabe         | Wert            |
| --------------- | --------------- |
| Prozentsatz     | 2,5 %           |
| Stückpreis      | 1,00 €          |
| Gemeldeter Wert | 1.000 Einheiten |

**Berechnung:** 1.000 × 2,5 % × 1,00 € = 25 × 1,00 € = **25,00 €**

Zusätzlich können beim prozentualen Preistyp eigene Freibeträge konfiguriert werden:

* **Frei pro Ereignis:** Anzahl Einheiten, die pro Nutzungsereignis abgezogen werden
* **Frei pro Gesamt:** Anzahl Einheiten, die von der Gesamtsumme abgezogen werden

***

## Basisgebühr (flatAmount)

Neben dem mengenabhängigen Preis kann auf jeder Stufe eine **Basisgebühr** konfiguriert werden. Diese wird als fester Betrag zusätzlich zum Stückpreis berechnet, sobald die jeweilige Stufe Einheiten enthält.

<Tip>
  Basisgebühren eignen sich für monatliche Grundgebühren, die zusätzlich zu einem nutzungsabhängigen Preis anfallen.
</Tip>

### Beispiel: Staffelpreis mit Basisgebühr

| Stufe | Ab Menge | Stückpreis | Basisgebühr |
| ----- | -------- | ---------- | ----------- |
| 1     | 0        | 5,00 €     | 199,00 €    |

**15 Einheiten:** 15 × 5,00 € + 199,00 € = **274,00 €**

### Beispiel: Mehrere Stufen mit Basisgebühr

| Stufe | Ab Menge | Stückpreis | Basisgebühr |
| ----- | -------- | ---------- | ----------- |
| 1     | 0        | 10,00 €    | 99,00 €     |
| 2     | 20       | 7,00 €     | 0,00 €      |

**30 Einheiten:**

| Stufe     | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
| --------- | --------- | ---------- | ------------- | ----------- |
| 1 (0–19)  | 20        | 10,00 €    | 200,00 €      | 99,00 €     |
| 2 (20–29) | 10        | 7,00 €     | 70,00 €       | 0,00 €      |

**Gesamt: 200,00 € + 99,00 € + 70,00 € = 369,00 €**

<Note>
  Die Basisgebühr wird nur berechnet, wenn die Stufe mindestens eine Einheit enthält. Bei Stufen ohne Einheiten fällt keine Basisgebühr an.
</Note>

***

## Freie Einheiten mit Basisgebühr

Wenn ein Preis sowohl freie Einheiten als auch eine Basisgebühr hat, ist es wichtig zu verstehen, wie diese zusammenwirken. Es gibt zwei Varianten:

### Variante 1: Basisgebühr fällt immer an

Die freien Einheiten werden als eigene Stufe mit einem Stückpreis von 0 konfiguriert. Die Basisgebühr wird auf dieser Stufe hinterlegt und fällt dadurch **immer** an — auch wenn die Nutzung innerhalb der freien Einheiten liegt.

| Stufe | Ab Menge | Stückpreis | Basisgebühr |
| ----- | -------- | ---------- | ----------- |
| 1     | 0        | 0,00 €     | 199,00 €    |
| 2     | 10       | 99,00 €    | 0,00 €      |

<AccordionGroup>
  <Accordion title="5 Benutzer">
    | Stufe   | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
    | ------- | --------- | ---------- | ------------- | ----------- |
    | 1 (0–9) | 5         | 0,00 €     | 0,00 €        | 199,00 €    |

    **Gesamt: 199,00 €** (nur die Basisgebühr, alle Benutzer sind inklusive)
  </Accordion>

  <Accordion title="15 Benutzer">
    | Stufe     | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
    | --------- | --------- | ---------- | ------------- | ----------- |
    | 1 (0–9)   | 10        | 0,00 €     | 0,00 €        | 199,00 €    |
    | 2 (10–14) | 5         | 99,00 €    | 495,00 €      | 0,00 €      |

    **Gesamt: 199,00 € + 495,00 € = 694,00 €**
  </Accordion>
</AccordionGroup>

### Variante 2: Basisgebühr fällt erst nach Verbrauch der freien Einheiten an

Die freien Einheiten werden über das Feld `Freie Einheiten` konfiguriert. Die Basisgebühr wird als `flatAmount` auf der ersten Stufe hinterlegt. Da die freien Einheiten **vor** der Stufenberechnung abgezogen werden, greift die Stufe erst, wenn die Nutzung die freien Einheiten übersteigt.

**Konfiguration:** 10 freie Einheiten

| Stufe | Ab Menge | Stückpreis | Basisgebühr |
| ----- | -------- | ---------- | ----------- |
| 1     | 0        | 99,00 €    | 199,00 €    |

<AccordionGroup>
  <Accordion title="5 Benutzer">
    Abzug freie Einheiten: max(5 − 10, 0) = **0 bereinigte Einheiten**

    Keine Stufe greift, da keine bereinigten Einheiten vorhanden sind.

    **Gesamt: 0,00 €** (alle Benutzer liegen innerhalb der freien Einheiten)
  </Accordion>

  <Accordion title="15 Benutzer">
    Abzug freie Einheiten: max(15 − 10, 0) = **5 bereinigte Einheiten**

    | Stufe | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
    | ----- | --------- | ---------- | ------------- | ----------- |
    | 1     | 5         | 99,00 €    | 495,00 €      | 199,00 €    |

    **Gesamt: 495,00 € + 199,00 € = 694,00 €**
  </Accordion>
</AccordionGroup>

<Warning>
  Verwende niemals freie Einheiten und eine Stufe mit Stückpreis 0 gleichzeitig. Das würde dazu führen, dass Einheiten doppelt als kostenlos gewertet werden.
</Warning>

***

## Komplexbeispiel

**Szenario:** 99 € pro Benutzer/Monat, 10 Benutzer inklusive, ab dem 15. Benutzer 80 € pro Benutzer, Basisgebühr 199 €.

**Konfiguration** (Basisgebühr fällt immer an):

| Stufe | Ab Menge | Stückpreis | Basisgebühr |
| ----- | -------- | ---------- | ----------- |
| 1     | 0        | 0,00 €     | 199,00 €    |
| 2     | 10       | 99,00 €    | 0,00 €      |
| 3     | 15       | 80,00 €    | 0,00 €      |

<AccordionGroup>
  <Accordion title="5 Benutzer">
    | Stufe   | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
    | ------- | --------- | ---------- | ------------- | ----------- |
    | 1 (0–9) | 5         | 0,00 €     | 0,00 €        | 199,00 €    |

    **Gesamt: 199,00 € pro Monat**
  </Accordion>

  <Accordion title="12 Benutzer">
    | Stufe     | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
    | --------- | --------- | ---------- | ------------- | ----------- |
    | 1 (0–9)   | 10        | 0,00 €     | 0,00 €        | 199,00 €    |
    | 2 (10–11) | 2         | 99,00 €    | 198,00 €      | 0,00 €      |

    **Gesamt: 199,00 € + 198,00 € = 397,00 € pro Monat**
  </Accordion>

  <Accordion title="20 Benutzer">
    | Stufe     | Einheiten | Stückpreis | Zwischensumme | Basisgebühr |
    | --------- | --------- | ---------- | ------------- | ----------- |
    | 1 (0–9)   | 10        | 0,00 €     | 0,00 €        | 199,00 €    |
    | 2 (10–14) | 5         | 99,00 €    | 495,00 €      | 0,00 €      |
    | 3 (15–19) | 5         | 80,00 €    | 400,00 €      | 0,00 €      |

    **Gesamt: 199,00 € + 495,00 € + 400,00 € = 1.094,00 € pro Monat**
  </Accordion>
</AccordionGroup>