Connecting a Moguta.CMS store to ILFF

Download the module ilff-moguta.zip

The plugin «ILFF - доставка и фулфилмент» (ILFF: delivery and fulfilment) links an online store on Moguta.CMS and the ILFF service:

• ILFF delivery methods appear on the checkout page: courier to the door, a pickup point chosen from the list of points of the city and Russian Post; the price and delivery time are calculated by the city the shopper enters;
• an order with an ILFF delivery method goes to ILFF on its own when it gets the status you chose;
• the tracking number and order status are returned to the store;
• stock and weight of products are passed from ILFF to the store;
• cancelling an order in the store cancels the request in ILFF.

The store always starts the exchange: the plugin itself calls the ILFF service with the API key.

You need:

• Moguta.CMS (tested on Moguta.CMS 14, the «Минимаркет» edition);
• PHP 8.1 or newer with the curl extension;
• the store currency is the Russian rouble;
• site administrator rights, access to the server cron or the hosting scheduler and to the ILFF client account.

The connection takes 15–20 minutes.

The plugin, the Moguta.CMS 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. Connection in the ILFF client account

Client account → the Интеграции (Integrations) tab → the Интернет-магазин (Online store) block: Платформа (Platform) is Moguta.CMS, Адрес магазина (Store address) is the site address. We recommend leaving the Заказ с несвязанным товаром ждёт привязки (An order with an unlinked product waits for linking) checkbox on. Press Подключить (Connect). The Ключ API (API key) is at the top of the tab; if it is missing, press Сгенерировать (Generate). Do not send it to anyone.

Step 2. Installing the plugin

1. Download the archive ilff-moguta.zip from the module page on the ILFF site or get it from your manager.
2. In the Moguta admin panel open Плагины (Plugins), upload the archive (or unpack it into the folder mg-plugins/ilff) and activate the plugin «ILFF - доставка и фулфилмент».

On activation the plugin creates the delivery methods Курьер ILFF (ILFF courier), Пункт выдачи ILFF (ILFF pickup point) and Почта России (ILFF) (Russian Post) with the same payment methods as your first delivery method, and its own tables. Activating it again does not duplicate the methods.

Step 3. Plugin settings

Плагины → «ILFF - доставка и фулфилмент» → Настройки (Settings):

1. Ключ API ILFF (ILFF API key): the key from step 1.
2. Адрес сервиса ILFF (ILFF service address): already filled in, no need to change it.
3. Вариант настроек калькулятора (Calculator settings profile): the profile code from the ILFF client account; empty means the default settings.
4. Передавать в ILFF в статусах (Send to ILFF in statuses): Moguta status ids separated by commas, 2,6 (paid, in processing) by default. An order in the status «не подтверждён» (not confirmed) does not go to ILFF.
5. Отменять заявку в статусах (Cancel the request in statuses): 4 (cancelled) by default.
6. Статус «передан в службу доставки» (handed over to the carrier: 3, in delivery), «доставлен» (delivered: 5, completed), «отменён в ILFF» (cancelled in ILFF: 4), «возврат» (return: empty, do not change).
7. Оплата при получении (Cash on delivery): payment method ids separated by commas; empty means the methods with the words «наложенный» or «при получении» in the name.
8. Остатки из ILFF (Stock from ILFF), Вес товаров из ILFF (Product weight from ILFF), Вес и габариты собранного заказа (Weight and dimensions of the picked order): 1 or 0.

Press Сохранить (Save): «Сохранено, связь с ILFF есть» (saved, connected to ILFF) appears. The exchange task address is on the same page.

Step 4. What the shopper sees

On the checkout page the Город доставки (Delivery city) field is shown under the ILFF methods. When the shopper enters the city, the ILFF methods show the price, the carrier and the delivery time. «Пункт выдачи ILFF» shows «выберите пункт выдачи, от N руб.» (choose a pickup point, from N roubles) and the list of points of the city; after a point is chosen it shows its exact price. A method that does not deliver to this city is not available.

You can rename the ILFF methods and change their order in Настройки → Доставка (Settings → Delivery); do not set a price for them, ILFF calculates it.

Place a test order, move it to the sending status and make sure the order has arrived in ILFF.

Step 5. Linking products

Once a day the plugin sends products and variants to ILFF. The link in the ILFF client account (Товары магазина, Store products) is matched by the Артикул (Article) field of the product or variant.

After linking, the plugin resends the waiting orders itself.

The order in the store

The plugin adds the ILFF request number, the tracking number and exchange errors to the manager comment of the order (visible in the admin panel, not to the shopper). When an ILFF status changes the order status, the shopper receives a status change email with the tracking number. ILFF stock is written to the «Количество» (Quantity) of the product or variant; products with unlimited quantity are not changed.

Order cancellation

Moving an order to a cancellation status cancels the request in ILFF until it has been handed over to the carrier. If the request is already with a carrier that accepts cancellation (Dalli, 5Post), the cancellation is passed to it; otherwise the reply of ILFF appears in the comment: contact your manager.

The exchange task

Add the exchange task address from the plugin settings (of the form https://your-site/ajaxrequest?pluginHandler=ilff&mguniqueurl=action/cron&token=…) to the server cron or the hosting scheduler, to run every 5–15 minutes. Do not publish the address.

If something does not work

The plugin writes exchange errors to uploads/ilff/ilff.log, without the API key and shopper data. For other questions contact your ILFF manager.