Проверить контрольные разряды ИНН и ОГРН
Робот «Проверить контрольные разряды ИНН и ОГРН» проверяет длину, цифры и контрольные разряды реквизита перед сохранением или передачей.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Менеджеру, который собирает реквизиты клиента, и администратору, добавляющему формальную проверку перед созданием документов.
Пропущенная цифра или неверный контрольный разряд часто обнаруживается уже при подготовке договора. Робот отдельно проверяет формат и контрольные разряды выбранного типа реквизита. Это помогает вернуть данные на исправление раньше, но не заменяет проверку регистрации организации.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
Тип реквизита (PROFILE) |
Обязательное поле. ИНН организации, 10 цифр (inn10); ИНН физлица, 12 цифр (inn12); ОГРН, 13 цифр (ogrn); ОГРНИП, 15 цифр (ogrnip) |
Реквизит строкой (VALUE) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Явно выберите профиль: ИНН организации, ИНН физлица, ОГРН или ОГРНИП. Длина значения зависит от этого выбора.
- Передайте номер строкой без пробелов и разделителей. Сохраните ведущие нули; не преобразуйте реквизит в число перед проверкой.
- После выполнения проверьте общий статус, затем «Проверка пройдена». Неверный номер может дать успешный статус действия с отрицательным результатом проверки.
- Используйте отдельные признаки формата и контрольных разрядов для сообщения об исправлении. Не допускайте зависимое заполнение документа только на основании успешного статуса.
Учебный пример и ожидаемый результат
Для профиля inn10 передайте учебное заведомо неверное значение 123. Ожидается отрицательный результат и некорректный формат, поскольку для ИНН организации нужно 10 цифр. Номер из десяти нулей также не проходит проверку. Эти примеры не используют реквизиты реального клиента.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Проверка пройдена» (
valid). - «Формат корректен» (
formatValid). - «Контрольные разряды совпадают» (
checksumValid). - «Результат проверки» (
reason). - «Профиль» (
profile).
«Результат проверки» содержит причину, «Профиль» возвращает выбранный тип. Положительный формат ещё не гарантирует совпадение контрольных разрядов. Проверяйте итоговый признак valid, а частные результаты используйте для понятного сообщения ответственному.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Явный профиль: ИНН организации (10 цифр), ИНН физлица (12), ОГРН (13), ОГРНИП (15). Значение передается строкой без пробелов; ведущие нули не удаляются. Значение из одних нулей отклоняется. Ошибка номера возвращает valid=N при успешном выполнении проверки. Проверка формальная: не подтверждает регистрацию, владельца или актуальность реквизита. Банковские счета не проверяются.
Робот не подтверждает существование организации, владельца номера и актуальность сведений. Банковские счета не проверяются. Если нужен статус из государственного реестра, добавьте отдельный согласованный источник и не выдавайте формальную проверку за такую сверку.