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.
When do I need this function?
Section titled “When do I need this function?”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.
Requirements
Section titled “Requirements”- You need access to the product administration area.
- A product with associated prices must already have been created.
Step-by-step instructions
Section titled “Step-by-step instructions”1. Call up the price list in the portal
Section titled “1. Call up the price list in the portal”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:
- Navigate to Products in the main menu and select a product from the list.
- 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.
3. View details of a specific version
Section titled “3. View details of a specific version”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.
Result
Section titled “Result”You see the price list versions of the product and can see which prices are current, past or planned.
Notes and typical errors
Section titled “Notes and typical errors”- 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.
API Notes
Section titled “API Notes”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 point | Method | Description | OperationId |
|---|---|---|---|
/v1/product/pricelist | GET | Search price lists | searchProductPricelist |
/v1/product/pricelist | POST | Create price list | createProductPricelist |
/v1/product/pricelist/{uuid} | GET | Get price list | getProductPricelist |
/v1/product/pricelist/{uuid} | PATCH | Update price list | updateProductPricelist |
Related topics
Section titled “Related topics”- Edit subscription product (price changes)
- Create subscription option
- Configure discounts