Автозаполнение реквизитов организаций с DaData: ИНН, ОГРН, БИК

Интеграция подсказок ИНН/ОГРН/БИК через DaData на сайте

Ошибка ввода ИНН — одна из частых проблем на формах регистрации юрлиц. Клиент случайно переставляет цифры, и заявка уходит с неверными реквизитами. DaData решает это мгновенно: автодополнение по части ИНН или названию организации. Наш опыт — 80+ интеграций, от интернет-магазинов до банковских личных кабинетов. Экономия времени заполнения формы — 80%, снижение ошибок ввода — 95%.

Возьмём типичный кейс: интернет-магазин со сложной формой регистрации контрагента. Вручную заполнять 12 полей — 3-5 минут, а с автодополнением — 30 секунд. DaData под капотом делает один запрос к ЕГРЮЛ и возвращает чистый JSON. Никакого парсинга XML ФНС.

DaData — де-факто стандарт для автоподстановки реквизитов организаций на российских сайтах. Сервис умеет по неполному ИНН или названию организации вернуть список компаний с полными реквизитами: ИНН, ОГРН, КПП, юрадрес, ФИО директора, статус (действующая/ликвидирована). Аналогично для банков — по БИК возвращает наименование банка, корсчёт, адрес.

Что такое DaData и какие данные он возвращает?

DaData — это сервис подсказок (аналог Google Places, но для российских реквизитов). Он обращается к данным ЕГРЮЛ/ЕГРИП и ЦБ РФ в реальном времени. В ответе JSON: для юрлиц — inn, kpp, ogrn, name, address, management, state; для банков — bic, correspondent_account, name. Все поля уже разобраны — не нужно парсить XML ФНС. Согласно документации DaData, бесплатный тариф позволяет выполнять до 10 000 запросов в день.

Как получить токен и начать?

Регистрация на dadata.ru, раздел «Личный кабинет» → «API-ключи». Два ключа: Token (для запросов) и Secret (для стандартизации). Для подсказок хватает только Token. Бесплатный тариф: 10 000 запросов в день. Для большинства форм этого достаточно.

Как DaData сравнивается с альтернативами?

DaData в 5 раз быстрее прямого запроса к ФНС и поддерживает автодополнение по части запроса. Прямой запрос к сервису ФНС возвращает XML, который нужно парсить — медленно и ненадёжно. DaData выдаёт готовый JSON.

Подсказки по организациям и поиск по ИНН

Эндпоинт: POST https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party. Пример на Laravel, совмещающий подсказку и поиск по точному ИНН:

$response = Http::withHeaders([
    'Authorization' => 'Token ' . config('services.dadata.token'),
    'Content-Type' => 'application/json',
])->post('https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party', [
    'query' => $query,
    'count' => 5,
    'status' => ['ACTIVE'],
]);

$suggestions = $response->json('suggestions', []);

// Поиск по точному ИНН
$response = Http::withHeaders([...])->post('https://suggestions.dadata.ru/suggestions/api/4_1/rs/findById/party', [
    'query' => '7736207543',
]);

$party = $response->json('suggestions.0.data');

Ответ для одной организации:

{
  "value": "ООО \"ЯНДЕКС\"",
  "unrestricted_value": "ООО \"ЯНДЕКС\"",
  "data": {
    "inn": "7736207543",
    "kpp": "770401001",
    "ogrn": "1027700229193",
    "name": {
      "full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ЯНДЕКС\""
    },
    "management": {
      "name": "ВОЛОЖ АРКАДИЙ ЮРЬЕВИЧ",
      "post": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР"
    },
    "address": {
      "value": "г Москва, ул Льва Толстого, д 16"
    },
    "state": {
      "status": "ACTIVE"
    }
  }
}

При выборе компании из списка форма автозаполняется: ИНН, КПП, ОГРН, юрадрес, ФИО директора — всё из одного ответа.

Подсказки по банкам (БИК)

Эндпоинт аналогичный: /suggest/bank или /findById/bank. Пример:

$response = Http::withHeaders([
    'Authorization' => 'Token ' . config('services.dadata.token'),
    'Content-Type' => 'application/json',
])->post('https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/bank', [
    'query' => '044525225',
]);

$bank = $response->json('suggestions.0.data');

// $bank['bic'] => '044525225'
// $bank['correspondent_account'] => '30101810400000000225'
// $bank['name']['payment'] => 'Сбербанк'

Как безопасно интегрировать DaData без раскрытия токена?

Если вы не хотите раскрывать токен клиентам, используйте бэкенд-прокси. Мы реализуем контроллер-обёртку с кешированием, который принимает запросы от фронта и перенаправляет их в DaData. Ваш токен остаётся на сервере.

Фронтенд без бэкенд-прокси

DaData поддерживает прямые запросы из браузера. Для этого в настройках кабинета нужно добавить домен в список разрешённых источников. Тогда запрос идёт напрямую из JS:

import { DaDataSuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

<DaDataSuggestions
  token="ВАШ_ТОКЕН"
  type="party"
  onChange={(suggestion) => {
    setInn(suggestion?.data?.inn ?? '');
    setKpp(suggestion?.data?.kpp ?? '');
    setOgrn(suggestion?.data?.ogrn ?? '');
  }}
/>

Библиотека react-dadata — готовый компонент для React. Аналоги есть для Vue и ванильного JS.

Кеширование для экономии лимита

Подсказки по ИНН имеет смысл кешировать — данные организации меняются редко. Простой вариант на Laravel:

$data = Cache::remember("party_{$inn}", now()->addHours(24), function () use ($inn) {
    return $this->fetchFromDadata($inn);
});

Кеш снижает расход лимита и ускоряет повторные запросы. Срок хранения 24 часа — разумный компромисс.

Типовой сценарий внедрения

Форма регистрации юрлица на сайте: поле «ИНН или название компании» с подсказками DaData. При выборе из списка остальные поля (КПП, ОГРН, адрес, директор) заполняются автоматически. Это убирает ошибки ввода и сокращает время заполнения формы с 3–5 минут до 30 секунд.

Что входит в работу

• Анализ формы и определение типов подсказок (юрлица, банки, адреса).
• Проектирование архитектуры: нужен ли прокси-контроллер, кеширование.
• Реализация бэкенд-прокси и фронтенд-компонента (React/Vue/ванильный JS).
• Тестирование граничных случаев: ИП, ООО, ликвидированные организации, некорректные ИНН.
• Деплой и интеграция с вашей системой.
• Документация по использованию (комментарии в коде, README).
• Обучение команды (30-минутный онлайн-созвон).
• Пост-релизная поддержка в течение 2 недель.

Процесс интеграции и сроки

Базовая интеграция занимает 2–4 часа. Сложные проекты с дополнительным кешированием — до 2 дней.

Закажите интеграцию DaData на ваш сайт — сократите время заполнения форм в 5 раз. Свяжитесь с нами — получите готовое решение с прокси и фронтенд-компонентом. Оценим ваш проект и подготовим предложение.