Working with catalog discounts
You can use catalog discounts to motivate selected customers to purchase more products. If you use catalog discounts, the system offers your products on the live site to all eligible customers for discounted prices. The system also displays the products’ discounted prices to your on-line store administrators while creating/editing orders of your eligible customers.
For example, you can provide special Christmas sale discounts to all eligible customers who purchase any products from the selected departments such as Clothing, Electronics, etc. between November 15 and December 23.
You can configure catalog discounts in detail to apply only to products specified by rules (macro conditions). These rules use properties of the respective SKUs (products), and can include the range of the product price, manufacturer of the product, its public status, etc. You can also specify periods of validity for catalog discounts.
The system binds catalog discounts to specific sites, for example to the sample E-commerce Site.
If you run multiple sites and want to use catalog discounts, you need to define dedicated catalog discounts for each site.
Adding or editing catalog discounts
You can add or edit catalog discounts in the Catalog discounts application.
- Catalog discounts limited by periods of validity
- Catalog discounts targeted at selected customers
- Catalog discounts limited to selected product scopes
You can combine the catalog discount limitations.
For example, you can add discounts effective on all footwear products throughout January, and targeted at your registered customers.
Catalog discounts limited by periods of validity
To add or to edit catalog discounts limited by periods of validity:
To add a new discount, clickNew catalog discount. To edit an existing discount, click Edit () at the desired discount.
Type a Name for the discount.
Enter the catalog discount properties in the Duration category:
- Valid from – specifies the start of the period of validity.
- Valid to – specifies the end of the period of validity.
Leave both fields empty for permanent validity.Click Save.
The system saves the catalog discount. The system now applies the discount only during the discount’s period of validity (if the discount is running).
Catalog discounts targeted at selected customers
To add or to edit catalog discounts targeted at selected customers:
To add a new discount, click New catalog discount. To edit an existing discount, click Edit () at the desired discount.
Type a Name for the discount.
Change the value of the Available for property in the Target customers category
- All visitors – all customers are eligible for the discount; the default option.
- Registered users – only registered customers are eligible for the discount.
- Selected roles – only customers in selected roles are eligible for the discount.
Click Save.
The system saves the catalog discount. The system now applies the discount (if the discount is running) only for the selected customers.
If you need to add catalog discounts targeted at custom groups of customers, for example, at selected users, contact groups, etc., see Configuring discount rules.
Catalog discounts limited to selected product scopes
To add or to edit catalog discounts limited to selected product scopes:
To add a new discount, click New catalog discount. To edit an existing discount, click Edit () at the desired discount.
Type a Name for the discount.
In Discount, select percentage if you want to apply the discount in percent or fixed amount to apply the discount in a specific amount of money in the main currency.
To Amount, enter an exact value of the discount either in percent or in fixed amount according to Discount.
Click Edit next to the Apply to field to set the discount rules and their parameters:
In the Edit macro condition dialog that opens, select the required rule in the right part of the dialog.
Use drag & drop, or double-click, or click Add rule () button to add the rule.
Click the underlined parts of the rule in the left part of the dialog to open the Set parameter value dialog.
One rule can contain more parameters. That’s why there can be more underlined words.
Select the desired parameter:
Click Set parameter.
(Optional) Repeat editing to set all discount rules and all their parameters you want.
Click Save & Close.
Click Save.
The system saves the catalog discount. The system now applies the discount only if the specified condition is fulfilled (if the discount is running).
If you want to allow some other user to add or to edit discounts, see Role management and Configuring permissions.
Permission |
Description |
Read discounts |
Allows users in selected roles to access discounts and free shipping offers. |
Modify discounts |
Allows users in selected roles to create, modify and delete discounts and free shipping offers. |
Read configuration |
Allows users in selected roles to access E-commerce configuration, i.e. the on-line store settings, discount rules, etc. |
Modify configuration |
Allows users in selected roles to modify E-commerce configuration. |
If you edit or delete a discount, the existing orders stay with that discount. To update existing orders according to the new rules, you must edit the required orders manually.
Displaying catalog discounts in the invoice
To display catalog discounts applied on the ordered product items in the invoice:
Open the Store configuration application.
Switch to the Invoice tab.
Add the following code into your invoice template:
{%ContentTable.ApplyTransformation("Ecommerce.Transformations.Order_ContentTable", "Ecommerce.Transformations.Order_ContentTableHeader", "Ecommerce.Transformations.Order_ContentTableFooter")#%}
Click Save.
If you now review an existing order on the Invoice tab, you can see that the invoice includes information about catalog discounts applied on the ordered product items.
The ordered product items and the related information including the applied catalog discounts are displayed by the Ecommerce.Transformations.Order_ContentTable transformation.
You can edit the transformation in Page types -> Edit () E-commerce - Transformations on the Transformations tab.
Displaying catalog discounts on the live site
The system allows you to attract the customers by showing them what economical and convenient purchases they can make in your on-line store. Specifically, the system can display original and also discounted prices of products. The system can also display special status labels, for example, Sale, New, Featured, etc.
Offering products at discounted prices
The sample E-commerce Site can display the products with the original and discounted prices. Whether and how the system displays the prices depends on the products’ configuration, and availability of catalog discounts:
Product price |
Product list price |
Catalog discount |
Description |
defined |
defined |
doesn’t apply |
The list price is crossed out and the price is highlighted. |
defined |
not defined |
applies |
The price is crossed out and the price reduced by the discount is highlighted. |
defined |
defined |
applies |
The list price is crossed out and the price reduced by the discount is highlighted. |
defined |
not defined |
doesn’t apply |
Only the price is displayed for the product; the price is highlighted. (The system displays only one price for the product). |
The sample E-commerce Site can display the products with the original and discounted prices. The amount (and percentage of the original prices) that the customers can save is also displayed. Whether and how the system displays this information depends on the products’ configuration, and availability of catalog discounts:
Product price |
Product list price |
Catalog discount |
Description |
defined |
defined |
doesn’t apply |
The list price, displayed as List price, is crossed out and the price, displayed as Your price, is highlighted. |
defined |
not defined |
applies |
The price, displayed as List price, is crossed out and the price reduced by the discount, displayed as Your price, is highlighted. |
defined |
defined |
applies |
The list price, displayed as List price, is crossed out and the price reduced by the discount, displayed as Your price, is highlighted. |
defined |
not defined |
doesn’t apply |
The system displays for the product only the price as Total price. |
You can specify the products’ Price and List price properties while editing the products on the General tab.
Alternatively, you can specify these properties in the Pages application while editing the corresponding product pages on the Form tab.
List price stands for the recommended retail price (RRP) or manufacturer’s suggested retail price (MSRP) of the product. The list price is typically determined by factors such as supply, demand and manufacturing costs.
Offering products highlighted with statuses
You can motivate your customers to purchase selected products by showing product statuses, e.g., Sale, New, Featured, etc.
You can specify the products’ statuses by modifying their Public status properties on the General tab.
Alternatively, you can specify the products’ statuses in the Pages application while editing the corresponding product pages on the Form tab.
Configuring pages to display product discounts
The sample product listing pages and sample product details pages contain web parts using transformations that can display product discount information (product prices and statuses).
Kentico sample pages |
Web part |
Transformation |
Product listing pages, e.g., T-shirts page |
Product List |
EcommerceSite.Transformations.ProductPreviewForThreeColumnsLayout |
Product details pages, e.g., Adidas Trefoil Tee page |
Product Detail |
EcommerceSite.Transformations.ProductDetail |
Product details pages, e.g., Adidas Trefoil Tee page |
Product Main Image |
EcommerceSite.Transformations.ProductDetailGalleryProductImage |
To configure a product listing/product details page to display product prices and product statuses:
Open the Pages application.
Select the required page from the content tree.
Switch to the Edit -> Design tab.
Add appropriate web parts to the selected web part zones.
You can do this by copying the web part(s) from any sample product listing/product details page. If you are editing:
- your custom product listing page, add the Product List web part;
- your custom product details page, add the Product Detail and Product Main Image web parts.
Modify the web parts’ Transformation properties as required:
- Product listing pages
If you want the page to display product prices, i.e., the currently valid price and the undiscounted price (if available), make sure the transformation contains the following code:
<span class="retailPrice"><%# If(GetSKUOriginalPrice() > 0, GetSKUFormattedOriginalPrice(), "") %></span> <span class="price"><%# GetSKUFormattedPrice() %></span>
If you want the page to display product statuses (if available), make sure the transformation contains the following code:
<span class="indicator <%# GetSKUIndicatorProperty("PublicStatusName") %>"><%# Localize(GetSKUIndicatorProperty("PublicStatusDisplayName")) %></span>
- Product details pages
If you want the page to display product prices, i.e., the currently valid price and the undiscounted price (if available), and the amount (percentage of the original price) that the customers can save, make sure the transformation contains the following code:
<table> <% if(GetSKUPriceSaving() > 0){ %> <tr> <td class="label"> <span class="retailPrice">List price: </span> </td> <td> <span class="lineThrough"><%# GetSKUFormattedOriginalPrice() %></span> </td> </tr> <tr> <td class="label"> <span class="yourPrice">Your price: </span> </td> <td> <span><%# GetSKUFormattedPrice() %></span> </td> </tr> <tr> <td class="label"> <span class="instantSavings">You save: </span> </td> <td> <span><%# GetSKUFormattedPriceSaving() + " (" + GetSKUPriceSaving(true) + "%)" %></span> </td> </tr> <% } %> </table>
If you want the page to display the product’s status (if available), make sure the transformation contains the following code:
<div class="productPublicStatus"> <span class="<%# GetSKUIndicatorProperty("PublicStatusName") %>"> <%# Localize(GetSKUIndicatorProperty("PublicStatusDisplayName")) %> </span> </div>
- Product listing pages
(Optional) Modify other properties of the web parts if required.
Click OK.
If your customers now view the page on the live site, they can see the product’s discount information.
Reference
General |
|
Name |
The name of the catalog discount used throughout the administration interface, e.g., in catalog discounts lists. The system can display this name also to your on-line store customers while viewing the details of the product price in the Product price detail dialog. |
Code name |
The unique identifier of the catalog discount object used by developers in the code. Unless there is a reason to set a particular value, you can leave the default (automatic) option, and the system generates an appropriate code name automatically. |
Description |
To make the catalog discount easier to use and maintain, you can add an explanation about the scenarios for which the discount is intended, etc. The description doesn’t have any functionality, it’s just for better orientation. |
Enabled |
Indicates if the catalog discount is enabled in the system. While calculating the price of product (product option) items added to the shopping cart, the system skips disabled discounts. |
Basics |
|
Discount |
Specify if you want to apply the discount in percentage or in fixed amount.
|
Amount |
Specify an exact value of the discount in percent or in fixed amount according to Discount. The system reduces the price of the product items that the customer adds to the shopping cart (including all selected product options) by the discount value and calculates all applicable taxes accordingly. The amount has to be a number. When the amount is in percentage, enter a number between 0 and 100. When the amount is fixed, enter a number greater than 0. |
Apply to |
Enter further conditions that must be fulfilled for the system to apply the catalog discounts. By utilizing rules (user-friendly representations of macro expressions), you can write any condition according to your specific requirements. Clicking Edit opens the Edit macro condition dialog, which allows you to add rules through a graphical interface.
Example SKU contains 1255 The condition ensures that the catalog discount is only applied if the SKU contains 1255. You can also edit macros on the Code tab in the Edit macro condition dialog. For details about available macro options and syntax, please refer to Macro expressions. |
Duration |
|
Valid from |
Specify from when the discount is running. If you leave Valid from empty, the discount will be valid permanently till Valid to. |
Valid to |
Specify to when the discount is running. If you leave Valid to empty, the discount will be valid permanently from Valid from. |
Target customers |
|
Available for |
Choose roles of users who are able to apply the discount:
You can enter roles directly by typing in their code names separated by semicolons, e.g., _authenticated_;Members. You can add registered customers to roles in the Customers application while editing a selected customer on the Roles tab. |
Discount calculation |
|
Priority |
Specify in what sequence the system applies the listed running catalog discounts (if any). Enter 1 for the highest priority. The number has to be greater than or equal to 1. Use greater intervals between priority numbers. If you want to add a new discount inbetween two already existing, you can add the new discount more easily between 10 and 20 than between 1 and 2. If you already have only small gaps, you can also use decimals. |
Apply lower priority discounts |
If selected, other catalog discounts with lower priorities are applied to the shopping cart as well. If cleared, discount processing stops with the last discounts with the same priority level as the edited discount. |