Модули для интернет-магазинов

Подключение облачного Битрикс24 к ILFF

Смотрите также: Виджет доставки для корзины · API ILFF · Все модули для CMS

Обмен подходит для сделок в облачном Битрикс24. Он работает через входящий вебхук REST API и не связан с модулем «1С-Битрикс».

Что делает ILFF:

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

Служба доставки Битрикс24 и тариф ILFF в сделке в этот этап не входят.

Шаг 1. Вебхук

  1. В Битрикс24 откройте Разработчикам → Другое → Входящий вебхук.
  2. Создайте вебхук с разрешениями CRM (crm) и Торговый каталог (catalog).
  3. Для создания полей ILFF при первом подключении пользователю вебхука нужно право Разрешить изменять настройки в CRM. Для остатков нужны права на просмотр каталога, склады и создание/проведение документов оприходования и списания.
  4. Сохраните полный адрес вида https://<портал>.bitrix24.ru/rest/<user>/<секрет>/. Он содержит секрет: не пересылайте его в открытом виде и не храните в документах.

Шаг 2. Воронка и стадия

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

Передайте администратору ILFF адрес вебхука и выбранную воронку или стадию. При подключении в сделках создаются строковые поля:

  • Трек ILFF;
  • Ссылка отслеживания ILFF;
  • Статус ILFF.

Шаг 3. Товары

ILFF читает товары и вариации и ищет соответствие сначала по штрихкоду, затем по артикулу (code или xmlId). Товары без однозначной пары отмечаются как несвязанные; свяжите их вручную в личном кабинете.

Как оформить сделку для ILFF

  1. Переведите сделку в выбранную стадию.
  2. Заполните контакт, телефон и адрес доставки. Почтовый индекс укажите в поле адреса ADDRESS_POSTAL_CODE.
  3. Добавьте товарные позиции. Сумма позиций считается стоимостью товаров; превышение суммы сделки над ними считается стоимостью доставки.
  4. Поле CLOSEDATE используется как плановая дата доставки.

Сделка без адреса или товаров не создаёт заявку и попадает в список ожидающих данных с причиной.

Статусы

  • передан в службу доставки — стадия Отгружен (или Отправлен, Передан в доставку);
  • выдан — Доставлен либо успешная стадия;
  • отменён или полный отказ — Отменен либо стадия-провал;
  • возврат принят — Возврат, если она есть, иначе стадия-провал.

Точный статус и служба доставки также пишутся в поле Статус ILFF. При смене статуса добавляется комментарий в таймлайн.

Остатки

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

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

  • Нет разрешений crm/catalog — включите их в настройках вебхука и повторите подключение.
  • Не созданы поля ILFF — дайте пользователю вебхука право изменять настройки CRM или создайте три строковых поля самостоятельно: UF_CRM_ILFF_TRACK, UF_CRM_ILFF_TRACK_URL, UF_CRM_ILFF_STATUS.
  • Сделка не пришла — проверьте стадию, адрес и товарные позиции, а также список ожидающих данных в личном кабинете.
  • Остатки не выгрузились — проверьте складской учёт, активный склад и права на документы оприходования и списания.

WeChat

QR-код WeChat

Отсканируйте QR-код в WeChat · 用微信扫码添加

Перезвоним за пару минут

В рабочее время позвоним сразу, в другое время перезвоним утром. Пн–пт с 11:00 до 20:00.