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

ファイルアップロードおよびフィードAPIを利用した価格更新時のAmazonポイントの挙動の変更について

【2019.07.30 追記】 2019年7月31日に適用予定となっていた本変更ですが、適用時期が延期となりました。最新情報は下記セラーフォーラム記事をご確認ください。 ファイルアップロードおよびフィードAPI を利用した価格更新時のAmazon ポイントの挙動の変更について

2019年7月31日より、セラーセントラルからのファイル（カテゴリー別在庫ファイル、出品ファイル(L)(I)、価格と数量変更ファイル、カスタムテンプレート）のアップロードおよびフィードAPIを使用した価格更新において、既に設定されているAmazonポイントの付与数に対する挙動が変更されます。

 

■変更内容

付与するAmazonポイントが設定されている商品の価格更新時に、ポイント設定項目にブランクを指定またはポイント設定項目自体を含めない場合の挙動が下記のように変更されます。

変更前	変更後
付与されるポイント数を0に上書き。	設定済みの付与ポイント数を維持。

 

■影響

上記の仕様変更により、フィードAPIによる価格更新時に下記のパターンで付与ポイントの削除を行っている開発者様は対応が必要となります。

パターン	必要な対応
ポイントを削除する際に、ポイント設定項目をブランクにして更新している。	ポイントを削除する際には、ポイント設定項目にブランクではなく0を設定する。
ポイントを削除する際に、ポイント設定項目をフィードに含めずに更新している。	ポイントを削除する際には、ポイント設定項目をフィードに含め、かつ、値に0を設定する。

 

なお、上記仕様変更の影響を受ける各種ファイル・フィードにおいて、商品の販売価格、セール価格およびそれぞれの価格に対応するポイント数の設定項目名は下記となります。

 

ファイル/フィード	フィードタイプ	価格設定項目	ポイント設定項目
カスタム在庫ファイル, カテゴリー別在庫ファイル	_POST_FLAT_FILE_LISTINGS_DATA_	standard_price	standard_price_points
		sale_price	sale_price_points
出品ファイル(L)	_POST_FLAT_FILE_LISTINGS_DATA_	price	standard-price-points
		sale-price	sale-price-points
出品ファイル(I)	_POST_FLAT_FILE_INVLOADER_DATA_	price	standard-price-points
価格と数量変更ファイル(フラットファイル 価格と数量更新フィード)	_POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA_	price	standard-price-points
		sale-price	sale-price-points
フラットファイル 本の商品登録フィード	_POST_FLAT_FILE_BOOKLOADER_DATA_	standard_price	standard_price_points
		sale_price	sale_price_points
フラットファイル ミュージックの商品登録フィード	_POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA_	standard_price	standard_price_points
		sale_price	sale_price_points
価格フィード	_POST_PRODUCT_PRICING_DATA_	StandardPrice	StandardPricePoints
		SalePrice	SalePricePoints

 

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

商品APIセクションおよび AnyOfferChanged 通知の LandedPrice の変更について

2019年6月19日に予定されている、商品APIセクションおよび AnyOfferChanged 通知の LandedPrice の変更内容をご紹介します。なお、仕様変更の実施日の最新情報については、フォーラムアナウンスをご確認ください。この変更により、出品APIセクションの一部のオペレーションのレスポンスに含まれるLandedPrice要素の定義が変更されます。また、AnyOfferChanged通知に含まれるLandedPrice要素の定義も合わせて変更されます。

 

変更前のLandedPrice要素の定義	変更後のLandedPrice要素の定義
販売価格（ListingPrice）＋配送料（Shipping）	販売価格（ListingPrice）＋配送料（Shipping）- Amazonポイント（Points）

 

この定義変更に伴い、アクティブな出品一覧をLandedPriceの値でソートして最低価格もしくは上位20の価格情報を決定するオペレーションとプッシュ通知では、ポイント数を考慮したLandedPriceでソートされた価格情報に基づいて返却値が決定されるようになります。

 

