13 — Bonusprogramme

PartnerDesk kennt zwei Bonus-Mechanismen über die regulären Tier-Provisionen hinaus: Leistungsprämien (für Umsatz-Schwellenwerte) und Lead-Aff-Boni (für Downline-Aufbau). Beide werden täglich automatisch evaluiert und in die nächste Gutschrift eingerechnet.

Leistungsprämien (BonusRules)

Wann sinnvoll?

Sie wollen Top-Performer extra belohnen — z. B. „Wer in einem Quartal mehr als 10.000 € Umsatz generiert, bekommt 500 € Bonus".

Anlage

Admin → „Bonus" → „Neue Regel".

Feld	Bedeutung
Name	Anzeigename (z. B. „Quartalsbonus 10k")
Threshold-Typ	Worauf zielt die Regel
Threshold-Wert	Schwelle, ab der ausgelöst wird
Bonus-Betrag	Fester Bonus in EUR (oder Tenant-Default-Currency)
Period-Typ	monthly, quarterly, yearly, custom
Aktiv	Master-Switch

Threshold-Typen

Typ	Berechnung pro Partner
gross_sum	Summe Brutto-Umsatz aller TX im Zeitraum
commission_sum	Summe der Provisionen
tx_count	Anzahl Transactions
referral_count	Anzahl direkt empfohlener aktiver Partner
referral_revenue	Brutto-Umsatz der Downline im Zeitraum

Die letzten beiden ermutigen Partner zum Downline-Aufbau.

Tägliche Evaluation

Der Daily-Scheduler prüft jeden Tag für jede aktive Regel und jeden aktiven Partner, ob die Schwelle in der aktuellen Periode erreicht wurde. Bei Erfolg:

1. BonusAward-Datensatz wird angelegt (UNIQUE-Constraint rule + partner + period_start verhindert Doppel-Vergabe).
2. Transaction mit paymentProvider='manual' wird erzeugt — der Bonus-Betrag erscheint als Provision in der nächsten Auszahlungsperiode.

Wo sieht der Partner den Bonus?

In seiner Provisionsliste als reguläre Transaction mit Note „Bonus: ".

Lead-Aff-Boni

Ähnlicher Mechanismus, aber spezialisiert auf das Lead-Empfehlungs-Programm:

• referral_count belohnt Vermittler-Aktivität (egal ob die Leads später kaufen).
• referral_revenue belohnt erfolgreich konvertierende Vermittler.

Lässt sich z. B. nutzen für: „Wer 5 Leads pro Monat ins Empfehlungs-Programm bringt, bekommt 50 € Bonus".

Beispiel-Konfiguration

Regel-Name	Threshold-Typ	Wert	Bonus	Period
Quartals-Top	gross_sum	10.000 €	500 €	quarterly
Aktiver Werber	referral_count	5	50 €	monthly
Jahresgewinner	commission_sum	5.000 €	1.000 €	yearly

Tipps

• Klein anfangen — ein zu großzügig konfigurierter Bonus kann den Cashflow belasten.
• Idempotenz im Hinterkopf: pro Periode wird jeder Bonus nur einmal vergeben — Sie können also auch monatlich evaluieren, ohne Mehrfach-Zahlungen befürchten zu müssen.
• Period-Reset: bei quarterly startet die Periode am 1. Januar/April/Juli/Oktober. Custom-Perioden definieren Sie selbst.

Verwandte Kapitel

• 11 — Provisionsmodelle — Standard-Tier-Provisionen.
• 12 — MLM-Struktur — Downline-basis.
• 40 — Auszahlungen — Wo Boni in die Gutschrift einfließen.

---

Technische Tiefen-Doku: ../100-performance-bonuses.md, ../104-daily-scheduler.md, ../105-lead-aff-bonuses.md