Skip to main content

Zuora Quotes Version 10 Release Notes

Zuora

Zuora Quotes Version 10 Release Notes

These release notes provide a summary of new features, enhancements, and resolved issues in the Zuora Quotes Version 10 releases. Version 10.0 is the major release, on which all the 10.X releases are based. 

CPQ X is available to all customers since Zuora Quotes version 10.0. To learn more about CPQ X, see CPQ X.

To see previous release notes, go to Previous Zuora CPQ Releases.

Release 10.10.2 (Release Date: 2022-09-21) 

The 10.10.2 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Support to add Usage charges with Overage Pricing Charge Model in CPQ 9 and CPQ X

In Quotes version 10.10.2, you can add Usage charges with Overage Pricing as a charge model in CPQ 9 and CPQ X. You must enable the Store Existing Products setting under Zuora Config > Advanced Quoting Configuration Settings to add usage charges.

When you add products with usage charges to a new quote, Included Units and Number of Periods will be populated with their respective values from Zuora Product Catalog.

In amendment quotes, the Number of Periods field will be read-only. To update the Number of Periods field, remove the original product and replace it with the products with usage charges and update the Number of Periods.

Support to create Remove Product Amendment Action in Amendment Quote to remove a One Time Charges in CPQ X

In Quotes version 10.10.2, you can now create Remove Product Amendment Action in Amendment quote to remove a One Time Charges.

Support for setting a different Initial Term period type

Previously, when you select Initial Term Period Type other than months, you might encounter the following error:

Javascript Error: Uncaught Action failed: zqu:quoteStudio$controller$updateQuote [Invalid time value] throws at https: //zuorainc-e-dev-ed--zqu.visua..._prod.js:94:15. Caused by: Action failed: zqu:quoteStudio$controller$updateQuote [Invalid time value]
This issue has been resolved.

In Quotes version 10.10.2, the Initial Term Period Type (zqu__InitialTermPeriodType) field now supports the following term period types:

  • Day
  • Week
  • Month
  • Year

Resolved issue: Existing Zuora Account and Subscription Information details are not cleared when selecting Maintain Quote

Previously, when you select Maintain Quote to create a new billing account or select a different billing account, you may have experienced an issue where the Existing Zuora Account and Subscription Information details were not cleared. This issue has been resolved.

Resolved issue: Error when Auto-Renew is set to active and the Subscription Term Type is changed from Termed to Evergreen

Previously, if you enabled the Auto-Renew option under Quote Studio Settings > Default Settings and changed the Subscription Term Type from Termed to Evergreen when creating a subscription, the following error would occur: Error Processing Quote At Previewing: Code: 58730030, Message: AutoRenew is invalid for Evergreen subscription. This issue has been resolved.

Resolved issue: List Price for usage-based products appears as $0 when amending or renewing quotes

Previously, in Quote Studio, the List Price was displayed as $0 when amending or renewing a quote for usage-based products. This issue has been resolved.

Resolved issue: All contacts are not displayed in the Custom Lookup field

Previously, in Quote Studio when adding a custom lookup field with contact as Parent, it displayed only contacts related to the selected account instead of all contacts. This issue has been resolved.

This fix only applies to custom fields and not managed package fields such as BillToContact, SoldToContact, etc.

Resolved issue: Issue with Collapse or Expand Quote Panel and Subscription Panel in Quote Studio

As of Quotes version 10.8, we introduced support to configure the Quote Panel and Subscription Panel to collapse or expand during page load from the Quote Studio Settings Page for New, Renew, Amend, and Cancel subscription flow. You might have encountered issues with this feature when creating a quote for a new billing account. This issue has been resolved.

In Quotes version 10.10.2, the Quote Panel and Subscription Panel will now respect the settings under Zuora Config > Quote Studio Settings > Component Layout Config.

Note that the Quote and Subscription Panels are set to expand by default.

Resolved issue: Bill to Contact and Sold to Contact fields are not auto-populated when creating a quote for an existing billing account

Previously, when you create a quote for an existing billing account, you might have encountered that the Bill to Contact and Sold to Contact fields were not auto-populated. This is because when you type mailing addresses in Salesforce contacts, Zuora splits the address into two fields. As a result, Salesforce contact information does not match Zuora tenant billing information. This issue has been resolved.

Resolved issue: Bill to Contact and Sold to Contact fields default to the first contact in the list when creating new quote

Previously, when you created a new quote, the Bill to Contact and Sold to Contact fields were automatically populated with the first contact in the list. This issue has been resolved.

Resolved issue: OpportunityId value missing on BillingAccountPlugin when creating a quote from opportunity in CPQ X

Previously, you might have noticed that OpportunityId value missing from BillingAccountPlugin when creating a new subscription quote from an opportunity. This issue has been resolved. 

Release 10.10.1 (Release Date: 2022-09-14) 

The 10.10.1 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Support for creating Drawdown charges along with Prepaid charges in CPQ X

CPQ X now allows you to create a quote with Drawdown charges along with Prepaid charges.

See Create Prepaid Subscription for more information.

Support for configuring Subscription object fields in Quote Studio

CPQ X now allows you to configure the display of Subscription object fields in Quote Studio using the Object Fields Config settings in Zuora Config > Quote Studio Settings.

For more information, see Configure Quote Studio field editability based on quote type.

Resolved issue: Unable to create new subscription quote with Renewal Term of zero in CPQ X

Previously, when creating a new subscription quote with Renewal Term set to zero, you would encounter a warning indicating The number is too low under the Renewal Term field. This issue has been resolved.

In Quotes version 10.10.1, you can now create a new subscription quote with a Renewal term of zero months to indicate a non-renewable quote.

Resolved issue: Remove product action for new and amended quotes has an incorrect effective date

Previously, you may have encountered incorrect effective dates when removing products from new and amendment quotes. This issue has been resolved.

In version 10.10.1, for a new subscription quote, the effective date of the Remove Product Action will default to the day following the Contract Effective Date of the Add Product Action. For example, if the Contract Effective Date of the Add Product Action is June 1 (N), then the effective date for Remove Product Action will be June 2 (N+1).  

For amendment quotes, the Contract Effective Date of the Remove Product Action on an Original Product will default to the Quote Start Date. For example, if the Quote Start Date is June 1, then the default effective date for the Remove Product Action will also be June 1.

Additionally, suppose the setting Prohibit Backdated Actions is not enabled. In that case, it will be possible to create a Remove Product Action as early as the same date the original product was added to the subscription (this could result in a chargeback scenario, as you may be backdating the removal of a product that has been billed for).

In the case of a newly added product on the amendment quote, the Remove Product Action will default to N+1 (where N is the contract effective date of the Add Product Action), and it will not be possible to set the Remove Product Action to occur before N+1. This means a Remove Product Action cannot occur the same day as an Add Product Action for the same product. 

If you would like to delete a newly added product from an Inflight Quote, please use the X icon on the right side of the product table.

Resolved issue: Default picklist value not populating in the custom field when creating a new subscription quote

Previously, you might find that if you set a default picklist value for the custom field in Quote Studio fieldset, the configured default picklist value would not populate in the custom field when creating a new subscription quote. This issue has been resolved.

Resolved issue: Incorrect currency in List price and Effective price when currency field is removed from the CPQX_Subscription_Billing fieldset on Quote object

Previously, if you enabled currency other than USD and removed the currency field from the CPQX_Subscription_Billing fieldset from the Quote object, in that case, you may have encountered currency displayed as USD instead of the original currency in the List price and Effective price in the Quote Studio UI.

Resolved issue: Error when entering decimal values in charge fields that are not present on the Display Scale Settings page

Previously, in Quote Studio when you entered decimal values in charge fields, you would encounter an error if the respective charge field (for example - Included Units) was not present on the Display Scale Settings page. This issue has been resolved.

In Quotes version 10.10.1, the charge fields that are not present on the Display Scale Settings page are not restricted to whole numbers. With this enhancement, you have the flexibility to add decimals according to your field definition requirements.

Resolved issue: Error when creating an amendment quote against a Subscription with a future dated Service Activation Date (SAD) or Contract Acceptance Date (CAD)

This relates only to Quote Studio and Pending Subscription functionality.

Previously, when you create an amendment quote against a Subscription with a future dated Service Activation Date (SAD) or Contract Acceptance Date (CAD), you might encounter the following error message: Error Processing Quote At Previewing: Code: 58730030, Message: The contract effective date should not be earlier than the customer acceptance date of the basic subscription. This is because the Quote Start Date aligns with the Contract Effective Date of the Amendment when creating an amendment quote. Also, it is not possible to update a subscription before its Service Activation Date or Customer Acceptance Date (if SAD/CAD are set to required in Zuora Billing Settings).

In Quotes version 10.10.1, When you create an amendment quote, the Quote Start Date will now be aligned with the Service Activation Date (SAD) or Contract Acceptance Date (CAD), whichever is later. Whenever you attempt to change the Quote Start Date before Service Activation Date (SAD) or Contract Acceptance Date (CAD), whichever is earlier, you will see a below Warning pop-up message.

Resolved issue: Incorrect calculation/proration of charges when the Quote Start Date is moved after the Ramp Deal is created and saved

Previously, when a Ramp Deal was created and saved, and the Quote Start Date was changed, you may have encountered an incorrect calculation/proration of charges. This is because the Specific Update Date field on subsequent intervals was not updated (on the backend) when the Quote Start Date was changed. This issue has been resolved.

Resolved issue: Blank or empty update product actions created on amendment quote when clicking custom Quote Rate Plan object field in the product table

Previously, when adding Quote Rate Plan Charge object custom fields in the Display Charge Fields Fieldset in Salesforce, you might have encountered the issue of blank or empty Update Product Quote Amendments being created even if you did not update any value in the Quote Studio when clicking into a field. This issue has been resolved.

In version 10.10.1, an Update Product Quote Amendment is only created when you make a valid change to custom fields on the Quote Rate Plan Charge object in Quote Studio.

Resolved issue: Loading issue when creating amendment and renewal quote

Previously, with Zuora__Status__c field was removed from the Zuora__fields_for_select_billing_account_compon fieldset on the Zuora__Subscription__c object, you may have encountered a loading issue while creating amendment and renewal quotes. This issue has been resolved.

In version 10.10.1, Zuora__Status__c field is not mandatory in the Zuora__fields_for_select_billing_account_compon fieldset.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: Field validation not performed for Initial Term and Renewal Term fields in CPQ 9 (legacy UI)

Previously, you may have encountered an issue with field validation for Initial Term and Renewal Term fields when creating a quote. This issue has been resolved.

In Quotes version 10.10.1, we have applied a field validation rule to all fields in the legacy UI. Therefore, whenever you enter a value in a field, the field validation rule checks the value you entered when Next button is selected. 

Release 10.10 (Release Date: 2022-08-31) 

The 10.10 release includes the following enhancements and resolved issues.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Salesforce Winter ‘23 Validate Getter and Setter Access Modifier Enforcement caused issues for customers using a specific configuration of the Quote Wizard in legacy CPQ UI

On August 26th, Salesforce began to enforce a feature within the Winter ‘23 release on all Sandbox orgs known as Validate Getter and Setter Access Modifier Enforcement during Visualforce Expression Language Parsing.

Due to an incompatibility with this feature, you may have encountered errors when attempting to create Quotes with a very specific configuration to which custom pages were being directed within the Quote Wizard Flow. The following two KC articles describe those specific configurations:

The following error messages may have been seen when that Salesforce feature began to be enforced:

  • Unknown property 'zqu.CreateQuoteController.paramBackPageUrl'
  • Unknown property 'zqu.PropertyComponentController.FieldWrapper.label'
  • Unknown property 'zqu.LookupComponentController.isValueRequired'

