В данной статье рассмотрим, как можно передать заказы с сайта на платформе 1С-Битрикс: управление сайтом с помощью модуля Отправка вебхуков от MoreKIT
Задача
При создании заказа на сайте — передадим данные по заказу в Битрикс24
Подключение Битрикс24
Перед добавлением сервиса Битрикс24 в MoreKIT необходимо установить приложение наше приложение в маркетплейсе. Для установки приложения требуется подписка на маркетплейс Битрикс24
После установки приложения MoreKit в маркетплейс Битрикс24 можно приступать к добавлению сервиса в Morekit. Для этого в проекте нажмите Добавить сервис, найдите в списке Битрикс24. При подключении сервиса будет запрошена ссылка на ваш битрикс
Введите ссылку в формате https://мой-домен.bitrix24.ru. После этого произойдет редирект на страницу с вашим битриксом, подтвердите авторизацию
Если все правильно — сервис появится в списке сервисов и у него будет статус Готово
Установка модуля Отправка хуков от MoreKIT на сайт
Для установки модуля, который будет отправлять данные — перейдите в маркетплейс решений 1с-битрикс и установите MoreKIT: вебхуки для сайта
С помощью данного модуля можно осуществить отправку данных с сайта на 1с-битрикс по следующим событиям:
- Веб-формы
- Инфоблоки (создание элемента)
- Инфоблоки (обновление элемента)
- Инфоблоки (обновление инфоблока)
- Заказы: создание
- Заказы: обновление
- Заказы: смена статуса
- Заказы: удаление
Создание процесса в MoreKIT
Следующим шагом — нам потребуется создать процесс на стороне MoreKIT. Данный процесс будет принимать данные с сайта, которые далее будут переданы в Битрикс24
Нам потребуется создать процесс с типом Другое. В окне проекта MoreKIT нажмите на кнопку Создать процесс, тип процесса выберите Другое, дайте процессу название и нажмите Добавить
После создания процесса будет осуществлен переход в процесс. Нам необходимо скопировать ссылку из первого блока. По данной ссылке будем отправлять данные из модуля на стороне 1с-битрикс
Настройка маршрута
Теперь необходимо настроить маршрут на стороне модуля MoreKIT: вебхуки для сайта
Нужно перейти в Настройки —> Настройки продукта —> Настройки модулей —> Отправка хуков от MoreKIT
Здесь необходимо настроить маршрут:
- Url обработчика: скопированная ссылка на процесс MoreKIT
- Событие: «Заказы: создание» — так как нам нужно передавать созданный заказ
Нажимаем Сохранить
Теперь нужно проверить, что модуль работает и данные отправляются. Вы можете либо дождаться создания заказа со стороны клиента, либо создать тестовый заказ. Создадим тестовый заказ
Вводим тестовые данные и сохраняем заказ
Чтобы проверить, пришли данные или нет — перейдем в раздел События и посмотрим, есть ли там событие
Видим данные по событию созданного заказа
Модуль отправки всегда подписывает события, по которому был отправлен запрос, в данном примере мы видим "event": "sale.order.created" — событие создания заказа. В случае — если разные события будут приходить на один процесс, логику можно разделять в зависимости от типа события
Теперь осталось собрать схему передачи данных в Битрикс24
Настройка схемы передачи в Битрикс24
Схема передачи будет выглядеть следующим образом:
И часть схемы внутри цикла #6 по добавлению товаров
Описание блоков схемы
#2 Найти контакты — поиск существующего контакта в Битрикс24 по номеру телефона
#3 Поиск контакта — если не нашли по телефону, ищем контакт по email
#4 Создание контакта — создаем контакт, заполняя email, телефон и имя
#5 Создание сделки — создаём сделку в воронке Выгружено на стадии Выгрузка. Название сделки: «Новый заказ с сайта № {{input.order_id}}«. В поле CONTACT_ID подставляется ID контакта (из #2 или #3 или #4)
#6 Цикл — запускаем цикл на список товаров из корзины. Внутри цикла будет либо прикрепляться существующий товар к сделке, либо создаваться новый
#7 Найти товары — ищем существующий товар в Битрикс24 по внешнему коду. Подразумевается, что ваши товары в Битрикс24 будут связаны с товарами на сайте по какому-либо параметру (в данном случае — внешний код)
#8 Добавить товар в торговый каталог — создаем новый товар. ID торгового каталога можно найти в URL браузера, если перейти в какой-либо товар в Битрикс24. Например: https://mydomen.bitrix24.ru/crm/catalog/25/product/135/, где 25 — это ID торгового каталога, в котором создастся товар
#10 Добавить товар в сделку — прикрепляем найденный/созданный товар к сделке, указываем цену и количество
Тестирование процесса
После настройки схемы — можно проверить работоспособность процесса. Для этого перейдем во вкладку События и нажмем на значок повторения процесса. При перезапуске события — входящие данные из него переотправятся на текущий процесс, но отработают уже по новой схеме
После перезапуска события — жмем кнопку Обновить, пока не появится новое событие
Как видим — схема отработала, можно смотреть результат в Битрикс24. Для быстрого перехода в созданную сделку — нажмите на серый ID напротив блока создания сделки, MoreKIT перенаправит вас в сделку
Как видим — сделка создалась. Прикрепился контакт, заполнилась стоимость. Если заполнилась стоимость — значит прикрепились товары, по котоырм она формируется
Проверим товары:
Как видим — товары также прикрепились. Передача прошла успешно
Итоги
В данной статье рассмотрели, как можно передать созданный заказ на стороне с сайта на 1с-Битрикс. Было выполнено:
- Поиск или создание контакта в Битрикс24
- Создание сделки с прикреплением контакта
- Прикрепление товаров из корзины к сделке
Отправка была произведена с помощью установки на сайт модуля MoreKIT: вебхуки для сайта