変更前の価格情報のソート方法	変更後の価格情報のソート方法
販売価格（ListingPrice）＋配送料（Shipping）が小さい順に出品をソート	販売価格（ListingPrice）＋配送料（Shipping）- Amazonポイント（Points）が小さい順に出品をソート

 

なお、GetLowestPricedOfferForSKUおよびGetLowestPricedOfferForASINオペレーションにて返却されるLandedPriceは、この変更が適用された日より段階的に更新されます。この段階的な更新による注意点は下記となります。

• 変更適用後も、一部の商品に対しては引き続きポイント数を考慮しないLandedPriceが返却されます。
• LandedPriceが更新されていない商品については、上位20の出品情報の決定にもポイント数が考慮されません。
• 全ての商品のLandedPriceが更新されるまでに15日程度かかる可能性があります。
• この移行期間中にポイント数を考慮したLandedPriceを確実に取得するには、レスポンスに含まれるListingPrice、 Shipping、およびPoints要素の値を用いて、下記計算を行ってください。
  LandedPrice = ListingPrice + Shipping - Points

 

下記は、これらの変更が適用されるオペレーションと通知をまとめたものです。

 

API セクション	APIオペレーション名もしくは フィード・レポート名	予定されている 仕様変更	関連情報
商品	GetCompetitivePricingForSKU GetCompetitivePricingForASIN GetMyPriceForSKU GetMyPriceForASIN	販売価格+配送料の合計からポイント数を差し引いた値をLandedPrice要素として返却。	GetCompetitivePricingForSKU GetCompetitivePricingForASIN GetMyPriceForSKU GetMyPriceForASIN
商品	GetLowestPricedOffersForSKU GetLowestPricedOffersForASIN	販売価格+配送料の合計からポイント数を差し引いた値をLandedPrice要素として返却。   ポイントを考慮した価格で出品をソートし、返却値を決定。	GetLowestPricedOffersForSKU GetLowestPricedOffersForASIN
商品	GetLowestOfferListingsForSKU GetLowestOfferListingsForASIN	販売価格+配送料の合計からポイント数を差し引いた値をLandedPrice要素として返却。   ポイントを考慮した価格で出品をソートし、返却値を決定。   LandedPriceの値に基づいて最低価格の出品が複数あるかどうかを判定しているMultipleOfferListingsAtLowestPrice要素についても、付与されるポイント数を   ※変更の適用日より、段階的に更新	GetLowestOfferListingsForSKU GetLowestOfferListingsForASIN
サブスクリプション	AnyOfferChangedNotification	BuyBoxPrice, LowestPrice要素で返却されるLandedPrice価格が、販売価格+配送料の合計からポイント数を差し引いた値で表示されるように変更。   ポイントを考慮した価格で出品をソートし、返却値を決定。	AnyOfferChangedNotification

 

 

なお、この変更に関連して、開発者様よりいただくよくある質問と回答につきましては、随時本記事に追加させていただきます。

 

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

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）

 

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

 

商品検索シートの提供終了に伴う商品情報の取得について

無償ツールとして提供されていた『商品検索シート』が廃止となりました。商品検索シートは、既にAmazonのカタログに登録されている（ASINが存在する）商品を出品する際に必要な商品情報を取得するツールです。

商品検索シートで提供されていた５種類の検索機能と、それぞれ利用されていた商品APIの主なオペレーションは以下のとおりです。

1	JANから商品を検索	GetMatchingProductForIdオペレーション
2	ASINから商品を検索	GetMatchingProductForIdオペレーション （またはGetMatchingProduct）
3	キーワードから商品を検索	ListMatchingProductsオペレーション
4	親ASINから子ASINを検索	GetMatchingProductForIdオペレーション （またはGetMatchingProduct）
5	ASINからブラウズノードを検索	GetProductCategoriesForASINオペレーション

 

最低価格の取得