On September 6th, Salesforce acknowledged there were issues with that specific feature they began to enforce in Sandbox Orgs as part of Winter ‘23, and they reverted enforcement of that feature for all orgs. Salesforce has explained that this feature’s release “will be postponed indefinitely and is not enforced in its present form”. See  Salesforce documentation for more information. 

In version 10.10, we have resolved all incompatibility issues associated with the Validate Getter and Setter Access Modifier Enforcement During Visualforce Expression Language Parsing update in case Salesforce does decide to enforce this feature in the future. If you are using one of the aforementioned custom Quote Wizard configurations, you will need to upgrade to version 10.10, at least, to remain compatible. 

Release 10.9.2 (Release Date: 2022-09-08) 

The 10.9.2 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Resolved issue: Newly created custom formula field does not display its values on the Product and Charges selector page

Previously, when creating an amendment quote, you might have encountered an issue where newly created custom formula fields on the Zuora__SubscriptionProductCharge__c (Subscription Product & Charge) object did not display values. This issue has been resolved.

Release 10.9.1 (Release Date: 2022-08-30) 

The 10.9.1 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Enhancements to product selector table UI

In version 10.9.1, we have improved the UI of the product selector table. With this enhancement, you can now add the List Price Base field on the Quote Rate Plan Charge object in the product selector table UI. The field will appear as editable when it is displayed.

If you want to display the List Price Base field in the UI, you need to add the field to the CPQX_Charge_Display_Fields fieldset.

Enhancements to UOM (Unit Of Measurement) name display in the product selector table

Previously, the UOM name text would continue into the next column without text wrapping and appear incorrectly with underscores in the product selector table.

In version 10.9.1, the UOM name is now correctly displayed in the product selector table with improved user experience. To display the UOM name correctly, you should give the label name and API name without underscores in Zuora UOM settings.

Support for custom label for New Quote button on Billing Account Selection page in CPQ X

In version 10.9.1, using custom label, you can now translate the New Quote button on the Billing Account Selection page to different languages.

New Quote Button label is NEW_QUOTE_LABEL.

Enhancements to pending subscriptions in CPQ X

In version 10.9.1, a preview feature is now available for pending subscriptions with Upon Contract Effective as the trigger event when rate plan charges have trigger events as Upon Service Activation or Upon Customer Acceptance.

To preview Pending Subscription, you need to enable the Preview Pending Subscription setting by navigating to Zuore Config > Quote Studio Settings > Admin Config.

Resolved issue: Newly added Product Action is not visible on the confirmation page when amending a subscription

Previously, you might not be able to see the Newly added Product Action on the confirmation page when creating an amendment quote. This issue is now resolved.

Resolved issue: Error when creating amendment quote due to character limit discrepancy for rate plan charge description

Previously, if you created a subscription in Zuora with a rate plan charge description longer than 255 characters and tried to amend that subscription in Salesforce, you would encounter an error. It was because Zuora allows 500 characters for the rate plan charge description to be stored within the system, while Salesforce only allows 255 characters.

To solve this issue, a character limit validation has been added to discard extra characters if it exceeds 255 characters when creating a Quote Rate Plan Charge record in Salesforce.

Resolved issue: Generate Invoice and Process Payment fields not synced with Quote Configuration Settings

Previously, when you create a new, amend, or renew quote, the Generate Invoice and Process Payment fields are unchecked by default, even if they are set to true in Quote Configuration Settings. This issue is now resolved.

In version 10.9.1, the Generate Invoice and Process Payment fields are aligned with Quote Configuration settings.

Resolved issue: Currency price value for product rate plans not appearing when creating a quote in CPQ X

Previously, when creating quotes, you might have noticed that currency price value for product rate plans did not appear in the Quote Studio product selector. This error occurred due to internal changes in Salesforce. This issue is now resolved.

Release 10.9 (Release Date: 2022-08-17) 

The 10.9 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Enhancements to clone quote feature in CPQ X

Previously, when you cloned a new subscription quote, amended quote, or renewal quote, the approval status of the cloned quote record was also cloned.

We have enhanced the cloning feature in version 10.9, so the approval status of the respective quote record will not be cloned when cloning a quote record. On the Quote object, we have also added a new field called "Is Cloned", which indicates whether the quote record has been cloned.

Enhancements to subscription history panel

In Quotes version 10.9, When you change the Invoice Owner, the CPQ X Subscription Change History panel will be updated accordingly. You can now view the Invoice Owner Transfer amendment history within the CPQ X Subscription Change History panel.

Support for creating pending subscriptions in CPQ X

In CPQ X, you can now create pending subscriptions and set activation dates for the pending subscriptions.

See Pending Subscription for more information

Support for user profiles in quick filters

In Quotes Version 10.9, you can define user profiles while creating quick filters under Product and Quick Filters setting.

We have introduced a new toggle called Select Specific Profiles. If the Select Specific Profiles toggle is set to active, it will show all the profiles associated with the account. By default, the created quick filter will be visible to all profiles.

After upgrading to 10.9, you may find user profiles. If you had configured Quick Filters before upgrading, the filters would no longer appear in the Product Selector. You can fix this by opening each Quick Filter and saving it without making any changes, and the filters will appear again in the Product Selector.

To define user profiles to quick filters, take the following steps:

  1. In your Salesforce org, navigate to Zuora Config > Quote Studio Settings > Product & Quick Filters.
  2. Switch on the toggle Select profile, and all associated profiles will pop up.
  3. Select the profiles you want to apply this filter to.
  4. Click Save.

New UX for sorting Quick Filters

In Quotes version 10.9, you can now drag and drop existing Quick Filters to re-order them. 

To do so, take the following steps:

  1. In your Salesforce org, navigate to Zuora Config > Quote Studio Settings > Product & Quick Filters.
  2. Click Update Order.
  3. Drag and drop the existing quick filters to re-order.
  4. Click Save.

New read-only quote detail page for lightning experience

In Quotes version 10.9, for Lightning experience, we have created a new read-only Quote Detail Page. You can configure this new Quote Detail Page using fieldsets.

You can now add custom fieldsets to the quote summary section of your lightning page and define custom components.

See Quote Detail Page for Lightning Experience for more information.

Resolved issue: “Attempt to de-reference a null object” error in CPQ X

Previously, when you send a Quote to Zuora, you might encounter Attempt to de-reference a null object error. This is because, in Zuora, the Bill To Contact's Address 1 field is not synced with Salesforce. This issue is now resolved.

Resolved issue: ContactTrigger does not function as expected when the MailingState or MailingCountry are updated

Previously, you might have encountered an issue with ContactTrigger when updating MailingState or MailingCountry. This issue is now resolved.

As of version 10.9, the trigger code will take into account MailingState and MailingCountry if the Salesforce organization has state and country picklist values enabled.

Resolved issue: Remove Product Action is aligned with Quote Start Date (QSD) in different time zones

As of version 10.7, the effective date of the Remove Product Order Action has been set to the day following that of the Add Product Order Action. You may have encountered errors with this enhancement in some time zones. This issue is now resolved.

Now, this enhancement will work across all time zones uniformly.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Default action dates configurability for amendment quotes in CPQ 9

For better configurability and usability of amendment quotes, we have introduced a new setting called View/Update Amend Quote as of Quote Start Date under Zuora Config > Advanced Quoting Configuration Settings.

When this setting is enabled, updates to Original Charges in CPQ Product Selector will be aligned with Quote Start Date instead of Subscription Term Start Date for amendment quotes.

Note that View/Update Amend Quote as of Quote Start Date setting must be used in conjunction with Enable Orders and Store Existing Products settings.

See Advanced Quoting Configuration Settings for more information.

Roll back of functionality released in 10.7 and 10.8.3 to change the behavior of Renewal Quotes when using the Initial Term field and Renewal Term field

In version 10.7, the Initial Term field was made editable on Renewal Quotes and was intended to be used as the Current Term for a Renewal Quote. This caused unforeseen inconsistencies in order action behavior and is being rolled back in 10.9. 

As of version 10.9, the Initial Term field under Terms and conditions becomes read-only when creating a Renewal Quote. The Renewal Term field will control the Current Term of the Renewal Subscription. 

Resolved issue: Renewal setting is set to "Renew With Specific Term" by default

Previously, when you selected Renew To Evergreen in Renewal Setting and submitted your quote, the renewal setting value defaulted to Renew With Specific Term in CPQ 9. This issue is now resolved.

Release 10.8.3 (Release Date: 2022-08-09) 

The 10.8.3 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Resolved issue: Error occurs when using Lightning page URL in preview version

Previously, when you used Lightning page URL in the preview version, you might encounter the following error: Redirection Error: URL for Next must begin with /apex/. An unexpected error has occurred. Your solution provider has been notified. (zqu). This issue has been resolved in this release.

Note that this issue was only seen or reported by one customer.

Resolved issue: “Illegal assignment from String to Decimal” and “SObject row was retrieved via SOQL without querying the requested field” errors in CPQ X

Previously, when adding a number type field to the Custom Charge Fields fieldset on the Quote Rate Plan Charge object, you might encounter the following errors: “Illegal assignment from String to Decimal” and “SObject row was retrieved via SOQL without querying the requested field”. This issue is now resolved.

Note that no additional step of adding a field to the "Display Charge Fields" fieldset is required.

Resolved issue: Unwanted TermsandConditions amendment object is created when renewing a quote

Previously, when renewing a quote, if the original subscription's Initial Term and Renewal Term are different, an unnecessary TermsandConditions type amendment object was created. This issue is now resolved.

Note that in a Renewal Quote, the Initial Term field will always be aligned with the Renewal Term field value from the original subscription. This means that the TermsandConditions amendment object will only be created if the subscription's Initial Term and Renewal Term are changed.

Resolved issue: Incorrect rounding of Total price

Previously, you might have encountered the incorrect rounding of Total calculated at Quote Rate Plan Charge price even if you enabled “Send Rounded Figures to Zuora” in Display Scale Settings. This is because the Total price is calculated using a non-rounded price and quantity. This issue is now resolved.

Now the Total price will be calculated as Total Calculated Price = Effective Price (Rounded) * Quantity.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Supported jQuery versions

The following table lists the deprecated and supported versions of jQuery in Zuora Quotes managed package versions.

Quotes version Supported jQuery version Deprecated jQuery version
10.7 and above jQuery-ui-1.13.1.js jQuery-ui-1.12.1.min.js
10.4 to 10.6.1 angular-animate.1.8.2.js angular-animate.1.3.15.js
9.32.2 to 10.3.1 datatables-1.10.23.min.js,
jQuery-ui-1.12.1.min.js,
jQuery-3.5.1, and
jQuery-migrate-3.3.2.min.js

jQuery-UI-1.10.2.js,
jQuery-ui-1.10.3.custom.js,
jQuery-1.9.1, and
jQuery-1.4.2.resource.js

See Supported jQuery versions for more information.

Release 10.8.1 (Release Date: 2022-07-26) 

The 10.8.1 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Support to sync prepaid drawdown product rate plan charge with CPQ X

In version 10.8.1, you can now sync prepaid drawdown product rate plan charge with CPQ X. In the current version of CPQ X, creation of drawdown charge is not supported.

See Notes and limitations for more information.

Enhancements to Product Selector modal UI in Quote Studio

In version 10.8.1, we have added descriptions for the Products and Rate plans on the Product Selector Modal. By default, the descriptions are displayed in two lines. The full description will be displayed in the blue text box when you hover over the description part.

Support for creating custom fields with Multi-Select Picklist in CPQ X

In version 10.8.1, you can add custom fields with Multi-Select Picklists to the Quote Studio UI.

Note that there will be no mapping between custom fields with Multi-Select Picklists and Zuora custom fields.

Support for restricting access to create Future Dated Remove Product action

In version 10.8.1, you can now restrict the access to create the Future Dated Remove Product Action to specific profiles for New, Renew, Amend, and Cancel Subscription flow.

