Подсказки: организации

Ищет компании и индивидуальных предпринимателей:

по ИНН, ИНН/КПП, ОГРН;
названию (полному и краткому);
ФИО (для индивидуальных предпринимателей);
ФИО руководителя компании;
адресу до улицы.

Что умеет

✔️ Ищет по комбинации ИНН, названия и адреса в одном запросе («7736050003 Газ» → «ПАО Газпром», «вавилова сбер» → «ПАО Сбербанк»).

✔️ Находит конкретный филиал, если указать в запросе КПП («сбербанк 540602001» → «Сибирский банк ПАО Сбербанк», «7812014560 272143001» → «Дальневосточный филиал ПАО Мегафон»).

✔️ Понимает слитное и раздельное написание («альфабанк» = «Альфа-Банк»).

✔️ Ищет по частичному совпадению в ИНН / ОГРН («77094209» → «ООО Акварель») и названиях («росне» → «ПАО «НК «Роснефть»).

✔️ Подсказывает только организации или только ИП, или и тех и других. Умеет искать только в действующих или ликвидированных компаниях. Может ограничить подсказки кодом ОКВЭД или конкретным регионом России.

✔️ Учитывает, где вы находитесь (определяет город по IP-адресу).

✔️ Возвращает основные реквизиты компании из ЕГРЮЛ: краткое и полное название, ОПФ, адрес, ОГРН, ИНН, КПП, ОКВЭД, статус организации, ФИО и должность руководителя.

✔️ Возвращает вагон дополнительной информации: количество сотрудников, все коды ОКВЭД, сведения о налоговой, ПФР и ФСС, документы и лицензии, учредители и руководители, финансовые показатели, реестр малого и среднего бизнеса.

❌ Для 25% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы можно найти по ИНН, городу и улице филиала. Например, «7724261610 москва мясницкая» → «Филиал ФГУП "Почта России" (г Москва)».

Как подключить

Вставьте код из примера на свой сайт.
Profit!

<input id="party" name="party" type="text" />
<link href="https://cdn.jsdelivr.net/npm/@dadata/suggestions@25.11.0/dist/suggestions.min.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/@dadata/suggestions@25.11.0/dist/suggestions.min.js"></script>

<script>
    const input = document.getElementById("party");
    Dadata.createSuggestions(input, {
        token: "${API_KEY}",
        type: "party"
    });
</script>

Параметр token — это API-ключ.

Демонстрация

Выберите вариант из списка, чтобы увидеть полный текст ответа в JSON:

Название, адрес, ИНН или ОГРН

Также работает через API

Что в ответе

Аргумент suggestion функции onSelect выглядит так:

Все тарифы

Название	Описание
value	Наименование компании
unrestricted_value	= value

data.inn	ИНН
data.kpp	КПП
data.kpp_largest	КПП крупнейшего налогоплательщика
data.ogrn	ОГРН
data.ogrn_date	Дата выдачи ОГРН
data.hid	Внутренний идентификатор в Дадате
data.type	Тип организации LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель

data.name	Наименование
└ full_with_opf	— полное наименование
└ short_with_opf	— краткое наименование
└ latin	— не заполняется
└ full	— полное наименование без ОПФ генерируется на основе full_with_opf, может содержать ошибки
└ short	— краткое наименование без ОПФ генерируется на основе short_with_opf, может содержать ошибки

data.fio	ФИО индивидуального предпринимателя
└ surname	— фамилия
└ name	— имя
└ patronymic	— отчество
└ gender	не заполняется
└ source	не заполняется
└ qc	не заполняется

	Коды статистики (только для действующих головных организаций и ИП):
data.okato	Код ОКАТО
data.oktmo	Код ОКТМО
data.okpo	Код ОКПО
data.okogu	Код ОКОГУ
data.okfs	Код ОКФС

data.okved	Код ОКВЭД
data.okved_type	Версия справочника ОКВЭД (2001 или 2014)

