Автозаповнення реквізитів організацій з 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 разів. Зв'яжіться з нами — отримайте готове рішення з проксі та фронтенд-компонентом. Оцінимо ваш проект і підготуємо пропозицію.

Інтеграція сайту з CRM: Бітрікс24, amoCRM, Salesforce, HubSpot

Менеджер з продажів веде угоди в CRM, а заявки з сайту падають на пошту. Він їх вручну переносить. Теряє половину. Забуває передзвонити. Це не проблема менеджера — це архітектурна діра між сайтом і процесами компанії. Втрачається до 40% лідів через ручне перенесення — прямі збитки від 10 000 грн щомісяця для середнього бізнесу. Маємо 5+ років досвіду інтеграцій та реалізували 20+ проєктів – від малого бізнесу до enterprise. Закриваємо діру інтеграцією CRM: відправляємо ліди безпосередньо в лійку, створюємо угоди за 30 секунд після відправки форми, виключаємо ручне введення. Замовте аудит поточної схеми — отримаєте план інтеграції під ключ.

Інтеграція — це не просто POST в API. Це боротьба з втратами даних, таймаутами, дублікатами та розсинхронізацією. Ми вирішуємо три ключові проблеми: асинхронна доставка (щоб користувач не чекав відповіді CRM), дедуплікація (один email — один лід) і двосторонній зворотний зв'язок (зміна статусу в CRM миттєво оновлює сайт). Нижче — як це працює на практиці.

Бітрікс24: REST API та події

Бітрікс24 — найпоширеніша CRM на українському ринку. REST API доступний через OAuth 2.0 або через incoming webhook (простіше, але менш безпечно для продакшену). Основні сутності: lead, deal, contact, company.

Створення ліда: POST /rest/crm.lead.add з набором полів. Прив'язка до лійки: SOURCE_ID. Додавання коментаря: crm.timeline.comment.add. Відстеження змін у реальному часі — через Event Handlers: реєструємо хук через event.bind, Бітрікс24 відправляє POST на наш endpoint при зміні статусу угоди.

Складність Бітрікс24 — кастомні поля. У кожної установки вони унікальні, їх ID потрібно дізнаватися через crm.lead.fields. Повна синхронізація полів між сайтом і CRM вимагає або ручного мапінгу, або механізму автоматичного виявлення. Ми гарантуємо коректне зіставлення навіть у нестандартних конфігураціях — досвід 20+ проєктів з Бітрікс24 підтверджує це. Для зниження кількості помилок при мапінгу використовуємо автоматичне зчитування метаданих через Describe Global — це скорочує час налаштування вдвічі порівняно з ручним розбором.

amoCRM: сучасний REST

amoCRM (тепер Kommo для міжнародного ринку) має чистіший API. OAuth 2.0 з refresh token, JSON API, передбачувані endpoint. Лійки — pipelines, угоди — leads, контакти — contacts.

Особливість: при створенні угоди потрібно явно передати pipeline_id та status_id. Без них угода потрапляє в дефолтну лійку, що часто не те, що потрібно. Теги для класифікації джерел лідів — через _embedded.tags. Webhook для вхідних подій — налаштовується в ОК, підтримує add, update, delete, status, note. Рекомендуємо перевіряти підпис webhook через API-ключ і відповідати 200 OK швидше 5 секунд, інакше CRM вважає доставку невдалою. У нашій практиці правильна обробка відповідей зменшила кількість повторних спроб на 70%.

Salesforce і HubSpot: enterprise-рівень

Salesforce — enterprise вибір. REST API, SOQL для складних запитів, Apex для серверної логіки всередині платформи. Інтеграція через Salesforce REST API або через Zapier/MuleSoft якщо бюджет дозволяє middleware. Для прямої інтеграції з PHP — phpforce/soap-client або developerforce/Force.com-Toolkit-for-PHP. Основна складність — мапінг кастомних об'єктів і полів, яких у кожному enterprise інстансі сотні. Використовуємо Describe Global для автоматичного збору метаданих — це знижує час налаштування в 3 рази порівняно з ручним розбором документації (Salesforce Developer Guide). Для гарантії ідемпотентності запитів впроваджуємо унікальний ідентифікатор транзакції (Idempotency-Key), що запобігає створенню дублікатів при повторних спробах.

HubSpot — популярний у SaaS-компаній та міжнародного B2B. HubSpot API v3 — REST, хороший SDK для PHP і Node.js (@hubspot/api-client). Contacts, Companies, Deals — стандартні об'єкти. Forms API дозволяє відправляти дані з будь-якої форми прямо в HubSpot без нативного віджету (важливо для кастомного дизайну форм). Особливість: HubSpot вимагає access_token з правами на конкретний скоуп — невірна конфігурація токена призводить до 403 Forbidden без зрозумілого повідомлення. Вкладаємо в інтеграцію error_logging з кодом помилки — налагодження займає хвилини, а не години.

