Welcome to Zuora Product Documentation

Explore our rich library of product information

View Versioned Subscription Change History

This article explains how to view the change history of a subscription, including details on subscription versions and order actions.

As a change is made to a subscription (such as an Add product amendment and a Renew subscription order action), a new version of the subscription is created. The corresponding order action or amendment type of each subscription version indicates the change made to the subscription.

You can view the change history of a subscription on the subscription detail page.

You can also query the Subscription Status History data source, see Query data through Subscription Status History data source .

To view the change history of a subscription:

  1. Navigate to Customers > Subscriptions in the left-hand navigation section.
  2. Select the subscription that you want to view the change history.
  3. In the Subscription detail screen, scroll to the Subscription change history area. You can see a table that lists the detailed change information for each version of the subscription.

Each row in the change history table stands for a subscription version. Based on the mode of your tenant: Orders , Subscribe/Amend (S/A), or Orders Harmonization (Orders and S/A co-existent), the table can contain corresponding columns that indicate the detailed change information.

For an Orders tenant, the Subscription change history table is like below:

subscription_change_history_for_orders

It contains the following columns:

  • Version: Identifies a certain version of the subscription.
  • Order Number: Identifies the order that contributes to this version of the subscription. This column is present in Orders tenants or co-existent tenants.
  • Order Action: The order actions that have impacted the subscription and taken place in a particular order. If multiple order actions are present in this column, you can click the plus icon (+) in the Version column to display a list of the order actions. At most five order actions can be displayed.
  • Order Details: The detailed change information tagged for each order action in the order.
  • Created By
  • Created On
  • Order Date
  • Contract Effective
  • Service Activation: This column is present if Zuora is configured to require service activation .
  • Customer Acceptance: This column is present if Zuora is configured to require customer acceptance .

For an Orders Harmonization (Orders and S/A co-existent) tenant, the table is like below:

subscription_change_history_for_orders_hamonization

It contains the following columns:

  • Version: Identifies a certain version of the subscription.
  • Order Number: Identifies the order that contributes to this version of the subscription. This column is present in Orders tenants or co-existent tenants.
  • Amendment Number: Identifies the amendment that contributes to this version of the subscription. This column is present in S/A tenants or co-existent tenants.
  • Action: The order actions that have impacted the subscription and taken place in a particular order. If multiple order actions are present in this column, you can click the plus icon (+) in the Version column to display a list of the order actions. At most five order actions can be displayed.
  • Details: The detailed change information tagged for each order action in the order.
  • Created By
  • Created On
  • Order Date
  • Contract Effective
  • Service Activation : This column is present if Zuora is configured to require service activation .

  • Customer Acceptance: This column is present if Zuora is configured to require customer acceptance .

For a Subscribe/Amend tenant, the Subscription change history table is like below:

subscription_change_history_for_subscribe_and_amend

It contains the following columns:

  • Version: Identifies a certain version of the subscription.
  • Amendment Number: Identifies the amendment that contributes to this version of the subscription. This column is present in S/A tenants or co-existent tenants.
  • Amendment Type
  • Details: The detailed change information tagged for each amendment.
  • Created By
  • Created On
  • Booking Date: The last booking date of the subscription.
  • Contract Effective
  • Service Activation: This column is present if Zuora is configured to require service activation .

  • Customer Aceptance: This column is present if Zuora is configured to require customer acceptance .