# ecforce連携設定

> STEP 2-3

## 1. ecforceにてAPI接続用の認証トークンを発行する

1. ecforceの管理者画面にログインします

2. 設定を変更する > メンバー/権限 > メンバーの管理 の「設定する」をクリックします

3. 「新規作成」ボタンから、API接続用ユーザを作成します

   ※「ロール」には、adminなど、APIのアクセス権が有効になっているロールを選択してください

   ![ecforceのメンバー新規作成画面。APIのアクセス権が有効なロールを選択します](images/02c_ecforce-member-create.png)

4. メンバー管理の画面に戻り、3にて作成したユーザを検索します

5. 検索結果に表示されたAPI接続用ユーザの「詳細」をクリックします

   ![メンバー管理の検索結果。API接続用ユーザの「詳細」をクリックします](images/02c_ecforce-member-detail.png)

6. 詳細画面の中の、「API 認証トークン」の「更新」ボタンをクリックします

   ![詳細画面の「API 認証トークン」。「更新」ボタンをクリックします](images/02c_ecforce-token-update.png)

7. API認証トークンが発行されるので、値をコピーします

◼️参考情報：[API接続用のユーザ作成方法と認証トークン（アクセストークン）発行方法を教えてください（ecforceサポート）](https://support.ec-force.com/hc/ja/articles/4411457389593)

## 2. Recustomerへのキー入力

![ecforceとの連携設定画面（認証タブ）](images/02c_ecforce-key-overview.png)

1. Recustomerの 設定 > 外部サービス連携 > 連携サービス > ecforce へ移動します

   ![連携サービス一覧から「ecforce」をクリックします](images/02c_ecforce-service-click.png)

2. ドメイン、認証トークンにそれぞれ値を入力し、「認証する」をクリックします

   ![ecforceとの連携設定。ドメインと認証トークンを入力して「認証する」をクリックします](images/02c_ecforce-auth-input.png)

   | 項目 | 入力する値 |
   | --- | --- |
   | ドメイン | ecforceのドメインを入力します。ドメインはecforceの管理者画面にログインした時のURLに含まれます。 例：https://sample.ec-force.com/admin の場合「sample.ec-force.com」がドメインです |
   | 認証トークン | 1. の手順7でコピーした「API 認証トークン」を入力します |

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

   ![ecforceのステータスが「認証済み」になっていれば成功です](images/02c_ecforce-authenticated.png)

## 3. 注文ステータスのマッピング

1. ストア設定 > 外部サービス連携 > ecforce を選択 > 認証 > 注文ステータスのマッピング へ移動し、Recustomerの注文ステータスとecforceの「対応状況」をマッピングします

   ![注文ステータスのマッピング画面](images/02c_ecforce-status-mapping.png)

   > **注意: 注意**
   >
   > 本設定にて登録されていない対応状況の注文は、Recustomerで情報を取得することができません。そのため、全ての「対応状況」を、キャンセル済み・発送処理中・発送済みのいずれかに登録するようにお願いいたします。

   | 項目 | 設定する内容 |
   | --- | --- |
   | キャンセル済み | ecforce上で「キャンセル済み」に該当する「対応状況」の名前（半角英数字）を入力 |
   | 発送処理中 | ecforce上で「発送処理中」（＝まだ発送していない）に該当する「対応状況」（半角英数字）を入力 |
   | 発送済み | ecforce上で「発送済み」（＝発送処理が完了している）に該当する「対応状況」（半角英数字）を入力 |

   ※1行に1つの対応状況を入力してください

▼ecforce上の対応状況の一覧は、以下の画面（設定を変更する > 受注/定期受注 > 対応状況の管理 > 設定する）より確認できます

![ecforceの対応状況の一覧画面](images/02c_ecforce-status-list.png)

## 4. 連携設定（キャンセル）

1. ストア設定 > 外部サービス連携 > ecforce を選択 > 連携設定 > キャンセル へ移動し、キャンセル時のecforce側の動きを設定します

   ![連携設定のキャンセルタブ](images/02c_ecforce-cancel-setting.png)

   | 項目 | 設定する内容 |
   | --- | --- |
   | キャンセル時の対応状況 | Recustomerからecforce上の注文を自動キャンセルする際にecforceに反映する「配送状況」 |
   | 除外する対応状況 | キャンセルを**受けたくない**「対応状況」。購入者がキャンセル申請を行った際、該当の注文がここに登録されている場合、**キャンセルを拒否**します |

▼ecforce上の対応状況の一覧は、以下の画面（設定を変更する > 受注/定期受注 > 対応状況の管理 > 設定する）より確認できます

![ecforceの対応状況の一覧画面](images/02c_ecforce-status-list.png)