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

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

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

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

Что умеет

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

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

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

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

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

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

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

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

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

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

  1. Зарегистрируйтесь и получите API-ключ
  2. Вставьте код из примера на свой сайт.
  3. Profit!
<input id="party" name="party" type="text" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.3.1/jquery.min.js"></script>
<link href="https://cdn.jsdelivr.net/npm/suggestions-jquery@21.6.0/dist/css/suggestions.min.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/suggestions-jquery@21.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 — полное наименование без ОПФ
⚠️ будет удалено в 2021, используйте full_with_opf
└ short — краткое наименование без ОПФ
⚠️ будет удалено в 2021, используйте 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 Система налогообложения
  ENVD      — единый налог на вмененный доход (ЕНВД)
  ESHN      — единый сельскохозяйственный налог (ЕСХН)
  SRP       — система налогообложения при выполнении
              соглашений о разделе продукции (СРП)
  USN       — упрощенная система налогообложения (УСН)
  ENVD_ESHN — ЕНВД + ЕСХН
  USN_ENVD  — УСН + ЕНВД
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.management.disqualified Наличие дисквалифицированных лиц в руководстве компании. Возвращает true при наличии, иначе null.
data.managers[ ] Руководители компании
└ ogrn — ОГРН руководителя (для юрлиц)
└ inn — ИНН руководителя
└ name — наименование руководителя (для юрлиц)
└ fio — ФИО руководителя (для физлиц)
└ post — должность руководителя (для физлиц)
└ hid — внутренний идентификатор
└ type — тип руководителя
  EMPLOYEE  — сотрудник
  FOREIGNER — иностранный гражданин
  LEGAL     — юрлицо
data.predecessors[ ] Правопредшественники, только для юрлиц
└ ogrn — ОГРН предшественника
└ inn — ИНН предшественника
└ name — наименование предшественника
data.successors[ ] Правопреемники, только для юрлиц
└ ogrn — ОГРН преемника
└ inn — ИНН преемника
└ name — наименование преемника
data.capital Уставной капитал компании
└ type — тип капитала
└ value — размер капитала
data.finance Финансовые показатели за год
частично заполнены у 70% действующих компаний
└ year — год бух. отчетности
└ income — доходы по бух. отчетности
└ 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.phones[ ] Телефоны, заполнены у 30% действующих компаний
└ 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[ ] Адреса эл. почты, заполнены у 40% действующих компаний
└ data.source — email одной строкой как в ЕГРЮЛ
└ data.local — локальная часть адреса (то, что до «собачки»)
└ data.domain — домен (то, что после «собачки»)
Не заполняются
data.source не заполняется
data.qc не заполняется

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

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

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

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

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

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

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

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

Ограничения

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Стоимость

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

ajax-spinner

Зарегистрируйтесь, чтобы подключить подсказки
до 10 тыс. запросов в день — бесплатно
чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти