Skip to main content
Ein Plan besteht aus einer geordneten Liste von Tarifstufen, und jede Tarifstufe enthält eine oder mehrere Positionen. Diese Seite erklärt die Felder, die du beim Anlegen setzt, und die Regeln dahinter. Im Wallet verwaltest du Pläne unter Pläne. So sieht die Übersicht aus:
Übersicht der Pläne mit Status und Anzahl der Tarifstufen

Plan-Übersicht im Wallet.

Und so legst du einen Plan mit seinen Tarifstufen an:
Formular zum Anlegen eines Plans mit Tarifstufen und Positionen

Plan anlegen im Wallet.

​
Plan

​
Status-Lebenszyklus

Ein Plan startet immer als draft. Mit der Aktivierung wird er active. Beim Löschen wird er hart gelöscht, falls er nirgends referenziert ist, sonst archiviert.
Damit du einen Plan aktivieren kannst, muss er mindestens eine Tarifstufe haben, und jede Tarifstufe muss mindestens eine Position enthalten.

​
Tarifstufe

Eine Tarifstufe ist eine Stufe innerhalb des Plans.
Die Felder upgradeable und downgradeable beschreiben, ob eine Tarifstufe verlassen werden darf, nicht ob sie betreten werden darf. So kannst du gezielte Sperren zwischen Tarifstufen einbauen, etwa eine Testphase, die nur nach oben verlassen werden kann.
changeTiming und creditType der Zielstufe bestimmen gemeinsam die anteilige Berechnung. Details dazu findest du unter Up- und Downgrades.

​
Position

Eine Position verbindet ein Produkt mit einem Preisplan innerhalb einer Tarifstufe.
Alle Preispläne innerhalb eines Plans müssen dieselbe Währung verwenden. Bei nutzungsbasierten Produkten ist die Menge nicht editierbar, da sie aus den Nutzungsdaten entsteht.

​
Editierbare Mengen

Ob ein Kunde die Menge einer Position anpassen darf, leitet die API automatisch ab. Eine Menge ist nicht editierbar, wenn
  • das Produkt nutzungsbasiert ist (die Menge kommt aus Nutzungsereignissen), oder
  • minQuantity, defaultQuantity und maxQuantity gleich sind (es gibt nur einen gültigen Wert).
In allen anderen Fällen ist die Menge editierbar. In der Antwort des Kundenbereichs erkennst du das am Feld quantityEditable.