Product Promotions Import/Export

A product promotion rule adds all required information to target certain products with product-specific discount rules. The products being promoted are described through selection rules. You can tier product promotions (multiple discount elements) or designate them as simple (unconditional). The special discount rule Buy X / Get Y is represented by its own XML elements.

Bonus Discounts

Bonus products are a special, more complex discount than typical monetary or percentage discounts. Bonus discounts describe the actual bonus products being granted by the promotion rule. The current XML schema supports the definition of SKU lists of bonus products.

<xsd:complexType name="Bonus">
 <xsd:choice>
  <xsd:element name="bonus-products" type="BonusProductList" />
 </xsd:choice>
</xsd:complexType>
<xsd:complexType name="BonusProductList">
 <xsd:sequence>
  <xsd:element name="product-id" type="Generic.NonEmptyString.256" minOccurs="1" maxOccurs="unbounded" />
 </xsd:sequence>
</xsd:complexType>

Product Specification

A product specification is used by product promotions to describe the set of promoted and conditional products, and therefore supports certain rules for selecting products. A product specification lets merchants set up rules for products that are included or excluded in the specification.

The following XML snippet represents a simple product promotion that grants a 10% discount on all 'Sony' products.

<promotion promotion-id="simple-product-promo" campaign-id="c1">
 <enabled-flag>true</enabled-flag>
 <name xml:lang="x-default">Simple ProductPromotion</name>
 <product-promotion-rule>
  <discounted-products>
    <included-products>
       <condition-group>
           <brand-condition>
             <brand>Westsea</brand>
           </brand-condition>
       </condition-group>
    </included-products>
  </discounted-products>
  <simple-discount>
   <percentage>10</percentage>
  </simple-discount>
 </product-promotion-rule>
</promotion>

The following XML sample represents a more complex product promotion that grants a tiered discount (for example, $10 off, 20%) on all Cheap Televisions excluding low stock Phillips depending on the purchase amount of any Sony product.

<promotion promotion-id="tiered-product-promo" campaign-id="c1">
 <enabled-flag>true</enabled-flag>
 <name xml:lang="x-default">Simple ProductPromotion</name>
 <product-promotion-rule>
   <qualifying-products>
     <included-products>
       <condition-group>
         <brand-condition>
          <brand>Westsea</brand>
         </brand-condition>
       </condition-group>
     </included-products>
   </qualifying-products>
   <discounted-products>
     <included-products>
       <condition-group>
        <category-condition recursive="true">
          <category-id>Roller</category-id>
        </category-condition>
          <price-condition operator="less than">
            <price>500</price>
          </price-condition>
       </condition-group>
     </included-products>
       <excluded-products>
         <condition-group>
           <brand-condition>
             <brand>Nason</brand>
           </brand-condition>
           <inventory-condition operator="less than">
             <ats>50</ats>
           </inventory-condition>
         </condition-group>
       </excluded-products>
   </discounted-products>
     <discounts condition-type="product-amount">
       <discount>
         <threshold>50</threshold>
         <amount>10</amount>
       </discount>
       <discount>
         <threshold>100</threshold>
         <percentage>20</percentage>
       </discount>
     </discounts>
 </product-promotion-rule>
</promotion>

The following XML sample shows a simple bonus promotion that grants free bonus products (that is, SKU1 and SKU2) on the purchase of $200 of Sony products.

<promotion promotion-id="conditional-bonus-promotion" campaign-id="c1">
  <enabled-flag>true</enabled-flag>
  <name xml:lang="x-default">Conditional BonusPromotion</name>
  <product-promotion-rule>
    <qualifying-products>
      <included-products>
        <condition-group>
          <brand-condition>
            <brand>Westsea</brand>
          </brand-condition>
        </condition-group>
      </included-products>
    </qualifying-products>
  <discounts condition-type="product-amount">
    <discount>
      <threshold>100</threshold>
      <bonus>
        <bonus-products>
          <product-id>SKU1</product-id>
          <product-id>SKU2</product-id>
        </bonus-products>
      </bonus>
    </discount>
  </discounts>
  </product-promotion-rule>
