Modules for online stores

Connecting MoySklad to ILFF

MoySklad connects to ILFF without a module and without a programmer: ILFF runs the exchange through the MoySklad JSON API using a token.

posted customer orders with the ILFF warehouse arrive in ILFF automatically and become delivery requests;
the order status changes with the request status, and the tracking number, tracking link and ILFF status are written to the order's additional fields;
the ILFF warehouse in MoySklad is maintained with documents: receipt at ILFF — «Оприходование» (Stock receipt), order dispatch — «Отгрузка» (Shipment) against the order, accepted return — «Возврат покупателя» (Customer return);
cancelling an order in MoySklad cancels the request in ILFF if the request is not yet in work.

You need:

a MoySklad administrator account (or an employee with rights to customer orders, warehouses, products, stock receipts, write-offs, shipments, returns and additional fields);
access to the ILFF client account.

The connection takes 10 minutes.

The MoySklad interface and the ILFF client account are in Russian. Screen labels are given in Russian, with a translation in brackets at first mention.

Step 1. ILFF warehouse in MoySklad

Open «Товары → Склады» (Products → Warehouses) and create a warehouse named ILFF. This is your stock stored with us.
You may choose a different name; if you do, enter it when connecting (step 3).
In orders that ILFF is to ship, select this warehouse.

Step 2. Token

Open «Настройки → Токены» (Settings → Tokens) (gear icon → «Токены») and click «Создать токен» (Create token).
Select the employee on whose behalf ILFF will work. Documents created by ILFF in MoySklad will be created on their behalf.
Copy the token: it is shown in full only when it is created.

Step 3. Connection in the ILFF client account

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

Платформа (Platform): choose МойСклад (MoySklad).
Склад ILFF в МойСклад (ILFF warehouse in MoySklad): leave it empty if the warehouse is named "ILFF"; otherwise enter its name.
Токен JSON API МойСклад (MoySklad JSON API token): the token from step 2.
The Выгружать остатки (Export stock) checkbox: maintain the ILFF warehouse in MoySklad with documents (see below).
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 token and warehouse and creates the additional fields «Трек ILFF» (ILFF tracking number), «Ссылка отслеживания ILFF» (ILFF tracking link) and «Статус ILFF» (ILFF status) in the «Заказ покупателя» (Customer order). To change the settings only, the token field can be left empty.

Step 4. Linking products

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

How to place an order for ILFF

Create a «Заказ покупателя» and select the ILFF warehouse.
The counterparty is the buyer: ILFF takes the name and phone number from the counterparty card.
Enter the delivery address in the order's «Адрес доставки» (Delivery address) field. The postal code is part of the full address.
Add the delivery price for the buyer as a service line (for example, «Доставка», Delivery): ILFF does not send service lines for shipment and treats their total amount as the delivery cost.
The planned shipment date, if filled in, becomes the delivery date.
Post the order. ILFF does not pick up unposted orders, so you can keep them as drafts.

How the exchange runs

What	When
Posted orders with the ILFF warehouse	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 of the «Неуспешный» (Unsuccessful) type (for example, «Отменен» (Cancelled))	the request is cancelled if it is not yet in work; otherwise contact your ILFF manager
Order in a status of the «Успешный» (Successful) type	ILFF no longer changes it
Tracking number and tracking link	in the order's additional fields as soon as the carrier has issued the tracking number
Order status	handed over to the carrier → «Отгружен» (Shipped), delivered → «Доставлен» (Delivered), cancellation and refusal → «Отменен», return accepted → «Возврат» (Return). If these statuses do not exist, ILFF uses the first status of the required type; the «Статус ILFF» additional field shows the exact status

ILFF warehouse in MoySklad

ILFF maintains the stock of the ILFF warehouse in MoySklad with documents. Each event has its own document tagged "ILFF" in the comment:

Event in ILFF	Document in MoySklad
First enabling of "Выгружать остатки"	«Оприходование» or «Списание» (Write-off) with the comment "ILFF: начальный остаток склада ILFF" (ILFF: initial stock of the ILFF warehouse) — the warehouse stock becomes equal to the stock at ILFF
Receipt of your supply completed	«Оприходование» with the comment "ILFF: приёмка …" (ILFF: receipt …)
Order from MoySklad handed over to the carrier	«Отгрузка» against this order, with the prices from the order
Return for such an order accepted at the warehouse	«Возврат покупателя» against this shipment
Everything else: marketplace and other store orders, defects, stocktaking	«Оприходование» or «Списание» with the comment "ILFF: прочие движения склада ILFF" (ILFF: other movements of the ILFF warehouse)

Do not change or delete ILFF documents: ILFF recognises them by their external code and reconciles the stock. You can post your own documents for the ILFF warehouse (for example, a transfer to it) — ILFF will correct any discrepancy with an "other movements" document.

If something does not work

«МойСклад не принял токен» (MoySklad did not accept the token) — the token has been deleted or was not copied in full. Create a new one.
«В МойСклад нет склада …» (There is no … warehouse in MoySklad) — create the warehouse or check its name in the «Склад ILFF» (ILFF warehouse) field.
«Не удалось создать доп. поле заказа» (Failed to create an order additional field) — the token's employee does not have rights to configure additional fields. Grant the rights or create the fields manually (type «Строка», String): «Трек ILFF», «Ссылка отслеживания ILFF», «Статус ILFF».
An order did not arrive — check that the order is posted, the ILFF warehouse is selected and all products are linked (the Товары магазина button).
For anything else, contact your ILFF manager or support from the client account.