Подключение магазина на Joomla + VirtueMart к ILFF

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

Пакет «ILFF для VirtueMart» связывает ваш магазин на Joomla с VirtueMart и сервис ILFF:

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

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

Нужны:

• Joomla 4 или 5 и VirtueMart 4 (проверено на Joomla 5.4.10 и VirtueMart 4.6.4);
• PHP 8.1 или новее с расширением curl;
• валюта магазина — российский рубль, страна Россия опубликована в VirtueMart;
• права администратора сайта, доступ к cron сервера или планировщику хостинга и к личному кабинету ILFF.

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

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

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

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

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

На одном сайте Joomla подключайте к ILFF один магазин: VirtueMart или JoomShopping. Если работают оба, их списки товаров в ILFF заменяют друг друга.

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

1. Скачайте архив ilff-virtuemart.zip со страницы модуля на сайте ILFF или получите его у менеджера. Распаковывать не нужно.
2. В админке Joomla откройте Система → Установка → Расширения и загрузите архив.

Пакет ставит и включает два плагина:

• Система - ILFF для VirtueMart — настройки, обмен заказами, статусами и остатками;
• VM Shipment - ILFF — способ доставки ILFF для VirtueMart.

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

Откройте Система → Плагины → Система - ILFF для VirtueMart.

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

Нажмите Сохранить: вверху появится «ILFF: связь есть» и адрес задания обмена (шаг «Задание обмена»).

Шаг 4. Способы доставки и что видит покупатель

VirtueMart → Магазин → Способы доставки → Создать: выберите плагин VM Shipment - ILFF и в его настройках Вид доставки ILFF:

• Курьер — самая дешёвая служба по адресу покупателя;
• Пункт выдачи — покупатель выбирает пункт из списка пунктов своего города;
• Почта России — Почта по адресу покупателя.

Создайте по способу на каждый нужный вид. Цену у способов не задавайте — её считает ILFF.

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

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

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

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

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

В карточке заказа в админке VirtueMart, в блоке доставки — Доставка ILFF: служба или пункт, номер заявки ILFF, статус ILFF, трек-номер, состояние обмена и заметки обмена с датой. Когда статус ILFF меняет статус заказа, трек-номер добавляется комментарием к смене статуса, и покупатель получает его в письме.

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

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

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

Задание нужно запускать раз в 5–15 минут: добавьте адрес задания обмена (показан после сохранения настроек, вида https://ваш-сайт/index.php?option=com_ajax&group=system&plugin=ilffvm&format=raw&token=…) в cron сервера или планировщик хостинга. Адрес не публикуйте.

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

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

Ошибки обмена модуль пишет в журнал Joomla ilffvm.php (папка administrator/logs), без ключа API и данных покупателей. По остальным вопросам обращайтесь к вашему менеджеру ILFF.