Подключение магазина на UMI.CMS к ILFF

Скачать модуль ilff-umi.zip

Модуль «ILFF» связывает интернет-магазин на UMI.CMS (модуль «Интернет-магазин») и сервис ILFF:

• на шаге «Доставка» появляются способы ILFF: курьер до двери, пункт выдачи с выбором из списка пунктов города и Почта России, с ценой и сроком;
• заказ со способом доставки ILFF сам уходит в ILFF, когда получает выбранный вами статус;
• трек-номер и статус заказа возвращаются в магазин;
• остатки и вес товаров передаются из ILFF в магазин;
• отмена заказа в магазине отменяет заявку в ILFF.

Обмен всегда начинает магазин: модуль сам обращается к сервису ILFF по ключу API.

Нужны:

• UMI.CMS 24 с модулем «Интернет-магазин» (проверено на UMI.CMS 24, шаблон demomarket);
• PHP 8.2 или 8.3 с расширением curl, доступ к консоли сервера (для установщика);
• валюта магазина — российский рубль;
• права администратора сайта и доступ к личному кабинету ILFF.

Подключение занимает 20–30 минут.

Шаг 1. Подключение в личном кабинете ILFF

Личный кабинет → Интеграции → блок Интернет-магазин: Платформа — UMI.CMS, Адрес магазина — адрес сайта, флажок Заказ с несвязанным товаром ждёт привязки — рекомендуем оставить включённым, нажмите Подключить. Вверху вкладки — Ключ API (если его нет — Сгенерировать). Никому его не пересылайте.

Шаг 2. Установка модуля

1. Скачайте архив ilff-umi.zip со страницы модуля на сайте ILFF или получите его у менеджера.
2. Распакуйте архив в корень сайта: файлы лягут в classes/components/emarket/…, templates/demomarket/…, ilff_cron.php, ilff_install.php.
3. В консоли сервера, в корне сайта, выполните: ILFF_API_KEY=<ключ API> php ilff_install.php.

Установщик создаст тип данных и тип доставки «ILFF», три способа доставки — Курьер ILFF, Пункт выдачи ILFF, Почта России (ILFF) — и поле Артикул у товаров каталога, выведет адрес задания обмена. Повторный запуск ничего не дублирует.

1. Шаблон сайта: в templates/<ваш шаблон>/php/emarket/delivery/choose/list.phtml способ с типом ilff выводите шаблоном emarket/delivery/choose/ilff (в архиве он есть для demomarket). Если у вас XSLT-шаблон или своя разметка шага «Доставка», передайте задачу разработчику сайта или менеджеру ILFF.

Шаг 3. Настройки модуля

Модули → Интернет-магазин → Доставка: откройте способ доставки ILFF, группа полей ILFF. Настройки берутся из первого способа ILFF с ключом API:

• Ключ API ILFF, Адрес сервиса ILFF (заполнен), Вариант настроек калькулятора;
• Передавать в ILFF в статусах — коды статусов UMI через запятую, по умолчанию accepted (принят);
• Отменять заявку в статусах — по умолчанию canceled,rejected;
• Статус «передан в службу доставки» (delivery), «доставлен» (ready), «отменён в ILFF» (canceled), «возврат»;
• Оплата при получении — ид способов оплаты через запятую; пусто — способы оплаты курьеру;
• Остатки из ILFF, Вес товаров из ILFF, Вес и габариты собранного заказа — 1 или 0.

Поле Вид доставки ILFF у каждого способа: door — курьер, pickup — пункт выдачи, post — Почта России.

Шаг 4. Что видит покупатель

На шаге «Доставка» (после адреса) — способы ILFF с ценой, под ними служба или пункт и срок. У «Пункта выдачи ILFF» до выбора пункта — «выберите пункт выдачи, от N ₽» и список пунктов города; без выбранного пункта шаг не завершается. Способ, который не возит по адресу покупателя, не показывается.

Оформите пробный заказ, переведите его в статус «Принят» и убедитесь, что заказ пришёл в ILFF.

Шаг 5. Привязка товаров

Раз в сутки модуль передаёт в ILFF товары каталога. Связь в личном кабинете ILFF (Товары магазина) подбирается по полю Артикул товара: заполните его у товаров, которые хранятся на складе ILFF. Подобранные проверьте, ненайденные свяжите вручную.

Заказ в магазине

Номер заявки ILFF, трек-номер и ошибки обмена модуль дописывает в Служебную информацию заказа (видна в админке). По статусам ILFF статус заказа меняется по настройкам, остатки — в «Общее количество на складах» товара.

Отмена заказа

Переход заказа в статус отмены отменяет заявку в ILFF, пока её не передали в службу доставки. Если заявка уже у службы, которая принимает отмену (Dalli, 5Post), отмена передаётся ей; иначе в служебной информации появится ответ ILFF — свяжитесь с менеджером.

Задание обмена

Задание нужно запускать раз в 5–15 минут: по адресу https://ваш-сайт/ilff_cron.php?token=<токен> (адрес с токеном выводит установщик) или командой php ilff_cron.php в корне сайта из cron сервера. Адрес не публикуйте.

Если что-то не работает

Ошибки обмена модуль пишет в sys-temp/logs/ilff.log, без ключа API и данных покупателей. По остальным вопросам обращайтесь к вашему менеджеру ILFF.