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.
商品リストの見積もり手数料を返します。
GetMyFeesEstimateオペレーションは、商品とマーケットプレイスのリストを与えることで、そのマーケットプレイスでの商品の手数料を返します。商品価格を設定する前に、その商品に対してGetMyFeesEstimateを呼び出すことができます。その手数料見積り額を考慮した上で価格を設定できます。商品は、ASINまたはSKUで指定する必要があります(UPCやISBNなどは使用できません)。
商品手数料のリクエストでは、オリジナルのIDを毎回入力する必要があります。このIDは手数料見積り額とともに返されるので、手数料見積り額とオリジナルのリクエストを照合できます。
このオペレーションでは、一度に最大20個の商品をリクエストできます。結果の処理について詳しくは、一括オペレーションリクエストを実行するを参照してください。
手数料の詳細については、セラーセントラルの手数料見積り額とFBA - 機能と手数料を参照してください。
このオペレーションはすべてのマーケットプレイスで利用できます。
最大リクエストクォータ | 回復レート | 時間あたりのリクエストクォータ |
---|---|---|
20リクエスト | 1秒ごとに10商品 | 1時間あたり36000リクエスト |
すべてのAmazon MWSオペレーションに必須とされるリクエストパラメーターについて詳しくは、Amazon MWS開発者ガイドの必須リクエストパラメータを参照してください。
名前 | 説明 | 必須 | 値 |
---|---|---|---|
FeesEstimateRequestList | 手数料のクエリで問い合わせる商品、マーケットプレイス、その他のオプションのリスト。 | はい | 最大:20リクエスト。 タイプ:タイプのリスト: FeesEstimateRequest |
Amazon MWSは、リクエストまたはサブスクリプションの成功に対するレスポンスを含むXMLファイルを返します。リクエストが失敗すると、主なレスポンス要素はErrorResponseとなります。詳しくは、Amazon MWS開発者ガイドのレスポンスのフォーマットを参照してください。
GetMyFeesEstimateオペレーションが返すレスポンス要素は、公開されているXSD ProductsAPI_Response.xsdで内容を確認できます。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>
標準のレスポンスフォーマットについて詳しくは、レスポンスフォーマットを参照してください。
<?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>