Как массово заполнить реквизиты компаний в Битрикс24 по ИНН через DaData

1. Автоматизация заполнения реквизитов для крупных клиентских баз компаний

Задача

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

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

Однако на практике более половины компаний не имеют заполненных реквизитов, отсутствует ИНН или оба поля оставлены пустыми.

Связка Dadata и Битрикс24 для привязки компаний к сделкам по ИНН: похожий сценарий описан здесь.

Ручной процесс заполнения данных мог бы занять огромное количество времени.

Для этого нужно было бы искать каждую компанию в онлайн-справочниках (например, в DaData) по названию и адресу и вручную заполнять реквизиты.

Это создавало значительные трудности для клиента.

Решение

Мы предложили инновационный подход, автоматизировав этот процесс с помощью интеграции Битрикс24 и DaData. Вот как это работает:

1.1. Проверка ИНН. Интеграция автоматически сканирует карточки компаний в Битрикс24, чтобы выявить, в каких из них отсутствует ИНН.

1.2. Автоматическое заполнение реквизитов. Если ИНН найден, система подтягивает данные из DaData и заполняет все необходимые поля реквизитов. В карточку компании добавляются:

• Полное и сокращенное наименование


• Дата регистрации


• ФИО генерального директора


• ИНН, ОГРН, ОКПО, ОКТМО


• Статус компании (активна, ликвидирована, банкрот и т.д.)


• Реквизиты филиалов (если они имеются).

1.3. Добавление актуального адреса. Интеграция получает из DaData актуальный адрес и добавляет его в карточку состветствующей компании в Битрикс24.

1.4. Обработка компаний без ИНН. В случае отсутствия ИНН процесс остановится, чтобы не перезаписать уже имеющиеся данные с корректными реквизитами.

Реализация

Для реализации такого решения мы использовали платформу Пинкит для настройки интеграции.

Это решение позволяет быстро и без ошибок обновить реквизиты в массовых базах данных. Попробуйте готовый шаблон решения по ссылке.

2. Проверка, есть ли ИНН в Битрикс24 и заполнение этого поля данными из DaData

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

Указываем, что получаем данные из Битрикс24 при создании компании.

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

2.2.1. Проверка на ИНН и Реквизиты

• Дополнительная проверка, что ИНН заполнен

Используем проверку по полю source.UF_CRM_1738820758676. Условие - не пустое значение, действие - продолжить, если проверка пройдена.

• Проверить наличие сущности "Реквизиты"

Используем API-запрос методом GET с указанием урла /crm.requisite.list?filter[ENTITY_ID]={{source.ID}}.

• Если реквизиты пустые, тогда продолжить

Используем проверку по полю step2.result. Условие - пустое значение, действие - продолжить, если проверка пройдена.

2.2.2. Запрос в DaData

• Запрос в DaData

Используем API-запрос методом POST с указанием урла /4_1/rs/findById/party.

Тело запроса: { "query": "{{source.UF_CRM_1738820758676}}" }

• Для каждых реквизитов

Используем инструмент Для каждого в поле step4.suggestions.

2.2.3. Статус организации

Используем инструмент Сопоставление данных по полю step16.data.state.status.

Настраиваем сопоставление статусов организации в реквизитах.

2.2.4. Дата последних изменений

• Дата последних изменений (Разделить)

Используем Математическое действие с полем step16.data.state.actuality_date. Условие выполнения - step16.data.state.actuality_date.

• Дата последних изменений

Используем форматирование даты/времени в поле step6. Условие выполнения - step16.data.state.actuality_date. Укажем формат даты d.m.Y.

2.2.5. Дата государственной регистрации

• Дата государственной регистрации (Разделить)

Используем Математическое действие с полем step16.data.state.registration_date. Условие выполнения - step16.data.state.registration_date. Делим на 1000:

• Дата государственной регистрации

Используем Форматирование даты/времени в поле step8. Условие выполнения - step16.data.state.registration_date. Формат даты/времени - d.m.Y.

2.2.6. Дата ликвидации

• Дата ликвидации (Разделить)

Используем Математическое действие с полем step16.data.state.liquidation_date. Условие выполнения - step16.data.state.liquidation_date. Делим на 1000.

• Дата ликвидации

Используем Форматирование даты/времени в поле step10. Условие выполнения - step16.data.state.liquidation_date. Формат даты/времени - d.m.Y.

2.2.7. Тип организации (Шаблона)

Используем инструмент Сопоставление данных по полю step16.data.type. Сопоставляем типы организаций.

2.2.8. Дата выдачи ОГРН (Разделить)

Используем Математическое действие с полем step16.data.ogrn_date. Условие выполнения step16.data.ogrn_date. Делим на 1000:

• Дата выдачи ОГРН

