# 楽天RMS連携設定

> 共通設定

楽天市場の注文をRecustomerに取り込むために、楽天RMSと連携します。

1. [楽天RMSでアプリを登録する](#1-楽天rmsでアプリを登録する)

2. [Recustomerで認証する](#2-recustomerで認証する)

3. [ライセンスキーを更新する](#3-ライセンスキーを更新する)

4. [楽天RMS連携でのプロダクトのご利用について](#4-楽天rms連携でのプロダクトのご利用について)

> **注意: ライセンスキーは90日ごとに更新が必要です**
>
> 楽天RMSのライセンスキーの有効期限は90日です。期限が切れると楽天から注文を取り込めなくなります。Recustomerの管理画面には有効期限が表示されず、期限切れの通知も届かないため、期限が切れる前に「[3. ライセンスキーを更新する](#3-ライセンスキーを更新する)」の手順で更新してください。

## 1. 楽天RMSでアプリを登録する

1. Rakuten RMSにログインし、「店舗様向け情報・サービス」→「6 WEB APIサービス」へ移動します

   ![RMSのメニューで「店舗様向け情報・サービス」から「6 WEB APIサービス」を選択する](images/02c8_rakuten-webapi-menu.png)

2. 左メニューの「2-2 アプリ登録」をクリックし、アプリを登録します

   ![RMS WEB SERVICEの左メニュー。アプリ未作成の場合は「2-2 アプリ登録」、作成済みの場合は「2-1 アプリ一覧」を開く](images/02c8_rakuten-app-register.png)

   ※すでにアプリを登録済みの場合は、新しく登録せずに「2-1 アプリ一覧」から登録済みのアプリを開き、手順3に進んでください

3. アプリ詳細情報の画面下部にある「利用機能編集」をクリックします

4. 下記の機能の「利用する」にチェックを入れて保存します

      | API | 機能 | Recustomerでの用途 | 必要な場合 |
   | --- | --- | --- | --- |
   | 楽天ペイ受注API（RakutenPay_OrderAPI） | rpay.order.searchOrder | 取り込む注文を検索する | **必須** |
   | 楽天ペイ受注API（RakutenPay_OrderAPI） | rpay.order.getOrder | 注文の詳細（購入者・注文商品・配送先）を取得する | **必須** |
   | 店舗情報API（ShopAPI） | shop.shopMaster.get | 店舗URLを取得する（商品画像の表示に使います） | **必須** |
   | 商品API 2.0（ItemAPI 2.0） | itemapi_2.0.items.search | 商品名・商品画像・バリエーション（SKU）を取得する | **必須** |
   | 楽天ペイ受注API（RakutenPay_OrderAPI） | rpay.order.cancelOrder | キャンセル申請を楽天の注文に反映する | キャンセルをご利用の場合 |
   | 在庫API 2.1（InventoryAPI 2.1） | inventories.bulk.get_2.1 | 交換先の在庫数をまとめて参照する | 交換をご利用の場合 |
   | 在庫API 2.1（InventoryAPI 2.1） | inventories.variants.get_2.1 | 交換先SKUの在庫数を参照する | 交換をご利用の場合 |
   | 在庫API 2.1（InventoryAPI 2.1） | inventories.variants.upsert_2.1 | 交換先SKUの在庫を引き当てる | 交換をご利用の場合 |
   

   ※後からキャンセルや交換を使い始める場合は、その時点で該当の機能を追加してください。機能を追加・解除すると新しいライセンスキーが発行されるため、手順2の認証を新しいライセンスキーでやり直す必要があります

5. 「ライセンスキーの確認・変更」をクリックし、表示された文字列を入力して「確認する」をクリックします

6. 「最新の利用情報」に表示されるserviceSecretとライセンスキーを控えます

   ![アプリ詳細情報の「最新の利用情報」。serviceSecretとライセンスキーを控える。ライセンスキーの右に有効期限が表示される](images/02c8_rakuten-license-key.png)

   ※ライセンスキーの右に表示される「有効期限」も控えておくと、更新の時期を管理しやすくなります

## 2. Recustomerで認証する

1. [設定 > 外部サービス連携 > 連携サービス > 楽天RMS](https://rcmr.io/settings/integrations/integration/externals/rakuten-rms) へ移動します

   ![連携サービスの一覧で「楽天RMS」を選択する](images/02c8_rakuten-recustomer-menu.png)

2. 手順1で控えた値を入力し、「認証する」ボタンを押します

   | 項目 | 入力する値 |
   | --- | --- |
   | serviceSecret | 手順1-6で控えたserviceSecret |
   | licenseKey | 手順1-6で控えたライセンスキー |

   ![楽天RMSの連携設定画面。serviceSecretとlicenseKeyを入力して「認証する」ボタンを押す](images/02c8_rakuten-recustomer-auth.png)

3. 「認証済み」ステータスになっていると成功です

4. [データ連携カスタマイズ](./data-import.html)で、注文の取り込み元に「RAKUTEN_RMS」を指定します

### 注文の取り込みについて

- 新しい注文は30分ごとに取り込まれます。取り込み済みの注文のステータス（発送・キャンセルなど）は1時間ごとに更新されます

- 取り込まれるのは、連携した時点からおよそ1時間前以降に受け付けた注文です。それより前の注文は取り込まれません

## 3. ライセンスキーを更新する

ライセンスキーの有効期限（90日）が切れる前に、次の手順で更新します。

1. Rakuten RMSの「店舗様向け情報・サービス」→「6 WEB APIサービス」→「2-1 アプリ一覧」から、登録済みのアプリを開きます

2. 「最新の利用情報」のライセンスキーの「ライセンスキーの変更」をクリックします

   ![アプリ詳細情報の「最新の利用情報」。ライセンスキーの行の「ライセンスキーの変更」をクリックする](images/02c8_rakuten-key-change.png)

3. 「新しいライセンスキーを発行」をクリックします

   ![ライセンス情報の画面。「新しいライセンスキーを発行」をクリックする](images/02c8_rakuten-key-new.png)

4. アプリ詳細情報の「最新の利用情報」に表示される新しいライセンスキーを控えます

5. [設定 > 外部サービス連携 > 連携サービス > 楽天RMS](https://rcmr.io/settings/integrations/integration/externals/rakuten-rms) で、licenseKeyを新しいライセンスキーに変更し、「認証する」ボタンを押します

   ※serviceSecretは変わりません。手順1で控えた値をそのまま入力してください

6. 古いライセンスキーを停止します。「過去の利用情報」にある古いライセンスキーの「ライセンスキーの変更」から「利用停止」をクリックしてください

   ※古いライセンスキーが利用中のままだと、次回の更新時に新しいライセンスキーを発行できません。必ず手順5でRecustomerの認証を済ませてから停止してください

## 4. 楽天RMS連携でのプロダクトのご利用について

| プロダクト | 楽天RMS連携での動作 |
| --- | --- |
| 返品・交換 | 交換は、同じ商品の別のバリエーション（サイズ・カラーなど）への交換のみ受け付けられます。交換を承認すると交換先SKUの楽天の在庫が引き当てられますが、楽天に交換用の注文は作成されません。交換品の発送はストア様にて行ってください |
| キャンセル | キャンセルが承認されると、楽天の注文がキャンセルされます（キャンセル理由は「お客様都合」）。キャンセルできるのは発送前の注文の全体のみです。在庫を戻すかどうかは楽天の商品設定に従います |
| 返金 | 楽天の注文は自動返金に対応していません。返金方法には「PSP画面」（RMSでの返金作業）または「銀行振込」を設定してください（→ [決済方法（Key）の確認方法](./payment-key.html#楽天rms)） |