Availability

The Order Delta Metrics feature is only available if you have the Orders feature enabled. If you are an existing Subscribe and Amend customer and want Order Delta Metrics only, you can turn on Orders Harmonization . You can still keep the existing Subscribe and Amend API integrations and UI to create and manage subscriptions.

As of Zuora Billing Release 306, Order Metrics is no longer available. Zuora has updated the methodologies for calculating metrics in Orders . The new methodologies are reflected in the following Order Delta Metrics objects.

• Order Delta Mrr

• Order Delta Tcv

• Order Delta Tcb

• Order Delta Quantity

It is recommended that all customers use the Order Delta Metrics . If you are an existing Order Metrics customer and want to migrate to Order Delta Metrics , submit a request at Zuora Global Support . Whereas new customers, and existing customers not currently on Order Metrics , will no longer have access to Order Metrics , existing customers currently using Order Metrics will continue to be supported.

Order Delta Quantity

The value of an Order Delta Quantity metric is the change in quantity of a RatePlanCharge as the result of an Order. Zuora creates Order Delta Quantity metrics for one-time and recurring charges. You can use the orderdeltaquantity table in Data Query to retrieve the order delta quantity metrics.

For example, suppose that your customer has subscribed to 20 units of product for 12 months, with a list price of $5.00 per unit per month. The subscription starts from 2024-01-01 and is renewed on 2025-01-01. Your customer decides to increase the quantity to 30 units of product on 2025-07-01 and you perform the corresponding Update Product order action. Zuora then creates the Order Delta Quantity metrics for each charge segment for each order action shown in the following diagram.

In the above example, for the Update Product order action, the order delta quantity for charge segment PRC-2 between 2025–07-01 and 2026-01-01 is -20 due to the shrinking of the rate plan, and the order delta quantity for charge segment PRC-3 between 2025–07-01 and 2026-01-01 is 30 due to the updated quantity.

See Order Delta Quantity for more examples of different order actions.

Accessing Order Delta Metrics

You can access Order Delta Metrics through the following ways:

• Make the API call through the Preview an order operation.

• Use Data Query. See Data Query use cases in the following article:

  • Order Delta Mrr use cases

  • Order Delta Tcv use cases

  • Order Delta Tcb use cases

Objects and Fields

See the following articles for the objects and fields for Order Delta Metrics:

• Order Delta Mrr

• Order Delta Tcv

• Order Delta Tcb

• Order Delta Quantity

Historical Data

As of Zuora Billing Release 306, Order Delta Metrics will be generated asynchronously for every Order. If you want to generate Order Delta Metrics for your Orders generated in the past, submit a request at Zuora Global Support .

Limitations

Order Delta Metrics have the following limitations:

• Order Delta TCB does not support metrics generation for evergreen subscriptions.

• Order Delta TCV does not support metrics generation for charges that belong to evergreen subscriptions without an end date.

• When you create an Order, Zuora only generates Order Delta Metrics if the order is active.

• Discounts are supported at the subscription level, rate plan level, and account level. However, discount metrics are calculated for subscription and rate plan level discounts only, not calculated for account level discounts. You can perform the following amendments for subscriptions with account level discounts; however, no metrics will be generated:

  • Create Subscription

  • Add Product

  • Update

  • Remove

  • T&Cs

  • Cancellation

  • Renew

  • Suspend / Resume