To do so, take the following steps:

  1. In your Salesforce org, navigate to Zuora Config > Quote Studio Settings > Restricted Access Config.
  2. Select Future Dated Remove Product from the Feature Name dropdown field.
  3. Select the profiles using the Multi-Select Picklist under the Profiles dropdown.
  4. Tick in the required quote flow type (New, Amend, Renew, and cancel).
  5. Click Save. Quote studio will not display the selected feature for the selected profile.

Resolved issue: Custom option is missing in the dropdown for Ramp Frequency Default Value

Previously, you may have noticed that the Custom option is missing in the dropdown menu for Ramp Frequency Default Value. This issue has been resolved in this release.

The Ramp Frequency Length can be set to Custom by navigating to Zuora Config > Quote Studio Settings > Default Settings > Ramp Frequency Available Values section. All values in the Ramp Frequency Available Values dropdown are selected by default, and the Quote Studio UI shows them all.

Resolved issue: Error occurs when canceling a quote

Previously, when canceling a quote, you might encounter the following error: Cannot perform DML instruction, while prepareAn unexpected error has occurred. Your solution provider has been notified. (zqu). This issue has been resolved in this release.

Resolved issue: Differences in the field label naming convention

Previously, you might have encountered differences in the field label naming convention. For example, if the field label is Quote ID you must have noticed that by truncating the ID, the field will display as Quote. This issue has been resolved in this release.

Resolved issue: Incorrect calculation of discount and effective price on Quote Rate Plan Charge when applying charge level discount to a tiered license product

Previously, When applying a charge level discount to a tiered license product, its effective price and discount were incorrectly calculated on the Quote Rate Plan Charge. This issue is now resolved.

Resolved issue: Incorrect rounding of Effective Price and Total values

Previously, you may have encountered the incorrect rounding of Effective Price and Total values. This issue is now resolved.

Now, when you enable Send Rounded Figures to Zuora setting, rounded-off values (Effective Price, Total) will respect the scale settings, and the rounded-off values are stored on the object in Salesforce and sent to Zuora. Additionally, the values are saved on the Quote Rate Plan Charges and Quote Charge Tiers.

Resolved issue: Error occurs when creating or viewing amendment quote

Previously, when adding a number type field to the Custom Charge Fields fieldset on the Quote Rate Plan Charge object, you might encounter the following error: Illegal assignment from String to Decimal. This was due to the fact that Zuora only supports custom fields of type Picklist, Text Field, and String; now, if a field type other than those three is added to the Custom Charge Fields fieldset, it will be ignored and not sent to Zuora, thus avoiding the error.

Release 10.8 (Release Date: 2022-07-14) 

The 10.8 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Support for customizing metric fields in Sidebar Metrics Panel

Now, in Quote Studio you can add custom quote metrics to be displayed in the Sidebar Metrics Panel. This enhancement allows you to customize the metric fields to meet your business requirements. Note that only the following types of fields can be added:

  • Number type, including the Formula fields of the Number type
  • Currency type

To do so, take the following steps:

  1. Click Setup icon and select Setup. The Setup homepage opens.
  2. Click the Object Manager tab. 
  3. Find the Quote (zqu__Quote__c) and click the object label. 
  4. Click Field Sets in the left navigation menu.
  5. Find the CPQX Sidebar Metrics Panel fieldset.
  6. Drag and drop the field you want to add from the box at the top to the Field Set box. If you want to remove a field, hover over the field you want to remove in the Field Set box and click icon_removeField
  7. (Optional) Drag the fields up and down in the Field Set box to adjust the display order.
  8. Click Save. The new custom field is then added to the selected field set, which will be reflected in the corresponding section on the Quote Studio page.

Enhancements to Plugins User Interface

Previously, Billing Account Plugin and Lookup Filter Plugin were located on the Admin Config tab, and Default Value Plugin was located on the Default Settings tab.

In version 10.8, all three plugins have been merged under a new tab labeled Plugins.

To locate: Navigate to Zuora Config > Quote Studio Settings > Administration > Plugins.

Support for configuring Ramp Interval Length dropdown values in Quote Studio

CPQ X now supports configuring Ramp Interval Length dropdown values in Quote Studio. The Ramp Frequency Length can be configured by navigating to Zuora Config > Quote Studio Settings > Default Settings > Ramp Frequency Available Values section. With this setting configured, you can control which values are displayed when Ramp is enabled.

Note that this new option is available after upgrading to this package; you will need to set Ramp Frequency Available values.

Support for custom ramp deals with user-specified intervals in CPQ X

CPQ X now supports custom ramp deals with user-specified intervals. We have introduced a new option named "Custom" under the Ramp Interval Length input field as shown below for the New, Amend, and Renew Quote process.

When you select "Custom" in the Ramp Interval Length, it displays another input field named "Number of Intervals" with values ranging from 2 to 12 (2 being the minimum and 12 being the maximum). This field allows you to specify how many intervals you want to break down the entire subscription into. Depending on the Ramp Interval Length selected, the "Details" section will display a given number of Interval start and end dates.

.     

We made the “Details” section look chronological by enabling the Interval 2 Start Date first and disabling the others. If you enter a value in the Interval 2 Start Date input field, then the Interval 3 Start Date input field will be enabled, and so forth.

Interval 1 Start Date and Interval last end date fields are auto-calculated and populated and are read-only.

Quote type Description
New Interval 1 Start Date is the Quote Start Date specified, and Interval Last End Date is calculated based on the Initial Term Length defined.
Renewal Interval 1 Start Date is the Subscription Term Start Date, and Interval Last End Date is calculated based on the Initial Term Length defined.
Amendement Interval 1 Start Date is the Subscription Term End Date, and Interval Last End Date is calculated based on the Initial Term Length defined.

Note: Based on the subsequent interval start dates you define, intermediate interval end dates are automatically calculated. For example, assume you define Interval 2 Start Date as 10 Jan 2022, Interval 1 End Date will be automatically calculated as 09 Jan 2022.

Note that the below fields are the driving factors for your custom ramp intervals and thus significantly impact your intervals if any changes are made. If you change any of the below fields after defining ramp intervals and adding products to specific intervals, the system will automatically discard the ramp intervals you defined and the added products to the timeline.

  • Changing the Quote Start Date
  • Disabling the Ramp option
  • Changing the Initial Term
  • Changing the Number of Intervals

Enhancements to Field Logic Composer User Interface

In version 10.8, we have made changes to normalize our Quote Field Rule object data. With this enhancement, we eliminated data redundancy, resulting in good performance and giving admins more flexibility when creating field rules in the Zuora Config > Quote Studio Settings > Object Fields Config section.

Previously, as shown below, you had to create duplicate entries (OBJECT + FIELD) to make the same field behave differently depending on the quote journey (e.g., new, amend, renew, cancel).

Now in version 10.8, you can create a single entry (OBJECT + FIELD) to make the same field behave differently depending on the quote journey (e.g., new, amend, renew, cancel).

As part of the above enhancement, we have also added the following validation checks to prevent duplicate data from being created.

  1. You cannot save duplicate settings containing the same OBJECT + FIELD. The following warning pop-up will appear if you create duplicate entries and click Save.

  1. You cannot save the data when OBJECT + FIELD is defined, but no properties are associated with any of the quote journeys (e.g., new, amend, renew, cancel). The following warning pop-up will appear if you click Save with no properties defined.

Support for creating Prepaid Subscriptions

CPQ X now supports the creation of Prepaid subscriptions (New, Amend, Renew, and Cancel). 

As described here, you can now add a Prepaid Product Rate Plan Charge in Zuora and sync it with CPQ X through Zuora 360 or Zuora 360+ Sync to create Prepaid subscriptions. 

See Create Prepaid Subscription for more information.

Support to Collapse or Expand Quote Panel and Subscription Panel in Quote Studio

With this new feature in CPQ X, you can configure the Quote Panel and Subscription Panel to collapse or expand during page load from the Quote Studio Settings Page for New, Renew, Amend, and Cancel Subscription flow.

Note that the Quote and Subscription Panels are set to expand by default.

To do so:

  1. In your Salesforce org, navigate to Zuora Config > Quote Studio Settings > Component Layout Config.
  2. Configure component state based on the Quote flow type using the dropdown options (Expanded or Collapsed).
  3. Click Save.

Support to configure modal pop up when Quote Start Date is moved after product selection

Previously, a modal popup appears with three choices to prevent errors when adding or updating products to a subscription and changing the Quote Start Date.

In Quotes version 10.8, you can now customize the default option you want to see or execute in CPQ X UI when you add or update products on the subscription and change the Quote Start Date.

To configure take the following steps:

  1. In the navigation bar, navigate to Zuora Config > Quote Studio Settings.
  2. In the left pane, select Default Settings
  3. Select the dropdown option from “Define the default product alignment when Quote start date is changed after products are added” under the Subscription category. The dropdown options are:
    1. None
    2. Align all Initial Actions of any Rate Plan timelines to Quote Start Date
    3. Initial Actions of any Rate Plan timelines will not be moved
    4. Align all Initial Actions of any Rate Plan timelines to Quote Start Date, and eliminate all future dated segments of RatePlans

  1. After selecting “Define the default product alignment when Quote start date is changed after products are added”, another toggle input field named "Show Quote Start Date" Pop-up will appear, which determines whether or not the modal popup will display on Quote Studio UI.
Field Status Description
Show Quote Start Date Active

You will always see a modal popup with the option selected by default in the Define the default product alignment when Quote start date is changed after products are added” field.

Inactive

You won’t see a modal popup, but with the option selected in the Define the default product alignment when Quote start date is changed after products are added” field, the actions will be performed on the newly added/updated product trigger dates.

 

  1. Click Save at the top right in the main region to save the configuration.

Resolved issue: Product selector page showing different views (link and values) of charges in Rate Plan Details

Previously, the Charge Model name was displayed in the Product selector section as charges when the List price was 0 or null and as values when the List price was greater than 0. This issue is now resolved.

In version 10.8, the Charge Model names will now only be displayed if the product is tier-based, otherwise, the amount will be displayed.

Resolved issue: Validation of Service Activation Date (SAD) and Customer Acceptance Date (CAD) at Quote Level is incorrect

Previously, the Customer Acceptance Date (CAD) was aligned with the Quote Start Date (QSD). This issue is now resolved.

In version 10.8, if you change the Service Activation Date (SAD) to a future date, the Customer Acceptance Date (CAD) will realign the Service Activation Date (SAD) regardless of whether the Service Activation Date (SAD) field is displayed in the user interface.

Resolved issue: Add-on products added by rules engine are not showing up on Quote Studio page

Previously, add-on products added by the rules engine were not showing up on the Quote Studio page when you navigated through the New Quote button and Amend/Renew/Cancel icons from a specific subscription. This issue is now resolved.

In version 10.8, the CPQ_X rules engine will be explicitly executed if an organization has a rules engine enabled. 

Note that the preview calls do not occur immediately after rule execution. The preview call only happens when you save/submit the quote or make changes to the Quote Studio UI.

Resolved issue: Error occurs when saving a Quote

Previously, when saving a quote, you might encounter the following error: Cannot deserialize instance of double from START_OBJECT value. This issue has been resolved in this release.

Resolved issue: Quote record is not deleted when the Back button is clicked without saving

Previously, when navigating from CPQ 9 to Quote Studio, the Quote may not get deleted because the logic to delete the Quote object failed. This issue is now resolved.

In version 10.8, if you create a Quote record and make changes to it, clicking the Back button without saving displays a warning dialog that lets you delete the Quote record.

Resolved issue: Original Product Effective Date is incorrect for Renewal Quote in CPQ X

Previously, when creating a renewal quote, the Original Product Effective Date did not match the renewal term's start date but instead displayed the original quote start date. This issue is now resolved.

