Partnerprogramm & Provisionen
Überblick
Der Bereich führt Vertriebspartner, ordnet ihnen Umsätze zu und rechnet daraus Provisionen ab. Drei Dinge hängen zusammen: der Partner (wer vermittelt), die Zuordnung (welcher Umsatz gehört ihm) und die Abrechnung (was wird ausgezahlt).
Die Zuordnung geschieht über Referral-Codes. Ein Umsatz ohne Code bleibt unzugeordnet — das ist Absicht: eine geratene Zuordnung wäre am Ende eine falsche Auszahlung.
Kernaufgaben
Einen Partner anlegen. In der Partnerliste legen Sie Stammdaten, Rolle und Auszahlungs- konditionen fest. Zum Partner gehören ein oder mehrere Referral-Codes.
Umsätze zuordnen. Kommt ein Umsatz über einen Referral-Code herein, wird er dem Partner zugeschrieben. Im Partner-Detail sehen Sie die zugeordneten Umsätze und die daraus errechnete Provision.
Provisionsregeln pflegen. Die Regeln bestimmen, wie aus einem Umsatz eine Provision wird — prozentual oder als fester Betrag, je nach Partner-Rolle.
Abrechnen und auszahlen. Ein Abrechnungslauf fasst die offenen Provisionen eines Zeitraums zu einer Abrechnung zusammen. Die Abrechnung wird erst freigegeben und dann als ausgezahlt markiert — zwei Schritte, damit eine Auszahlung nie versehentlich passiert.
Felder im Detail
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Geschäftspartner businessPartnerUlid | ja | bestehender Partner | Wer der Partner ist. Anschrift und Kontakte kommen von dort — ein Partner ist eine Rolle, kein zweiter Adressstamm. |
Partnernummer partnerNumber | nein | Text, max. 50 Zeichen | Ihre Nummer für den Partner. |
Art partnerType | nein | Affiliate, Wiederverkäufer, intern, Empfehler | Welche Art von Partnerschaft. Sie bestimmt, welche Provisionsregeln greifen. |
Stufe defaultTier | nein | Text, max. 30 Zeichen | Die Provisionsstufe, mit der abgerechnet wird. |
Auszahlungsart payoutMode | nein | Gutschrift, Selbstabrechnung, Partnerrechnung | Wie abgerechnet wird. Selbstabrechnung heißt: Sie erstellen die Abrechnung im Namen des Partners — das spart ihm die Rechnung, verlangt aber seine Zustimmung. |
Auszahlungsweg payoutMethod | nein | SEPA oder PayPal | Womit ausgezahlt wird. |
Mindestauszahlung minPayoutAmount | nein | Betrag, 0 oder mehr | Ab welchem Betrag ausgezahlt wird. Darunter bleibt die Provision stehen und wächst weiter — das erspart Überweisungen über wenige Euro. |
Status status | nein | aktiv, pausiert, gesperrt | Ob der Partner vermitteln und abrechnen darf. |
Interner Betreuer linkedEmployeeId | nein | Mitarbeiter | Wer die Partnerschaft führt. |
Einstellungen & Rechte
- Lesen:
affiliate.partner.view - Partner-Stamm (Rolle, Referral-Codes, Auszahlungskonditionen):
affiliate.partner.manage - Provisionsregeln und Zuordnung:
affiliate.commission.manage - Abrechnungslauf fahren, freigeben und auszahlen:
affiliate.settlement.run
Das Modul hängt am Flag module.affiliate. Ist es aus, verschwinden Navigation und Endpunkte.
FAQ & Fehlerbilder
Ein Umsatz taucht bei keinem Partner auf. Dann trug er keinen Referral-Code. Nachträglich lässt sich die Zuordnung im Umsatz setzen, sofern Sie das Provisions-Recht haben.
Die Provision weicht von der Erwartung ab. Prüfen Sie, welche Regel gegriffen hat: Rolle und Zeitpunkt entscheiden, nicht der heutige Regelstand.
Eine Abrechnung lässt sich nicht mehr ändern. Nach der Freigabe ist sie fest — das ist gewollt. Korrekturen laufen über eine neue Abrechnung.