楽天APIについて

Question

いつもお世話になっております。

自社開発で、受注情報を取得しようとしているのですが、一度楽天のAPI担当の部署へ
問い合わせをしたものの、楽天さんが、公表するのは、rms上のAPIに関する説明書だけで、
それ以外は全く公開しないということで、それ以外は公開しないようで
ネットで調べても、これといって参考になる情報もなく

調査している時間がもったいないのです。
手順は面倒ですが、.netのwebbrowserから、手入力した時と同じ動作でログインから受注詳細情報まで
表示している情報から必要な部分を取り込むような仕掛けを作成し、運用しております。

今回、機能追加をしようとしているのですが、現行プログラムが複雑怪奇化しているので、
もし可能であれば、APIを利用してプログラムの簡略化も図れればと思っております。

c#　または VB.net で楽天から受注情報取り込むようなサンプルで結構なので
教えてもらうことはできないでしょうか？
楽天さんはJAVAのみ推奨と狭いこと言われておりますが、ヒントでも結構ですので、
何らかの、突破口を見出したいです。

ご教授、おねがい致します。

Accepted Answer

ECマスターズの田中です。

私の環境でも同じエラーが発生したため、調べたところ、
同じエラーに関する中文の掲示板記事にて、
解決方法が記載されておりました。
http://bbs.csdn.net/topics/370050426

記事の最後にあるスクリーンショットの通り、
ソリューションエクスプローラーのツールバーから
「すべてのファイルを表示」ボタンを押していただき、

（アプリケーション）→ Web Referrences → jp.co.rakuten.rms.api → Reference.map → Reference.cs

を開き、「nominateUnEnclosureModel」で検索していただき、

private string[][] nominateUnEnclosureModelField;
を
private string[] nominateUnEnclosureModelField;
に、

