Skip to content

Book/change option

During the term of a subscription, it often happens that customers want to adjust their additional services. Unlike a product change (where the core product is swapped), the main product of the subscription remains unchanged. Instead, only options (e.g. a service level upgrade, additional hardware or expanded cloud storage quotas) are flexibly modified.

Use this process if a customer wants to add additional services to their existing subscription or wants to switch from one existing version to another (e.g. switching from a single license to a family license).

  • The customer must have an active subscription.
  • Administrative option groups must be configured on the underlying product.

Whether you can add an option or have to change options depends on the administrative configuration of the product. The portal differentiates between the types of option groups:

  • XOR / limited OR groups: Within this group, the customer may have a maximum of one (or a fixed number) of options active at the same time. If he wants to use a new option, the system must deactivate an existing option. In this case, use the switching process (path A).
  • AND / any number of options: There is no limit in this group. The customer can have any number of additional options at the same time. In this case, use the direct booking process (way B).

Start the subscription from the customer view:

  1. Open the customer view. The Subscriptions tab is already open by default.
  2. Click on the subscription you want.
  3. Click on the Manage subscription button.

You will now see all the available option groups below the main product.

If the option belongs to a limited group, you must execute the change dialog to exchange an active variant for the new variant:

  1. Navigate to the new option you want the customer to receive.
  2. Click on the three-dot menu on the right.
  3. Select the entry “Switch to this option”.
  1. The change dialog opens. tebio points out that the previous service will be deactivated as part of the change.
  2. Under When would you like to switch to this option?, select whether the switch should be carried out Immediately or at a different desired date (On a specific date).

If you select “On a specific date”, a calendar field opens in which you can define the exact date.

Confirm the change with Yes, switch & pay.

If the option belongs to a free group (without limits), the process is simpler:

  1. Select the desired option directly using the icon in front of it (radio button or checkbox).
  1. The order overview is displayed on the right. Here you can see the price of the new option.
  2. Check the selected payment method.
  3. If desired, you can also assign a desired date here using the checkbox.

Confirm the change with Change subscription.

tebio processes the change commercially. The newly booked option or the option change is visible immediately or on the selected deadline.

[!TIP] Commercial calculation and proration Billing takes place automatically based on the product configuration. If you select the deadline “Immediately” when changing an option or making an additional booking, tebio will usually carry out a pro-rata billing for the exact day (pro rata calculation) until the end of the current billing period. However, if you select a key date (e.g. for the next contract extension), the calculation will be carried out as usual for the next regular period.

For implementation in headless scenarios or your own self-care portals, use the following REST endpoints of the tebio API:

End pointMethodDescriptionOperationId
/v1/subscription/{uuid}/optionPOSTBook optioncreateSubscriptionOption
/v1/subscription/{uuid}/optionPATCHSwitch optionupdateSubscriptionOption

(Note: Depending on the technical configuration, a change can also be implemented by deselecting and selecting the corresponding IDs.)

The exact payload structures can be found in the general table in article Edit subscription.