# LOGILESS integration

> Common settings

1. [Register a model number for your products](#1-register-a-model-number-for-your-products)

2. [Integration settings](#2-integration-settings)

3. [Exchange settings (when you accept exchanges)](#3-exchange-settings-when-you-accept-exchanges)

## 1. Register a model number for your products

If you set Order Importer (the order source) to LOGILESS in [Data integration settings](./data-import.html), **register a model number (型番) for every product** in the LOGILESS product master. Products without a model number are not eligible for returns, exchanges, or cancellations, and an order that contains only such products shows "order not found" on the request page.

If you use exchanges, products with the same model number become exchange options. Register the same model number for products that differ only in size or color.

![The product details screen in LOGILESS. A value is registered in the 型番 (model number) field under product information.](images/02c_logiless-model-number.png)

**Example: registering a T-shirt in different sizes**

| Product | Model number (型番) | Product code |
| --- | --- | --- |
| T-shirt S | 1000 | 1000-S |
| T-shirt M | 1000 | 1000-M |
| T-shirt L | 1000 | 1000-L |

→ In an exchange request for the T-shirt, S, M, and L can be selected as exchange options.

※Model numbers registered later are not applied to orders that Recustomer has already imported. Register them before you start the integration.

## 2. Integration settings

1. Go to [Settings > External service integrations > Integrations > LOGILESS](https://rcmr.io/settings/integrations/integration/externals/logiless)

2. Enter the client ID, client secret, and merchant ID

   | Field | Value to enter |
   | --- | --- |
   | Client ID | Please contact us |
   | Client secret | Please contact us |
   | Merchant ID | You can find this in the URL bar of your LOGILESS admin. Example: if the URL is "https://app2.logiless.com/merchant/1154/dashboard", the merchant ID is "1154". ![The URL bar of the LOGILESS admin. The part after /merchant/ highlighted in red is the merchant ID.](images/02c_logiless-merchant-id.png) |

3. Click **Authenticate**

4. The LOGILESS sign-in screen opens. Sign in.

   > **注意: Important**
   >
   > If the account you sign in with here is later deleted on the LOGILESS side, Recustomer's authentication will also fail. Avoid accounts that may be deleted (for example when someone leaves the company) and sign in with an account that will remain.

5. Click **Approve**

   ![The screen for granting the application access. Click Approve.](images/02c_logiless-approve.png)

   ※You can leave both "Merchant restrictions" and "Shop restrictions" empty (all merchants / all shops).

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

7. A **LOGILESS shops** field appears. Select every shop you want to connect to Recustomer.

   ![Selecting LOGILESS shops. Select every shop you want to connect to Recustomer.](images/02c_logiless-stores.png)

8. Click **Save** at the top right

## 3. Exchange settings (when you accept exchanges)

※This step is required **only when you accept exchanges**. Skip it if you do not accept exchanges

These settings let shoppers choose a replacement based on the stock in LOGILESS, and issue an exchange slip that reserves the stock of the replacement. The exchange slip is issued at ¥0, so it reserves the stock without creating a charge. The slip is then shipped in the same way as a normal order.

> **注意: An SKU (product code) is required on every product you accept exchanges for**
>
> Exchange slips are sent to LOGILESS using the SKU as the key. Creating the slip fails for products without an SKU.

1. On the Exchange / Cancellation tab of [Settings > External service integrations > Data integration settings](https://rcmr.io/settings/integrations/integration/target), set Get Product Variants (where the stock is looked up) and Create Exchange Order (where the exchange slip is issued) to LOGILESS and save ([Data integration settings](./data-import.html))

   ※Set the same system for the stock lookup (Get Product Variants) and the order import source (Order Importer). If they differ, the replacement items are not shown correctly

2. Go to the [Settings > External service integrations > Integrations > LOGILESS](https://rcmr.io/settings/integrations/integration/externals/logiless) > Integration settings tab and configure it under **Exchange**

   | Item | What to set |
   | --- | --- |
   | Stock lookup | Looks up the stock when a shopper chooses an exchange and only allows them to select items that are in stock. Items without stock are shown as "Out of stock" |
   | Create an order slip for the replacement item | Creates an order slip through the API to reserve the stock of the replacement |
   | When the exchange slip is issued | Choose "Create it automatically when the approval status becomes approved" or "Enter it manually on the exchange processing page" |
   | Order code of the exchange slip | Set the prefix and suffix added to the order code of the exchange slip |
   | Shipping method | Choose "Use the shipping method of the original order" or "Specify a shipping method" |
   | Payment method | Choose "Use the payment method of the original order" or "Specify a payment method" |
   | Store of the exchange slip | Choose "Use the store of the original order" or "Use a specific store only" |

   ※For items without stock, the exchange option is greyed out on the shopper's request page and only a refund can be chosen