data.opf	Организационно-правовая форма
└ code	— код ОКОПФ
└ full	— полное название ОПФ
└ short	— краткое название ОПФ
└ type	— версия справочника ОКОПФ (99, 2012 или 2014)

data.management	Руководитель
└ name	— наименование руководителя (для юрлиц) или ФИО руководителя (для физлиц)
└ post	— должность руководителя (для физлиц)
└ start_date	— дата вступления в должность руководителя

data.branch_count	Количество филиалов
data.branch_type	Тип подразделения MAIN — головная организация BRANCH — филиал

data.address	Адрес
└ value	— адрес одной строкой: адрес организации для юридических лиц; город проживания для индивидуальных предпринимателей. стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ unrestricted_value	— адрес одной строкой (полный, с индексом) стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ data	— гранулярный адрес
└ data.source	— адрес одной строкой как в ЕГРЮЛ
└ data.qc	— код проверки адреса 0 — адрес распознан уверенно 1 или 3 — требуется ручная проверка

data.state	Состояние
└ actuality_date	— дата последних изменений
└ registration_date	— дата регистрации
└ liquidation_date	— дата ликвидации
└ status	— статус организации ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована BANKRUPT — банкротство REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией
└ code	— детальный статус

Тарифы «Расширенный» и «Максимальный»

Название	Описание
data.employee_count	Среднесписочная численность работников
data.finance.tax_system	Система налогообложения AUSN — автоматизированная упрощенная система налогообложения (АУСН) ESHN — единый сельскохозяйственный налог (ЕСХН) SRP — система налогообложения при выполнении соглашений о разделе продукции (СРП) USN — упрощенная система налогообложения (УСН)
data.okved	Код ОКВЭД
data.okveds[ ]	Коды ОКВЭД дополнительных видов деятельности
└ main	— основной или нет (true / false)
└ type	— версия справочника ОКВЭД (2001 или 2014)
└ code	— код по справочнику
└ name	— наименование по справочнику

data.authorities	Сведения о налоговой, ПФР и ФСС
data.authorities.fts_registration	ИФНС регистрации
└ type	— код гос. органа
└ code	— код отделения
└ name	— наименование отделения
└ address	— адрес отделения одной строкой
data.authorities.fts_report	ИФНС отчётности, структура аналогична fts_registration
data.authorities.pf	Отделение Пенсионного фонда, структура аналогична fts_registration
data.authorities.sif	Отделение Фонда соц. страхования, структура аналогична fts_registration

data.citizenship	Гражданство ИП
└ code.numeric	— числовой код страны по ОКСМ
└ code.alpha_3	— трехбуквенный код страны по ОКСМ
└ name.full	— полное наименование страны
└ name.short	— краткое наименование страны

Только «Максимальный» тариф

Название	Описание
data.founders[ ]	Учредители компании
└ ogrn	— ОГРН учредителя (для юрлиц)
└ inn	— ИНН учредителя
└ name	— наименование учредителя (для юрлиц)
└ fio	— ФИО учредителя (для физлиц)
└ hid	— внутренний идентификатор
└ type	— тип учредителя (LEGAL / PHYSICAL)
└ start_date	— дата вступления в права учредителя
data.founders[ ].share	Доля учредителя
└ type	— тип значения (PERCENT / DECIMAL / FRACTION)
└ value	— значение (для type = PERCENT и type = DECIMAL)
└ numerator	— числитель дроби (для type = FRACTION)
└ denominator	— знаменатель дроби (для type = FRACTION)

data.founders[ ].invalidity	Недостоверность сведений об учредителе
└ code	— код причины недостоверности PARTY — обращение лица или организации FTS — проверка налоговой COURT — решение суда OTHER — прочие причины
└ decision	— решение суда (только для code = COURT)
└ court_name	— наименование суда
└ number	— номер судебного решения
└ date	— дата судебного решения

