Mechanics

Each type (DIRECT, VOLUME, COMBO, TOTAL, COMPLEX) of promotion has a set of attributes that can be combined in their mechanics, with combinations divided into 2 groups: the first group for activation rules and the second group for applied benefits.

Available atributes at this type of promotion: item, quantity, amount, percentage.

CustomerBuys - Activation rule for the promotion

Combinations allowed	Description	Notes	Mandatory	Types
items + quantity	Combining items + quantity means that whenever the specified quantity of this product is reached in the cart, the benefit will be granted to the customer.	`customerBuys_items`: Should be filled with the SKU, limited to 1 SKU. It can also be filled with * to indicate that the promotion should be applied across the entire catalog. Allows more than 1 SKU? No! `customerBuys_quantity`: Integer field, should be filled with the required quantity for activation.	Yes	Items: String quantity: Integer
items + amount	Combining items + amount means that when the total value of this product in the cart reaches a certain amount, the benefit will be granted to the customer.	`customerBuys_items`: Should be filled with the SKU, limited to 1 SKU. It can also be filled with * to indicate that the promotion should be applied across the entire catalog. Allows more than 1 SKU? No! `customerBuys_amount`: Decimal field, should be filled with the required amount for activation.	Yes	Items: String amount: Decimal

CustomerGets - Benefits of the promotion

Combinations	Description	Notes	Mandatory	Types
items + percentage	Combining items and percentage means that the promotion will apply the percentage value specified as a discount on the product.	`customerGets_items`: Should be filled with the SKU, limited to 1 SKU. It can also be filled with * to indicate that the promotion should be applied across the entire catalog. Allows more than 1 SKU? No! `customerGets_percentage`: Decimal field, must be filled in as 0.10 for 10%	Yes	Items: String percentage: Decimal
items + cash	Combining items and cash means that the promotion will apply a nominal discount on the configured product.	`customerGets_items`: Should be filled with the SKU, limited to 1 SKU. Allows more than 1 SKU? No! `customerGets_cash`: Decimal field, must be filled in with the amount to be applied as cash back.	Yes	Items: String cash: Decimal

Is Direct promo cumulative?

Yes, whenever the quantity value is reached, the benefit will be granted.
Since we have a promotion configured with quantity = 10, if the customer places 11 quantity in the cart, he/her will only receive discounts on the 10 items described in the rule. Limited by perCustomer and perOrder parameters.

Direct Promotion is not cumulative with other promotions, meaning it cannot be combined with the benefits of another promotion.

Examples:

Buy 1 box of candy and receive a discount on its price.
Buy 10 boxes of candy and receive a discount on the total price.

Setting up example 2:

customerBuys_items: SKU_Candy
customerBuys_quantity: 10

customerGets_items: SKU_Candy
customerGets_percentage: 0.10

Note:

In example 2, if the customer places 11 quantity in the cart, he/her will only receive discounts on the 10 items described in the rule. But if the user buys 20 he will be getting 2 discounts applied.

Real Scenarios

Scenario 1: Get a discount on a given group of items

customerBuys: For every 8 packs of infant formula Frizz Orange Soda
cutomerGets: 15% off
Example in CSV, line 2

Scenario 2: Get discount of a given amount $$

customerBuys: For every $150 of Rich Cola 6 Pack
customerGets: 10% off
Example in CSV, line 3

Scenario 3: Direct discount on a single item

customerBuys: Buy Formula Onion Dip Chips
customerGets: 10% off
Example in CSV, line 4