PPartnerDesk

22 — Partner-Profile & Stammdaten

Aktualisiert am 1. Juni 2026

22 — Partner-Profile & Stammdaten

Jeder Partner hat einen Satz Stammdaten, die für Provisionsberechnung, Auszahlung, Kommunikation und Compliance relevant sind. Dieses Kapitel beschreibt alle Felder und wer sie wo bearbeitet.

Pflichtfelder

Feld Wozu
Vorname, Nachname Anrede, Gutschrift-Empfänger
Email Login + Kommunikation
Partner-ID Eindeutiger Identifier — in Tracking-Links, Webhooks, CSV-Importen
Status Lifecycle-Position (siehe 21)

Optional, aber empfohlen

Feld Wozu
Telefon Direkte Erreichbarkeit
Anschrift (Straße, PLZ, Ort, Land) Pflicht für Gutschrift §14 UStG sobald Auszahlung läuft
USt-ID oder Steuernummer Für die Gutschrift, korrekte MwSt-Behandlung
vat_rate 19 (Standard) oder 0 (Kleinunternehmer § 19 UStG)
partnerType affiliate, joint_venture, sales_employee (für Reporting)
commissionGroup Tier-Klasse (siehe 11)
min_payout_amount Persönlicher Mindestbetrag (überschreibt Tenant-Default)
language DE/EN für Emails und UI
notification_email Separate Adresse für System-Mails (z. B. wenn email privat, Notifications an die Firma sollen)

Auszahlungs-Präferenzen

Partner wählt zwischen:

  • Banküberweisung — IBAN, BIC, Kontoinhaber. Wird im SEPA-XML genutzt.
  • PayPal — Email-Adresse.
  • Stripe Connect — automatische Auszahlung über verbundenes Stripe-Connect-Konto (siehe 43).

Marketing-Felder

Optional für eigene Vermarktung:

  • landing_slug — URL-freundlicher Identifier für die persönliche Landing-Page (siehe 54).
  • landing_page (JSON) — Headline, Subline, Hero-Image, CTA, Custom-HTML, Accent-Color.
  • profile_photo_url — Profilbild.
  • website_url — Eigene Webseite.

DSGVO-Audit-Felder

Werden automatisch beim Self-Signup oder Invite-Annahme gesetzt:

  • terms_accepted_at — Wann hat der Partner zugestimmt.
  • terms_accepted_ip — Von welcher IP.
  • terms_accepted_version — Version der AGB, die zum Zeitpunkt galt.

Externe IDs

additionalExternalIds (JSON-Array) — pro Provider eine externe ID. Z. B.:

  • PAP-Legacy-ID (für Importe aus dem Vorgänger-System).
  • Stripe-Customer-ID.
  • ERP-Nummer.

Wird für Cross-System-Lookups verwendet (z. B. „Suche Partner mit Stripe-Customer-ID cus_xyz").

Wer bearbeitet was?

Tenant-Admin

Kann alle Felder bearbeiten.

Partner (Self-Service)

Kann bearbeiten:

  • Eigenen Vor-/Nachname, Telefon.
  • Anschrift, USt-ID/Steuernummer.
  • Auszahlungs-Präferenzen + Bankdaten.
  • Landing-Page.
  • Sprache + Notification-Email.
  • Passwort + 2FA.

Kann nicht bearbeiten (Admin-only):

  • Partner-ID.
  • Status.
  • Sponsor.
  • CommissionGroup.
  • vat_rate.
  • partnerType.

Self-Registration

Bei Self-Signup setzt der Partner initial nur: Email, Vor-/Nachname, Telefon (optional), Passwort. Restliche Felder ergänzt er später im Profil — oder Admin füllt sie nach.

Partner-ID-Generierung

Konfigurierbar pro Tenant (siehe …/145-partner-id-generator.md):

Modus Beispiel
numeric P-00001, P-00002, …
random P-A3F9 (alphanumerisch, keine 0/O/1/I/L)
self_chosen Partner darf eigene ID vorschlagen (z. B. MUSTERMANN)

Verwandte Kapitel

Technische Tiefen-Doku: ../001-initial-setup.md, ../076-pap-import-commission-groups.md (erweiterte Felder), ../145-partner-id-generator.md