</promotion>

Product Combinations

Product combinations are supported with With a combination of products promotions and Buy X and Y Get Z promotions.

The combination of a quantity and a ProductSpecification is a constraint. A collection of constraints is a product combination. The element product-combination-promotion-rule uses the complex type ProductCombinationPromotionRule.

Example 1:Buy 3X 2Y for $5.00

In this example, the customer must buy three kids accessories and two pieces of kids clothing to get a fixed price of $5.00 for each product.

 <promotion promotion-id="Buy3X2YGetfixedprice">
        <enabled-flag>false</enabled-flag>
        <searchable-flag>false</searchable-flag>
        <exclusivity>global</exclusivity>
        <name xml:lang="x-default">Buy3X2YGetfixedprice</name>
        <callout-msg xml:lang="x-default">Buy 3X 2Y for $5.00</callout-msg>
        <product-combination-promotion-rule>
            <qualifying-products-combination>
                <product-constraints>
                    <product-constraint>
                        <quantity>3</quantity>
                        <product-specification>
                            <included-products>
                                <condition-group>
                                    <category-condition catalog-id="storefront-catalog-en">
                                        <category-id>kids-accessories</category-id>
                                    </category-condition>
                                </condition-group>
                            </included-products>
                        </product-specification>
                    </product-constraint>
                    <product-constraint>
                        <quantity>2</quantity>
                        <product-specification>
                            <included-products>
                                <condition-group>
                                    <category-condition catalog-id="storefront-catalog-en">
                                        <category-id>kids-clothing</category-id>
                                    </category-condition>
                                </condition-group>
                            </included-products>
                        </product-specification>
                    </product-constraint>
                </product-constraints>
            </qualifying-products-combination>
            <bogo>
                <fixed-price>5.00</fixed-price>
            </bogo>
        </product-combination-promotion-rule>
    </promotion>

Example Buy X and Y Get 25% percent off Z

In this example, if you buy one product from Atari or Apple and one product from EASports or Lucas Arts, you get 25% off a product from Rockstar Games.

<promotion promotion-id="BuyXYGetpercentoffZ">
        <enabled-flag>false</enabled-flag>
        <searchable-flag>false</searchable-flag>
        <exclusivity>class</exclusivity>
        <name xml:lang="x-default">Buy X and Y get percent off Z</name>
        <product-combination-promotion-rule>
            <qualifying-products-combination>
                <product-constraints>
                    <product-constraint>
                        <quantity>1</quantity>
                        <product-specification>
                            <included-products>
                                <condition-group>
                                    <brand-condition operator="is equal">
                                        <brand>Nason</brand>
                                        <brand>Westsea</brand>
                                    </brand-condition>
                                </condition-group>
                            </included-products>
                        </product-specification>
                    </product-constraint>
                    <product-constraint>
                        <quantity>1</quantity>
                        <product-specification>
                            <included-products>
                                <condition-group>
                                    <brand-condition operator="is equal">
                                        <brand>EASports</brand>
                                        <brand>LucasArts</brand>
                                    </brand-condition>
                                </condition-group>
                            </included-products>
                        </product-specification>
                    </product-constraint>
                </product-constraints>
            </qualifying-products-combination>
            <discounted-products-combination>
                <product-constraints>
                    <product-constraint>
                        <quantity>1</quantity>
                        <product-specification>
                            <included-products>
                                <condition-group>
                                    <brand-condition operator="is equal">
                                        <brand>Same Games</brand>
                                    </brand-condition>
                                </condition-group>
                            </included-products>
                        </product-specification>
                    </product-constraint>
                </product-constraints>
            </discounted-products-combination>
            <bogo>
                <percentage>25.0</percentage>
            </bogo>
            <max-applications>1</max-applications>
        </product-combination-promotion-rule>
    </promotion>

Product Shipping Promotions

Import/export product shipping promotions, as specified in promotions.xsd support the following: