You can suspend an asset for a particular period of time, which means the asset is temporarily not in effect. For example, ABC Corp is an electricity service provider who has installed meters at customer locations to measure the usage of the electricity. ABC Corp bills its customers based on their usage of the electricity. If a customer does not pay the bill for some time, a finance operations user from ABC Corp suspends the electricity service for that customer until the customer pays the due bill.

When an asset is suspended, it is not available for any other ABO action (except Terminate) until you manually resume it. You can suspend assets only through Suspend APIs (SOAP and REST), but not on the UI. For more information, see Suspending Assets and CPQ Asset-Based Ordering APIs.

You must create and pass a business object (quote, agreement, or order) to be associated with the cart. When you execute the Suspend API code in the Developer Console, CPQ creates a transactional cart with the associated business object. After executing the API, the Asset Status field on asset line item is Pending Suspension. Upon order activation, the Asset Status field on asset line item is Suspended.

Key Points to Note

  • The Pricing Status for the suspended asset line items on product configuration is Complete. CPQ does not perform pricing calculations on a cart if it has suspended assets.
  • The Constraint Status Check for the suspended asset line items on product configuration is Complete. CPQ does not execute constraint rules on a cart if it has suspended assets.
  • When you finalize the cart (using only the Finalize API), CPQ generates the respective line items for the associated business object. If the cart is a associated with a quote, agreement, or order, CPQ generates the proposal line items, agreement line items, or order line items respectively.
  • A cart can only consist of line items with status Suspended. You cannot select line items with any other status because CPQ does not execute pricing or constraint rules on a cart if it has suspended assets.