Amazon Services Japan

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

Amazon MWS ドキュメント » APIリファレンス » 商品 - バージョン2011-10-01 » GetMyFeesEstimate

GetMyFeesEstimate

商品リストの見積もり手数料を返します。

説明

GetMyFeesEstimateオペレーションは、商品とマーケットプレイスのリストを与えることで、そのマーケットプレイスでの商品の手数料を返します。商品価格を設定する前に、その商品に対してGetMyFeesEstimateを呼び出すことができます。その手数料見積り額を考慮した上で価格を設定できます。商品は、ASINまたはSKUで指定する必要があります(UPCやISBNなどは使用できません)。

商品手数料のリクエストでは、オリジナルのIDを毎回入力する必要があります。このIDは手数料見積り額とともに返されるので、手数料見積り額とオリジナルのリクエストを照合できます。

このオペレーションでは、一度に最大20個の商品をリクエストできます。結果の処理について詳しくは、一括オペレーションリクエストを実行するを参照してください。

注: このAPIで返された手数料見積り額は確定された金額ではありません。実際の手数料は異なる場合があります。

手数料の詳細については、セラーセントラルの手数料見積り額とFBA - 機能と手数料を参照してください。

利用可否

このオペレーションはすべてのマーケットプレイスで利用できます。

スロットリング

最大リクエストクォータ	回復レート	時間あたりのリクエストクォータ
20リクエスト	1秒ごとに10商品	1時間あたり36000リクエスト

スロットリング用語の定義およびスロットルの詳しい説明については、Amazon MWS開発者ガイドのスロットリング: リクエストを送信できる頻度を制限するを参照してください。

リクエストパラメーター

すべてのAmazon MWSオペレーションに必須とされるリクエストパラメーターについて詳しくは、Amazon MWS開発者ガイドの必須リクエストパラメータを参照してください。

名前	説明	必須	値
FeesEstimateRequestList	手数料のクエリで問い合わせる商品、マーケットプレイス、その他のオプションのリスト。	はい	最大：20リクエスト。タイプ：タイプのリスト： FeesEstimateRequest

レスポンス要素

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

GetMyFeesEstimateオペレーションが返すレスポンス要素は、公開されているXSD ProductsAPI_Response.xsdで内容を確認できます。GetMyFeesEstimateオペレーションが返す最上位要素は以下の通りです。

GetMyFeesEstimate要素

名前	説明	必須	値
FeesEstimateResultList	商品のリストと各商品の手数料見積り額	はい	タイプ：タイプのリスト： FeesEstimateResult

例

クエリリクエスト例

標準のリクエスト要件について詳しくは、必須のリクエストパラメーターを参照してください。

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

POST /Products/2011-10-01 HTTP/1.1
Content-Type: x-www-form-urlencoded
Host: mws.amazonservices.com
User-Agent: <Your User Agent Header> 

FeesEstimateRequestList.FeesEstimateRequest.1.MarketplaceId= ATVPDKIKX0DER
&FeesEstimateRequestList.FeesEstimateRequest.1.IdType=ASIN
&FeesEstimateRequestList.FeesEstimateRequest.1.IdValue= B002KT3XQM
&FeesEstimateRequestList.FeesEstimateRequest.1.IsAmazonFulfilled=true
&FeesEstimateRequestList.FeesEstimateRequest.1.Identifier= request1
&FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.ListingPrice.CurrencyCode=USD
&FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.ListingPrice.Amount=30.00
&FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.Shipping.CurrencyCode=USD
&FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.Shipping.Amount=3.99
&FeesEstimateRequestList.FeesEstimateRequest.1.PriceToEstimateFees.Points.PointsNumber=0
&AWSAccessKeyId=AKIAEXAMPLEFWR4TJ7ZQ
&Action=GetMyFeesEstimate
&MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE
&SellerId=A1IMEXAMPLEWRC
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Timestamp=2012-12-04T22%3A03%3A05Z
&Version=2011-10-01
&Signature=fJFzEXAMPLEEax1vAdKP7l3lwKQUH1r34lcEXAMPLEA%3D

レスポンス例(成功)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

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

