Configurable Bundle Feature Overview

A configurable bundle is a product bundle, that a customer can configure in the Storefront on the go by choosing the suggested concrete products.

A Configurable Bundle contains:

• Configurable Bundle Template
• Configurable Bundle Template ID - a unique identifier of a configurable bundle in the system
• Configurable Bundle Template Name
• Configurable Bundle Template Image. It is displayed on the Templates page for the corresponding Configurator in the Storefront.
• Configurable Bundle Slots
• Configurable Bundle Slots Name

Read on to learn more about these elements.

Configurable Bundle Template

Every configurable bundle is created per a template. The template is a model that contains the configuration details for the bundle, for example, the number of slots it may provide, product lists assigned to a slot, etc. A Back Office User creates the template in the Back Office, and the Shop User then uses the template to configure the bundle. See Configurable Bundle Templates on working with templates in the Back Office.

A Shop User can set up the Configurable Bundle on the Configurator page. Configurator is the Storefront representation of the Template that Back Office User creates in the Back Office. See Configurator to learn more about it.

Storefront	Back Office

A bundle template can contain an infinite number of the slots.

The example below illustrates how the Configurable Bundle data is saved to the database:

{
     "id_configurable_bundle_template": 2,
     "uuid": "c8291fd3-c6ca-5b8f-8ff5-eccd6cb787de",
     "name": "configurable_bundle_templates.my-bundle.name",
     "slots": [
        [
            "id_configurable_bundle_template_slot": 6,
            "uuid": 9626de80-6caa-57a9-a683-2846ec5b6914,
            "name": "configurable_bundle.template_slots.slot-6.name",
            "id_product_list": 13
        ],
        [
            "id_configurable_bundle_template_slot": 7,
            "uuid": 2a5e55b1-993a-5510-864c-a4a18558aa75,
            "name": "configurable_bundle.template_slots.slot-7.name",
            "id_product_list": 14
        ]
    ]
}

Configurable Bundle Slots

A slot is an entity with a list of assigned products for the configurable bundle. A slot contains:

• Configurable Bundle Slot Name
• Configurable Bundle Slot ID
• Product List ID

A Back Office User can create an unlimited number of slots for a template.

A slot contains a list of products or even categories to choose from. In Spryker Commerce OS, this functionality is represented via product lists. Spryker Back Office User adds the necessary products to the product list to allow buyers to choose among several options in the slot.

Configurable Bundle & Cart and Cart Notes

When the customer has successfully filled all the slots in the template, they add the configurable bundle to the cart. On the cart page, the items are grouped by the configured bundle.

You can add a note to the whole Configurable bundle on the cart page. The note will further be displayed on the Checkout Summary and Order Details page under the respective Configurable Bundle template.

Configurable Bundle Quantity, Stock and Price

The current configuration supports 1:1 product-slot relation in the Configurator. It means, that you can select only one concrete product for a slot with quantity 1. However, using the data import, you may import a bigger quantity for the products in the slots.

On the cart page, a shopper can also change the number of configured bundles to buy. After the number of bundles is increased, the quantity of the items in the configured bundle is multiplied by this number.

Product availability is taken into account when calculating the total.

Configurable Bundle & Reorder

The items from the configurable bundle can be reordered and are added to a new order as separate order items.

Configurable Bundle & RFQ

A Buyer can include the Configurable Bundle into the RFQ process and change the price per each item in the bundle. The item total of the concrete product and the configurable bundle total is recalculated in this case based on the new prices.

Configurable Bundle & Splittable Order Items

Configurable Bundle may contain splittable and non-splittable products. If a Configurable Bundle includes splittable products and has quantity more than 1, then the order is split into the separate configured bundle items with its items also split.

Configurator

Configurator is a page where a shopper assembles a Configurable Bundle. It allows customers to choose compound and technically feasible product combinations online, making the shopping experience interactive for companies and their customers.

Configurable Bundle List

This page contains a list of all Configurable Bundle Templates that are active. All the templates are taken from the Back Office > Configurable Bundle Templates section. To configure the template, use our Configurable Bundle Template Back Office guide.

Configurator Page

Configurator is the exemplary page where you can set up your configurable bundle from the template.

All slots are optional, so you can fill, for example, only two slots from the example image above. However, you can customize this configuration according to project needs.

Current Constraints

• From the Configurator page, you cannot add the configured bundle to the shopping list or wishlist.
• The shopper cannot return to the Configurator page from the cart, reorder, or shopping list pages.
• The following products cannot be displayed in the Configurator:
  • products with the Measurement or Packaging Units
  • default product bundles
  • gift cards
• Product options are not displayed for concrete products.
• Product labels are not displayed for concrete products.
• Product quantity restrictions cannot be applied to concrete products.
• The slot page doesn’t have any sorting/pagination/search.
• Product bundles cannot be added to the configurable bundle.