public string[][] nominateUnEnclosureModel {
を
public string[] nominateUnEnclosureModel {
に、

それぞれご変更の上、上書き保存していただきますと、
エラーが発生しなくなりますので、
改めてプログラムの動作をご確認いただきますようお願いいたします。

Answer

ECマスターズの田中です。

楽天APIをC#で操作したサンプルを公開しているページがありますので、
下記URLをご参照ください。
http://d.hatena.ne.jp/nagakura_eil/20080201/1201870427

こちらのサンプルを、受注APIに合わせて変更していただくことで
操作が可能になると思います。

下記URLに記載されている受注APIの詳細情報を確認したところ、
https://webservice.rms.rakuten.co.jp/merchant-portal/view?page=document0046
WEB参照のURLを
https://api.rms.rakuten.co.jp/es/1.0/order/ws?WSDL
にご変更いただき、
サンプル中のクラス名・インスタンス名・メソッド名を、受注APIに合わせてご変更いただくことで
操作ができるようになると思いますので、
お手持ちのC#構築環境で、動作をお試しいただけますでしょうか。

Answer

田中様
お世話になります。
紹介いただきました、ページで、確認していたのですが。
楽天さんのサンプルと、楽天さんのパラメータを紹介している
https://webservice.rms.rakuten.co.jp/merchant-portal/view?page=document0047
上記のアドレスで、引数と、実際のプログラム中で、どう結びつくのかが
理解に苦しんでおります。
例えば：getOrder
arg0,arg1へ引数を渡すのでしょうが、arg=0には、userAuthModelの内容
arg1にはgetOrderRequestModelの内容
では、getOrderRequestModelの内容と楽天さんのdocument0047に記載されている
リクエストする内容は、どこへ設定すればいいのでしょうか？
お手数ですが、ご教授お願いいたします。

Answer

ECマスターズの田中です。

＞arg=0には、userAuthModelの内容
＞arg1にはgetOrderRequestModelの内容

はい、それぞれ各クラスのインスタンスを引数にご設定ください。

＞getOrderRequestModelの内容と楽天さんのdocument0047に記載されている
＞リクエストする内容は、どこへ設定すればいいのでしょうか？

最初に、getOrderRequestModelのインスタンスを作成していただき、
document0047に記載の「物理名」のプロパティに、
各リクエストの名前を設定していただく形になります。
なお、「Lv」は入れ子の数を示しており、
1増えている場合は、直前の項目の中に含まれることを意味します。

たとえば、受注番号で検索する場合は、

===== この下の行から ================
getOrderRequestModel orderreq = new getOrderRequestModel();
orderreq.orderNumber = new string[] { "123456-78901234-5678901234","567890-1234567-8901234567" };
===== この上の行まで ================

のように、受注番号の配列を渡す形に、
受注検索モデルで検索する場合は、さらにorderSearchModelのインスタンスを作り、

===== この下の行から ================
getOrderRequestModel orderreq = new getOrderRequestModel();

orderSearchModel ordersearch = new orderSearchModel();
ordersearch.dateType = 1;
ordersearch.startDate = DateTime.Today.AddDays(-5);
ordersearch.endDate = DateTime.Today;

orderreq.orderSearchModel = ordersearch;
===== この上の行まで ================

のように、orderSearchModelプロパティに、orderSearchModelのインスタンスを設定する、
という形になります。

Answer

ECマスターズ　田中様
ご回答ありがとうございます。

何度も質問させていただき、申訳ありません。

前回、ご回答頂きました内容で、作業を進めております。

APIの発効タイミングなのですが、xmlファイルが作成された時点で
楽天へリクエスト送信されているのでしょうか？

リクエスト送信後、レスポンスについて
成功したのか、失敗したのか確認方法、
成功時の、レスポンスの取り方も、ご教授いただけないでしょうか

よろしくお願いいたします。

Answer

ECマスターズの田中です。

＞APIの発効タイミングなのですが、xmlファイルが作成された時点で
＞楽天へリクエスト送信されているのでしょうか？
https://webservice.rms.rakuten.co.jp/merchant-portal/view?page=document0046
に掲載されている、OrderApiServiceのインスタンスの各メソッド（getOrderなど）が
実行された際に、リクエスト送信が行われます。

＞リクエスト送信後、レスポンスについて
＞成功したのか、失敗したのか確認方法、
上記document0046の「4.2.3. アプリケーションの実装」の例をご参考いただき、

res.errorCode != null && res.errorCode.Equals("N00-000")
（※resは、GetOrderResponseModel型のインスタンスとします）

のような条件で、成功・失敗をご判断ください。
（上の例の場合、trueだと成功、falseだと失敗となります）

＞成功時の、レスポンスの取り方

getOrderメソッドの結果を代入したGetOrderResponseModel型の変数の中に、
レスポンスの内容が記録されております。

たとえば、

OrderApiService oas = new OrderApiService();

とした場合、一つの結果を受け取る場合は

res = oas.getOrder(auth, getorderrequest);
（※authはuserAuthModel型、getorderrequestはgetOrderRequestModel型のインスタンスです）

のようにして、resに代入することで、

res.orderModel[0].goodsPrice

として、検索結果１つ目の注文の商品合計金額を取得することができます。

レスポンスに含まれる他のデータの取得方法は、今一度
https://webservice.rms.rakuten.co.jp/merchant-portal/view?page=document0047
の「2. レスポンス」をご確認ください。

Answer

田中様
お世話になります。

インスタンス作成時に
OrderApiService oas = new OrderApiService();
上記のように、記載されていますが、こちらでは
new OrderApiService();　を設定することができないのですが
そもそも、参照設定などが、間違えているのでしょうか？
new .... OrderApiServiceClientは表示されます。

よろしくお願いいたします。

Answer

ECマスターズの田中です。

私の環境では、確かに
OrderApiService oas = new OrderApiService();
で、インスタンスの作成ができておりますので、
参照設定が正しくできていない可能性があります。

参考までに、私の導入した
「Microsoft Visual Studio Community 2015」で行った
参照設定の手順をご案内いたします。

ソリューションエクスプローラーでプロジェクト名を右クリック
＞ 追加
＞ サービス参照
＞ 詳細設定
＞ Web 参照の追加
＞ URLに「https://api.rms.rakuten.co.jp/es/1.0/order/ws?WSDL」を記載してEnterキー
＞ 参照の追加

参照設定後、ソースに
using (プロジェクト名).jp.co.rakuten.rms.api;
と記載することで、各クラスが利用できるようになっていれば
正しく参照設定が行われております。

Answer

田中様
ご指導ありがとうございます。
開発環境を「Microsoft Visual Studio Community 2015」を導入し
新規プロジェクトから、参照設定を行い、ソースを移行しました。
編集中の画面では、お教えいただいた通り、エラーは表示はありませんでした。

しかしながら、実行を行うと
===========================
型 'System.InvalidOperationException' のハンドルされていない例外が System.Xml.dll で発生しました

追加情報:一時クラスを生成できません (result=1)。

error CS0030: 型 'string[]' を型 'string' に変換できません。
===========================
上記エラーが発生します。
これは、何か他に設定しておかないと、エラーが発生するのでしょうか？

Answer

ECマスターズの田中です。

ソースコードを確認する必要があるのですが、
エラーメッセージの通り、エラーの発生した場所で、
string型の変数に対して、string型の配列型のデータを
代入しようとされてはいないでしょうか。
ご確認をお願いします。

Answer

田中様

エラーだけ記載し問い合わせし、申訳ありません。
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
      private void button1_Click(object sender, EventArgs e)
        {
            OrderApiService iss = new OrderApiService();
        }
＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝
これだけでも、前回問い合わせいたしました、同じエラーは発生します。

Answer

田中様
ありがとうございました。
無事、Responseまで、通す事ができました。
本当にありがとうございました。