Amazon マーケットプレイスWebサービス(MWS) 日本公式ブログ

FBA手数料改定後のGetMyFeesEstimateのレスポンスについて

2019年2月、フルフィルメントby Amazon(FBA)の手数料改定が順次予定されております。

商品APIセクションのGetMyFeesEstimateオペレーションにて見積もり額を取得可能な「配送代行手数料」につきましても、2月21日出荷分より新しい料金体系が適用されます。

GetMyFeesEstimateオペレーションが返す配送代行手数料の見積もり額は、2月21日以降に送信されるリクエスト分より、新しい料金体系が適用される予定です。

GetMyFeesEstimateオペレーションで返却されるFeeTypeが表す手数料に変更はなく、配送代行手数料は引き続きFBAPickAndPackとして返却されます。FeeTypeが表す手数料は以下となります。

ReferralFee	販売手数料
VariableClosingFee	カテゴリー成約料
PerItemFee	基本成約料
FBAFees	フルフィルメント by Amazon 手数料の合計
FBAPickAndPack	配送代行手数料
FBAWeightHandling	使用しない（常に0）

レスポンスのサンプル

<?xml version="1.0"?>
<GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>Success</Status>
        <FeesEstimateIdentifier>
          <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
          <SellerId>>**************</SellerId>
          <IdType>ASIN</IdType>
          <IdValue>**********</IdValue>
          <IsAmazonFulfilled>true</IsAmazonFulfilled>
          <PriceToEstimateFees>
            <ListingPrice>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>5000</Amount>
            </ListingPrice>
            <Shipping>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>0</Amount>
            </Shipping>
            <Points>
              <PointsNumber>0</PointsNumber>
            </Points>
          </PriceToEstimateFees>
          <SellerInputIdentifier>FEE20180428AAA</SellerInputIdentifier>
        </FeesEstimateIdentifier>
        <FeesEstimate>
          <TimeOfFeesEstimation>2018-04-28T05:58:52.781Z</TimeOfFeesEstimation>
          <TotalFeesEstimate>                       <!-- 見積もり手数料の合計 -->
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>866.00</Amount>
          </TotalFeesEstimate>
          <FeeDetailList>
            <FeeDetail>
              <FeeType>ReferralFee</FeeType>                 <!-- 販売手数料 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>500.00</Amount>
              </FeeAmount>
              <FeePromotion>                <!-- 販売手数料のプロモーション金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>                              <!—販売手数料の最終金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>500.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>VariableClosingFee</FeeType>    <!-- カテゴリー成約料 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>PerItemFee</FeeType>                <!-- 基本成約料 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>FBAFees</FeeType>              <!-- FBA手数料の合計 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>366.00</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>366.00</Amount>
              </FinalFee>
              <IncludedFeeDetailList>
                <FeeDetail>
                  <FeeType>FBAWeightHandling</FeeType>   <!-- 不使用 (常時0) -->
                  <FeeAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FeeAmount>
                  <FeePromotion>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FeePromotion>
                  <FinalFee>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FinalFee>
                </FeeDetail>
                <FeeDetail>
                  <FeeType>FBAPickAndPack</FeeType>      <!-- 配送代行手数料 -->
                  <FeeAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>366.00</Amount>
                  </FeeAmount>
                  <FeePromotion>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FeePromotion>
                  <FinalFee>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>366.00</Amount>
                  </FinalFee>
                </FeeDetail>
              </IncludedFeeDetailList>
            </FeeDetail>
          </FeeDetailList>
        </FeesEstimate>
      </FeesEstimateResult>
    </FeesEstimateResultList>
  </GetMyFeesEstimateResult>
  <ResponseMetadata>
    <RequestId>12abcdef-1234-5678-abcd-abcdefgh1234</RequestId>
  </ResponseMetadata>
</GetMyFeesEstimateResponse>		

 

GetMyFeesEstimateオペレーションについて詳しくは以下もご参照ください。

• ブログ（2017/01/30投稿）: Amazon MWS での手数料見積り額の取得について
• APIリファレンス： GetMyFeesEstimate

 

FBAの料金体系の変更及び手数料の改定については以下のヘルプをご参照ください。

• ヘルプ： 2019年フルフィルメントby Amazonの手数料改定（Amazon.co.jp）

 

以上、開発の参考にして頂けますと幸いです。

 

FBA手数料改定に伴うGetMyFeesEstimateのレスポンスの変更について

