Modules for online stores

Connecting RetailCRM to ILFF

RetailCRM (Simla) connects to ILFF without a module or a programmer: ILFF runs the exchange through the RetailCRM API using a key.

orders with the "ILFF" delivery type arrive in ILFF on their own and become delivery requests;
the order status changes according to the request status, and the tracking number, tracking link and ILFF status are written to the order fields;
your stock at the ILFF warehouse is exported to the "ILFF" warehouse in RetailCRM;
cancelling an order in RetailCRM cancels the request in ILFF if the request is not yet in work.

You need:

RetailCRM administrator access (to create a delivery type, a warehouse and an API key);
access to the ILFF client account.

The connection takes 10 minutes.

The RetailCRM and ILFF client account interfaces are in Russian, so their labels are given below as they appear on the screen, with a translation in brackets when first mentioned.

Step 1. ILFF delivery type and warehouse in RetailCRM

Open Настройки → Справочники → Типы доставок (Settings → Directories → Delivery types) and create the ILFF delivery type with the symbolic code ilff. Choose this delivery type in orders that ILFF must ship.
If you want to see stock, open Настройки → Склад → Склады (Settings → Warehouse → Warehouses) and create the ILFF warehouse with the symbolic code ilff.
You can choose your own code; in that case, enter it when connecting (step 3): the delivery type and the warehouse must have the same code.

Step 2. API key

Open Настройки → Интеграция → Ключи доступа к API (Settings → Integration → API access keys) and press Добавить (Add).
Grant the key access to the stores from which ILFF will collect orders.
Select the following rights: orders (read and write), directories, warehouse, and custom fields (read and write).
Save and copy the key.

Step 3. Connection in the ILFF client account

Client account → the Интеграции (Integrations) tab → expand the Интернет-магазин (Online store) block.

Платформа (Platform): choose RetailCRM.
Адрес магазина (Store address): the address of your RetailCRM, for example shop.retailcrm.ru.
Код типа доставки и склада ILFF в RetailCRM (Code of the ILFF delivery type and warehouse in RetailCRM): leave it empty if the code is "ilff"; otherwise enter your own code.
Ключ API RetailCRM (RetailCRM API key): the key from step 2.
The Выгружать остатки (Export stock) checkbox: export stock from the ILFF warehouse to the "ILFF" warehouse in RetailCRM.
The Заказ с несвязанным товаром ждёт привязки (An order with an unlinked product waits for linking) checkbox: when it is on, an order with a product that is not yet linked to your product in ILFF is not accepted until you link it (step 4). We recommend leaving it on.
Press Подключить (Connect). The account checks the key and delivery type and creates the "Трек ILFF" (ILFF tracking number), "Ссылка отслеживания ILFF" (ILFF tracking link) and "Статус ILFF" (ILFF status) fields in the order. To change the settings only, the key field can be left empty.

Step 4. Linking products

ILFF reads RetailCRM product offers itself once a day and links them to your products in ILFF by barcode, then by SKU. Products without a pair are in the client account under the Товары магазина (Store products) button: choose your product for each one and press Привязать (Link).

How to place an order for ILFF

In the order, choose the ILFF delivery type.
Enter the buyer's first name, last name and phone number in the order fields.
Enter the delivery address in the order delivery block, including the postcode in the address.
Enter the delivery cost for the buyer in the delivery cost field.
The delivery date and time, if filled in, become the ILFF delivery date and time.
Confirm the order: move it from the «Новый» (New) status group to any working status (for example, «Согласовано», Confirmed). ILFF does not collect new orders, so you can keep drafts.

How the exchange runs

What	When
Orders with the ILFF delivery type, except new ones	every few minutes: new ones and those changed since the previous load
Order change before picking	the request is updated; after picking the changes are visible in the client account ("изменён после сборки", changed after picking)
Order in a status from the «Отменен» (Cancelled) group	the request is cancelled if it is not yet in work; otherwise contact your ILFF manager
Order in a status from the «Выполнен» (Completed) group	ILFF no longer changes it
Tracking number and tracking link	written to the order fields as soon as the carrier has issued the tracking number
Order status	handed over to the carrier → «Передан в доставку» (Handed over for delivery) (or «Доставляется», In transit), delivered → «Выполнен» (Completed), cancellation and refusal → «Отменен» (Cancelled) (other). If there are no such statuses, the first status of the required group is used; the "Статус ILFF" field shows the exact status
ILFF warehouse stock	after every stock change at ILFF: to the warehouse with the ILFF code, in the "Доступно" (Available) field

If something does not work

«RetailCRM не принял ключ API» (RetailCRM did not accept the API key): the key has been deleted, was not copied in full, or does not have the required rights.
«В RetailCRM нет типа доставки с символьным кодом …» (RetailCRM has no delivery type with the symbolic code …): create the delivery type or check the code in the connection field.
«Не удалось создать поле заказа» (Could not create the order field): grant the key rights to custom fields or manually create string order fields with the codes ilff_track_number, ilff_tracking_url, ilff_status.
An order did not arrive: check that the ILFF delivery type is chosen for the order, the order is not in the «Новый» group, and all products are linked (the Товары магазина button).
For anything else, contact your ILFF manager or support from the client account.