Подключение магазина на CS-Cart к ILFF

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

Модуль «ILFF: доставка и фулфилмент» связывает ваш магазин на CS-Cart и сервис ILFF:

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

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

Нужны:

• CS-Cart 4.21 (проверено на CS-Cart 4.21.2, русская сборка);
• PHP 8.1 или новее с расширением curl;
• основная валюта магазина — российский рубль, валюта RUB есть в списке валют: ILFF считает доставку и суммы заказа в рублях;
• способы ILFF работают только по России;
• права администратора магазина, доступ к cron сервера или планировщику хостинга и к личному кабинету ILFF.

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

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

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

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

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

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

1. Скачайте архив ilff-cscart.zip со страницы модуля на сайте ILFF или получите его у менеджера. Распаковывать архив не нужно.
2. В админке CS-Cart откройте Модули → Управление модулями, нажмите + (Загрузить и установить модуль) и выберите архив.

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

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

Откройте Модули → Управление модулями, найдите модуль ILFF: доставка и фулфилмент и откройте его Настройки.

Связь с ILFF

1. Ключ API — ключ из шага 1.
2. Адрес сервиса — уже заполнен, менять не нужно.
3. Код клиента (виджет) — код из личного кабинета. Без кода карта пунктов выдачи не показывается.
4. Вариант настроек калькулятора — код варианта из личного кабинета ILFF, например site2, если для этого сайта заведены свои настройки доставки. Пусто — настройки по умолчанию. Пороги бесплатной доставки задаются в личном кабинете ILFF.
5. Адрес подсказки городов — необязательно, обычно оставьте пустым.

Заказы

1. Передавать заказ в ILFF в статусах — по умолчанию «Обработан». Заказ уходит при переходе в один из отмеченных статусов. Заказ в статусе «Открыт» в ILFF не уходит: переведите его в «Обработан», когда проверите.
2. Отменять заявку ILFF в статусах — по умолчанию «Аннулирован». Переход отправленного заказа в такой статус отменяет заявку в ILFF.
3. Способы оплаты при получении — отметьте способы, при которых покупатель платит при получении. Такие заказы уходят в ILFF с наложенным платежом, остальные считаются предоплаченными.

Статусы заказа по статусам ILFF. «Не менять» оставляет статус как есть:

Отдельного статуса «Отправлен» в CS-Cart нет, поэтому переданный в доставку заказ по умолчанию становится «Выполнен». Если вы завели свой статус, выберите его здесь.

Остатки и вес

1. Получать остатки из ILFF — в количество товара записывается свободный остаток: остаток на складе ILFF за вычетом резерва и заказов, которые ещё не дошли до ILFF. Товар в зоне приёмки склада в остаток не входит, пока его не разместили. Товары без учёта остатков не меняются.
2. Получать вес и габариты товаров из ILFF — вес и габариты, измеренные на складе ILFF, записываются в товары и вариации.
3. Получать вес и габариты собранного заказа — вес, габариты и число мест собранного заказа показываются в блоке ILFF заказа.

Сохраните настройки и нажмите Проверить связь в блоке Состояние обмена: появится «Связь с ILFF есть.». Если связи нет, там же будет причина (раздел «Если что-то не работает»).

Блок Состояние обмена показывает способы доставки ILFF, очередь заказов, время последних запусков обмена, адрес задания обмена и журнал ошибок. Нажмите Передать товары в ILFF: товары уйдут в ILFF для привязки (шаг 5).

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

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

Покупатель на оформлении заказа:

1. Курьер ILFF — цена и срок. Цена считается по городу адреса покупателя, улица уходит в ILFF с заказом.
2. Пункт выдачи ILFF — до выбора пункта: «Выберите пункт выдачи на карте, от N ₽» и кнопка Выбрать пункт на карте. Выбор этого способа сам открывает карту. После выбора пункта под способом показан адрес пункта, у способа — точная цена и срок, кнопка — Выбрать другой пункт.
3. Почта России (ILFF) — Почта по адресу покупателя, если сервис ILFF считает Почту для вашего магазина.
4. На вкладке «Курьер» виджета можно выбрать службу курьера: выберется способ «Курьер ILFF» с ценой этой службы.
5. Без выбранного пункта заказ со способом «Пункт выдачи ILFF» не оформляется: появится «Выберите пункт выдачи ILFF на карте.».

Если в городе покупателя нет пунктов выдачи, виджет показывает ближайшие пункты соседних городов с расстоянием; цена считается до выбранного пункта. Способ ILFF, который не возит по адресу покупателя, в списке не показывается.

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

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

В личном кабинете ILFF кнопка Товары магазина в блоке «Интернет-магазин» показывает товары магазина, переданные модулем, и их связь с вашими товарами в ILFF. Связь подбирается по артикулу — коду товара CS-Cart (поля штрихкода в CS-Cart нет).

Товар с вариациями (модуль «Вариации товаров»: размер, цвет) передаётся вариациями: у каждой свой код, остаток и заказ идут по вариации.

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

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

В карточке заказа в админке CS-Cart, в правой колонке — блок ILFF: вид доставки, номер заявки ILFF, состояние обмена («передан», «ждёт привязки товаров», «в очереди»), статус ILFF, трек-номер, при включённом флажке — вес, габариты и число мест, ошибка обмена, если она была.

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

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

Переход заказа в статус отмены отменяет заявку в ILFF, пока её не передали в службу доставки; собранный заказ вернётся на хранение. Если заявка уже у службы доставки, которая принимает отмену (Dalli, 5Post), отмена передаётся ей, а заказ возвращается на склад. У других служб заявка в работе сама не отменяется: в блоке ILFF заказа появится ответ «Заявка уже в работе…», свяжитесь с менеджером.

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

Задание обмена нужно запускать раз в 15–60 минут. В блоке Состояние обмена настроек модуля показан адрес задания обмена с секретным токеном. Добавьте его в cron сервера или планировщик хостинга, например:

*/15 * * * * wget -q -O - "<адрес задания обмена>" >/dev/null 2>&1

Адрес не публикуйте: без верного токена задание не запускается.

Задание досылает заказы, которые не ушли сразу (через 1, 5, 15, 60 и 180 минут), забирает трек-номера и статусы, обновляет остатки и вес, раз в сутки проверяет связь, передаёт список товаров и сверяет все остатки. Заказы уходят в ILFF сразу при смене статуса и без задания. Время последних запусков видно в блоке «Состояние обмена»; там же кнопка Выполнить обмен сейчас.

Обновление и удаление

Обновление: загрузите новый архив модуля так же, как при установке (Модули → Управление модулями → +) — настройки и данные сохраняются.

Удаление (Модули → Управление модулями, модуль ILFF → Удалить): способы доставки ILFF выключаются (на них ссылаются ваши заказы), данные ILFF в заказах остаются.

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

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