This article explains what bundles are, how they work, and how to define bundle logic for pricing.
Overview
Bundles allow catalog items to be priced and sold together as one bundle item.
When items are bundled, the individual items do not appear on the item list. Only the bundle item appears.
Bundles are different from packages:
- Packages are used for a 1-to-1 item setup.
- Bundles are used when many items are represented by one bundle item.
Bundle logic is applied as an additional step in the pricing calculation flow. It is applied before price rules and price values are computed.
Note: Ensure that the bundle code exists in the catalog for this to function correctly.
When to use bundles
Use bundles when multiple catalog items need to be sold together as one priced bundle item.
This is useful when the selected or configured items should not appear separately on the item list, and only the bundle item should be shown.
How bundles work
Bundles use a CSV file to define which catalog items are covered by a bundle.
Each row in the bundle file identifies an item, the quantity covered by the bundle, and the bundle item that represents it.
To bundle items together, the items must use the same Bundle.Code.
For example, if two different items have the same Bundle.Code, both items are covered by the same bundle item.
Bundle file structure
Bundles are defined using a CSV file. An example CSV file (bundle.csv) is attached to this article below.
The bundle.csv file contains the following columns:
| Column | Description |
|---|---|
| Item.Ref | The refCode of the item as originally selected or configured in the catalog. |
| Quantity | The number of units of the item that the bundle covers. |
| Bundle.Code | The refCode of the catalog item that represents the bundled version of the items. |
The bundle file can be imported by clicking the three dots next to the catalog name and selecting Import Bundle option. You can also export the same by the clicking Export Bundle option from the same list.
Example
In bundle.csv file, two catalog items are grouped into the same bundle because they use the same Bundle.Code.
In this setup:
- Item 111099 is included in bundle_1 with a quantity of 1.
- Item 342013 is included in bundle_1 with a quantity of 2.
- Because both rows use the same Bundle.Code, both items are represented by the same bundle item.
After the bundle logic is applied, the individual items are not shown separately on the item list. Only the bundle item is shown and used for pricing.