Реквизиты компании по ИНН
Робот «Реквизиты компании по ИНН» создаёт реквизиты компании или ИП по ИНН и при необходимости дополняет их сведениями DaData.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую задачу решает
Администратору CRM, который подготавливает реквизит существующей компании по ИНН и при необходимости дополняет его сведениями DaData.
Создание реквизита без подходящего шаблона даёт неполный набор полей, а повторное создание приводит к дублям. Робот проверяет имеющиеся записи и совместимость российского шаблона для организации или ИП. Неоднозначные совпадения требуют решения пользователя.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ИНН (inn) |
Обязательное поле |
ID компании (companyId) |
Обязательное поле |
Получить сведения DaData (includeDadata) |
Необязательное поле |
Тип адреса (fieldsAddress) |
Необязательное поле. Юридический адрес (ur); Фактический адрес (fiz); Адрес регистрации (reg) |
Шаблон реквизитов (presetId) |
Необязательное поле. по умолчанию . Автоматически () |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Укажите существующую companyId и ИНН из 10 либо 12 цифр. Компания должна быть доступна пользователю интеграции.
- Выберите подходящий шаблон реквизитов либо оставьте автоматический выбор. Автоматический вариант требует единственного совместимого активного российского шаблона.
- Явно решите, получать ли сведения DaData. При включении нужен настроенный доступ приложения; найденная организация должна однозначно соответствовать ИНН.
- Выберите тип адреса: юридический ur, фактический fiz или регистрации reg. Адрес добавляется из полученных сведений только при подходящих условиях.
- После выполнения сохраните id реквизита. При ошибке сверяйте компанию: реквизит мог уже создаться до остановки следующего шага.
Учебный пример и ожидаемый результат
В учебной CRM подготовьте компанию 51, один совместимый российский шаблон и разрешённый для примера ИНН. При выключенном обогащении робот создаст минимальный реквизит по ИНН либо использует единственный совместимый существующий. Если найдены два реквизита с этим ИНН, действие остановится и попросит уточнить записи.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «ID реквизитов» (
id), список значений.
Возвращаемый id относится к реквизиту, а не к компании. Повторное использование существующего реквизита не означает, что все его поля будут обновлены данными DaData. Для детального чтения и проверки заполнения применяйте отдельные действия.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Пояснение ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Поддерживаются ИНН организации из 10 цифр и ИП из 12. Нужен совместимый активный российский шаблон; при неоднозначности выберите его явно. Единственный существующий совместимый реквизит используется повторно. При DaData требуется однозначное соответствие ИНН; уже существующий адрес не перезаписывается этим действием.
Робот не создаёт компанию и не переносит реквизиты между клиентами. Автоматический выбор шаблона не угадывает вариант при нескольких подходящих. При неизвестном результате сначала проверьте уже созданные записи, чтобы не получить повторное создание.