【2019.01.30 追記】 2019年2月に、フルフィルメント by Amazon（FBA）の手数料改定が予定されています。詳しくは下記の記事をご参照ください。 FBA手数料改定後のGetMyFeesEstimateのレスポンスについて

 

2018年4月24日、日本のAmazonマーケットプレイスではFBAの料金体系の変更及び手数料の改定が実施されました。

これに伴い、商品の販売手数料の見積り額を取得するためのGetMyFeesEstimateオペレーション（商品APIセクション）が返すFeeTypeが表す手数料が一部変更されています。

 

FeeType変更点

「出荷作業手数料」と「発送重量手数料」の2つの手数料が「配送代行手数料」に統一されました。以前は「出荷作業手数料」を表していたFBAPickAndPackが、現在は「配送代行手数料」を表すようになっています。FBAWeightHandlingは現在使用されていません。

FBAPickAndPack：	出荷作業手数料　⇒　配送代行手数料
FBAWeightHandling：	発送重量手数料　⇒　使用しない（常に0を返却）

 

これにより、GetMyFeesEstimateオペレーションで返却されるFeeTypeが表す手数料は以下のようになります。

ReferralFee	販売手数料
VariableClosingFee	カテゴリー成約料
PerItemFee	基本成約料
FBAFees	フルフィルメント by Amazon 手数料の合計
FBAPickAndPack	配送代行手数料
FBAWeightHandling	使用しない（常に0）

 

レスポンスのサンプル

<?xml version="1.0"?>
<GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>Success</Status>
        <FeesEstimateIdentifier>
          <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
          <SellerId>>**************</SellerId>
          <IdType>ASIN</IdType>
          <IdValue>**********</IdValue>
          <IsAmazonFulfilled>true</IsAmazonFulfilled>
          <PriceToEstimateFees>
            <ListingPrice>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>5000</Amount>
            </ListingPrice>
            <Shipping>
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>0</Amount>
            </Shipping>
            <Points>
              <PointsNumber>0</PointsNumber>
            </Points>
          </PriceToEstimateFees>
          <SellerInputIdentifier>FEE20180428AAA</SellerInputIdentifier>
        </FeesEstimateIdentifier>
        <FeesEstimate>
          <TimeOfFeesEstimation>2018-04-28T05:58:52.781Z</TimeOfFeesEstimation>
          <TotalFeesEstimate>                       <!-- 見積もり手数料の合計 -->
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>866.00</Amount>
          </TotalFeesEstimate>
          <FeeDetailList>
            <FeeDetail>
              <FeeType>ReferralFee</FeeType>                 <!-- 販売手数料 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>500.00</Amount>
              </FeeAmount>
              <FeePromotion>                <!-- 販売手数料のプロモーション金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>                              <!—販売手数料の最終金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>500.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>VariableClosingFee</FeeType>    <!-- カテゴリー成約料 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>PerItemFee</FeeType>                <!-- 基本成約料 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
              <FeeType>FBAFees</FeeType>              <!-- FBA手数料の合計 -->
              <FeeAmount>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>366.00</Amount>
              </FeeAmount>
              <FeePromotion>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>366.00</Amount>
              </FinalFee>
              <IncludedFeeDetailList>
                <FeeDetail>
                  <FeeType>FBAWeightHandling</FeeType>   <!-- 不使用 (常時0) -->
                  <FeeAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FeeAmount>
                  <FeePromotion>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FeePromotion>
                  <FinalFee>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FinalFee>
                </FeeDetail>
                <FeeDetail>
                  <FeeType>FBAPickAndPack</FeeType>      <!-- 配送代行手数料 -->
                  <FeeAmount>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>366.00</Amount>
                  </FeeAmount>
                  <FeePromotion>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>0.00</Amount>
                  </FeePromotion>
                  <FinalFee>
                    <CurrencyCode>JPY</CurrencyCode>
                    <Amount>366.00</Amount>
                  </FinalFee>
                </FeeDetail>
              </IncludedFeeDetailList>
            </FeeDetail>
          </FeeDetailList>
        </FeesEstimate>
      </FeesEstimateResult>
    </FeesEstimateResultList>
  </GetMyFeesEstimateResult>
  <ResponseMetadata>
    <RequestId>12abcdef-1234-5678-abcd-abcdefgh1234</RequestId>
  </ResponseMetadata>
</GetMyFeesEstimateResponse>		

* TotalFeesEstimate = ReferralFee + VariableClosingFee + PerItemFee + FBAFees    * FBAFees = FBAWeightHandling + FBAPickAndPack

 

