Skip to main content

Overview of Single Version Subscription

Zuora

Overview of Single Version Subscription

  1. Last updated
  2. Save as PDF

The Single Version Subscription feature, only available to new customers and tenants, offers the following benefits:

  • Simplicity and clarity: With a single version, customers do not have to manage multiple versions of a subscription. This simplifies the subscription management process and reduces confusion.
  • Change history transparency: The introduction of the Change History object provides a clear record of all orders-related changes made to single version subscriptions. This transparency can help customers understand the evolution of the service and make informed decisions. 
  • Consistent experience: A single version ensures that all customers have a consistent experience with the product or service, which is particularly important for brand consistency and user satisfaction.
  • Consistent UI experience: Users will benefit from a consistent look and feel. This uniformity helps in reducing the learning curve and ensures a seamless experience.
  • Revert Order order action: This new order action allows users to revert an order containing single version subscriptions. 
  • Only subscriptions created through orders can be single version subscriptions. The Single Version Subscription feature is in the Early Adopter phase. We areactively soliciting feedback from a small group of early adopters before releasing it as generally available. If you want to join this early adopter program, submit a request at Zuora Global Support.
  • In the Early Adopter phase, you can turn on this feature only for new customers and new tenants. Single version subscriptions and versioned subscriptions cannot coexist in the same tenant, which means you cannot turn on this feature in a tenant with versioned subscriptions.

Change history 

An object called Change History records the following orders-related changes to single version subscriptions. 

The following tables list the change history available in UI. For more information, see View details of single version subscriptions. For change history available in API, see Subscription Change History.

Order Actions

Order action 

Change history displayed

Create Subscription
  • Create Subscription: Subscription start date and end date
  • Add Product: Product rate plans and charges, including the quantity and price of regular charges and the fixed amount or percentage of the discount charges. 

Add Product

Add Product: Product rate plans and charges, including the quantity and price of regular charges and the fixed amount or percentage of the discount charges. 

Update Product

Update Product: Subscription rate plans and charges, including the updated quantity and price of regular charges and the updated fixed amount or percentage of the discount charges. 

Remove Product

Remove Product: Removed subscription rate plan name.

Terms And Conditions

Terms And Conditions changed: The changes in the following settings:

  • Auto Renew
  • Renewal settings: renew to Evergreen or a specific term
  • Term: new term start date and end date

Suspend

Suspend Subscription: The date on which the subscription is suspended.

Resume

  

Resume Subscription: The date on which the subscription is resumed.

Renewal

Renew Subscription:

  • For a subscription renewed to an evergreen subscription, displays the new subscription term start date and the evergreen subscription type.
  • For a subscription renewed to a specific date, displays the new subscription term start date and end date.

Owner Transfer

Owner Transfer: 

  • If the invoice owner account is transferred, displays the new invoice owner account.
  • If the subscription owner account is transferred, displays the new subscription owner account.

Cancelation

Cancel Subscription: The date on which the subscription is canceled.

Revert

Note: This order action is only available to single version subscriptions

  

If you revert order O-00000637. Order O-00000638 is automatically generated, including the Revert Order order action. The order O-00000637 is a reverted order, and the order O-00000638 is a revert order. 

Information about reverted order O-00000637 and revert order O-00000638 are both displayed:

  • Order has been reverted on: Displays information for the reverted order O-00000637, that is, the date on which this order is reverted.
  • Reverted Order: Displays information for revert order O-00000638, that is, the order number of the associated reverted order O-00000637.

For more information, see Revert orders.

Change Plan

Only available in API. For more information, see Subscription Change History.

Regardless of the order action types, the charge tier level change is not available in UI and API. 

Scheduled and draft orders

The following table lists the scheduled and draft orders in the change history in UI.

Scheduled or draft orders

Description

Scheduled orders

Scheduled Execution Date: The scheduled execution date.

Draft order

Draft order: Only displays the order number.

In API, there is no subscription change information for draft orders.

Work with other features

The following table lists how change history works with other features. 

Feature Name

Description

Events and Notifications

When defining custom event trigger conditions for the subscription object for the single version subscriptions:

  • for creating subscriptions, you still can use changeType = INSERT
  • for updating subscriptions, you must use changeType = UPDATE since the updates apply to the unique subscription object

For more information, see Custom event triggers.
Zuora CPQ The Single Version Subscription feature is supported in legacy CPQ and CPQ X.