Configuring discount rules

Discount rules are user‑friendly representations of discount- and free shipping offer-related macro conditions. These conditions allow your on-line store administrators to limit the application of discounts (catalog and order) and free shipping offers. If the condition is evaluated as true, the respective discount / free shipping offer is valid and the system applies it (unless configured otherwise).

Catalog rules

Catalog rules are user‑friendly representations of catalog discount-related macro expressions. Using these rules in the Rule designer mode of the macro condition editor (while editing the catalog discounts’ Apply to property), you can build conditions limiting your catalog discounts’ application.

Available data for the catalog rules

The data available for catalog rules includes SKU and its properties, for example SKUOrder, SKUPrice, SKUPublicStatus, etc.

You can easily access the data in Store / Multistore configuration -> Discount rules -> Catalog rules by typing SKU. while editing the rule’s Condition property on the General tab.

Order rules

Order rules are user‑friendly representations of order discount- and free shipping offer-related macro expressions. Using these rules in the Rule designer mode of the macro condition editor (while editing the order discounts’ / free shipping offers’ Further conditions property), you can build conditions limiting your order discounts’ / free shipping offers’ application.

Available data for the order rules

The data available for order rules includes ShoppingCart and its properties, for example Currency, PaymentOption, ShippingOption, etc.

You can easily access the data in Store / Multistore configuration -> Discount rules -> Order rules by typing CTRL+SPACE while editing the rule’s Condition property on the General tab.

Adding discount rules

You can add discount rules in Store configuration -> Discount rules on the Catalog rules / Order rules tab (alternatively also in the Multistore configuration application).

1. (Optional) Add a new classto the App_Code\CMSModules\Ecommerce\ sub-folder in your Kentico installation directory.

   1. Make sure the class inherits from the MacroMethodContainer class.

   2. Add your custom methods into the class.

   3. Register your macro method container class into the macro engine.

   4. Save the class and build your solution.

      • You can now use your custom methods in the discount rule’s condition.
      • Refer to Example - Adding an order rule to see an example.

2. Open the Store configuration application.

3. Switch to the Discount rules tab.

4. Switch to catalog rules (order rules) using the corresponding tab.

5. Click New catalog rule (New order rule).

6. Enter the discount rule properties as required.

   

7. Click Save.

   • The system creates a new discount rule leaving it open on the General tab.

8. (Optional) Switch to the Parameters tab.

9. Define the discount rule’s parameter(s) if required.

   

10. Click Save.

You can now use the discount rule to limit the application of your discounts / free shipping offers.

Filtering discount rules

The system allows you to view only discount rules matching certain search criteria (the display name of the rule, its condition and status).

1. Open the Store configuration (Multistore configuration) application.

2. Use the tabs to view the list of available catalog rules / order rules.

   • The system shows all corresponding discount rules available in the system.

     

3. Specify your search criteria.

4. Click Search.

5. (Optional) Click Reset to view all catalog rules / order rules available in the system.

The system shows only discount rules matching your search criteria.

Modifying discount rules

You can modify discount rules in Store configuration -> Discount rules on the Catalog rules / Order rules tab (alternatively also in the Multistore configuration application).

1. Using the tabs, select either catalog rules or order rules.
2. Select a discount rule and click Edit ().
3. Modify the rule’s properties as required.
4. (Optional) Switch to the Parameters tab.
5. (Optional) Modify the rule’s parameters (if any).
6. Click Save.

You can now use the discount rule with its updated settings.

Removing discount rules

You can remove discount rules from the system in Store configuration -> Discount rules on the Catalog rules / Order rules tab (alternatively also in the Multistore configuration application).

1. Using the tabs, select either catalog rules or order rules.
2. Select a discount rule.
3. Click Delete ().
4. Confirm that you want to remove the discount rule (OK).

The system removes the discount rule from your on-line store(s).

Reference

General tab

See Creating macro rules.

Parameters tab

See Reference - Field editor.