Loading

Revenue Cloud Advanced: Renewal opportunity creation fails with missing renewalTerm and renewalTermUnit on RCA-generated assets

Publish Date: May 27, 2026
Description

This article explains why renewal opportunity generation fails on assets produced by Revenue Cloud Advanced (RCA) standard asset generation flows and how to resolve it. Customers describe the issue as: "We are not able to generate renewal opportunities for assets that are created with standard RCA flows. We are getting an error that we are missing renewalterm and renewaltermunit fields" and "These fields generated on assets fine before but we recently started implementing RCA's method of generating assets and contracts and since we made that change it no longer populates those fields." The error occurs when the 'Create and Update Renewal Opportunities' flow runs against an Asset whose Renewal Term [RenewalTerm] and Renewal Term Unit [RenewalTermUnit] fields are blank. Per Revenue Cloud asset renewal scenarios, an asset created from a New Sale order without a contract derives its renewal term and unit from the order item's pricing fields; if those fields are missing on the order item, the system creates the asset without renewal details and blocks any later renewal attempt. An asset created from a New Sale order with a contract intentionally leaves the asset's renewal fields blank and reads them from the contract during renewal — if both the asset and contract lack the values, or the renewal is initiated from the Account Asset Viewer (which does not pass a contract), the validation error appears. This scope applies to Revenue Cloud Advanced (Enterprise, Unlimited, and Developer Editions) orgs where Transaction Management is enabled and standard RCA asset and contract generation is in use, including orgs that converted legacy CPQ Subscription records into Assets during migration.

Resolution

Resolve the missing-renewal-fields validation by populating the renewal term values on the correct record for the scenario, then retry renewal opportunity creation.

Cause 1: Asset created from a New Sale order without a contract
1. Open the affected Account record and locate the Managed Asset Viewer component on the Account page layout.
2. In the Managed Asset Viewer, select the affected Asset row.
3. Edit the Asset and set Renewal Term [RenewalTerm] to the numeric term length (for example, 12) and Renewal Term Unit [RenewalTermUnit] to the correct unit (for example, Months).
4. Save the Asset.
5. To prevent recurrence on future assets, navigate to Setup > Object Manager > Order Product [OrderItem] and verify that Renewal Term and Renewal Term Unit (or the equivalent pricing fields used by your RCA configuration) are populated on the source order item before activation. Update your order creation process to set these values on every subscription Order Product.

Cause 2: Asset created from a New Sale order with a contract, but the contract is missing renewal values
1. Open the Contract record associated with the asset.
2. Set Renewal Term [RenewalTerm] to the numeric term length and Renewal Term Unit [RenewalTermUnit] to the correct unit.
3. Save the Contract.
4. If renewal will be initiated from the Account Asset Viewer (which does not pass the contract context), also populate Renewal Term [RenewalTerm] and Renewal Term Unit [RenewalTermUnit] directly on the Asset record using the Managed Asset Viewer, because the system reads these values from the asset when no contract is supplied.

Cause 3: Future-dated assets with no current Asset Contract Relationship
1. Open the Account page and locate the Managed Asset Viewer.
2. Select the future-dated Asset.
3. Set Renewal Term [RenewalTerm] and Renewal Term Unit [RenewalTermUnit] on the Asset directly, because Salesforce blocks the renewal when no current Asset Contract Relationship (ACR) exists for it to copy from.
4. Save the Asset.

Cause 4: Migrated assets converted from legacy CPQ Subscription records
1. Identify the migrated Asset records that lack Renewal Term [RenewalTerm], Renewal Term Unit [RenewalTermUnit], and (for termed assets) ProductSellingModel [ProductSellingModelId] on the initial sale Asset Action.
2. Use Data Loader to bulk update the Asset records with the correct Renewal Term and Renewal Term Unit values derived from the source contract or subscription.
3. For termed migrated assets, also populate ProductSellingModel [ProductSellingModelId] on the initial sale Asset Action record. This is required for renewal per Known Issue KI-69692.
4. Save the records.

Verification
Confirm the issue is resolved by re-running the 'Create and Update Renewal Opportunities' flow (or activating an Order containing the affected products) against an updated Asset and verifying that a renewal opportunity is created without the missing renewalTerm or renewalTermUnit error.

Knowledge Article Number

005385136

 
Loading
Salesforce Help | Article