商品検索シートでは、JAN、(親)ASIN、キーワードを指定して返却される商品情報に加え、最低価格の情報を取得するためにGetLowestOfferListingsForASINオペレーションを利用していました。

GetLowestOfferListingsForASINオペレーションでは、そのASINに対して最低価格が設定されている出品情報の価格（ListingPrice要素、ShippingPrice要素）に加えて、リードタイム（ShippingTime要素）も取得できます。

 

子ASINの取得

バリエーションが設定されている商品で親ASINから子ASINを検索する場合、GetMatchingProductForId（またはGetMatchingProduct）オペレーションを使用します。

まず、親ASINを指定してGetMatchingProductForIdオペレーションのレスポンスのRelationShips要素で子ASINのリスト（VariationChild要素）が返却されます。

<?xml version="1.0"?>
<GetMatchingProductResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMatchingProductResult ASIN="B*********" status="Success">
    <Product xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
            :
      <Relationships>
        <ns2:VariationChild>
          <Identifiers>
            <MarketplaceASIN>
              <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
              <ASIN>B*********</ASIN>
            </MarketplaceASIN>
          </Identifiers>
          <ns2:Color>グレー</ns2:Color>
          <ns2:Size>S</ns2:Size>
        </ns2:VariationChild>
        <ns2:VariationChild>
          <Identifiers>
            <MarketplaceASIN>
              <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
              <ASIN>B07J1F1CGX</ASIN>
            </MarketplaceASIN>
          </Identifiers>
          <ns2:Color>ブラック</ns2:Color>
          <ns2:Size>S</ns2:Size>
        </ns2:VariationChild>
        <ns2:VariationChild>
      </Relationships>
            :
</GetMatchingProductResponse>

返却された子ASINを指定してGetMatchingProductForIdオペレーションを呼び出すことで、それぞれの子ASINの商品情報を取得できます。

親ASINがわからない場合、子ASINを指定すると以下のようにRelationShips要素は親ASINの情報（VariationParent要素）を返却します。

<?xml version="1.0"?>
<GetMatchingProductResponse xmlns="http://mws.amazonservices.com/schema/Products/2011-10-01">
  <GetMatchingProductResult ASIN="B*********" status="Success">
    <Product xmlns:ns2="http://mws.amazonservices.com/schema/Products/2011-10-01/default.xsd">
            :
      <Relationships>
        <VariationParent>
          <Identifiers>
            <MarketplaceASIN>
              <MarketplaceId>A1VC38T7YXB528</MarketplaceId>
              <ASIN>B07J1GKD4N</ASIN>
            </MarketplaceASIN>
          </Identifiers>
        </VariationParent>
      </Relationships>
            :
</GetMatchingProductResponse>

 

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

Amazon SQSからのAmazon MWS プッシュ通知の取得について

Amazon MWSの「サブスクリプションAPI」を利用することで、特定の情報が更新されることで自動的に配信される「Amazon MWS プッシュ通知」の受信（サブスクライブ）が可能です。

今回は、Amazon Simple Queue Service（Amazon SQS）のキューに配信されたプッシュ通知をアプリケーションから取り込む手順についてご紹介します。

 

Amazon MWSプッシュ通知

現在サブスクライブできるプッシュ通知は以下の3種類ですが、今後も新たなプッシュ通知が追加されることが予想されます。

通知タイプ	通知内容
AnyOfferChangedNotification	出品者が出品している購入可能な状態の商品について、コンディション別の価格の上位20の出品情報に変更があるたびに送信されます。
FulfillmentOrderStatusNotification	FBAマルチチャネルサービス(MCF)の出荷注文のステータスが変更されたときに送信されます。
FeePromotionNotification	期間限定の手数料のプロモーション（割引）が適用された時に送信されます。

※サブスクリプションAPIおよびAnyOfferChanged通知については、『サブスクリプションAPIの特徴について』についてもご参照ください。

 

Amazon SQSのキューの作成とプッシュ通知のサブスクライブ

