This method enables you to update the price for items in a given cart. Only line items in pending status are updated.

APISignature
updatePriceForCartwebService static Apttus_CPQApi.CPQ.UpdatePriceResponseDO updatePriceForCart(Apttus_CPQApi.CPQ.UpdatePriceRequestDO request)


Parameters
NameTypeDescription
RequestApttus_CPQApi.CPQ.UpdatePriceRequestDOThis is the request data object.


Request Data Object - Apttus_CPQApi.CPQ.UpdatePriceRequestDO
FieldTypeDescription
CartIdIDThe Id of the cart to update the price for.


Response Data Object - Apttus_CPQApi.CPQ.UpdatePriceResponseDO
FieldTypeDescription
CompletedLineNumbersList<Integer>The list of line numbers representing line items that were updated in the current update price invocation.
IsPostPricePendingBooleanIndicates whether the execution of post-price logic is pending.
IsPrePricePendingBooleanIndicates whether the execution of pre-price logic is pending.
IsPricePendingBooleanIndicates whether there are more items to update in future invocations. The caller needs to invoke the update price method in a separate transaction. This should be repeated until there are no more items pending.
IsTotalPricePendingBooleanIndicates whether the calculation of the total price is pending.
PendingLineNumbersList<Integer>The list of line numbers in pending status after the method completes.


Code Sample

The sample below enables you to update the net price in the cart for pending line items. In the sample below, with a single call of updatePriceForCart API, the API computes the net price for a single line item with status pending. updatePriceForCart API is invoked using <apex:actionPoller> command until compute net price operation is completed for all the line items in the cart.   For example, there are 10 line items in the cart and you invoke updatePriceForCart API 10 times at a regular interval of 5 seconds using <apex:actionPoller> command to complete the computing net price operation for all 10 line items.  
 

 <apex:actionPoller action="{!doUpdatePrice}" rerender="MessageID" interval="5" rendered="{!actionPollerActive}" enabled="{!actionPollerActive}"/> .
CODE

In the sample below the action poller is executed as soon as the page is loaded. The hasPendingitems flag returns false since no pending items have been added to the cart yet. If a valid cartID has been passed as an argument to the API and isPricePending returns true, run the action poller and invoke the updatePriceforCart API. The action poller does not run when hasPendingitems=false. You can invoke this API when the user adds discounts to the cart and clicks Reprice.
 

public void updatePriceforCart()
{
	hasPendingItems = false;
	actionPollerActive = true;
		
	if(String.isBlank(cartId))
	{
		ApexPages.addMessage(new ApexPages.Message(ApexPages.severity.info, 'Please create cart.'));
		
		objUpdatePriceRequestDO = new Apttus_CpqApi.CPQ.UpdatePriceRequestDO();    
	}
	else
	{
		// create the update price request
		objUpdatePriceRequestDO = new Apttus_CpqApi.CPQ.UpdatePriceRequestDO();
		
		// add request parameters
		objUpdatePriceRequestDO.CartId = cartId;
		
		// update price for the cart
		Apttus_CpqApi.CPQ.UpdatePriceResponseDO result = Apttus_CpqApi.CPQWebService.updatePriceForCart(objUpdatePriceRequestDO);
		
		hasPendingItems = result.IsPricePending;
		 
		// Start the action poller. If isPricePending=true returns true, run the action poller and the updatePrice API is invoked again
		if (hasPendingItems) 
		{
			actionPollerActive = true; 
			flagUpdatePrice = true;
		}
	}
}

// invoke the following in a new transaction using action poller
public void doUpdatePrice() 
{           
	
	// update price for the cart

	if(String.isNotBlank(cartId) && flagUpdatePrice == true)
	{
		// create the update price request
		objUpdatePriceRequestDO = new Apttus_CpqApi.CPQ.UpdatePriceRequestDO();
		
		// add request parameters
		objUpdatePriceRequestDO.CartId = cartId;
	
		Apttus_CpqApi.CPQ.UpdatePriceResponseDO result = Apttus_CpqApi.CPQWebService.updatePriceForCart(objUpdatePriceRequestDO);
		 
		hasPendingItems = result.IsPricePending;
		List<Integer> pendingLineNumbers = result.PendingLineNumbers;
		List<Integer> completedLineNumbers = result.CompletedLineNumbers;
		
		if( hasPendingItems == false && completedLineNumbers.size() != 0 )
		{
			// stop the action poller
			actionPollerActive = false;   
		} 
		else if( hasPendingItems == true && pendingLineNumbers.size() > 0 )
		{
			actionPollerActive = true;
		}
	}  
} 
CODE

Integration Details

Use the following information in your integrations with Apttus CPQ Web Services API. Refer to Integrating Apttus with External Systems for information on how to get started.

API Prerequisites

Response/Request XML

Example Request (click to expand)

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns:cpq="http://soap.sforce.com/schemas/class/Apttus_CPQApi/CPQWebService"
    xmlns:cpq1="http://soap.sforce.com/schemas/class/Apttus_CPQApi/CPQ">
    <soapenv:Header>
        <cpq:SessionHeader>
            <cpq:sessionId>00DZ000000NAEIA!ASAAQLC3rla0VIl_gk7v0A9K1n7dLEcCAANQHwNfXAPFKZEH292fAdeal5Nps8X2klNu98fcp6usnVFmzKARwE99xq_dE8U6</cpq:sessionId>
        </cpq:SessionHeader>
    </soapenv:Header>
    <soapenv:Body>
        <cpq:updatePriceForCart>
            <cpq:request>
                <cpq1:CartId>a1OZ0000002ZQVZ</cpq1:CartId>
            </cpq:request>
        </cpq:updatePriceForCart>
    </soapenv:Body>
</soapenv:Envelope>
XML

Example Response (click to expand)

<soapenv:Envelope
    xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
    xmlns="http://soap.sforce.com/schemas/class/Apttus_CPQApi/CPQWebService"
    xmlns:UpdatePriceResponseDO="http://soap.sforce.com/schemas/class/Apttus_CPQApi/CPQ">
    <soapenv:Body>
        <updatePriceForCartResponse>
            <result>
                <UpdatePriceResponseDO:CompletedLineNumbers>1</UpdatePriceResponseDO:CompletedLineNumbers>
                <UpdatePriceResponseDO:IsPostPricePending>false</UpdatePriceResponseDO:IsPostPricePending>
            </result>
        </updatePriceForCartResponse>
    </soapenv:Body>
</soapenv:Envelope>
XML