Amazon Services
Amazon Marketplace Web Service (Amazon MWS) Documentation

Deprecation Notice:

Amazon Marketplace Web Service (MWS) will no longer be available after March 31, 2024. All MWS developers must migrate to Selling Partner API (SP-API) to avoid service disruptions. Refer to the Migration Hub for more information.

Amazon MWS Documentation

AnyOfferChangedNotification

The AnyOfferChanged notification is sent whenever there is a listing change for any of the top 20 offers, by condition (new or used), or if the external price (the price from other retailers) changes for an item that you sell. The top 20 offers are determined by the landed price, which is the price plus shipping minus Amazon Points. If multiple sellers are charging the same landed price, the results will be returned in random order.

You will only receive AnyOfferChanged notifications for items for which you have active offers. You cannot subscribe to notifications for items for which you do not have active offers.

Availability

This notification is available in all marketplaces.

Elements

This is the root element of the AnyOfferChangedNotification.xsd schema:

Name Description
AnyOfferChangedNotification The root element of the payload for the notification that is sent when an offer has changed.

These are the complex elements of the AnyOfferChangedNotification element:

Name Description
BuyBoxPrice The price of the item that is displayed in the Buy Box.
LowestPrice The lowest price of the item.
Offer One of the top 20 offers for the item and condition that had an offer change.
OfferChangeTrigger The event that caused the notification to be sent.
OfferCount The total number of offers for the specified condition and fulfillment channel.
Points The number of Amazon Points offered with the purchase of an item.
Note: The Points element is only returned in Japan (JP).
SalesRank The sales rank of the item in the given product category.
SellerFeedbackRating Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received.
ShippingTime The minimum and maximum time, in hours, that the item will likely be shipped after the order has been placed.
ShipsFrom The state and country from where the item is shipped.
Summary Information about the product that had the offer change. The information in this summary applies to all conditions of the product.

AnyOfferChangedNotification

The root element of the payload for the notification that is sent when an offer has changed.

AnyOfferChangedNotification Elements

The following table shows the child elements of the AnyOfferChangedNotification element:

Name Description
OfferChangeTrigger The event that caused the notification to be sent.

Required.

Type: OfferChangeTrigger

Summary Information about the product that had the offer change. The information in this summary applies to all conditions of the product.

Required.

Type: Summary

Offers The top 20 competitive offers for the item and condition that triggered the notification.

Required.

Type: List of Offer

BuyBoxPrice

The price of the item that is displayed in the Buy Box.

BuyBoxPrice Attributes

The following table shows the attributes of the BuyBoxPrice element:

Name Description
condition Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.

Required.

Type: xs:string

BuyBoxPrice Elements

The following table shows the child elements of the BuyBoxPrice element:

Name Description
LandedPrice ListingPrice + Shipping - Points.

Required.

Type: MoneyType

ListingPrice The price of the item.

Required.

Type: MoneyType

Shipping The shipping cost.

Required.

Type: MoneyType

Points The number of Amazon Points offered with the purchase of an item.

Optional.

Note: The Points element is only returned in Japan (JP).

Type: Points

LowestPrice

The lowest price of the item.

LowestPrice Attributes

The following table shows the attributes of the LowestPrice element:

Name Description
condition Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.

Required.

Type: xs:string

fulfillmentChannel Indicates whether the item is fulfilled by Amazon or by the seller.

Required.

Type: FulfillmentChannelType

LowestPrice Elements

The following table shows the child elements of the LowestPrice element:

Name Description
LandedPrice ListingPrice + Shipping - Points.

Required.

Type: MoneyType

ListingPrice The price of the item.

Required.

Type: MoneyType

Shipping The shipping cost.

Required.

Type: MoneyType

Points The number of Amazon Points offered with the purchase of an item.

Optional.

Note: The Points element is only returned in Japan (JP).

Type: Points

Offer

One of the top 20 offers for the item and condition that had an offer change.

Offer Elements

The following table shows the child elements of the Offer element:

Name Description
SellerId The seller identifier for the offer.

Required.

Type: xs:string

SubCondition The subcondition of the item. For example: New, Mint, Very Good, Good, Acceptable, Poor, Club, OEM, Warranty, Refurbished Warranty, Refurbished, Open Box, or Other.

Required.

Type: xs:string

SellerFeedbackRating Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received.

Optional.

Type: SellerFeedbackRating

ShippingTime The minimum and maximum time, in hours, that the item will likely be shipped after the order has been placed.

Required.

Type: ShippingTime

ListingPrice The price of the item.

Required.

Type: MoneyType

Points The number of Amazon Points offered with the purchase of an item.

Optional.

Note: The Points element is only returned in Japan (JP).

Type: Points

Shipping The shipping cost.

Required.

Type: MoneyType

ShipsFrom The state and country from where the item is shipped.

Optional.

Type: ShipsFrom

IsFulfilledByAmazon Indicates whether the offer is fulfilled by Amazon.

Required.

Type: xs:boolean

IsBuyBoxWinner Indicates whether the offer is currently in the Buy Box. There can be up to two Buy Box winners at any time per ASIN, one that is eligible for Prime and one that is not eligible for Prime.

Optional.

Type: xs:boolean

ConditionNotes Information about the condition of the item.

Optional.

Type: xs:string

PrimeInformation Amazon Prime information.

Optional.

Type: PrimeInformation

IsExpeditedShippingAvailable Indicates whether expedited shipping is available.

Optional.

Type: xs:boolean

IsFeaturedMerchant Indicates whether the seller of the item is eligible to win the Buy Box.

