Подключение магазина на NetCat к ILFF

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

Модуль «ILFF» связывает ваш интернет-магазин на NetCat (модуль «Интернет-магазин», netshop) и сервис ILFF:

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

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

Нужны:

• NetCat 7 с модулем «Интернет-магазин» (проверено на NetCat 7.2 E-commerce);
• PHP 8.1 или новее с расширением curl;
• основная валюта магазина — российский рубль;
• права администратора сайта, доступ к файлам сайта и к личному кабинету ILFF.

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

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

Личный кабинет → вкладка Интеграции → раскройте блок Интернет-магазин.

1. Платформа — выберите NetCat.
2. Адрес магазина — адрес сайта, например shop.ru.
3. Флажок Заказ с несвязанным товаром ждёт привязки: если он включён, заказ с товаром, который ещё не связан с вашим товаром в ILFF, не принимается, пока вы его не свяжете (шаг 5). Рекомендуем оставить флажок включённым.
4. Нажмите Подключить. К магазину кабинет не обращается: связь проверит модуль.

Вверху вкладки Интеграции показан Ключ API. Если его нет, нажмите Сгенерировать. Ключ понадобится на шаге 3. Никому его не пересылайте: по нему сервис ILFF узнаёт ваш магазин.

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

1. Скачайте архив ilff-netcat.zip со страницы модуля на сайте ILFF или получите его у менеджера.
2. Распакуйте архив в корень сайта: папка модуля должна оказаться в netcat/modules/ilff.
3. Узнайте секретный ключ системы: Настройки системы → Секретный ключ.
4. Откройте в браузере https://ваш-сайт/netcat/modules/ilff/install.php?secret_key=<секретный ключ>.

Установщик добавит модуль ILFF, службу расчёта доставки «ILFF», таблицы модуля и задание обмена в планировщик NetCat (раз в 5 минут). Повторный запуск ничего не дублирует.

Шаг 3. Способ доставки и настройки модуля

Откройте Интернет-магазин → Доставка и создайте способ доставки с автоматическим расчётом ILFF (например, «Доставка ILFF»). В настройках службы:

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

Если способов доставки ILFF несколько, настройки обмена берутся из первого включённого.

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

На шаге выбора доставки под способом ILFF показываются варианты с ценой и сроком: курьеры служб, пункты выдачи и постаматы (выбор пункта — стандартный выбор пункта NetCat), Почта России. Цена считается по городу покупателя. Вариант, который не возит по адресу покупателя, не показывается.

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

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

Раз в сутки модуль передаёт в ILFF список товаров и вариантов. В личном кабинете ILFF кнопка Товары магазина показывает их и связь с вашими товарами в ILFF. Связь подбирается по артикулу — поле Артикул товара или варианта. Статусы «Связан», «Подобран», «Несколько совпадений», «Не найден» — как в других модулях: проверьте подобранные и выберите товар вручную, где связь не найдена.

Если заказ ждёт привязки, вверху вкладки Интеграции появляется плашка с числом таких заказов. После привязки модуль досылает заказ сам.

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

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

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

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

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

Установщик сам добавляет задание в планировщик NetCat (Инструменты → Задачи по расписанию). Чтобы оно выполнялось в срок, планировщик NetCat должен запускаться cron сервера. Задание можно запускать и по адресу https://ваш-сайт/netcat/modules/ilff/cron.php?secret_key=<секретный ключ>; адрес не публикуйте.

Задание досылает заказы, которые не ушли сразу, забирает трек-номера и статусы, обновляет остатки и вес, раз в сутки передаёт список товаров и сверяет все остатки.

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

По остальным вопросам обращайтесь к вашему менеджеру ILFF.