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

FeePromotionNotification

Amazon MWSを使用している出品者は、期間限定の手数料のプロモーション(割引)を利用できます。利用可能な販売手数料のプロモーションの通知を受信するには、FeePromotion通知をサブスクライブする必要があります。最初に出品者がサブスクリプションにサインアップしたときに、isEnabledtrueに設定されていると、出品者は現在有効なプロモーションをすべて利用できます。各プロモーションは、1つのメッセージとして送信されます。以降のプロモーション通知は、プロモーションが有効になると送信されます。

FeePromotion通知は、対象プロモーションの詳細を記述するデータフィールドのセットで構成されます。データフィールドには、各プロモーションのすべての適用基準が記述されます。

注: このAPIから返された手数料見積もりは保証されません。実際の手数料は異なる場合があります。 手数料の詳細については、セラーセントラルの手数料見積り額およびFBA - 機能と手数料を参照してください。

FeePromotionNotification

指定した出品者/マーケットプレイスに有効な手数料プロモーションの詳細がすべて含まれます。

以下の表は、FeePromotionNotification.xsdスキーマのルート要素を示しています。

名前 説明
FeePromotionNotification FeePromotion通知のペイロードのルート要素。

FeePromotionNotification属性

FeePromotionNotification要素は、以下のデータオブジェクトで構成されます。

名前 説明 必須
FeePromotionType プロモーションのタイプ。 はい 値:PricingSelectionASIN、またはSelectionCategory。その他のタイプは、今後追加される予定です。

タイプ:xs:string

FeePromotionTypeDescription プロモーションの目的に関する詳細を提供します。 いいえ ローカライズされたわかりやすい文字列の説明。インテグレーターがUIに表示するのに役立ちます。

タイプ:xs:string

MarketplaceId プロモーションは、このmarketplaceIdに適用されます。 はい タイプ:xs:string
MerchantId プロモーションは、このmerchantIdに適用されます。 はい タイプ:xs:string
IdentifierList このプロモーションの適用対象の商品のリスト。 はい タイプ:Identifierタイプのリスト
PromotionActiveTimeRange このプロモーションが有効になる期間。 はい タイプ: PromotionActiveTimeRange
PromotionInformation プロモーションに関するその他の詳細を含むオブジェクト。該当する場合は、手数料の見積もりが含まれています。 はい タイプ: PromotionInformation

Identifier

このプロモーションの適用対象の商品の説明。

Identifier属性

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

名前 説明 必須
IdentifierType このプロモーションが適用される商品の識別子のタイプ。 はい 例:ASIN、SKU、ブラウズノード、ブランド。

タイプ:xs:string

IdentifierValueList このプロモーションが適用される商品の識別子の値。 はい 例:出品者の実際のASINまたはSKU、ブランドの実際のリスト(Nikeなど)、ブラウズノードの実際のリスト。

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

IdentifierValue

このプロモーションの適用対象のIDの値の説明。

IdentifierValue属性

名前 説明 必須
IdentifierValueId 実際のブラウズノードID、実際のASIN/SKU、またはブランド値。 はい タイプ:xs:string
IdentifierValueFriendlyName IDの値に付けるわかりやすい名前。 いいえ ブラウズノードなどに関連したもののみ。たとえば、ブラウズノード名など。

タイプ:xs:string

PromotionActiveTimeRange

このプロモーションが有効になる期間。

PromotionActiveTimeRange属性

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

名前 説明 必須
EffectiveFromDate プロモーションが有効になる日の日付(この日も適用される)。 はい タイプ:xs:dateTime
EffectiveThroughDate プロモーションが終わる日の日付(この日は適用されない)。 はい タイプ:xs:dateTime

PromotionInformation

プロモーションに関するその他の詳細を含むオブジェクト。該当する場合は、手数料の見積もりが含まれています。

PromotionInformation属性

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

名前 説明 必須
FeeType このプロモーションで割引の対象となる手数料のタイプ。 はい 対象の手数料タイプ:ReferralFeeVariableClosingFeePerItemFeeFBAFeesFBAPickAndPackFBAWeightHandlingFBAOrderHandlingFBADeliveryServicesFee

タイプ:xs:string

FeeDiscountType 手数料に適用されるプロモーションのタイプ。 はい 次のいずれか:FixedDiscountPercentage points off

タイプ:xs:string

PriceThreshold プロモーションの適用を受けるのに満たしていなければならない出品価格の基準しきい値(上限値)。 いいえ

タイプ:MoneyType

FeeDiscountMonetaryAmount FeeDiscountTypeが金額の場合、受け取ることができる手数料割引額。 いいえ FeeDiscountTypeが金額の場合、この値が入力されます。

タイプ:MoneyType

FeeDiscountValue FeeDiscountTypeが金額以外の場合、手数料の割引率。 いいえ FeeDiscountTypeが金額以外の場合、この値が入力されます。

タイプ:xs:BigDecimal

FeesEstimate このプロモーションの手数料の見積もり(該当する場合)。見積もりではプロモーションの対象となるすべてのコンディション基準を満たしていると想定しています。 いいえ タイプ:FeesEstimate

FeesEstimate

このプロモーションの手数料の見積もりの詳細(該当する場合)。

FeesEstimate属性

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

名前 説明 必須
TimeOfFeesEstimated 手数料の見積もりが算定された日付と時刻。 はい タイプ:xs:dateTime
TotalFeesEstimate 価格がしきい値以下の場合、手数料の金額合計。 はい タイプ:MoneyType
FeeDetailList (TotalFeesEstimateの明細)。 はい タイプ:FeeDetailのリスト

FeeDetail

FeeDetailデータタイプは、手数料見積もり明細のコンテナです。必要に応じて別のFeeDetail要素を含めることができます。

FeeDetail属性

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

名前 説明 必須
FeeType 請求された手数料のタイプ。 はい 対象の手数料タイプ:ReferralFeeVariableClosingFeePerItemFeeFBAFeesFBAPickAndPackFBAWeightHandlingFBAOrderHandlingFBADeliveryServicesFee

タイプ:xs:string

FeeAmount 手数料タイプに対応する手数料金額。 はい タイプ:MoneyType
FeePromotion 手数料タイプに対応する手数料プロモーションの金額。 いいえ タイプ:MoneyType
TaxAmount 出品者に請求される手数料に対して算定された税額。 いいえ タイプ:MoneyType
FinalFee 出品者へ請求されることになる最終的な手数料。 はい FeeAmountからFeePromotionを差し引いた結果。

タイプ:MoneyType

IncludedFeeDetailList 特定の手数料タイプの明細が含まれたFeeDetailの構造化リスト。 いいえ タイプ:FeeDetailのリスト

Amazon MWSは、リクエストまたはサブスクリプションの成功に対するレスポンスを含むXMLファイルを返します。リクエストが失敗すると、主なレスポンス要素はErrorResponseとなります。詳しくは、Amazon MWS開発者ガイドレスポンスのフォーマットを参照してください。

通知例1

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>

↑ トップへ戻る

通知例2

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>

↑ トップへ戻る

通知例3

カテゴリーレベルの出品プロモーション(意味:このカテゴリーの商品を出品すると手数料の割引を受けられる):

サンプルを表示するサンプルを隠す

<?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>

↑ トップへ戻る