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を使用している出品者は、期間限定の手数料のプロモーション（割引）を利用できます。利用可能な販売手数料のプロモーションの通知を受信するには、FeePromotion通知をサブスクライブする必要があります。最初に出品者がサブスクリプションにサインアップしたときに、isEnabledがtrueに設定されていると、出品者は現在有効なプロモーションをすべて利用できます。各プロモーションは、1つのメッセージとして送信されます。以降のプロモーション通知は、プロモーションが有効になると送信されます。
FeePromotion通知は、対象プロモーションの詳細を記述するデータフィールドのセットで構成されます。データフィールドには、各プロモーションのすべての適用基準が記述されます。
指定した出品者/マーケットプレイスに有効な手数料プロモーションの詳細がすべて含まれます。
以下の表は、FeePromotionNotification.xsdスキーマのルート要素を示しています。
| 名前 | 説明 |
|---|---|
| FeePromotionNotification | FeePromotion通知のペイロードのルート要素。 |
各FeePromotionNotification要素は、以下のデータオブジェクトで構成されます。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| FeePromotionType | プロモーションのタイプ。 | はい | 値：Pricing、SelectionASIN、またはSelectionCategory。その他のタイプは、今後追加される予定です。 タイプ：xs:string |
| FeePromotionTypeDescription | プロモーションの目的に関する詳細を提供します。 | いいえ | ローカライズされたわかりやすい文字列の説明。インテグレーターがUIに表示するのに役立ちます。 タイプ：xs:string |
| MarketplaceId | プロモーションは、このmarketplaceIdに適用されます。 | はい | タイプ：xs:string |
| MerchantId | プロモーションは、このmerchantIdに適用されます。 | はい | タイプ：xs:string |
| IdentifierList | このプロモーションの適用対象の商品のリスト。 | はい | タイプ：Identifierタイプのリスト |
| PromotionActiveTimeRange | このプロモーションが有効になる期間。 | はい | タイプ： PromotionActiveTimeRange |
| PromotionInformation | プロモーションに関するその他の詳細を含むオブジェクト。該当する場合は、手数料の見積もりが含まれています。 | はい | タイプ： PromotionInformation |
このプロモーションの適用対象の商品の説明。
以下の表は、IdentifierList要素の商品の属性を示しています。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| IdentifierType | このプロモーションが適用される商品の識別子のタイプ。 | はい | 例：ASIN、SKU、ブラウズノード、ブランド。 タイプ：xs:string |
| IdentifierValueList | このプロモーションが適用される商品の識別子の値。 | はい | 例：出品者の実際のASINまたはSKU、ブランドの実際のリスト(Nikeなど)、ブラウズノードの実際のリスト。 タイプ：IdentifierValueタイプのリスト |
このプロモーションの適用対象のIDの値の説明。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| IdentifierValueId | 実際のブラウズノードID、実際のASIN/SKU、またはブランド値。 | はい | タイプ：xs:string |
| IdentifierValueFriendlyName | IDの値に付けるわかりやすい名前。 | いいえ | ブラウズノードなどに関連したもののみ。たとえば、ブラウズノード名など。 タイプ：xs:string |
このプロモーションが有効になる期間。
以下の表は、PromotionActiveTimeRange要素の子要素を示しています。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| EffectiveFromDate | プロモーションが有効になる日の日付(この日も適用される)。 | はい | タイプ：xs:dateTime |
| EffectiveThroughDate | プロモーションが終わる日の日付(この日は適用されない)。 | はい | タイプ：xs:dateTime |
プロモーションに関するその他の詳細を含むオブジェクト。該当する場合は、手数料の見積もりが含まれています。
以下の表は、PromotionInformation要素の子要素を示しています。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| FeeType | このプロモーションで割引の対象となる手数料のタイプ。 | はい | 対象の手数料タイプ：ReferralFee、 VariableClosingFee、 PerItemFee、 FBAFees、 FBAPickAndPack、 FBAWeightHandling、 FBAOrderHandling、 FBADeliveryServicesFee。 タイプ：xs:string |
| FeeDiscountType | 手数料に適用されるプロモーションのタイプ。 | はい | 次のいずれか：Fixed、Discount、Percentage
points off。 タイプ：xs:string |
| PriceThreshold | プロモーションの適用を受けるのに満たしていなければならない出品価格の基準しきい値(上限値)。 | いいえ | タイプ：MoneyType |
| FeeDiscountMonetaryAmount | FeeDiscountTypeが金額の場合、受け取ることができる手数料割引額。 | いいえ | FeeDiscountTypeが金額の場合、この値が入力されます。 タイプ：MoneyType |
| FeeDiscountValue | FeeDiscountTypeが金額以外の場合、手数料の割引率。 | いいえ | FeeDiscountTypeが金額以外の場合、この値が入力されます。 タイプ：xs:BigDecimal |
| FeesEstimate | このプロモーションの手数料の見積もり(該当する場合)。見積もりではプロモーションの対象となるすべてのコンディション基準を満たしていると想定しています。 | いいえ | タイプ：FeesEstimate |
FeeDetailデータタイプは、手数料見積もり明細のコンテナです。必要に応じて別のFeeDetail要素を含めることができます。
以下の表は、FeeDetail要素の属性を示しています。
| 名前 | 説明 | 必須 | 値 |
|---|---|---|---|
| FeeType | 請求された手数料のタイプ。 | はい | 対象の手数料タイプ：ReferralFee、 VariableClosingFee、 PerItemFee、 FBAFees、 FBAPickAndPack、 FBAWeightHandling、 FBAOrderHandling、 FBADeliveryServicesFee。 タイプ：xs:string |
| FeeAmount | 手数料タイプに対応する手数料金額。 | はい | タイプ：MoneyType |
| FeePromotion | 手数料タイプに対応する手数料プロモーションの金額。 | いいえ | タイプ：MoneyType |
| TaxAmount | 出品者に請求される手数料に対して算定された税額。 | いいえ | タイプ：MoneyType |
| FinalFee | 出品者へ請求されることになる最終的な手数料。 | はい | FeeAmountからFeePromotionを差し引いた結果。 タイプ：MoneyType |
| IncludedFeeDetailList | 特定の手数料タイプの明細が含まれたFeeDetailの構造化リスト。 | いいえ | タイプ：FeeDetailのリスト |
Amazon MWSは、リクエストまたはサブスクリプションの成功に対するレスポンスを含むXMLファイルを返します。リクエストが失敗すると、主なレスポンス要素はErrorResponseとなります。詳しくは、Amazon MWS開発者ガイドのレスポンスのフォーマットを参照してください。
ASINレベルの価格設定プロモーション(意味：出品価格を下げると手数料の割引を受けられる)：
<?xml version="1.0"?>
<FeePromotionNotification xmlns="http://mws.amazonservices.com/schema/Subscription/2011-10-01>
<MerchantId>ATEXAMPLERGR</MerchantId>
<MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
<FeePromotionType>Pricing</FeePromotionType>
<FeePromotionTypeDescription>A promotion encouraging you to lower your price on an item to receive lower fees.</FeePromotionTypeDescription>
<PromotionActiveTimeRange>
<EffectiveFromDate>2015-07-19T23:15:11.859Z </EffectiveFromDate>
<EffectiveThroughDate>2015-08-19T23:15:11.859Z </EffectiveThroughDate>
</PromotionActiveTimeRange >
<IdentifierList>
<Identifier>
<IdentifierValueList>
<IdentifierValue>
<IdentifierValueId>B0002GTTRC</IdentifierValueId>
</IdentifierValue>
</IdentifierValueList>
<IdentifierType>ASIN</IdentifierType>
</Identifier>
</IdentifierList>
<PromotionInformationList>
<PromotionInformation>
<FeeType>ReferralFee</FeeType>
<FeeDiscountType>Percentage points off</FeeDiscountType>
<FeeDiscountValue>6.0</FeeDiscountValue>
<PriceThreshold>
<CurrencyCode>USD</CurrencyCode>
<Amount>100.00</Amount>
</PriceThreshold>
<FeesEstimate>
<TimeOfFeesEstimated>2015-07-12T23:15:11.859Z </TimeOfFeesEstimated>
<TotalFeesEstimate>
<CurrencyCode>USD</CurrencyCode>
<Amount>6.30</Amount>
</TotalFeesEstimate>
<FeeDetailList>
<FeeDetail>
<FeeType>ReferralFee</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>10.00</Amount>
</FeeAmount>
<FeePromotion>
<CurrencyCode>USD</CurrencyCode>
<Amount>6.00</Amount>
</FeePromotion>
<FinalFee>
<CurrencyCode>USD</CurrencyCode>
<Amount>4.00</Amount>
</FinalFee>
</FeeDetail>
<FeeDetail>
<FeeType>VariableClosingFee</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>0.00</Amount>
</FeeAmount>
</FeeDetail>
<FeeDetail>
<FeeType>PerItemFee</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>0.00</Amount>
</FeeAmount>
</FeeDetail>
<FeeDetail>
<FeeType>FBAFees</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>2.30</Amount>
</FeeAmount>
<IncludedFeeList>
<FeeDetail>
<FeeType>FBAOrderHandling</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>1.00</Amount>
</FeeAmount>
</FeeDetail>
<FeeDetail>
<FeeType>FBAPickAndPack</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>0.30</Amount>
</FeeAmount>
</FeeDetail>
<FeeDetail>
<FeeType>FBAWeightHandling</FeeType>
<FeeAmount>
<CurrencyCode>USD</CurrencyCode>
<Amount>1.00</Amount>
</FeeAmount>
</FeeDetail>
</IncludedFeeList>
</FeeDetail>
</FeeDetailList>
</FeesEstimate>
</PromotionInformation>
</PromotionInformationList>
</FeePromotionNotification>
<ResponseMetadata>
<RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
</ResponseMetadata>
ASINレベルの出品プロモーション(意味：このASINを出品すると手数料の割引を受けられる)：
<?xml version="1.0"?>
<FeePromotionNotification xmlns="http://mws.amazonservices.com/schema/Subscription/2011-10-01">
<MerchantId>ATEXAMPLERGR</MerchantId>
<MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
<FeePromotionType>SelectionASIN</FeePromotionType>
<FeePromotionTypeDescription>A promotion encouraging you to list a particular ASIN or set of ASINs.</FeePromotionTypeDescription>
<PromotionActiveTimeRange>
<EffectiveFromDate>2015-07-19T23:15:11.859Z </EffectiveFromDate>
<EffectiveThroughDate>2015-08-19T23:15:11.859Z </EffectiveThroughDate>
</PromotionActiveTimeRange >
<IdentifierList>
<Identifier>
<IdentifierValueList>
<IdentifierValue>
<IdentifierValueId>B0002GTTRC</IdentifierValueId>
</IdentifierValue>
</IdentifierValueList>
<IdentifierType>ASIN</IdentifierType>
</Identifier>
</IdentifierList>
<PromotionInformationList>
<PromotionInformation>
<FeeType>ReferralFee</FeeType>
<FeeDiscountType>PercentagePoints</FeeDiscountType>
<FeeDiscountValue>6.0</FeeDiscountValue>
</PromotionInformation>
</PromotionInformationList>
</FeePromotionNotification>
<ResponseMetadata>
<RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
</ResponseMetadata>
カテゴリーレベルの出品プロモーション(意味：このカテゴリーの商品を出品すると手数料の割引を受けられる)：
<?xml version="1.0"?>
<FeePromotionNotification xmlns="http://mws.amazonservices.com/schema/Subscription/2011-10-01">
<MerchantId>ATEXAMPLERGR</MerchantId>
<MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
<FeePromotionType>SelectionCategory</FeePromotionType>
<FeePromotionTypeDescription>A promotion encouraging you to begin selling new items in a brand, category or area to increase sales..</FeePromotionTypeDescription>
<PromotionActiveTimeRange>
<EffectiveFromDate>2015-07-19T23:15:11.859Z </EffectiveFromDate>
<EffectiveThroughDate>2015-08-19T23:15:11.859Z </EffectiveThroughDate>
</PromotionActiveTimeRange >
<IdentifierList>
<Identifier>
<IdentifierValueList>
<IdentifierValue>
<IdentifierValueId>123456789</IdentifierValueId>
<IdentifierValueFriendlyName>Espresso Machines</IdentifierValueFriendlyName>
</IdentifierValue>
<IdentifierValue>
<IdentifierValueId>987654321</IdentifierValueId>
<IdentifierValueFriendlyName>Espresso Accessories</IdentifierValueFriendlyName>
</IdentifierValue>
</IdentifierValueList>
<IdentifierType>BrowseNode</IdentifierType>
</Identifier>
</IdentifierList>
<PromotionInformationList>
<PromotionInformation>
<FeeType>ReferralFee</FeeType>
<FeeDiscountType>PercentagePoints</FeeDiscountType>
<FeeDiscountValue>6.0</FeeDiscountValue>
</PromotionInformation>
</PromotionInformationList>
</FeePromotionNotification>
<ResponseMetadata>
<RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
</ResponseMetadata>