GetMyFeesEstimateオペレーションについて詳しくは以下もご参照ください。

• ブログ（2017/01/30投稿）： Amazon MWS での手数料見積り額の取得について
• APIリファレンス： GetMyFeesEstimate

 

FBAの料金体系の変更及び手数料の改定については以下のヘルプをご参照ください。

• ヘルプ： 2018年フルフィルメント by Amazonの手数料改定（Amazon.co.jp）

尚、今回の変更ではクライアントライブラリの更新は必要ありません。

以上、開発の参考にして頂けますと幸いです。

 

Amazon MWS での手数料見積り額の取得について

【2019.01.30 追記】 2018年4月24日より、フルフィルメント by Amazon（FBA）の「出荷作業手数料」と「発送重量手数料」の2つの手数料が「配送代行手数料」に統一されたことにより、GetMyFeesEstimateオペレーションが返すFeeTypeが表す手数料が一部変更されています。詳しくは下記の記事をご参照ください。 FBA手数料改定に伴うGetMyFeesEstimateのレスポンスの変更について

 

Amazon MWSの商品APIにGetMyFeesEstimateオペレーションが追加されました。

これまで手数料は、カテゴリーやサイズ情報をもとに各種手数料情報を参照して計算する必要がありました。

GetMyFeesEstimateオペレーションでは、商品情報とともにリクエストした条件（商品価格、配送料、ポイント、出荷経路）に応じた商品の販売手数料の見積り額を簡単に取得することができます。

以下のセラーセントラルの在庫管理画面の「手数料見積り額」に相当する情報をAPIで取得できるようになります。

 

■ 主なリクエスト要素（FeesEstimateRequestList要素）

MarketplaceId	手数料を見積もるマーケットプレイスのID　 (Amazon.co.jp : A1VC38T7YXB528)
IdType	IdValueで使用される商品IDの種類　（ASIN または SellerSKU）
IdValue	商品ID （手数料を見積もる商品の ASIN または SKU）
PriceToEstimateFees	手数料の見積もりの基準となる商品価格 ListingPrice 商品の価格 Shipping  配送料 Points 商品の購入で獲得するAmazonポイント数
Identifier	リクエストを識別するためにリクエスト単位で指定する送信者が設定するID
IsAmazonFulfilled	出荷経路　（true: FBA, false: 出品者出荷）

 

■ 主なリクエスト要素（FeesEstimateResultList要素）

FeesEstimateIdentifier	以下の子要素からなる商品ID、マーケットプレイス、リクエスト日時、見積もりに関する情報。 MarketplaceId 暗号化された、Amazonが定義したマーケットプレイスID IdType  IdValueで使用される商品IDのタイプ IdValue 商品ID PriceToEstimateFees 手数料の見積りの基準となる商品価格 IsAmazonFulfilled 出荷経路（true: Amazon出荷[FBA], false: 出品者出荷） SellerInputIdentifier リクエスト識別のために送信者が指定したID TimeOfFeesEstimation 手数料の見積もり日時
FeesEstimate	以下の子要素からなる合計手数料見積り額の詳細のリスト。（ASIN または SellerSKU） TotalFeesEstimate  各商品、価格、出荷経路に対する手数料見積り額の合計。 FeeDetailList  以下の子要素からなる手数料に適用されたその他の手数料のリスト。 FeeType 出品者に請求される手数料のタイプ FeeAmount 手数料の請求金額 FeePromotion 手数料のプロモーション金額 TaxAmount 手数料の税額（インドのみ） FinalFee 手数料の最終的な金額 IncludedFeeDetailList 手数料に適用されたその他の手数料のリスト
Status	手数料リクエストのステータス（Success、ClientError、ServiceError）
Error	タイプ、コード、メッセージで構成されるエラーオブジェクト

 

■ レスポンスのサンプル

