Подключение облачного Битрикс24 к ILFF
Смотрите также: Виджет доставки для корзины · API ILFF · Все модули для CMS
Обмен подходит для сделок в облачном Битрикс24. Он работает через входящий вебхук REST API и не связан с модулем «1С-Битрикс».
Что делает ILFF:
- забирает сделки выбранной стадии и создаёт заявки на доставку;
- записывает обратно статус, трек-номер и ссылку отслеживания, меняет стадию сделки и добавляет комментарий;
- отменяет заявку при стадии-провале, если она ещё не в работе;
- связывает товары и вариации по штрихкоду, затем по артикулу;
- при включённом складском учёте выравнивает остатки документами оприходования и списания.
Служба доставки Битрикс24 и тариф ILFF в сделке в этот этап не входят.
Шаг 1. Вебхук
- В Битрикс24 откройте Разработчикам → Другое → Входящий вебхук.
- Создайте вебхук с разрешениями CRM (crm) и Торговый каталог (catalog).
- Для создания полей ILFF при первом подключении пользователю вебхука нужно право Разрешить изменять настройки в CRM. Для остатков нужны права на просмотр каталога, склады и создание/проведение документов оприходования и списания.
- Сохраните полный адрес вида
https://<портал>.bitrix24.ru/rest/<user>/<секрет>/. Он содержит секрет: не пересылайте его в открытом виде и не храните в документах.
Шаг 2. Воронка и стадия
Выберите воронку или конкретную стадию, из которой ILFF забирает сделки. Если указана только воронка, используется первая рабочая стадия. Стадии-провалы той же воронки читаются дополнительно, чтобы ILFF мог отменить заявку.
Передайте администратору ILFF адрес вебхука и выбранную воронку или стадию. При подключении в сделках создаются строковые поля:
- Трек ILFF;
- Ссылка отслеживания ILFF;
- Статус ILFF.
Шаг 3. Товары
ILFF читает товары и вариации и ищет соответствие сначала по штрихкоду, затем по артикулу (code или xmlId). Товары без однозначной пары отмечаются как несвязанные; свяжите их вручную в личном кабинете.
Как оформить сделку для ILFF
- Переведите сделку в выбранную стадию.
- Заполните контакт, телефон и адрес доставки. Почтовый индекс укажите в поле адреса
ADDRESS_POSTAL_CODE. - Добавьте товарные позиции. Сумма позиций считается стоимостью товаров; превышение суммы сделки над ними считается стоимостью доставки.
- Поле
CLOSEDATEиспользуется как плановая дата доставки.
Сделка без адреса или товаров не создаёт заявку и попадает в список ожидающих данных с причиной.
Статусы
- передан в службу доставки — стадия Отгружен (или Отправлен, Передан в доставку);
- выдан — Доставлен либо успешная стадия;
- отменён или полный отказ — Отменен либо стадия-провал;
- возврат принят — Возврат, если она есть, иначе стадия-провал.
Точный статус и служба доставки также пишутся в поле Статус ILFF. При смене статуса добавляется комментарий в таймлайн.
Остатки
Выберите активный склад ILFF, если он есть; иначе используется первый активный склад. Перед выгрузкой ILFF сравнивает свои остатки с остатками портала и создаёт только необходимые документы оприходования или списания с пометкой ILFF. Повторный запуск не меняет уже совпадающие остатки. Если складской учёт на портале отключён, выгрузка просто пропускается.
Если что-то не работает
- Нет разрешений crm/catalog — включите их в настройках вебхука и повторите подключение.
- Не созданы поля ILFF — дайте пользователю вебхука право изменять настройки CRM или создайте три строковых поля самостоятельно:
UF_CRM_ILFF_TRACK,UF_CRM_ILFF_TRACK_URL,UF_CRM_ILFF_STATUS. - Сделка не пришла — проверьте стадию, адрес и товарные позиции, а также список ожидающих данных в личном кабинете.
- Остатки не выгрузились — проверьте складской учёт, активный склад и права на документы оприходования и списания.