Overview of Single Version Subscription

Last updated
Save as PDF

The Single Version Subscription feature offers the following benefits to new customers and those looking to migrate from versioned subscriptions:

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.

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 Order 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.

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	Zuora CPQ is not supported until Q4 in 2024.

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 Zuora CPQ is not supported until Q4 in 2024.