home

Zuora Billing

Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies
Zuora BillingZuora PaymentsZuora PlatformZuora CPQZephrZuora RevenueAccounts ReceivableRelease NotesBasicsEntitlementsSupport and policies

Welcome to Zuora Product Documentation

Explore our rich library of product information

Show Contents

thumbnailZuora Billing

Order Delta Metrics and Order Metrics

Order Delta TCB

This article explains the Order Delta Tcb metric, its calculation, and how to access it through Data Query, highlighting its role in the Order Delta Metrics.

This article introduces the concept and calculation of the Order Delta Tcb metric, and how to access the Order Delta Tcb object and fields through Data Query.

The Order Delta Tcb metric is part of the Order Delta Metrics. If you are still using the previous Order Metrics, see Key Metrics for Orders.

Note:

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

It is recommended that all customers use the new 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 Tcb

The value of an Order Delta Tcb metric is the change in estimated billing over the duration of a RatePlanCharge object as the result of an Order.

For a termed subscription, Order Delta Tcb is generated asynchronously when an Order causes a change to the TCB of one-time or recurring charges. For an evergreen subscription, Order Delta Tcb will not be generated. The metrics are associated with the Order Action that causes the change, and the Rate Plan Charges that the Order Action impacts.

If Order Line Items are present in the Order, Order Delta TCB is generated for the Order Line Items as well, representing the total estimated billing amount for the Order Line Items. Gross and Net amount of Order Delta Tcb will always equal to Order Delta Tcv that is associated with the same Order Line Item.

Tcb model
Note:

Order Delta Tcb is not generated for evergreen subscriptions.

Order Delta TCB for term-aligned charges

When a recurring charge is configured with Billing Period Alignment = Align to Term Start Date or Align to Term End Date, Zuora calculates Order Delta Tcb using the latest subscription term boundary when an order changes the term (for example, through a Terms and Conditions or Renew order action).

For these term-aligned charges, Zuora first recalculates the TCB of the earlier version and the later version of the charge based on the current term start and end dates, and then derives Order Delta Tcb as the difference between those two TCB values.

  • Delta TCB correctly reflects the impact of term changes for charges aligned to the subscription term.

  • Order Metrics and Charge Metrics returned by the Preview an orderAPI are consistent for term-aligned charges, avoiding discrepancies such as unexpected contributions from removed historical charge segments in renewal scenarios.

Asynchronism

Order Delta Metrics will be generated asynchronously with the order. There could be a delay between the Order submission and metrics generation.

Last updated: April 28, 2026