# 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. General settings

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 connect to Recustomer ![How to check the shop code on the CROSSMALL screen.](images/02c_crossmall-store-code.png) |

## 4. Order status mapping

1. 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 (they are not tracked, and shoppers will not find them on the cancellation request page either). 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)

## 5. Carrier mapping

1. Under **Carrier mapping**, map Recustomer's carriers to CROSSMALL's carriers

   ![The carrier mapping screen. For each of Yamato Transport, Sagawa Express, and Japan Post, register the CROSSMALL shipping method codes with Add row (for example, 001 and 002 for Yamato Transport and 013 for Sagawa Express).](images/02c_crossmall-carrier-mapping.png)

   | Field | What to set |
   | --- | --- |
   | Yamato Transport | Register the shipping method codes that mean "Yamato Transport" in CROSSMALL |
   | Sagawa Express | Register the shipping method codes that mean "Sagawa Express" in CROSSMALL |
   | Japan Post | Register the shipping method codes that mean "Japan Post" in CROSSMALL |

   ▼How to check the carrier codes in the CROSSMALL admin

   ![In the CROSSMALL admin, choose the shipping method name type under Master registration > Name master to see the list of codes per shipping method.](images/02c_crossmall-carrier-code.png)

## 6. Cancellation processing phase settings

※This step is required **only if you also use Cancellation**. Skip it if you use Tracking only.

1. 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**. |