Resolved issue: Incorrect calculation of effective price on Quote Rate Plan Charge when adding a tiered license as a product on a quote with an Inline discount

Previously, When applying an Inline discount to a tiered license product, its effective price was incorrectly calculated on the Quote Rate Plan Charge that excluded the Inline discount. This issue is now resolved.

Resolved issue: Contract Effective Date of Remove Product Order Action is set to Quote Start Date (QSD) +1 in CPQ X

Previously, the effective date of the Remove Product Order Action will default to the day following the Add Product Order Action start date. For example, if the Quote Start Date is June 1 (N), then the effective date for Remove Product Action will be June 2 (N+1). This issue is now resolved.

In Quotes version 10.8, the effective date of Remove Product Action is aligned with the Quote Start Date (QSD). For example, if the Quote Start Date is June 1, then the effective date for Remove Product Action will also be June 1.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: Duplicate charges on the Select Products screen when renewing a quote in CPQ 9

Previously, when you create a renewal quote, you may encounter duplicate charges on the Select Products screen in CPQ 9. This issue is now resolved.

End of Support for Early Versions (6.4 or earlier) of Zuora Quotes

Starting on January 31, 2023, Zuora Quotes version 6.4 or earlier will be deprecated, and you won’t be able to access them from your account.

Refer to Zuora CPQ Deprecation Policy for more information.

Release 10.7.1 (Release Date: 2022-06-20) 

The 10.7.1 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Resolved issue: Unable to create Update Product Action on Renew or Amend subscription for Ramp deal

Previously, when you create Update Product Action, you may encounter an issue with the Create Mid-Interval Update Required Fields dialog box appearing. This issue has been resolved now.

Resolved issue: Loading issue when clicking Browse Products button, and an error appears when clicking X to cancel

