Найти организацию по ИНН (DaData)
Что делает робот
Робот принимает ИНН и возвращает полную карточку организации из справочника DaData: реквизиты, адрес, руководителя, статус, ОКВЭД, число сотрудников и финансовые показатели. Один ИНН на входе — более шестидесяти полей на выходе. Карточка компании в CRM заполняется без ручного забивания данных с выписки ЕГРЮЛ.
Робот лежит в разделе «Компании» каталога приложения.
Что возвращает
Полный набор реквизитов: КПП, ОГРН с датой присвоения, ОКАТО, ОКТМО, ОКПО, ОКФС, основной ОКВЭД и его расшифровка, количество филиалов. Названия во всех вариантах — полное и краткое с ОПФ и без, латиницей. Отдельным блоком идут данные о состоянии компании: статус (действующая, в ликвидации, ликвидирована, реорганизация), даты регистрации и ликвидации, дата актуальности сведений.
Дальше — то, за что обычно и ставят робота: адрес одной строкой и разложенный по полям, руководитель с должностью и датой назначения, признак дисквалификации, число сотрудников, система налогообложения, уставный капитал. На старших тарифах DaData доступны учредители, финансы (выручка, доход, расход, долг, пени за год), лицензии, телефоны и email компании — они приходят в виде JSON-полей, которые разбираются следующим шагом процесса.
Настройка
- ИНН — десять или двенадцать цифр. Подставляется из поля сделки, реквизитов компании или результата другого робота;
- API ключ и Secret ключ DaData — необязательно. Если заданы оба, запрос идёт с вашего аккаунта DaData и ест ваш тариф. Если пусто — работают ключи приложения.
В результате есть служебное поле, которое показывает, чьи ключи сработали — удобно проверить, чей лимит расходуется.
Кэш на семь дней
Повторный запрос по тому же ИНН в течение недели не ходит в DaData: робот отдаёт сохранённый результат мгновенно и не тратит лимит. Это важно, когда один контрагент проверяется в нескольких процессах — на создании сделки, перед выставлением счёта, при отгрузке. Кэш привязан к паре «ИНН + ключи», так что смена аккаунта DaData не смешивает данные.
Сценарии из практики
Мгновенное заполнение карточки компании. Менеджер вписал в реквизиты только ИНН. Процесс вызывает робота, следующие шаги записывают в карточку название с ОПФ, адрес, ОГРН и руководителя. Десять секунд вместо похода на сайт налоговой.
Фильтр на входе в воронку. Новый лид с ИНН проверяется автоматически: статус не «действующая» или компания ликвидирована — сделка не создаётся, ответственному уходит уведомление. Дисквалифицированный руководитель — отдельный стоп-фактор. Для более жёсткой проверки связку дополняют роботом «Проверить компанию в чёрном списке ЦБ РФ».
Сегментация по масштабу клиента. По числу сотрудников и выручке процесс раскидывает новые компании по сегментам: микробизнес — на самообслуживание, средний бизнес — на выделенного менеджера.
Типичные ошибки
«Не указан ИНН». Поле пустое — переменная не подставилась или в источнике ИНН хранится с пробелами и буквами. Очищайте значение до цифр перед вызовом.
«Не заданы ключи DaData». Возникает, когда своих ключей нет, а ключи приложения не настроены. Заполните оба поля ключей в настройках робота — пара API + Secret работает только вместе.
Пустые поля в результате. Не ошибка, а тариф DaData: учредители, финансы, лицензии и контакты отдаются только на расширенном и максимальном тарифах. На бесплатном тарифе эти поля приходят пустыми.
«Ошибка DaData: …». Текст подскажет причину: неверный ключ, превышен дневной лимит запросов или сервис недоступен. При лимите помогает кэш — повторные ИНН неделю обрабатываются бесплатно.