Troubleshoot Customer Acquisition Management

Unable to deploy profile and communities in a new org while setting up Customer Acquisition Management. An error message is displayed: A site with the same name already exists in org

The error may be caused if there are two communities with the same URL. As communities created for Customer Acquisition Management do not have any suffixes in the URL, it may conflict with other communities in the target org with the same URL.

If communities are enabled in the target org, ensure that existing communities have suffixes appended to the base URL.

OmniScripts become unresponsive while setting up Customer Acquisition Management. The bill graph in Energy and Utilities Console may also not be visible.

The error may be caused due to Lightning Web Security. To disable Lightning Web Security, follow these steps:

• Click Setup.

• In Quick Find, enter Session Settings and click Session Settings under Security.

• Under Lightning Web Security, deselect the Use Lightning Web Security for Lightning web components checkbox.

• Save your changes.

Errors due to Sites, Profiles and Sharing rules

Click Setup and search All Sites. If there are no sites, enable the Digital Experience settings.

An error message is displayed: No apex named Communities Landing Found

From the master org, copy the contents of CommunitiesLandingController.apxc, CommunitiesLandingControllerTest.apxc and Communities.vfp and paste them in the target org after creating the respective files.

FlexCards may need to be reactivated after activating OmniScripts

FlexCards are sometimes deactivated after components are deployed in your org.

Manually reactivate the following components for Customer Acquisition Management:

• VEEConsumerOfferDetails

• VEEConsumerSelectedCommodityOfferDetails

• VEEConsumerTestimonial

• VEEConsumerFAQ

• VEEConsumerAddOnOfferDetails

• VEEConsumerSelectedCommodityOfferDetails

Refresh Platform cache job is failing

• Change the namespace for your package.

• Execute the following commands in an anonymous window:

  Database.executeBatch(new vlocity_cmt.EPCFixCompiledAttributeOverrideBatchJob(), 1);

  delete [select Id from vlocity_cmt__CachedAPIResponse__c];
  List<Id> productIds = new List<Id>();
  for (Product2 prod : [ Select Id from Product2 where vlocity_cmt__ObjectTypeId__c != null or vlocity_cmt__ProductSpecId__c != null ])
  {
  productIds.add(prod.Id);
  }
  Database.executeBatch(new vlocity_cmt.EPCProductAttribJSONBatchJob(productIds), 1);

Deployment of Sample Permission Sets and Permission Set Groups is failing

For OmniStudio-Enabled orgs, deployment of permission sets may conflict with the existing permission sets and permission set groups related to other apps in your org.

Remove the permission sets and permission set groups related to Large Account Sales Management and Utility Self Service Portal from your org, and then try deploying the permission sets for Customer Acquisition Management.

Unit prices are not displayed while running GetBasketVip

Run Create Pricing Variables and Bundles job along with Populate API Cache jobs in post-deployment steps. For more information, see Run Maintenance Jobs and Refresh the Application Cache for Energy & Utilities.

Premises and service points are not created while running full flow

Ensure that the guest user profile has edit access on Distribution region for premise object.

Unable to process Basket while creating Baskets or getting errors in Offer Details API

This error appears when there are problems in the products configuration. Ensure that the attachments URLs in products are correct.

While submitting an order

This error message appears:

Sorry, we have encountered a technical issue. Please contact your system administrator.

• The JSONResult class is not present in the input in the Create Cart API. From Vlocity CMT Administration tab, check your CPQ configuration Settings and set CacheAPI.CreateCartFromContextKey to True. For more information, see Checking Your CPQ Configuration Settingsand Response Format for Cart-Based APIs.

• Ensure that the VEE guest Users profiles Object setting has Distribution Area enabled.

Error message mentions access issues in the JSON Payload

For example:

success\":false,\"result\":{\"success\":false,\"sessionKey\":\"c2c27bf49105e22f27e9ad4b90ad8c92\",\"result\":null,\"errorCode\":\"INVOKE-500\",\"error\":\"No calculation matrix found with name FixedPriceProducts\"

Create a sharing rule to provide the guest user access to the desired component. For example, a sharing rule needs to be created to provide access to FixedPriceProducts calc matrix.

Launching OS fails on the Customer Acquisition Managementapplication

.

The console displays an error message:

Refused to apply style from ‘https://camdigitalprocess.force.com/null/resource/1603954111000/newport_nds/assets/styles/vlocity-newport-design-system.min.css’; because its MIME type ('text/html') is not a supported stylesheet MIME type, and strict MIME checking is enabled

In the site, click Administration and add some text in URL.

Currency Code is not displayed on the UI of the target org

• In Products, under the Pricing tab change the currency code.

• Delete and regenerate Cached API response records for them.

• Clear the platform cache to avoid stale cache records bring picked by the Vlocity Integration Procedure (VIP).

Newly added product does not appear in Customer Acquisition Management

• From the App Launcher, search for Product, and click Vlocity Product Designer.

  To add a new product in the Products tab, follow the steps in Add Product Specification to the Reference Product Model.

• If the product is listed in the Products tab and is not visible in Customer Acquisition Management, follow the steps in Refresh Product Cache for Customer Acquisition Management.

In the Digital Experience site, if you click Get Personalized Quote, enter the details and then click Next, the list of products should be displayed. If the requested criteria does not generate a CachedApiResponse record, it may display an error message: Sorry, we have encountered a technical issue. Please contact your system administrator.