The OfferFull response group returns comprehensive information about an offer. OfferFull is a parent response group that returns the results of the Offers response group as well as:
Merchant's name
Merchant's nickname
Merchant's state
Merchant's country
Operations that can use this response group include:
The following table describes the elements returned by OfferFull. The elements on the left side of a slash mark are the parents of the elements on the right side of the slash mark.
| Response Element | Ancestry | Definition |
|---|---|---|
|
Offers/Offer/OfferListing/ISPUStoreAddress/Address1 Offers/Offer/OfferListing/ISPUStoreAddress/Address2 Offers/Offer/OfferListing/ISPUStoreAddress/Address3 | Street address of the merchant. |
| Amount |
OfferSummary/LowestCollectiblePrice/Amount OfferSummary/LowestNewPrice/Amount OfferSummary/LowestRefurbishedPrice/Amount OfferSummary/LowestUsedPrice/Amount Offers/Offer/OfferListing/Price/Amount Offers/Offer/OfferListing/SalePrice/Amount | Price in terms of the lowest currency denomination, for example, pennies of the item offered for sale. See also FormattedPrice and CurrencyCode. |
Availability
| Offers/Offer/OfferListing/Availability | How soon the item can be shipped. |
AverageFeedbackRating
| Offers/Offer/Seller/AverageFeedbackRating | Customer review of an item represented by a number of stars where 5 stars is the highest rating, 0 the lowest. This element contains the average of all customer ratings of the item. |
City
| Offers/Offer/OfferListing/ISPUStoreAddress/City | The city where the store is that you can pick up the item. |
Condition
| Offers/Offer/OfferAttributes/Condition | The condition of the item, for example, new, used, or refurbished. |
ConditionNote
| Offers/Offer/OfferAttributes/ConditionNote | A note that describes the Condition. |
Country
| Offers/Offer/OfferListing/ISPUStoreAddress/Country | The country where the store is that you can pick up the item. |
Country
| Offers/Offer/Seller/Location/Country | The merchant's country |
| CurrencyCode |
OfferSummary/LowestCollectiblePrice/CurrencyCode OfferSummary/LowestNewPrice/CurrencyCode OfferSummary/LowestRefurbishedPrice/CurrencyCode OfferSummary/LowestUsedPrice/CurrencyCode Offers/Offer/OfferListing/Price/CurrencyCode Offers/Offer/OfferListing/SalePrice/CurrencyCode | An abbreviation that specifies the formatting to use when displaying the price. |
ExchangeId
|
Offers/Offer/OfferListing/ExchangeId OfferSummary/LowestNewPrice/FormattedPrice OfferSummary/LowestRefurbishedPrice/FormattedPrice OfferSummary/LowestUsedPrice/FormattedPrice Offers/Offer/OfferListing/Price/FormattedPrice Offers/Offer/OfferListing/SalePrice/FormattedPrice | Token that uniquely identifies an offer in the Marketplace. Exchange IDs are available for every item offered by a third-party seller. When using ExchangeId, you must also specify a matching SellerID and ASIN. |
| FormattedPrice |
OfferSummary/LowestCollectiblePrice/FormattedPrice OfferSummary/LowestNewPrice/FormattedPrice OfferSummary/LowestRefurbishedPrice/FormattedPrice OfferSummary/LowestUsedPrice/FormattedPrice Offers/Offer/OfferListing/Price/FormattedPrice Offers/Offer/OfferListing/SalePrice/FormattedPrice | The price formatted according to the CurrencyCode parameter. |
GlancePage
|
Offers/Offer/Seller/Glancepage Offers/Offer/Merchant/GlancePage | URL of a seller's web page. A GlancePage is not returned when the merchant is Amazon. |
IsEligibleForSuperSaverShipping
| Offers/Offer/OfferListing/IsEligibleForSuperSaverShipping | Specifies whether the items is eligible for super saving shipping. |
ISPUStoreHours
| Offers/Offer/OfferListing/ISPUStoreHours | Store hours when you can pick up an item when in store pickup is (ISPU) specified. |
MerchantId
| Offers/Offer/Merchant/MerchantId | A number that uniquely identifies a merchant |
Name
| Offers/Offer/OfferListing/ISPUStoreAddress/Name | The name of the store where you can pick up the item. |
Name
| Offers/Offer/Merchant/Name | Merchant's name |
Nickname
| Offers/Offer/Seller/Nickname | Seller's nickname |
OfferListingId
| Offers/Offer/OfferListing/OfferListingId | A number that uniquely identifies an offer listing. This number represents a sales offer from a specific merchant. |
PostalCode
| Offers/Offer/OfferListing/ISPUStoreAddress/PostalCode | Postal code, such as a postal code. |
Quantity
| OfferListing | The Quantity value is an integer that specifies the number of items in stock. A value of -1 specifies that a Quantity value is unknown. |
SellerId
| Offers/Offer/Seller/SellerId | A number that uniquely identifies a seller. |
State
| Offers/Offer/OfferListing/ISPUStoreAddress/State | The state in which the store is where the customer will pick up the item when in store pickup (ISPU) has been specified. |
State
| Offers/Offer/Seller/Location/State | The merchant's state |
SubCondition
| Offers/Offer/OfferAttributes/SubCondition | Further specifies the Condition of an item, for example, mint, verygood, good. Typically used to qualify the condition of a Used item. |
TotalCollectible
| OfferSummary/TotalCollectible | Total number of offers whose items are considered collectible. |
TotalFeedback
| Offers/Offer/Seller/TotalFeedback | Average rating of the customers' feedback about the seller. |
TotalNew
| OfferSummary/TotalNew | Total number of offers whose items are considered new. |
TotalOfferPages
| Offers/TotalOfferPages | Number of pages of offers. Up to ten offers are returned per page. By default, the first ten offers are returned in the resonse. |
TotalOffers
| Offers/TotalOffers | Total number of offers. |
TotalRefurbished
| OfferSummary/TotalRefurbished | Total number of offers whose items are considered refurbished. |
TotalUsed
| OfferSummary/TotalUsed | Total number of offers whose items are considered used. |
OfferFull also returns the elements that all response groups return, which is described in Elements Common to All Response Groups.
The folllowing request was used to illustrate the XML response elements returned by OfferFull.
http://ecs.amazonaws.com/onca/xml?Service=AWSECommerceService& AWSAccessKeyId=[Access Key ID]& Operation=ItemSearch& Condition=All& SearchIndex=Books& Title=Harry%20Potter& ResponseGroup=OfferFull
The following response snippet shows the elements returned by OfferFull.
<Item>
<ASIN>0439682584</ASIN>
<OfferSummary>
<LowestNewPrice>
<Amount>2580</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$25.80</FormattedPrice>
</LowestNewPrice>
<LowestUsedPrice>
<Amount>1599</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$15.99</FormattedPrice>
</LowestUsedPrice>
<LowestCollectiblePrice>
<Amount>2580</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$25.80</FormattedPrice>
</LowestCollectiblePrice>
<TotalNew>40</TotalNew>
<TotalUsed>16</TotalUsed>
<TotalCollectible>3</TotalCollectible>
<TotalRefurbished>0</TotalRefurbished>
</OfferSummary>
<Offers>
<TotalOffers>0</TotalOffers>
<TotalOffers>1</TotalOffers>
<TotalOfferPages>0</TotalOfferPages>
<TotalOfferPages>1</TotalOfferPages>
<Offer>
<Merchant>
<MerchantId>ATVPDKIKX0DER</MerchantId>
<Name>Amazon.com</Name>
<GlancePage>http://www.amazon.com/gp/help/seller/home.html?seller=ATVPDKIKX0DER</GlancePage>
</Merchant>
<OfferAttributes>
<Condition>New</Condition>
</OfferAttributes>
<OfferListing>
<OfferListingId>cMVuIFx8kiYSgRIJXiCzKZZyylwztVSAYV8vCo2OxHS8L9SB7lwho8fK6CxYkmdDPy8thFzm30Y%3D</OfferListingId>
<Price>
<Amount>2580</Amount>
<CurrencyCode>USD</CurrencyCode>
<FormattedPrice>$25.80</FormattedPrice>
</Price>
<Availability>Usually ships in 24 hours</Availability>
<IsEligibleForSuperSaverShipping>1</IsEligibleForSuperSaverShipping>
</OfferListing>
</Offer>
</Offers>
</Item>