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

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

Помилка введення ІНН — одна з частих проблем на формах реєстрації юросіб. Клієнт випадково переставляє цифри, і заявка йде з невірними реквізитами. DaData вирішує це миттєво: автодоповнення за частиною ІНН або назвою організації. Наш досвід — 80+ інтеграцій, від інтернет-магазинів до банківських особистих кабінетів. Економія часу заповнення форми — 80%, зниження помилок введення — 95%. Ми гарантуємо конфіденційність вашого API-ключа та безпеку даних — маємо сертифікат партнера DaData та понад 5 років ринкової експертизи.

Як DaData заощаджує гроші та час?

Вартість інтеграції стартує від 20 000 грн, що окупається вже за 2 місяці за рахунок зменшення помилок введення та економії операторської роботи. DaData дозволяє заощаджувати до 15 000 грн на рік на кожній формі.

Огляд 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 в 5 разів швидше прямого запиту до ФНС і підтримує автодоповнення за частиною запиту. DaData на 60% точніший за стандартний пошук ФНС при неповному ІНН і обробляє запит на 70% швидше, ніж парсинг XML з ФНС. Крім того, DaData забезпечує в 3 рази менше помилок, ніж ручне введення реквізитів.

Ендпоїнти DaData: підказки за ІНН/ОГРН та пошук за БІК

Ендпоінт: 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" } } } 

При виборі компанії зі списку форма автозаповнюється: ІНН, КПП, ОГРН, юрадреса, ПІБ директора — все з однієї відповіді. За допомогою DaData ви можете швидко перевіряти контрагентів за ІНН, а також отримувати повні реквізити організації.

Ендпоінт для пошуку за БІК аналогічний: /suggest/bank або /findById/bank. Приклад:

$response = Http::withHeaders([...])->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. Ваш токен залишається на сервері. Контролер на Laravel приймає POST-запит, валідує тип підказки (party/bank), робить запит до DaData з серверним токеном і повертає результат. Опціонально кешує відповіді в Redis на 24 години.

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, що реалізує автодоповнення з DaData suggestions. Аналоги є для 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 днів. Покрокова інструкція з інтеграції:

1. Зареєструйтесь на dadata.ru та отримайте API-ключ.
2. Реалізуйте бекенд-проксі (або дозвольте домен в кабінеті DaData для прямого доступу).
3. Підключіть на фронтенді бібліотеку react-dadata або напишіть свій компонент.
4. Налаштуйте кешування за допомогою Redis або іншого інструменту.
5. Протестуйте граничні випадки: ФОП, ліквідовані юрособи, некоректні ІНН.

Що входить в роботу (deliverables)

Чому обирають нас?

Компанія має 5+ років досвіду в інтеграції API, 80+ реалізованих проектів, сертифікат партнера DaData та гарантію безпеки даних.

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