Skip to main content

Configuring promotions

Configuring a global exclusion list

You can create a list of products that must never be discounted during a purchase. For example, products like gift cards and carry bags are never discounted by a retailer.

Products in the exclusion list will not be discounted when an order discount, an item discount, or a coupon code is applied to the cart. Automatic promotions cannot be applied to these products either.

To check the current list of global excluded products for your business, use the Get promotions config method.

To modify a list of global excluded products:

  1. Use the Update promotions config, or delete promotions config method.
  2. For updating the list, in the ids property, specify a list of product IDs to which no discounts or promotions can be applied during checkout.

Configuring reason codes for manual discounts (from v1.50.0 to v1.51.0)

Supported from
This feature is supported from Associate App v1.50.0.

You can create a list of reason codes for manual discounts. Associates can use these to specify reasons to offer manual discounts to a customer. You can configure these reason codes when offering manual discounts on:

  • The whole cart or order, or
  • Individual items
note

This feature is not available when the Associate App is offline.

Before you start creating or using reason codes, ensure that you have enabled the feature. Use the Update app configuration method and set capabilities > reason_codes_enabled to true.

To view the list of reason codes, use the List reason codes method.

To create a new reason code:

  1. Use the Create reason codes method.

  2. Specify a code for the reason in code and a relevant name in name.

    For example, dmgd and Damaged for manual discounts to be offered on damaged or defected items in the store.

These reasons will be available in the app for the associate when offering manual discounts to the customer. See Adding discounts and redeeming coupons .

Important
  • Ensure that the value defined in the Accept-Language property matches the locale set for the store.
  • To allow associates to enter a manual discount or price override value, ensure that you create a reason code for the store's specified locale.

To update a reason code, use the Update reason code method.

To delete a reason code, use the Delete reason codes method.

Configuring reason codes for manual discounts (from v1.52.0)

Supported from
This feature is supported from Associate App v1.52.0.

You can create a list of reason codes for manual discounts. Associates can use these to specify reasons to offer manual discounts to a customer. If no reason codes are specified for a given catalog, the Associate App will display a free text field to enter the reason for the discount. You can configure the reason codes when offering manual discounts on:

  • The whole cart or order, or
  • Individual items
note

This feature is not available when the Associate App is offline.

To view the list of reason codes, use the List reason codes method.

To create a new reason code:

  1. Use the Create reason codes method.

  2. Specify a code for the reason in code and a relevant name in name.

    For example, dmgd and Damaged for manual discounts to be offered on damaged or defected items in the store.

These reasons will be available in the app for the associate when offering manual discounts to the customer. See Adding discounts and redeeming coupons .

Important
  • Ensure that the value defined in the Accept-Language property matches the locale set for the store.
  • To display a free-text field for associates to enter a custom reason, ensure that you do not create a reason code for the store's specified locale.

To update a reason code, use the Update reason code method.

To delete a reason code, use the Delete reason codes method.

Configuring price overrides for items (v1.50.0 and v1.51.0)

To enable overriding the catalog price of an item in Associate App:

  1. Use the Update app configuration method.
  2. In customizations > cart_management_v2, add priceOverride.

Configuring price overrides for items (v1.52.0 or later)

Supported from
This feature is supported from Associate App v1.52.0.

Starting with version v1.52.0, this feature is available along with the item discount feature.

Related topics