Kernkonzepte

Ein Provisionsplan legt den Provisionssatz fest und steuert, ab wann ausgezahlt wird. Diese Seite erklärt die Felder, die du beim Anlegen setzt, und die beiden monatlichen Schwellen.

Felder eines Plans

Feld	Bedeutung
`name`	Interner Name des Plans.
`type`	Berechnungsart. Aktuell `ongoing_percentage`.
`percentage`	Basissatz als Dezimalbruch, `0.10` entspricht 10 %.
`basisType`	Berechnung auf `net` oder `gross` des Rechnungsbetrags.
`triggerEvent`	`invoice_finalized` (bei Rechnungsstellung) oder `invoice_paid` (bei Zahlungseingang).
`commissionScope`	`all_invoices` oder `first_contract_period`.
`requireDeal`	Wenn `true`, generieren nur Rechnungen mit verknüpftem Deal Provisionen.
`payoutThresholdAmount`	Mindestauszahlung je Vertriebsmitarbeiter und Monat. Siehe unten.
`monthlyRevenueThreshold`	Mindestumsatz je Vertriebsmitarbeiter und Monat. Siehe unten.
`rules`	Produktregeln, die den Basissatz je Produkt überschreiben.

Beträge gibst du als Objekt in kleinster Einheit an:

{ "amount": 5000, "currency": "EUR", "precision": 2 }

Das entspricht 50,00 EUR. Lässt du eine Schwelle weg oder setzt sie auf null, gilt keine Grenze.

Die beiden monatlichen Schwellen

Beide Schwellen wirken je Vertriebsmitarbeiter, je Plan, je Kalendermonat, immer über alle Kunden eines Vertriebsmitarbeiters zusammen. Sie entscheiden, ob die Provisionen eines Monats ausgezahlt werden. Mindestauszahlung (payoutThresholdAmount) Erreicht die Provisionssumme eines Vertriebsmitarbeiters im Monat diese Grenze nicht, wird der ganze Monat zurückgehalten. Erreicht sie die Grenze, wird der komplette Monat ausgezahlt. Mindestumsatz (monthlyRevenueThreshold) Erreicht der Umsatz eines Vertriebsmitarbeiters im Monat diese Grenze nicht, gibt es für den gesamten Monat keine Provision. Wird die Grenze erreicht, wird der komplette Umsatz provisioniert. So belohnst du das Erreichen von Monatszielen. Sind beide gesetzt, muss ein Monat beide erreichen, damit er ausgezahlt wird.

Zurückgehaltene Provisionen gehen nicht verloren. Sie bleiben genehmigt und werden aufgenommen, sobald die Grenze in einem zukünftigen Monat erreicht wird.

Beispiel

Ein Plan mit Mindestauszahlung 50 EUR und Mindestumsatz 1.000 EUR:

Vertriebsmitarbeiter	Umsatz im Monat	Provision im Monat	Ergebnis
A	1.500 EUR	75 EUR	wird ausgezahlt (beide Grenzen erreicht)
B	600 EUR	75 EUR	zurückgehalten (Mindestumsatz nicht erreicht)
C	1.500 EUR	25 EUR	zurückgehalten (Mindestauszahlung nicht erreicht)

Einen Plan anlegen

curl https://coreapi.io/api/commissions/plans \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Neukundenvertrieb 10 %",
    "percentage": "0.10",
    "basisType": "net",
    "triggerEvent": "invoice_finalized",
    "commissionScope": "all_invoices",
    "requireDeal": false,
    "payoutThresholdAmount": { "amount": 5000, "currency": "EUR", "precision": 2 },
    "monthlyRevenueThreshold": { "amount": 100000, "currency": "EUR", "precision": 2 }
  }'

Die vollständige Referenz aller Felder und Antworten findest du unter Provisionspläne.

Einführung

Grundlagen

Pläne

Angebote

Provisionen

Zahlungspläne

Felder eines Plans

Die beiden monatlichen Schwellen

Beispiel

Einen Plan anlegen

​Felder eines Plans

​Die beiden monatlichen Schwellen

​Beispiel

​Einen Plan anlegen

Felder eines Plans

Die beiden monatlichen Schwellen

Beispiel

Einen Plan anlegen