Реквизиты компании по ИНН: форма, которая заполняется сама

Где это нужно

• Счёт, договор или акт в CRM: менеджер заводит нового клиента за пару секунд.
• Регистрация юрлица в личном кабинете B2B-магазина или маркетплейса.
• Анкета поставщика и заявка на кредит или лизинг для бизнеса.
• Любая форма, где реквизиты сейчас переписывают руками из выписки.

Как подключить

Понадобится публичный ключ — он выдаётся сразу после регистрации. Скрипт подключается на страницу один раз, всё остальное задаётся атрибутами полей. Полю компании ставим data-hintdata="party", а атрибуты data-fill-… говорят, какое значение из карточки в какое поле положить.

<script src="https://api.hintdata.ru/widget.js" data-key="pk_ваш_ключ"></script>

<label for="company">Компания или ИНН</label>
<input id="company" data-hintdata="party"
  data-fill-inn="#inn" data-fill-kpp="#kpp" data-fill-ogrn="#ogrn"
  data-fill-address-value="#address" data-fill-management-name="#director">

<label for="inn">ИНН</label>
<input id="inn">
<label for="kpp">КПП</label>
<input id="kpp">
<label for="ogrn">ОГРН</label>
<input id="ogrn">
<label for="address">Юридический адрес</label>
<input id="address">
<label for="director">Руководитель</label>
<input id="director">

Что можно разложить по полям

Тонкости, о которых стоит знать заранее

• Искать можно по ИНН, ОГРН и по названию — человек вводит то, что у него под рукой.
• Адрес и ФИО руководителя приходят в том виде, как они записаны в ЕГРЮЛ, — заглавными буквами. Если в документах нужен другой регистр, приведите его при сохранении.
• Ликвидированные компании тоже находятся. Перед сделкой проверяйте статус — его можно положить в скрытое поле через data-fill-state-status.
• Поля, которых нет на странице, виджет пропускает молча: лишний атрибут ничего не сломает.
• В заполненные поля уходят события input и change, поэтому React, Vue и Angular видят новые значения без доработок.

Частые вопросы

Нужен ли свой сервер, чтобы так сделать?

Нет, виджет работает в браузере с публичным ключом. Сервер понадобится, только если реквизиты нужно перепроверить при сохранении: тогда поиск по ИНН вызывают из бэкенда секретным ключом.

Откуда данные о компаниях?

Из ЕГРЮЛ и ЕГРИП Федеральной налоговой службы. Дата актуальности записи приходит в карточке вместе с остальными полями.

Сколько это стоит?

Подсказки по компаниям входят в дневной лимит тарифа, на бесплатном — до 10 000 запросов в день. Запрос уходит не на каждую букву: виджет ждёт паузу в наборе и не повторяет одинаковые запросы.

А банк по БИК так же можно?

Да, отдельным полем — смотрите пример с банком по БИК.