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.
複数のマーケットプレイスに出品用アカウントを登録している場合の有効な利用方法を説明します。
複数のマーケットプレースに登録している場合は、自身のSellerIdに複数のMarketplaceId値が関連付けられています。こうした複数のMarketplaceId値は、たとえばAmazon出品用アカウントや、該当サービスが利用可能なCheckout by Amazonアカウントの場合があります。欧州(EU)または北米(NA)地域では、統一された1つの出品用アカウントを使用して登録していれば、複数のマーケットプレースで出品できます。また、自身のアカウントに関連付けられた複数のMarketplaceId値を保持することになります。
すべての出品者がデフォルトのマーケットプレースを持ちます。デフォルトのマーケットプレイスは、最初に出品用アカウントを登録した国になります。たとえば、ドイツ(DE)のセラーセントラルの出品用アカウントを登録した場合、デフォルトのマーケットプレイスはドイツ(DE)、MarketplaceIdはA1PA6795UKMFR9です(以下の表にあるMarketplaceIdの値を参照)。複数のマーケットプレイスでの販売について詳しくは、北米マーケットプレイスでのAmazon出品サービスを参照してください。
マーケットプレイスが指定されていない場合は、互換性のために、デフォルトマーケットプレイスのサイトですべてのマーケットプレイスが表示されます。
RequestReportオペレーションを呼び出すときに、MarketplaceIdListパラメータにMarketplaceIdのリストを提供し、レポートが必要なマーケットプレイスを指定します。たとえば、EUマーケットプレイスの出品者は、以下のMarketplaceIdListパラメーターを指定して、レポートにフランス(FR)とドイツ(DE)のマーケットプレイスの情報を含めることができます。
&MarketplaceIdList.Id.1=A13V1IB3VIYZZH &MarketplaceIdList.Id.2=A1PA6795UKMFR9
このパラメータをMarketplaceパラメータと混同しないようにしてください。Marketplaceパラメータは認証には使用されなくなっていて廃止されます。
EUおよびNAの出品者は、レポートのマーケットプレイスを示すために、https://mws.amazonservices.deなどの特定の国のエンドポイントを使用する必要はありません。EUおよびNAの出品者は、レポートのリクエストを送信するときにMarketplaceIdを指定して、指定したEUやNAのマーケットプレイスのレポートを入手できます。
以下の表に、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の値を示します。
マーケットプレイス | ドメイン | MarketplaceId |
---|---|---|
カナダ | www.amazon.ca | A2EUQ1WTGCTBG2 |
米国 | www.amazon.com | ATVPDKIKX0DER |
メキシコ | www.amazon.com.mx | A1AM78C64UM0Y8 |
また、Checkout by AmazonMarketplaceId値を指定することもできます。
レポートリクエストを送信するときに、複数のMarketplaceId値を含めると、レポート処理の動作はより複雑になります。以下は、複数のMarketplaceId値でレポートリクエストを送信する際のルールになります。
「ReportType列挙子」の出品レポートは、1つのリクエストにつき1つのマーケットプレイスのみの情報を提供します。
「ReportType列挙子」のフラットファイル形式の注文レポートでは、販売チャネル情報の追加列を表示するためにShowSalesChannelパラメーターを使用できます。以下のコードはReportOptions=ShowSalesChannelパラメーターがどのようにレポートリクエストに含まれているかを示しています。
POST /?AWSAccessKeyId=SDFSD235ASSDFG3445AS &Action=RequestReport &MWSAuthToken=amzn.mws.4ea38b7b-f563-7709-4bae-87aeaEXAMPLE &MarketplaceIdList.Id.1=A1F83G8C2ARO7P &MarketplaceIdList.Id.2=A1PA6795UKMFR9 &SellerId=AGFDG34255SFDSSHV83 &SignatureVersion=2 &Timestamp=2011-06-23T22%3A33%3A25Z &Version=2009-01-01 &Signature=%2BtKQ637UjDCoE%2F3w8GTmsd8E29Lrgsuc%2FkdYBLPfyE8%3D &SignatureMethod=HmacSHA256 &ReportType=_GET_CONVERGED_FLAT_FILE_ORDER_REPORT_DATA_ &ReportOptions=ShowSalesChannel%3Dtrue HTTP/1.1 Host: mws.amazonservices.com x-amazon-user-agent: AmazonJavascriptScratchpad/1.0 (Language=Javascript) Content-Type: text/xml
ReportType列挙子の注文トラッキングレポートは、レポートリクエスト送信時に1つのマーケットプレイスのみを指定しても、出品者が登録しているすべてのマーケットプレイスの注文を返します。
ReportType列挙子の決済レポートは、マーケットプレイスのアカウントのステータスにかかわらず入手できます。決済レポートには、Amazonの出品者、およびCheckout by Amazon(適用される場合)決済のトランザクションが含まれます。