CRM роботы 2.0 + AI (300+ роботов)

Проверить комплектность конкретного реквизита

Робот «Проверить комплектность конкретного реквизита» проверяет заполнение обязательных полей одного реквизита и выбранные правила формата.

Настройки робота «Проверить комплектность конкретного реквизита» в Битрикс24

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую задачу решает

Менеджеру документов и администратору CRM, который проверяет конкретный набор реквизитов перед договором или счётом.

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

Параметры и подготовка

Поле	Как заполнить
ID реквизита (`REQUISITE_ID`)	Обязательное поле
Обязательные поля (JSON-массив) (`REQUIRED_FIELDS`)	Обязательное поле
Профиль проверки (`PROFILE`)	Обязательное поле. по умолчанию `filled`. Только заполнение (`filled`); Россия: организация (`ru_company`); Россия: ИП (`ru_ip`); Россия: физлицо (`ru_person`)

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

Как использовать

Получите ID конкретного реквизита: например, результатом выбора реквизитов клиента. Не подставляйте ID самой компании.
Перечислите REQUIRED_FIELDS JSON-массивом кодов, обязательных для вашего документа. Профиль не расширяет этот список автоматически.
Выберите filled для проверки заполнения либо российский профиль организации, ИП или физлица для проверки выбранных ИНН и регистрационного номера.
После статуса проверьте ready. Разберите missing, unknown и invalid отдельно: заполнение, неполученные данные и формальные ошибки требуют разных действий.

Как заполнить JSON-поля

Обязательные поля (JSON-массив) (`REQUIRED_FIELDS`)

[
  "RQ_INN",
  "RQ_KPP"
]

От 1 до 50 разных кодов доступных полей. Профиль сам не добавляет обязательные поля. [] запрещён. Коды берите из схемы реквизита, ID реквизита из предыдущего выбора.

Это массив: внешние квадратные скобки обязательны. Пустой массив [] отличается от объекта {}; возможность пустого списка определяется правилами этого поля, описанными ниже.

Учебный пример и ожидаемый результат

Для учебного реквизита 81 укажите REQUIRED_FIELDS=["RQ_INN","RQ_KPP"], PROFILE=filled. Если ИНН заполнен, а КПП пустой, ready выключен и missing содержит RQ_KPP. Если поле вообще не пришло в ответе, оно попадёт в unknown. При ru_company формально проверяется ИНН из выбранного списка, но ОГРН не становится обязательным без добавления RQ_OGRN.

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

Что возвращает и как продолжить процесс

«Комплектность подтверждена» (ready).
«Пустые обязательные поля» (missing), список значений.
«Поля, не переданные в ответе» (unknown), список значений.
«Причины ошибок формата в JSON» (invalid).
«ID реквизита» (requisiteId).

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

Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.

Ограничения и разбор ошибок

Принимает ID реквизита, JSON-массив из 1–50 обязательных полей и явный профиль: только заполнение, российская организация, ИП или физлицо. Российские профили дополнительно проверяют выбранные ИНН и ОГРН/ОГРНИП по контрольным разрядам. Формат КПП и банковских счетов не проверяется. Профиль сам по себе не делает поле обязательным: обязательность задаёт список. Отсутствующее в ответе поле не считается пустым: возвращается отдельно как unknown, готовность: Нет. Нулевые числа и false не считаются пустыми. Возвращает готовность, пустые и неизвестные поля, JSON причин некорректного формата. Проверка не подтверждает регистрацию или действительность реквизитов и ничего не меняет.

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