<?xml version="1.0"?>
<GetMyFeesEstimateResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMyFeesEstimateResult>
    <FeesEstimateResultList>
      <FeesEstimateResult>
        <Status>Success</Status>
        <FeesEstimateIdentifier>
          <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
          <SellerId>**************</SellerId>
          <IdType>ASIN</IdType>
          <IdValue>**********</IdValue>
          <IsAmazonFulfilled>true</IsAmazonFulfilled>
          <PriceToEstimateFees>
            <ListingPrice>　　　　　　　　　　<-- 手数料見積りリクエスト時に指定した商品の価格-->
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>5000</Amount>
            </ListingPrice>
            <Shipping>　　　　　　　　　　　　 <-- 手数料見積りリクエスト時に指定した配送料 -->
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>1000</Amount>
            </Shipping>
            <Points>　　　　　　　　　　　　   <-- 手数料見積りリクエスト時に指定したAmazon ポイント数 -->
              <PointsNumber>0</PointsNumber>
            </Points>
          </PriceToEstimateFees>
          <SellerInputIdentifier>FEE20161221024537AAA</SellerInputIdentifier>
        </FeesEstimateIdentifier>
        <FeesEstimate>
          <TimeOfFeesEstimation>2016-12-21T02:45:37.171Z</TimeOfFeesEstimation> <!-- 見積り日時 -->
          <TotalFeesEstimate>
            <CurrencyCode>JPY</CurrencyCode>
            <Amount>2171.00</Amount>               <!--  合計見積もり手数料  -->
          </TotalFeesEstimate>
          <FeeDetailList>
            <FeeDetail>
              <FeeType>ReferralFee</FeeType>       <!--販売手数料 -->
              <FeeAmount>　　　　　　　　　　　　      <!—販売手数料の請求金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>1842.00</Amount>
              </FeeAmount>
              <FeePromotion>                         <!—販売手数料のプロモーション金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>0.00</Amount>
              </FeePromotion>
              <FinalFee>                             <!—販売手数料の最終金額 -->
                <CurrencyCode>JPY</CurrencyCode>
                <Amount>1842.00</Amount>
              </FinalFee>
            </FeeDetail>
            <FeeDetail>
            <FeeType>VariableClosingFee</FeeType>    <!-- カテゴリー成約料 -->
            <FeeAmount>　　　　　　　　　　　　　　　    <!—カテゴリー成約料の請求金額 -->
              <CurrencyCode>JPY</CurrencyCode>
              <Amount>0.00</Amount>
            </FeeAmount>
                    ：
					

GetMyFeesEstimate のクエリリクエストやレスポンスのサンプルは以下のAPIリファレンスのサンプルもご覧ください。

 

■ よくあるご質問

Q. 返却される手数料の見積り金額に税は含まれますか？ A. GetMyFeesEstimateで返却される金額は税抜価格です。

Q. どのような手数料が取得できますか？ A. 返却される手数料には以下のようなものがあります。  ReferralFee 販売手数料 VariableClosingFee カテゴリー成約料 PerItemFee 基本成約料 FBAFees フルフィルメント by Amazon 手数料 FBAPickAndPack 出荷作業手数料 FBAWeightHandling 発送重量手数料  なお、以下の手数料は返却されません。 ・月間登録料 ・ギフト包装料 ・以下のFBA手数料 - 在庫保管手数料／長期在庫保管手数料 - 商品ラベル貼付サービス - 返送・所有権の放棄 ・マルチチャネルサービスの手数料

Q. “Item shipping weight is not available.“ というエラーメッセージが返りました。なぜでしょうか？ A. FBA利用時の手数料を見積る場合（setIsAmazonFulfilled = TRUE）、包装された商品の重量が登録されていない商品を指定すると、FeesEstimate要素が返却されず、代わりに以下のエラーが返却されます。  <Error>           <Type>Receiver</Type>           <Code>DataNotAvailable</Code>           <Message>Item shipping weight is not available.</Message> </Error> GetMyFeeEstimate では、FBA の重量に関連する手数料の計算には包装された状態での商品の寸法と重量が使われるため、商品フィードやセラーセントラルで以下のように包装の寸法と重量を登録してください。  [在庫管理] →　[詳細の編集] → [詳細] → 「包装の寸法」の下の 「重量」

この新しい機能のリリースにより更新されたクライアントライブラリ（Java, C#, PHP）はAmazon MWS開発者ポータルからダウンロードが可能です。

GetMyFeesEstimateについて詳しくは APIリファレンスをご覧ください。

 

以上、皆様の開発時のご参考となれば幸いです。

商品APIでのデジタルコンテンツのASINの識別方法について

書籍や音楽CD等の商品登録において、同タイトルのデジタルコンテンツ商品のASINを誤って指定してしまうことで、実際にはその商品を販売できていないという状況が発生することがあります。商品APIを正しく使うことで、これらの問題を防ぐことができます。

 

具体的には、以下のように商品APIを使って正しいASINを取得してください。

