Magento 2 Bundle Items Inventory

Installation and User Guide for Magento 2 Bundle Items Inventory

Table of Contents

1. Installation
   • Download Extension
   • Installation via app/code
   • Installation via Composer
2. Configuration Settings for Bundle Items
   • General Settings
3. Workflow
4. Setting Up Bundle Items Association
   • Associating Bundle Items & Defining Quantities
   • Updating or Removing Bundle Associations
5. Inventory Automation
   • On Purchase
   • On Refund
   • Out-of-Stock Handling
6. What Customers See
7. Bulk Import & Export
   • Bulk Import
   • Bulk Export

Installation

• Download Extension: 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.

• Installation via app/code: 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 bin/magento setup:upgrade
  php bin/magento setup:di:compile
  php bin/magento setup:static-content:deploy

   

• Installation via Composer: Please follow the guide provided in the below link to complete the installation via composer.

Configuration Settings for Bundle Items

Go to Admin > Stores > Configuration > Scommerce Configuration > Security Base

General Settings

• 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.

Workflow

The extension empowers Magento 2 Bundle Items Inventory extension allows store administrators to associate any number of component products with simple items in their catalogue—eachstores with a preciserobust quantity.affiliate Thisprogram, setupenabling enablescustomers inventoryto deductionpromote your products in exchange for commissions and restorationallowing foradmins bothto mainefficiently monitor, pay, and associatedmanage (bundle)program itemsperformance.

during

For purchasesCustomers: Join and refunds,Use streamliningthe complexAffiliate product management and keeping total inventory accurate.

Program

Setting Up Bundle Item Associations 

Associating Bundle Items & Defining Quantities

Navigate

Affiliate to Products:
Catalog > Products in your Magento Admin.

Edit a Simple Product:
Open the product you want to add bundle items to (e.g., "Deluxe Gift Set").

Find the 'Bundle Items' Tab:
(This extension will add a new tab or section named Bundle Items)

Add Bundle Items:Registration

• Click

  Go to 'AddMy BundleAccount Item'> Affiliate Program. after logging in.

• Use

  Review the search/pickeraffiliate toprogram selectdescription productsand you'dTerms likeand toConditions.

  include (e.g., "Gift Box", "Greeting Card", "Ribbon").
• Enter

  Accept the numberTerms ofby eachchecking itemthe requiredbox; perthe unitbox (e.g.,text 1and ribboncontent perdepend gifton set,admin 2configuration.

  cards per set).

• Click Save"Join Program". theOnce mainenrolled, productyou’ll tosee commityour changes.unique referral link.

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.

UpdatingReferral or Removing Bundle AssociationsLinks

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

Your

Inventoryreferral Automation 

On Purchase

When an order containing the main productlink is placed:displayed prominently.

• The main

  Use productCopy stockto decreasesquickly bycopy theit quantityto purchased.your clipboard.

• Each bundle item's stock decreases based on the quantity defined per main product

  Use ×Share 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)

On Refund

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)

Out-of-Stock Handling

By default, the main product can be purchased even if bundle items are out of stock.
(Future versions will allow configuration to preventdistribute purchasevia ifFacebook, bundleTwitter, itemsReddit, areor unavailable.)Instagram with one click.

What Customers See 

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").

Bulk Import & Export 

Bulk Import

1. Prepare a CSV File: Each row should include:
   • Main Product SKU
   • Bundle Item SKU
   • Quantity per main product
2. Go to:
   System

   You >can Datanow Transfershare >this Importlink anywhere. Anyone using your link is tracked for commission.

3. Choose Entity

   Affiliate Type:
   "Bundle Item Associations"

4. Upload and Import:Dashboard
   • The system

     In validates:My Account > Affiliate Dashboard, view:

     • All SKUs

       Total existSales Generated

     • Quantities are

       Total wholeCommission numbersEarned

     • No duplicate

       Commission relationshipsPaid/Pending

       are
     present

     • Performance overview (click-throughs, orders)

   Referred Orders Dashboard

   • Go to My Account > Referred Orders to see:

     • Order ID, Order Date

     • Order Amount, Status

     • Predicted commission amount

   • Errors will

     Top appearsummary withdisplays:

     guidance
     to
     • fix.

       Total order amount

     • Total commission paid

     • Total commission pending

SampleFor CSVAdmins: Format

main_product_sku	bundle_item_sku	quantity_per_unit
spa-kit	candle	2
spa-kit	oil-bottle	1
baking-kit	spatula	2

Bulk Export

1. Go to:
   System > Data Transfer > Export
2. Choose "Bundle Item Associations" as entity.
3. DownloadManaging the CSV:
   TheAffiliate exportProgram will

   Affiliate show:Dashboard

   • Each main

     Navigate SKUto Marketing > Affiliates in the admin panel.

   • Associated bundle

     The SKUs

   dashboard
   • Quantitiesgrid lists for each linkaffiliate:

     • Customer ID, Name, Email

     • Total Orders, Sales Amount, Commissions (pending/paid)

Actions:

• Search, filter, and sort to find affiliates easily.

• Export affiliate data for reporting or external processing.

• Click on an affiliate to see:

  • Order breakdowns

  • Payout history

  • Details of commissions

Referred Orders Overview (Admin)

• Examine which orders were generated by each affiliate from the dashboard.

• View and validate predicted commissions, manage disputes or issues.

Payout Management

• View a list of affiliates eligible for payouts:

  • Payouts are only due for orders with approved statuses (e.g., Complete, Shipped).

  • Set minimum payout threshold and payout schedule (weekly, monthly, manual).

• Payout Processing:

  • Select payout method (Bank Transfer or PayPal).

  • Mark payouts as “Paid”–affiliate’s balance resets to 0.

  • All payouts and payment history are tracked for each affiliate.

  • Affiliates receive email notification templates you configure.

• Refunds and Cancelations:

  • If an order is refunded or canceled after commission has been paid, commission is deducted or reversed automatically.

Multi-tier Commission Structure

• Enable/Disable tiered commission system from Affiliate Settings.

• Configure slabs and rates, e.g.:

  • £1–£999.99: 10% commission

  • £1,000–£1,999.99: 15% commission

  • £2,000+: 20% commission

---

Order & Affiliate Tracking

How Order Attribution Works

• When a prospect clicks your referral link:

  • A browser cookie stores your affiliate ID for 30 days.

• Any purchase in that period is attributed to you.

• After 30 days or if no link is used, no commission is awarded.

Cookie Lifecycle

• Creation: On link click.

• Active period: 30 days from last click.

• Expiry: After 30 days.

If you have a question related to this extension please check out our FAQ Section first. If you can't find the answer you are looking for then please contact support@scommerce-mage.com.