Loading

Renewal Opportunity Not Created or Deleted in Salesforce CPQ

Publiceringsdatum: Oct 12, 2026
Beskrivning

When the Renewal Forecast checkbox is set to True on a Contract in Salesforce CPQ (Configure, Price, Quote), the renewal can produce unexpected results in Lightning Experience or Salesforce Classic. Users may be unable to create a Renewal Opportunity, the Renewal Opportunity may contain no Opportunity Products, or the renewal records may be deleted immediately after creation. The renewal may also remain in an "In Progress" status or return an error message.

Renewal Forecast Process

Setting Renewal Forecast to True automates the creation of a Renewal Opportunity. The Renewal Opportunity holds all renewable products from the primary Quote of the original Opportunity. The Salesforce CPQ process runs in the following sequence:

  1. Create a new Renewal Opportunity.
  2. Create a temporary "ghost" Quote, which is a Quote that is never saved as a permanent record.
  3. Generate temporary "ghost" Salesforce CPQ Quote Lines.
  4. Run calculations on the Quote and Quote Lines.
  5. Sync products from the Quote Lines to Opportunity Products.
  6. Delete the temporary "ghost" Quote and Quote Lines.

A failure at any step can result in missing Opportunity Products, a missing Renewal Opportunity, or a renewal that never completes. Common causes include products that are not configured as renewable, validation failures, invalid Account Hierarchy data, multiple Master Contracts, and a disconnected calculation service.

For background on the feature, see Renew a Contract with Salesforce CPQ.

Lösning

The following troubleshooting steps identify why a Renewal Opportunity or its Opportunity Products are missing, deleted, or stuck, and explain how to correct each cause. Review the causes in order, starting with the most common.

Products Missing from Renewal Opportunity

Symptom: The Renewal Opportunity is created, but expected Opportunity Products are absent.

Cause: Only renewable products are carried to the Renewal Opportunity. A product is not renewable when its Salesforce CPQ Quote Line fields are not set correctly.

Fix:

  1. Open the original Quote and review the Quote Lines for the missing products. The fields that determine renewal behavior are visible.
  2. Confirm that Subscription Pricing is populated. A blank value means the product does not generate a subscription.
  3. Confirm that Subscription Type is set to "Renewable". Any other value means no renewal line is created.
  4. Update the product configuration as needed and re-contract if the renewal data must reflect the change. Subscriptions on the Contract then include the renewable products.

Preserve Bundle Structure for One-Time Products in Bundles

Symptom: One-time products inside bundles do not appear on the Contract or the renewal.

Cause: The Preserve Bundle Structure field is not set to True at the applicable level.

Fix:

  1. Set Preserve Bundle Structure to True in the Salesforce CPQ package settings, on the Account, or on the Contract.
  2. Note the precedence: the package-level value flows to newly created Accounts, which default the value to the Account's Contracts. A value set on the Account or Contract overrides the package-level setting.
  3. Update historical records manually, because changes are not retroactive and existing Contracts do not receive the new value.

Renewal Still Processing

Symptom: Quote Lines have not yet converted into Subscriptions, or the Renewal Opportunity shows no Opportunity Products.

Cause: Contract and renewal processing can take time.

Fix:

  1. Refresh the Contract page until the Quote Lines appear as Subscriptions on the Contract record.
  2. Refresh the Renewal Opportunity page until the ghost Quote is gone and the Opportunity Products are generated.
  3. Avoid editing the Renewal Opportunity while processing continues. Edits during processing can interfere with product creation.

Ghost Quote Visible During Processing

Symptom: A temporary Quote appears in the user interface while the renewal is processing.

Cause: The Renewal Opportunity is built from a ghost Quote, which holds the data needed to create Opportunity Products. The Quote is deleted when processing finishes.

Fix:

  1. Do not select or update the ghost Quote.
  2. Review any Salesforce CPQ price rules or other automation on the Quote object, because these fire when the ghost Quote is created.
  3. Update the conditions of any automation that should not run during renewal, so that failures or unwanted changes do not interrupt Opportunity Product creation.

Contract Generation Errors

Symptom: Contracts fail to generate, so no renewal data is available.

Cause: Contract generation failures are reported in different places depending on the Contract in Foreground setting. This Salesforce CPQ package setting controls whether contracting runs immediately on the page or as a background process.

Fix:

  1. If Contract in Foreground is False, open Apex Jobs from Setup. Apex jobs are background processes, and a failed job identifies the contract generation failure.
  2. If Contract in Foreground is True, read the error message that appears on the page from which contracting started.
  3. Check for validation rules that block the creation of the Opportunity or Quote, and confirm that the Contract has a Renewal Term populated. Opportun
Knowledge-artikelnummer

000390198

 
Laddar
Salesforce Help | Article