Welcome to Zuora Product Documentation

Explore our rich library of product information

Configure Quote Configuration Settings

Learn how to configure quote settings in Zuora Quotes, including editing settings and managing configuration fields.

  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. Enter information for the configuration fields. The table below describes these fields in more detail.
  5. Click Save.

    The following fields are available for configuring Zuora Quotes.

    FieldDescriptionLegacy CPQCPQ X
    Zuora Package Installation Status
    This view-only section displays the installed packages and includes information such as version and namespace. This section is hidden when you are in the edit mode.
    Quote Configurations
    Disable Additional Price Discounts

    Select to prevent users from:

    • Creating additional discounts on quotes
    • Editing any fields in tier levels
    • Adding or removing tiers
    File:Z_Media/checkmarkGreen_xsm.png
    Enable Consolidated Charge-level Reports

    Select to allow consolidated pipeline reporting on New subscription, Amendment, and Renewal quotes at the charge level. When selected, this options lets you use the Zuora Quotes custom report types.

    This setting was deprecated as of the 6.50 (Q2 2015) release of Zuora Quotes.

    Deprecated
    Get Tiers from Zuora

    Select to obtain Subscription Rate Plan Charge Tiers directly from the Subscription in Zuora. If not selected, the information about the Tiers comes from the Zuora Product Catalog in Zuora 360.

    This setting only applies to Amendment and Renewal quotes, and this setting must be selected to use the automatic price lift feature.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Get Billing Accounts from 360

    Select to obtain Billing Account information directly from Zuora 360 in Salesforce.

    We recommend that you have Real-time Sync enabled when using this setting to always have the most up-to-date Billing Account data.

    If you have a custom field on the Billing Account object, enable this setting to avoid an error from the corresponding custom field missing in Zuora.

    Irrespective of this setting, CPQ X will consistently retrieve Billing Account details from Zuora 360 in Salesforce for the lists generated in the Billing Account Selector Page.

    File:Z_Media/checkmarkGreen_xsm.png
    Enable Amendment Functionality

    Select to allow users to create Amendment quotes from Salesforce.

    This setting was deprecated as of the 6.50 (Q2 2015) release of Zuora Quotes.

    Deprecated
    Store Data in Quote Charge

    Starting in the 6.50 (Q2 2015) release, the Quote Rate Plan Charge object is used for New Subscription Quotes.

    Select this setting to replicate data from the Quote Rate Plan Charge object (zqu__QuoteRatePlanCharge__c) to the Quote Charge object (zqu__QuoteCharge__c) to ensure that your reports and custom codes previously built from the Quote Charge object (zqu__QuoteCharge__c) can still work with the new data model.

    Use this setting in interim while migrating your reports and customizations to use the new data model with Quote Rate Plan Charge.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Approved Quote StatusFinal and approved status of the quote when sent to Zuora. Only the quotes in this status will be sent to Zuora.To add your custom status, add the status value to the picklist of the Approval Status field (zqu__ApprovalStatus__c) on the Quote object (zqu__Quote__c).File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enable Billing Discount DistributionControls whether Discount charge metrics will be aggregated on the Discount line item or be spread out to the various other charges that it affects. If enabled, the Billing Discount will be populated for all discounted charges and related objects. If disabled, the aggregate Billing Discount will be present only for the Discount Charge and related objects. Requires WSDL versions 80.0+.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Get Subscriptions from 360

    Select to obtain Subscription information directly from Zuora 360 in Salesforce when populating the Select Billing Account page of the Quote Wizard.

    We recommend that you have Real-time Sync enabled when using this setting to always have the most up-to-date subscription data.

    Irrespective of this setting, CPQ X will consistently retrieve Subscription details from Zuora 360 in Salesforce for the lists generated in the Billing Account Selector Page. Moreover, CPQ X will always retrieve Subscription details for Amendment and Renewal Quotes directly from Zuora Billing via API, regardless of this setting.

    File:Z_Media/checkmarkGreen_xsm.png
    Enforce Unique Subscription Quote Number

    Select to prevent a quote from being sent to Zuora if there is an existing subscription with the same quote number.

    When you clear this setting, the check for duplicate subscriptions is turned off when quotes are sent to Zuora.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Hide Original One-Time ChargesSelect to hide the existing one-time charges on the amendment/renewal quotes.This setting must be used in conjunction with the View Amend Quote as of Quote Start Date setting under Zuora Config > Quote Studio Settings > Admin Config.
    • When the View Amend Quote as of Quote Start Date setting is enabled and the Hide Original One-Time Charges setting is disabled, the original One-Time charges will be visible in the amendment and renewal quote types.
    • When both the View Amend Quote as of Quote Start Date setting and the Hide Original One-Time Charges setting are enabled, the One-Time charges will not be visible in the amendment and renewal quote types.
    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enable Rule Validation on Quote CreationSelect to enable the runValidationRules method in the Quote Rules Engine Plugin being run on the Create Quote page. This setting is by default unselected to improve the quoting performance. See Quote Rules Engine Pluginfor more information.File:Z_Media/checkmarkGreen_xsm.png
    Default Trigger DatesSelect to allow Service Activation Date and Customer Acceptance Date inherit from Contract Effective Date.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Amend List Price to Effective PriceSelect to set the list price of the Quote Rate Plan Charge to that of the Subscription Rate Plan Charge on renewal and amendment quotes for non-tiered charges.File:Z_Media/checkmarkGreen_xsm.png
    Disable chatter feed from QuoteSelect to disable the Chatter feeds from quotes.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Disable Edit Product in Quote DetailSelect to disable the editing access of product details on the Quote Detail page.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Quote PDF Processing Options
    Use SFDC Locale to Format Quote DOCSelect to allow the quote document to be formatted using the locale of the Salesforce user.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Attach Quote PDF/DOC

    Select to automatically attach the quote PDF or Word document to the quote or the opportunity.

    • If this option is selected and if a quote was created for an opportunity, the quote file is attached to the opportunity.
    • If this option is selected and if a quote was created without an opportunity, the quote file is attached to the quote.

    If this option is cleared, you must open and view the quote PDF or Word document and save it manually.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Attach PDF/Word documents as FilesSelect to enable quote documents to be attached as files.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Quote Processing Options
    Update Opportunity Amount with Quote TCVSelect to copy the Quote TCV amount to the Opportunity Amount field when a quote is created or updated.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Auto-replace Expired Rate PlansSelect to automatically replace an expired rate plan when creating a renewal quote and the subscription contains an inactive rate plan (past the expiration date set in the product catalog).File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Electronic Payment Method Processing Options
    Electronic Payment Method Setting

    Determines how an electronic payment method is treated when sending a new subscription quote to Zuora.

    To learn how this setting affects the payment processing in Zuora, refer to Process Payments in Zuora Billing.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Send to Zuora Processing Options
    Allow Zuora Account Info to be UpdatedSelect to allow users to use Salesforce data to update Zuora billing account and contact information. See below for more information about this setting.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Generate Invoice

    Select to automatically generate an invoice when the subscription is created in Zuora.

    The setting you select here is a default value at the organization-level. You can override this org-default value when creating a new quote.

    By default, this option is not set.

    If this option selected, configure Zuora to invoice subscriptions separately.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Process Payments

    Select to automatically apply a payment when the subscription is created in Zuora.

    The setting you select here is a default value at the organization-level. You can override this org-default value when creating a new quote.

    If this option is selected, configure the Zuora application to invoice subscriptions separately.

    If this option is selected, you need to set up an electric payment method through Hosted Payment Method Pages or Payment Pages. Otherwise, you will not be able to submit quotes to Zuora.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Apply Credit BalanceSelect to automatically apply any credit balance on a customer account to invoices when sending quotes with the Generate Invoice setting enabled.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Always Set Amendments to 'Active' Status

    Select to set the status of Zuora Quotes amendments and renewals to Active when the quotes are sent to Zuora.

    If the Service Activation Date is blank, the Service Activation Date is set to the same date as the Contract Effective Date.

    If the Customer Acceptance Date is blank, the Customer Acceptance Date is set to the same date as the Service Activation Date.

    Zuora recommends enabling this option.

    You can send an amendment quote to Zuora in the Pending status by leaving the required trigger dates blank. If you want to be able to send amendment quotes in the Pending status, do not enable this setting.

    File:Z_Media/checkmarkGreen_xsm.png
    Quote Read-Only after Sent to ZuoraSelect to change quotes to read-only status after they are sent to Zuora. When this option is selected, the Edit button is removed from the Quote view.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Autofill Dates for Quote Metrics Preview

    Select to automatically fill blank trigger dates on the quote when previewing quote metrics on the quote detail page.

    If the Service Activation Date is blank, the Service Activation Date is set to the same date as the Contract Effective Date.

    If the Customer Acceptance Date is blank, the Customer Acceptance Date is set to the same date as the Service Activation Date.

    Note that this setting will not be effective if you enable Orders.

    File:Z_Media/checkmarkGreen_xsm.png
    Allow Invoice SeparatelySelect to allow invoice separately on the Salesforce side. If both this setting and the "Enable Subscriptions to be Invoiced Separately?" setting on Zuora Billing are enabled, the zqu__InvoiceSeparately__c field value on your quote will be sent to Zuora as it is.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enable High Volume QuotingSelect this check box to enabled the High Volume Quoting feature. See Manage Existing Products on a Subscription for more information.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enable Ramp Metrics

    This setting is available only if Orders is enabled. Select this check box to enable the calculation of ramp metrics when previewing multi-interval updates. Enabling this setting will also automatically turn on the Ramp toggle when you create an amendment or renewal quote for a subscription with ramp. See the following articles for more information:

    • Set up Ramp Metrics

    • Add mid-interval updates to ramp deals

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enable Billing Docs OverrideThis setting is available only if Orders is enabled. Select this check box to take advantage of the following Invoice Settlement features on quote submission:
    • Apply Credit
    • Change order that unapplied credits and unapplied payments are applied
    • Override sequence set
    • Override Debit Memo Template
    • Override Credit Memo Template

    This setting should be enabled if both Orders and Invoice Settlement are enabled in your Zuora tenant.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Legacy Support: Send SF Custom Fields to Zuora as StringWith this setting enabled, the Salesforce Custom Fields are sent to Zuora as string as they were before April 2023, providing backward compatibility for existing integrations.

    This setting is disabled by default after upgrading to version 10.24. You can create custom fields of different types (Boolean, Integer, Number, Date) in Salesforce and map them to corresponding custom fields in Zuora.

    If you add fields to the Retain Custom Field Data Type object fieldsets of Account, Quote, Quote Rate Plan, Quote Rate Plan Charges, Quote Amendment, and Quote Order Line, then those custom field values retain the original data type, such as boolean, number, or date, and will not be converted to string while sending data to Zuora.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Default Order/Booking Date to TodayThis setting determines the default behavior for sending Booking Dates to Zuora.
    • When this setting is disabled and no date is specified in the Quote Order Date field, the Quote Start Date will be set as the Order/Booking Date.
    • If the setting is enabled and no date is specified in the Quote Order Date field, it will automatically set the Order/Booking Date to today's date. By default, this setting will be disabled.

    To translate Quote Order Date to Booking Date, see Translate object field labels and help text.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Field Configurations
    Enable Invoice OwnerSelect to allow users to specify the invoice owner on the quote.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enable Parent Customer AccountSelect to allow users to specify the parent customer account when creating a new subscription quote with a new billing account.File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png
    Enforce Single Primary Quote

    When this setting is selected:

    • Updating or inserting a primary quote disables the primary flag on other quotes on the opportunity.
    • Sending a primary quote to Zuora disables the primary flag on other quotes on the opportunity.

    This setting is not supported for Multi Subscription Quoting.

    File:Z_Media/checkmarkGreen_xsm.png
    Whitelist FieldSet Name

    The API name, including the namespace, of a field set that contains the user-defined custom fields that should be tracked by Zuora Quotes.Zuora Quotes tracks the standard fields and custom fields that are included in the field sets of the managed package. If there are additional custom fields you need to track, add those fields to this field set.If you need to track custom fields in other packages, e.g. Zuora 360, create a custom field set, add the custom fields to the field set, and specify the field set API name in this setting.

    Only one whitelist field set is tracked per object, and that field set must have the same name that is configured in this setting.

    See Whitelist Field Set Code Sample and Use Case for a code sample for the whitelist field set.

    Starting in Version 8.8.1, you can also use this setting to populate additional fields in Product Selector JavaScript plugin . See Whitelist Field Set Code Sample and Use Case for a sample use case.

    File:Z_Media/checkmarkGreen_xsm.pngFile:Z_Media/checkmarkGreen_xsm.png