Amazon MWSでは、出品者がAmazonへ出品している商品の情報が含まれる、5種類の出品レポートのリクエストおよびダウンロードが可能です。Amazon MWS レポートAPIリファレンスの説明では、レポートタイプのどれを指定すれば、どの種類の出品レポートの取得が可能は分かりづらいという意見がありましましたので、この場を借りてサンプルを含めて詳しく説明させていただきたいと思います。手順は以下通りです。
- RequestReport オペレーションを使用してレポートリクエストを送信します。 ※注文レポートと違い出品レポートは定期的なスケジュールは設定できません。
出品レポートを取得するため、RequestReport オペレーションのReportTypeパラメータに次のいずれかを指定します：
- _GET_FLAT_FILE_OPEN_LISTINGS_DATA_
- _GET_MERCHANT_LISTINGS_DATA_
- _GET_MERCHANT_LISTINGS_DATA_LITE_
- _GET_MERCHANT_LISTINGS_DATA_LITER_
- _GET_MERCHANT_CANCELLED_LISTINGS_DATA_
- ReportRequestListByIdパラメータにReportRequestIdを指定し,GetReportRequestList オペレーションのリクエストを送信します。Amazon MWSによってレポートリクエストのステータスが_DONE_ に設定されると、レポートを取得する準備ができ、GeneratedReportIdが作成されます。ステータスが_DONE_になるまで、GetReportRequestListオペレーションの送信を繰り返します。
- 取得したいレポートのGeneratedReportId をリクエストに含め、GetReport オペレーションのリクエストを送信します。Content-MD5 ヘッダを処理してレポートが送信中に破損していないことを確認します。検証が成功すれば、出品レポートの取得が完了します。レポートの取得作業の詳細については、Amazon MWSのポータルサイトより Amazon MWS 開発者ガイドをご参照ください。
出品レポート別ReportTypeの一覧
※「出品中の商品レポート」つまり、数量が0より大きい出品中の商品レポートを取得する際にはレポートタイプ_GET_MERCHANT_LISTINGS_DATA_LITE_および_GET_MERCHANT_LISTINGS_DATA_LITER_ を指定してRequestReport オペレーションを送信してください。
_GET_FLAT_FILE_OPEN_LISTINGS_DATA_
タブ区切りのフラットファイル形式の出品中の商品レポートで、SKU、ASIN、価格、数量欄を含みます。
例：
sku asin price quantity GOLFCLUB003 B002GX4M62 1 1 GOLFCLUB004 B002GXA5WW 2 1 GOLFCLUB005 B002GXA5O0 3 1 GOLFCLUB006 B002GX8BE6 4 1
_GET_MERCHANT_LISTINGS_DATA_
最大50,000件までの詳細な出品中の商品レポートで商品名、出品ID、出品者SKU、価格、数量、出品日、商品IDタイプ、コメント、コンディション、国外へ配送可、商品ID、在庫数およびフルフィルメント・チャンネル含み、タブ区切りのフラットファイル形式で提供されます。
例：
商品名 出品ID 出品者SKU 価格 数量 出品日 商品IDタイプ コメント コンディション 国外へ配送可 商品ID 在庫数 フルフィルメント・チャンネル 【軽量シャフトモデル】スポルディング ゴルフ ハイボール SE 単品アイアン （#4） アポロ カーボンシャフト #8/R [その他] 0621INPY1AQ GOLFCLUB003 1 1 2011/06/21 19:53:46 JST 1 11 B002GX4M62 0 DEFAULT 【軽量シャフトモデル】スポルディング ゴルフ ハイボール SE 単品アイアン （#4） アポロ カーボンシャフト #8/SR [その他] 0621INPY38Q GOLFCLUB004 2 1 2011/06/21 19:53:47 JST 1 11 B002GXA5WW 0 DEFAULT 【軽量シャフトモデル】スポルディング ゴルフ ハイボール SE 単品アイアン （#4） アポロ カーボンシャフト #4/R [その他] 0621INPY50W GOLFCLUB005 3 1 2011/06/21 19:53:50 JST 1 11 B002GXA5O0 0 DEFAULT 【軽量シャフトモデル】スポルディング ゴルフ ハイボール SE 単品アイアン （#4） アポロ カーボンシャフト #4/SR [その他] 0621INPY8L8 GOLFCLUB006 4 1 2011/06/21 19:53:52 JST 1 11 B002GX8BE6 0 DEFAULT
_GET_MERCHANT_LISTINGS_DATA_LITE_
タブ区切りのフラットファイル形式で提供される、数量が0より大きい出品中の商品レポートで、SKU、ASIN、価格、数量欄を含みます。50,000 件以上出品している場合、本レポートを使用できます。
例：
出品者SKU 数量 価格 商品ID GOLFCLUB004 1 2 B002GXA5WW GOLFCLUB005 1 3 B002GXA5O0 GOLFCLUB006 1 4 B002GX8BE6 GOLFCLUB007 1 5 B002GX4LYA
_GET_MERCHANT_LISTINGS_DATA_LITER_
タブ区切りのフラットファイル形式で提供される、数量が0より大きい出品中の商品レポートで、SKUと数量欄のみを含みます。50,000件 以上出品している場合、本レポートを使用できます。
例：
出品者SKU 数量 GOLFCLUB004 1 GOLFCLUB005 1 GOLFCLUB006 1 GOLFCLUB007 1
_GET_MERCHANT_CANCELLED_LISTINGS _DATA_
タブ区切りのフラットファイル形式で提供される、 キャンセルされた出品のレポートで、商品名、出品者SKU、価格、数量、商品IDタイプ、コメント、コンディション、国外へ配送可および商品IDを含みます。現在のところ、マーケットプレイス出品者のみに提供されています。
例：
商品名 出品者SKU 価格 数量 商品IDタイプ コメント コンディション 国外へ配送可 商品ID ONE PIECE -10th ANNIVERSARY- MOVIE LOG BOX (ワンピース・ムービーログボックス) 2007年 4/10号 [雑誌] ONEPIECE141234 300 1 1 未開封品です。雑誌の角に若干折れがございます。迅速かつ丁寧な発送を致します。是非ご検討ください。 11 11 B000NCJMK4 ケロロ軍曹 (11) 【初回完全限定版】 アクションケロロパック by 吉崎 観音 KERORO1234 200 1 1 未開封品です。雑誌の角に若干折れがございます。迅速かつ丁寧な発送を致します。是非ご検討ください。 11 11 4049007711
