Use this action to apply promotions to a cart based on specified inputs. For example, a sales rep can use this action to apply the promotions applicable to internet packages to a customer.
Required Editions
| Available in: Lightning Experience |
| Available in: Enterprise, Unlimited, and Developer Editions |
Industries CPQ API Used to Invoke Apply Promotions to Cart Invocable Action
Note When a promotion is applied, promotion-level attribute overrides take precedence over
bundle-level overrides for child products. If both exist, the system applies only the
promotion-level overrides and ignores those at the bundle level. However, if no promotion-level
overrides are present, the bundle-level overrides will apply as expected.
- postCartsPromoItems
Input Values
| Parameter | description | data type |
|---|---|---|
| cartId | The ID of the quote or order record for which a promotion must be applied. | String |
| promotionId | The ID of the promotion to apply to a quote or an order. | String |
| price | Optional: A Boolean value that indicates whether to update the price of the cart after applying the promotion. The default value is true. | Boolean |
| validate | Optional: A Boolean value that indicates whether to validate the configuration of the cart after applying the promotion. The default value is true. | Boolean |
Output Values
| Parameter | description | data type |
|---|---|---|
| error | An error due to which the promotions weren't applied. | String |
| messages | A message indicating whether the promotions were applied. | String |
Example
JSON Request
cartId = (801Dn000000vRSOIA2)
promotionId = (a3XDn000000dE4NMAU)
JSON Response Body
error (null)
message (Promotion added successfully)