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. |
{ "amount": 5000, "currency": "EUR", "precision": 2 }
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 }
}'