1.  ListMatchingProducts ではなくGetMatchingProductForId を使う
2. ListMatchingProducts や GetMatchingProductForId のレスポンスから正しい商品を特定する

 以下に、それぞれのケースをご紹介します。

 

1. ListMatchingProducts ではなくGetMatchingProductForId を使う

ListMatchingProducts で書籍のISBNをQueryパラメータに指定して検索した際、紙書籍と電子書籍の両方が販売されているにも関わらず電子書籍の情報だけが返却され、紙書籍のASINを取得できない場合があります。

この現象を避けるために、ISBNやJANなどの商品コードがわかっている場合は ListMatchingProducts オペレーションの代わりにGetMatchingProductForId オペレーションを使います。

（例：ISBNでの検索の場合）

リクエストパラメータのIdType に“ISBN”を、IdList に検索するISBNの値を指定して検索します。

  &Action=GetMatchingProductForId
         :
  &IdType=ISBN
  &IdList.Id.1=1234****7890

これにより、商品コードに一致している紙書籍と電子書籍の両方の情報を取得できます。

続いて、次にご紹介する方法で出品したい商品の識別を行います。

 

2. ListMatchingProducts や GetMatchingProductForId のレスポンスから正しい商品を特定する

ListMatchingProducts を利用し商品タイトル等で検索すると、紙書籍と電子書籍、CDとMP3などの異なる媒体の商品が同時に返される場合があります。

その場合、レスポンスには複数の Product 要素が存在します。たとえば書籍の場合、「文庫」「ハードカバー」「コミック」などの紙書籍のProduct要素に加えて「Kindle版」のProduct要素が出現します。

 この時、レスポンスの最初にあるProduct要素を紙書籍やCDと仮定して無条件に取り込んでしまうと、誤ってデジタルコンテンツのASINに対して出品してしまうことがあります。

複数の Product 要素が返却された場合、子要素のProductGroup によって商品カテゴリーを識別し、正しい商品へ出品する必要があります。紙書籍の場合は Book 、電子書籍の場合はeBooks がProductGroupの値となりますので、紙書籍に出品する場合は、ProdcutGroupがBookのProduct要素を使用します。

〔GetMatchingProductForId のレスポンス例〕

<?xml version="1.0"?>
<GetMatchingProductForIdResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
<GetMatchingProductForIdResult Id="9780751565355" IdType="ISBN" status="Success">
  <Products xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01" xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">    <Product>
    <Identifiers>
      <MarketplaceASIN>
        <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
        <ASIN>B01BMK1NBQ</ASIN>                                <--------  電子書籍のASIN       
      </MarketplaceASIN>
    </Identifiers>
    <AttributeSets>
      <ns2:ItemAttributes xml:lang="ja-JP">
        <ns2:Binding>Kindle版</ns2:Binding>
        <ns2:Creator Role="著">Rowling, J.K.</ns2:Creator>
        <ns2:Creator Role="著">Tiffany, John</ns2:Creator>
        <ns2:Creator Role="著">Thorne, Jack</ns2:Creator>
        <ns2:Format>Kindle本</ns2:Format>
　　　　　　　　　     　　：         
        <ns2:Manufacturer>Pottermore from J.K. Rowling</ns2:Manufacturer>
        <ns2:NumberOfPages>320</ns2:NumberOfPages>
        <ns2:ProductGroup>eBooks</ns2:ProductGroup>            <--------  電子書籍のProductGroup         
        <ns2:ProductTypeName>ABIS_EBOOKS</ns2:ProductTypeName>
        <ns2:PublicationDate>2016-07-31</ns2:PublicationDate>
        <ns2:Publisher>Pottermore from J.K. Rowling</ns2:Publisher>
        <ns2:ReleaseDate>2016-07-31</ns2:ReleaseDate>
　　　　　　　　　      　：   
    <Product>
      <Identifiers>
        <MarketplaceASIN>
          <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
          <ASIN>0751565350</ASIN>                              <--------  紙書籍のASIN        
        </MarketplaceASIN>
      </Identifiers>
      <AttributeSets>
        <ns2:ItemAttributes xml:lang="ja-JP">
          <ns2:Binding>ハードカバー</ns2:Binding>
          <ns2:Creator Role="著">Rowling, J. K.</ns2:Creator>
          <ns2:Creator Role="著">Thorne, Jack</ns2:Creator>                                  
          <ns2:Creator Role="著">Tiffany, John</ns2:Creator>
