Подключение сайта на 1С-Битрикс к ILFF

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

Модуль ILFF связывает ваш интернет-магазин на 1С-Битрикс с сервисом ILFF:

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

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

Нужны редакция 1С-Битрикс с интернет-магазином (модули «Интернет-магазин» и «Торговый каталог»), PHP 8, права администратора сайта и доступ к личному кабинету ILFF. Подключение занимает 15–20 минут.

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

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

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

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

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

1. Скачайте архив модуля ilff.delivery.zip со страницы модуля на сайте ILFF или получите его у менеджера.
2. Распакуйте архив в каталог сайта /local/modules/, чтобы получилось /local/modules/ilff.delivery/. Если каталога local/modules нет, создайте его.
3. В админке откройте Marketplace → Установленные решения, найдите ILFF: доставка и обмен заказами и нажмите Установить.

При установке модуль сам:

• создаёт службы доставки «Доставка до двери ILFF» и «Пункты выдачи ILFF» (Магазин → Настройки → Службы доставки);
• добавляет в заказ служебные свойства: тариф, пункт выдачи, вес, габариты и число мест;
• подключает карту выбора пункта на странице оформления заказа;
• создаёт агентов обмена (шаг 6).

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

Админка → Настройки → Настройки продукта → Настройки модулей → ILFF: доставка и обмен заказами.

1. Адрес сервиса ILFF — уже заполнен, менять не нужно.
2. Ключ API клиента ILFF — ключ из шага 1. После сохранения поле остаётся пустым, сохранённый ключ не показывается. Чтобы поменять только настройки, оставьте поле пустым.
3. Статус, при котором заказ уходит в ILFF — по умолчанию «Принят, ожидается оплата»: заказ уходит сразу после оформления. Если вы сначала проверяете заказ или ждёте оплату, выберите статус, в который переводите заказ после проверки, например «Оплачен, формируется к отправке». Заказ уходит при переходе в этот статус.
4. Статусы сайта для статусов ILFF. Пустое значение «Не менять» оставляет статус сайта как есть:

При установке модуль сам создаёт статусы «Передан в доставку» и «Возврат» и выставляет соответствие: передан в доставку → «Передан в доставку», доставлен → «Выполнен», отменён → заказ отмечается отменённым (вариант «Отменить заказ (флаг «Отменён»)»), возврат → «Возврат». Если вы уже выбрали статусы, они не меняются.

1. Способы оплаты при получении — отметьте способы, которые покупатель оплачивает курьеру или в пункте выдачи, например «Наличные курьеру» или «Наложенный платёж». Наложенный платёж в заявке будет только у них и только у неоплаченного заказа. Остальные заказы считаются предоплаченными, даже если онлайн-оплата ещё не пришла.
2. Флажки:
   • Получать остатки из ILFF — на сайт записываются свободные остатки: остаток на складе ILFF за вычетом резерва и заказов, которые ещё не дошли до ILFF. Товар в зоне приёмки склада в остаток не входит, пока его не разместили;
   • Получать вес и габариты товаров — вес и размеры товаров из ILFF записываются на сайт, только по товарам, где они у нас заполнены;
   • Получать вес и габариты заказа — после сборки в свойства заказа пишутся фактические вес, габариты и число мест;
   • Доставка в карточке товара (по умолчанию выключено) — под кнопкой покупки показывается цена доставки курьером и в пункт выдачи «от» для города магазина.
3. Окно выбора пункта выдачи — «Виджет ILFF» (по умолчанию: карта, службы и цены) или «Простое окно» (список и карта). Для виджета укажите Код клиента ILFF для виджета из личного кабинета и добавьте домен сайта в список доменов виджета в кабинете. Без кода открывается простое окно. Вариант настроек калькулятора — код варианта из личного кабинета ILFF, например site2, если для этого сайта заведены свои настройки доставки. Пусто — настройки по умолчанию. Пороги бесплатной доставки («Бесплатно для получателя от суммы товаров») задаются в личном кабинете ILFF, когда сумма товаров дошла до порога, модуль показывает доставку как «Бесплатно».
4. Адрес подсказки городов — необязательно. Пусто — подсказка берётся с сервиса ILFF рядом с адресом сервиса.
5. Отметьте Передать список товаров сейчас и нажмите Сохранить и проверить связь. Вверху появится «Связь с ILFF есть, клиент: …», число переданных товаров и, если включены остатки, число обновлённых остатков.

