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

Deprecation Notice:

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.

Amazon MWS ドキュメント

複数のマーケットプレイスに出品する(NA、EUのみ)

複数のマーケットプレイスに登録している場合、複数のMarketplaceId値がSellerIdに関連付けられています。これらの複数のMarketplaceIdは、たとえば、Amazon出品者用アカウント、Amazon Webstoreアカウント、またはこれらのサービスを使用できるCheckout by Amazonアカウントなどです。1つ以上のMarketplaceId値に適用されるフィードを送信できます。ヨーロッパ(EU)または北米(NA)地域の出品者は、統合された1件の出品用アカウントで、複数のマーケットプレイスをサポートするフィードを送信できます。

複数のマーケットプレイスで販売する場合、マーケットプレイス全体で同じSKUを使用して在庫を管理できます。こうすることで、複数のマーケットプレイスの在庫を手動で同期する必要がなくなります。複数のマーケットプレイスで販売する場合の詳細については、北米マーケットプレイスでのAmazon出品サービスを参照してください。

マーケットプレイスが指定されていない場合、後方互換性のため、同じデフォルトの国コードを共有するすべてのマーケットプレイスにフィードが適用されます。

注: Amazon MWS出品者APIセクションを使用して、SellerIdに関連付けられているMarketplaceId値を判断することができます。

MarketplaceId値の使用方法

どのマーケットプレイスにフィードを適用するか指定するには、SubmitFeedオペレーションを呼び出すときに、任意のMarketplaceIdListパラメーターにMarketplaceIdのリストを渡します。たとえば、EUの複数のマーケットプレイスの出品者は、以下のようにMarketplaceIdListパラメーターを指定し、フランス(FR)とドイツ(DE)のマーケットプレイスの両方にフィードを適用することを指定できます。 

&MarketplaceIdList.Id.1=A13V1IB3VIYZZH
&MarketplaceIdList.Id.2=A1PA6795UKMFR9

任意のMarketplaceIdListパラメーターをリクエストのMarketplaceパラメーターと混同しないでください。Marketplaceパラメーターは認証に使用されなくなり、廃止されました。