Previously, when you click Browse Products button, you might encounter a loading issue, and if you click X to cancel, you might encounter the following error: [LWC component's @wire target property or method threw an error during value provisioning. Original error: [Cannot read properties of undefined (reading 'includes')]] Failing descriptor: {markup ://zqu:commonUtils}. This issue has been resolved in this release.

Resolved issue: ‘Either ‘previewAccountInfo’ or ‘existingAccountNumber’ need to be specified’ error in CPQ X

Previously, when you land on the Billing Account Selector page to amend, renew or cancel the quote, you might encounter Either ‘previewAccountInfo’ or ‘existingAccountNumber’ need to be specified error. This issue has been resolved now.

Resolved issue: When creating an amendment or renew quote, the List Price (USD) and Discount % values are not same as their original subscription values

In Quotes version 10.7, when you create an amendment or renew quote, List Price (USD) and Discount % values are not the same as their original subscription values. This is because List Price (USD) value was derived from the Effective Price instead of the Product Catalog. This issue has been resolved.

Resolved issue: Unable to create Quote Charge Tiers in CPQ X

Previously, if you did not have access to create new Quote Rate Plan Charge, you could not add Charge Tiers to Quote. This issue has been resolved.


In Quotes version 10.7.1, you can add Charge Tiers to Quote even if you do not have access to create new Quote Rate Plan Charges.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: When renewing a subscription, original products are showing the incorrect effective date on the Product Selector page in CPQ 9

Previously, when renewing a subscription, CPQ 9 incorrectly displays the effective date of original products on the Product Selector page. This issue has been resolved in this release.

Release 10.7 (Release Date: 2022-06-13) 

The 10.7 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Enhancements to Remove Product Action in Quote Studio

Previously, the effective date of Remove Product Action was aligned with the product start date. Due to this behavior, whenever you confirm the product removal, you might receive a JavaScript error that prevents you from saving or submitting the Quote.

In Quotes version 10.7, the effective date of the Remove Product Order Action will default to the day following the Add Product Order Action start date. For example, if the Add Product Start Date is June 1st (N), then the effective date for Remove Product Action will be June 2nd (N+1). This is because a product cannot be added or removed on the same day within the same Quote. Use the “X” icon if you would like to Delete an RP Timeline (Quote Line Item) from the Inflight Quote.

Enhancements to One-Time Charges

In Quotes version 10.7, we removed the Remove Product Action-Trash Can Icon for One-time charges under Rate Plan to prevent you from creating Remove Product Action on One-time charges. This is because the Trash Can icon’s purpose is to create Future Dated Remove Product Actions, and a One-Time Charge is not recurring in nature and thus will only be effective once upon its trigger condition. Use the “X” icon if you would like to Delete a One-Time Charge from the Inflight Quote.

Note that the Remove Product Action-Trash Can Icon is only available for one-time charges that are contained within RatePlans with Recurring Charges. 

Enhancements to CPQ X validation when adding or updating products on the subscription and changing the Quote Start Date

Previously, when adding or updating products to a subscription and changing the Quote Start Date; the Customer Acceptance Date (CAD), Service Activation Date (SAD), and Quote Start Date (QSD) were only validated when you clicked the Save or Submit button. 

In Quotes version 10.7, validations will happen as soon as you change the Customer Acceptance Date (CAD) or the Service Activation Date (SAD) to ensure that appropriate date sequencing is always respected - i.e., SAD can never be before CAD, and CAD can never be before SAD.

Enhancements to Quote Studio Settings

As of version 10.5, the setting in Zuora Config > Quote Studio Settings > Admin SettingsView Amendment Quotes as of Quote Start Date was temporarily hidden to address further testing. 

In version 10.7, we have re-instated the View Amendment Quotes as of Quote Start Date setting. With this setting enabled, on an amendment quote, CPQ X will display the Amendment Quote with any actions that are active as of the Quote Start Date (or remain in the future from the Quote Start Date).  

Enhanced Display Scale Settings functionality

In Quotes version 10.7, we have introduced a new setting called Send Rounded Figures to Zuora under Display Scale Settings. 

With this setting enabled, the rounded-off values are stored on the object in Salesforce and sent to Zuora.

To configure this setting:

  1. Navigate to Zuora Config > Display Scale Settings.
  2. Enable Send Rounded Figures to Zuora setting.

Note that this setting works in both CPQ 9 and CPQ X; by default, it will be disabled. The recommended best practice is to send all decimals to Zuora regardless of what is configured to display in the CPQ UI to allow Zuora to execute rounding sequences as defined in this KC Article. However, this setting recognizes a desire to round decimals based on what is seen in the CPQ UI and save those rounded figures to the Quote objects in Salesforce. 

Support for Configuring/Customizing CPQ X Quote Studio for Prepayment product structure

In Quotes version 10.7, as a part of the Prepaid Drawdown initiative, we have introduced the below fields on the Product Rate Plan Charge and the Quote Rate Plan Charge.

Product Rate Plan Charge:

The following fields were added to the fieldset in Product Rate Plan Charge object → PrePaymentRules:

  • PrepaidOperationType__c
  • PrepaidQuantity__c
  • Prepaid_Total_Quantity__c
  • PrepaidUOM__c
  • sPrepaid__c
  • ValidityPeriodType__c
  • CreditOption__c
  • DrawdownRate__c
  • DrawdownUom__c

Quote Rate Plan Charge:

The following fields were added to the fieldset in Quote Rate Plan Charge object  → CPQX_Charge_Display_Fields:

  • IsPrepaid__c
  • PrepaidOperationType__c
  • Prepaid_Quantity__c
  • PrepaidTotalQuantity__c
  • PrepaidUOM__c
  • Prepaid_Validity_Period_Type__c

Note: As part of Quotes version 10.6 and 10.7, only the new fields have been added; prepaid functionality to create prepaid charges will be included in an upcoming release.

Support for adding Quote Ramp Interval fields to Quote PDF

Now, you can see the Quote Ramp Interval object records in Quote PDF by adding Quote Ramp Interval fields to the Quote PDF template. The feature is also available in Quotes version 10.6 but is dependent on the 2022.06.R3 Zuora Billing Release.

Below are the required tags to add Quote Ramp Interval fields to the Quote PDF template.

  • TableStart:QuoteRampIntervals
  • QuoteRampInterval.FieldName

Based on the 2022.06.R3 Release, Quote Ramp Interval objects will be available in the Quote PDF after the below dates:

Sandbox Production
June 14 - 16, 2022 June 21- 23, 2022

Support for Guided Selling Flow Button in Quote Studio while using Legacy Guided Selling Flow

In Quote version 10.7, when hiding the Browse Products and Search Products function in Quote Studio, a new button will be added to Quote Studio called Guided Selling Flow, allowing you to re-enter the legacy Guided Selling Flow to add more products. This functionality will be used if Quote Wizard is configured to use Legacy Guided Selling with Quote Studio.

To do so, take the following steps:

  1. Navigate to Zuora Config > Quote Studio Settings > Admin Config.
  2. Switch the Hide Product Selector Modal for New Subscription Quote Type and Hide Product Selector Modal for Amend/Renew Subscription Quote Type toggles to Active based on the Quote subscription type.
  3. Click Save.
  4. Now, the Browse Product button will be removed under subscription, and the Guided Selling Flow button will appear instead.
  5. Click the Guided Selling Flow button to select products from CPQ 9.
  6. After product selection, click Next or Checkout CPQ X to navigate to Quote Studio (for this button to be available, you have to enable the setting Show CPQ X Button in Edit Products under Admin config).

Note that the Product Search bar and Browse Products button will be hidden once you enable Hide Product Selector Modal for New Subscription Quote Type or Hide Product Selector Modal for Amend/Renew Subscription Quote Type.

Enhancements to Renewal Quote User Interface

As of Quotes version 10.6, the Initial Term field under Terms and conditions becomes read-only when you renew the subscription. 

In Quotes version 10.7, you can edit the Initial Term when renewing subscription in the CPQ X and CPQ 9 quote process.

Note: In a Renewal Quote, the Initial Term field will always be aligned with the Renewal Term field value from the original subscription. For example, if the initial quote was created with 12 as the Initial Term and 24 as the Renewal Term, when renewing the subscription, the initial term will default to 24, and the user will still have the option of editing it.

Initial Term field respects Field-Level Security or Object Level Field Configurations under Quote Studio Settings. When this field is marked as read-only, you will not be able to modify the initial term.

Resolved issue: Two Quote records are created

Previously, you may have noticed that two Quote records were being created when selecting the legacy New Quote button from the Opportunity after Quote Wizard was configured to sequence legacy Guided Selling with the Quote Studio. This issue is now resolved.

Resolved issue: Quote Studio not loading when using Legacy New Quote Button via Accounts when configuring Quote Wizard to sequence legacy Guided Selling with Quote Studio

Previously, when you create a new quote from the legacy New Quote button via a Salesforce Account, you might encounter a loading issue in the Quote Studio. This issue is now resolved.

Resolved issue: Loading error when clicking Edit Quote (New) button on Renewal Quote

Previously, when you click Edit Quote (New) button on Renewal Quote, you might encounter a loading issue if an expired product is present on the quote. This issue is now resolved.

Release 10.6.1 (Release Date: 2022-06-02) 

The 10.6.1 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Enhancements to Lookup Filters

In Quotes version 10.6.1, when you update a LookUp field directly in the Quote Studio, the Lookup filter will now dynamically use the newly updated value on the field, whether the Quote record is saved or not.

Enhancements to Quick Filter

In Quotes version 10.6.1, we have added the following two new basic settings options in the Quick Filter section under Quote Studio Settings.

  • Status - Set this toggle to Active if you want the quick filter to be effective in Quote Studio. If this toggle is set to Inactive, Quote Studio will not allow the filter to be seen or used. 
  • Forced - Set this toggle to Active to force the quick filter to be applied by default whenever the browse pop-up window or search window is opened. Multiple filters can be configured as Forced = Active, in which case each filter will be applied to display only the relevant products. 

The Forced filter toggle can be used in conjunction with the Visible to User toggle. If a filter is Forced = Active and Visible to User = Active, then the user will see the filter in the Quick Filter list but will not be able to turn the filter off. If Forced = Active and Visible to User = Inactive, the user will not see the Quick Filter in the list, but it will still filter products as the filter logic prescribes. 

Enhancements to modal pop up when Quote Start Date is moved after product selection

As of version 10.6, a modal popup will appear with two choices to prevent errors when adding or updating products to a subscription and changing the Quote Start Date.

Now we've added one more option in Quotes version 10.6.1 that will keep all Initial RatePlan Actions and future dated segments aligned as they are currently and move them manually if needed.

Here is the updated table that explains all three options.

Quote Option Description
New Quote or Edit Quote Would you like to align all initial Actions of a Rateplan timeline to QSD and keep all future dated actions respectively aligned?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • Adjust the updated product versions Contract Effective Date, Service Activation Date, and Customer Acceptance Dates to a future date to maintain the interval between the original and updated dates.
Would you like to align all initial Actions of a Rateplan timeline to QSD and eliminate all future dated actions?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • Removes all future-dated product actions.
Would you like the Initial Actions of a RatePlan timeline to remain as is?
  • There will be no action performed on the newly added or updated products, and you may see the below error message: The contract effective date should not be earlier than the contract effective date of the basic subscription.
  • It is necessary to manually adjust the product trigger dates to save or submit the quote successfully.
Amendment Quote Would you like to align all initial Actions of a Rateplan timeline to QSD and keep all future dated actions respectively aligned?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • If there is an updated versions of the original product, the Original product line remains unchanged, however, it adjusts the updated product versions Contract Effective Date, Service Activation Date, and Customer Acceptance Dates to a future date to maintain the interval between the original and updated dates.
Would you like to align all initial Actions of a Rateplan timeline to QSD and eliminate all future dated actions?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • Removes all future-dated product actions.
  • Original product line remains unchanged.
Would you like the Initial Actions of a RatePlan timeline to remain as is?
  • There will be no action performed on the newly added or updated products, and you may see the below error message: The contract effective date should not be earlier than the contract effective date of the basic subscription.
  • It is necessary to manually adjust the product trigger dates to save or submit the quote successfully.

Note that this feature is not applicable to Renew and Cancel quotes. The Quote Start Date is read-only by default when renewing a Quote, and products are read-only when canceling a Quote.

Resolved issue: Error occurs when creating the new quote for a new account

Previously, when using Quote Studio as part of the Quote Wizard flow (accessed through the legacy New Quote button) creating a new quote, you might encounter the following error: Javascript Error: Uncaught render threw an error in 'zqu:subscriptionMetricsPanel' [Unexpected token u in JSON at position 0]This issue has been resolved in this release.

Note that this issue was only seen or reported by one customer.

Resolved issue: No Vertical Scroll Bar in the Subscription section of Quote Studio page

Previously, if the Zuora Billing Account had more than 20 subscriptions, only 20 subscriptions were displayed on the Quote Studio page.

We have now added vertical scrolling in the subscription table, allowing all subscriptions to be shown.

Release 10.6 (Release Date: 2022-05-16) 

The 10.6 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Enhancements to Quick Filters

As of version 10.5, when you create a Quick Filter, if you select Field in the Filter Logic Section, you must use the actual field-object name.

In Version 10.6, we removed the manual process of typing the actual field-object name. Now, if you select Field in the Filter Logic Section, you will have a lookup available for the field that can be used to refer to the field name you want to set field mapping for the filters. The lookup contains custom fields for any further customization in filters.

New Configuration Option to enable or disable editing access of product listed in the Product I-Frame on the Quote Detail page

In Quotes 10.6, we introduced a new configuration option Disable Edit Product in Quote Detail under Quote Configuration Settings on the Zuora Config tab page. This option is introduced for toggling between enabling and disabling the editing access of product details on the Quote Detail page.

To configure this setting:

  1. In Zuora Quotes, click the Zuora Config tab.
  2. On the Zuora Quotes Configuration Setting page, click Quote Configuration Settings.
  3. Click Edit Settings.
  4. Enable or Disable the Disable Edit Product in Quote Detail setting.
  5. Click Save.

See Quote configuration settings for more information.

Hiding One-time Charges on Amendment/Renewal Quote extended to CPQ X

We have extended the capability of Hide Original One-Time Charges setting to CPQ X. With this option you can now choose to hide or show existing one-time charges on amendment/renewal quotes in CPQ X

To configure this setting:

  1. In Zuora Quotes, click the Zuora Config tab.
  2. On the Zuora Quotes Configuration Setting page, click Quote Configuration Settings.
  3. Click Edit Settings.
  4. Enable or Disable the Hide Original One-Time Charges setting.
  5. Click Save.

See Quote configuration settings for more information.

Entity/Use Code added to Quote object

In Quotes version 10.6, we have added Entity/Use Code field to the Quote object.

Now, when you create a quote for a new billing account with tax exempted, you can specify an Entity/Use Code to apply for exemptions when using any external Tax Engine from CPQ. This field is supported in both Orders and Non-orders flow and respects the Field Level Security.

New custom object added to Quote Interval metrics fields

We have added a new custom object called Quote Ramp Interval to improve the usability of Quote Interval metrics.

Now the Quote Templates include the Quote Ramp Interval information. To see interval-level metrics in Quote Studio, you should enable the Enable Ramp Metrics. As a system administrator, you can now add custom quote interval metrics to be displayed in Quote Studio. 

Object name: Quote Ramp Interval (zqu__QuoteRampInterval__c)

The following interval metrics fields are added to the Quote ramp Interval (zqu__QuoteRampInterval__c) object:

  • Inline Discount (zqu__Inline_Discount__c) 
  • Interval Discount (zqu__Interval_Discount__c)
  • Interval End Date (zqu__Interval_End_Date__c)
  • Interval Start Date (zqu__Interval_Start_Date__c)
  • Interval Subtotal (zqu__Interval_Subtotal__c)
  • Interval Tax (zqu__Interval_Tax__c)
  • Interval Total (zqu__Interval_Total__c)
  • Quote (zqu__Quote__c)
  • Quote Ramp Interval Name (Name)
  • Description (zqu__Description__c)
  • Gross TCB (zqu__Gross_TCB__c)
  • Gross TCV (zqu__Gross_TCV__c)
  • Net TCB (zqu__Net_TCB__c)
  • Net TCV (zqu__Net_TCB__c)
  • Discount TCB (zqu__Discount_TCB__c)
  • Discount TCV (zqu__Discount_TCV__c)

See Quote and Charge Metrics and Zuora CPQ metric fields mapping and derivation for more information.

Enhancements to Quote Studio Settings

In Quotes version 10.6, when you change any settings under Quote Studio settings and navigate to other settings without hitting Save button, you will get a warning message stating, There are unsaved changes. You can choose to stay on that page or continue without saving.

You can control the message on the popup by the Custom Label - UNSAVED_LEAVE_VALIDATION.

Custom Label Description
UNSAVED_LEAVE_STAY Stay in the same page
UNSAVED_LEAVE_LEAVE Leave the page without saving

Support for customizing what metric fields are displayed in Quote Studio

CPQ X allows you to configure the display of metric fields in Quote Studio based on Quote type using Field Logic Composer. You can control the display of metric fields with the Hidden property in the attribute column. 

By default metric fields are displayed as read-only. You can only use the Hidden property in the Field Logic Composer to hide or display the metric fields in Quote studio.

For more information, see Configure Quote Studio field editability based on quote type.

Support for customizing Quote Studio field editability for Cancellation Quote

CPQ X now allows you to customize the editability of fields in Quote Studio for Cancellation Quote:

  • Hide fields
  • Set read-only fields
  • Disable fields to be updated

For more information, see Configure Quote Studio field editability based on quote type.

Support for guided product selection in Quote Studio by configuring filter logic under Quick Filters

In Quotes version 10.6, you have the flexibility to map any field of a product or product rate plan with the respective field of any object related to Quote in the filters. 

Based on the field defined in the Quick Filter logic, the products will be displayed in the Product Selector Modal. The defined filters on the Product Selector Modal works based on pre-stored Data in the database. Note that the experience will be enhanced in the later releases.

Note that the object field mapping used in filters must already have stored data before running the filter in the Browse Products section. If the Quote is not saved and you use the Quote field in the Quick filter logic, the filter may not work. This limitation only applies to Quote Objects in the Quote Studio layout. This will be enhanced in the later releases.

Support for Automated Price Change (Uplift) in CPQ X  

In Quotes version 10.6, you can now automatically change the price for one or more products when a subscription renews in CPQ X. 

The following fields were added to the fieldset in Quote Rate Plan Charge Object → Charge Display Fields:

  • Trigger Event
  • Trigger Date
  • Billing Timing
  • Period
  • Specific Billing Period
  • End Date Condition
  • Specific End Date
  • Price Change Option
  • Price Increase Percentage

To display and allow your users to enter a price change option, add the above new fields to the Charge Display Fields field set on the Quote Rate Plan Charge object.

Enhancement to CPQ X Default Value Plugin (DefaultValuesPluginV2) 

With Quotes version 10.6, when a new subscription quote is generated from an existing billing account, the selected billing account information such as ZuoraAccountID__c and Zuora__Account__Number__c are available in the plugin context so that conditional logic can be built around them. Likewise, when amending or renewing a quote, the attribute SubscriptionType__c will populate the correct value for the plugin.

Resolved issue: Quote formula fields appear as text boxes instead of toggle icons

Previously, Quote formula fields were displayed with text boxes instead of toggle icons. This issue is now resolved.

Now, Quote formula fields will appear as a disabled toggle icon on the CPQ Quote screen. The formula field is read-only and thus can only be used in the view mode.

Resolved issue: Quote currency not synced with Charge Subtotal

Previously, you might encounter the issue when quote currency is different from currency defined in Salesforce, Quote currency is not synchronized with Charge Subtotal. This issue is now resolved.

Resolved issue: Errors when Quote Start Date is not aligned with the product effective date

Previously, when you add or update products on the subscription and change the Quote Start Date to any future date, you might encounter an error The contract effective date should not be earlier than the contract effective date of the basic subscription.

In Quotes version 10.6, when you add or update products on the subscription and change the Quote Start Date to any future date, a modal popup will appear with the following two options you can select:

Quote Option Description
New Quote or Edit Quote Would you like to align all initial Actions of a Rateplan timeline to QSD and keep all future dated actions respectively aligned?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • Adjust the updated product versions Contract Effective Date, Service Activation Date, and Customer Acceptance Dates to a future date to maintain the interval between the original and updated dates.
Would you like to align all initial Actions of a Rateplan timeline to QSD and eliminate all future dated actions?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • Removes all future-dated product actions.
Amendment Quote Would you like to align all initial Actions of a Rateplan timeline to QSD and keep all future dated actions respectively aligned?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • If there is an updated versions of the original product, the Original product line remains unchanged, however, it adjusts the updated product versions Contract Effective Date, Service Activation Date, and Customer Acceptance Dates to a future date to maintain the interval between the original and updated dates.
Would you like to align all initial Actions of a Rateplan timeline to QSD and eliminate all future dated actions?
  • Syncs the newly added products’ Contract Effective Date, Service Activation Date, and Customer Acceptance Date with the updated Quote Start Date.
  • Removes all future-dated product actions.
  • Original product line remains unchanged.

Note that this feature is not applicable to Renew and Cancel quotes. The Quote Start Date is read-only by default when renewing a Quote, and products are read-only when canceling a Quote.

Resolved issue: Editing mode for Effective price and Discount fields of Original One-Time Charges

Quotes version 10.5, when creating Amendment or Renewal Quotes, the Effective Price and Discount fields of Original One-Time Charges can be edited, but the Charge Subtotal value does not change.

In Quotes version 10.6, we removed the display of edit mode to avoid confusion. Now, when you create an amendment or renewal quote, the Original One-Time Charges are grayed out, and it will be in read-only mode. If the one-Time Charges have already been billed, they are labeled "Billed for.". If they have not been billed, they are labeled "Original."

Resolved issue: Unable to remove future-dated Rate Plan charge before its actual trigger date

Previously, when you try to remove the Product from Rate Plan Charge before the Product effective date, you might encounter Date can not be earlier than Add Product effective date error. This issue is now resolved.

This issue has been resolved. Now you can remove the Product from the Rate Plan Charge before the Product effective date.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: Fixed page formatting issue with Price Summary section on Add products page in CPQ 9

We have fixed the page formatting issue on the price summary section on Add products page in CPQ 9.

Release 10.5.3 (Release Date: 2022-05-04) 

The 10.5.3 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Resolved issue: Incorrect rounding of effective price and discount values

In version 10.5, we released an enhancement that allows prices (including charges and tiers) in the Quote Studio to follow the scale defined in the Display Scale Settings. However, you would encounter rounding errors in the computation of Effective price and Discount values. This issue is now resolved.

Resolved issue: Invalid increment error for Amount Per Unit in quote line items

As of version 10.5, when creating or editing quote line items, you might encounter the invalid increment error if you specified decimals in the Amount Per Unit field. This issue is now resolved.

Enhancements to Discount field

In 10.5, we released an enhancement to the tiered Charge “Tier Detail” modal that allows you to define a top line Inline Discount that would cascade down to all tiers. However, if you change the Inline Discount field in any one of the specific tiers, the top line Inline Discount field would update to reflect an aggregated percentage which was confusing. 

As of 10.5.3, you can use the top line Inline Discount field in the “Tier Detail” Modal to cascade a percentage discount to all tiers. However, if you manually change the discount percentage value for any specific tier, the top line Inline Discount field will clear. Still, the values for each tier’s Inline Discount will remain the same and can continue to be manually updated. 

Resolved issue: Opportunity field not auto-populated in Quote Studio 

In version 10.5, by configuring Quote Wizard settings, you can add Quote Studio to your guided selling flow. With Quote Studio added to Quote Wizard settings, when you previously tried to create new quotes by clicking the New Quote button, the opportunity record was not automatically populated to the Opportunity field of the Quote Information section. It was because the logic of querying opportunity ID was not added to the New Quote button.

This issue has been resolved in version 10.5.3. The Opportunity field is now auto-populated in the same case.

Resolved issue: Values of Amount Per Unit and Quantity gets shuffled in order line item 

Previously, when you add multiple order line items, the Amount Per Unit and Quantity fields get shuffled up in the Quote Studio UI.

In version 10.5.3, we have updated the logic behind the order line Item. This issue is now resolved.

Release 10.5.2 (Release Date: 2022-04-25) 

The 10.5.2 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Resolved issue: Not possible to create future-dated actions

As of 10.5, when you click the Update button to create a future-dated action, you would find the future-dated charge segment rows were not persisting in CPQ X. This issue is now resolved.

Resolved issue: Invoice Owner field is not editable for New, Amend, or Renew quote types in Quote Studio

As of version 10.5, you cannot edit the Invoice Owner field for New, Amend, or Renew quote types in Quote Studio, which could cause an issue with assigning the invoice responsibility of a subscription to a customer account that does not own that subscription.

We have now fixed this issue in version 10.5.2 and made the Invoice Owner field editable for New, Amend, or Renew quote types in Quote Studio.

Release 10.5.1 (Release Date: 2022-04-19) 

The 10.5.1 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Resolved issue: Entity is Deleted error when renewing a ramped quote

In version 10.5, when you renew a ramped quote, you might encounter an Entity is Deleted error. This error is due to the order of execution of Data Manipulation Language (DML) operations. This issue is now resolved.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: ‘Either ‘previewAccountInfo’ or ‘existingAccountNumber’ need to be specified’ error in CPQ 9

Previously, when cloning or maintaining Quote, you might encounter an Either ‘previewAccountInfo’ or ‘existingAccountNumber’ need to be specified error when changing the account. This issue has been resolved now.

Resolved issue: Missing Organization Feature: DandBEnterprise error when installing Zuora Quotes version 10.5

Previously, when you tried to install Zuora Quotes version 10.5, you would get a Missing Organization Feature: DandBEnterprise error. There were unwanted Account Object fields in the Quote Object fieldsets that caused this error.

Now that the unwanted fields have been removed from the fieldsets, this issue is now resolved.

Release 10.5 (Release Date: 2022-04-13) 

The 10.5 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

Support for creating subscription cancellation quotes

Quote Studio now supports creating subscription cancellation quotes. On the Billing Account Selection page, you can now cancel a subscription by clicking the subscription cancellation icon. 

Support for changing invoice owner in amendment subscription

Now, you can create an amendment quote to change the Invoice Owner in Quote Studio.

To change the Invoice owner:

  1. Enable the following two settings in the Zuora tenant:
    • Owner Transfer Amendment
    • Invoice Subscription to Different Accounts
  2. Navigate to Zuora Config > Quote Configuration Settings, in the Field Configurations section, select the Enable Invoice Owner checkbox.
  3. Add InvoiceOwner__c field to whichever Quote Studio Fieldset you would like to see it in.
  4. Optional - Navigate to Zuora Config > Quote Studio Settings > Object Fields Config, hide Quote > Invoice Owner field for new and renew quotes.

Formula field recalculation for newly added products

Quote Studio now triggers the custom formula field recalculation for newly added products. ​​Once you update the price, discount, or quantity of the quote, the formula will be recalculated.

Support for cloning in-flight quotes

With this new feature in CPQ X, you can click the New Clone Quote button to clone a new subscription quote, amendment quote, or renewal quote in a lesser turnaround time. Note that only one of the Amendment or Renewal quotes should be allowed to be sent to Zuora. Trying to send the other would result in an error. Currently, quote cloning is available only for existing billing accounts or primary contacts.

Furthermore, CPQ with Orders now recognizes when an in-flight quote is made against an outdated subscription version. Now, in version 10.5 and above, when attempting to send the in-flight quote to Zuora after the subscription version has been modified (either by another Sent Quote, Order UI, or Order API), an error message will appear stating Unable to send: The subscription in Zuora does not match the base subscription in this quote.

When submitting the quote, the ExistSubscriptionID__c field fetches the existing subscription version ID from Zuora and compares it with the latest subscription version found in the in-flight quote. If there is a mismatch, the error is displayed.

Support for customizing fields in Billing Account and Subscription tables

Now, in Quote Studio you can select which fields should appear in the Billing Account table and Subscription table in the billing account selector page in CPQ X depending on your preferences. To define the fields to be displayed, you must customize:

Billing Account Table -  Zuora__fields_for_select_billing_account_compon fieldset on the Billing Account Object.

Subscription Table - Zuora__fields_for_select_billing_account_compon fieldset on the Subscription Object.

Support for adding filter logic into lookup fields using Lookup Filter Plugin

Quote Studio now allows you to add filter logic via plugin for custom lookup fields such as Bill To Contact, Sold To Contact, Opportunity, etc.

To do so, take the following steps:

  1. Create a global plugin interface that implements zqu.LookupFilterPlugin.ILookupFilter
  2. Register and activate the plugin.
    • Navigate to Zuora Config > Quote Studio Settings > Admin Config.
    • Switch the Lookup Filter Plugin toggle to Active, then add the class name of your custom plugin.
    • Click Save.

Improved usability to populate discount value for tiers

Previously, to apply a discount to charge tiers in Quote Studio, you had to manually apply the discount one by one. With the newly added charge-level Discount field, you can now populate discount values at the charge level to propagate down to all tiers.

Flexibility of customizing Billing Account Plugin

Now, you can use the IBillingAccountPlugin on the BillingAccountPlugin component to customize the Billing Account selection process. The following customizations are available:

  • For billing account selection
    • Control new and existing billing account options
    • Filter billing accounts
    • Set the default billing account
  • For quote type selection
    • Control quote type options - new, amend, renew, or cancel
  • For subscription selection
    • Filter subscriptions

See Billing Account Plugin for more information.

Support for controlling Browse Product button and Search Product field from all quote types

Now, you can hide the Browse Product button or control the Search Product field from all quote types in Quote Studio. 

To do so, take the following steps:

  1. Enable the Guided Product Selector setting.
  2. Navigate to Zuora Config > Quote Studio Settings > Admin Config.
  3. Switch the Hide Product Selector Modal for New Subscription Quote Type and Hide Product Selector Modal for Amend/Renew Subscription Quote Type toggles to Active.
  4. Click Save.

Note that this is to be used when legacy Guided Selling is enabled with CPQ X; else, you cannot choose a product while creating a quote.

Enhancements to Invoice Quote PDF metrics fields

As part of this enhancement, we have introduced the Inline Discount metric field in the Invoice Quote PDF template.

Note that 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 and then those figures for each charge are added together.

Enhanced Display Scale Settings functionality

Now, prices (including charges and tiers) in the Quote Studio follow the scale as defined in the Display Scale Settings.

Resolved: New product in amendment quote aligned with subscription term start date

Previously, when you added a product in an amendment quote, it automatically aligned to the subscription term start date. This issue has been resolved. 

Release 10.4 (Release Date: 2022-03-09) 

The 10.4 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements and resolved issues are only applicable to Quote Studio and its corresponding settings.

CPQ X Extensibility Framework now available

We now provide you with the CPQ X Extensibility Framework feature that enables you to easily include your own Salesforce Lightning Web Components (LWC) or Lightning Aura components in the Quote Studio sidebar on the right. After you have implemented your components, registered and dispatched the component events, you must register your components in CPQ X by navigating to Zuora Config > Quote Studio Settings > Custom Component Settings in your Salesforce org. This feature vastly improves the customizability of Quote Studio to better suit your needs.

For more information, see Customize Quote Studio sidebar with Extensibility Framework.

Enhancements to Quote Studio metrics fields

We have made the following enhancements to improve usability and customizability of Quote Studio metrics:

  • As a system administrator, you can now add custom quote metrics to be displayed in Quote Studio. This enhancement allows you to customize the metric fields to meet your business requirements. Note that only the following types of fields can be added:
    • Number type, including the Formula fields of the Number type
    • Currency type
  • As part of this enhancement, we have also introduced the Inline Discount field as a standard subscription metric and a quote metric. This field reflects the discounted amount for inline items in real time. 

For more information, see Customize field sets for CPQ X.

Support for editing Billing Batch and Bill Cycle Day in amendment and renewal quotes 

In Quotes 10.3, we introduced the Allow Zuora Account Info to be Updated setting that allows several fields to be editable in amendment and renewal quotes. We have extended the capability of this setting to control the editability of the Billing Batch and Bill Cycle Day fields in this release. 

With this setting enabled, you can now edit Billing Batch and Bill Cycle Day fields when creating amendment or renewal quotes. Otherwise, both fields are read-only.

See Quote configuration settings for more information.

Configurability of default value for Billing Batch

You can now set the default value for the Billing Batch field for new quotes by navigating to Zuora Config > Quote Studio Settings > Default Settings. With this default setting configured, the Billing Batch field is automatically populated with the default value when a new quote page is loaded.

See Update default settings for more information.

New metrics added to default quote template

We have enhanced the quote template to incorporate metrics for quote line items (QLI). The following metrics are now available in the default quote template:

  • QLI Charge Subtotal
  • QLI Subtotal
  • QLI Tax
  • QLI Total
  • Quote Subtotal
  • Quote Total

Note that you can download the default quote template by navigating to Commerce Settings > Configure Salesforce.com Quote Templates in the Zuora UI.

Account and Opportunity fields available to be added and edited in Quote

You can now add fields from accounts or opportunities to Quote Studio through configuring the zqu__CPQX_Quote_Information field set of the Quote object. Both standard and custom fields are supported.

The added fields will be rendered based on the field-level security settings:

  • If the field-level security setting is set to both Visible and Read-Only, then the added fields will be rendered as read-only fields. 
  • If the field-level security setting is set to only Visible, then the fields will be rendered as editable fields.
  • If the field-level security setting is set to neither Visible nor Read-Only, the fields are hidden from the UI.

The account or opportunity fields are automatically populated with the field value saved on the Account or Opportunity object. If the fields are rendered as editable fields, you can edit them and the updated values will override the respective fields on the Account or Opportunity object after you save or submit the quote. If you enter blank values in these fields, the field values are not overridden after you save or submit the quote.

For each change you make to the account or opportunity fields for a new quote, the values will change only in Salesforce and will not be synced to Zuora.

Note that some custom fields on account might contribute to the Multi-Attribute Pricing charge model. Therefore, we do not recommend that you add those custom fields to the Quote Information section because users might change these field values frequently, which can significantly impact pricing. 

Enhanced “Back” button options for amendment and renewal quotes

Previously, the amendment or renewal quote was created even if you clicked the Don’t Save button in the dialog after clicking Back in Quote Studio. This behavior was by design but is confusing.

To improve your experience with Quote Studio, we have replaced the Don’t Save button with the following buttons:

  • Delete and leave page: Leave the page without creating any quote record.
  • Keep and leave without saving: Leave the page without saving the change, but the amendment or renewal quote record is still created.

Formula field recalculation triggered on metrics preview

If you create and add a formula field to Quote Studio, the formula field recalculation can be triggered each time Quote Studio calls the Preview an order API operation. Once you update the price, discount, or quantity of the quote, the formula will be recalculated.

Note that the current support for formula field recalculation has the following limitations:

  • Only the fields on the Quote and Quote Rate Plan Charge objects are supported.
  • The formula cannot contain any of the metrics fields such as TCV, Subtotal, and Discount, and Total.
  • Formula field recalculation does not work for newly added product. 

Resolved: Opportunity field not auto-populated in Quote Studio

By configuring Quote Wizard settings, you can add Quote Studio to your guided selling flow. With Quote Studio added to Quote Wizard settings, when you previously tried to create new quotes by clicking the New Quote button, the opportunity record was not automatically populated to the Opportunity field of the Quote Information section. It was because the logic of querying opportunity ID was not added to the New Quote button. This issue has been resolved. The Opportunity field is now auto-populated in the same case.

Resolved: Salesforce field-level security not supported in Quote Studio

Previously, field-level security was not supported it in Quote Studio. 

This issue has been resolved. Salesforce field-level security is now supported in Quote Studio. The field permissions are determined based on the more restrictive one between the Salesforce field-level security settings on different levels and the Object Field Configuration settings within Quote Studio settings.

Release 10.3 (Release Date: 2022-02-09) 

The 10.3 release includes the following enhancements and resolved issues.

Quote Studio enhancements and resolved issues

The following enhancements are only applicable to Quote Studio.

Support for disabling ramp deal creation in Quote Studio

The Enable Ramp Deal Creation in Quote Studio admin setting is now available for Quote Studio page configuration.This setting can be used by system administrators to enable or disable ramps in quotes. 

With this setting disabled, no ramp settings are displayed in Quote Studio, thus users cannot create new quotes with ramps. If users attempt to amend or renew quotes that contain existing ramps, they cannot complete in-flight quotes, but can see previous ramp actions with no intervals displayed. 

See Configure Quote Studio admin settings for more information.

Support for customizing Quote Studio field editability based on quote type

CPQ X now allows you to customize the editability of fields in Quote Studio based on the quote type (new subscription, amendment, or renewal).

A set of Quote Studio settings called Object Fields Config is now available by navigating to Zuora Config > Quote Studio Settings in your Salesforce org. On the Object Fields Config page, you can do the following field customization for each quote type:

  • Hide fields
  • Set read-only fields
  • Disable fields to be updated

See Configure Quote Studio field editability based on quote type for more information.

Support for adding custom lookup fields to Quote Studio based on lookup filters

You can now configure lookup fields that conform to the defined lookup filter logic to Quote Studio. 

The Enable Lookup Filter admin setting is now available by navigating to Zuore Config > Quote Studio Settings > Admin Config. With this setting enabled, users can add custom lookup fields to Quote Studio based on filter logic defined in lookup filters. When an existing lookup filter is updated or new lookup fields are created, you can click the Refresh Filter button to refresh all filters.

See Enable lookup filters for fields in Quote Studio or more information.

Charges in Quote Studio product selectors now displayed based on list price base

The product rate plan charges in Quote Studio product selectors are now displayed based on the configured list price base regardless of the billing period. It allows you to easily identify how charges are set up to be priced in the product catalog in Zuora. If you want the charges to be displayed based on the billing period, you must set the list price base the same as the billing period. 

Invoice Owner lookup field now available for CPQ X fieldsets

After you add the Invoice Owner (InvoiceOwnerName__c) field to the fieldset for new quotes in the legacy CPQ 9 quote flow, you can check the associated billing account through this field. However, this lookup relationship was previously not supported by Quote Studio.

In this release, we have introduced the Invoice Owner  (InvoiceOwner__c) field that can be added to CPQ X fieldsets. With this field added, you can perform the billing account lookup through this field in Quote Studio.

Support for setting default ramp frequency

CPQ X now supports setting a default ramp frequency. The Ramp Frequency default value setting is now available by navigating to Zuora Config > Quote Studio Settings > Default Settings. With this setting configured, the specified default ramp frequency is displayed when the Ramp toggle in Quote Studio is enabled. 

Required field validation on rich text fields

In Zuora Quotes 10.2, we introduced support for configuring required fields in Quote Studio. Quote Studio provides validation on the configured required fields. However, rich text fields previously did not support required field validation. Thus, we have enhanced the rich text fields in Quote Studio to support such validation. 

Support for editing billing account details and contacts in amendment and renewal quotes

Quote Studio now allows for updating the following fields in amendment and renewal quotes:

  • Bill To Contact
  • Sold To Contact
  • Payment Term
  • Payment Method

To allow these fields to be updated, you must select the Allow Zuora Account Info to be Updated check box by navigating to Zuora Config > Quote Configuration Setting. With this check box selected, the previous fields are editable when users amend or update quotes; otherwise, these fields are read-only.

For more information, see Quote Configuration Settings.

Enhancements to rules engine

Previously, rules defined in rules engines were triggered during the billing account selection process. This behavior could result in an increased loading time and other potential issues. 

Because the quoting process technically starts after a billing account is selected, it is unnecessary to trigger rules prior to the quoting process. Therefore, we have enhanced the rules engine so that the rules are triggered only after the billing account selection. In addition, when any validation message of the Error type is displayed during the rules engine processing, the Save and Submit buttons are now disabled to prevent users from saving or submitting the quote.

Resolved issue: Percentage discounts incorrectly displayed as amounts in Subscription History panel

Previously, the values of percentage discount charges for ramp deals were incorrectly displayed as amounts in the Subscription History panel. For example, if you updated a 20% percentage discount charge to 10%, the Original Value and New Value columns for this action were displayed as $20 and $10, respectively. This issue has been resolved now and the values are displayed correctly.

Resolved issue: Related contacts not auto-populated when creating amendment or renewal quotes 

Previously, with Contacts to Multiple Accounts enabled in your Salesforce org, when you created renewal or amendment quotes, Bill To Contact and Sold To Contact were not automatically populated if you were using related contacts. This issue has been resolved now.

Resolved issue: Cannot amend quotes with Create Subscription and Remove Product actions through Quote Studio

Previously, if you created an order with both “create subscription” and “remove product” order actions, this subscription was not available for amendment through Quote Studio after it was synced to Salesforce. However, it could be amended through the legacy CPQ 9 UI. This issue has been resolved. You can amend such quotes through Quote Studio now.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: Incorrect preview metrics when quotes contain products of Multi-Attribute Pricing charges

Previously, when trying to preview the quotes that contain products of the Multi-Attribute Pricing charge model, you could find that the custom fields were not sent to Zuora for metrics calculation, thus the metrics were incorrect. This issue has been resolved now.

Release 10.2 (Release Date: 2022-01-11) 

The 10.2 release includes the following enhancements.

Quote Studio enhancements and resolved issues

The following enhancements are only applicable to Quote Studio.

Flexibility of configuring custom fields in Quote Studio

You now have the flexibility to enable the Additional Fields section in any section on the Quote Studio page. We have introduced the following field sets on the Quote object, which allows you to display custom fields in Quote Studio to meet your business needs:

  • CPQX_Quote_Information_CustomFields
  • CPQX_Subscription_Overview_CustomFields
  • CPQX_Subscription_TAndC_CustomFields
  • CPQX_Subscription_Billing_CustomFields

With this enhancement, each section in Quote Studio contains two types of field sets: one is to display standard fields and the other is to display custom fields. The following list describes the hierarchy of the field sets of the standard sections in Quote Studio and their child field sets for custom fields:

  • Quote Information (zqu__CPQX_Quote_Information)
    • Additional Fields (zqu__CPQX_Quote_Information_CustomFields)
  • Overview (zqu__CPQX_Subscription_Overview)
    • Additional Fields (zqu__CPQX_Subscription_Overview_CustomFields)
  • Terms and Conditions (zqu__CPQX_Subscription_Terms_And_Conditions)
    • Additional Fields (zqu__CPQX_Subscription_TAndC_CustomFields)
  • Billing (zqu__CPQX_Subscription_Billing)
    • Additional Fields (zqu__CPQX_Subscription_Billing_CustomFields)

Note that the labels of all these fields can be translated into a different language or renamed using the Salesforce Translation Workbench. 

See Customize field sets for CPQ X for more information.

Support for configuring required fields in Quote Studio

CPQ X now allows you to configure fields as required fields in the corresponding field sets. If a field is configured as required, Quote Studio displays an asterisk (*) next to its field label for highlighting and provides validation on this field. Users cannot save or submit the quote until all required fields on the Quote Studio page are specified.

CPQ X now supports product features with limitations

CPQ X now provides support for product features of Zuora with limitations. 

You can create, amend, or renew quotes that contain products with features, for ramp deals or non-ramped subscriptions. Future dated actions on products with features are also supported. However, you cannot view, add, remove, edit, or override these features in any way from Quote Studio. 

For more information about the configuring features or product features in Salesforce, see Create features and product features in Salesforce.

For more information about features or product features in Zuora, see the following articles:

Support for adding New Quote (New) button to Quote related list on Account and Opportunity page

You can now add the New Quote (New) button for CPQ X to the Quotes related list on the Account and Opportunity page. This shortcut allows you to navigate to Quote Studio directly from the Account or Opportunity page with billing account and opportunity information automatically populated.

Support for creating quote line items as taxable or non-taxable

CPQ X now supports creating ad hoc quote line items or quote line items from an existing Product Catalog as taxable or non-taxable. The tax details for each product are displayed while you browse the product catalog for quote line item creation. The Tax Mode and Tax Code fields are displayed only when the Taxable checkbox is selected. 

Note that you might notice a limitation that you cannot select other tax codes that are set up in your Zuora tenant. This issue will be resolved in a future release. 

Resolved issue: Errors when creating quote line items if Item Type was Discount or Item State was Cancelled 

Previously, when creating quotes that contain quote line items through Quote Studio, you would encounter errors if Item Type of the quote line item was Discount, or Item State was set to Cancelled. The reasons for the errors include:

  • The Discount item type was not a supported option.
  • The Cancelled item state was spelt incorrectly, and the correct form is Canceled.

We have removed the Discount option from the Item Type dropdown list, and corrected the Cancelled option to Canceled for the Item State dropdown list. Thus, this issue no longer exists.

Resolved issue: Error when submitting quote line items with “Sent to Billing” item state and unspecified Bill Target Date

Previously, when you submitted quote line items with the Item State set as Sent to Billing and Bill Target Date left empty, you would get an error only when you attempted to submit the quote line items. This issue has been resolved. The Bill Target Date field for quote line items is made a required field when the Item State is Sent to Billing

Resolved issue: Errors when creating quote line items if Sold To Contact was selected

Previously, when creating quotes that contain quote line items through Quote Studio, you would encounter an error indicating that soldToData was an invalid parameter if you selected a sold-to contact.

This issue has been resolved. We have removed the Sold To Contact section.

Resolved issue: Future-dated actions on fixed amount discount charges not successfully sent to Zuora 

Previously, you could successfully add or preview mid-interval updates or future dated actions on fixed amount discount charges, but would fail to send them to Zuora. The reason was that fixed amount discount charges cannot be applied to future dates by Zuora’s design. We have resolved this issue by introducing a validation to prevent future-dated actions from being made to fixed amount discount charges in Quote Studio.

Resolved issue: Record Type field not populated for quotes created through Quote Studio

Previously, quotes created through Quote Studio did not have the Record Type field. This issue has been resolved. Quotes created through Quote Studio now have the Record Type field populated based on the quote flow type:

  • New subscription quote flow has the Default type. 
  • Amendment quote flow has the Amendment type. 
  • Renewal quote flow has the Renewal type. 

Note that the cancellation flow does not have the corresponding record type.

Resolved issue: Invalid increment error for Amount Per Unit in quote line items

Previously, when creating or editing quote line items, you might encounter the invalid increment error if you specified decimals in the Amount Per Unit field. This issue is now resolved.

Resolved issue: Subscription Term End Date not automatically populated

Previously, with the Subscription Term End Date field enabled in Quote Studio, you might find that the value of this field was not automatically populated as expected when creating new subscriptions. To get this field populated, you had to manually update the Subscription Term Start Date or Initial Term field.

This issue has been resolved. This value for the Subscription Term End Date field is now automatically populated based on the default subscription start date and the default initial term.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Resolved issue: Product updates in amendment quotes cannot be triggered on Service Activation Date

When you previously updated products in amendment quotes through Quote Studio or in the legacy CPQ 9 UI, all charges were triggered on the Contract Effective Date and blocked you from changing the action-level trigger date to the Service Activation Date. This issue has been resolved now. 

If the trigger condition of the product rate plan charge is set to Service Activation Date, the action-level trigger date now aligns with the Service Activation Date.

Resolved issue: Unclear error displayed on Quote Details page if opportunity name exceeds 100 characters

Previously, if the opportunity name exceeded 100 characters, an API call error with an error code and error message would be displayed on the Quote Details page. The displayed error was not intuitive for you to identify the root cause. 

This issue has been resolved. The following self-explanatory warning message is now displayed on the Quote Details page if the opportunity name is over 100 characters: 

Opportunity name should be less than 100 characters

Resolved issue: Bill to contact and Sold to contact information not auto-populated when creating renewal quotes and with related contacts enabled

Previously, with the related contact permission enabled, information for Bill to Contact and Sold to Contact were not automatically populated when you created renewal or amendment quotes. This issue has been resolved. Now, if Bill to Contact and Sold to Contact are set to a related contact, they are automatically populated when you create renewal or amendment quotes.

Resolved issue: Incorrect percentage with decimals for discount charges after submitting the quote

Previously, after you submitted quotes that contain percentage discount charges with decimals, you might find that the discount percentage for some charges were not incorrectly displayed on the quote details page. This issue has been resolved now.

Resolved issue: Unknown internal error when generating Quote PDF documents

Previously, you might encounter an unknown internal error if you clicked the Generate PDF button to generate PDF documents for quotes. This error occurred due to behavior changes on the Salesforce side. We have worked with Salesforce to resolve this issue, thus this issue no longer exists. 

Resolved issue: zqu_RenewalSetting_c in default value plugin not effective for amendment or renewal quotes

Previously, you might find that if you set a default value for the zqu_RenewalSetting_c field in your default value plugin that extends zqu.CreateQuoteController.PopulateDefaultFieldValuePlugin, the configured default value did not take effect in amendment or renewal quotes. This issue is now resolved.

Release 10.1 (Release Date: 2021-12-07) 

The 10.1 release includes the following enhancements.

Quote Studio enhancements

The following enhancements are only applicable to Quote Studio.

Default action dates configurability for amendment quotes 

For better configurability and usability of amendment quotes, we have changed the default behavior of the update product actions in amendment quotes in CPQ X. If an update is made on an original product, the update action is now triggered on the Quote Start Date by default. 

With this change, the following Quote Studio admin settings are now available:

  • Update Amendment Quotes as of Original/Subscription Term Start Date: Enabling this setting brings back the legacy behavior. The Contract Effective Date of the update action on an existing product will default to the original subscription start date.
  • View Amendment Quotes as of Quote Start Date: With this setting enabled, on an amendment quote, CPQ X will consider the quote to start from the Quote Start Date instead of the subscription term start date, thus will filter out original actions before that.
  • Prohibit Backdate Actions: With this setting enabled, the Contract Effective Date of update actions cannot be set to earlier than the Quote Start Date. 
    Note that if Update Amendment Quotes as of Original/Subscription Term Start Date is also enabled, you still can update original products as of the original trigger date.

You can optionally enable one or multiple of these settings based on your business requirements.

See Configure Quote Studio admin settings for more information.

Related contacts available for selection for Bill to Contact and Sold to Contact in Quote Studio

When you configure the Bill to Contact and Sold to Contact dropdown lists on the Quote Studio page, in addition to primary contacts, related contacts associated with the account are now also available for selection. 

Previously, only primary contacts could be selected for both dropdown lists.

Enhanced text area usability in Quote Studio

We have enhanced text areas in Quote Studio for better usability. Text areas that allow for rich text and long plain text are now displayed in a more intuitive way so that they can be easily distinguished from short plain text areas. A text formatting toolbar is also available in rich text areas.

Previously, all text areas were equally displayed as short plain text areas.

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than Quote Studio, or both Quote Studio and other components in Zuora Quotes.

Zuora Connection Settings page reorganization

We have reorganized the layout of the Zuora Connection Settings page for improved user experience. 

  • If you are an existing Zuora Quotes user, no update is required.
  • If you are new to Zuora Quotes, you need to specify the following fields to connect your Salesforce organization to your Zuora tenant:
    • SOAP API URL: Specify the SOAP API URL provided by Zuora, including the WSDL version that you want to use. The REST API URL field will be automatically populated based on the specified SOAP API URL.
    • API User Name: The user name provided by Zuora
    • API Password: The password provided by Zuora

See Zuora Connection Settings for more information.

JavaScript library updated

We have updated our existing JavaScript libraries to avoid potential security issues. If you have been using the JavaScript libraries provided in the Zuora Quotes package, you should update the reference to the new JavaScript libraries or manage your own libraries. 

Note that we do not provide any support to third-party libraries if you use your own JavaScript libraries.

Release 10.0 (Release Date: 2021-11-09) 

The 10.0 release includes the following features, enhancements, and resolved issues.

CPQ X enhancements

The following enhancements are only applicable to Quote Studio.

CPQ X is now generally available 

CPQ X is now generally available to all customers. 

CPQ X contains a single-page application named Quote Studio, which enables you to optimize the efficiency of quoting work streams within your sales process and eliminate quoting errors.

For more information about how to enable CPQ X in your Salesforce organization, see Enable CPQ X for your organization.

Support for CPQ X internationalization

The Quote Studio page can be translated into multiple languages now. 

To translate Quote Studio into a language other than English, you need to enable the language in Translation Workbench, then configure custom labels in CPQ X to add translation texts. Subsequently, if the language preference of a user is set to this language, the configured custom labels are displayed in the equivalent text in this language.

See Localize and Customize Labels and Messages for more information.

Support for on-demand metrics preview

Previously, CPQ X called the Preview an order API every time a change was made to the quote, which would trigger a tax engine call if the products were set up to be taxed. It could increase tax engine fees if you were using any tax engines other than Zuora Tax because most tax providers charge by the number of API calls. 

To minimize the number of Preview an order API calls, we have enhanced CPQ X to support on-demand metrics preview. If you enable the Enable Preview On Demand setting, a new button named Preview Metrics will be displayed on the Quote Studio page. You can click this button to preview quote metrics after you have made all changes to the quote, and the button is disabled until later changes are made. It ensures that the Preview an order API is called only when needed.

See Enable Preview On Demand for more information.

Included Units available for selection for zqu__CPQX_Charge_Display_Fields field set

The Included Units field of Quote Rate Plan Charge has been added to the available options for the Charge Display Metrics (zqu__CPQX_Charge_Display_Fields) field set. You can now enable this field to display the Included Units field for quote rate plan charges with the overage charge model.

Support for customizing dates to be displayed when clicking action date

CPQ X now supports customizing the dates that are displayed when you click the action date for a product. The Trigger Dates field set has been added to the Quote Amendment (zqu__QuoteAmendment__c) object, from which you can enable or disable the following dates:

  • Service Activation Date
  • Customer Acceptance Date

Note that Contract Effective Date is required in the field set.

See Customize displayed action dates for more information.

Support for viewing Quote Line Item metrics from quote details page

After subscription items or quote line items are added through Quote Studio, the metrics for both quote line items and subscription items are now available on the quote details page. 

Previously, only the metrics for subscriptions could be displayed on the quote details page.

To support this enhancement, the following fields have been added to the Quote object:

  • Quote Line Item Total (QLI_Total__c)
  • Quote Line Item Subtotal (QLI_Subtotal__c)
  • Quote Line Item Tax (QLI_Tax__c)
  • Subscription Subtotal (Subscription_Subtotal__c)
  • Subscription Total (Subscription_Total__c)
  • Subscription Tax (Subscription_Tax__c)

Enhanced usability for action buttons

Previously, the action buttons, including Back, Save, and Submit buttons, could only be found if you scroll to the top of the Quote Studio page. To optimize your experience, we have enhanced the Quote Studio page to ensure that these buttons are fixed at the top of the screen. Thus you can find and click these buttons from anywhere within Quote Studio. 

General enhancements and resolved issues

The enhancements and resolved issue in this section are applicable to Zuora Quotes components other than CPQ X, or both CPQ X and other components in Zuora Quotes.

Enhanced Chatter feeds for Opportunities

If you have enabled Salesforce Chatter feed tracking for both Quote and Opportunity, you can now dynamically configure the quote fields that will be posted as a Chatter feed on the corresponding opportunity record.

A list of quote fields have been added as the default fields to the Chatter Feed On Opportunity field set of the Quote object. The Chatter feed is only posted when the values of one or more of these fields are changed. You can also customize this field set by adding more fields or removing unnecessary fields. 

By default, if feed tracking for both Quote and Opportunity are enabled, Chatter feeds are posted on Opportunity when quotes are created or updated. Now you have the flexibility to disable Chatter feeds from quotes by enabling the Disable chatter feed from Quote setting. 

See Chatter Collaboration for more information.

Support for combining Quote Studio with guided selling flows

CPQ X now supports combining Quote Studio with existing guided selling flows. You can combine them using either or both of the following approaches:

  • Add Quote Studio to quoting flows through Quote Wizard
  • Enable the Navigate to Quote Studio After Select Products setting

It allows for high flexibility of quote configuration and thereby meets different business needs.

See Combine guided selling flows with Quote Studio for more information.

Resolved issue: Tier changes not saved after quote is submitted

Previously, if you updated product rate plan charge tiers in an amendment quote or a renewal quote, you might find that the tier changes were not saved after the quote was submitted. This issue has been resolved now.