Найти организацию по ИНН (DaData)

Робот «Найти организацию по ИНН (DaData)» помогает быстро обогатить карточку компании по ИНН и сократить ручное заполнение реквизитов.

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

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

Менеджеру, заполняющему сведения организации, и администратору CRM, который подготавливает данные контрагента по ИНН.

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

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

Поле	Как заполнить
ИНН (inn)	Обязательное поле
API ключ DaData (необязательно) (api_key)	Необязательное поле
Secret ключ DaData (необязательно) (secret_key)	Необязательное поле

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

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

1. Передайте ИНН непустой строкой в inn. Сверьте номер с источником до запроса.
2. Если используете собственный доступ, заполните одновременно api_key и secret_key. Иначе применяется настроенный доступ приложения при его наличии.
3. После выполнения проверьте status, затем заполненность нужных результатов. Пустой ответ списка может дать успешный запрос с пустыми полями, поэтому статус не равен найденной организации.
4. Подставьте выбранные поля в карточку отдельным действием после проверки. Сверьте data_inn и наименование с ожидаемым клиентом.

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

Для учебного сценария передайте ИНН организации, сведения которой разрешено использовать, и при необходимости свои тестовые ключи. Ожидается наименование в value и номер в data_inn, если сервис вернул организацию. Если вариантов несколько, робот использует первый ответ; отдельного интерфейса выбора кандидата нет.

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

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

• «Использованы ключи пользователя (Y/N)» (is_user_key).
• «value: Наименование компании» (value).
• «unrestricted_value: = value» (unrestricted_value).
• «data.inn: ИНН» (data_inn).
• «data.kpp: КПП» (data_kpp).
• «data.kpp_largest: КПП крупнейшего налогоплательщика» (data_kpp_largest).
• «data.ogrn: ОГРН» (data_ogrn).
• «data.ogrn_date: Дата выдачи ОГРН» (data_ogrn_date).
• «data.hid: Внутренний идентификатор в DaData» (data_hid).
• «data.type: Тип организации (LEGAL/INDIVIDUAL)» (data_type).
• «data.name.full_with_opf» (data_name_full_with_opf).
• «data.name.short_with_opf» (data_name_short_with_opf).
• «data.name.latin» (data_name_latin).
• «data.name.full» (data_name_full).
• «data.name.short» (data_name_short).
• «data.fio.surname» (data_fio_surname).
• «data.fio.name» (data_fio_name).
• «data.fio.patronymic» (data_fio_patronymic).
• «data.fio.gender» (data_fio_gender).
• «data.fio.source» (data_fio_source).
• «data.fio.qc» (data_fio_qc).
• «data.okato» (data_okato).
• «data.oktmo» (data_oktmo).
• «data.okpo» (data_okpo).
• «data.okogu» (data_okogu).
• «data.okfs» (data_okfs).
• «data.okved» (data_okved).
• «data.okved_type» (data_okved_type).
• «data.opf.code» (data_opf_code).
• «data.opf.full» (data_opf_full).
• «data.opf.short» (data_opf_short).
• «data.opf.type» (data_opf_type).
• «data.management.name» (data_management_name).
• «data.management.post» (data_management_post).
• «data.management.start_date» (data_management_start_date).
• «data.management.disqualified» (data_management_disqualified).
• «data.branch_count» (data_branch_count).
• «data.branch_type (MAIN/BRANCH)» (data_branch_type).
• «data.address.value» (data_address_value).
• «data.address.unrestricted_value» (data_address_unrestricted_value).
• «data.address.data.source» (data_address_data_source).
• «data.address.data.qc» (data_address_data_qc).
• «data.address.data (JSON)» (data_address_data_json).
• «data.address.invalidity (JSON)» (data_address_invalidity_json).
• «data.state.actuality_date» (data_state_actuality_date).
• «data.state.registration_date» (data_state_registration_date).
• «data.state.liquidation_date» (data_state_liquidation_date).
• «data.state.status» (data_state_status).
• «data.state.code» (data_state_code).
• «data.employee_count (Расширенный/Максимальный)» (data_employee_count).
• «data.finance.tax_system (Расширенный/Максимальный)» (data_finance_tax_system).
• «data.okveds[] (JSON) (Расширенный/Максимальный)» (data_okveds_json).
• «data.authorities (JSON) (Расширенный/Максимальный)» (data_authorities_json).
• «data.authorities.fts_registration (JSON)» (data_authorities_fts_registration_json).
• «data.authorities.fts_report (JSON)» (data_authorities_fts_report_json).
• «data.authorities.pf (JSON)» (data_authorities_pf_json).
• «data.authorities.sif (JSON)» (data_authorities_sif_json).
• «data.citizenship.code.numeric (Расширенный/Максимальный)» (data_citizenship_code_numeric).
• «data.citizenship.code.alpha_3 (Расширенный/Максимальный)» (data_citizenship_code_alpha_3).
• «data.citizenship.name.full (Расширенный/Максимальный)» (data_citizenship_name_full).
• «data.citizenship.name.short (Расширенный/Максимальный)» (data_citizenship_name_short).
• «data.founders[] (JSON) (Только Максимальный)» (data_founders_json).
• «data.managers[] (JSON) (Только Максимальный)» (data_managers_json).
• «data.predecessors[] (JSON) (Только Максимальный)» (data_predecessors_json).
• «data.successors[] (JSON) (Только Максимальный)» (data_successors_json).
• «data.capital.type (Только Максимальный)» (data_capital_type).
• «data.capital.value (Только Максимальный)» (data_capital_value).
• «data.finance (JSON) (Только Максимальный)» (data_finance_json).
• «data.finance.year» (data_finance_year).
• «data.finance.income» (data_finance_income).
• «data.finance.revenue» (data_finance_revenue).
• «data.finance.expense» (data_finance_expense).
• «data.finance.debt» (data_finance_debt).
• «data.finance.penalty» (data_finance_penalty).
• «data.documents (JSON) (Только Максимальный)» (data_documents_json).
• «data.documents.fts_registration (JSON)» (data_documents_fts_registration_json).
• «data.documents.fts_report (JSON)» (data_documents_fts_report_json).
• «data.documents.pf_registration (JSON)» (data_documents_pf_registration_json).
• «data.documents.sif_registration (JSON)» (data_documents_sif_registration_json).
• «data.documents.smb (JSON)» (data_documents_smb_json).
• «data.licenses[] (JSON) (Только Максимальный)» (data_licenses_json).
• «data.phones[] (JSON) (Только Максимальный)» (data_phones_json).
• «data.emails[] (JSON) (Только Максимальный)» (data_emails_json).
• «data.invalid (Только Максимальный) true/null» (data_invalid).
• «data.source (не заполняется)» (data_source).
• «data.qc (не заполняется)» (data_qc).

is_user_key сообщает, использован ли собственный комплект ключей. Результаты включают название, ИНН, КПП, ОГРН, адрес, состояние и другие поля. JSON-результаты содержат вложенные сведения; пустая строка не должна автоматически считаться пустым JSON-объектом.

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

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

Входы: ИНН и необязательная пара собственных ключей. Только оба заполненных ключа вместе выбирают собственный доступ; иначе применяется доступ приложения при наличии. Используется первый вариант ответа сервиса. Успешный пустой ответ оставляет поля пустыми. Некоторые данные доступны не во всех ответах.

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