EUとNAの出品者は、どのマーケットプレイスにフィードを適用するかを示すために、特定の国のエンドポイント(https://mws.amazonservices.deなど)を使用する必要はありません。フィードを送信するときにMarketplaceIdを指定することで、特定のEUまたはNAのマーケットプレイスに変更を適用できます。

以下の表は、EUのMarketplaceIdの値を示しています。

表 1. EU MarketplaceId値
マーケットプレイス ドメイン MarketplaceId
フランス www.amazon.fr A13V1IB3VIYZZH
ドイツ www.amazon.de A1PA6795UKMFR9
イタリア www.amazon.it APJ6JRA9NG5V4
スペイン www.amazon.es A1RKKUPIHCS9HS
イギリス www.amazon.co.uk A1F83G8C2ARO7P

以下の表は、NAのMarketplaceIdの値を示しています。

表 2. NA MarketplaceId値
マーケットプレイス ドメイン MarketplaceId
カナダ www.amazon.ca A2EUQ1WTGCTBG2
米国 www.amazon.com ATVPDKIKX0DER
メキシコ www.amazon.com.mx A1AM78C64UM0Y8

また、Amazon WebstoreMarketplaceId値またはCheckout by AmazonMarketplaceId値を指定することもできます。

複数のMarketplaceId値を送信するときのフィード動作

フィードのリクエストを送信するときに、複数のMarketplaceId値を含める場合は、フィード処理の動作はより複雑になります。以下は、複数のMarketplaceId値でフィードのリクエストを送信する際のルールになります。
  • フラットファイルフィードは1つの国にのみ適用できます。たとえば、フラットファイルフィード送信は、MarketplaceId値がUK出品用アカウントおよびUK Webstoreアカウント用である場合には受け付けられますが、MarketplaceId値がDE出品用アカウントおよびFR出品者アカウント用などの場合には受け付けられません。
  • フィード動作は、FeedTypeと送信されるMarketplaceId値によって異なる場合があります。複数のMarketplaceId値で送信されるときの特定のFeedTypeの動作については、以下の表を参照してください。
  • 複数のMarketplaceId値が送信され、これらのMarketplaceId値の1つ以上が何らかの理由(通貨不一致、言語不一致、国不一致、出品用アカウントの一方が一時停止でもう一方が有効)によって検証に失敗した場合、Amazon MWSはエラーを返し、送信が失敗します。
  • Amazon MWS は、処理のキューに入る前にフィード送信を検証します。送信されたFeedTypeに適したMarketplaceId値が含まれている場合、フィード送信は検証に合格します。検証に合格しても、必ずしもフィードの書式が正しいことや正常に処理されることを意味するわけではありません。
  • PurgeAndReplaceがtrueに設定されたSubmitFeedが送信されると、EUまたはNAの出品者が設定したすべてのEUまたはNAのマーケットプレイスに対して消去処理が適用されます。EUまたはNAのマーケットプレイスが指定されていない場合は、後方互換性のため、国内のすべてのマーケットプレイスが更新されます。

複数のMarketplaceId値が使用された場合のXML商品フィードとXML関係フィードの動作

複数のMarketplaceId値のリストが指定されたXML商品フィードまたはXML関係フィードの送信時には、同じ言語コードを共有するすべてのマーケットプレイスを指定する必要があります。指定しないと、フィードは送信時に拒否されます。MarketplaceId値が指定されていない場合、出品者が登録されているマーケットプレイス、および出品者のデフォルトマーケットプレイスと同じ言語コードを使用するすべてのマーケットプレイスに、フィードが適用されます。FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。この動作は、次のフィードに適用されます。

  • Product Feed (_POST_PRODUCT_DATA_)
  • Relationships Feed (_POST_PRODUCT_RELATIONSHIP_DATA_)

複数のMarketplaceId値が使用された場合のXML在庫フィードの動作

EU(すべての出品者)とNA(出品者出荷の出品者のみ)の場合、数量はSKUに関連したグローバル値であるため、在庫レベルの変更は、SKUが出品中のすべてのマーケットプレイスに反映されます。複数のXML在庫フィードが異なるマーケットプレイスで同じSKUで処理された場合、出品者から最後にアップロードされたXML在庫フィードの数量が在庫としてグローバルに反映されます。商品在庫レベルを0に設定すると、すべてのマーケットプレイスの商品数量が有効に0に設定され、商品が購入不可になります。購入不可状態となった後でもすべての出品情報はシステムで管理されます。FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。この動作は、次のフィードに適用されます。

  • Inventory Feed (_POST_INVENTORY_AVAILABILITY_DATA_)

複数のMarketplaceId値が使用された場合のXML上書きファイルフィードの動作

XML上書きファイルフィードには1つのマーケットプレイスだけを指定できます。FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。この動作は、次のフィードに適用されます。

  • Overrides Feed (_POST_PRODUCT_OVERRIDES_DATA_)

複数のMarketplaceId値が使用された場合のXML価格フィードの動作

複数のMarketplaceId値のリストが指定されたXML価格フィードの送信時には、同じ通貨コードを共有するすべてのMarketplaceId値を指定する必要があります。指定しないと、フィードは送信時に拒否されます。MarketplaceId値が指定されていない場合、出品者が登録されているマーケットプレイス、および出品者のデフォルトマーケットプレイスと同じ通貨コードを使用するすべてのマーケットプレイスに、フィードが適用されます。FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。この動作は、次のフィードに適用されます。

  • Pricing Feed (_POST_PRODUCT_PRICING_DATA_)

複数のMarketplaceId値が使用された場合のXML商品画像フィードの動作

XML商品画像フィードは、指定されたマーケットプレイスのASINに画像をマッピングします。MarketplaceId値が指定されていない場合、出品者が登録されているマーケットプレイス、およびその登録したマーケットプレイスと同じ国のすべてのマーケットプレイスに、フィードが適用されます。この動作は、次のフィードに適用されます。

  • Product Images Feed (_POST_PRODUCT_IMAGE_DATA_)

複数のMarketplaceId値が使用された場合のフラットファイル商品および在庫フィードの動作

フラットファイル商品および在庫フィードは1つの国にのみ適用できます。ただし、このフィードは、Amazon出品者MarketplaceId、Amazon WebstoreMarketplaceId、Checkout by AmazonMarketplaceIdなど、その国の複数のマーケットプレイスに適用できます。ただし、EU(すべての出品者)とNA(出品者出荷の出品者のみ)の場合、数量はSKUに関連したグローバル値であるため、在庫レベルの変更は、SKUが出品されているすべてのマーケットプレイスに反映されます。異なるマーケットプレイスで、同じSKUが複数の在庫フィードで処理された場合、出品者から最後にアップロードされた在庫フィードの数量が在庫レベルとしてグローバルに反映されます。商品在庫レベルを0に設定すると、すべてのマーケットプレイスの商品数量が有効に0に設定され、商品が購入不可になります。購入不可状態となった後でもすべての出品情報はシステムで管理されます。FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。この動作は、次のフィードに適用されます。

  • Flat File Inventory Loader Feed (_POST_FLAT_FILE_INVLOADER_DATA_)
  • Flat File Listings Feed (_POST_FLAT_FILE_LISTINGS_DATA_)
  • Flat File Book Loader Feed (_POST_FLAT_FILE_BOOKLOADER_DATA_)
  • Flat File Music Loader Feed (_POST_FLAT_FILE_CONVERGENCE_LISTINGS_DATA_)
  • Flat File Video Loader Feed (_POST_FLAT_FILE_LISTINGS_DATA_)
  • Flat File Price and Quantity Update Feed (_POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA_)
  • UIEE Inventory Feed (_POST_UIEE_BOOKLOADER_DATA_)

複数のMarketplaceId値が使用された場合の注文フィードの動作

すべての注文フィードは、グローバルに一意のIDであるAmazon注文IDを参照します。このため、注文フィードはマーケットプレイス固有ではありません。この動作は、次のフィードに適用されます。

  • Order Acknowledgement Feed (_POST_ORDER_ACKNOWLEDGEMENT_DATA_)
  • Order Adjustments Feed (_POST_PAYMENT_ADJUSTMENT_DATA_)
  • Order Fulfillment Feed (_POST_ORDER_FULFILLMENT_DATA_)
  • Flat File Order Acknowledgement Feed (_POST_FLAT_FILE_ORDER_ACKNOWLEDGEMENT_DATA_)
  • Flat File Order Adjustments Feed (_POST_FLAT_FILE_PAYMENT_ADJUSTMENT_DATA_)
  • Flat File Order Fulfillment Feed (_POST_FLAT_FILE_FULFILLMENT_DATA_)

複数のMarketplaceId値が使用された場合のXML FBA出荷注文フィードの動作

すべてのXML FBA出荷注文フィードは1つの国にのみ適用できます。ただし、このフィードは、Amazon出品者のMarketplaceId、Amazon WebstoreMarketplaceId、Checkout by AmazonMarketplaceIdなど、その国の複数のマーケットプレイスに適用できます。FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。この動作は、次のフィードに適用されます。

  • FBA Fulfillment Order Feed (_POST_FULFILLMENT_ORDER_REQUEST_DATA_)
  • FBA Fulfillment Order Cancellation Feed (_POST_FULFILLMENT_ORDER_CANCELLATION_REQUEST_DATA_)

複数のMarketplaceId値を送信するときのエラーメッセージ

複数のMarketplaceId値を使用してリクエストを送信するときに、送信される可能性のあるエラーメッセージがいくつかあります。

エラーメッセージ 説明
このフィードタイプに指定されたすべてのマーケットプレイスには、同じデフォルト言語コードである必要があります。[ABCD]、[EFGH]は異なるデフォルト言語コードとなっています。 _POST_PRODUCT_DATA_フィードフィードなどの一部のフィードは、同じ言語を使用するマーケットプレイスにのみ適用できます。指定されたMarketplaceId値は同じ言語を使用していません。
このフィードタイプに指定されたすべてのマーケットプレイスには、同じデフォルト通貨コードである必要があります。[ABCD]、[EFGH]は異なるデフォルト通貨コードがあります。 _POST_PRODUCT_PRICING_DATA_フィードなどの価格を処理するフィードの一部は、同じ通貨を使用するマーケットプレイスにのみ適用できます。指定されたMarketplaceId値は同じ通貨を使用していません。
このフィードタイプに指定されたすべてのマーケットプレイスは同じ国になければなりません。[ABCD]、[EFGH]は異なるデフォルト国コードとなっています。 フラットファイルフィードは、同じ国で登録されたMarketplaceId値にのみ適用できます。指定されたMarketplaceId値は同じデフォルトの国を使用していません。
指定したマーケットプレイスは正しくアカウントに関連付けられますが、次のマーケットプレイスではこのアクションを実行できません：[ABCD]、[ABCD]。アカウントの詳細については、デフォルトマーケットプレイスのテクニカルサポートにお問い合わせください。 指定したアカウントとMarketplaceIdに何らかの問題があります。マーケットプレイスへの登録が完了していないなどの理由で、このエラーメッセージが表示されることがあります。販売国のテクニカルサポートに問い合わせ、問題を解決してください。
1つ以上の指定されたマーケットプレイスはFBAマーケットプレイスであり、このフィードおよびレポートタイプでは使用できません：[ABCD]、[ABCD]。 FBAのMarketplaceIdは、このタイプのフィードでは有効なMarketplaceIdではありません。
フィードをマーケットプレイスに適用できませんでした。 MarketplaceIdを指定しなかったため、Amazon MWSは使用する適切なマーケットプレイスを決定しようとしました。リクエストを実行するために使用できるアカウントに関連付けられたマーケットプレイスが見つかりませんでした。