プッシュ通知の配信先にはAWS（Amazon Web Services）のAmazon SQSのキューが必要となります。

AWSの登録、Amazon SQSのキュー作成、MWSのサブスクリプションAPIを使った受信（サブスクライブ）の設定について詳しくは、過去のブログ記事『サブスクリプションAPI 設定方法について』をご参照ください。

尚、現在のAmazon SQSでは「スタンダード キュー」と「FIFOキュー」の2種類のキューが選択できますが、サブスクリプションAPIで指定できるキューは「スタンダードキュー」のみとなっています。

 

Amazon SQSからのプッシュ通知の取得

Amazon SQS のキューで受信したメッセージ（プッシュ通知）は、Amazon SQS APIを使用してキューをポーリングすることでアプリケーションに取り込むことが可能です。

Amazon Simple Queue Service API Reference

チュートリアル: Amazon SQS キューからのメッセージの受信および削除

 キューをポーリングする代わりに、AWS Lambdaを利用するとキューへの新しいメッセージの受信をトリガーとしてLambda関数を実行してメッセージを処理することも可能です。

AWS Lambda がサポートするイベントソースに Amazon Simple Queue Service を追加

チュートリアル: AWS Lambda 関数をトリガーするように Amazon SQS キューへの着信メッセージを設定する

  Amazon SQS APIを利用するためには、Amazon MWSの認証情報とは別に、AWS アカウントと AWS 認証情報が必要となります。アクセスキーの作成とその権限の管理は、AWSのIdentity and Access Management (IAM) コンソールから行えます。

 

AWSアクセスキーの取得

AWSアカウントにアクセスするIAMユーザーの作成とアクセスキーの取得方法については、アクセスキーの作成をご参照ください。

また、セキュリティ確保のために「AWS アクセスキーを管理するためのベストプラクティス」や「IAM のベストプラクティス」も参照してください。

 

 Amazon SQSキューへのアクセス許可

作成されたIAMユーザーにAmazon SQSキューへのアクセス権を付与するためには、「IAM ポリシー」を利用する方法と「 Amazon SQS ポリシー」を利用する方法があります。

 

IAMコンソールからのIAMポリシー設定

IAMコンソール では、以下のようにIAMユーザーやグループにAmazon SQSへのアクセスを可能にする管理ポリシー（AmazonSQSReadOnlyAccess やAmazonSQSFullAccess ）を設定可能です。

SQSコンソールからのAmazon SQSポリシー設定

SQS Management コンソールでは、プッシュ通知の配信先のキューへのアクセス許可が可能です。以下のようにプリンシパルにIAMユーザーのARNを指定し、許可するアクション（例：ReceiveMessageとDeleteMessage）の設定が可能です。

詳しくは、以下のAmazon SQS開発者ガイドもご参照ください。

Amazon SQS に対する認証とアクセスコントロール

Amazon SQS でのアイデンティティベース (IAM) のポリシーの使用

Amazon SQS Access Policy Language を使用したカスタムポリシーの使用

 

アプリケーションからのAmazon SQSへのアクセス

適切にアクセス権が付与されたIAMユーザーのAWSアクセスキーが取得できたら、Amazon SQS APIを利用してメッセージ(プッシュ通知）にアクセスが可能となります。

AWS SDKでは、MWSのクライアントライブラリでサポートされている各言語のサンプルコードも提供されています。

AWS SDK for Javaのサンプルコード

AWS SDK for PHPのサンプルコード

AWS SDK for .NETのサンプルコード

AWS SDK for Javaを利用する場合、開発者ガイドの「開始方法」を参照してSDKのインストールやAWSアクセスキーのセットアップを行い、「AWS SDK for Java を使用した Amazon SQS の例」を参考にAmazon SQSメッセージ（MWSプッシュ通知）の受信や削除などがお試しください。

 

「Amazon SQS開発者ガイド」では「Amazon SQS コストの削減」など様々な「Amazon SQSのベストプラクティス」も紹介されていますので是非ご参照ください。

 

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