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.
Referral-Links weitergeben. Ein Referral der Art Link zeigt im Partner-Detail seine Adresse zum Kopieren. Wer sie öffnet, landet auf dem Ziel aus Referral-Programm (Ihre Website); die Landung steht am Referral, und der Browser merkt sich den Partner bis zum Ablauf des Codes, höchstens so lange wie das Attributionsfenster des Programms (Vorgabe 90 Tage, siehe Einstellungen & Rechte). Registriert sich der Besucher danach im Kundenportal, steht der geworbene Kunde am Referral — seine späteren Rechnungen tragen die Provision des Partners, so lange wie die Zuordnungsdauer des Programms läuft (ab der Zuordnung des Kunden; Vorgabe unbegrenzt). Bis wann das ist, zeigt der Reiter Referrals in der Spalte Zuordnung bis.
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. Ein Umsatz gehört genau einem Referral — ein zweiter Code auf dieselbe Rechnung (oder ihren Auftrag) wird abgewiesen. Haben mehrere Partner denselben Kunden geworben, entscheidet die Einstellung Erster Klick gewinnt: aus heißt der letzte Klick vor dem Kauf zählt.
Provisionsregeln pflegen. Im Partner-Detail, Reiter Regeln, bestimmen die Regeln, wie aus einem Umsatz eine Provision wird — prozentual (vom Netto oder Brutto) oder als fester Betrag, optional gedeckelt, für alle Umsätze oder nur den Erstauftrag eines Kunden. Der Geltungsbereich entscheidet, wofür eine Regel gilt: für einen Artikel, eine Kategorie (samt Unterkategorien) oder alle Umsätze des Partners. Artikel- und Kategorie-Regeln rechnen je Rechnungsposition: jede Position bekommt die spezifischste passende Regel — Artikel vor näherer Kategorie vor übergeordneter Kategorie vor der Partner-Regel; bei Gleichstand gewinnt die höhere Umsatz-Stufe, dann die höhere Priorität. Das Netto der Zuordnung wird dafür anteilig auf die Positionen verteilt; ein fester Betrag zählt je Regel einmal.
Umsatz-Stufen. Ab Partner-Umsatz macht aus einer Regel eine Stufe: sie greift erst, wenn der Partner im laufenden Kalenderjahr (oder -monat) mindestens diesen Umsatz vermittelt hat — der aktuelle Umsatz eingerechnet. Mehrere Stufen ergeben eine Staffel, etwa 5 % ab dem ersten Euro, 8 % ab 10.000 €; es gilt die höchste erreichte. Unabhängig davon wirkt die feste Stufe am Partner: eine Regel mit gesetzter Stufe greift nur für Partner mit genau dieser Stufe. Regeln können außerdem aus anderen Modulen stammen — die Provisions-Engine nimmt sie über eine Schnittstelle für Regelquellen auf und wählt nach denselben Regeln.
Programm-Übersicht. Oben in der Partnerliste zeigt die Programm-Übersicht für diesen Monat, den letzten Monat oder das Jahr den vermittelten Umsatz (netto), die Provisionen je Stand — offen, verdient, ausgezahlt — und die Top-Partner nach Umsatz. Dieselben Zahlen gibt es als Kachel Partnerprogramm für die Übersicht.
Abrechnen und auszahlen. Ein Abrechnungslauf fasst die offenen Provisionen eines Zeitraums zu einer Abrechnung zusammen. Die Abrechnung wird erst freigegeben und dann mit Auszahlen ausgezahlt — zwei Schritte, damit eine Auszahlung nie versehentlich passiert. Erst mit Auszahlen steht der Betrag fest; danach geht jede Position ihren Zahlweg, den der Lauf beim Bündeln aus dem Partner-Stamm festhält (Spalte Zahlweg im Lauf):
- SEPA-Zahllauf — Partner mit Auszahlungsweg SEPA und hinterlegter IBAN erscheinen im
Zahlungsvorschlag der Buchhaltung als Zeile Provision und gehen über denselben Zahllauf und dieselbe SEPA-Datei wie Ihre Lieferantenrechnungen. Wird der Zahllauf als ausgeführt vermerkt, steht an der Position „überwiesen am …". Ohne IBAN steht die Provision gesperrt im Vorschlag, statt still zu fehlen. Wer den Vorschlag sieht, braucht zusätzlich affiliate.settlement.run.
- PayPal-Datei — für Partner mit Auszahlungsweg PayPal lädt PayPal-Datei im ausgezahlten Lauf
eine Sammelzahlungs-Datei für PayPal Payouts herunter (Empfänger-Adresse, Betrag, Währung, Referenz, Hinweis; ohne Kopfzeile). Fehlt einem Partner die PayPal-Adresse, nennt die Meldung ihn.
- Lohn-Export — interne Partner mit verknüpftem Mitarbeiter bekommen ihre Provision als Lohnart
im Lohn-Export des Auszahlungsmonats (Lohnarten-CSV und DATEV LODAS, Einheit Euro). Für sie entsteht keine Gutschrift — Lohn ist keine Gutschrift. Freelancer gehören nicht in den Lohn-Export; ihre Provision folgt dem Auszahlungsweg.
- Manuell — ohne Auszahlungsweg bleibt die Auszahlungs-CSV des Laufs (eine Zeile je Partner,
mit Spalte Zahlweg).
Der Beleg hängt an der Auszahlungsart: Gutschrift und Gutschriftverfahren erzeugen je Position einen Gutschrift-Entwurf in der Faktura (beim Gutschriftverfahren als „Provisionsabrechnung im Gutschriftverfahren" bezeichnet), Partnerrechnung erzeugt keinen Beleg — der Partner stellt selbst. Zahlen Sie die Partnerrechnung nicht zusätzlich als Eingangsrechnung, wenn die Provision schon über den Zahlweg läuft.
Was der Partner im Kundenportal sieht. Hat der Partner einen Portal-Zugang, findet er dort unter Partnerprogramm seine offenen, freigegebenen und ausgezahlten Provisionen, seine Abrechnungen und seine Empfehlungen — ausschließlich die eigenen. Eine Abrechnung erscheint dort erst nach der Freigabe; Entwürfe bleiben intern (Kundenportal).
Storno, Teilgutschrift und Retoure. Wird die Rechnung ganz storniert, fällt ihre noch nicht ausgezahlte Provision auf storniert. Eine Teilgutschrift (Rechnungskorrektur) oder die Gutschrift einer Retoure kürzt die Provision anteilig: Gutschreiben Sie 25 % des Netto, entsteht eine Gegenbuchung über −25 % der Provision mit der Gutschrift-Nummer als Grund. Sie reift mit dem Original (offen, solange die Rechnung offen ist) und wird nach einer bereits erfolgten Auszahlung im nächsten Abrechnungslauf abgezogen. Ein Saldo von null oder darunter wird nie ausgezahlt, sondern vorgetragen; mehrere Gutschriften kürzen zusammen höchstens die ganze Provision.
Felder im Detail
Partner
| 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 — für Einordnung, Auswertung und Auszahlung (intern: über den Mitarbeiter). Welche Regel greift, entscheiden Geltungsbereich, Stufe und Priorität der Regeln. |
Stufe defaultTier | nein | Text, max. 30 Zeichen | Feste Provisionsstufe des Partners: Regeln mit derselben Stufe gelten nur für ihn und Partner gleicher Stufe. |
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 — und es wirkt: SEPA-Partner stehen im Zahllauf der Buchhaltung, PayPal-Partner in der PayPal-Datei. Leeren Sie das Feld, gilt manuell (Auszahlungs-CSV). |
IBAN payoutIban | bei SEPA | gültige IBAN | Konto für den SEPA-Zahllauf. Wird verschlüsselt gespeichert; im Detail sehen nur Verwalter sie ganz, sonst die letzten vier Stellen. Leer lassen behält die hinterlegte IBAN. |
BIC payoutBic | nein | 8 oder 11 Zeichen | Bankkennung; bei SEPA im Euroraum nicht nötig. |
Kontoinhaber payoutAccountHolder | nein | Text, max. 140 Zeichen | Nur, wenn das Konto nicht auf den Partnernamen läuft — er steht als Empfänger in der SEPA-Datei. |
PayPal-Adresse paypalEmail | bei PayPal | E-Mail-Adresse | Empfänger in der PayPal-Datei. |
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. |
Verknüpfter Mitarbeiter linkedEmployeeId | bei Art intern | Mitarbeiter | Bei Art intern der Mitarbeiter, dessen Vertriebsprovision das ist: sie läuft dann als Lohnart über den Lohn-Export statt über den Auszahlungsweg. Ein unbekannter Mitarbeiter wird abgewiesen. |
Provisionsregel
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Satz-Typ und Wert rateType, value | ja | Prozent oder Festbetrag | Wie viel Provision entsteht. Prozent wird auf das Netto bzw. Brutto der Zuordnung (oder der Position) gerechnet. |
Geltungsbereich scope | nein | Partner, Produkt, Kategorie | Wofür die Regel gilt. Produkt und Kategorie wirken je Rechnungsposition und brauchen ihren Bezug. |
Produkt/Kategorie refId | bei Produkt/Kategorie | Artikel bzw. Kategorie | Der Bezug der Regel; eine Kategorie schließt ihre Unterkategorien ein. |
Auslöser trigger | nein | Verkauf, Lead, wiederkehrend | Bei welchem Anlass die Regel gilt: Verkauf beim Erstverkauf, Lead je qualifiziertem Lead, wiederkehrend nur bei Abo-Folgezahlungen. |
Gilt für appliesTo | nein | alle Umsätze, nur Erstauftrag | Nur Erstauftrag ist die Neukunden-Provision. |
Basis basis | nein | Netto, Brutto | Worauf der Prozentsatz rechnet. |
Deckelung capAmount | nein | Betrag | Höchstbetrag je Regel und Umsatz. |
Ab Partner-Umsatz minRevenueAmount, revenuePeriod | nein | Betrag; Kalenderjahr oder -monat | Umsatz-Stufe: die Regel greift erst ab diesem vermittelten Umsatz im Zeitraum. |
Staffel (Tier) tier | nein | Text | Nur für Partner mit derselben festen Stufe. |
Priorität priority | nein | Zahl | Entscheidet bei sonst gleichem Rang. |
Gültig ab/bis validFrom, validTo | nein | Datum | Maßgeblich ist der Tag der Zuordnung. |
Auch auf Abo-Folgezahlungen recurring | nein | Ja/Nein | Eine Verkaufs-Regel zahlt dann zusätzlich auf jede bezahlte Abo-Folgerechnung des vermittelten Kunden — solange das Abo läuft. Beim Auslöser wiederkehrend ist der Schalter immer an, bei Lead gibt es ihn nicht. Passen auf eine Folgezahlung mehrere Regeln, gewinnt wie immer die spezifischste, dann die höhere Priorität. Nur Erstauftrag gilt nur dem Erstverkauf, nicht den Folgezahlungen. |
Aktiv active | nein | Ja/Nein | Eine inaktive Regel bleibt gespeichert, greift aber bei keiner neuen Zuordnung. |
Abrechnungslauf
| Feld | Pflicht | Werte / Format | Was es bewirkt |
|---|---|---|---|
Periode von periodFrom | ja | Datum (JJJJ-MM-TT) | Erster Tag des Zeitraums, dessen offene Provisionen der Lauf bündelt. |
Periode bis periodTo | ja | Datum (JJJJ-MM-TT), nicht vor Periode von | Letzter Tag des Zeitraums (einschließlich). Liegt er vor dem Beginn, wird der Lauf abgewiesen. |
Einstellungen & Rechte
- Lesen und Programm-Übersicht:
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.
Unter Affiliate & Provision → Referral-Programm legen Sie fest, ob der erste oder der letzte Klick gewinnt, wohin Referral-Links führen (leer = Startseite) und wie lange der Browser den Partner nach dem Klick merkt — das Attributionsfenster (affiliate.cookie_days, 1–730 Tage, Vorgabe 90). Ein früheres Ende am einzelnen Referral gewinnt.
Ebenfalls dort: die Zuordnungsdauer geworbener Kunden (affiliate.attribution_days, 0–3650 Tage, Vorgabe 0 = unbegrenzt). Sie zählt ab der Zuordnung des Kunden zum Referral; danach bringen seine Folgeumsätze dem Partner keine Provision mehr. So stellen Sie Programme wie „12 Monate Provision auf jeden geworbenen Kunden" ein, ohne an jedem Referral ein Ablaufdatum zu pflegen. Und die Lohnart der internen Provision (affiliate.payroll_wage_type, Vorgabe 300) — die Nummer, unter der interne Vertriebsprovision im Lohn-Export steht; stimmen Sie sie mit Ihrem Lohnbüro ab.
Die Programm-Einstellungen verlangen platform.settings.manage.
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 Zuordnung wird mit „schon über einen anderen Referral-Code zugeordnet" abgewiesen. Der Umsatz gehört bereits einem anderen Partner. Provision gibt es je Umsatz nur einmal — ist die erste Zuordnung falsch, korrigieren Sie sie dort.
Die Provision weicht von der Erwartung ab. Prüfen Sie, welche Regel gegriffen hat: Geltungsbereich (Artikel, Kategorie, Partner), erreichte Umsatz-Stufe und der Zeitpunkt der Zuordnung entscheiden, nicht der heutige Regelstand.
Eine SEPA-Provision fehlt im Zahlungsvorschlag. Der Abrechnungslauf muss ausgezahlt sein, der Partner braucht eine IBAN (sonst steht die Zeile unter den gesperrten), und Sie brauchen neben dem Zahllauf-Recht affiliate.settlement.run. Steht die Provision schon in einem offenen Zahllauf, wird sie nicht ein zweites Mal vorgeschlagen.
Die PayPal-Datei meldet eine fehlende Adresse. Tragen Sie die PayPal-Adresse im Partner-Detail nach und laden Sie die Datei erneut.
Eine Abrechnung lässt sich nicht mehr ändern. Nach der Freigabe ist sie fest — das ist gewollt. Korrekturen laufen über eine neue Abrechnung.