You are here:
Price a Master Quote Using an External Pricing Engine
You can price a Multi-Site Quote or Order by getting prices from pricing sources defined within CME, such as price lists, or through a third party pricing application.
The external pricing requests are processed asynchronously, which means that the price quote response does not immediately follow your request for it. It may take any length of time between a few minutes to a few days before you receive the pricing information from the external source. The response time depends on the external pricing engine that processes the request.
Requesting pricing for a master Quote or Order from an external source is an optional step. Industries CPQ pricing is available by default.
This feature is exclusively supported in the Hybrid CPQ setup.
This feature uses Vlocity Integration Procedures to send and receive price quotes from an external pricing engine. See Vlocity Integration Procedures for External Pricing.
Price a Master Quote Using External Asynchronous Pricing
Learn how to receive a price quote from an external source.
- Create the master Quote or Order and its groups. See Create a Multi-Site Quote or Order in Industries CPQ.
- Validate and price the quotes. See Validate, Price, and Submit a Multi-Site Quote or Order in Industries CPQ.
- Switch to Salesforce Classic view and locate the Opportunity from which the master Order was originally created in Industries CPQ.
- Click Edit Layout, add Multi-Site Quote or Multi-Site Orderbutton to the Opportunity object page, and save the changes.
- Click Multi-Site Quote or Multi-Site Order on the Opportunity object.
- Review the master Quote or Order in the list and then select it.
- Click Master Quote or Master Order on the progress bar above the cart after you validate and price the Quote or Order.
-
Select the master Quote or Order for which you want to request external pricing and
refresh the page.
The External Pricing Status field changes to Ready. See Price a Master Quote Using an External Pricing Engine.
NoteYou can configure custom fields for the External pricing feature. See Price a Master Quote Using an External Pricing Engine.
- Click the arrow on the action buttons and click Request External Pricing.
- Click Yes.
- After the external engine confirms the request, the system updates the status to Request confirmed.
- Click the arrow on the action buttons and click Get External Pricing.
- Click Yes on the confirmation message.
-
When the system receives the quote price from the external source., it updates the
master Quote or Order with the pricing information.
External Pricing Status changes to Completed.
NoteIf you reconfigure the master Quote or Order after submitting the request, the pricing request is no longer applicable and the status changes to Invalidated. You must make a new request with the new configuration.The external pricing request expires if there is a session timeout before the external engine confirms the request. The status on the page changes to Expired. Submit the request again.
- Submit the order. See Validate, Price, and Submit a Multi-Site Quote or Order in Industries CPQ.
External Pricing Statuses
This section provides a list of the available pricing status options and descriptions when you submit a pricing request for a master quote or order to an external pricing engine.
See Price a Master Quote Using an External Pricing Engine.
Status |
Indicates that... |
|---|---|
Not Ready |
The master Quote or Order is not ready for external pricing. You must validate and price each group member. This is the default value. |
Ready |
The master Quote or Order is ready for external pricing. The system validates the master Quote or Order during
validation and pricing using the |
Requested |
The Vlocity system has sent a request for a price quote to an external
system. The system uses the |
Request Confirmed |
The external pricing request is confirmed. The external engine confirms the pricing request either through a call back mechanism or using a platform event. The pricing request status changes to Request Confirmed. |
Invalidated |
The external pricing request is invalidated. When you make configuration changes to the master quote after submitting the request, the pricing request is invalidated and you must make a new request. |
Expired |
The session timed out before the external pricing engine returned the price quote. Make the request again. |
Completed |
The external pricing received from the third-party pricing engine is
updated successfully in the Vlocity system. The system uses the |
Configure Custom Fields for External Pricing
You can configure custom fields for the External Pricing feature, for example, configure the External Pricing status field for displaying on the Multi-Site Select page.
To configure external pricing fields:
- Log in to Salesforce.
- Click Setup on the right. Search for Custom Settings in the Quick Find box.
- Find Field Settings. To narrow down your search, click F in the alphabet index.
- Click Field Settings and then click Manage.
- To add a new custom field, click New.
-
Enter the following information.
Field
Description
Name
Enter a unique name for the field, for example, ExternalPricingStatus.
Field Name
Enter an API name for the field, for example, h_cpq_ExternalPricingStatus__c.
Feature
Enter the feature name, for example, MultiServiceMasterCartFields.
Object Name
Enter an object name, for example, Quote or Order.
Inclusion
Select the checkbox.
Is editable
Select the checkbox.
Sequence
Enter a number, for example, 4. This indicates the sequence in which the field will appear on the Multi-Site Select page.
The following image displays the custom field configured for External Pricing on the Multi-Site Select page:
Vlocity Integration Procedures for External Pricing
The Vlocity external pricing feature uses the following Vlocity integration procedures (VIP) to send and receive pricing requests from an external pricing engine. The VIPs are invoked when you click the action buttons on the Multi-Site Select page at the time of requesting a price quote from an external pricing engine.
Out of the box, these VIPs do not actually integrate with any external pricing engines. They are placeholders that you must configure to interact with external pricing engines.
VIP |
Used when... |
|---|---|
Validate And Update External Pricing Status |
You price and validate the master Quote or Order. It validates whether a master Quote or Order is configured to receive a price quote from an external engine and updates the status from Not Ready to Ready. |
Request External Pricing |
You click the Request External Pricing button on the Multi-Site Select page. It sends a request for pricing to an external pricing engine. The pricing status changes from Ready to Requested. The external pricing engine confirms the pricing request either through a call-back mechanism or through a platform event and the status changes from Requested to Request Confirmed. |
Get External Pricing |
You click the Get External Pricing button on the Multi-Site Select page. It gets the price quote from the external pricing engine and updates the master Quote or Order with the new price. The status changes from Request confirmed to Completed. |