　　　　　　　　　　　　　　：         
          <ns2:PackageQuantity>1</ns2:PackageQuantity>
          <ns2:PartNumber>9780751565355</ns2:PartNumber>
          <ns2:ProductGroup>Book</ns2:ProductGroup>            <--------  紙書籍のProductGroup         
          <ns2:ProductTypeName>ABIS_BOOK</ns2:ProductTypeName>
          <ns2:PublicationDate>2016-07-31</ns2:PublicationDate>
　　　　　　　　　　　　　　：

以上を参考に、既にカタログが存在する商品の出品時には、デジタルコンテンツではなく紙書籍やCD等のASINを指定するようお願いいたします。

 

なお、デジタルコンテンツのASINを指定して出品した場合、処理レポートにはエラーが表示されます。

フィードをアップロードした場合は、処理レポートのエラーを必ずご確認頂くようお願いします。

 

以上、皆様の開発時の参考となれば幸いです。

まずはスクラッチパッドで商品APIの動作をお試しください。

https://mws.amazonservices.jp/scratchpad/index.html

人気商品の情報が取得できないか？

「今回は人気商品の情報が取得できませんか？」というお問い合わせを今までに何度かいただきました。 いくつか方法があります。以下をご参考にしていただければと思います。

1) 商品APIのSalesRankings情報を確認する

商品APIのオペレーションを通じてSalesRankingsの情報を取得いただくことで、その商品のランキングを知ることができます。

GetMatchingProduct, GetMatchingProductForId

GetCompetitivePricingForASIN, GetCompetitivePricingForSKU

レスポンス内容（一部抜粋）
    <SalesRankings>
      <SalesRank>
        <ProductCategoryId>grocery_display_on_website</ProductCategoryId>
        <Rank>6</Rank>
      </SalesRank>
      <SalesRank>
        <ProductCategoryId>71443051</ProductCategoryId>
        <Rank>6</Rank>
      </SalesRank>
    </SalesRankings>

ここで取得されるProductCategoryId,Rankと商品詳細ページ上の対応は以下のようになります

ProductCategoryIdについてはレポートAPIでブラウズツリーガイドの取得が可能となりました。こちらのレポートより翻訳名称を取得ください。

ブラウズツリーガイド(CategoryIdの翻訳名称)の取得方法

2)レコメンドAPIの「セレクション」の推奨情報を取得する

レコメンドAPIの中に、商品セレクションの推奨情報を返却する機能があります。

出品者様が出品している商品の類似商品で品薄だったものが推奨情報として返却されます。

リクエスト内容等の詳細はリファレンスよりご確認いただけます。合わせてご確認ください。

レスポンス内容（一部抜粋）
      <member>
        <SalesRank>6078</SalesRank>
        <BuyboxPrice>
          <Amount>991.0</Amount>
          <CurrencyCode>JPY</CurrencyCode>
        </BuyboxPrice>
        <RecommendationReason>Popular out of stock products</RecommendationReason>
        <ItemName>ふるさと</ItemName>
        <ProductCategory>ミュージック</ProductCategory>
        <LastUpdated>2013-10-07T00:00:00Z</LastUpdated>
        <RecommendationId>Selection-Popular out of stock products-B006PJB6FS---ふるさと</RecommendationId>
        <NumberOfOffers>1</NumberOfOffers>
        <NumberOfCustomerReviews>2</NumberOfCustomerReviews>
        <BrandName>Independent Label Council Japan(IND/DAS)(M)</BrandName>
        <AverageCustomerReview>4.0</AverageCustomerReview>
        <ItemIdentifier>
          <Asin>B006PJB6FS</Asin>
          <Sku/>
          <Upc/>
        </ItemIdentifier>
      </member>

3)Amazon出品サービス掲示板の出品推奨レポートを利用する

商品APIではASINやJANコードをパラメータとして設定する必要があります。商品カテゴリー別 月間売上数TOP1000レポートを「Amazon 出品サービス掲示板」で提供されていますので、ご参照いただければと思います。こちらで人気の高い商品情報を特定し、商品APIで最低価格等の情報を取得することができます。

商品カテゴリー別 月間売上数TOP1000レポート

出品推奨レポート(週次更新)

今までいただいたお問い合わせや、先日Amazon MWS利用者様向けに実施したアンケートを基にトピックを追加していきたいと思います。今後ともどうぞよろしくお願いいたします。

商品の入り数の取得

