Vertriebspartner bearbeiten

Nachdem ein Vertriebspartner im System angelegt wurde, können Sie dessen Detailansicht aufrufen. Von hier aus lassen sich nicht nur die Stammdaten aktualisieren, sondern auch zugehörige Informationen wie Zahlungsvereinbarungen, Adressen, Benutzer und zugehörige Untervertriebspartner verwalten.

Wann brauche ich diese Funktion?

Nutzen Sie diese Funktion, wenn:

sich die vertraglichen oder steuerlichen Rahmenbedingungen (z. B. USt.-ID, Rechtsform) des Partners geändert haben.
der Vertriebspartner einer anderen Vertriebsregion oder einem neuen Account Manager zugewiesen werden soll.
Sie Adressdaten (Rechnungs- oder Lieferadresse) pflegen müssen.
Sie dem Partner neue Untervertriebspartner (UVPs) zuweisen oder seine Provisionsabrechnungen einsehen wollen.

Voraussetzungen

Sie benötigen administrative Rechte zur Bearbeitung von Vertriebspartnern.
Um den Status eines Partners ändern zu können, dürfen keine blockierende Abhängigkeiten (wie unbezahlte Rechnungen) im System existieren.

Schritt-für-Schritt-Anleitung

1. Detailansicht öffnen

Suchen Sie den gewünschten Vertriebspartner in der Vertriebspartner-Suche und klicken Sie auf den entsprechenden Listeneintrag, um die Detailansicht zu öffnen.

2. Stammdaten bearbeiten

Auf der linken Seite sehen Sie die Zusammenfassung des Vertriebspartners.

Klicken Sie auf den Button Vertriebspartner bearbeiten.
Es öffnet sich ein Dialog, in dem Sie folgende Felder anpassen können:
- Status: Wechseln Sie den Status (z. B. auf Aktiv, falls der Partner aus der Validierung kommt, oder Gesperrt).
- Account Manager, Kanal, Region und Sprache: Organisatorische Zuordnungen.
- Steuerliche Daten: USt.-ID, Steuernummer, Rechtsform und Handelsregisternummer.
- Externe Referenz: Ihre interne ID aus Drittsystemen.
Speichern Sie Ihre Änderungen.

(Hinweis: Den Admin-Benutzer des Partners können Sie separat über den Button Benutzer bearbeiten anpassen).

3. Reiter verwalten

Auf der rechten Seite finden Sie verschiedene Reiter, über die Sie die verknüpften Datensätze des Partners verwalten:

Adressen: Hier sehen Sie alle hinterlegten Adressen (z. B. Rechnungs- und Lieferadresse). Klicken Sie jeweils auf Bearbeiten, um die Anschrift zu korrigieren.
Untervertriebspartner (UVP): Hier sehen Sie eine Liste aller zugeordneten Untervertriebspartner. Über die Buttons UVP erstellen können Sie direkt einen neuen Untervertriebspartner für diesen Vertriebspartner anlegen. Mit Beziehung hinzufügen können Sie einen bereits existierenden Partner als Untervertriebspartner mit diesem Partner verknüpfen.
Rechnungen: Dieser Reiter listet alle Provisionsabrechnungen oder Service-Rechnungen auf, die für oder von diesem Partner generiert wurden. Sie sehen hier auf einen Blick den Status, den Betrag und das Fälligkeitsdatum.
Zahlungsvereinbarungen: Hier werden die hinterlegten Zahlungsmittel (z. B. PayPal, Kreditkarte) verwaltet, über die gegebenenfalls Abrechnungen laufen.

Ergebnis

Die Änderungen an Stammdaten oder verknüpften Elementen werden nach dem Speichern übernommen und – sofern konfiguriert – über entsprechende Webhooks (z. B. salespartner.updated) an Ihre Drittsysteme gemeldet.

Hinweise und typische Fehler

Pflichtfelder beim Statuswechsel: Beachten Sie, dass für eine Aktivierung (Status Aktiv) in der Regel bestimmte Felder (wie USt.-ID oder eine gültige Adresse) ausgefüllt sein müssen. Fehlen diese, gibt tebio einen Validierungsfehler zurück.
Benutzerkonto und Vertriebspartner unterscheiden: Achten Sie darauf, dass Stammdaten des Vertriebspartnerunternehmens (wie die USt.-ID) über “Vertriebspartner bearbeiten” geändert werden, während persönliche Daten des Benutzerkontos (wie die E-Mail-Adresse) über “Benutzer bearbeiten” gepflegt werden müssen.

API-Hinweise

Die in diesem Artikel beschriebenen Funktionen können über folgende API-Endpunkte automatisiert werden:

Endpunkt	Methode	Beschreibung	OperationId
`/v1/salespartner/-uuid-`	PATCH	Vertriebspartner aktualisieren	updateSalespartner