Используем Форматирование даты/времени в поле step13. Условие выполнения - step16.data.ogrn_date. Формат даты/времени - d.m.Y.

2.2.9. Тип подразделения

Используем инструмент Сопоставление данных по полю step16.data.branch_type. Сопоставляем типы подразделений.

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

Заполняем реквизиты в компаниях Битрикс24.

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

Сопоставляем поля в реквизитах:

ID типа родительской сущности - 4

ID родительской сущности - ID компании

ID шаблона реквизитов - {{step12}}

Название реквизита - {{step16.value}}

ФИО - {{step16.data.fio.surname|default()}} {{step16.data.fio.name|default()}} {{step16.data.fio.patronymic|default()}}

Имя - {{step16.data.fio.name|default()}}

Фамилия - {{step16.fio.surname|default()}}

Сокращенное наименование организации - {{step16.data.name.short_with_opf|default()}}

Полное наименование организации - {{step16.data.name.full_with_opf|default()}}

Дата государственной регистрации - {{step9}}

Ген. директор - {{step16.data.management.name|default()}}

ИНН - {{step16.data.inn}}

КПП - {{step16.data.kpp}}

ОГРН - {{step16.data.ogrn}}

ОКПО - {{step16.data.okpo}}

ОКТМО - {{step16.data.oktmo}}

Добавим пользовательские сопоставления:

Статус организации

Тип: Тело

Название параметра: fields.UF_CRM_1743081575

Значение параметра: {{step5}}

Дата выдачи ОГРН

Тип: Тело

Название параметра: fields.UF_CRM_1743146306

Значение параметра: {{step14}}

Внутренний идентификатор в Дадате

Тип: Тело

Название параметра: fields.UF_CRM_1743146317

Значение параметра: {{step16.data.hid}}

ОКАТО

Тип: Тело

Название параметра: fields.UF_CRM_1743146398

Значение параметра: {{step16.data.okato|default()}}

ОКОГУ

Тип: Тело

Название параметра: fields.UF_CRM_1743146412

Значение параметра: {{step16.data.okogu|default()}}

ОКФС

Тип: Тело

Название параметра: fields.UF_CRM_1743146417

Значение параметра: {{step16.data.okfs|default()}}

ОКВЭД

Тип: Тело

Название параметра: fields.UF_CRM_1743146428

Значение параметра: {{step16.data.okved|default()}}

Дата последних изменений

Тип: Тело

Название параметра: fields.UF_CRM_1743146538

Значение параметра: {{step7}}

Дата ликвидации

Тип: Тело

Название параметра: fields.UF_CRM_1743146547

Значение параметра: {{step11}}

Количество филиалов

Тип: Тело

Название параметра: fields.UF_CRM_1743146584

Значение параметра: {{step16.data.branch_count|default()}}

Тип подразделения

Тип: Тело

Название параметра: fields.UF_CRM_1743146595

Значение параметра: {{step15}}

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

Запускаем интеграцию.

3. Добавление адреса

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

Забираем данные из Пинкит, если предыдущая интеграция отработала с успехом:

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

Пропускаем.

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

Добавляем адрес в карточку компании.

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

Сопоставляем поля в адресе.

Идентификатор типа адреса. Элемент перечисления «Тип адреса» - 6

Идентификатор типа родительского объекта - 8

Идентификатор родительского объекта (реквизит или лид) - {{source.int9402.result.result}}

Улица, дом, корпус, строение - {{source.int9402.step16.data.address.data.street_with_type}} {{source.int9402.step16.data.address.data.house_type_full|default()}} {{source.int9402.step16.data.address.data.house|default()}}

{{source.int9402.step16.data.address.data.block_type_full|default()}} {{source.int9402.step16.data.address.data.block|default()}}

Квартира / офис - {{source.int9402.step16.data.address.data.flat_type_full|default()}} {{source.int9402.step16.data.address.data.flat|default()}}

Город - {{source.int9402.step16.data.address.data.city|default()}}

Почтовый индекс - {{source.int9402.step16.data.address.data.postal_code|default()}}

Район - {{source.int9402.step16.data.address.data.city_district_with_type|default()}}

Страна - {{source.int9402.step16.data.address.data.country|default()}}

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

Запускаем.

Резюмируем

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

Она ежедневно проверяет все компании в базе: если в поле "ИНН" указаны данные, а реквизиты отсутствуют, интеграция автоматически обновляет карточки актуальной информацией из DaData.

Это не только сэкономит ваше время, но и гарантирует точность данных в базе.

Попробуйте готовый шаблон интеграции здесь.

Если у вас есть вопросы, пишите нам в Телеграм или WhatsApp.

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

Также вы можете самостоятельно протестировать Пинкит, для этого зарегистрируйтесь в личном кабинете по ссылке: https://lk.pinkit.io/register.

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