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

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

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

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

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

  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@19.8.0/dist/css/suggestions.min.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/suggestions-jquery@19.8.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-ключ.

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

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

Что в ответе

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

Название Описание
Базовые поля, заполняются для всех тарифов
value Наименование компании
unrestricted_value = value
data.address Адрес
└ value — адрес одной строкой:
  • адрес организации для юридических лиц;
  • город проживания для индивидуальных предпринимателей.
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ unrestricted_value — адрес одной строкой (полный, от региона)
стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ.
└ data — гранулярный адрес
└ data.source — адрес одной строкой как в ЕГРЮЛ
└ data.qc — код проверки адреса
  0        — адрес распознан уверенно
  1 или 3  — требуется ручная проверка
data.branch_count Количество филиалов
data.branch_type Тип подразделения
  MAIN   — головная организация
  BRANCH — филиал
data.inn ИНН
data.kpp КПП
data.ogrn ОГРН
data.ogrn_date Дата выдачи ОГРН
data.hid Уникальный идентификатор в Дадате
data.management Руководитель
└ name — ФИО руководителя
└ post — должность руководителя
data.name Наименование
└ full_with_opf — полное наименование с ОПФ
└ short_with_opf — краткое наименование с ОПФ
└ latin — наименование на латинице (не заполняется)
└ full — полное наименование
└ short — краткое наименование
data.okpo Код ОКПО (не заполняется)
data.okved Код ОКВЭД
data.okved_type Версия справочника ОКВЭД (2001 или 2014)
data.opf Организационно-правовая форма
└ code — код ОКОПФ
└ full — полное название ОПФ
└ short — краткое название ОПФ
└ type — версия справочника ОКОПФ (99, 2012 или 2014)
data.state Состояние
└ actuality_date — дата актуальности сведений
└ registration_date — дата регистрации
└ liquidation_date — дата ликвидации
└ status — статус организации
  ACTIVE       — действующая
  LIQUIDATING  — ликвидируется
  LIQUIDATED   — ликвидирована
  REORGANIZING — в процессе присоединения
                 к другому юрлицу,
                 с последующей ликвидацией
data.type Тип организации
  LEGAL      — юридическое лицо
  INDIVIDUAL — индивидуальный предприниматель
Дополнительные поля, заполняются в зависимости от тарифа
Заполняются при выборе конкретной подсказки. До этого они пустые.
Тарифы «Расширенный» и «Всё включено»
data.employee_count Среднесписочная численность работников
data.finance.tax_system Система налогообложения
  ENVD — единый налог на вмененный доход
  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.management.disqualified Наличие дисквалифицированных лиц в руководстве компании. Возвращает true при наличии, иначе null.
data.managers[ ] Руководители компании
└ ogrn — ОГРН руководителя (для юрлиц)
└ inn — ИНН руководителя
└ name — наименование руководителя (для юрлиц)
└ fio — ФИО руководителя (для физлиц)
└ post — должность руководителя (для физлиц)
└ hid — внутренний идентификатор
└ type — тип руководителя
  EMPLOYEE  — сотрудник
  FOREIGNER — иностранный гражданин
  LEGAL     — юрлицо
data.capital Уставной капитал компании
└ type — тип капитала
└ value — размер капитала
data.finance Финансовые показатели за год
└ income — доходы по бух. отчетности
└ expense — расходы по бух. отчетности
└ debt — недоимки по налогам
└ penalty — налоговые штрафы
data.documents Документы
data.documents.fts_registration Свидетельство о регистрации в налоговой
└ type — тип документа (= FTS_REGISTRATION)
└ series — серия документа
└ number — номер документа
└ issue_date — дата выдачи
└ issue_authority — код подразделения
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.founders[ ].share
data.phones[ ]
data.emails[ ]
data.source
data.qc

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

Ограничения

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

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

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

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

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

Как разложить компанию по полям? Наименование, ИНН, КПП, адрес?

Пример: разложить организацию по полям

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

Пример: ограничить сектор поиска по организациям

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

Пример: ограничить сектор поиска по организациям

Как подсказывать ликвидированные компании?

Пример: ограничить сектор поиска по организациям

Как заставить подсказки учитывать местонахождение пользователя?

Подсказки делают это «из коробки»: определяют город пользователя по IP-адресу и подсказывают ближайшие варианты.

Как отключить геолокацию?

Передайте параметр geoLocation = false.


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

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

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

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


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

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

  • Не подтверждён адрес эл. почты. Проверьте почтовый ящик и папку «спам» — там должно быть письмо от «Дадаты».
  • В запросе указан неправильный API-ключ. Проверьте в личном кабинете
  • Исчерпан лимит запросов на день. Проверьте в личном кабинете
  • Вы делаете запросы с сервера, при этом настроена привязка к домену. Отключите привязку к домену, либо делайте запросы из браузера.
Что будет, если превысить 10 000 бесплатных запросов в день?

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

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

Как защитить API-ключ от злоумышленников?

Если вы используете jQuery-плагин Подсказок, то API-ключ виден в исходном коде страниц вашего сайта. Чтобы злоумышленник не мог воспользоваться вашим ключом, можно привязать его к конкретному домену.

Например, если вы владелец интернет-магазина myshop.ru, то привязка ключа к этому домену запретит пользоваться им на всех остальных сайтах.

Привязка API-ключа к домену настраивается в личном кабинете.

Стоимость

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

ajax-spinner

Зарегистрируйтесь, чтобы подключить подсказки

до 10 тыс. запросов бесплатно

чтобы обращаться к вам в письмах

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

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