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, percentage.

CustomerBuys - Activation rule for the promotion

Combinations allowed	Description	Notes	Mandatory	Type
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? Yes! [SKU1,SKU2,SKU3] `customerBuys_quantity`: Integer field, should be filled with the required quantity for activation.	Yes	items: String List quantity: Integer
items + quantity + brand ( `customerBuys_type`: BRAND )	Combining items + quantity + BRAND means that when purchasing any item associated with the brand in the specified quantity, the promotion will be activated.	`customerBuys_type`: String field, should be filled with "BRAND" to activate brand behavior. `customerBuys_items`: In this case, the items field should be filled with the brand of the item instead of the SKU code. `customerBuys_quantity`: Integer field, should be filled with the required quantity for activation.	Yes	items: String quantity: Integer Type: String

Note: Combo is the only type of promotion that allows the use of brand. When selecting a brand, any product associated with that brand can activate the promotion.

CustomerGets - Benefits of the promotion

Combinations	Description	Notes	Mandatory	Type
items + quantity	Combining items + quantity means that a free product will be granted to the buyer.	`customerGets_items`: Should be filled with the SKU in question, 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_cash`: Number field, must be filled in with the amount to be applied as cash back.	Yes	items: String quantity: Integer
items + percentage	Combining items and percentage means that the promotion will apply the specified percentage as a discount on the product.	`customerGets_items`: Should be filled with the SKU in question, 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`: Numeric field, must be filled in as 0.10 for 10%	Yes	items: String percentage: Decimal

Is Combo 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.

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

Examples:

The following example is a simple 3x2. The customer will get one item free of charge when buying two items.
It's also possible to offer a different product as a gift. Buy 5 Candy, Chocolate, Ice Cream, get 1 Ice Cream free. Note that we can add a list in customerBuys and select a free product as a benefit.

Setting up example 1:

customerBuys_items: SKU_Candy
customerBuys_quantity: 2

customerGets_items: SKU_Candy
customerGets_quantity: 1

Setting up example 2:

customerBuys_items: SKU1, SKU2,SKU3
customerBuys_minimum: 5

customerGets_items: SKU_IceCream
customerGets_quantity: 1

Note:

In example 2, when buying a quantity of 5 of any item from the SKU list, the buyer will receive a different product for free.

Real Scenarios

Scenario 1: Buy a given item and get second item for free (2x1)

customerBuys: 1 Fizz Orange Soda Pack
cutomerGets: 1 Fizz Orange Soda Pack for free
Example in CSV, line 8

Scenario 2: Buy a given item and get another item for free

customerBuys: 2 Rich Cola 6 Pack
cutomerGets: 1 Rich Cola 6 Pack for free
Example in CSV, line 9

Scenario 3: Buy a given item and get a discount on the second item

customerBuys: 1 pack of Rich Cola 12 Pack
customerGets: 50% discount on the second item of Fizz Orange Soda Pack
Example in CSV, line 10

Scenario 4: Combo Multisku - Buy a set of products and get an item for free

customerBuys: 1 pack of Rich Cola 6 Pack or 1 pack of Rich Cola 12 Pack
customerGets: 2 packs of Fizz Orange Soda Pack for free
Example in CSV, line 11

Scenario 5: Combo Multisku - Buy a set of products and get a different item for free

customerBuys: 8 units of Cereal 300g or 8 units of Cereal Miel 230g
cutomerGets: 2 units of Cereal Chocolate 30g for free
Example in CSV, line 12