Announcement: You can find the guides for Commerce 7.5 and later on the new Elastic Path Documentation site. This Developer Center contains the guides for Commerce 6.13.0 through 7.4.1.Visit new site

This version of Elastic Path Commerce is no longer supported or maintained. To upgrade to the latest version, contact your Elastic Path representative.

Product Bundles

Product Bundles

Product bundles are collections of products sold together under a single product code. Typically, a bundle is comprised of one main product and several related constituent products. For example, a winter coat bundled with a scarf and gloves. Bundled products generally offer a price savings when compared with purchasing the constituent products individually.

When you export a product bundle, the exported information includes the product code for the bundle and the product codes for the bundle constituents. A product's bundle constituents are exported separately in a bundle.xml file; see the sample XML product bundle below for more information. Associated categories are automatically exported, as well as the catalogs associated with those categories.

Like a regular product, you can optionally export associated assets, inventory and product associations.

If you import a product bundle into a target system that has a product bundle with the same product code, all constituents of the target bundle are first cleared and the imported constituents are written in their place.

Sample XML Product Bundle

A product bundle's constituents are exported in a separate file called bundle.xml. bundle.xml uses the product's <code> to reference the product. For example, the product bundle code is BUN_DIG_BEG and the bundle's code is <bundle code="BUN_DIG_BEG">.


<products>
...
<product pricingMechanism="assigned" bundle="true">
    <code>BUN_DIG_BEG</code>
    <name>
        <value language="en">Digital Photography - Beginner Bundle</value>
        <value language="fr">Photographie numérique - Offre spécial pour débutant</value>
    </name>
    <type>Camcorders &amp; Digital Cameras</type>
    <taxcode>GOODS</taxcode>
    <brand>Store</brand>
    <image></image>
    <availability>
        <storevisible>true</storevisible>
        <notsoldseperately>false</notsoldseperately>
        <enabledate>2009-11-26T00:00:00-08:00</enabledate>
        <minorderqty>1</minorderqty>
        <availabilityrule>AVAILABLE_WHEN_IN_STOCK</availabilityrule>
        <orderlimit>0</orderlimit>
    </availability>
    <attributes>
        <attribute key="description">
            <value language="en">Everything you need to get started in the exciting world of digital photography.</value>
        </attribute>
    </attributes>
    <skus>
        <sku guid="23ac0ac4-4720-4225-8b10-59d2245c47d4">
            <code>BUN_DIG_BEG_1</code>
            <shippable enabled="true">
                <weight units="KG">0.00</weight>
                <width units="CM">0.00</width>
                <length units="CM">0.00</length>
                <height units="CM">0.00</height>
            </shippable>
            <digitalasset enabled="false"/commerce-legacy/>
        </sku>
    </skus>
    <seo>
        <url>
            <value language="en"></value>
            <value language="fr"></value>
        </url>
        <title>
            <value language="en"></value>
            <value language="fr"></value>
        </title>
        <keywords>
            <value language="en"></value>
            <value language="fr"></value>
        </keywords>
        <description>
            <value language="en"></value>
            <value language="fr"></value>
        </description>
    </seo>
</product>
...
</products>

...
<bundle code="BUN_DIG_BEG">
    <constituents>
        <constituent>
            <guid>0F7C2816-3B0A-CF17-4F8E-76CE7CAEEE61</guid>
            <code type="product">BUN_DIG_CAM</code>
            <quantity>1</quantity>
            <ordering>0</ordering>
            <price_adjustments/>
        </constituent>
        <constituent>
            <guid>0C07AD3C-AC4D-723A-A153-A37BA3BB9A35</guid>
            <code type="product">BUN_ACC_PCH</code>
            <quantity>1</quantity>
            <ordering>1</ordering>
            <price_adjustments/>
        </constituent>
        <constituent>
            <guid>8C41AD31-0965-ED19-DAFE-176513DFDF95</guid>
            <code type="product">BUN_TUT_1</code>
            <quantity>1</quantity>
            <ordering>2</ordering>
            <price_adjustments/>
        </constituent>
    </constituents>
</bundle>

..