Enabling fix JR56347

JR56347 introduces a new parameter that changes the behavior of coupons. The new behavior is enabled by default.

Before you begin

Install one of the following maintenance packages:
  • WebSphere Commerce Version 8.0.3.0 or later

About this task

This fix changes the default behavior of how coupons are applied, so that one coupon gives only one discount, instead of one coupon being allowed to give multiple discounts. This parameter is enabled by default.

This fix does not affect order level promotions, shipping level promotions, and any product or category level promotions using subtotals. The promotion types affected are shown in the following table that summarizes the changes made by this fix:
Default promotion type Flag = on; multiple coupons are redeemable on the order. Each coupon gives a single 'reward' (i.e. amount off, percentage off, fixed price). The number of coupons that can be applied is governed by the 'Per Order Limit' set by user. Flag = off; only one coupon is redeemable on the order. One coupon can give multiple 'rewards' (i.e. amount off, percentage off, fixed price) up to the 'Per Order Limit' set by user.
Amount off the subtotal of catalog entries from a category No change
Fixed price on the subtotal of catalog entries from a category No change
Percentage off the subtotal of catalog entries from a category No change
Buy catalog entries from category X, get shipping at a fixed price No change
Amount off individual catalog entries from a category One coupon gives amount off on one catalog entry from the category One coupon gives amount off on all catalog entries in the category, up to the per order limit
Fixed price on individual catalog entries from a category One coupon gives fixed price on one catalog entry from the category One coupon gives fixed price on all catalog entries in the category, up to the per order limit
Percentage off individual catalog entries from a category One coupon gives percentage off on one catalog entry from the category One coupon gives percentage off on all catalog entries in the category, up to the per order limit
Buy catalog entries from category X, get a percentage off catalog entry Y One coupon gives percentage off on one Y that has a corresponding item from category X One coupon gives percentage off on all Y's that have a corresponding item from category X, up to the per order limit
Buy catalog entries from category X, get additional catalog entries from category X at a percentage off One coupon gives percentage off on one additional X One coupon gives percentage off on all additional X's that has a corresponding X, up to the per order limit
Buy catalog entries from category X, get catalog entry Y free One coupon gives one free Y for a corresponding item in category X One coupon gives a free Y for all Y's that have a corresponding item in category X, up to the per order limit
Buy A (and B and C), get an amount off Y One coupon gives amount off on one Y for one grouping of A (and B and C) and Y One coupon gives amount off all Y's that have a corresponding group of A (and B and C), up to the per order limit
Buy A (and B and C), get a percentage off Y One coupon gives percentage off on one Y for one grouping of A (and B and C) and Y One coupon gives percentage off on all Y's that have a corresponding group of A (and B and C), up to the per order limit
Buy A and B, get a percentage off both One coupon gives percentage off on one grouping of A and B One coupon gives percentage off on all grouping of A and B, up to the per order limit
Amount off on order No change
Amount off shipping on an order No change
Fixed price for shipping an order No change
Free gift with an order No change
Percentage off an order No change
Amount off the subtotal of catalog entries No change
Fixed price on the subtotal of catalog entries No change
Percentage off the subtotal of catalog entries No change
Buy catalog entry X, get shipping at a fixed price No change
Amount off individual catalog entries One coupon gives amount off on one matching catalog entry One coupon gives amount off on all matching catalog entries in the cart, up to the per order limit
Fixed price on individual catalog entries One coupon gives fixed price on one matching catalog entry One coupon gives fixed price on all matching catalog entries, up to the per order limit
Percentage off individual catalog entries One coupon gives percentage off on one matching catalog entry One coupon gives percentage off on all matching catalog entries, up to the per order limit
Buy catalog entry X, get percentage off catalog entry Y One coupon gives percentage off on one Y for a corresponding X One coupon gives percentage off on all Y that has a corresponding X, up to the per order limit
Buy catalog entry X, get additional X at a percentage off One coupon gives percentage off on one additional X One coupon gives a percentage off on all additional X's, up to the per order limit
Buy catalog entry X, get catalog entry Y free One coupon gives one free Y for a corresponding X One coupon gives the maximum free Y for every corresponding X, up to the per order limit

If you prefer to revert back to the previous behavior, complete the following steps:

Procedure

  1. Open the custom WC_eardir\xml\config\com.ibm.commerce.promotion-ext\wc-admin-component.xml file.
    If a custom file does not exist, create it.
  2. Set the AllowMultipleCouponRedemption property to false. The default value is true after enabling this fix, which means a promotion can only be applied to one item in the shopping cart.
  3. Save and close the customized file.
  4. To update the changes in a development environment, start, or restart the WebSphere Commerce server.
  5. If you want to push the configuration changes out to the production environment, see Deploying J2EE assets for a single file.

Example

The following example shows the promotion behavior for a shopper that has two items in their shopping cart and the following promotion applied:
  • Create a coupon promotion giving $5 off everything in store (Amount off individual catalog entries from a category - site wide).
Before the fix, or if the property is set to false, $10 is discounted off the order, since the $5 promotion is applied to both items in the cart:
Before fix
After the fix, and if the property is set to true, $5 is discounted off the order, since the $5 promotion is applied only once:
After fix
Note: The second coupon still remains in the customer's wallet, and can still be used for their next order.