PPartnerDesk

20 — Partner anlegen

Aktualisiert am 1. Juni 2026

20 — Partner anlegen

PartnerDesk kennt vier Wege, einen neuen Partner ins System zu bringen — je nach Use-Case nutzen Sie den passenden.

Übersicht

Weg Wann sinnvoll Wer löst es aus
A) Admin legt manuell an Einzelner Partner mit individuellen Daten Tenant-Admin
B) Self-Registration Open-Door: Partner registriert sich selbst Partner
C) Invite-Flow Sie kontaktieren einen Wunsch-Partner Tenant-Admin sendet Link, Partner aktiviert
D) CLI / Import Massendaten (Migration, PAP-Import) Plattform-Admin

A) Admin legt manuell an

Admin-Portal → „Partner" → „Neu anlegen".

Pflichtfelder

  • Email
  • Vorname, Nachname
  • Status (pending oder direkt active)

Optionale Felder

  • Telefon
  • Anschrift (Straße, PLZ, Ort, Land)
  • USt-ID / Steuernummer
  • Bankverbindung (IBAN, BIC, Kontoinhaber) — falls Banküberweisung
  • PayPal-Adresse — falls PayPal-Auszahlung
  • Sponsor (Referrer) für MLM
  • CommissionGroup (falls Sie das Gruppen-Modell nutzen)
  • min_payout_amount — Override des Tenant-Defaults
  • Notification-Email (separate Mail-Adresse für Notifications)

Nach Anlage: System sendet automatisch eine Welcome-Mail mit Login-Link.

B) Self-Registration

Partner ruft <slug>.partnerdesk.io/register auf und füllt das Formular aus:

  1. Email + gewünschtes Passwort.
  2. Vor- und Nachname, optional Telefon.
  3. Klick auf „Registrieren".
  4. System sendet Email mit Aktivierungs-Link.
  5. Partner klickt Link → Status wechselt auf active, Auto-Login zum Dashboard.

Selbst-Registration kann mit Sponsor-Empfehlung kombiniert werden:

<slug>.partnerdesk.io/register?ref=<sponsor-partner-id>

Beim Submit wird der Sponsor automatisch verknüpft (siehe 12 — MLM-Struktur und 63 — Lead-Affiliate-Programm).

Bei deaktiviertem Self-Registration

In den Tenant-Settings können Sie Self-Registration ausschalten. In dem Fall liefert die Register-Seite einen Hinweis: „Bitte kontaktieren Sie uns für eine Einladung."

C) Invite-Flow

Admin-Portal → „Partner" → „Neu einladen".

  1. Email des einzuladenden Partners eingeben.
  2. Optional: Sponsor und CommissionGroup vorab zuweisen.
  3. System generiert einen einmaligen Invite-Token und sendet eine Einladungsmail.
  4. Partner klickt den Link in der Mail.
  5. Partner setzt Passwort + ergänzt Stammdaten.
  6. Status wechselt auf active.

Re-Send

Wenn der Partner die Mail verloren hat: Admin → Partner-Detail → „Einladung erneut senden". Neuer Token, alter wird invalidiert.

D) CLI / Import

Für große Datenmengen (Migration aus PAP, CSV-Import, etc.):

Einzelne Anlage

app:tenant:create <tenant-slug> "<name>" --with-partner=P-DEMO

Bulk-Import

Plattform-Admin nutzt:

  • app:pap:import — vollständiger Import aus Post Affiliate Pro.
  • app:import:provider — Import aus Provider-CSV (Stripe, Digistore24, Ablefy, CopeCart, easybill).

Beide Befehle sind idempotent — mehrfaches Ausführen erzeugt keine Duplikate.

Details: …/076-pap-import-commission-groups.md.

Partner-IDs

Jeder Partner bekommt eine Partner-ID (partnerId), die eindeutig pro Tenant ist. Standard-Format ist eine kurze alphanumerische Zeichenkette (z. B. P-A3F9). Diese ID wird in Tracking-Links, Webhook-Bodies und CSV-Importen verwendet.

Sie können die Generierung in den Tenant-Settings anpassen (Prefix, Länge).

Bei Webhook-Sales ohne bestehenden Partner

Wenn ein Webhook eine Partner-ID liefert, die noch nicht existiert:

  • Standardmäßig: TX landet auf STATUS_UNASSIGNED. Admin muss manuell zuordnen.
  • Optional via Konfiguration: Auto-Anlage eines Lead-Partners (STATUS_LEAD). Wenn der Partner später aktiviert wird, bleiben die TX-Verknüpfungen erhalten.

Doppelte Email

Pro Tenant ist die Email eindeutig. Versuche, einen zweiten Partner mit gleicher Email anzulegen, werden abgewiesen.

Aber: derselbe Mensch kann in mehreren Tenants verschiedene Partner-Accounts haben — pro Tenant getrennt.

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md (Partner-Entity), ../073-self-registration-invite.md, ../062-tenant-create-cli.md