Skip to content

Define prices and manage price lists

In the tebio Business portal, prices are directly linked to products or options. There is therefore no separate area in which you can create prices separately. Instead, prices are defined in the creation or editing process of products and options and bundled and versioned by tebio in price lists.

Use the price list view if you:

  • You would like to check which specific prices currently apply to new bookings of a product.
  • Want to understand the history of past or planned price adjustments.
  • Want to check the breakdown of net and gross amounts (including taxes) per product or option.
  • You need access to the product administration area.
  • A product with associated prices must already have been created.

All defined prices (for the main product and all associated options) are automatically bundled by the system in a price list.

You can view the current as well as all past, current and planned price lists in the detailed view of a product:

  1. Navigate to Products in the main menu and select a product from the list.
  2. In the detailed view, switch to the Price list tab.

2. Understand the overview of price list versions

Section titled “2. Understand the overview of price list versions”

In the tabular overview you can see all price list versions. The following is documented for each version:

  • Valid from / Valid until: The period in which these prices were or will be used for new bookings.
  • Version: A consecutive numbering (e.g. 1, 2, 3…) that is automatically incremented with every price change.
  • Created / Last modified: Timestamp for tracking.

By clicking on the arrow at the end of a line, you can open the detailed information for a specific price list version.

In this detailed view you can see, among other things:

  • Whether the prices are shown including or excluding taxes.
  • Which tax category (e.g. reduced rate) applies to this list.
  • An accurate breakdown of pricing by entity (product and option).
  • The exact amounts for recurring fee, setup and cancellation, each supplemented by the stated tax portion.

You see the price list versions of the product and can see which prices are current, past or planned.

  • No separate price creation in the portal: If you want to create a price in the portal independently of a product, there is no separate menu item available for this. In the user interface, prices arise primarily for Creating products or Options. (Note: Separate management of price lists is possible via the API).
  • Price changes: If you want to adjust existing prices, do not change them in the price list itself, but rather via the Edit subscription product function. There you can either make price changes effective immediately or schedule them for a future date. The system then creates a new version of the price list.

You have your own API endpoints available for managing price lists. You can use this to search, retrieve, create or update price lists independently of the product object:

End pointMethodDescriptionOperationId
/v1/product/pricelistGETSearch price listssearchProductPricelist
/v1/product/pricelistPOSTCreate price listcreateProductPricelist
/v1/product/pricelist/{uuid}GETGet price listgetProductPricelist
/v1/product/pricelist/{uuid}PATCHUpdate price listupdateProductPricelist