商品の入り数は、JANコードが振られている商品に関して、何セット単位で販売されているかを表す値になります。この値は、商品APIの ListMatchingProducts、GetMatchingProduct、GetMatchingProductForIdオペレーションの<ns2:PackageQuantity>レスポンスエレメントとして取得可能です。 例を挙げると、<ns2:PackageQuantity>の値は下記のようになります。

• 例1) 「ビール500ml」 1本に対してJANコードが割り当てられている商品を1本単位で販売している場合の<ns2:PackageQuantity>は”1”。
• 例2) 「ビール500ml」 1本に対してJANコードが割り当てられている商品を24本単位で販売している場合の<ns2:PackageQuantity>は”24”。

ここで注意して頂きたいのが、商品によっては、1ケース/パッケージ/箱単位でJANコードが割り当てられている場合があることです。 その場合、<ns2:PackageQuantity>の値は、それぞれ下記の通りになります。

• 例1) 「ビール 500ml×24本」 1箱に対してJANコードが割り当てられている商品を1箱単位で販売している場合の<ns2:PackageQuantity>は”1”。
• 例2) 「ビール 500ml×24本」 1箱に対してJANコードが割り当てられている商品を2箱単位で販売している場合の<ns2:PackageQuantity>は”2”。

実際、Amazon MWS Scratchpadを使用し、商品データを見てみると<ns2:PackageQuantity>の値は下記の通りになっていることが確認できます。

※ Amazon MWS Scratchpadのメニューから、「API セクション」には「商品」、「Operation」には「GetMatchingProduct」を選択し実行。

大塚製薬 オロナミンC 120ml (ASIN: B001TZ8XUE)

<GetMatchingProductResult ASIN="B001TZ8XUE" status="Success">
 ・・・・
    <AttributeSets>
・・・・
        <ns2:PackageQuantity>1</ns2:PackageQuantity>
・・・・

        <ns2:Title>大塚製薬 オロナミンＣ 120ml</ns2:Title>
      </ns2:ItemAttributes>
・・・・

大塚製薬 オロナミンC 120ml × 50本 (ASIN: B000K7ZGYS)

<GetMatchingProductResult ASIN="B000K7ZGYS" status="Success">
 ・・・・
    <AttributeSets>
・・・・
        <ns2:PackageQuantity>50</ns2:PackageQuantity>
・・・・
        <ns2:Title>オロナミンC ドリンク 120ml×50本</ns2:Title>
      </ns2:ItemAttributes>
・・・・

以上になりますが、商品登録する際は商品の入り数に注意して頂ければと思います。

ListMatchingProducts、GetMatchingProduct、GetMatchingProductForIdオペレーションの仕様について詳しくは、Amazon MWS商品APIリファレンスをご参照ください。

Amazon MWSのPerlサンプルコード

今回は、Amazon MWSに商品APIに簡単にアクセスできる、Perlのコードをご紹介したいと思います。 現在Amazon MWSチームより、Java、C#、PHP言語によるクライアントライブラリーが提供されていますが、開発言語の違い、バージョンの違いにより、クライアントライブラリーが使用できないケースもあります。このようなケースの場合、独自ライブラリーを作成する際に今回紹介するサンプルコードを参考にしてください。

本サンプルコードの使用者は、使用に先立って以下の事項に承諾したものとします。もし承諾いただけない場合は、本サンプルコードは使用しないで下さい。

• 本サンプルコードは現状のまま無保証、無サポートにて提供されます。使用者は自己の責任の下、本サンプルコードを使用します。
• 本サンプルコードを使用したことによる使用者の損害または損失について、開発者および提供者はいかなる責任も負いません。
• 本サンプルコードの使い方や不具合についての質問には、開発者および提供者は回答の義務を負いません。

Perlモジュール

以下のPerlモジュールを予め利用できるようインストールする必要があります。

• URI::Escape - クエリース文字列パラメータのURIエンコード用
• POSIX - パラメータの日時文字列作成用
• Digest::SHA - リクエストクエリの署名用
• LWP - WEBアクセス用

ソースコード

以下ソースコードをファイルとして保存し、Amazon MWS認証情報を「####CONFIG####」内の各変数に設定してください。

use strict;
use warnings;
binmode( STDOUT, ":utf8" );
use encoding 'utf8';
use URI::Escape;
use POSIX qw(strftime);
use Digest::SHA qw(hmac_sha256_base64 hmac_sha256_hex);
use LWP;

