Amazon Services Japan
Amazonマーケットプレイス Web サービス (Amazon MWS) ドキュメント

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 ドキュメント

AnyOfferChangedNotification

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

出品情報が変更された場合に送信される通知のペイロードのルート要素。

AnyOfferChangedNotification要素

以下の表は、AnyOfferChangedNotification要素の子要素を示しています。

名前 説明
OfferChangeTrigger 通知の送信を引き起こしたイベント。

必須。

タイプ: OfferChangeTrigger

Summary 出品情報に変更のあった商品に関する情報。このサマリーの情報は、すべてのコンディションの商品に適用されます。

必須。

タイプ: Summary

Offers 通知をトリガーした商品およびコンディションの上位20の競合出品。

必須。

タイプ:タイプのリスト: Offer

BuyBoxPrice

ショッピングカートボックスに表示される商品の価格。

BuyBoxPrice属性

以下の表は、BuyBoxPrice要素の属性を示しています。

名前 説明
condition 商品のコンディションを表示します。例:NewUsedCollectibleRefurbishedClub

必須。

タイプ:xs:string

BuyBoxPrice要素

以下の表は、BuyBoxPrice要素の子要素を示しています。

名前 説明
LandedPrice 価格 + 配送料 - 獲得するAmazonポイント数。

必須。

タイプ: MoneyType

ListingPrice 商品の価格。

必須。

タイプ: MoneyType

Shipping 配送料。

必須。

タイプ: MoneyType

Points 商品の購入で獲得するAmazonポイント数。

任意。

注: Points要素が返されるのは日本(JP)の場合のみです。

タイプ: Points

LowestPrice

商品の最低価格。

LowestPrice属性

以下の表は、LowestPrice要素の属性を示しています。

名前 説明
condition 商品のコンディションを表示します。例:NewUsedCollectibleRefurbishedClub

必須。

タイプ:xs:string

fulfillmentChannel Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。

必須。

タイプ: FulfillmentChannelType

LowestPrice要素

以下の表は、LowestPrice要素の子要素を示しています。

名前 説明
LandedPrice 価格 + 配送料 - 獲得するAmazonポイント数。

必須。

タイプ: MoneyType

ListingPrice 商品の価格。

必須。

タイプ: MoneyType

Shipping 配送料。

必須。

タイプ: MoneyType

Points 商品の購入で獲得するAmazonポイント数。

任意。

注: Points要素が返されるのは日本(JP)の場合のみです。

タイプ: Points

Offer

商品やコンディションに変更があった上位20の出品商品の1つ。

Offer要素

以下の表は、Offer要素の子要素を示しています。

名前 説明
SellerId 出品商品の出品者ID。

必須。

タイプ:xs:string

SubCondition 商品のサブコンディション。例:NewMintVery GoodGoodAcceptablePoorClubOEMWarrantyRefurbished WarrantyRefurbishedOpen 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

通知の送信を引き起こしたイベント。

OfferChangeTrigger要素

以下の表は、OfferChangeTrigger要素の子要素を示しています。

名前 説明
MarketplaceId 出品情報に変更のあった商品のマーケットプレイスID。

必須。

タイプ: MarketplaceType

ASIN 出品情報に変更のあった商品のASIN。

必須。

タイプ:xs:string

ItemCondition 出品情報に変更のあった商品のコンディション。たとえば、中古品の出品情報に変更があった場合、Offers要素の商品リストには中古品のみが表示されます。Summary要素は価格の改定時に参考となるその他の条件の概要を示します。

必須。

タイプ:xs:string

TimeOfOfferChange この通知のきっかけとなった出品情報の更新時間。

必須。

タイプ:xs:dateTime

OfferCount

指定したコンディションおよび配送経路の商品の合計出品数。

OfferCount属性

以下の表は、OfferCount要素の属性を示しています。

名前 説明
condition 商品のコンディションを表示します。例:NewUsedCollectibleRefurbishedClub

必須。

タイプ:xs:string

fulfillmentChannel Amazonから出荷する商品であるか、出品者から出荷する商品であるかを示す。

必須。

タイプ: FulfillmentChannelType

OfferCount要素

OfferCount要素には子要素がありません。OfferCount要素はタイプ:xs:intの拡張型です。

Points

商品の購入で獲得するAmazonポイント数。

Points要素

以下の表は、Points要素の子要素を示しています。

