API(AmazonMWS)で、注文された商品のコンディション・コメントを取得する方法を説明します。注文に対する納品書の発行システムを作成する際には、コンディションやコメントの取得が必要となります。注文データの取得方法AmazonMWSで注文された商品は、ListOrdersと、ListOrderItemsのAPIを使用して取得します。APIは注文の一覧を取得します。住所や合計金額は分かりますが、どの商品が購入されたかの内訳は本APIでは取得できません。APIをコールする事で取得可能です。ListOrderItemsでは、商品明細(SellerSKU,ASIN,Title等)を取得する事が可能となっています。残念ながら商品のコンディション・コメントまでは取得できません。注文された商品のコンディション・コメントが欲しい場合は、予めダウンロードされた「出品詳細レポート」から出品者SKU(SellerSKU)をキーに、上記の情報を取得します。出品詳細レポートをMWSのAPIで取得する場合、RequestReport,GetReportのAPIを使用します。APIRequestReportは「出品詳細レポート」に限らず、大量の情報一覧をTSV形式のレポートとして取得可能なAPIです。RequestReportリクエストのAPIの呼び出し制限は30req/1時間となっています。APIでは、どの種類のレポートが欲しいかをReportTypeで指定します。ReportTypeとして指定可能なのは以下の5つです。_GET_MERCHANT_CANCELLED_LISTINGS_DATA_各レポートの情報はTSV形式で取得できます。取得できる情報の概要とTSVの列一覧は以下の通りです。quantity_GET_MERCHANT_LISTINGS_DATA_最大50,000件までの詳細な出品中の商品レポート。フルフィルメント・チャンネル_GET_MERCHANT_LISTINGS_DATA_LITE_在庫を持つ出品データの一覧(=出品数が1以上の商品一覧)。50,000件以上出品している場合に使用可能。商品ID_GET_MERCHANT_LISTINGS_DATA_LITER_出品中商品のSKUと数量だけの一覧。LITERの文字通り_GET_MERCHANT_LISTINGS_DATA_LITE_よりさらに軽い情報のみが取得できる。商品ID上記の一覧から分かるように、商品のコンディション・コメントを取得する場合は、ReportTypeに_GET_MERCHANT_LISTINGS_DATA_を指定します。データはリアルタイムではなくバッチで作成されるので、リクエストのレスポンスで上記の情報を取得する事はできません。レスポンスでは、以下の2点をチェックします。APIを使用して確認します。APIのレスポンスとしてサーバからもらった値をそのままセットします。レスポンスとして、ReportRequestInfoが返されるので、この値が_DONE_であれば、サーバ側でレポートの作成が完了した事になります。作成されたレポートのレポートIDを取得するレポートが作成された事が分かったので、早速ダウンロードしたいのですが、その前に作成されたレポートのIDを取得する必要があります。APIをコールする事で取得可能です。ReportRequestIdを渡してあげると、ReportIdを取得できます。パラメータとしてReportIdを指定します。(ReportRequestIdではないので注意)結果として、TSV区切りのテキストが取得できます。APIの呼び出し制限は60req/1時間です。まとめというわけで、注文された商品のコメントを取得するためには複数のAPIをコールする必要があります。呼び出すべきAPIの順序と、各APIの主だったリクエストキー、レスポンス情報をまとめると以下の流れになります。実際には他にも必要なリクエストKeyや応答項目が有りますし、APIによっては検索キーとして下記以外の項目を使用することも可能ですが、ここでは流れを分かりやすくするため省略しています。詳細はAPI仕様書を参照してください。コメント、コンディションetcの情報びっくりする事に、たかだかコメント/コンディション情報を取るだけの為に6つもAPIをコールする必要がありました。SellerSKU指定で1品分の出品明細が取得できるシンプルなAPIが有れば便利なのに...と思うところです。コメントをキャンセルメールアドレスが公開されることはありません。29お勧め書籍webアプリのセキュリティ対策の為に。