Optional.

Type: xs:boolean

ShipsDomestically Indicates whether the item ships domestically.

Optional.

Type: xs:boolean

OfferChangeTrigger

The event that caused the notification to be sent.

OfferChangeTrigger Elements

The following table shows the child elements of the OfferChangeTrigger element:

Name Description
MarketplaceId The marketplace identifier of the item that had an offer change.

Required.

Type: MarketplaceType

ASIN The ASIN for the item that had an offer change.

Required.

Type: xs:string

ItemCondition The condition of the item that had an offer change. For example, if a used offer changes, the list of offers in the Offers element will be only used items. The Summary element provides a summary for the other conditions that can be used for repricing.

Required.

Type: xs:string

TimeOfOfferChange The update time for the offer that caused this notification.

Required.

Type: xs:dateTime

OfferChangeType The type of offer that changed and triggered this notification.

OfferChangeType values:

  • External - An offer from a non-Amazon seller. The CompetitivePriceThreshold in the Summary element has changed.
  • Internal - An offer from an Amazon seller. The price of an offer on Amazon's retail website has changed.

Required.

Type: xs:string

OfferCount

The total number of offers for the specified condition and fulfillment channel.

OfferCount Attributes

The following table shows the attributes of the OfferCount element:

Name Description
condition Indicates the condition of the item. For example: New, Used, Collectible, Refurbished, or Club.

Required.

Type: xs:string

fulfillmentChannel Indicates whether the item is fulfilled by Amazon or by the seller.

Required.

Type: FulfillmentChannelType

OfferCount Elements

The OfferCount element does not contain any child elements. It is an extension of Type: xs:int.

Points

The number of Amazon Points offered with the purchase of an item.

Points Elements

The following table shows the child elements of the Points element:

Name Description
PointsNumber The number of Amazon Points offered with the purchase of an item.

Required.

Type: xs:int

PrimeInformation

Amazon Prime information.

PrimeInformation Elements

The following table shows the child elements of the PrimeInformation element:

Name Description
IsNationalPrime Indicates whether the offer is an Amazon Prime offer throughout the entire marketplace where it is listed.

Required.

Type: xs:boolean

IsPrime Indicates whether the offer is an Amazon Prime offer.

Required.

Type: xs:boolean

SalesRank

The sales rank of the item in the given product category.

SalesRank Elements

The following table shows the child elements of the SalesRank element:

Name Description
ProductCategoryId The product category identifier of the item.

Required.

Type: xs:string

Rank The sales rank of the item in the given product category.

Required.

Type: xs:int

SellerFeedbackRating

Information about the seller's feedback, including the percentage of positive feedback, and the total count of feedback received.

SellerFeedbackRating Elements

The following table shows the child elements of the SellerFeedbackRating element:

Name Description
SellerPositiveFeedbackRating The percentage of positive feedback for the seller in the past 365 days.

Optional.

Type: xs:double

FeedbackCount The count of feedback received about the seller.

Required.

Type: xs:long

ShippingTime

The minimum and maximum time, in hours, that the item will likely be shipped after the order has been placed.

ShippingTime Attributes

The following table shows the attributes of the ShippingTime element:

Name Description
minimumHours The minimum time, in hours, that the item will likely be shipped after the order has been placed.

Optional.

Type: xs:short

maximumHours The maximum time, in hours, that the item will likely be shipped after the order has been placed.

Optional.

Type: xs:short

availableDate The date when the item will be available for shipping. Only displayed for items that are not currently available for shipping.

Optional.

Type: xs:dateTime

availabilityType Indicates whether the item is available for shipping now, or on a known or an unknown date in the future. If known, the availableDate attribute indicates the date that the item will be available for shipping.

Optional.

Type: AvailabilityType

ShipsFrom

The state and country from where the item is shipped.

ShipsFrom Elements

The following table shows the child elements of the ShipsFrom element:

Name Description
State The state from where the item is shipped.

Optional.

Type: xs:string

Country The country from where the item is shipped.

Optional.

Type: xs:string

Summary

Information about the product that had the offer change. The information in this summary applies to all conditions of the product.

Summary Elements

The following table shows the child elements of the Summary element:

Name Description
NumberOfOffers A list that contains the total number of offers for the item for the given conditions and fulfillment channels.

Required.

Type: List of OfferCount

LowestPrices A list that contains the lowest prices of the item for the given conditions and fulfillment channels.

Required.

Type: List of LowestPrice

BuyBoxPrices A list that contains the Buy Box price of the item for the given conditions.

Optional.

Type: List of BuyBoxPrice

ListPrice The list price of the item as suggested by the manufacturer.

Optional.

Type: MoneyType

SuggestedLowerPricePlusShipping The suggested lower price of the item, including shipping (minus Amazon Points). The suggested lower price is based on a range of factors, including historical selling prices, recent Buy Box-eligible prices, and input from customers for your products.

Optional.

Type: MoneyType

SalesRankings A list that contains the sales rank of the item in the given product categories.

Optional.

Type: List of SalesRank

BuyBoxEligibleOffers A list that contains the total number of offers that are eligible for the Buy Box for the given conditions and fulfillment channels.

Required.

Type: List of OfferCount

CompetitivePriceThreshold This price is based on competitive prices from other retailers (excluding other Amazon sellers). The offer may be ineligible for the Buy Box if the seller's price + shipping (minus Amazon Points) is greater than this competitive price.
Note: In Japan, CompetitivePriceThreshold considers any points that a non-Amazon retailer applies to their selling price.

Optional.

Type: MoneyType