Elastic Path Production Tools

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"/>
        </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>

..