To configure the automatic addition of a related product based on the quantity of the main product added to the cart, you need to complete two steps:

Step 1: Create a packing rule
In this step, you need to define a rule that specifies which related product should be added and in what quantity—depending on the quantity of the main product added to the cart.
Example: For every 10 units of Product A, add 1 unit of Product B.
To do this, follow these steps:

     1. Go to the Salesperson Panel and navigate to ONe Framework > Related Products > Rule System

    2. Add a new rule

3. Fill in the required fields and save the rule:

• Rule name – helps identify the rule when assigning it to main products.

• Minimum quantity – defines the quantity of the main product from which the mechanism should be triggered (e.g. allows small orders without activating the rule).

Tip: Labels and rules can be manually linked to a product in the Salesperson Panel, but there is also an option to automatically associate products with the appropriate rules based on labels assigned in the PIM system.

4. Then, open the created rule and fill in the details:

• Specify the quantity of the main product from which the related product should be added.

• Enter the catalog number of the related product – select the product that should be automatically added.
• Quantity to add – specify how many units of the related product should be added for the given quantity range.
• Quantity limit – defines up to what order quantity the related product should be added.

Tip: You can define multiple rule items for different quantity thresholds.

Step 2: Assigning the rule to the main product

    1. Go to ONe Framework > Related Products > Product Settings

    2. Search for the product for which you want to apply the rule; you can do this using filters.

   3. Select the main product you want to configure, and then choose the rule to apply from the dropdown list. In this window, you can specify whether the product should be enabled on eCommerce (Front Office) or in the Salesperson Panel (Back Office).

4.  Save the settings – from this moment, the rule will be automatically applied according to the configuration you have entered.

Plugin actions on the eCommerce platform (Front Office)
When a customer adds the main product to the cart, and the quantity exceeds the minimum threshold defined in the rule, the plugin is automatically triggered.
A message will appear on the page indicating that the additional product is awaiting to be added to the cart, in accordance with the configuration of the assigned rule.

Then, the product is added to the cart along with the related product.

After adding to the cart, two product lines will appear: the main product and the related product. Each of them has its own price and availability, according to the current pricing for the respective item.

Note: The related product is non-editable – it cannot be removed or its quantity changed directly in the cart.

If you need to change the quantity of the main product:
   1. Click the three dots icon located on the right side of the product.

   2. Then, select the "Edit Product" option.

   3. In the newly opened window (popup), make the quantity change.

   4. After saving the changes, the cart will be automatically refreshed, and the number of related products will be recalculated according to the active rule.