# Bundle discount

The **Bundle Discounts** feature allows you to create **custom product bundles** with a fixed price or percentage discount. Unlike standard bundled discounts, this feature operates at the **product level**, giving you more flexibility and control.

It is especially useful for **POS (Point of Sale)** workflows where bundles need to be applied instantly based on scanned items.

{% embed url="<https://dollarlabs.neetorecord.com/watch/2c60345d0b55279149b2>" %}

***

### Key Capabilities

* Create bundles using **specific product combinations**
* Set bundle pricing as:
  * Fixed total price
  * Percentage discount
* Define **shared components** across multiple bundles
* Control **bundle priority** to determine which discount applies first
* Support for **multiple bundle repetitions**
* Optimized for handling **large and complex bundle configurations**

***

### How It Works

#### 1. Define Bundle Components

Each bundle consists of:

* **Required products**
* Optional **shared components** (common across multiple bundles)

Example:

* Shared components:
  * Hydrogen (Qty: 1)
  * Oxygen (Qty: 1)
* Bundle-specific item:
  * Liquid (Qty: 1)

***

#### 2. Set Bundle Pricing

You can assign:

* A **fixed bundle price** (e.g., ₹100 for the full bundle)
* Or a **percentage discount**

***

#### 3. Create Multiple Bundles

You can create multiple bundles using the same shared components.

Example:

* **Liquid Bundle**
  * Hydrogen + Oxygen + Liquid → ₹100
* **Snowboard Bundle**
  * Hydrogen + Oxygen + Snowboard → ₹200

***

#### 4. Configure Priority

When multiple bundles can be formed from the same cart, **priority determines which bundle is applied first**.

* Higher priority bundles are applied first
* Lower priority bundles are ignored if items are already consumed

You can adjust priority using the **arrow controls** in the UI.

***

### Example Scenarios

#### Scenario 1: Single Bundle Application

Cart contains:

* Liquid + Hydrogen + Oxygen

Result:

* Bundle is formed
* Total price becomes ₹100

***

#### Scenario 2: Competing Bundles

Cart contains:

* Liquid + Hydrogen + Oxygen
* Snowboard + Hydrogen + Oxygen

If **Liquid Bundle has higher priority**:

* Liquid bundle is applied
* Snowboard bundle is ignored

If **Snowboard Bundle has higher priority**:

* Snowboard bundle is applied
* Liquid bundle is ignored

***

#### Scenario 3: Multiple Bundle Formation

Cart contains:

* 2× Hydrogen
* 2× Oxygen
* 1× Liquid
* 1× Snowboard

Result:

* Both bundles can be formed:
  * Liquid bundle → ₹100
  * Snowboard bundle → ₹200
* Total = ₹300

***

### Repetition Control

You can configure how many times a bundle can be applied:

* Limited repetitions
* Unlimited repetitions

If unlimited, bundles will continue forming as long as required items exist in the cart.

***

### When to Use This Feature

This feature is ideal when:

* You need **precise control over bundle composition**
* Bundles share **common components**
* You operate in a **POS environment**
* You want to avoid **cart-level discount inconsistencies**
* You manage **large or complex bundle catalogs**

***

### Important Notes

* Bundles are applied **only when all required items are present**
* Items used in one bundle **cannot be reused** in another (unless quantities allow)
* **Priority order directly impacts discount outcomes**
* Changes in cart (adding/removing items) will **re-evaluate bundle application**

***

### Summary

The Bundle Discounts feature enables powerful, flexible bundling by:

* Combining products at a granular level
* Supporting shared components
* Using priority-based logic for conflict resolution

This makes it highly effective for **retail, POS systems, and complex product combinations**.