Интеграция сервиса Dadata и Битрикс24 для привязки сделок к компаниям по полям ИНН и КПП

Пример заказчика: налаживаем бизнес-процессы и регламенты

Один наш заказчик много лет ведет рабочие процессы в Битрикс24 и накопил в CRM базу данных из более чем двухсот компаний.

С этим связана одна большая проблема: в некоторых из них некорректно прописаны и привязаны к сделкам ИНН, КПП или другие реквизиты, либо одно из полей не заполнено вовсе.

Если вас интересует перенос дел в Битрикс24 из сделок в таймлайн компании с удалением дубликатов, читайте наш кейс.

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

Неточности приходится исправлять вручную, что отнимает немало времени у менеджеров.

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

Все это никак не способствует увеличению прибыли фирмы заказчика.

Парсинг тела письма Битрикс24 с автоматическим созданием контактов и компаний с контролем дубликатов: читайте в статье.

Избежать такой проблемы можно, если корректного заполнять данные в полях компании еще на этапе создания в Битрикс24 или массово исправлять данные в уже существующих сущностях.

Но делать это вручную слишком долго, поэтому используем автоматизацию! Настроим интеграцию на платформе Пинкит для подключения к DaData и передаче нужных данных о компании в Битрикс24.

Перенос дел из таймлайна сущности Контакт в таймлайн сущности Компания: подробнее здесь.

В базе этого сайта собраны официально подтвержденные данные юридических лиц из государственных справочников.

Благодаря этому не нужно больше беспокоиться о том, что компания отправила неверные или неполные данные, либо кто-то в цепочке мог совершить ошибку в цифрах.

Поля в сущности можно просто автоматически подтянуть из справочника dadata.ru.

Распознавание тела письма в Битрикс24 для сортировки поступающей корреспонденции от клиентов в Битрикс24: читайте по ссылке.

Готовое решение для заказчика выглядит так:

Для начала создаем в сущностях Сделка и Компания два пользовательских поля - КПП и ИНН.

В момент создания новой компании на портале заполняем любое из них.

На этом этапе интеграция проверит наличие аналогичных данных в CRM и в случае совпадения дозаполнит второе поле автоматически.

Если же совпадений не обнаружится, то мы создаем новую компанию, а интеграция берет оставшиеся данные с портала dadata.ru и привязывает к сделке.

В случае уже созданных в Битрикс24 компаний без заполненных КПП или ИНН настраиваем интеграцию для автоматического заполнения данных полей и исключения дублей.

Переходим к настройке интеграции.

2. Интеграция dadata.ru и Битрикс24 для привязки сделок к компаниям по полям ИНН и КПП

Шаг первый: Откуда

Откуда получаем данные - Битрикс24, событие - Сделка -создание.

Шаг второй: Инструменты

• Прервать если ИНН не заполнено

Используем проверку по названию поля - source.UF_CRM_***** (это специальное пользовательское поле ИНН). Условие - не пустое значение, действие - Продолжить, если проверка пройдена.

• Прервать если КПП заполнено

Используем проверку по названию поля - source.UF_CRM_***** (это специальное пользовательское поле КПП). Условие - Пустое значение, действие - Продолжить, если проверка пройдена.

• Поиск компании в Битрикс24 по ИНН

Используем API-запрос методом POST по ссылке /crm.company.list следующего вида:

{

"filter" : {

"UF_CRM_***": {{source.UF_CRM_***}}

}

}

Вместо звездочек указываем код поля ИНН.

Заголовки:

Content-Type: application/json

Accept: application/json

• Получить реквизиты

Используем API-запрос методом POST по ссылке /crm.requisite.list следующего вида:

{

"filter" : {

"ENTITY_TYPE_ID": 4,

"ENTITY_ID": 1577

}

}

Заголовки:

Content-Type: application/json

Accept: application/json

• ЕСЛИ компания найдена

Используем шаг Если-иначе, Название поля - step3.total (из предыдущего шага поиска компаний по ИНН).

Если найденных компаний больше или равно 1, Результат при успешной проверке = 1, Результат при неуспешной проверке = 0.

• Добавляем в сделку найденную по ИНН компанию

Используем API-запрос методом POST по ссылке /crm.deal.update следующего вида:

{

"ID" : {{source.ID}},

"fields":{

"COMPANY_ID": {{step3.result.0.ID}}

}

}

Заголовки:

Content-Type: application/json

Accept: application/json

• ЕСЛИ компания не найдена

Используем шаг Если-иначе, Название поля - step3.total (из предыдущего шага поиска компаний по ИНН).

Если найденных компаний больше или равно 1, Результат при успешной проверке = 0, Результат при неуспешной проверке = 1.

• То запрашиваем данные из DaData

Используем API-запрос методом POST по ссылке /4_1/rs/findById/party следующего вида:

{

"query":{{source.UF_CRM_****}},

"branch_type": "MAIN"

}

Условие выполнения - step11 (если компания не найдена по ИНН).

Заголовки:

Content-Type: application/json

Accept: application/json

Необходимо добавить на данном шаге доступ к учетной записи dadata.ru.

• Экранируем кавычки в названии компании

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

Используем "Замену по регулярному выражению". Условие выполнения - step11, step11 - step7.suggestions.0.value, Регулярное выражение - /"/, Строка для замены - '.

• Добавляем компанию в Битрикс24 из DaData

Используем API-запрос методом POST по ссылке /crm.company.add следующего вида:

{

"fields":{

"TITLE": "{{step13}}",

"UF_CRM_**": {{step7.suggestions.0.data.inn}},

"UF_CRM_**": {{step7.suggestions.0.data.kpp}},

"ADDRESS": "{{step7.suggestions.0.data.address.value}}"

}

}

Заголовки:

Content-Type: application/json

Accept: application/json

Условие выполнения - step11.

• Прикрепляем компанию в сделку

Используем API-запрос методом POST по ссылке /crm.deal.update следующего вида:

{

"ID" : {{source.ID}},

"fields":{

"COMPANY_ID": {{step9.result}}

}

}

Заголовки

Content-Type: application/json

Accept: application/json

Условие выполнения - step11.

• Прерывание

Используем проверку по полю source.ID. Условие - Число (меньше), Сравниваемое значение = 0, действие - Продолжить, если проверка пройдена.

Шаг третий: Куда

Обновляем сделку для прикрепления к ней компании:

Шаг четвертый: Сопоставление данных

Сопоставляем сделки по ID:

Шаг пятый: Запуск

Сохраняем и запускаем интеграцию

Интеграция, срабатывающая при обновлении сделки, настраивается аналогично. Единственное, на шаге 1 меняем событие на Сделка-обновление:

Для большей точности можно сверять еще и КПП. Для этого на шаге Инструменты добавляем следующий шаг:

• Поиск компании в Битрикс24 по ИНН+КПП

Используем API-запрос методом POST по ссылке /crm.company.list следующего вида:

{

"filter" : {

"UF_CRM_***": {{source.UF_CRM_***}},

"UF_CRM_***": {{source.UF_CRM_***}}

}

}

Резюмируем

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

Если компании на портале нет, она автоматически создается с заполнением полей из сервиса dadata.ru.

Регистрируйтесь в личном кабинете Пинкит по ссылке: https://lk.pinkit.io/register и протестируйте интеграцию dadata.ru и Битрикс24 по нашей инструкции самостоятельно.

Алексей Окара,
основатель Пинол и продакт-менеджер Пинкит