The Marketplace Promotions and Discounts feature ensures that discounts are applied to orders.

There are two discount types:

• Voucher
• Cart rule

A product catalog manager selects a discount type when creating a discount.

Creating cart rules or vouchers based on any merchant parameters, such as a merchant ID or product offer, is not available by default in the current implementation and needs to be added on the project level by extending the Discount Engine. However, it is possible to create cart rules and vouchers for the Marketplace products. See Create discounts for more details.

Based on the business logic, discounts can be applied in the following ways:

• The discount is applied to the whole Marketplace order. In such a scenario, the discount is distributed among all the merchant orders and calculated according to the total volume of each of the items.

• The discount is related to a single product item in the Marketplace order. In this case, the whole discount is assigned only to the merchant order that contains the discounted item.

Voucher

A Voucher is a discount that applies when a customer enters an active voucher code on the Cart page.

Once the customer clicks Redeem code, the page refreshes to show the discount name, discount value, and available actions: Remove and Clear all. The Clear all action disables all the applied discounts. The Remove action disables a single discount.

Multiple voucher codes can be generated for a single voucher. The code has a Max number of uses value which defines how many times the code can be redeemed.

You can enter codes manually or use the code generator in the Back Office.

To learn how a product catalog manager can create a voucher in the Back Office, see Creating a voucher.

Cart Rule

A cart rule is a discount that applies to the cart once all the decision rules linked to the cart rule are fulfilled.

The cart rule is applied automatically. If the decision rules of a discount are fulfilled, the customer can see the discount upon entering the cart. Unlike with vouchers, the Clear all and Remove actions are not displayed.

To learn how a product catalog manager can create a cart rule in the Back Office, see Create discounts.

Decision rule

A decision rule is a condition assigned to a discount that should be fulfilled for the discount to be applied.

A discount can have one or more decision rules. Find an exemplary combination below:

PARAMETER	RELATION OPERATOR	VALUE
total-quantity	equal	3
day-of-week	equal	5

In this case, the discount is applied if the cart contains three items and the purchase is made on the fifth day of the week (Friday).

Multiple decision rules form a query. A query is a request for information based on the defined parameters. In the Discount feature, a query requests information from a cart to check if it is eligible for the discount. By specifying decision rules, you define the parameters of the query.

In the Back Office, a product catalog manager creates decision rules in a Query Builder. The decision rules created in the Query Builder are transformed into a single query.

The decision rules from the previous example look as follows in the Query Builder:

A product catalog manager can enter the query manually as well.

The same decision rules look as follows as a plain query:

You can switch between Query Builder and Plain query modes to see how the specified decision rules look in either of them.

Decision rules are combined with AND and OR combination operators. With the AND operator, all the rules should be fulfilled for the discount to be applied. With the OR operator, at least one of them should be fulfilled for the discount to be applied.

In the following example, for the discount to be applied, a cart should contain three items, and the purchase should be made on Wednesday.

In the following example, for the discount to be applied, a cart should contain three items, or the purchase should be made on Wednesday.

Info

When rules are combined by the OR operator, they do not exclude each other. If a cart fulfills both such rules, the discount is still applied.

Decision rule group

A rule group is a separate set of rules with its own combination operator.

With the rule groups, you can build multiple levels of rule hierarchy. When a cart is evaluated against the rules, it is evaluated on all levels of the hierarchy. On each level, there can be both rules and rule groups.

When a cart is evaluated on a level that has a rule and a rule group, the rule group is treated as a single rule. The following diagram shows how a cart is evaluated against the rules in the previous screenshot.

Discount threshold

A threshold is a minimum number of items in the cart that should fulfill all the specified decision rules for the discount to be applied. The default value is 1. It means that a discount is applied if at least one item fulfills the discount’s decision rules.

In the following example, the discount is applied if there are four items with the Intel Core processor in the cart.

Discount application

Discount application is a discount configuration option that defines the products to which a discount is applied.

The Marketplace discounts are applied based on the query string.

The query string is a discount application type that uses decision rules to dynamically define what products a discount applies to.

The discount in the following example applies to white products.

The product selection based on the query string is dynamic:

• If at some point, the color attribute of a product changes from white to anything else, the product is no longer eligible to be discounted.
• If at some point, a product receives the white color attribute, it becomes eligible for the discount.

Discount calculation

Calculation defines the value to be deducted from a product’s original price. There are two types of discount calculation:

• Calculator percentage
• Calculator fixed

Info

With the calculator fixed type, the currency of the respective shop is used for calculation.

See examples in the following table.

PRODUCT PRICE	CALCULATION TYPE	AMOUNT	DISCOUNT APPLIED	PRICE TO PAY
€50	Calculator percentage	10	€5	€45
€50	Calculator fixed	10	€10	€40

A product catalog manager defines calculation when creating a voucher or Create discounts.

Discount exclusiveness

Discount exclusiveness defines if a discount value of a discount can be combined with the discount value of other discounts in a single order.

A product catalog manager defines calculation when creating a voucher or Create discounts.

Exclusive discount

An exclusive discount is a discount that, when applied to a cart, discards all the other discounts applied to it. If a cart is eligible for multiple exclusive discounts, the highest-value discount is applied.

In the following example, a cart with the order total amount of €100 contains the following discounts.

DISCOUNT NAME	DISCOUNT AMOUNT	DISCOUNT TYPE	EXCLUSIVENESS	DISCOUNTED AMOUNT
D1	15	Calculator percentage	Exclusive	€15
D2	5	Calculator fixed	Exclusive	€5
D3	10	Calculator percentage	Non-exclusive	€10

The discount exclusivity is resolved as follows:

1. The discounts D1 and D2 are exclusive, so the non-exclusive discount D3 is discarded.
2. The discount D1 provides more free value than the discount D2.
3. As a result, the discount D1 is applied.

Non-exclusive discount

A non-exclusive discount is a discount that can be combined with other non-exclusive discounts in a single order.

In the following example, a cart with the order total amount of €30 contains the following discounts.

DISCOUNT NAME	DISCOUNT AMOUNT	DISCOUNT TYPE	EXCLUSIVENESS	DISCOUNTED AMOUNT
D1	15	Calculator percentage	Non-exclusive	€15
D2	5	Calculator fixed	Non-exclusive	€5
D3	10	Calculator percentage	Non-exclusive	€10

As all the discounts are non-exclusive, they are applied together.

Discount validity interval

A validity interval is a time period during which a discount is active and can be applied.

If a cart is eligible for a discount outside of its validity interval, the cart rule is not applied. If a customer enters a voucher code outside of its validity interval, they get a “Your voucher code is invalid.” message.

A product catalog manager defines the calculation when creating a discount.

Related Developer articles

INSTALLATION GUIDES
Install the Marketplace Promotions & Discounts feature