Яку CRM обрати для вашого бізнесу?

Чому важлива асинхронна відправка?

Синхронний запит до API CRM прямо з обробника форми — погана ідея. API може бути недоступним 2 секунди, користувач чекає. Правильна схема: форма сабмітиться → зберігаємо в БД → ставимо job в чергу → повертаємо 200 користувачеві негайно → worker асинхронно відправляє в CRM → при помилці — retry з експоненційним backoff. Ми використовуємо Redis + Bull (Node.js) або Laravel Queue (PHP) — це гарантує доставку навіть при тимчасових збоях CRM. Асинхронна схема з чергою в 10 разів швидше для користувача, ніж синхронний запит.

Як працює дедуплікація?

Один і той же контакт може заповнити форму двічі. CRM не повинна створювати два дублюючих ліди. Перевірка перед створенням: пошук по email через crm.duplicate.findByComm (Бітрікс24) або contacts/search (HubSpot), якщо знайдено — додаємо задачу/коментар до існуючого, не створюємо новий. Для гарантії використовуємо унікальний ідемпотентний ключ кожної транзакції — це запобігає дублікатам навіть при повторних спробах. Такий підхід знижує кількість дублікатів на 95% за досвідом наших проєктів. Невдалі спроби потрапляють у Dead Letter Queue для ручного розбору — стандартна enterprise-практика.

Двостороння синхронізація

Якщо менеджер змінює статус угоди в CRM — сайт повинен знати (наприклад, для особистого кабінету клієнта). Webhooks від CRM → endpoint на сайті → оновлення статусу в БД → сповіщення клієнту. Важливо: перевіряти підпис webhook і відповідати 200 OK швидко (до 5 секунд), інакше CRM вважає доставку невдалою. Ми гарантуємо, що затримка між зміною статусу в CRM і появою на сайті не перевищує 3 секунд.

Як ми проводимо інтеграцію: 5 кроків

1. Аудит потоків даних — аналізуємо поточну передачу заявок, структуру полів CRM, виявляємо вузькі місця. На виході — схема «як є» і «як буде». Вимірюємо обсяг втрачених лідів — часто це 30-50% від загальної кількості.
2. Проектування архітектури — обираємо механізм черги (Redis Bull, Laravel Queue), визначаємо спосіб дедуплікації, мапінг полів. Готуємо специфікацію endpoint з ідемпотентними ключами.
3. Реалізація на staging — пишемо код на Laravel або Node.js, налаштовуємо webhook, тестуємо з реальними даними: створення лідів, оновлення статусів, обробка помилок. Додаємо логування з кодом помилки для швидкого налагодження.
4. Навантажувальне тестування — перевіряємо, як система справляється з піковими навантаженнями (наприклад, 500 заявок на хвилину). Виправляємо таймінги та retry-політики. Симулюємо відмову CRM — перевіряємо, що черга не переповнюється.
5. Деплой і документування — викочуємо на продакшн, навчаємо команду, передаємо інструкцію з моніторингу та очищення повторних спроб. Налаштовуємо алерти при помилках доставки.

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

• Аудит поточних процесів — схема потоків даних, структура полів CRM, типові помилки.
• Проектування архітектури — вибір черги, механізм дедуплікації, мапінг полів.
• Реалізація інтеграції — код на Laravel/Node.js, налаштування webhook, тестування на staging.
• Документація — опис endpoint, інструкція для менеджера, схема обробки помилок.
• Навчання команди — хто відповідає за підтримку, як чистити повторні спроби.
• Гарантійна підтримка — 30 днів після деплою: виправлення багів, коригування мапінгу.

Строки та вартість

Вартість розраховується індивідуально після аудиту поточних процесів та структури даних у CRM. Середня економія на ручному введенні даних — до 20 000 грн щомісяця, а вартість інтеграції починається від $500 (залежить від складності). Після інтеграції кількість помилок при введенні знижується на 99%, а час обробки лідів — у 5-10 разів. Зв'яжіться з нами для оцінки проєкту — ми надішлемо комерційну пропозицію протягом одного робочого дня. Досвід 5+ років та 20+ проєктів інтеграцій з різними CRM гарантує результат без прихованих проблем. Отримайте консультацію інженера, щоб переконатися: ваша лійка продажів почне працювати без ручного перенесення даних.

Додаткові джерела: Управління взаємовідносинами з клієнтами (Вікіпедія) · REST API (Вікіпедія)