# Magento 2 Product Packs & Bulk Quantity Sync

### <span style="color: rgb(59, 130, 246);">Installation and User Guide for Magento 2 Product Packs &amp; Bulk Quantity Sync</span>

**Table of Contents**

1. [*Installation* ](#bkmrk-installation)
    - *Download Extension*
    - *Installation via app/code*
    - *Installation via Composer*
2. [*Configuration Settings for Bundle Items*](#bkmrk-configuration-settin)
    - *General Settings*
3. [*Workflow*](#bkmrk-workflow)
4. [*Setting Up Bundle Items Association*](#bkmrk-setting-up-bundle-it)
    - *Associating Bundle Items &amp; Defining Quantities*
    - *Updating or Removing Bundle Associations*
5. [*Inventory Automation*](#bkmrk-inventory-automation)
    - *On Purchase*
    - *On Refund*
    - *Out-of-Stock Handling*
6. *[What Customers See](#bkmrk-what-customers-see)*
7. [*Bulk Import &amp; Export*](#bkmrk-bulk-import-%26-export)
    - *Bulk Import*
    - *Bulk Export*

### <span style="color: #3b82f6;">Installation</span> [](#bkmrk-)

- <span style="color: #f97316;">**Download Extension:**</span> Once you have placed the order from our site then go to Account section and click on My Downloadable Products and download the extension package.

[![image (84) (1).png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/scaled-1680-/image-84-1.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/image-84-1.png)

- <span style="color: #f97316;">**Installation via app/code:**</span> Upload the content of the module to your root folder. This will not overwrite the existing Magento folder or files, only the new contents will be added. After the successful upload of the package, run below commands on Magento 2 root directory.
    
    ```php
    php bin/magento setup:upgrade
    php bin/magento setup:di:compile
    php bin/magento setup:static-content:deploy
    ```
- <span style="color: #f97316;">**Installation via Composer:**</span> Please follow the guide provided in the below link to complete the installation via composer.

<p class="callout success">[https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer](https://docs.scommerce-mage.com/magento-2-extensions/installation-via-composer/installation-via-composer)</p>

### <span style="color: #3b82f6;">Configuration Settings for Magento 2 Product Packs &amp; Bulk Quantity Sync</span>[](#bkmrk--1)

Go to **Admin &gt; Stores &gt; Configuration &gt; Scommerce Configuration &gt; Bundle Items**

#### <span style="color: #f97316;">General Settings</span> [](#bkmrk--2)

- **Enabled –** Select "Yes" or "No" to enable or disable the module.
- **License Key –** Please add the license for the extension which is provided in the order confirmation email. Please note license keys are site URL specific. If you require license keys for dev/staging sites then please email us at <support@scommerce-mage.com>.

[![image - 2025-07-31T164813.407.png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/scaled-1680-/image-2025-07-31t164813-407.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/image-2025-07-31t164813-407.png)

### <span style="color: #3b82f6;">Workflow</span> [](#bkmrk--3)

The **Magento 2 Bundle Items Inventory** extension allows store administrators to associate any number of component products with simple items in their catalogue—each with a precise quantity. This setup enables inventory deduction and restoration for both main and associated (bundle) items during purchases and refunds, streamlining complex product management and keeping total inventory accurate.

### <span style="color: #3b82f6;">**Setting Up Bundle Item Associations**</span> [](#bkmrk--7)

#### <span style="color: #f97316;">**Associating Bundle Items &amp; Defining Quantities**</span>

1. **Navigate to Products:**  
    `Catalog > Products` in your Magento Admin.
2. **Edit a Simple Product:**  
    Open the product you want to add bundle items to (e.g., "Deluxe Gift Set").
3. **Find the 'Bundle Items' Tab:**  
    (This extension will add a new tab or section named **Bundle Items**)
4. **Add Bundle Items:**
    - Click **'Add Bundle Item'**.
    - Use the search/picker to select products you'd like to include (e.g., "Gift Box", "Greeting Card", "Ribbon").
    - Enter the number of each item required per unit (e.g., 1 ribbon per gift set, 2 cards per set).
5. **Save** the main product to commit changes.

**Example:**  
If "Family Baking Kit" requires 1 rolling pin, 2 spatulas, and 3 mixing bowls per kit, add each as a bundle item and specify quantities accordingly.

#### <span style="color: #f97316;">**Updating or Removing Bundle Associations**</span>

- **To change quantities:** Edit the relevant field next to each bundle item.
- **To remove an item:** Use the remove/delete option within the grid.

[![image - 2025-07-31T164933.254.png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/scaled-1680-/image-2025-07-31t164933-254.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/image-2025-07-31t164933-254.png)

### <span style="color: #3b82f6;">**Inventory Automation**</span> [](#bkmrk--7)

#### <span style="color: #f97316;">**On Purchase**</span>

When an order containing the main product is placed:

- The main product stock decreases by the quantity purchased.
- Each bundle item's stock decreases based on the quantity defined per main product **×** number of mains sold.

**Example:**  
Purchasing 4 "Spa Kits" (each requires 2 candles and 1 bottle of oil):

- Main product: 4 deducted
- Candles: 8 deducted (4 × 2)
- Oil bottles: 4 deducted (4 × 1)

#### <span style="color: #f97316;">**On Refund**</span>

When an order for the main product is refunded:

- The main product stock increases by the quantity refunded.
- Each bundle item's stock increases based on the refund quantity and their association.

**Example:**  
Refund 2 "Family Baking Kits":

- Main product: +2
- Rolling pins: +2
- Spatulas: +4 (2 × 2)
- Mixing bowls: +6 (2 × 3)

#### <span style="color: #f97316;">**Out-of-Stock Handling**</span>

By default, the main product can be purchased even if bundle items are out of stock.  
(*Future versions will allow configuration to prevent purchase if bundle items are unavailable.*)

### <span style="color: #3b82f6;">**What Customers See**</span> [](#bkmrk--7)

On the main product's page, your customers will see all associated bundle items and the quantities per unit (e.g. "Includes: 2 Candles, 1 Essential Oil Bottle per kit").

### <span style="color: #3b82f6;">**Bulk Import &amp; Export**</span> [](#bkmrk--7)

#### <span style="color: #f97316;">**Bulk Import**</span>

1. **Prepare a CSV File:** Each row should include: 
    - Main Product SKU
    - Bundle Item SKU
    - Quantity per main product
2. **Go to:**  
    `System > Data Transfer > Import`
3. **Choose Entity Type:**  
    "Bundle Item Associations"
4. **Upload and Import:**
    - The system validates: 
        - All SKUs exist
        - Quantities are whole numbers
        - No duplicate relationships are present
    - Errors will appear with guidance to fix.

### **Sample CSV Format**

<table id="bkmrk-main_product_sku-bun" style="height: 131px; width: 89.7619%;"><thead><tr><th style="width: 33.3833%;">main\_product\_sku</th><th style="width: 33.3833%;">bundle\_item\_sku</th><th style="width: 33.3833%;">quantity\_per\_unit</th></tr></thead><tbody><tr><td style="width: 33.3833%;">spa-kit</td><td style="width: 33.3833%;">candle</td><td style="width: 33.3833%;">2</td></tr><tr><td style="width: 33.3833%;">spa-kit</td><td style="width: 33.3833%;">oil-bottle</td><td style="width: 33.3833%;">1</td></tr><tr><td style="width: 33.3833%;">baking-kit</td><td style="width: 33.3833%;">spatula</td><td style="width: 33.3833%;">2</td></tr></tbody></table>

[![image - 2025-07-31T165218.847.png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/scaled-1680-/image-2025-07-31t165218-847.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/image-2025-07-31t165218-847.png)

#### <span style="color: #f97316;">**Bulk Export**</span>

1. **Go to:**  
    `System > Data Transfer > Export`
2. **Choose "Bundle Item Associations" as entity.**
3. **Download the CSV:**  
    The export will show: 
    - Each main SKU
    - Associated bundle SKUs
    - Quantities for each link

[![image.png](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/scaled-1680-/image.png)](https://docs.scommerce-mage.com/uploads/images/gallery/2025-07/image.png)

If you have a question related to this extension please check out our [<span style="text-decoration: underline;">**FAQ Section**</span>](https://www.scommerce-mage.com/magento-2-bundle-items-inventory.html#customfaq) first. If you can't find the answer you are looking for then please contact [**support@scommerce-mage.com**](mailto:core@scommerce-mage.com)**.**