# CROSSMALL integration

> STEP 2-3

> **注意: Before you start**
>
> You need to allow access from the following Recustomer IP addresses on the CROSSMALL side.
>
> - 52.199.155.223
>
> - 54.95.233.104
>
> - 57.180.95.90

## 1. Get the authentication key and company code from CROSSMALL

1. Sign in to CROSSMALL

2. Copy the company code shown at the top right of the screen

   ![Copy the company code shown at the top right of the CROSSMALL screen.](images/02c_crossmall-company-code.png)

3. Open System settings > Basic information

   ![Opening Basic information under System settings.](images/02c_crossmall-basic-info.png)

4. Click **Edit**

   ![The Basic information screen. Scroll to the bottom to find the Edit button.](images/02c_crossmall-edit-button.png)

   ※The Edit button appears when you scroll to the bottom of the page.

5. Copy the authentication key under API settings

   ![Copying the authentication key under API settings.](images/02c_crossmall-auth-key.png)

## 2. Authenticate in Recustomer

1. In Recustomer, go to Settings > External service integrations > Integrations > CROSSMALL

2. Enter the authentication key and company code, then click **Authenticate**

   ![The CROSSMALL integration settings. Enter the authentication key and company code, then authenticate.](images/02c_crossmall-auth-input.png)

   | Field | Value to enter |
   | --- | --- |
   | Authentication key | The authentication key you copied in step 5 of section 1 |
   | Company code | The company code you copied in step 2 of section 1 |

3. The setup is complete when the status changes to **Authenticated**

## 3. Configure the integration

1. Under **General**, set the information used to import orders

   ![The general settings screen for the CROSSMALL integration.](images/02c_crossmall-general.png)

   | Field | What to set |
   | --- | --- |
   | Mail account | Enter the mail account used when importing orders (one of those under "Master registration > Mail account") ![How to check the registered mail accounts on the CROSSMALL screen.](images/02c_crossmall-mail-account.png) |
   | CROSSMALL shop code | Register the shop code of each shop you want to accept cancellations for in Recustomer ![How to check the shop code on the CROSSMALL screen.](images/02c_crossmall-store-code.png) |

2. Under **Order status mapping**, map Recustomer's order statuses to CROSSMALL's processing phases

   ![The order status mapping screen.](images/02c_crossmall-status-mapping.png)

   > **注意: Important**
   >
   > Orders in a processing phase that is not registered here are not imported into Recustomer (shoppers will not find them when they look up an order on the request page). Make sure every processing phase is registered under one of Cancelled, Preparing for shipment, or Shipped.

   | Field | What to set |
   | --- | --- |
   | Cancelled | Check the processing phases that mean "cancelled" in CROSSMALL |
   | Preparing for shipment | Check the processing phases that mean "not yet shipped" in CROSSMALL |
   | Shipped | Check the processing phases that mean "already shipped" in CROSSMALL |

   ▼How to check the processing phases in the CROSSMALL admin

   ![How to check the processing phases in the CROSSMALL admin.](images/02c_crossmall-phase-list.png)

3. Go to the Settings > External service integrations > Integrations > CROSSMALL > Integration settings tab and configure what happens on the CROSSMALL side when a cancellation occurs, under **Cancellation processing phase settings**

   ![The cancellation processing phase settings screen.](images/02c_crossmall-cancel-phase.png)

   | Field | What to set |
   | --- | --- |
   | Order status on cancellation | The status applied to the CROSSMALL order after Recustomer cancels it automatically |
   | Excluded order statuses | Order statuses you do **not** want to accept cancellations for. If a shopper requests a cancellation and the order has one of these statuses, the cancellation is **rejected**. |