名前 説明
PointsNumber 商品の購入で獲得するAmazonポイント数。

必須。

タイプ:xs:int

PrimeInformation

Amazonプライムに関する情報。

PrimeInformation要素

以下の表は、PrimeInformation要素の子要素を示しています。

名前 説明
IsNationalPrime 出品されているマーケットプレイス全体でAmazonプライムの対象であるかどうかを示す。

必須。

タイプ:xs:boolean

IsPrime Amazonプライム対象の出品かどうかを示す。

必須。

タイプ:xs:boolean

SalesRank

特定の商品カテゴリーの商品の売上ランキング。

SalesRank要素

以下の表は、SalesRank要素の子要素を示しています。

名前 説明
ProductCategoryId 商品の商品カテゴリーID。

必須。

タイプ:xs:string

Rank 特定の商品カテゴリーの商品の売上ランキング。

必須。

タイプ:xs:int

SellerFeedbackRating

出品者のフィードバックに関する情報(良い評価を受けた割合など)および寄せられたフィードバックの総数。

SellerFeedbackRating要素

以下の表は、SellerFeedbackRating要素の子要素を示しています。

名前 説明
SellerPositiveFeedbackRating 過去365日間に出品者が良い評価を受けた割合。

任意。

タイプ:xs:double

FeedbackCount 出品者に関して寄せられたフィードバックの数。

必須。

タイプ:xs:long

ShippingTime

注文があってから商品が出荷できるようになるまでの最短時間と最長時間(時間単位)。

ShippingTime属性

以下の表は、ShippingTime要素の属性を示しています。

名前 説明
minimumHours 注文があってから商品が出荷できるようになるまでの最短時間(時間単位)。

任意。

タイプ:xs:short

maximumHours 注文があってから商品が出荷できるようになるまでの最長時間(時間単位)。

任意。

タイプ:xs:short

availableDate 商品の出荷予定日。現在出荷できない商品にのみ表示。

任意。

タイプ:xs:dateTime

availabilityType 現在出荷可能な商品であるか、出荷予定日がわかっている/不明の商品であるかを示します。 出荷予定日がわかっている場合、availableDate属性は商品の出荷予定日を示します。

任意。

タイプ: AvailabilityType

ShipsFrom

商品の発送元の都道府県および国。

ShipsFrom要素

以下の表は、ShipsFrom要素の子要素を示しています。

名前 説明
State 商品の発送元の都道府県。

任意。

タイプ:xs:string

Country 商品の発送元の国。

任意。

タイプ:xs:string

Summary

出品情報に変更のあった商品に関する情報。このサマリーの情報は、すべてのコンディションの商品に適用されます。

Summary要素

以下の表は、Summary要素の子要素を示しています。

名前 説明
NumberOfOffers 指定したコンディションおよび配送経路の商品の合計出品数を示すリスト。

必須。

タイプ:タイプのリスト: OfferCount

LowestPrices 指定したコンディションおよび配送経路の商品の最低価格を示すリスト。

必須。

タイプ:タイプのリスト: LowestPrice

BuyBoxPrices 指定したコンディションの商品のショッピングカートボックス価格を示すリスト。

任意。

タイプ:タイプのリスト: BuyBoxPrice

ListPrice メーカー希望価格。

任意。

タイプ: MoneyType

SuggestedLowerPricePlusShipping 価格見直し推奨商品の価格(商品価格 + 配送料 - 獲得するAmazonポイント数)。価格見直し例は、販売価格の履歴、ショッピングカートボックス価格、対象商品への購入者の意見など、広範な要因を基に表示しています。

任意。

タイプ: MoneyType

SalesRankings 指定した商品カテゴリーの商品の売上ランキングを示すリスト。

任意。

タイプ:タイプのリスト: SalesRank

BuyBoxEligibleOffers ショッピングカートボックス獲得の対象となっている、指定したコンディションおよび配送経路の商品の合計出品数を示すリスト。

必須。

タイプ:タイプのリスト: OfferCount

CompetitivePriceThreshold 他社サイトで販売されている同じ商品の最低価格。Amazonで他の出品者が販売している同じ商品の価格は考慮していません。出品者の価格(配送料込)が当該最低価格よりも高い場合、Amazonでのショッピングカートボックス獲得資格の対象とならない場合があります。

任意。

Type: MoneyType