data.management.disqualified	не заполняется
data.managers[ ]	Руководители компании
└ ogrn	— ОГРН руководителя (для юрлиц)
└ inn	— ИНН руководителя
└ name	— наименование руководителя (для юрлиц)
└ fio	— ФИО руководителя (для физлиц)
└ post	— должность руководителя (для физлиц)
└ hid	— внутренний идентификатор
└ type	— тип руководителя EMPLOYEE — сотрудник LEGAL — юрлицо
└ start_date	— дата вступления в должность руководителя

data.managers[ ].invalidity	Недостоверность сведений о руководителе
└ code	— код причины недостоверности PARTY — обращение лица или организации FTS — проверка налоговой COURT — решение суда OTHER — прочие причины
└ decision	— решение суда (только для code = COURT)
└ court_name	— наименование суда
└ number	— номер судебного решения
└ date	— дата судебного решения

data.predecessors[ ]	Правопредшественники, только для юрлиц
└ ogrn	— ОГРН предшественника
└ inn	— ИНН предшественника
└ name	— наименование предшественника
data.successors[ ]	Правопреемники, только для юрлиц
└ ogrn	— ОГРН преемника
└ inn	— ИНН преемника
└ name	— наименование преемника

data.capital	Уставной капитал компании
└ type	— тип капитала
└ value	— размер капитала
data.finance	Финансовые показатели за год частично заполнены у 60% действующих компаний
└ year	— год бух. отчетности
└ income	— доходы по бух. отчетности
└ revenue	— выручка по бух. отчетности
└ expense	— расходы по бух. отчетности
└ debt	— недоимки по налогам
└ penalty	— налоговые штрафы

data.documents	Документы
data.documents.fts_registration	Свидетельство о регистрации в налоговой
└ type	— тип документа (= FTS_REGISTRATION)
└ series	— серия документа
└ number	— номер документа
└ issue_date	— дата выдачи
└ issue_authority	— код подразделения
data.documents.fts_report	Сведения об учете в налоговом органе, структура аналогична fts_registration
data.documents.pf_registration	Свидетельство о регистрации в Пенсионном фонде, структура аналогична fts_registration
data.documents.sif_registration	Свидетельство о регистрации в Фонде соц. страхования, структура аналогична fts_registration
data.documents.smb	Запись в реестре малого и среднего предпринимательства
└ type	— тип документа (= SMB)
└ category	— категория предприятия (MICRO, SMALL или MEDIUM)
└ issue_date	— дата регистрации в реестре

data.licenses[ ]	Лицензии
└ series	— серия документа
└ number	— номер документа
└ issue_date	— дата выдачи
└ issue_authority	— название выдавшего органа
└ suspend_date	— дата приостановки
└ suspend_authority	— название приостановившего органа
└ valid_from	— дата начала действия
└ valid_to	— дата окончания действия
└ activities[ ]	— перечень лицензируемых видов деятельности
└ addresses[ ]	— перечень адресов, по которым действует лицензия

data.address.invalidity	Недостоверность сведений об адресе
└ code	— код причины недостоверности PARTY — обращение лица или организации FTS — проверка налоговой COURT — решение суда OTHER — прочие причины
└ decision	— решение суда (только для code = COURT)
└ court_name	— наименование суда
└ number	— номер судебного решения
└ date	— дата судебного решения

data.phones[ ]	Телефоны, заполнены у 60% действующих компаний
└ data.source	— телефон одной строкой как в ЕГРЮЛ
└ data.type	— тип телефона (мобильный, стационарный, ...)
└ data.country_code	— код страны
└ data.city_code	— код города / DEF-код
└ data.number	— локальный номер телефона
└ data.provider	— оператор связи
└ data.region	— регион
└ data.city	— город (только для стационарных телефонов)
└ data.timezone	— часовой пояс
└ data.contact	— контактное лицо

data.emails[ ]	Адреса эл. почты, заполнены у 50% действующих компаний
└ data.source	— email одной строкой как в ЕГРЮЛ
└ data.local	— локальная часть адреса (то, что до «собачки»)
└ data.domain	— домен (то, что после «собачки»)