<?xml version="1.0"?>
<GetMyFeesEstimateResponse
  xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>Success</Status>
        <FeesEstimateIdentifier>
          <MarketplaceId>ATVPDKIKX0DER</MarketplaceId>
          <IdValue>B0002GTTRC</IdValue>
          <IdType>ASIN</IdType>
          <IsAmazonFulfilled>True</IsAmazonFulfilled>
          <PriceToEstimateFees>
            <ListingPrice>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>58.00</Amount>
            </ListingPrice>
            <Shipping>
              <CurrencyCode>USD</CurrencyCode>
              <Amount>0.00</Amount>
            </Shipping>
            <Points>
              <PointsNumber>0</PointsNumber>
            </Points>
          </PriceToEstimateFees>
          <SellerInputIdentifier>IDDDDDDDD</SellerInputIdentifier>
        </FeesEstimateIdentifier>
        <FeesEstimate>
          <TimeOfFeesEstimation>2015-07-19T23:15:11.859Z</TimeOfFeesEstimation>
          <TotalFeesEstimate>
            <CurrencyCode>USD</CurrencyCode>
            <Amount>10.00</Amount>
          </TotalFeesEstimate>
          <FeeDetailList>
            <FeeDetail>
              <FeeType>AmazonReferralFee</FeeType>
              <FeeAmount>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>8.70</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>1.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>7.70</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>VariableClosingFee</FeeType>
              <FeeAmount>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>0.00</Amount>
              </FeeAmount>
              <FinalFee>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>0.0</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>FulfillmentFees</FeeType>
              <FeeAmount>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>2.30</Amount>
              </FeeAmount>
              <FinalFee>
                <CurrencyCode>USD</CurrencyCode>
                <Amount>2.30</Amount>
              </FinalFee>
              <IncludedFeeList>
                <FeeDetail>
                  <FeeType>OrderHandlingFee</FeeType>
                  <FeeAmount>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>1.00</Amount>
                  </FeeAmount>
                  <FinalFee>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>1.00</Amount>
                  </FinalFee>
                </FeeDetail>
                <FeeDetail>
                  <FeeType>PickAndPackFee</FeeType>
                  <FeeAmount>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>0.30</Amount>
                  </FeeAmount>
                  <FinalFee>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>0.30</Amount>
                  </FinalFee>
                </FeeDetail>
                <FeeDetail>
                  <FeeType>WeightHandlingFee</FeeType>
                  <FeeAmount>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>1.00</Amount>
                  </FeeAmount>
                  <FinalFee>
                    <CurrencyCode>USD</CurrencyCode>
                    <Amount>1.00</Amount>
                  </FinalFee>
                </FeeDetail>
              </IncludedFeeList>
            </FeeDetail>
          </FeeDetailList>
        </FeesEstimate>
      </FeesEstimateResult>
    </FeesEstimateResultList>
  </GetMyFeesEstimateResult>
  <ResponseMetadata>
    <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
  </ResponseMetadata>
</GetMyFeesEstimateResponse>

レスポンス例(エラー、無効なパラメーター値)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

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

<?xml version="1.0"?>
<GetMyFeesEstimateResponse
  xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>ClientError</Status>
        <FeesEstimateIdentifier>
          <!--  Rest of the input parameters -->
        </FeesEstimateIdentifier>
        <Error>
          <Type>Sender</Type>
          <Code>InvalidParameterValue</Code>
          <Message> Attribute X is not valid for marketplace ATVPDKIKX0DER </Message>
        </Error>
      </FeesEstimateResult>
    </FeesEstimateResultList>
  </GetMyFeesEstimateResult>
  <ResponseMetadata>
    <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
  </ResponseMetadata>
</GetMyFeesEstimateResponse>

レスポンス例(エラー、内部エラー)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

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

<?xml version="1.0"?>
<GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>ServerError</Status>
        <FeesEstimateIdentifier>
          <!--  Rest of the input parameters -->
        </FeesEstimateIdentifier>
        <Error>
          <Type> Receiver </Type>
          <Code>InternalError</Code>
          <Message> There was an internal service failure. </Message>
        </Error>
      </FeesEstimateResult>
    </FeesEstimateResultList>
  </GetMyFeesEstimateResult>
  <ResponseMetadata>
    <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
  </ResponseMetadata>
</GetMyFeesEstimateResponse>

レスポンス例(エラー、利用できるデータなし)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

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

<?xml version="1.0"?>
<GetMyFeesEstimateResponse
  xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>ServerError</Status>
        <FeesEstimateIdentifier>
          <!--  Rest of the input parameters -->
        </FeesEstimateIdentifier>
        <Error>
          <Type> Receiver </Type>
          <Code>DataNotAvailable</Code>
          <Message> Non-buyable item. Missing category. </Message>
        </Error>
      </FeesEstimateResult>
    </FeesEstimateResultList>
  </GetMyFeesEstimateResult>
  <ResponseMetadata>
    <RequestId>21534f03-e7e3-4d9a-9bea-0e15add3326d</RequestId>
  </ResponseMetadata>
</GetMyFeesEstimateResponse>

レスポンス例(エラー、一括実行数が20を超過)

標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。

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

<?xml version="1.0"?>
<ErrorResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <Error>
    <Type>Sender</Type>
    <Code>InvalidParameterValue</Code>
    <Message> There are more than 20 elements in FeesEstimateRequestList. </Message>
    <Detail/>
  </Error>
  <RequestID>9f17b9ff-2ef5-42fe-b956-6d9b38ac8422</RequestID>
</ErrorResponse>

関連トピック

Amazon MWS商品APIセクションについて知っておくべきこと

一括オペレーションリクエストを実行する

Copyright © 2009-2019, Amazon.com, Inc. およびその関係者。 Amazon とAmazon.com は、Amazon.com, Inc. またはその関係者の登録商標です。その他のすべての登録商標は、それぞれの所有者に帰属します。