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

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

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

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

Что умеет

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

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

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

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

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

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

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

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

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

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

  1. Вставьте код из примера на свой сайт.
  2. Profit!
<input id="party" name="party" type="text" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.0/jquery.min.js"></script>
<link href="http://cdn.jsdelivr.net/npm/suggestions-jquery@22.6.0/dist/css/suggestions.min.css" rel="stylesheet" />
<script src="http://cdn.jsdelivr.net/npm/suggestions-jquery@22.6.0/dist/js/jquery.suggestions.min.js"></script>

<script>
    $("#party").suggestions({
        token: "${API_KEY}",
        type: "PARTY",
        /* Вызывается, когда пользователь выбирает одну из подсказок */
        onSelect: function(suggestion) {
            console.log(suggestion);
        }
    });
</script>

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

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

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

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

Что в ответе

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

Все тарифы

НазваниеОписание
valueНаименование компании
unrestricted_value= value
data.innИНН
data.kppКПП
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— должность руководителя
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)
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     — юрлицо
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.invalid Признак недостоверных сведений об организации (true/null)
Не заполняются
data.source не заполняется
data.qc не заполняется

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

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

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

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

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

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

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)

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

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

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

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

Стоимость

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