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

Интеграция сайта с CRM: Битрикс24, amoCRM, Salesforce, HubSpot

Менеджер по продажам ведёт сделки в CRM, а заявки с сайта падают на почту. Он их вручную переносит. Теряет половину. Забывает перезвонить. Это не проблема менеджера — это архитектурная дыра между сайтом и процессами компании. Мы закрываем её интеграцией 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 подтверждает это.

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 считает доставку неудачной.

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).

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 выбрать: Битрикс24, amoCRM или HubSpot?

Почему важна асинхронная отправка?

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

Дедупликация. Один и тот же контакт может заполнить форму дважды. CRM не должна создавать два дублирующих лида. Проверка перед созданием: поиск по email через crm.duplicate.findByComm (Битрикс24) или contacts/search (HubSpot), если найден — добавляем задачу/комментарий к существующему, не создаём новый. Снижает количество дубликатов на 95% по опыту наших проектов.

Двусторонняя синхронизация. Если менеджер меняет статус сделки в CRM — сайт должен знать (например, для личного кабинета клиента). Webhooks от CRM → endpoint на сайте → обновление статуса в БД → уведомление клиенту. Важно: проверять подпись webhook и отвечать 200 OK быстро (до 5 секунд), иначе CRM считает доставку неудачной. Мы гарантируем, что задержка между изменением статуса в CRM и появлением на сайте не превышает 3 секунд.

Как мы проводим интеграцию: 5 шагов

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

Что входит в работу (deliverables)

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

Сроки и стоимость

Стоимость рассчитывается индивидуально после аудита текущих процессов и структуры данных в CRM. Экономия на ручном вводе — от 50 000 до 150 000 рублей в месяц. Типичный бюджет интеграции — от 40 000 до 200 000 рублей в зависимости от CRM и сложности. Свяжитесь с нами для оценки проекта — мы пришлём коммерческое предложение в течение одного рабочего дня. Опыт 5+ лет и 20+ проектов интеграций с различными CRM гарантирует результат без скрытых проблем. Получите консультацию инженера, чтобы убедиться: ваша воронка продаж начнёт работать без ручного переноса данных.

Дополнительные источники: Customer relationship management (Wikipedia) · REST API (Wikipedia)