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

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

Плагин «ILFF - доставка и фулфилмент» связывает интернет-магазин на Moguta.CMS и сервис ILFF:

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

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

Нужны:

• Moguta.CMS (проверено на Moguta.CMS 14, редакция «Минимаркет»);
• PHP 8.1 или новее с расширением curl;
• валюта магазина — российский рубль;
• права администратора сайта, доступ к cron сервера или планировщику хостинга и к личному кабинету ILFF.

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

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

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

Шаг 2. Установка плагина

1. Скачайте архив ilff-moguta.zip со страницы модуля на сайте ILFF или получите его у менеджера.
2. В админке Moguta откройте Плагины, загрузите архив (или распакуйте его в папку mg-plugins/ilff) и активируйте плагин «ILFF - доставка и фулфилмент».

При активации плагин создаёт способы доставки Курьер ILFF, Пункт выдачи ILFF и Почта России (ILFF) с теми же способами оплаты, что у вашего первого способа доставки, и свои таблицы. Повторная активация способы не дублирует.

Шаг 3. Настройки плагина

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

1. Ключ API ILFF — ключ из шага 1.
2. Адрес сервиса ILFF — уже заполнен, менять не нужно.
3. Вариант настроек калькулятора — код варианта из личного кабинета ILFF; пусто — настройки по умолчанию.
4. Передавать в ILFF в статусах — ид статусов Moguta через запятую, по умолчанию 2,6 (оплачен, в обработке). Заказ в статусе «не подтверждён» в ILFF не уходит.
5. Отменять заявку в статусах — по умолчанию 4 (отменён).
6. Статус «передан в службу доставки» (3, в доставке), «доставлен» (5, выполнен), «отменён в ILFF» (4), «возврат» — пусто, не менять.
7. Оплата при получении — ид способов оплаты через запятую; пусто — способы со словами «наложенный» или «при получении» в названии.
8. Остатки из ILFF, Вес товаров из ILFF, Вес и габариты собранного заказа — 1 или 0.

Нажмите Сохранить: появится «Сохранено, связь с ILFF есть». На той же странице — адрес задания обмена.

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

На странице оформления под способами ILFF — поле Город доставки. Когда покупатель вводит город, у способов ILFF появляются цена, служба и срок. У «Пункта выдачи ILFF» — «выберите пункт выдачи, от N руб.» и список пунктов города; после выбора пункта — его точная цена. Способ, который не возит в этот город, недоступен.

Способы ILFF можно переименовать и поменять их порядок в Настройки → Доставка; цену у них не задавайте — её считает ILFF.

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

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

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

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

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

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

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

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

Добавьте адрес задания обмена из настроек плагина (вида https://ваш-сайт/ajaxrequest?pluginHandler=ilff&mguniqueurl=action/cron&token=…) в cron сервера или планировщик хостинга, запуск раз в 5–15 минут. Адрес не публикуйте.

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

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