Connecting an InSales store to ILFF

The module links your InSales store with the ILFF service:

• our delivery methods appear in the checkout with the price and a map of pickup points;
• the delivery cost is shown on the product page and in the cart;
• orders reach ILFF on their own, and the tracking number and status are returned to the store;
• stock, weight and dimensions of products are passed from ILFF to the store;
• cancelling an order in the store cancels the request in ILFF.

The connection takes 10–15 minutes and needs no changes to the site template. You need access to the InSales admin panel and to the ILFF client account.

The InSales admin panel and the ILFF client account are in Russian, so their labels are given below as they appear on the screen, with a translation in brackets.

Step 1. API key in InSales

1. In the InSales admin panel open Расширения → Разработчикам (Extensions → For developers) and create an access key. The API is not available on every InSales plan: if the section is missing, check your plan with InSales support.
2. Give the key full access: the module needs orders, products, delivery methods, order statuses, additional fields and storefront scripts.
3. Save the two values of the key: Идентификатор (Identifier) and Пароль (Password). Do not send them to anyone, they are entered only in the client account.

Step 2. Connection in the ILFF client account

Client account → the Интеграции (Integrations) tab → expand the Интернет‑магазин (Online store) block. The first line of the block is a link to the Russian version of this guide, and the stores already connected are shown above the platform field.

1. Адрес магазина (Store address): the technical address of the form магазин.myinsales.ru. Your own domain is not suitable.
2. Идентификатор ключа API (API key identifier) and Пароль ключа API (API key password): from step 1.
3. Когда забирать заказ (When to take the order): the status from which the order goes to ILFF:
   • Утверждён (Approved; the default, recommended): the order goes when you have confirmed it;
   • Новый (New): right after the shopper places it;
   • Оплачен (Paid): paid or approved;
   • Свой статус магазина (Custom store status): a list of the statuses of your store appears below, choose the one you need. This option is available after the first connection: connect the store with another option, then come back and choose your status.
4. Checkboxes:
   • Выгружать остатки (Export stock): the store receives free stock, that is the stock at the ILFF warehouse minus the reserve and the orders not yet loaded into ILFF;
   • Выгружать вес и габариты (Export weight and dimensions): the weight and size of products from ILFF are written to the store, only for products where we have them filled in;
   • Передавать вес и габариты заказа (Pass order weight and dimensions): after picking and repacking, the actual weight, dimensions and number of packages are written to the store order;
   • Заказ с несвязанным товаром ждёт привязки (An order with an unlinked product waits for linking): an order with a product that is not yet linked to your product in ILFF is not loaded until you link it (step 3). Without the checkbox such a product is created in ILFF as a new item. We recommend leaving the checkbox on.
5. Press Подключить (Connect). The account checks the key, the block header shows «подключён» (connected), and the store sets itself up:
   • it creates the delivery methods «Доставка до двери ILFF» (ILFF door delivery) and «Пункты выдачи ILFF» (ILFF pickup points);
   • it adds order fields for the tracking number, weight and dimensions;
   • it installs a delivery cost block on the product page and in the cart of the storefront.

After the connection the key fields stay empty, and this is intended: the saved key is not shown. To change the settings only, leave them empty and press «Подключить».

1. Expand the Способы оплаты при получении (Cash on delivery payment methods) group and tick the methods that the shopper pays on receipt. The list is read from the store, and the Обновить из магазина (Refresh from the store) button reads it again. What this gives is described in step 4. The changes are saved with the «Подключить» button.
2. Expand the Статусы в магазине (Statuses in the store) group and check which ILFF statuses are passed to the store. The table is filled in on connection, and changing it is optional:

The other statuses are not passed to the store. You can add a row or choose another store status, including a custom one: the «Обновить из магазина» button adds your statuses to the choice.

Step 3. Linking products

The Товары магазина (Store products) button in the same block shows all product variants of the store and their link to your products in ILFF. The link is matched first by barcode, then by SKU:

To remove a link, clear the product in the row. Sizes of one model often share an SKU, so fill in barcodes in the store.

If an order is waiting for linking, a banner with the number of such orders appears at the top of the Интеграции tab, and the "Интернет‑магазин" block shows a table with the orders and products. After linking, the orders are loaded on their own.

Step 4. InSales store settings

1. Delivery methods. Switch off or delete the store delivery methods with a fixed price (for example, the default «Курьером»). Otherwise the shopper sees them next to ours, with their own price.
2. Payment methods and cash on delivery. In the checkout the shopper sees the delivery price without the cash on delivery fee: at this step InSales does not tell us the payment method. Cash on delivery gets into the request only for the methods ticked in the client account as paid on receipt, and only if the order is not paid. For the other methods the cash on delivery amount is 0 and there is no fee, even if the online payment has not arrived yet. While no method is ticked, cash on delivery is determined by the payment status of the order: an unpaid order with online payment will get cash on delivery, so the block shows a warning. To have the shopper pay the fee, set a surcharge in the payment method settings in InSales.
3. Hiding out-of-stock products. If «скрывать товары не в наличии» (hide out-of-stock products) is on in the InSales settings, products with zero stock at the ILFF warehouse disappear from the storefront after the stock export. Check this setting before you switch on the «Выгружать остатки» checkbox.
4. Stock write-off. InSales writes off stock when an order is created. The store stock is then aligned with the actual ILFF stock at the next export.
5. Demo products. InSales itself archives products marked «[Пример]» when you create your first own product.
6. Test order. Place an order on the site and make sure that the ILFF delivery methods are visible in the checkout and the order has arrived in ILFF.

What the shopper sees

• Доставка до двери ILFF: a courier and Russian Post «Курьер онлайн».
• Пункты выдачи ILFF: CDEK and 5Post pickup points and parcel lockers and Russian Post offices on one map, labelled "carrier · type: address".
• The price and delivery time are calculated from the weight and dimensions of the cart and the shopper's address.

How the exchange runs afterwards

• Orders: ILFF regularly takes orders in the chosen status. Before picking starts, changes to the order in the store are applied to the request. After picking starts, changes are not applied: the banner and the table in the account show such an order, contact your manager.
• Cancellation: an order cancelled in the store before picking starts cancels the request in ILFF. If the request is already in work, it is not cancelled on its own: the manager decides.
• Tracking number and status: the tracking number is written to the store order when we receive it. The status is sent when the request status changes, if it is in the «Статусы в магазине» table. Both are passed on a schedule, not instantly.
• Stock, weight and dimensions: sent to the store on a schedule if the checkboxes are on.

If something does not work

For other questions contact your ILFF manager.