--- schema_version: "1" id: 025ea6e278c9e7492107c7dd784ca997ffd43caa05f25d0037ead4f6d8b05d67 title: ConnectApi.PromotionEvaluateInput collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_connectapi_input_promotion_evaluate.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_promotion_evaluate.htm source_site: developer.salesforce.com content_type: documentation content_hash: 2080b2c89109b3f18ed4297b889441f8a2a45a844ada0af940fb8aa48c912068 description: Find promotions that the customer is eligible for and compute their discounts. --- # ConnectApi.PromotionEvaluateInput Find promotions that the customer is eligible for and compute their discounts. | Property | Type | Description | Required or Optional | Available Version | | --- | --- | --- | --- | --- | | cart | [ConnectApi.PromotionCart​Input](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_promotion_cart.htm "Cart during promotion evaluation.") | Cart and its items. | Required | 57.0 | | cartDelivery​Groups | [List](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list "Contains methods for the List collection type.")<[ConnectApi.PromotionCartDeliveryGroupInput](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_promotion_cart_delivery_group.htm "IDs of the cart delivery group and its delivery method.")\> | List of cart delivery groups associated with the items in the cart. Available if shipping promotions are enabled. | Required when evaluating shipping promotions | 57.0 | | couponCodes | [List](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list "Contains methods for the List collection type.") | Collection of coupon codes to enable promotions. A customer can apply a maximum of two coupons per cart. | Optional | 57.0 | | effectiveAccount​Id | String | ID of the account for which the request is made. | Required if segments isn’t specified | 57.0 | | isItemizeHeader​Adjustments | Boolean | Specifies whether order-level adjustments are itemized (true) or not (false). If unspecified, the default value is false. | Optional | 57.0 | | parentProducts | [List](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list "Contains methods for the List collection type.")<[ConnectApi.​PromotionParent​ProductsInput](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_promotion_parent_products.htm "IDs of a parent product and variation product.")\> | Collection of parent product IDs mapped to their variation product IDs. | Optional | 57.0 | | productCategories | [List](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list "Contains methods for the List collection type.")<[ConnectApi.​PromotionProduct​CategoriesInput](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_promotion_product_categories.htm "IDs of a product and associated category.")\> | Collection of product IDs mapped to their associated category IDs. | Optional | 57.0 | | segments | [List](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list "Contains methods for the List collection type.") | All promotions associated with promotion segments specified in this collection are active and can be evaluated against the cart. Additionally, any segments associated with a store or buyer group are also still evaluated against the cart. If this field is not present, only the promotions associated with a store or buyer group are evaluated. | Optional | 57.0 | | webStoreId | String | ID of the store for which the request is made. If unspecified, defined segments must be used instead. | Optional | 57.0 | #### See Also - [evaluate(salesTransaction)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_CommercePromotions_static_methods.htm#apex_ConnectAPI_CommercePromotions_evaluate_1 "Determine which promotions the customer is eligible for based on the store and buyer group, and compute the applicable price adjustments based on the coupons and the items in the cart. This API evaluates only the first 50 active manual promotions and first 50 active automatic promotions, based on priority. This API computes and returns applicable price adjustments, but it does not apply those adjustments to the webcart record. If you want to enable promotions based on shipping, contact Salesforce Customer Support.")