#####################CONFIG#####################
my $method="POST";
my $access_key_id='A***********'; 
my $private_key='*******************************';
my $market_place_id='A1VC38T7YXB528'; #Markeplace is JP
my $seller_id='*************';
my $endpoint_scheme='https://';
my $endpoint_host='mws.amazonservices.jp';
my $endpoint_uri='/Products/2011-10-01';
#####################CONFIG END##################

#####################INPUT#######################
my $query="村上春樹 1q84";
my $queryContextId="Books";
#####################INPUT END###################

my $param = "";
$param .= "AWSAccessKeyId=$access_key_id";
$param .= "&Action=ListMatchingProducts";
$param .= "&MarketplaceId=$market_place_id";
$param .= "&Query=".uri_escape_utf8($query);
$param .= '&QueryContextId='.$queryContextId;
$param .= "&SellerId=".$seller_id;
$param .= "&SignatureMethod=HmacSHA256";
$param .= "&SignatureVersion=2";
$param .= "&Timestamp=".uri_escape_utf8(strftime("%Y-%m-%dT%H:%M:%SZ",gmtime(time)));
$param .= "&Version=2011-10-01";

my $signtemp = $method."\n".$endpoint_host."\n".$endpoint_uri."\n".$param;
warn("SIGSTR:\n$signtemp\n");
my $b64_digest=hmac_sha256_base64($signtemp, $private_key);
while (length($b64_digest) % 4) {
	$b64_digest .= '=';
}
my $signature = uri_escape_utf8($b64_digest);
warn("SIGBASE64: $signature\n");
$param.="&Signature=".$signature;

my $url=$endpoint_scheme.$endpoint_host.$endpoint_uri."?".$param;

my $browser=LWP::UserAgent->new;
my $response=($method eq 'POST') ? $browser->post($url) : $browser->get($url);
warn "Can't access [$url] with:",$response->status_line unless $response->is_success;
print("RESPONSE for url($url):\n\n".$response->content);

※$paramを構成するクエリーのパラメータ項目は予めAPI仕様通りにソートされています。詳しくは「開発者ガイド」より「独自のクライアントライブラリを作成する場合」をご参照ください。

サンプルの実行方法

上記ソースコードをファイルに保存し、以下のように実行してください。(例:ファイル名=exec_sample.pl)

$ perl exec_sample.pl

以上になりますが、今回のソースコードを参考にして、商品APIにかぎらず独自ライブラリーの作成にお役立てください。また、今回は、フィードの送信、レポート取得方法には触れていませんが、次の機会にご紹介したいと思います。

Amazon MWS商品API GetMatchingProductForId オペレーション – 商品コードによる商品情報の取得

出品する商品の属性情報または、価格情報（競合価格・最低価格）を取得する際には、その商品をAmazonカタログ上の適切な商品とマッチングし、商品のASINを取得する必要があります。

※ASINとは Amazonカタログ上の商品を特定する、英数字の組み合わせによる10桁の文字列です。

JANやISBNのような商品コードが明らかな場合、Amazon MWS商品APIのGetMatchingProductForIdオペレーションを呼び出してASINおよび商品属性を取得できます。

※GetMatchingProductForIdオペレーションは複数の商品を返す場合があります。パッケージ商品数(PackageQuantity)、商品カテゴリ(Binding)、売り上げランキング(SalesRankings)、商品画像(SmallImage)などの取得した商品属性情報を利用して商品を特定してください。

商品コードが分からない商品の場合、商品名などをパラメータに指定してListMatchingProductsオペレーションを呼び出すことにより商品を検索します。商品名を使った検索では複数の商品にマッチして商品特定が困難になるため、商品コードを使用したマッチングがおすすめです。

GetMatchingProductForIdオペレーション

GetMatchingProductForIdオペレーションは、指定された商品コードに基づき、商品一覧とその属性を返します。商品コードとは、ASIN、SKU（出品者商品管理番号）、UPC、EAN、ISBN、JANになります。リクエストパラメータのIdTypeに指定する商品コードの種類を指定し、IdListパラメータに商品コードを5つまで指定できます。

GetMatchingProductForIdオペレーションのスロットリング設定は、最大リクエストクォータが20リクエストで、回復レートは1秒毎に1商品です（2012年8月の時点）。

このオペレーションは、 ListMatchingProducts オペレーションを同じレスポンス要素を返します。

GetMatchingProductForIdオペレーションの仕様について詳しくは、Amazon MWS商品APIリファレンスをご参照ください。