Zum Inhalt springen

Preise definieren und Preislisten verwalten

Im tebio Business-Portal sind Preise im tebio Business-Portal direkt an Produkte oder Optionen gekoppelt. Es gibt daher keinen separaten Bereich, in dem Sie Preise separat anlegen. Stattdessen werden Preise im Erstellungs- oder Bearbeitungsprozess von Produkten und Optionen definiert und von tebio in Preislisten gebündelt und versioniert.

Nutzen Sie die Ansicht der Preislisten, wenn Sie:

  • Überprüfen möchten, welche konkreten Preise aktuell für neue Buchungen eines Produkts gelten.
  • Die Historie von vergangenen oder geplanten Preisanpassungen nachvollziehen wollen.
  • Die Aufschlüsselung von Netto- und Bruttobeträgen (inklusive Steuern) pro Produkt oder Option prüfen möchten.
  • Sie benötigen Zugriff auf den Administrationsbereich für Produkte.
  • Es muss bereits ein Produkt mit zugehörigen Preisen erstellt worden sein.

Alle definierten Preise (für das Hauptprodukt sowie alle dazugehörigen Optionen) werden vom System automatisch in einer Preisliste gebündelt.

Sie können die aktuelle sowie alle vergangene, aktuelle und geplante Preislisten in der Detailansicht eines Produkts einsehen:

  1. Navigieren Sie im Hauptmenü zu Produkte und wählen Sie ein Produkt aus der Liste aus.
  2. Wechseln Sie in der Detailansicht auf den Reiter Preisliste.

Preislisten zum Abo-Produkt

In der tabellarischen Übersicht sehen Sie alle Preislistenversionen. Für jede Version wird folgendes dokumentiert:

  • Gültig von / Gültig bis: Der Zeitraum, in dem diese Preise für neue Buchungen verwendet wurden bzw. werden.
  • Version: Eine fortlaufende Nummerierung (z.B. 1, 2, 3…), die bei jeder Preisänderung automatisch hochgezählt wird.
  • Erstellt / Letzte Änderung: Zeitstempel zur Nachverfolgung.

Durch einen Klick auf den Pfeil am Ende einer Zeile klappen Sie die detaillierten Informationen einer bestimmten Preislistenversion auf.

Detailansicht einer Preisliste

In dieser Detailansicht sehen Sie unter anderem:

  • Ob die Preise inklusive oder exklusive Steuern dargestellt sind.
  • Welche Steuerkategorie (z.B. Ermäßigter Satz) für diese Liste gilt.
  • Eine genaue Aufschlüsselung der Preise nach Entität (Produkt und Option).
  • Die exakten Beträge für wiederkehrende Gebühr, Einrichtung und Kündigung, jeweils ergänzt um den ausgewiesenen Steueranteil.

Sie sehen die Preislistenversionen des Produkts und können nachvollziehen, welche Preise aktuell, vergangen oder geplant sind.

  • Keine separate Preiserstellung im Portal: Wenn Sie im Portal einen Preis unabhängig von einem Produkt anlegen möchten, steht dafür kein eigener Menüpunkt zur Verfügung. In der Benutzeroberfläche entstehen Preise primär beim Erstellen von Produkten oder Optionen. (Hinweis: Über die API ist eine separate Verwaltung von Preislisten jedoch möglich).
  • Preisänderungen: Wenn Sie bestehende Preise anpassen möchten, ändern Sie diese nicht in der Preisliste selbst, sondern über die Funktion Abo-Produkt bearbeiten. Dort können Sie Preisänderungen entweder sofort gültig machen oder für ein Datum in der Zukunft terminieren. Das System erstellt daraufhin eine neue Version der Preisliste.

Für die Verwaltung von Preislisten stehen Ihnen eigene API-Endpunkte zur Verfügung. Über diese können Sie Preislisten unabhängig vom Produkt-Objekt suchen, abrufen, anlegen oder aktualisieren:

EndpunktMethodeBeschreibungOperationId
/v1/product/pricelistGETPreislisten suchensearchProductPricelist
/v1/product/pricelistPOSTPreisliste erstellencreateProductPricelist
/v1/product/pricelist/{uuid}GETPreisliste abrufengetProductPricelist
/v1/product/pricelist/{uuid}PATCHPreisliste aktualisierenupdateProductPricelist