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

Promotions

Promotions

A promotion is a marketing tool used to increase sales of a certain product or set of products. There are two types of promotions:

  • Shopping cart promotions, which are applied to items after they are added to shopping carts. Shopping cart promotions can be restricted to certain customers, based on Condition Rules.
  • Catalog promotions, which are applied to specific products in the catalog.

When exporting promotions, you can optionally include their associated eligibilities (in the case of shopping cart promotions), conditions, and actions.



Sample XML: Promotions


<promotion type="Cart">
    <store_code>SNAPITUPUK</store_code>
    <name>20% off all digital camera with coupon</name>
    <displayName>
        <value language="en">25 % off digital camera</value>
    </displayName>
    <code>CAMERA2</code>
    <description>20% off all DigiCameras (single use per customer only)(coupon code = CAMERA2-1, CAMERA2-2, CAMERA2-3,  CAMERA2-4, CAMERA2-4, CAMERA2-5) IN SNAPITUPUK store</description>
    <availability>
        <enabled>true</enabled>
    </availability>
    <actions>
        <action type="cartCategoryPercentDiscountAction">
            <parameters>
                <parameter>
                    <key>discountPercent</key>
                    <value>20.0</value>
                </parameter>
                <parameter>
                    <key>categoryCode</key>
                    <value>90000003|SNAPITUPUK</value>
                </parameter>
                <parameter>
                    <key>numItems</key>
                    <value>1</value>
                </parameter>
            </parameters>
            <exceptions/>
        </action>
    </actions>
    <selling_context>
        <guid>20% off all digital camera with coupon</guid>
        <name>20% off all digital camera with coupon</name>
        <description>Selling Context</description>
        <priority>1</priority>
        <conditions>
            <condition>
                <guid>20% off all digital camera with coupon_TIME</guid>
                <name>20% off all digital camera with coupon_TIME</name>
                <condition_string>{AND {SHOPPING_START_TIME.greaterThan (1262337131000L)} {SHOPPING_START_TIME.lessThan (1580548331000L)}}</condition_string>
                <dictionary_guid>TIME</dictionary_guid>
            </condition>
        </conditions>
    </selling_context>
</promotion>
<promotion type="Catalog">
    <catalog_code>SNAPITUPUS</catalog_code>
    <name>50% off all Single Use Camera's</name>
    <displayName/>
    <code>0774BF5E-B309-B50A-22AC-47576CC76992</code>
    <description>50% off all Single Use Camera's</description>
    <availability>
        <enabled>true</enabled>
        <enabledate>2008-01-01T00:00:00-08:00</enabledate>
    </availability>
    <actions>
        <action type="catalogCurrencyPercentDiscountAction">
            <parameters>
                <parameter>
                    <key>currency</key>
                    <value>USD</value>
                </parameter>
                <parameter>
                    <key>discountPercent</key>
                    <value>50.0</value>
                </parameter>
            </parameters>
            <exceptions/>
        </action>
    </actions>
</promotion>
...
</promotions>