PromotionSummary Response Group

The PromotionSummary response group returns summary information about a promotion, including the promotion category, the promotion ID, elegibility requirements, and the terms and conditions of the promotion. Most if not all of the information you need to display to a customer concerning a promotion is returned by the PromotionSummary response group.

For additional information about a promotion, use the PromotionDetails response group.

PromotionSummary must be used along with one of the following response groups:

• Large

• OfferFull

• Offers

An error is returned if ProductDetails is not accompanied by one of these response groups.

For more information, see Displaying Promotions.

Promotion Categories

Promotion categories are returned by the Category element and include:

• FreeShipping--The item is shipped free of charge.

• BuyQuantityXGetAmountOffX--If you buy at least the specified number of items, the cost of the next item is discounted. For example, if a customer buys three shirts, the fourth shirt is half off.

• ForEachQuantityXGetAmountOffX--Each item is discounted by the specified amount. For example, all shirts are 30% off.

Relevant Operations

Operations that can use this response group are:

• ItemLookup

• ItemSearch

• ListLookup

• SimilarityLookup

Response Elements

The following table describes and shows the ancestry of the elements returned by PromotionSummary. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.

With the exception of Promotions, Promotion, and Summary, the ancestry of all elements in the table are Offers/Offer/Promotions/Promotion/Summary.

PromotionSummary also returns the elements that all response groups return.

Parent Response Group

The following response groups are parent response groups of PromotionSummary.

• None

Child Response Group

The following response groups are children response groups of PromotionSummary.

• None

Sample REST Use Case

The folllowing request was used to illustrate the XML response elements returned by PromotionSummary.

http://webservices.amazon.com/onca/xml?Service=AWSECommerceService&
Operation=ItemLookup&
ContentType=text/xml&
AWSAccessKeyId=[Access Key ID]&
ItemId=B000AQSMPO&
IdType=ASIN&
ResponseGroup=Offers,PromotionSummary&
Version=2007-01-17

Sample Response Snippet

The following response snippet shows the elements returned by PromotionSummary.

<Promotions>
  <Promotion>
  <Summary>
    <PromotionId>A2QIQTNOFYRK5N</PromotionId> 
    <Category>BuyAmountXGetAmountOffX</Category> 
    <EligibilityRequirementDescription>Save $25.00 when you spend $125.00 or more on Kitchen & Housewares or Bed & Bath products offered by Amazon.com. Enter code AUGSAVER at checkout.</EligibilityRequirementDescription> 
    <BenefitDescription>Save $25.00 when you spend $125.00 or more on Kitchen & Housewares or Bed & Bath products offered by Amazon.com. Enter code AUGSAVER at checkout.</BenefitDescription> 
    <TermsAndConditions><STRONG>To receive the Best Value discount:</STRONG> <OL> <LI>Add $125 of qualifying Kitchen & Housewares&nbsp;or Bed & Bath products to your Shopping Cart via the <STRONG>Add to Shopping Cart</STRONG> button on each respective product information page. <LI>At checkout, enter the promotional code and click the <STRONG>Apply</STRONG> button. <LI>The amount of the Best Value savings ($25) will be reflected on the final order checkout page. <LI>If you remove any of the participating promotion items from your Shopping Cart or violate any of the terms and conditions listed below, the promotion will be invalid, and the discount will be removed from the order. <LI>If you return any of the items involved in the promotion, the discount previously applied to the order will be subtracted from the return credit. </LI></OL><BR><STRONG>Terms and Conditions:</STRONG> <UL> <LI>Promotional offer valid for a limited time only. Items placed in Shopping Cart overnight may not be eligible for promotion at time of checkout. <LI>Promotion applies only to qualifying items displaying the offer message on their product information pages. Items that do not display the offer message do not qualify, regardless of the nature of the item.&nbsp; All All Clad, Calphalon, Capresso, Emerilware, Le Creuset, Orrefors, Kosta Boda, J.A. Henckels, Wusthof, Riedel, Marquis, Shun, Komachi, Waterford, Weber, Tassimo, Margaritaville, DKNY, Tommy Hilfiger, Nautica, Oscar by Oscar de Larenta, Cath Kidston, Raymond Waites, and KitchenAid Proline&nbsp;products are excluded from this offer.&nbsp; <LI>All Furniture & Decor and Outdoor Living products are excluded from this offer. <LI>Applies only to products sold by the merchant indicated in the promotional offer message. Does not apply to items sold by other merchants on the Amazon.com Web site. For example, where the promotional offer applies to items offered by Amazon.com, items offered by other merchants on the Amazon.com Web site (e.g. Land's End, Target, etc.) do not qualify. <LI>Does not apply to any products purchased in Amazon.com's other sites, including Amazon.co.uk, Amazon.de, Amazon.fr, or Amazon.co.jp, or in Marketplace, zShops, or Auctions. <LI>Unless the offer message indicates otherwise, the promotional offer applies to the lowest priced qualifying item(s) <LI>Applies only when all qualifying and benefit products in the promotion are purchased in one order. <LI>Applies only to complete orders shipping to a single address that meet all other promotional requirements. <LI>Offer good while supplies last. <LI>No substitutions or rain checks. <LI>Offer must be redeemed through the Shopping Cart. Does not apply to orders placed with 1 Click. <LI>Shipping and handling charges apply to all products, including bonus items. <LI>Offer may not be combined with other offers, including promotional certificates. <LI>Void where prohibited. </LI></UL></TermsAndConditions> 
    </Summary>
  </Promotion>
</Promotions>