Free Items
Penny perfect pricing supports free-item conditions where customer is given free goods based on predefined conditions. Free-item conditions are considered during condition finding and calculation.
Required Editions
| Available in: Lightning Experience in Professional, Enterprise, and Unlimited Editions that have Consumer Goods Cloud enabled |
To ensure that changes to the parent items are reflected in the free-item calculation, free items are calculated after calculating the standard items.
Free-item generation is supported for different scales and bases.
Free items originate from these sources:
- Regular free-item conditions that are either independent of any selectable promotion, or are given for an item ordered from a selectable promotion or an auto-granted promotion.
- Free item rewards selected automatically or manually.
For free items associated with selectable promotions:
- When promoted products are removed from an order, the free-item condition for the item is no longer available. And the free items that are generated through pricing calculation for the promoted products are also removed.
- When a promoted product is removed from the reward, the free item is also removed from the order.
To generate free items, the pricing engine:
- Determines the free items.
- Calls the order for creating the free item. Free items can be generated in multiple calculation steps for different ordered products and for different free items from the same ordered products. But, identical products can’t be generated multiple times from the same ordered product.
- Uses the calculation group of the item template to identify the item template. The item template belongs to the sales document template and has the free-item calculation group. If the free item template is missing from the sales document template, the pricing engine can't calculate the correct result and shows an error.
- Initiates the addition of the new free item into the calculation matrix.
- Adds the free item into the calculation matrix.
The free-item row has a reference to the parent item. If the parent item is modified, the pricing engine adjusts the free item line by using the reference.
The generation of free items depends on conditions:
-
Multibuy conditions: Free items are added to an order based on the promotion context, such as buy X, get Y free. The multibuy condition gives free items per piece multiple times.
Note The quantity of the free item is always rounded down. For example, a product's found condition is Buy 2, Get 1 free and the order quantity is 5. As 5/2 = 2.5, the quantity of free items is rounded down to 2.When calculating an order, the system:
- Adds the free item template.
- Sets the running total to 0.
- Relevant conditions: Free items are added to an order based on pre-defined conditions. The
item quantity to add depends on the specified conditions. For example, in an order, if the
total cost of product A >= €50.00, 5 items of product B are given for free. When calculating
the order, the system:
- Adds the free item template, which is generated on the product group condition.
- Sets the running total to 0.
- Sets the ERP ID of the free item.Note The ERP ID of the free item is based on relevant conditions. For example, ERP ID of parent + 1.
- Grouping conditions: Free items are added to an order based on product group conditions.
When calculating an order, items that generate free items are grouped using Item Grouping
and multiple items are considered to calculate the base. When calculating an order, the system:
- Adds the item, the quantity, and the free item template based on the product group condition.
- Sets the ERP ID for the free item. For any free item generated through item grouping, the ERP ID starts from 80,000.
- Sets the running total to 0.
For example, products A and B are line items of the same group. When an order is placed for 50 units of product A and B each, the customer gets 10 units of product C free.
