【R-とるく】楽天ペイ-APIモードについて  2018/05/15

Ver.5.00 以降に[UPDATE]してご利用ください。

【R-とるく】楽天ペイ-APIモードは,これまでのIEによるページ解析ではなくRMSサーバーと
直接データのやり取りをするAPIを実装することで処理時間の大幅な短縮を実現しました。

APIモードは[楽天ペイ受注]専用です。[従来受注]の処理はIEモードでのみ実行できます。
※RMSのAPI(WEB APIサービス)は無料でご利用いただけます。

【R-とるく】楽天ペイ-APIモードを利用するメリット
・処理が格段に高速化します。
・IEでは取得できないデータも取得できます。
※最下部[■IEモードで取得したデータによるRMS楽天ペイ仕様のCSV書出について]参照

【R-とるく】楽天ペイ-APIモードを利用するデメリット
・初期設定と90日ごとの更新作業が必要です。
※下記[■使い方■]参照

【R-とるく】楽天ペイ-APIモードご利用上の注意
IEモードでダウンロードした受注データとAPIモードでダウンロードした受注データに互換性がありません
[APIモードでダウンロード]-[CSV書出]-[発送処理]した受注データは[APIモードでダウンロード]した(し直した)受注データにのみ
[CSV読込]が可能です。
[IEモードでダウンロード]-[CSV書出]-[発送処理]した受注データは[IEモードでダウンロード]した(し直した)受注データにのみ
[CSV読込]が可能です。

[ダウンロード]実行時には[API/IE]のモードを選択できますが[RMS反映]実行時は【R-とるく】が自動判別し,モードの変更はできません。

■使い方■

[初期設定]

1:利用申請

※下記利用申請を完了しserviceSecret(サービスシークレット)とlicenseKey(ライセンスキー)取得後,
RMS側のAPIサーバーの準備に若干の時間(10〜30分程度)を要するようです。ご留意ください。


RMSのAPI機能は無料でご利用いただけますが申請が必要です。まだご利用になったことがない店舗様は,
[RMSメインメニュー]-[拡張サービス一覧]-[WEB APIサービス]-[2:利用設定]の[2-1WEB API]
から申請してください。



申込が完了すると同じページにserviceSecret(サービスシークレット)とlicenseKey(ライセンスキー)が表示されます。



2:利用機能編集
上の画像の[利用機能編集]ボタンをクリックしてください。
[利用機能編集]画面が開きます。



【R-とるく】が利用する機能4つにチェックを入れてください。

rpay.order.getOrder [受注データダウンロード](一覧取得)で使用します。
rpay.order.searchOrder [受注データダウンロード](詳細情報取得)で使用します。
rpay.order.updateOrderShipping [配送情報RMS反映]で使用します。

rpay.order.confirmOrder [注文確認](機能追加予定)で使用します。

[確認する]ボタンクリック->[登録する]ボタンをクリックします。

[更新作業]

※下記更新作業を完了しserviceSecret(サービスシークレット)とlicenseKey(ライセンスキー)取得後,
RMS側のAPIサーバーの準備に若干の時間(10〜30分程度)を要するようです。ご留意ください。


licenseKeyの有効期限は90日です。有効期限経過後は,同じく
[RMSメインメニュー]-[拡張サービス一覧]-[WEB APIサービス]-[2:利用設定]の[2-1WEB API]
から更新(新しいライセンスキーを発行)してください。






3:【R-とるく】初期設定
WEB API 初期利用設定または更新作業後,【R-とるく】でserviceSecret/licenseKeyを取得します。
[初期設定]ボタンをクリックしてください。



[更新]ボタンを押すとIEでRMSにログインしてserviceSecret/licenseKey,有効期限を取得します。
事前に有効なログイン情報の登録が必要です。
R-Login ID/パスワード,ユーザーID/パスワードを[保存]してからご利用ください。



有効なserviceSecret/licenseKeyの取得が完了すると【R-とるく】の[受注データダウンロード]で
[楽天ペイ受注]の[API]が使えるようになります。




IEモードで取得したデータによるRMS楽天ペイ仕様のCSV書出について

IEモードでダウンロードした受注データの[RMS楽天ペイ仕様CSV]書出においては
IE画面から取得できるデータの制限および開発環境等の都合により
下記項目のデータが欠落あるいは不完全です。

・サブステータスID
・キャンセル期限日
・注文確認日時
・注文確定日時
・発送完了報告日
・注文種別
・楽天確認中フラグ
・購入履歴修正有無フラグ
・クーポン発行元
・申込番号
・申込お届け回数
・商品明細ID
・医薬品受注フラグ
・楽天スーパーDEAL商品受注フラグ
・各日時の[秒]

運送各社向けCSVデータに必要な項目はIEモードでもすべて取得できます。

不具合,ご要望はお気軽にご連絡ください。