Quote and Charge Metrics
This article describes Quote and charge metrics in Zuora CPQ in two scenarios: without the Orders feature turned on and with the Orders feature on.
Quote and charge metrics are calculated based on a specified number of billing periods or based on the term end date of the subscription. The metrics are displayed on the Quote Detail page.
For proper calculation of the quote metrics, the Zuora Connection user must have the Post Invoice permission.
If you implemented a custom code to display quote and charge metrics, see Populate Quote and Charge Metrics in Custom Code for the steps to retrieve the metrics from Zuora and display them on your custom quote page.
Quote Metrics without Orders
Quote metrics are available as of Zuora Quotes version 6.0.
See the Zuora Quotes Q4 2013 Upgrade for more information how to configure the Quote Detail page with a revised layout and update your quotes to trigger a recalculation to use quote metrics.
The MRR and TCV metrics are displayed for New Subscription quotes, and Delta MRR and Delta TCV metrics are displayed for Amendment and Renewal quotes.
The following quote metrics are available:
| Metric | Description |
|---|---|
| MRR (Monthly Recurring Revenue) |
Monthly recurring revenue (MRR) calculates subscription recurring fees normalized to a monthly value. For more information, see Monthly Recurring Revenue. |
| Delta MRR |
The change in monthly recurring revenue (MRR) between the latest MRR and the previous MRR after a subscription amendment. For more information, see Delta Monthly Recurring Revenue. |
| TCV (Total Contract Value) |
Total contract value (TCV) calculates the total one-time and recurring charges from the subscription start date to the subscription end date, covering all terms. For instance, if a three-year contract is billed annually at $50,000 per year and has a one-time set up fee of $10,000, then the total contract value for this contract is $160,000. For more information, see Total Contract Value. |
|
Delta TCV |
Delta TCV calculates the TCV difference between two versions of subscription before and after the change. For example, if you have a 12-month subscription on a product with a flat fee of $100 per month, and the product price is increased to $200 per month from the 7th month, then Delta TCV is $100*6 + $200*6 - $100*12 = $600. For more information, see Delta Total Contract Value. |
| Sub-total | The quote subtotal for the specified billing periods, excluding discount charges and taxes. |
| Discount | The sum of all discount charges for the specified billing periods. |
| Tax | The tax calculated for the specified billing periods. |
| Total | The quote total for the specified billing periods, including discount charges and taxes. |
Quote Metrics Calculation Period
Quote metrics are calculated based on the Calculate Quote Metrics Through setting: Number of Billing Periods or End of Term
- Based on the Number of Billing Periods
If the Calculate Quote Metrics Through value is set to a specified number of billing periods, quote metrics are calculated using the number of billing periods. Note that the number of billing periods option is treated differently for evergreen and termed subscriptions:
- Evergreen Subscription: Number of billing periods will always default to 1.
- Termed Subscription: Number of billing periods will be the user entered value.
- Based on End of Term Date
If the Calculate Quote Metrics Through value is set to the End of Term, quote metrics are calculated through the End of Term date based on the quote type:
- New Subscription Quote: End of Term Date = Term Start Date (if null, default to the Quote Start Date) + Initial Term
- Amendment Quote: End of Term Date = Term End Date of the original Subscription
- Renewal Quote: End of Term Date = Term End Date of the original Subscription + Renewal Term
- Cancelation Quote: End of Term Date = Cancelation Effective Date
You need to add the "Calculate Quote Metrics Through" and "Number of periods" fields to any of the following fieldsets to display these fields in the Quote Studio UI:
| Fieldset Name | API Name |
|---|---|
| Quote Information | CPQX_Quote_Information |
| Quote Summary | CPQX_Quote_Summary |
| Quote Information | CPQX_SelectBillingAccount_Quote_Info |
| CPQX Sidebar Metrics Panel | CPQX_Sidebar_Metrics_Panel |
| Billing Attributes | CPQX_Subscription_Billing |
| Overview | CPQX_Subscription_Overview |
| Subscription Summary | CPQX_Subscription_Summary |
Quote Metrics Calculation/Recalculation Trigger
Quote metrics are calculated automatically when a New Subscription quote or a Renewal quote is created. Quote metrics are recalculated and updated if you update:
- Certain subscription term and date values on a quote
Quote metrics are recalculated if any of the following Subscription Terms values are updated on a quote:
- Start Date
- Subscription Term Type
- Initial Term
- Term Start Date
- Service Activation Date
- Customer Acceptance Date
Additionally, quote metrics are recalculated if the Calculate Quote Metrics Through option (from Zuora Quotes) Default Value page or Quote Detail page) is updated.
- Any values on a quote charge or a quote charge tier that result in the change of Total Price of the charge
- Quote Charges
Quote metrics are recalculated after updating any of the following charge values on the Product Selection page of a quote:
- Effective Price
- Quantity
- Discount %
- Tiered Quote Charges
When the Discount % or Effective Price values on a tiered quote charge of a quote are updated, quote metrics are recalculated only when the updated tiered level is reached.
For example, if you update the Discount % on Tier 2 from 0 to 5%, this change will recalculate quote metrics only when Tier 2 pricing is reached.
- Any values on a discount charge
Quote metrics are recalculated after updating any of the following discount values from the Product Selection page of a quote:
- Discount Percentage
- Discount Fixed Amount
- Up to How Many Periods
- Discount Level
- The address of the Sold-to Contact
Quote metrics are recalculated after updating any information on the Sold To Contact page, including the address.
You can only update Sold To Contact information on a quote that has already been sent to Zuora.
- Add or remove a rate plan
Quote metrics are recalculated after adding or removing a product rate plan from the Product Selection page of a quote.
- Change the invoice owner
The Invoice Owner field does not appear on the quote pages by default. Add the field to the appropriate field set to have the field available for edit in the quote flow. See Layout Configuration Settings for detail information.
The recalculated metrics can be viewed when you go to the Quote Detail page.
Set the Default Metric Calculation Period for All Quotes
You can set a default for calculating quote metrics based on a specific number of billing periods or through the end of a subscription term. See Configure Quote Settings for more information on this option.
To set the default calculation period for all quote metrics:
- In Salesforce, click the Zuora Quotes Config tab and click Default Value Settings from the Zuora CPQ Quotes Configuration Setting page.
- Click Edit Settings.
- From the Quote Default Settings section, select one of the following Calculate Quote Metrics Through options:
- Specific a number of Billing Period(s) from 1 up to 36 periods.
- End of Term.
- Click Save.
Set the Metric Calculation Period on a Single Quote
From the Quote Detail page, you can override the organization-level Calculate Metrics Through setting on the current quote. After setting and saving this value on the quote, metrics are calculated for this quote based on the Calculate Metrics Through value set on the quote.
- Click the quote name on the Quotes tab or from an opportunity to open the quote.
- On the Quote Detail page, click Edit Quote Details.
- Under the Quote Information section, set the Calculate Quote Metrics Through option for this quote.
- Click Save.
Charge Metrics without Orders
The charge metrics are available for all quote types via the Quote Charge Detail (zqu__QuoteChargeDetail__c) object. The process to retrieve the metrics are:
- The charge level metrics are retrieved directly from Zuora's Rating and Billing engine and stored in the Quote Charge Detail (zqu__QuoteChargeDetail__c) object:
- MRR (zqu__MRR__c) for the New Subscription and Renewal quotes
- TCV (zqu__TCV__c) for the New Subscription and Renewal quotes
- Delta MRR (zqu__DeltaMRR__c) for the Amendment and Cancellation quotes
- Delta TCV (zqu__DeltaTCV__c) for the Amendment and Cancellation quotes
- The metrics are also stored in the corresponding fields on the Quote Rate Plan Charge (zqu__QuoteRatePlanCharge__c) and Quote Charge Summary (zqu__QuoteChargeSummary__c) objects if those objects exist.
- TCV (zqu__PreviewedTCV__c)
- MRR (zqu__PreviewedMRR__c)
The below metrics are available at the charge and charge summary level.
| Quote Type | Metrics Available |
|---|---|
| New Subscription |
|
| New Product Amendment |
|
| Update Product Amendment |
|
| Renewal |
|
The charge level metrics do not appear on the Quote Detail page, by default. Refer to the steps described in Display Charge Level Metrics to configure Zuora Quotes to show the charge level metrics on the Quote Detail page.
Charge Metrics and Automatic Price Change Option
If the Price Change Option of a product charge is set to Use Latest Product Catalog, quoting metrics for the charge reflect the catalog price at the time of quoting, and they may be out of sync if the charge was changed in Product Catalog between the time the quote is approved and the time the quote is sent.
To keep the metrics consistent through the quoting lifecycle, you should ensure the Product Catalog is current in Salesforce when creating and sending quotes with the Use Latest Product Catalog charge option.
Limitations
The following limitations exist in the charge level metrics.
- The metrics for the Cancellation quotes are only available through the Quote Charge Detail.
- The charge metrics for the discount charges, both the fixed amount and percentage types, are not created or updated in the Quote Charge Detail. Currently, Zuora does not return any values for the charge metrics for the discount charge.
- The Discount (zqu__BillingDiscount__c) field on the Quote Charge Detail records represents the amount of the initial charge that is discounted.
The Discount field is populated for:
- One-Time charges
- Recurring charges
The Discount field is not populated for:
- Usage charges
- Discounts reflected by Discount Charges for One-Time and Recurring charges
Quote and Charge Metrics in Orders
All the metrics fields listed in this document can be relied upon as a direct representation of metrics returned from the Orders Preview Metrics Response. However, there are more metrics fields in the Zuora CPQ data model that represent older, locally calculated fields that should not be relied upon to represent metrics returned from the Zuora Billing engine.
Order metrics capture the impact of every change across the whole subscription lifecycle. The charge metrics represent the net changes on a charge caused by a specific action. While subscription metrics provide the values of a subscription over time, order metrics provide the values for a single transactional event within an order. Order metrics enhance the subscription metrics by including additional metrics, such as Discount Monthly Recurring Revenue (DMRR) and Total Contracted Billing (TCB).
There are three types of metrics based on how the values are aggregated across charge segments:
- Simple, single value metrics such as CMRR.
- Time series metrics such as MRR and ARR. They cannot be represented as a single number, but rather need to be represented as a time series.
- Aggregate metrics such as TCV, ACV, and TCB that are meaningful when applied across a period of time.
When the Orders setting is enabled in your Zuora tenant and Zuora Quotes org, previewing a quote produces order metrics, charge metrics, and invoice metrics by Zuora as below:
- Zuora Quotes retrieves and stores summary information for all rate plans and charges at the parent level in the Quote (zqu__Quote__c) object.
- Zuora Quotes retrieves the charge metrics and invoice metrics from Zuora, stores them in the Quote Charge Detail (zqu__QuoteChargeDetail__c) object to aggregate and populate the quote metrics.
- Zuora Quotes retrieves the delta order metrics and TCV from Zuora, stores them in the Quote Charge Summary (zqu__QuoteChargeSummary__c) and the Quote Rate Plan Charge (zqu__QuoteRatePlanCharge__c) objects to populate the charge metrics.
- Zuora Quotes retrieves and stores the interval level metrics of the charge for the ramp subscription in the Quote Charge Interval Detail (zqu__QuoteChargeIntervalDetail__c) object.
- Zuora Quotes retrieves and stores the non-subscription items attached to the quote and their related metrics in the Quote Order Line Item (zqu__QuoteOrderLineItem__c) object.
The MRR, TCB, and TCV metrics are displayed for New Subscription quotes, and Delta MRR, Delta TCB, and Delta TCV metrics are displayed for Amendment and Renewal quotes.
For detailed metrics and objects mapping between CPQ and the preview order response, see Zuora CPQ metric fields mapping and derivation.
For a detailed understanding of how CPQ object records are created for different Quoting scenarios (New, Amend, Renew), see Quote Object Records Created with Orders.
When the Orders setting is enabled, the Previewd MRR (zqu__PreviewedMRR__c) metric is no longer populated on the Quote Rate Plan Charge (zqu__QuoteRatePlanCharge__c) and Quote Charge Summary (zqu_QuoteChargeSummary__c) objects.
Quote Object in Orders
The following table describes the quote metrics and the mappings between Zuora and the Quote object fields.
| Zuora Metric | Metric Field on Quote | Description |
|---|---|---|
|
Total Contracted Billing |
Total Contracted Billing (zqu__Previewed_TCB__c) |
The amount billed in a contract. |
| TCB Tax | TCB Tax (zqu__TCBTax__c) |
Tax on TCB. |
|
Total Contracted Value |
Total Contract Value (zqu__Previewed_TCV__c) |
Total contract value (TCV) calculates the total one-time and recurring charges from the subscription start date to the subscription end date, covering all terms. For instance, if a three-year contract is billed annually at $50,000 per year and has a one-time set up fee of $10,000, then the total contract value for this contract is $160,000. For more information, see Total Contract Value. |
|
Monthly Recurring Revenue |
Monthly Recurring Revenue (zqu__Previewed_MRR__c) |
The subscription recurring fees normalized to a monthly value. This metric takes into account the expected cancellations, upgrades, and downgrades in the subscription, i.e. contracted MRR. |
|
Discount TCB |
Discount TCB (zqu__DiscountTCB__c) |
The impact of the discount charges against the TCB. |
| Discount TCB Tax | Discount TCB Tax (zqu__DeltaDiscountTCBTax__c) |
Tax on Discount TCB. |
|
Discount TCV |
Discount TCV (zqu__DiscountTCV__c) |
The impact of the discount charges against the TCV. |
|
Discount MRR |
Discount MRR (zqu__DiscountMRR__c) |
The impact of the discount charges against the contracted MRR. |
| Delta MRR | Delta MRR (zqu__Previewed_Delta_MRR__c) |
The change in monthly recurring revenue (MRR) between the latest MRR and the previous MRR after a subscription amendment. For more information, see Delta Monthly Recurring Revenue. |
| Delta TCB | Delta TCB (zqu__Previewed_Delta_TCB__c) |
The change in estimated billing over the duration of a RatePlanCharge or an order line item as the result of an Order. |
| Delta TCV | Delta TCV (zqu__Previewed_Delta_TCV__c) |
Delta TCV calculates the TCV difference between two versions of subscription before and after the change. For example, if you have a 12-month subscription on a product with a flat fee of $100 per month, and the product price is increased to $200 per month from the 7th month, then Delta TCV is $100*6 + $200*6 - $100*12 = $600. For more information, see Delta Total Contract Value. |
| Delta TCB Tax | Delta TCB Tax (zqu__DeltaTCBTax__c) |
Tax on Delta TCB. |
| Delta Discount TCB Tax | Delta Discount TCB Tax (zqu__DeltaDiscountTCBTax__c) |
Tax on Delta Discount TCB. |
| Delta Discount MRR | Delta Discount MRR (zqu__DeltaDiscountMRR__c) |
The change in Monthly Recurring Revenue (MRR) of discount charges as the result of an Order. |
| Delta Discount TCB | Delta Discount TCB (zqu__DeltaDiscountTCB__c) |
The change in estimated billing over the duration of discount charges as the result of an Order. |
| Delta Discount TCV | Delta Discount TCV (zqu__DeltaDiscountTCV__c) |
The change in Total Contract Value (TCV) of discount charges as the result of an Order. |
| Subscription Subtotal | Subscription Subtotal (zqu__Subscription_Subtotal__c) |
The subscription subtotal amount for the specified subscription term, excluding discount charges and taxes. |
| Subscription Tax | Subscription Tax (zqu__Subscription_Tax__c) |
The tax calculated for the specified subscription term. |
| Subscription Total | Subscription Total (zqu__Subscription_Total__c) |
The subscription total amount for the specified subscription term, including discount charges and taxes. |
| Inline Discount | Inline Discount (Inline_Discount__c) |
This is not a standard metric returned from Orders. This is a CPQ-only metric locally calculated from the difference between List Price and Effective Price for each charge in a quote, then those figures for each charge are added together. |
The following table describes the invoice metrics and the mappings between Zuora and the Quote object fields. The invoice metric fields are used to populate the quote level metrics.
| Zuora Invoice Metric | Metric Field on Quote | Description |
|---|---|---|
| Total Without Tax |
Sub-total (zqu__Previewed_SubTotal__c) |
The quote subtotal for the specified billing periods, excluding discount charges and taxes. |
| Discount |
Discount (zqu__Previewed_Discount__c) |
The sum of all discount charges for the specified billing periods. |
| Tax |
Tax (zqu__Previewed_Tax__c) |
The tax calculated for the specified billing periods. |
|
Total |
Total (zqu__Previewed_Total__c) |
The quote total for the specified billing periods, including discount charges and taxes. |
| Sub-Total | Sub-Total (zqu__Previewed_SubTotal__c) |
The subtotal for the specified billing periods, excluding discount charges and taxes. |
| Order Line Item Subtotal | Quote Line Item Subtotal (zqu__Qli_Subtotal__c) |
The quote subtotal for the specified billing periods for all order line items, excluding discount charges and taxes. |
| Order Line Item Tax | Quote Line Item Tax (zqu__Qli_Tax__c) |
The tax calculated for the specified billing periods for all order line items. |
| Order Line Item Total | Quote Line Item Total (zqu__Qli_Total__c) |
The quote total for the specified billing periods for all order line items, including discount charges and taxes. |
For the invoice metrics shown in the above table, we recommend you review your implementation requirements and consider if the TCB metrics are an appropriate replacement.
Quote Rate Plan Charge in Orders
The following table describes the charge metrics and the mappings between Zuora and the Quote Rate Plan Charge object fields.
| Zuora Charge Metric | Metric Field on Quote Rate Plan Charge |
Description |
|---|---|---|
|
Delta TCB |
Delta TCB (zqu__DeltaTCB__c) |
The delta of the total TCBs between the original subscription and the order action. For renewals, this is the TCB of the new contract. |
| Delta TCB Tax | Delta TCB Tax (zqu__DeltaTCBTax__c) |
Tax on Delta TCB. |
|
Delta TCV |
Delta TCV (zqu__DeltaTCV__c) |
Delta TCV calculates the TCV difference between two versions of subscription before and after the change. For example, if you have a 12-month subscription on a product with a flat fee of $100 per month, and the product price is increased to $200 per month from the 7th month, then Delta TCV is $100*6 + $200*6 - $100*12 = $600. For more information, see Delta Total Contract Value. |
|
Delta MRR |
Delta MRR (zqu__DeltaMRR__c) |
The change in monthly recurring revenue (MRR) between the latest MRR and the previous MRR after a subscription amendment. For more information, see Delta Monthly Recurring Revenue. |
|
Delta Discount TCB |
Delta Discount TCB (zqu__DeltaDiscountTCB__c) |
The delta of the Discount TCBs between the original subscription and the order action. For renewals, this is the Discount TCB of the new contract. |
| Delta Discount TCB Tax | Delta Discount TCB Tax (zqu__DeltaDiscountTCBTax__c) |
Tax on Delta Discount TCB. |
|
Delta Discount TCV |
Delta Discount TCV (zqu__DeltaDiscountTCV__c) |
The delta of the Discount TCVs between the original subscription and the order action. For renewals, this is the Discount TCV of the new contract. |
|
Delta Discount MRR |
Delta Discount MRR (zqu__DeltaDiscountMRR__c) |
The delta of the Discount MRRs between the original subscription and the order action. For renewals, this is the Discount MRR of the new contract. |
Quote Charge Summary in Orders
The following table describes the charge metrics and the mappings between Zuora and the Quote Charge Summary object fields. Quote Charge Summary metrics fields are used to populate the charge level metrics.
| Zuora Charge Metric | Metric Field on Quote Charge Summary |
Description |
|---|---|---|
|
Delta TCB |
Delta TCB (zqu__DeltaTCB__c) |
The delta of the total TCBs between the original subscription and the order action. For renewals, this is the TCB of the new contract. |
| Delta TCB Tax | Delta TCB Tax (zqu__DeltaTCBTax__c) |
Tax on Delta TCB. |
|
Delta TCV |
Delta TCV (zqu__DeltaTCV__c) |
Delta TCV calculates the TCV difference between two versions of subscription before and after the change. For example, if you have a 12-month subscription on a product with a flat fee of $100 per month, and the product price is increased to $200 per month from the 7th month, then Delta TCV is $100*6 + $200*6 - $100*12 = $600. For more information, see Delta Total Contract Value. |
|
Delta MRR |
Delta MRR (zqu__DeltaMRR__c) |
The change in monthly recurring revenue (MRR) between the latest MRR and the previous MRR after a subscription amendment. For more information, see Delta Monthly Recurring Revenue. |
|
Delta Discount TCB |
Delta Discount TCB (zqu__DeltaDiscountTCB__c) |
The delta of the Discount TCBs between the original subscription and the order action. For renewals, this is the Discount TCB of the new contract. |
| Delta Discount TCB Tax | Delta Discount TCB Tax (zqu__DeltaDiscountTCBTax__c) |
Tax on Delta Discount TCB. |
|
Delta Discount TCV |
Delta Discount TCV (zqu__DeltaDiscountTCV__c) |
The delta of the Discount TCVs between the original subscription and the order action. For renewals, this is the Discount TCV of the new contract. |
|
Delta Discount MRR |
Delta Discount MRR (zqu__DeltaDiscountMRR__c) |
The delta of the Discount MRRs between the original subscription and the order action. For renewals, this is the Discount MRR of the new contract. |
| Quantity | Quantity (zqu__Quantity__c) |
The charge quantity of a quote. With Quotes version 10.14.1 (for users with Orders enabled in CPQ), the default behavior of the Quantity field in the Quote Charge Summary object has changed for both CPQ 9 and CPQ X. Previously, Quantity on the Quote Charge Summary object represented the Delta Quantity value related to the quote amendment record created by an Add, Remove, or Update action. For example: Before 10.14.1, if a Per Unit's Quantity were updated from 5 to 8, then the Quote Charge Summary record attached to that Quote Amendment record would show the value "3". After upgrading to version 10.14.1, the Quantity field will reflect the updated value of the Quantity. For example: Following 10.14.1, if a Per Unit's Quantity is updated from 5 to 8, then the Quote Charge Summary record attached to that Quote Amendment record will show the value "8" in the Quantity field. |
| Delta Quantity | Delta Quantity (zqu__DeltaQuantity__c) |
Using the Order Metrics preview response, this field will store the Delta Quantity value. For example: If a Per Unit's Quantity is updated from 5 to 8, then the Delta Quantity field on the Quote Charge Summary object that will hold the value "3". Note that all references to QCS.Quantity should point to QCS.DeltaQuantity. |
Quote Charge Detail in Orders
The following table describes the charge metrics and the mappings between Zuora and the Quote Charge Detail object fields.
The Quote Charge Detail object is supported in the 9.26 or later versions of Zuora Quotes.
| Zuora Metric | Metric Field on Quote | Description |
|---|---|---|
|
Total Contracted Billing |
Total Contracted Billing (zqu__Previewed_TCB__c) |
The amount billed in a contract. |
| TCB Tax | TCB Tax (zqu__TCBTax__c) |
Tax on TCB. |
|
Total Contracted Value |
Total Contract Value (zqu__Previewed_TCV__c) |
Total contract value (TCV) calculates the total one-time and recurring charges from the subscription start date to the subscription end date, covering all terms. For instance, if a three-year contract is billed annually at $50,000 per year and has a one-time set up fee of $10,000, then the total contract value for this contract is $160,000. For more information, see Total Contract Value. |
|
Monthly Recurring Revenue |
Monthly Recurring Revenue (zqu__Previewed_MRR__c) |
The subscription recurring fees normalized to a monthly value. This metric takes into account the expected cancellations, upgrades, and downgrades in the subscription, i.e. contracted MRR. |
|
Discount TCB |
Discount TCB (zqu__DiscountTCB__c) |
The impact of the discount charges against the TCB.
|
| Discount TCB Tax | Discount TCB Tax (zqu__DeltaDiscountTCBTax__c) |
Tax on Discount TCB. |
|
Discount TCV |
Discount TCV (zqu__DiscountTCV__c) |
The impact of the discount charges against the TCV. |
|
Discount MRR |
Discount MRR (zqu__DiscountMRR__c) |
The impact of the discount charges against the contracted MRR. |
| Delta MRR | Delta MRR (zqu__Previewed_Delta_MRR__c) |
The change in monthly recurring revenue (MRR) between the latest MRR and the previous MRR after a subscription amendment. For more information, see Delta Monthly Recurring Revenue. |
| Delta TCB | Delta TCB (zqu__Previewed_Delta_TCB__c) |
The change in estimated billing over the duration of a RatePlanCharge or an order line item as the result of an Order. |
| Delta TCV | Delta TCV (zqu__Previewed_Delta_TCV__c) |
Delta TCV calculates the TCV difference between two versions of subscription before and after the change. For example, if you have a 12-month subscription on a product with a flat fee of $100 per month, and the product price is increased to $200 per month from the 7th month, then Delta TCV is $100*6 + $200*6 - $100*12 = $600. For more information, see Delta Total Contract Value. |
| Delta TCB Tax | Delta TCB Tax (zqu__DeltaTCBTax__c) |
Tax on Delta TCB. |
| Delta Discount TCB Tax | Delta Discount TCB Tax (zqu__DeltaDiscountTCBTax__c) |
Tax on Delta Discount TCB. |
| Delta Discount MRR | Delta Discount MRR (zqu__DeltaDiscountMRR__c) |
The change in Monthly Recurring Revenue (MRR) of discount charges as the result of an Order. |
| Delta Discount TCB | Delta Discount TCB (zqu__DeltaDiscountTCB__c) |
The change in estimated billing over the duration of discount charges as the result of an Order. |
| Delta Discount TCV | Delta Discount TCV (zqu__DeltaDiscountTCV__c) |
The change in Total Contract Value (TCV) of discount charges as the result of an Order. |
Quote Charge Interval Detail in Orders
The following table describes the charge metrics and the mappings between Zuora and the Quote Charge Interval Detail object fields. Quote Charge Interval Detail metrics fields are used to populate the charge level metrics.
The Quote Charge Interval Detail object is supported in the 9.26 or later versions of Zuora Quotes.
| Zuora Charge Metric | Metric Field on Quote Charge Interval Detail |
Description |
|---|---|---|
| TCB |
Net TCB (zqu__TCB__c) |
Net TCB within the interval. |
| MRR |
Net MRR (zqu__MRR__c) |
Net MRR as of the end of the period. |
| Delta TCB | Delta TCB (zqu__DeltaTCB__c) |
The delta of the total TCBs between quote charge intervals. |
| Delta MRR | Delta MRR (zqu__DeltaMRR__c) |
The change in monthly recurring revenue (MRR) between the latest MRR and the previous MRR after a subscription amendment. For more information, see Delta Monthly Recurring Revenue. |
Quote Order Line Item in Orders
The following table describes the charge metrics and the mappings between Zuora and the Quote Order Line Item object fields.
| Zuora Charge Metric | Metric Field on Quote Order Line Item |
Description |
|---|---|---|
| Sub-total | Subtotal (zqu__Subtotal__c) |
The quote subtotal for the specified billing periods, excluding discount charges and taxes. |
| Tax | Tax (zqu__Tax__c) |
The tax calculated for the specified billing periods. |
| Total | Total (zqu__Total__c) |
The quote total for the specified billing periods, including discount charges and taxes. |
Quote Ramp Interval in Orders
The following table describes the charge metrics and the mappings between Zuora and the Quote Ramp Interval object fields.
| Zuora Charge Metric | Metric Field on Quote Ramp Interval |
Description |
|---|---|---|
| Inline Discount | Inline Discount (zqu__Inline_Discount__c) | The discounted amount for inline items for the specified interval in real-time. |
| Interval Discount | Interval Discount (zqu__Interval_Discount__c) | Sum of all discount charges for the specified interval. |
| Interval Subtotal | Interval Subtotal (zqu__Interval_Subtotal__c) | The interval subtotal for the specified interval, excluding discount charges and taxes. |
| Interval Tax | Interval Tax (zqu__Interval_Tax__c) | The tax calculated for the specified interval. |
| Interval Total | Interval Total (zqu__Interval_Total__c) | The interval total amount for the specified interval, including discount charges and taxes. |
| Gross TCB | Gross TCB (zqu__Gross_TCB__c) | Gross TCB within the interval. |
| Gross TCV | Gross TCV (zqu__Gross_TCV__c) | Gross TCV within the interval. |
| Net TCB | Net TCB (zqu__Net_TCB__c) | Net TCB within the interval. |
| Net TCV | Net TCV (zqu__Net_TCB__c) | Net TCV within the interval. |
| Discount TCB | Discount TCB (zqu__Discount_TCB__c) | Discount TCB within the interval. |
| Discount TCV | Discount TCV (zqu__Discount_TCV__c) | Discount TCV within the interval. |
Quote Metrics Object Model in Orders
The main Zuora Quotes objects for quote metrics are:
- Quote Charge Detail: contains the charge level metrics after all actions are applied to the charge
- Quote Charge Summary: contains the delta charge level metrics after a single action is applied to the charge
- Quote: contains the cumulative metrics amounts of the subscription
- Quote Rate Plan Charge: contains the delta metrics
- Quote Charge Interval Detail: contains the interval level metrics of the charge for the ramp subscription as returned by the preview response
- Quote Order Line Item: contains the non-subscription items attached to the quote and its related metrics
The following diagram shows the objects and fields involved in order and charge metrics in Zuora and Zuora Quotes.