Шаг 4. Службы доставки и оформление заказа

1. Отключите способы доставки сайта с фиксированной ценой, если доставку выполняет ILFF. Иначе покупатель увидит их рядом с нашими со своей ценой.
2. В службах доставки ILFF при необходимости настройте ограничения: по способам оплаты, местоположениям или сумме заказа.
3. В заказе должно быть заполнено местоположение покупателя: по нему считается цена (курьер — по городу, улица на цену не влияет). Город берётся из свойства «Местоположение» вместе с регионом и районом, поэтому одноимённые сёла разных регионов не путаются. Улица — из свойства с флагом «Адрес» или из свойства с кодом ADDRESS, она уходит в заявку ILFF как есть.

Для доставки в сёла и посёлки нужен справочник местоположений с сёлами: по умолчанию Битрикс загружает только города, и покупатель из села видит «Местоположение не найдено». Загрузите его: «Магазин → Настройки → Местоположения → Импорт местоположений», источник — сервер 1С-Битрикс, страна Россия, уровень детализации — «с сёлами» (полная загрузка занимает несколько минут).

1. Оформите на сайте пробный заказ с доставкой ILFF и убедитесь, что цена и срок доставки показываются, а заказ пришёл в ILFF.
2. Если цену доставки ILFF посчитать не удалось или пункт выдачи не выбран, заказ с этой службой не оформится: покупатель увидит «Доставка ILFF: …. Выберите другой пункт или способ доставки.» Так заказ не уйдёт с доставкой 0 ₽.

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

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

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

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

Шаг 6. Агенты и cron

Модуль работает через агентов Битрикса:

Заказ уходит в ILFF сразу при смене статуса, агент нужен только для повторов. По умолчанию Битрикс запускает агентов при заходах посетителей. На сайте с небольшим трафиком настройте запуск агентов через cron (bitrix/modules/main/tools/cron_events.php), иначе остатки и трек-номера будут запаздывать. Строка «Запуск агентов» внизу настроек модуля показывает, как они запускаются сейчас, а «последний запуск» — работает ли каждый агент.

Что видит покупатель

• Доставка до двери ILFF — курьер и Почта России «Курьер онлайн», выбирается самый дешёвый тариф.
• Пункты выдачи ILFF — пункты и постаматы СДЭК, 5Post и отделения Почты России на карте. Пока пункт не выбран, цена доставки 0 и подпись «Выберите пункт выдачи на карте».
• Цена и срок считаются по весу и габаритам корзины и адресу покупателя.

Как дальше работает обмен

• Заказы: заказ с доставкой ILFF уходит при переходе в статус из настройки «Статус, при котором заказ уходит в ILFF». Если сервис ILFF не ответил, заказ остаётся в очереди и досылается агентом: через 1, 5, 15, 60 и 180 минут.
• Отмена: отмена заказа на сайте отменяет заявку в ILFF, пока её не передали в службу доставки; собранный заказ вернётся на хранение. Если заявка уже у службы доставки, которая принимает отмену (Dalli, 5Post), отмена передаётся ей, а заказ возвращается на склад. У других служб заявка в работе сама не отменяется: в комментарии к заказу появится «ILFF: Заявка уже в работе…», свяжитесь с менеджером.
• Трек-номер и статус: трек записывается в отгрузку заказа, статус меняется по таблице из шага 3. Передаются агентом раз в 15 минут. Ссылку на отслеживание посылки в службе доставки модуль отдаёт через штатное отслеживание Битрикса: покупатель видит её рядом с трек-номером в личном кабинете, её можно вставить в письма о заказе.
• Остатки, вес и габариты: записываются агентом, если включены флажки.

Обновление модуля

1. Скачайте новый архив модуля с этой страницы и распакуйте его в каталог /local/modules/ сайта поверх старой версии (каталог ilff.delivery).
2. В админке откройте Marketplace → Установленные решения, у модуля ILFF нажмите Удалить, затем Установить. Настройки модуля, службы доставки и свойства заказа сохраняются: переустановка обновляет только скрипты оформления и обработчики.
3. Откройте настройки модуля и нажмите Сохранить и проверить связь.

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

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