data.finance_history[ ]	История финансовой отчетности (БФО)
└ year	— год отчетности
└ metrics[ ]
└ code	— код показателя
└ value	— значение показателя

data.invalid	Признак недостоверных сведений об организации (true/null)

Не заполняются
data.source	не заполняется
data.qc	не заполняется

Доходы и расходы

Показатели рассчитываются по «Отчету о финансовых результатах» (форма по ОКУД 0710002):

Доходы = сумма по кодам 2110, 2310, 2320, 2340
Выручка = показатель по коду 2110
Расходы = сумма по кодам 2120, 2210, 2220, 2330, 2350

Доходы и расходы заполнены примерно у 60% действующих компаний (такая полнота данных в налоговой).

История финансовой отчетности

В поле data.finance_history возвращаются показатели БФО по данным налоговой за последние пять лет:

Код	Показатель
1100	Итого по разделу I
1200	Итого по разделу II
1300	Итого по разделу III
1400	Итого по разделу IV
1500	Итого по разделу V
1600	Баланс активов
1700	Баланс пассивов
2100	Валовая прибыль (убыток)
2110	Выручка
2200	Прибыль (убыток) от продаж
2300	Прибыль (убыток) до налогообложения
2400	Чистая прибыль (убыток)
2410	Налог на прибыль
2500	Совокупный финансовый результат периода
4100	Сальдо денежных потоков от текущих операций
4200	Сальдо денежных потоков от инвестиционных операций
4300	Сальдо денежных потоков от финансовых операций
4400	Сальдо денежных потоков за отчетный период
6100	Остаток средств на начало отчетного года
6200	Всего поступило средств
6300	Всего использовано средств
6400	Остаток средств на конец отчетного года

Недостоверные сведения об организации

Налоговая может признать сведения об учредителе, руководителе или адресе организации недостоверными. Тогда в ответе «Дадаты» будут заполнены соответствующие поля:

data.founders[ ].invalidity
data.managers[ ].invalidity
data.address[ ].invalidity

Если хотя бы один учредитель, руководитель или адрес организации признан недостоверным, «Дадата» вернет для организации в целом маркер data.invalid = true. Если недостоверных данных нет — будет data.invalid = null.

Источники данных:

Примеры настройки

Заполнить реквизиты компании: наименование, ИНН, КПП, адрес

Подсказывать компании, зарегистрированные в конкретном городе или области

Подсказывать только индивидуальных предпринимателей

Подсказывать только действующие компании

Отфильтровать компании из конкретной отрасли

Отключить геолокацию по IP

Ограничения

На бесплатном тарифе плагин подсказок показывает логотип «Дадаты» в углу выпадающего списка. На платных тарифах и в «коробке» логотипа нет.

Количество запросов в день — в соответствии с тарифным планом.

Длина запроса — не более 300 символов.

Количество условий (параметр locations) — не более 10.

Частые вопросы

Как часто обновляется справочник компаний (ЕГРЮЛ)?

По мере поступления обновлений от налоговой службы. Отставание от сайта налоговой (egrul.nalog.ru) не более 3 дней.

Почему не находится организация? Я точно знаю, она должна быть

Скорее всего, организация недавно зарегистрирована в ФНС, и мы еще не успели получить информацию о ней из налоговой. Отставание Дадаты от сайта налоговой (egrul.nalog.ru) не более 3 дней, так что организация скоро появится.

Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)

Возможные причины:

В запросе указан неправильный API-ключ. Проверьте в личном кабинете
Исчерпан лимит запросов на день. Проверьте в личном кабинете
Не подтверждён адрес эл. почты. Проверьте в личном кабинете

Что будет, если превысить 10 000 бесплатных запросов в день?

Подсказки перестанут подсказывать. До начала нового дня, затем снова заработают.

10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы...

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.