Скилл DaData в Aizor: как подключить и проверять адреса, ФИО и компании по ИНН

Что даёт скилл DaData в Aizor

Официальное описание скилла от команды Aizor: нормализация и подсказки адресов, ФИО, телефонов, email и банков, поиск контрагентов по ИНН/ОГРН через API DaData. Агент приводит данные к единому виду и достаёт реквизиты.

Скилл пригодится тем, у кого есть таблица клиентов с кривыми адресами и телефонами, а также бухгалтеру или менеджеру, которому часто нужно проверить контрагента по ИНН. Задачу вы формулируете обычными словами. Если списки лежат в таблице, посмотрите скилл Google Таблиц.

Что понадобится

• Регистрация на dadata.ru и подтверждённая почта: без подтверждения методы стандартизации отвечают ошибкой 403.
• API-ключ и секретный ключ из личного кабинета.
• Установленный Aizor (macOS или Windows) и скилл из каталога.

Документация не требует отдельной заявки на доступ. Достаточно зарегистрироваться и подтвердить почту.

Как получить ключ API: по шагам

1. Зарегистрируйтесь на dadata.ru и подтвердите адрес почты по письму.
2. Войдите в личный кабинет. В нём находятся API-ключ и секретный ключ. Конкретные названия разделов зависят от текущего вида кабинета.
3. Скопируйте оба ключа. API-ключ нужен для подсказок и поиска компании, оба ключа вместе нужны для стандартизации.
4. Посмотрите баланс и тариф. После регистрации автоматически включается бесплатный тариф.

В запросах ключи передаются в заголовках: Authorization: Token ваш_API-ключ и, для стандартизации, X-Secret: ваш_секретный_ключ. Срок действия ключей в документации не указан.

В Aizor установите скилл DaData из каталога и вставьте оба ключа в его настройки. Все подключаемые сервисы собраны в рубрике о скиллах.

Проверка: первые запросы агенту

• «Найди компанию по ИНН 7721581040 и покажи название и юридический адрес» (только чтение).
• «Подскажи полный адрес по строке: мск сухонска 11/-89» (только чтение).
• «Приведи этот телефон к единому формату» (только чтение).
• «Приведи в порядок адреса в этой таблице» (массовая обработка: она расходует платные запросы, включите подтверждение).

Сценарии автоматизации

Чистка адресов в базе клиентов

Вы даёте агенту список адресов, он разбирает их на регион, город, улицу и дом и возвращает таблицу. Стандартизация платная, поэтому для большого списка оцените стоимость заранее.

Проверка контрагента

Перед сделкой вы пишете ИНН, а агент возвращает реквизиты компании. По справке метод поиска по ИНН или ОГРН возвращает все доступные сведения о компании. Запросов хватит на ежедневные проверки в рамках бесплатного лимита.

Единый формат телефонов и ФИО

Агент приводит телефоны и ФИО в таблице к одному виду. Это удобно перед рассылкой или загрузкой в CRM.

Реквизиты банка для документов

Вы называете банк или БИК, агент находит реквизиты и подставляет их в шаблон. Раз в неделю его можно просить проверить, нет ли ошибок в сохранённых реквизитах.

Частые ошибки

Что видите	Причина	Что делать
401	В запросе нет API-ключа или секретного ключа	Проверьте, что в настройках скилла указаны оба ключа
403	Не подтверждена почта, указан несуществующий ключ или исчерпан дневной лимит	Подтвердите почту, проверьте ключ в кабинете, посмотрите остаток лимита
429	Слишком много запросов в секунду или новых соединений в минуту	Снизьте темп: для стандартизации лимит 20 запросов в секунду с одного IP, для поиска компании и банков 30
405	Метод стандартизации вызван не методом POST	Обычно это ошибка настройки интеграции, обратитесь в поддержку скилла
400	Некорректный запрос	Проверьте, что передана корректная строка, для поиска компании запрос не длиннее 300 символов

Про лимиты подробнее. Если исчерпать дневной лимит, сервисы по подписке отключаются до 00:00 следующего дня. Лимит общий для всех сервисов подписки. Если нужно больше, нужно перейти на тариф с большим лимитом. В справке DaData названы тарифы «Лёгкий» (14 000 ₽ в год, 50 000 запросов в день) и «Расширенный» (28 000 ₽ в год, 100 000 запросов в день). Актуальные цены смотрите на странице цен DaData.

Безопасность

• Секретный ключ позволяет тратить деньги вашего аккаунта. Не отправляйте его в чаты и не публикуйте в таблицах.
• DaData не поддерживает вызов стандартизации из браузерного JavaScript именно из-за риска кражи ключа. Держите ключи только в настройках скилла.
• Массовые операции со стандартизацией оставьте под ручным подтверждением: каждая запись платная.
• Регулярно смотрите баланс в кабинете. У DaData есть метод, который возвращает баланс пользователя.
• Если ключ мог утечь, замените его в личном кабинете и обновите настройки скилла.
• Не загружайте персональные данные без необходимости. ФИО и телефоны клиентов относятся к персональным данным.

Инструкция написана по официальной документации DaData (dadata.ru/api и dadata.ru/pricing), состояние на октябрь 2026 года. Интерфейс кабинета и условия могут измениться. Автор Aizorlab участвует в партнёрской программе Aizor.