Auf dieser Seite
Was ist ein Affiliate?
Affiliates sind Vermittler, die Kunden auf NODIKA bringen — z. B. über eigene Websites, Werbung oder bestehende Kundenbeziehungen. Sie erhalten für jeden über ihren Ref-Link abgeschlossenen Auftrag eine Provision aus NODIKAs Anteil.
Zugang & Login
Seite: /affiliate/login
- E-Mail + Passwort (vom NODIKA-Admin angelegt)
- Kein Self-Service-Registrierungsflow (aktuell)
Affiliate-Dashboard
Seite: /affiliate/dashboard oder /affiliate/info
KPI-Übersicht
| Kennzahl | Beschreibung |
|---|---|
| Aufträge gesamt | Alle über Affiliate-Links erzeugten Aufträge |
| Abgeschlossene Aufträge | COMPLETED — Basis für Provisionsberechnung |
| Provision gesamt (netto) | Summe aller affiliateCommissionNet in € |
| Provision (brutto) | Inkl. MwSt. |
| Offene Provision | Noch nicht ausgezahlte Provision |
| Ausgezahlte Provision | Bereits überwiesene Beträge |
Ref-Links verwalten
Pro Affiliate können mehrere Ref-Links mit unterschiedlichen Typen existieren:
- Button: + Neuer Link
- Pro Link: URL anzeigen, Kopieren, Deaktivieren
- URL-Schema:
https://nodika.de/?ref={code}<={A|B|C} - Auftragszähler pro Link:
X Aufträge
Provisionsmodell
Die Provision wird für jeden abgeschlossenen (COMPLETED) Auftrag berechnet, der über einen Affiliate-Ref-Link erstellt wurde:
| Feld | Beschreibung |
|---|---|
affiliateCommissionRate | Provisionssatz in % (z. B. 10%) — individuell pro Affiliate konfiguriert |
affiliateCommissionNet | Netto-Provision in € (= totalPrice × Rate / 100) |
affiliateCommissionVat | MwSt. auf die Provision |
affiliateShare | Brutto-Provision (Net + VAT) |
affiliateCommissionRecipientId | Partner-ID des Provision-Empfängers |
partnerShare = totalPrice − nodikaShare. Die Provision ist kein Abzug vom Partner-Anteil.
Beispielrechnung
| Posten | Betrag |
|---|---|
| Gesamtpreis (Kunde zahlt) | 100,00 € |
| NODIKA-Gebühr (20%) | 20,00 € |
| Partner-Anteil (80%) | 80,00 € |
| Affiliate-Provision (10% aus NODIKA-Anteil) | 10,00 € |
| NODIKA verbleibt | 10,00 € |
Wie ein Auftrag über Ref-Link läuft
URL enthält ?ref={code}<={A|B|C}. Das Frontend speichert Code + Typ im SessionStorage.
Beim Erstellen des Auftrags schickt das Frontend affiliateLinkCode im Request-Body mit.
Der Backend-Controller löst den Code auf, trägt affiliateLinkId in die Order ein und bestimmt das Routing (welcher Monteur-Pool).
Bei COMPLETED: Billing-Service berechnet affiliateCommissionNet und affiliateShare, bucht es in der Ledger-Tabelle.
Affiliate sieht die Provision im Dashboard und in der Buchungshistorie.
Auszahlungen
- Auszahlungen werden manuell durch NODIKA verarbeitet
- Affiliate kann eine Auszahlung beantragen (Betrag + bevorzugter Rhythmus)
- Status: Ausstehend → Ausgezahlt
- Zahlungsreferenz wird nach Überweisung eingetragen
Link-Typen im Detail
| Typ | Code (lt=) | Routing | Wann sinnvoll |
|---|---|---|---|
| Option A – Exklusiv | lt=A |
Nur Monteure des verlinkenden Partners | Partner verlinkt auf eigene Leistung — Provision + Flat-Fee |
| Option B – Hybrid | lt=B |
Eigene Monteure zuerst; Fallback auf alle wenn keiner verfügbar | Partner will eigene bevorzugen, aber keine Kunden verlieren |
| Option C – Marktplatz | lt=C |
Alle verfügbaren NODIKA-Monteure, sortiert nach Distanz | Reiner Vermittler ohne eigene Monteure |
Screenshots
