Zum Hauptinhalt springen
Mit der Provisionen API modellierst du, wie deine Vertriebsmitarbeiter an Rechnungen verdienen. Ein Provisionsplan legt den Provisionssatz fest, auf welche Rechnungen er wirkt und ab wann ausgezahlt wird.
Provisionspläne verwaltest du auch in der App unter Provisionen. Die vollständige Anleitung für den Alltag findest du im Benutzer-Guide unter Provisionspläne und Auszahlungen.

Was ein Plan steuert

Provisionssatz

Ein Basissatz in Prozent, optional pro Produkt überschrieben.

Auslöser und Geltungsbereich

Ob bei Rechnungsstellung oder Zahlungseingang provisioniert wird, und für welche Rechnungen.

Mindestauszahlung

Eine Provisionssumme, ab der ein Vertriebsmitarbeiter im Monat ausgezahlt wird.

Mindestumsatz

Ein Monatsumsatz, ab dem die Provisionen des Monats überhaupt laufen.

Authentifizierung

Alle Endpunkte erwarten einen Bearer-Token deiner Organisation, der die Berechtigung für Provisionspläne trägt: Lesen für GET, Schreiben für POST, PUT und DELETE. Sende ihn im Authorization-Header:
Authorization: Bearer <token>
Die Provisionen API ist als Beta gekennzeichnet und kann sich noch ändern. Verankere deine Integration gegen die datierte Version und beobachte das Changelog.
Weiter geht es mit den Kernkonzepten: die Felder eines Plans und die beiden monatlichen Auszahlungsschwellen.