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.
AnyOfferChanged通知は、出品している商品について、コンディション(新品または中古品)別の上位20の出品情報の変更があるたびに送信されます。上位20の商品は、配送料込み価格 (価格 ＋ 配送料 - 獲得するAmazonポイント数)によって決まります。複数の出品者が同じ配送料込み価格を設定している場合、結果は順不同で返されます。
出品がアクティブな商品についてのみAnyOfferChanged通知を受け取ります。アクティブな出品をしていない商品については、通知をサブスクライブすることはできません。
以下の表は、AnyOfferChangedNotification.xsdスキーマのルート要素を示しています。
| 名前 | 説明 |
|---|---|
| AnyOfferChangedNotification | 出品情報が変更された場合に送信される通知のペイロードのルート要素。 |
以下の表は、AnyOfferChangedNotification要素の複合要素を示しています。
| 名前 | 説明 |
|---|---|
| BuyBoxPrice | ショッピングカートボックスに表示される商品の価格。 |
| LowestPrice | 商品の最低価格。 |
| Offer | 商品やコンディションに変更があった上位20の出品商品の1つ。 |
| OfferChangeTrigger | 通知の送信を引き起こしたイベント。 |
| OfferCount | 指定したコンディションおよび配送経路の商品の合計出品数。 |
| Points | 商品の購入で獲得するAmazonポイント数。 注: Points要素が返されるのは日本(JP)の場合のみです。
|
| SalesRank | 特定の商品カテゴリーの商品の売上ランキング。 |
| SellerFeedbackRating | 出品者のフィードバックに関する情報(良い評価を受けた割合など)および寄せられたフィードバックの総数。 |
| ShippingTime | 注文があってから商品が出荷できるようになるまでの最短時間と最長時間(時間単位)。 |
| ShipsFrom | 商品の発送元の都道府県および国。 |
| Summary | 出品情報に変更のあった商品に関する情報。このサマリーの情報は、すべてのコンディションの商品に適用されます。 |
出品情報が変更された場合に送信される通知のペイロードのルート要素。
以下の表は、AnyOfferChangedNotification要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| OfferChangeTrigger | 通知の送信を引き起こしたイベント。 必須。 タイプ： OfferChangeTrigger |
| Summary | 出品情報に変更のあった商品に関する情報。このサマリーの情報は、すべてのコンディションの商品に適用されます。 必須。 タイプ： Summary |
| Offers | 通知をトリガーした商品およびコンディションの上位20の競合出品。 必須。 タイプ：タイプのリスト： Offer |
ショッピングカートボックスに表示される商品の価格。
以下の表は、BuyBoxPrice要素の属性を示しています。
| 名前 | 説明 |
|---|---|
| condition | 商品のコンディションを表示します。例：New、 Used、
Collectible、 Refurbished、
Club。 必須。 タイプ：xs:string |
商品の最低価格。
以下の表は、LowestPrice要素の属性を示しています。
| 名前 | 説明 |
|---|---|
| condition | 商品のコンディションを表示します。例：New、 Used、
Collectible、 Refurbished、
Club。 必須。 タイプ：xs:string |
| fulfillmentChannel | Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。 必須。 |
商品やコンディションに変更があった上位20の出品商品の1つ。
以下の表は、Offer要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| SellerId | 出品商品の出品者ID。 必須。 タイプ：xs:string |
| SubCondition | 商品のサブコンディション。例：New、Mint、Very
Good、Good、Acceptable、Poor、Club、OEM、Warranty、Refurbished
Warranty、Refurbished、Open Box、
またはOther。 必須。 タイプ：xs:string |
| SellerFeedbackRating | 出品者のフィードバックに関する情報(良い評価を受けた割合など)および寄せられたフィードバックの総数。 任意。 タイプ： SellerFeedbackRating |
| ShippingTime | 注文があってから商品が出荷できるようになるまでの最短時間と最長時間(時間単位)。 必須。 タイプ： ShippingTime |
| ListingPrice | 商品の価格。 必須。 タイプ： MoneyType |
| Points | 商品の購入で獲得するAmazonポイント数。 任意。 注: Points要素が返されるのは日本(JP)の場合のみです。
タイプ： Points |
| Shipping | 配送料。 必須。 タイプ： MoneyType |
| ShipsFrom | 商品の発送元の都道府県および国。 任意。 タイプ： ShipsFrom |
| IsFulfilledByAmazon | Amazonから出荷する出品商品かどうかを示します。 必須。 タイプ：xs:boolean |
| IsBuyBoxWinner | 現在、出品商品がショッピングカートにあるかどうかを示します。いつでも、1つのASINあたり最大2件(プライム対象とプライム対象外それぞれ1つ)のショッピングカートボックスを獲得できます。 任意。 タイプ：xs:boolean |
| PrimeInformation | Amazonプライムに関する情報。 任意 タイプ：PrimeInformation |
| IsExpeditedShippingAvailable | お急ぎ便を利用できるかどうかを示します。 任意。 タイプ：xs:boolean |
| IsFeaturedMerchant | 商品の出品者にショッピングカートボックスを獲得する資格があるかどうかを示します。 任意。 タイプ：xs:boolean |
| ShipsDomestically | 国内配送の対象商品かどうかを示します。 任意。 タイプ：xs:boolean |
通知の送信を引き起こしたイベント。
以下の表は、OfferChangeTrigger要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| MarketplaceId | 出品情報に変更のあった商品のマーケットプレイスID。 必須。 タイプ： MarketplaceType |
| ASIN | 出品情報に変更のあった商品のASIN。 必須。 タイプ：xs:string |
| ItemCondition | 出品情報に変更のあった商品のコンディション。たとえば、中古品の出品情報に変更があった場合、Offers要素の商品リストには中古品のみが表示されます。Summary要素は価格の改定時に参考となるその他の条件の概要を示します。 必須。 タイプ：xs:string |
| TimeOfOfferChange | この通知のきっかけとなった出品情報の更新時間。 必須。 タイプ：xs:dateTime |
指定したコンディションおよび配送経路の商品の合計出品数。
以下の表は、OfferCount要素の属性を示しています。
| 名前 | 説明 |
|---|---|
| condition | 商品のコンディションを表示します。例：New、 Used、
Collectible、 Refurbished、
Club。 必須。 タイプ：xs:string |
| fulfillmentChannel | Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。 必須。 |
OfferCount要素には子要素がありません。OfferCount要素はタイプ：xs:intの拡張型です。
商品の購入で獲得するAmazonポイント数。
以下の表は、Points要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| PointsNumber | 商品の購入で獲得するAmazonポイント数。 必須。 タイプ：xs:int |
Amazonプライムに関する情報。
以下の表は、PrimeInformation要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| IsNationalPrime | 出品されているマーケットプレイス全体でAmazonプライムの対象であるかどうかを示す。 必須。 タイプ：xs:boolean |
| IsPrime | Amazonプライム対象の出品かどうかを示す。 必須。 タイプ：xs:boolean |
特定の商品カテゴリーの商品の売上ランキング。
以下の表は、SalesRank要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| ProductCategoryId | 商品の商品カテゴリーID。 必須。 タイプ：xs:string |
| Rank | 特定の商品カテゴリーの商品の売上ランキング。 必須。 タイプ：xs:int |
出品者のフィードバックに関する情報(良い評価を受けた割合など)および寄せられたフィードバックの総数。
以下の表は、SellerFeedbackRating要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| SellerPositiveFeedbackRating | 過去365日間に出品者が良い評価を受けた割合。 任意。 タイプ：xs:double |
| FeedbackCount | 出品者に関して寄せられたフィードバックの数。 必須。 タイプ：xs:long |
注文があってから商品が出荷できるようになるまでの最短時間と最長時間(時間単位)。
以下の表は、ShippingTime要素の属性を示しています。
| 名前 | 説明 |
|---|---|
| minimumHours | 注文があってから商品が出荷できるようになるまでの最短時間(時間単位)。 任意。 タイプ：xs:short |
| maximumHours | 注文があってから商品が出荷できるようになるまでの最長時間(時間単位)。 任意。 タイプ：xs:short |
| availableDate | 商品の出荷予定日。現在出荷できない商品にのみ表示。 任意。 タイプ：xs:dateTime |
| availabilityType | 現在出荷可能な商品であるか、出荷予定日がわかっている/不明の商品であるかを示します。 出荷予定日がわかっている場合、availableDate属性は商品の出荷予定日を示します。 任意。 タイプ： AvailabilityType |
商品の発送元の都道府県および国。
以下の表は、ShipsFrom要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| State | 商品の発送元の都道府県。 任意。 タイプ：xs:string |
| Country | 商品の発送元の国。 任意。 タイプ：xs:string |
出品情報に変更のあった商品に関する情報。このサマリーの情報は、すべてのコンディションの商品に適用されます。
以下の表は、Summary要素の子要素を示しています。
| 名前 | 説明 |
|---|---|
| NumberOfOffers | 指定したコンディションおよび配送経路の商品の合計出品数を示すリスト。 必須。 タイプ：タイプのリスト： OfferCount |
| LowestPrices | 指定したコンディションおよび配送経路の商品の最低価格を示すリスト。 必須。 タイプ：タイプのリスト： LowestPrice |
| BuyBoxPrices | 指定したコンディションの商品のショッピングカートボックス価格を示すリスト。 任意。 タイプ：タイプのリスト： BuyBoxPrice |
| ListPrice | メーカー希望価格。 任意。 タイプ： MoneyType |
| SuggestedLowerPricePlusShipping | 価格見直し推奨商品の価格(商品価格 + 配送料 - 獲得するAmazonポイント数)。価格見直し例は、販売価格の履歴、ショッピングカートボックス価格、対象商品への購入者の意見など、広範な要因を基に表示しています。 任意。 タイプ： MoneyType |
| SalesRankings | 指定した商品カテゴリーの商品の売上ランキングを示すリスト。 任意。 タイプ：タイプのリスト： SalesRank |
| BuyBoxEligibleOffers | ショッピングカートボックス獲得の対象となっている、指定したコンディションおよび配送経路の商品の合計出品数を示すリスト。 必須。 タイプ：タイプのリスト： OfferCount |
| CompetitivePriceThreshold | 他社サイトで販売されている同じ商品の最低価格。Amazonで他の出品者が販売している同じ商品の価格は考慮していません。出品者の価格(配送料込)が当該最低価格よりも高い場合、Amazonでのショッピングカートボックス獲得資格の対象とならない場合があります。 任意。 Type: MoneyType |