Робот «Найти компанию по ИНН (реквизиты CRM)» помогает понять, есть ли компания с таким ИНН уже в CRM, чтобы избежать дублей и работать с существующей карточкой.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру CRM и администратору, который ищет существующую компанию по ИНН, сохранённому в её реквизитах.
ИНН не всегда хранится отдельным полем компании. Поиск по названию может дать похожую организацию. Робот ищет по реквизитам, собирает уникальные ID компаний и позволяет увидеть, когда с одним ИНН связаны несколько карточек.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ИНН компании (inn) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Передайте ИНН строкой из 10 или 12 цифр. Пробелы и нецифровые символы при нормализации удаляются, но исходные значения лучше подготовить заранее.
- Убедитесь, что нужный ИНН записан именно в реквизитах компаний CRM. Другие текстовые поля этим роботом не ищутся.
- Проверьте статус и count. При нескольких найденных компаниях не продолжайте с первой без принятого бизнес-правила.
- Используйте companyIds для перебора, companyId для первого найденного результата и requisiteIds для проверки, какие записи реквизитов дали совпадение.
Учебный пример и ожидаемый результат
В учебной CRM у компании 51 есть реквизит с заранее заданным ИНН. Передайте тот же номер. Ожидаются ID 51 в списке компаний и ID соответствующего реквизита. Если такой ИНН сохранён у двух компаний, count будет 2, список уникальных ID содержит обе. Робот не утверждает, что первая карточка предпочтительнее второй.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ИНН (нормализованный)» (
inn). - «Первый найденный ID компании» (
companyId). - «Список уникальных ID компаний» (
companyIds), список значений. - «Список ID найденных реквизитов» (
requisiteIds), список значений. - «Количество найденных компаний» (
count).
В этом роботе отсутствие компании выражается отрицательным статусом и пояснением «Компания с указанным ИНН не найдена». Это отличается от технического сбоя чтения, но не является успешным найденным результатом. inn возвращает нормализованное значение для сверки.
Сопоставляйте статус с текстом ошибки: отрицательный результат может означать обычное отсутствие компании по ИНН. Для дальнейшей обработки нужен найденный ID. Не записывайте пустой companyId в обязательное поле связи.
Ограничения и разбор ошибок
ИНН нормализуется до цифр и должен содержать 10 или 12 знаков. Поиск выполняется по реквизитам компаний. Компания с несколькими найденными реквизитами включается в список компаний один раз. При отсутствии совпадений status=N, companyId отсутствует, списки пустые, count=0.
Длина ИНН проверяется, контрольные разряды этим поиском не подтверждаются. Робот не обращается к государственному реестру и не создаёт компанию. Дубликаты CRM остаются отдельными карточками; для их разбора используйте отдельный процесс.