Documentation
Product Version
States
  • Pending
    The version is pending and can be changed.
  • Active
    The product version is active.
  • Obsolete
    The version is obsolete. It cannot be subscribed any more.
  • Retiring
    The version is retiring; it cannot be subscribed and existing customers must migrate away from it.
  • Retired
    The version is retired and it has no existing subscriptions.
Properties
  • Activated On
  • Billing Cycle
    The billing cycle determines the rhythm with which the subscriber is billed. The charging may have different rhythm.
  • Comment
    The comment allows to provide a internal comment for the version. It helps to document why a product was changed. The comment is not disclosed to the subscriber.
  • Created On
  • Default Currency
    The default currency has to be used in all fees.
  • Enabled Currencies
    The currencies which are enabled can be selected to define component fees. Currencies which are not enabled cannot be used to define fees.
  • ID
    A unique identifier for the object.
  • Increment Number
    The increment number represents the version number incremented whenever a new version is activated.
  • Linked Space ID
    The ID of the space this object belongs to.
  • Minimal Number Of Periods
    The minimal number of periods determines how long the subscription has to run before the subscription can be terminated.
  • Name
    The product version name is the name of the product which is shown to the user for the version. When the visible product name should be changed for a particular product a new version has to be created which contains the new name of the product.
  • Number of Notice Periods
    The number of notice periods determines the number of periods which need to be paid between the request to terminate the subscription and the final period.
  • Obsoleted On
  • Planned Purge Date
    The date and time when the object is planned to be permanently removed. If the value is empty, the object will not be removed.
  • Product
    Each product version is linked to a product.
  • Reference
    The product version reference helps to identify the version. The reference is generated out of the product reference.
  • Retiring Finished On
  • Retiring Started On
  • State
    The object's current state.
  • Tax calculation
    Strategy that is used for tax calculation in fees.
  • Version
    The version is used for optimistic locking and incremented whenever the object is updated.