Skip to main content

Welcome to our Dev Docs!

Component subscriptions

The lifetime of booked Components is handled separately from the Contract's phases in Component Subscriptions. Each object represents the subscription to a specific component. It holds data like component reference, contract reference, quantity, start date and an optional end date.

While Components and Discounts are the definition of products and possible conditions in the Product catalogue, Component subscriptions and Discount subscriptions represent the use of these within a Contract.


The Component subscription assigns a Component, and the Discount subscription assigns a Discount for a certain period of time to a Contract.

This has a significance for an Order.

If you want to add a Component to a Contract, the ComponentId is listed in the Order's cart. Billwerk+ uses this to create a new Component subscription for the Contract. If you want to end this subscription later on, you do not need the ComponentId, but you will need the unique Id associated with this Component subscription.