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

# Provisionspläne

> Provisionspläne definieren, wie Provisionen berechnet werden: flexible Sätze, Produktregeln und Geltungsbereiche.

## Übersicht

Ein Provisionsplan definiert die Berechnungslogik für Vertriebsprovisionen. Du kannst mehrere Pläne für unterschiedliche Vertriebsstrukturen erstellen, z.B. einen Plan für das Neukundengeschäft und einen für Bestandskunden.

<Frame>
  <img src="https://mintcdn.com/fynnsubscriptionbilling/zDQkHT5wBBQ3jA-O/images/commission-plan-config.png?fit=max&auto=format&n=zDQkHT5wBBQ3jA-O&q=85&s=238f3a9bf23dfd4a6ec6642c12138d20" alt="Provisionsplan konfigurieren" width="1378" height="1694" data-path="images/commission-plan-config.png" />
</Frame>

***

## Plan erstellen

<Tabs>
  <Tab title="Web-App verwenden">
    <Steps>
      <Step title="Pläne öffnen">
        Navigiere zu **Provisionen > Aktionen > Einstellungen > Pläne** und klicke auf **Neuer Plan**.
      </Step>

      <Step title="Grunddaten festlegen">
        Konfiguriere die Berechnungsparameter:

        | Parameter           | Beschreibung                                                                              |
        | ------------------- | ----------------------------------------------------------------------------------------- |
        | **Name**            | Bezeichnung des Plans (z.B. "Neukundenvertrieb 10 %")                                     |
        | **Prozentsatz**     | Basisprovision in Prozent (z.B. 10 %)                                                     |
        | **Basis**           | Berechnung auf **Netto** oder **Brutto**-Betrag der Rechnungspositionen                   |
        | **Auslöser**        | Wann die Provision berechnet wird: bei **Rechnungsstellung** oder bei **Zahlungseingang** |
        | **Geltungsbereich** | Für **alle Rechnungen** oder nur den **ersten Vertragszeitraum**                          |
      </Step>

      <Step title="Produktregeln hinzufügen (optional)">
        Über den Bereich **Produktregeln** kannst du den Provisionssatz pro Produkt überschreiben. Mehr dazu im Abschnitt [Produktregeln](#produktregeln).
      </Step>

      <Step title="Optionale Einstellungen">
        * **Deal erforderlich**: Nur Rechnungen mit verknüpftem HubSpot-Deal generieren Provisionen
        * **Mindestauszahlung pro Vertriebsmitarbeiter**: Erst ab dieser monatlichen Provisionssumme je Vertriebsmitarbeiter wird ausgezahlt. Bleibt die Summe darunter, wird der ganze Monat zurückgehalten
        * **Mindestumsatz pro Monat**: Erreicht ein Vertriebsmitarbeiter diesen Umsatz im Monat nicht, gibt es für den gesamten Monat keine Provision. Wird die Grenze erreicht, wird der komplette Umsatz provisioniert
      </Step>

      <Step title="Plan speichern">
        Der Plan ist sofort aktiv und wird bei neuen Rechnungen für zugewiesene Kunden angewendet.
      </Step>
    </Steps>
  </Tab>

  <Tab title="API verwenden">
    ```bash theme={null}
    POST /api/commissions/plans

    {
      "name": "Neukundenvertrieb 10 %",
      "percentage": 0.10,
      "basisType": "net",
      "triggerEvent": "invoice_finalized",
      "scope": "first_contract_period",
      "requireDeal": false,
      "payoutThresholdAmount": { "amount": 0, "currency": "EUR", "precision": 2 },
      "monthlyRevenueThreshold": { "amount": 0, "currency": "EUR", "precision": 2 },
      "rules": [
        {
          "externalProductReference": "enterprise-plan",
          "percentage": 0.20,
          "priority": 1
        }
      ]
    }
    ```
  </Tab>
</Tabs>

***

## Auslöser: Rechnungsstellung vs. Zahlungseingang

| Auslöser              | Wann berechnet                                | Empfohlen für                                             |
| --------------------- | --------------------------------------------- | --------------------------------------------------------- |
| **Rechnungsstellung** | Sobald die Rechnung finalisiert wird          | Schnelle Sichtbarkeit, wenn Zahlungsrisiko gering ist     |
| **Zahlungseingang**   | Sobald die Rechnung als bezahlt markiert wird | Konservativ: Provision erst bei tatsächlichem Geldeingang |

<Info>
  Der Auslöser bestimmt nur, **wann** die Provision berechnet wird. Die Auszahlung erfolgt in beiden Fällen erst nach manueller Freigabe.
</Info>

***

## Geltungsbereich

| Scope                       | Beschreibung                                                      | Anwendungsfall                                         |
| --------------------------- | ----------------------------------------------------------------- | ------------------------------------------------------ |
| **Alle Rechnungen**         | Provision auf jede Rechnung des zugewiesenen Kunden               | Laufende Vertriebsprovision (z.B. Reseller, Partner)   |
| **Erster Vertragszeitraum** | Provision nur auf Rechnungen innerhalb der ersten Vertragsperiode | Neukundenvergütung, keine Provision auf Verlängerungen |

<Tip>
  Der erste Vertragszeitraum wird automatisch aus dem Abonnement ermittelt. Rechnungen, deren Leistungszeitraum nach dem Ende der ersten Vertragsperiode liegt, generieren keine Provision.
</Tip>

***

## Produktregeln

Nicht jedes Produkt hat die gleiche Marge. Beim Erstellen oder Bearbeiten eines Plans kannst du Produktregeln definieren, die den Basisprozentsatz für bestimmte Produkte überschreiben.

### Beispiel

| Produkt            | Basisprovision | Produktregel | Effektiver Satz           |
| ------------------ | -------------- | ------------ | ------------------------- |
| Starter Plan       | 10 %           | -            | 10 %                      |
| Professional Plan  | 10 %           | 15 %         | **15 %**                  |
| Enterprise Plan    | 10 %           | 20 %         | **20 %**                  |
| Einrichtungsgebühr | 10 %           | 0 %          | **0 %** (keine Provision) |

Jede Regel enthält:

* **Externe Produktreferenz**: Kennung des Produkts (z.B. Produkt-ID oder externer Schlüssel)
* **Prozentsatz**: Abweichender Provisionssatz für dieses Produkt
* **Priorität**: Reihenfolge bei mehreren Regeln

<Info>
  Produktregeln werden anhand der Rechnungsposition ermittelt. Gibt es keine Regel für ein Produkt, greift der Basisprozentsatz des Plans.
</Info>

***

## Plan aktivieren und deaktivieren

Pläne können jederzeit aktiviert oder deaktiviert werden. Deaktivierte Pläne generieren keine neuen Provisionen, bestehende Provisionen bleiben erhalten.

***

## Mehrere Pläne

Du kannst beliebig viele Pläne erstellen. Ein Vertriebsmitarbeiter hat einen **Standard-Plan**, der bei Kundenzuweisungen automatisch verwendet wird. Bei individuellen Zuweisungen kann ein abweichender Plan gewählt werden.

```
Vertriebsmitarbeiter: Max Mustermann
├── Standard-Plan: "Neukundenvertrieb 10 %"
│
├── Kunde A → verwendet Standard-Plan (10 %)
├── Kunde B → verwendet Standard-Plan (10 %)
└── Kunde C → individueller Plan: "Partner Premium 15 %"
```