# CROSSMALL連携設定

> 共通設定

1. [CROSSMALLで「認証鍵」と「会社コード」を取得する](#1-crossmallで認証鍵と会社コードを取得する)

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

3. [一般設定](#3-一般設定)

4. [注文ステータスのマッピング](#4-注文ステータスのマッピング)

5. [配送会社のマッピング（配送追跡をご利用の場合）](#5-配送会社のマッピング配送追跡をご利用の場合)

6. [キャンセル処理フェーズの設定（キャンセルをご利用の場合）](#6-キャンセル処理フェーズの設定キャンセルをご利用の場合)

7. [交換の設定（交換をご利用の場合）](#7-交換の設定交換をご利用の場合)

> **注意: 事前準備**
>
> CROSSMALL側で、Recustomerの以下のIPアドレスからのアクセスを許可していただく必要があります。
>
> - 52.199.155.223
>
> - 54.95.233.104
>
> - 57.180.95.90

## 1. CROSSMALLで「認証鍵」と「会社コード」を取得する

1. CROSSMALLにログインします

2. 画面右上の「会社コード」をコピーします

   ![CROSSMALLの画面右上に表示される会社コードをコピーします](images/02c_crossmall-company-code.png)

3. 「システム設定」の「基本情報」を開きます

   ![システム設定の「基本情報」を開きます](images/02c_crossmall-basic-info.png)

4. 「編集」をクリックします

   ![基本情報の画面。一番下までスクロールすると「編集」ボタンが表示されます](images/02c_crossmall-edit-button.png)

   ※ページの一番下までスクロールすると「編集」ボタンが表示されます

5. 「API設定」の「認証鍵」をコピーします

   ![「API設定」の「認証鍵」をコピーします](images/02c_crossmall-auth-key.png)

## 2. Recustomerで認証する

1. Recustomerの [設定 > 外部サービス連携 > 連携サービス > CROSSMALL](https://rcmr.io/settings/integrations/integration/externals/crossmall) へ移動します

2. 認証鍵と会社コードにそれぞれ値を入力し、「認証する」をクリックします

   ![CROSSMALLとの連携設定。認証鍵と会社コードを入力して認証します](images/02c_crossmall-auth-input.png)

   | 項目       | 入力する値                          |
   | ---------- | ----------------------------------- |
   | 認証鍵     | 1. の手順5でコピーした「認証鍵」    |
   | 会社コード | 1. の手順2でコピーした「会社コード」 |

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

## 3. 一般設定

1. 「一般」で、注文の取り込みに使う情報を設定します

   ![CROSSMALL連携の一般設定画面](images/02c_crossmall-general.png)

   | 項目                 | 設定する内容                                                                                                                                                      |
   | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | メールアカウント     | 交換注文をCROSSMALLに登録するときに使用するメールアカウントを入力します（「マスタ登録」の「メールアカウント」内にあるもの） ![CROSSMALL画面で登録されているメールアカウントを確認する方法](images/02c_crossmall-mail-account.png) |
   | CROSSMALL店舗コード  | Recustomerと連携したい店舗の店舗コードを登録します ![CROSSMALL画面で店舗コードを確認する方法](images/02c_crossmall-store-code.png)                 |

   > **注意: メールアカウントが見つからない場合**
   >
   > 交換の受付を利用する場合は、CROSSMALLで以下を準備してください。
   >
   > - 「マスタ登録」の「メールアカウント」で、交換注文を受信するためのメールアカウントを新規登録します
   > - 「システム設定」の「店舗情報」で、受信方法が「メール」の店舗があるか確認します。ない場合は店舗の追加が必要です。店舗の追加はCROSSMALLサポートでの開設作業が必要になる場合があるため、CROSSMALLへご相談ください
   >
   > 交換の受付を利用しない場合は、空欄のままで問題ありません。

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

1. 「注文ステータスのマッピング」で、Recustomerの注文ステータスとCROSSMALLの処理フェーズのマッピング設定を行います

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

   > **注意: 注意**
   >
   > ここで登録されていない処理フェーズの注文は、Recustomerに取り込まれません（Recustomerの各機能で注文を扱えなくなります）。すべての処理フェーズを、キャンセル済み・発送処理中・発送済みのいずれかに登録してください。

   | 項目         | 設定する内容                                                                     |
   | ------------ | -------------------------------------------------------------------------------- |
   | キャンセル済み | CROSSMALL上で「キャンセル済み」に該当する処理フェーズにチェック                   |
   | 発送処理中   | CROSSMALL上で「発送処理中」（＝まだ発送していない）に該当する処理フェーズにチェック |
   | 発送済み     | CROSSMALL上で「発送済み」（＝発送処理が完了している）に該当する処理フェーズにチェック |

   ▼CROSSMALL管理画面で「処理フェーズ」を確認する方法

   ![CROSSMALL管理画面で「処理フェーズ」を確認する方法](images/02c_crossmall-phase-list.png)

## 5. 配送会社のマッピング（配送追跡をご利用の場合）

※この手順は、**配送追跡をご利用の場合のみ**必要です。配送追跡をご利用でない場合はスキップしてください

1. 「配送会社のマッピング」で、Recustomerの配送会社とCROSSMALLの配送会社のマッピング設定を行います

   ![配送会社のマッピング画面。ヤマト運輸・佐川急便・日本郵便それぞれに、CROSSMALLの配送方法のコードを「行を追加」から登録します（例：ヤマト運輸に001と002、佐川急便に013）](images/02c_crossmall-carrier-mapping.png)

   | 項目       | 設定する内容                                             |
   | ---------- | -------------------------------------------------------- |
   | ヤマト運輸 | CROSSMALL上で「ヤマト運輸」に該当する配送方法のコードを登録 |
   | 佐川急便   | CROSSMALL上で「佐川急便」に該当する配送方法のコードを登録   |
   | 日本郵便   | CROSSMALL上で「日本郵便」に該当する配送方法のコードを登録   |

   ▼CROSSMALL管理画面で配送会社のコードを確認する方法

   ![CROSSMALL管理画面の「マスタ登録」>「名称マスタ」で名称タイプに「配送方法」を選ぶと、配送方法ごとのコードの一覧を確認できます](images/02c_crossmall-carrier-code.png)

## 6. キャンセル処理フェーズの設定（キャンセルをご利用の場合）

※この手順は、**キャンセルをご利用の場合のみ**必要です。キャンセルをご利用でない場合はスキップしてください

1. [設定 > 外部サービス連携 > 連携サービス > CROSSMALL](https://rcmr.io/settings/integrations/integration/externals/crossmall) > 連携設定 タブに移動し、「キャンセル処理フェーズの設定」でキャンセル時のCROSSMALL側の動きを設定します

   ![キャンセル処理フェーズの設定画面](images/02c_crossmall-cancel-phase.png)

   | 項目 | 設定する内容 |
   | --- | --- |
   | キャンセル時の処理フェーズ | CROSSMALL上の伝票を自動キャンセルした時に、キャンセル後の該当伝票に反映する処理フェーズ |
   | 除外する処理フェーズ | キャンセルを**受けたくない**処理フェーズ。購入者がキャンセル申請を行った時、該当の伝票がここに登録されている場合、**キャンセルを拒否**します |

## 7. 交換の設定（交換をご利用の場合）

※この手順は、**交換をご利用の場合のみ**必要です。交換をご利用でない場合はスキップしてください

交換先の在庫を参照して購入者に選ばせる設定と、交換品の在庫を確保する交換伝票の設定です。交換伝票は商品金額0円で発行されるため、請求を発生させずに在庫を確保できます。発行された伝票は通常の注文と同じ流れで出荷できます。

> **注意: 交換の対象にする商品には、SKU（商品コード）の設定が必須です**
>
> 交換伝票は、SKUをキーにしてCROSSMALLへ連携されます。SKUが未設定の商品は交換伝票の作成に失敗します。

1. [設定 > 外部サービス連携 > データ連携カスタマイズ](https://rcmr.io/settings/integrations/integration/target) の「交換・キャンセル」タブで、Get Product Variants（在庫の参照先）と Create Exchange Order（交換伝票の発行先）に CROSSMALL を指定して保存します（[データ連携カスタマイズ](./data-import.html)）

   ※在庫の参照先（Get Product Variants）と注文の取り込み元（Order Importer）には、同じシステムを指定してください。異なるシステムを指定すると、交換先の商品が正しく表示されません

2. [設定 > 外部サービス連携 > 連携サービス > CROSSMALL](https://rcmr.io/settings/integrations/integration/externals/crossmall) > 連携設定 タブの「交換」で設定します

   | 項目 | 設定する内容 |
   | --- | --- |
   | 在庫の参照 | 交換の際に在庫を参照し、在庫がある場合のみ、お客様に選択を許可します。在庫がない場合は「在庫切れ」と表示します |
   | 交換商品の受注伝票を作成する | 交換商品の在庫を確保するために、API経由で受注伝票を作成します |
   | 交換伝票の発行方法 | 「承認ステータスが承認済みに変化した時点で自動で作成」または「交換処理ページで手動で入力」を選びます |
   | 交換伝票の受注コード | 交換伝票の受注コードに付けるプリフィックス・サフィックスを指定します |
   | 配送方法 | 「元の注文の配送方法を参照する」または「配送方法を指定する」を選びます |
   | 支払方法 | 「元の注文の支払方法を参照する」または「支払方法を指定する」を選びます |
   | 備考欄に入力されるテキスト | 交換伝票の備考欄に入れる文言を指定します |

   ※在庫がない商品は、購入者の申請画面で交換がグレーアウトされ、返金のみ選べるようになります