Обмен данными с CRM Битрикс24

Те клиенты, которые используют в своей работе Битрикс24, могут настроить интеграцию с сервисом Муравьиная логистика. После настройки интеграции необходимые данные будут напрямую выгружаться в наш сервис.

Для интеграции Битрикс24 с Муравьиной логистикой (далее – МЛ) необходимо создать Входящий вебхук. Для этого в боковом меню нажмем Разработчикам 1, на вкладке Готовые сценарии 2 выберем Другое 3.

Нажмем Входящий вебхук 1.

В окне Входящий вебхук в поле Настройка прав 1 выберем CRM. Сохраним изменения 2.

Если возникнет необходимость просмотреть или отредактировать ранее созданный вебхук, перейдем в Разработчикам 1, вкладка  Интеграции. В окне Интеграции 2 откроется список ранее созданных интеграций. Двойным кликом на необходимую строку с входящим вебхуком откроем окно редактирования, в котором можно просмотреть или изменить данные.

Далее выполним настройки в МЛ. Зайдем в Сервис - Параметры. В открывшемся окне выберем вкладку Учет 1 и в поле Тип сопоставления кодов в справочниках укажем текстовый 2.

Перейдем во вкладку Обмен и уведомления 1, в поле Тип сервера укажем Битрикс24 2. Нажмем на Настройки. В окне Дополнительные параметры 3 внесем информацию:

Далее мы подробно опишем, как заполнять поля окна Дополнительные параметры:

1) Адрес сайта – копируем указанные данные из поля Вебхук для вызова rest api в Битрикс24:

2) Ключ доступа – копируем указанные данные из поля Вебхук для вызова rest api в Битрикс24:

3) Идент. Пользователя – идентификатор пользователя, создавшего вебхук. Принимается согласно данных поля Вебхук для вызова rest api в Битрикс24:

4) Ист. Данных: Сущн. – указываем сущности, по которым необходимо выполнить интеграцию: Сделки или Счета.

5) Имя поля: Дата дост. – указываем имя поля в Битрикс24, в котором содержится дата доставки.  Поле заполняется в случае, если необходимо выгружать из Битрикс24 заявки, относящиеся только к выбранной дате.

6) Фильтр: Статусы – фильтр по статусам, согласно которым необходимо выгружать заявки в МЛ. Для Сделок фильтр выполняется по Стадиям сделки. Для этого зайдем в Битрикс24 в меню Настройки 1, нажмем Справочники и выберем Стадии сделки 2. Откроется перечень стадий, по которым можно выполнять фильтр заявок для интеграции с МЛ. Например, если необходимо выгружать в наш сервис все сделки со стадией Финальный счет, в поле Фильтр: Статусы укажем Финальный счет.

Также в данном поле можно указывать комбинации воронок и стадий в следующем формате: воронка1\стадия1;воронка2\стадия2;воронка3\стадия3.

Обратите внимание! Поле Имя поля: Дата дост.  и поле Фильтр: Статусы могут быть как заполнены одновременно, так и только одно из них. В зависимости от комбинации заполнения этих полей в наш сервис будут выгружаться разные данные из Битрикс24:

7) Соотв. полей – укажем соответствие полей МЛ и Битрикс24. Данное поле заполняется в случае, если значения каких-либо необходимых для работы полей Битрикс24 автоматически не подтягиваются в МЛ или подтягиваются неверно. Например, если необходимо в Пользовательское поле заявки 1 в МЛ выгружать информацию из поля Комментарий в Битрикс24, то укажем: DocUserField_1=[Комментарий], где:

- DocUserField_1 – имя поля Пользовательское поле заявки 1 в МЛ (имена полей принимать в соответствии с документацией API).

- [Комментарий] – имя соответствующего поля в Битрикс24, указанное в квадратных скобках.

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

Также возможен другой, более простой способ указать соответствие полей: для этого в Справочнике Настройки таблиц 1 выберем Документы/Заявки (Торговые точки). Далее в починенном окне выберем необходимую строку с полем, которому необходимо указать соответствие полю в Битрикс24. Двойным кликом или с помощью «карандаша» в нижней части экрана вызовем окно Редактирование записи. Зайдем на вкладку Сторонние CRM 2, выберем Сущность в CRM 3, в CRM поле 4 укажем имя поля в Битрикс24. В нашем примере мы указываем для поля Польз. поле заявки 1 соответствие полю Комментарий в Битрикс24:

Особенности внесения соответствий полей Битрикс24 и МЛ:

1) Имена полей прописываются в соответствии с именами, указанными в интерфейсе Битрикс24: в меню Сделки (выбрать отображение Список) или непосредственно в самой сделке. Также возможно использование имен, указанных в Документации Битрикс24 для CRM.

Пример для имени поля «Комментарий»:

- в меню Сделки (отображение Список):

 - непосредственно в Сделке:

- в документации Битрикс24 для CRM:

2) Для выгрузки информации в МЛ возможно использование системных и пользовательских наименований полей Битрикс24. Но необходимо отметить, что если в Битрикс24 системное поле было переименовано, то при интеграции в МЛ необходимо указывать «старое» системное имя, а не пользовательское переименованное. Например, если системное поле «Комментарий» переименовать в Битрикс24 на «Дополнительная информация», то при интеграции используем имя «Комментарий» или «COMMENTS».

3) При заполнении соответствия полей Битрикс24 и МЛ необходимо учитывать тип данных этих полей. Например, в поле Прибыль (числовой тип данных) нельзя выгрузить поле Сумма с валютой. Типы данных для полей указаны в документации API.

После выполненных настроек интеграции перейдем в Справочник Заявки 1, укажем необходимую дату загрузки. Далее нажмем «карандаш» и выберем Импорт заявок 2. В открывшемся окне Импорт 3 укажем Да/Нет в полях Удалять заявки и Обновл.координаты, ОК. В Заявках отобразится список точек на доставку согласно ранее выставленным в настройках критериям. В нашем примере выгружаем точки, которые относятся к определенной дате доставки и имеют стадию сделки: Финальный счет:

Теперь осталось привязать новые точки к карте и выполнить расчет маршрутов доставки. Не забывайте, точки необходимо привязывать только первый раз. При последующей загрузке уже внесенных в справочник МЛ точек доставки, сервис будет определять их автоматически.

Если Вас заинтересовал описанный функционал - мы готовы продемонстрировать его работу, выполнить необходимые настройки и предоставить доступ к сервису. Для этого оставьте заявку на сайте Муравьиная логистика.