API-ФНС предназначен для интеграции базы данных ФНС в любые информационные системы. Основная цель — автоматизация извлечения данных из Единого государственного реестра юридических лиц (ЕГРЮЛ)
и Единого государственного реестра индивидуальных предпринимателей (ЕГРИП) для использования в своих информационных системах (например, 1С, CRM, другие бухгалтерские, банковские системы).
С помощью сервиса вы сможете автоматизировать заполнение реквизитов компаний, поиска компаний по различным параметрам, проявить должную осмотрительность,
отслеживать изменения в параметрах ваших контрагентов.
Сервис предлагает получать любую информацию из базы ФНС по заданному запросу. Для получения информации используются запросы с параметрами GET или POST. На выходе — строка в формате JSON.
Для выбора методов и ввода параметров можно использовать единый адрес входа: https://api-fns.ru/api
API состоит из нескольких программных интерфейсов:
| Название метода | Команда | Описание |
|---|---|---|
| Поиск компаний | search | Позволяет получить список компаний, соответствующих указанному запросу |
| Автодополнение | ac | Позволяет получить список компаний, которые могут дополнить вводимое значение (автоподсказка) |
| Получение данных о компании | egr | Позволяет получить все актуальные и исторические данные из ЕГРЮЛ о юридическом лице (ЮЛ), или из ЕГРИП для индивидуального предпринимателя (ИП) |
| Реквизиты группы компаний | multinfo | Позволяет получить базовые данные сразу о нескольких юридических лиц или индивидуальных предпринимателей |
| Проверка группы компаний | multcheck | Позволяет провести базовую (упрощенную) проверку нескольких юридических лиц или индивидуальных предпринимателей |
| Проверка контрагента (признаки недобросовестности) | check | Позволяет получать информацию о том, попало ли юридическое лицо в различные негативные реестры ФНС, отметки о недостоверных данных, признаки «массового» директора, учредителя, решений о ликвидации, реорганизации и прочие |
| Проверка блокировок счета | nalogbi | Запрос полной информации о действующих решениях ФНС о приостановлении операций по счетам |
| Проверка блокировок счета в виде файла | nalogbi_file | Вывод полной информации о действующих решениях ФНС о приостановлении операций по счетам в виде файла zip с подписью ФНС |
| Отслеживание изменений параметров компании | changes | Позволяет получить те параметры компании, которые изменились, начиная с указанной даты |
| Мониторинг изменений по списку компаний | mon | Формирование списка компаний для мониторинга и отслеживание изменений в ЕГРЮЛ/ЕГРИП по этому списку |
| Выписка из ЕГРЮЛ | vyp | Позволяет получить заверенную выписку ФНС из ЕГРЮЛ или ЕГРИП |
| Бухгалтерская отчетность | bo | Бухгалтерская отчетность организации по данным ФНС |
| Бухгалтерская отчетность в виде файла | bo_file | Бухгалтерская отчетность организации в виде файла zip или pdf, заверенного подписью ФНС |
| Узнать ИНН по паспортным данным | innfl | Возвращает ИНН физического лица на основании введенных паспортных данных |
| Проверка паспорта на недействительность | mvdpass | Проверяет серию и номер паспорта по списку недействительных российских паспортов |
| Статусы физического лица | fl_status | Проверяет статус самозанятого, является ли физическое лицо индивидуальным предпринимателем, банкротство физического лица, недействительность ИНН |
| Лицензии ФСРАР | fsrar | Возвращает информацию о лицензиях по данным ФСРАР |
| Статистика запросов (использования ключа) | stat | Возвращает информацию статистику о количестве использованных и доступных запросов по каждому из методов |
Поиск компаний
Позволяет получить список компаний по указанному запросу.
На входе подается текстовая поисковая строка или фильтр, на выходе — строка JSON.
Поисковая строка может быть следующей:
- ИНН или ОГРН организации.
- ОГРН ИП.
- ИНН физ. лица
- ФИО физ. лица или его часть (пример: «Василий Гордиенко», «Гордиенко Василий Иванович»)
- Название или часть названия организации (производится полнотекстовый поиск).
- Контактные данные (номер телефона, e-mail или web-сайт).
- Адрес организации (для вывода организации по заданному адресу) (пример: «г. Москва, наб. Озерковская, д.52, стр.2»). Если задана начальная часть адреса, то выводятся все организации, соответствующие данному адресу: например, «г. Москва, наб. Озерковская, д.52» выдаст все организации с данным адресом, включая все строения и офисы.
- Смешанный поиск: Часть ФИО и населенного пункта, Часть наименования организации и населенного пункта, Часть наименования организации и ФИО учредителя или директора.
Адрес сервиса: https://api-fns.ru/api/search
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| q | string q=Гордиенко Василий |
Поисковая строка. Если указать q=any, то будут выведены все организации, соответствующие параметру filter |
| page | integer page=2 |
Страница поиска (поиск выдает только первые 100 найденных значений, если их больше используйте page для отображения следующей порции найденных значений)
Необязательное поле |
| filter | string filter=active |
Фильтрация вывода. Возможно указать следующие значения (разделяя символом +): active — выводит только действующие организации onlyul — выводит только юридические лица (без ИП) onlyip — выводит только ИП (без юридических лиц) okved — выводит организации с заданными основным ОКВЭД, разделенными символом | (пример okved69.10|69.20 — выведет организации с основным ОКВЭД 69.10 или 69.20) okvedgroup — выводит организации с заданной группой ОКВЭД (пример okvedgroup69 — выведет организации с основным ОКВЭД 69,69.1,69.10,69.20,69.20.2,69.20.3 и т.д.) region — выводит организации, зарегистрированные в заданных регионах (пример region77|78 — выведет организации Москвы и Санкт-Петербурга) vyruchka — выводит организации с выручкой в заданном интервале (пример vyruchka>5000<20000 — выведет организации с выручкой от 5 до 20 млн. руб.) sotrudnikov — выводит организации с количеством сотрудников в заданном интервале (пример sotrudnikov>5<20 — выведет организации с сотрудниками от 5 до 20 человек) datereg — выводит организации с датой регистации в заданном интервале (пример datereg>01.01.2019<01.01.2018 — выведет организации, зарегистрированные в 2018 году) reestrmsp — выводит организации, входящие в реестр МСП на последнюю доступную дату reestrmsp1, reestrmsp2 или reestrmsp3 отбирает Микро, Малые или Средние предприятия соответственно withphone — выводит организации, у которых указан номер телефона в контактах withemail — выводит организации, у которых указан email в контактах Необязательное поле |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий список найденных организаций.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | array | Массив результатов поиска |
| ЮЛ, ИП или НР | object | Тип найденной компании (юридическое лицо, индивидуальный предприниматель или представительство иностранной компании) |
| ИНН | string | ИНН найденной компании |
| ОГРН | string | ОГРН найденной компании |
| НаимСокрЮЛ | string | Наименование ЮЛ полное (только для ЮЛ) |
| НаимПолнЮЛ | string | Наименование ЮЛ краткое (только для ЮЛ) |
| ФИОПолн | string | ФИО ИП (только ИП) |
| ДатаРег | string | Дата регистрации ЮЛ (ИП) в формате YYYY-MM-DD |
| Статус | string | Статус ЮЛ (ИП): «Действующее», «Ликвидировано», «В состоянии реорганизации» и др. |
| ДатаПрекр | string | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| АдресПолн | string | Адрес организации (полный) |
| ОснВидДеят | string | Основной вид деятельности |
| ГдеНайдено | string | Где найдена поисковая строка:
|
| nextpage | object | true, если в запросе есть следующия страница |
| filter | object | Строка фильтра, если запрос с параметром filter |
| filter_any_count | integer | Общее количество найденных записей при фильтрации (выводится если указан параметр filter и req=any) |
| Count | integer | Количество найденных записей |
Примеры запросов.
https://api-fns.ru/api/search?q=Борунов Алексей Владимирович&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ИНН": "6732133377",
"ОГРН": "1166733070492",
"НаимСокрЮЛ": "СРФСОО "ФДСО"",
"НаимПолнЮЛ": "СМОЛЕНСКАЯ РЕГИОНАЛЬНАЯ ФИЗКУЛЬТУРНО-СПОРТИВНАЯ ОБЩЕСТВЕННАЯ ОРГАНИЗАЦИЯ "ФЕДЕРАЦИЯ ДАРТС СМОЛЕНСКОЙ ОБЛАСТИ"",
"ДатаРег": "2016-09-28",
"Статус": "Действующее",
"АдресПолн": "обл. Смоленская, г. Смоленск, ул. Попова, д.121, кв.152",
"ОснВидДеят": "Деятельность в области спорта прочая",
"ГдеНайдено": "ФИО учредителя (Борунов Алексей Владимирович, ИННФЛ: 673105975402)"
}
},
{
"ЮЛ": {
"ИНН": "2311146207",
"ОГРН": "1122311005453",
"НаимСокрЮЛ": "СНП "МЕГАТРОН"",
"НаимПолнЮЛ": "САДОВОДЧЕСКОЕ НЕКОММЕРЧЕСКОЕ ПАРТНЕРСТВО "МЕГАТРОН"",
"ДатаРег": "2012-06-20",
"Статус": "Действующее",
"АдресПолн": "край Краснодарский, р-н Динской, п. Южный, ул. Строителей, д.64",
"ОснВидДеят": "Управление эксплуатацией нежилого фонда за вознаграждение или на договорной основе",
"ГдеНайдено": "ФИО бывшего учредителя (Борунов Алексей Владимирович, ИННФЛ: 231121127449)"
}
},
{
"ЮЛ": {
"ИНН": "7614005733",
"ОГРН": "1127609000309",
"НаимСокрЮЛ": "ООО "ЛИГА"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛИГА"",
"ДатаРег": "2012-03-22",
"Статус": "Ликвидировано по 129-ФЗ",
"ДатаПрекр": "2016-11-21",
"АдресПолн": "обл. Ярославская, р-н Борисоглебский, п. Борисоглебский, ул. Допризывная, д.30",
"ОснВидДеят": "Производство пластмассовых изделий для упаковывания товаров",
"ГдеНайдено": "ФИО директора (Борунов Алексей Владимирович, ИННФЛ: 761400964351)"
}
},
{
"ИП": {
"ИНН": "673105975402",
"ОГРН": "308673128200018",
"ФИОПолн": "Борунов Алексей Владимирович",
"ДатаРег": "2008-10-08",
"Статус": "Прекратило деятельность",
"ДатаПрекр": "2010-07-05",
"АдресПолн": "обл. Смоленская, г. Смоленск",
"ОснВидДеят": "Ремонт бытовых изделий и предметов личного пользования",
"ГдеНайдено": "ФИО ИП полное"
}
},
{
"ИП": {
"ИНН": "231121127449",
"ОГРН": "308231118900012",
"ФИОПолн": "Борунов Алексей Владимирович",
"ДатаРег": "2008-07-07",
"Статус": "Прекратило деятельность",
"ДатаПрекр": "2012-11-14",
"АдресПолн": "край Краснодарский, г. Краснодар",
"ОснВидДеят": "Техническое обслуживание и ремонт автотранспортных средств",
"ГдеНайдено": "ФИО ИП полное"
}
},
{
"ИП": {
"ИНН": "111800978544",
"ОГРН": "312293215200092",
"ФИОПолн": "Борунов Алексей Владимирович",
"ДатаРег": "2012-05-31",
"Статус": "Прекратило деятельность",
"ДатаПрекр": "2015-04-16",
"АдресПолн": "обл. Архангельская, р-н Лешуконский, с. Койнас",
"ОснВидДеят": "Прочая деятельность по организации отдыха и развлечений",
"ГдеНайдено": "ФИО ИП полное"
}
}
],
"Count": 6
}
https://api-fns.ru/api/search?q=зао миа&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ИНН": "7705272662",
"ОГРН": "1147746867542",
"НаимСокрЮЛ": "ЗАО "МИА"",
"НаимПолнЮЛ": "ЗАО "МОСКОВСКОЕ ИНЖИНИРИНГОВОЕ АГЕНТСТВО"",
"ДатаРег": "2014-07-31",
"Статус": "Действующее",
"АдресПолн": "г. Москва, пер. Овчинниковский Б., д.22, стр.1",
"ОснВидДеят": "Строительство жилых и нежилых зданий",
"ГдеНайдено": "Наименование ЮЛ полное"
}
},
{
"ЮЛ": {
"ИНН": "7801029660",
"ОГРН": "1037835019738",
"НаимСокрЮЛ": "ЗАО "МИА"",
"НаимПолнЮЛ": "ЗАО "МЕХАНОБР ИНЖИНИРИНГ АВТОМАТИК"",
"ДатаРег": "1996-09-04",
"Статус": "Ликвидировано по 129-ФЗ",
"ДатаПрекр": "2012-02-13",
"АдресПолн": "г. Санкт-Петербург, пр-кт Дунайский, д.38, кор.1, оф.123",
"ГдеНайдено": "Наименование ЮЛ полное"
}
},
{
"ЮЛ": {
"ИНН": "7730678360",
"ОГРН": "1127747271607",
"НаимСокрЮЛ": "ООО "НИКО"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "НИКО"",
"ДатаРег": "2012-12-20",
"Статус": "Находится в стадии ликвидации",
"АдресПолн": "г. Москва, ул. Кастанаевская, д.3А, стр.1, оф.3",
"ОснВидДеят": "Торговля оптовая неспециализированная",
"ГдеНайдено": "Участие в УК (99% доля)"
}
}
],
"Count": 3
}
https://api-fns.ru/api/search?q=any&filter=okved69.10|69.20+region01+reestrmsp+withemail+datereg<01.01.2019>01.01.2018&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ИНН": "0105079583",
"ОГРН": "1180105000558",
"НаимСокрЮЛ": "ООО "СТАТУС"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "СТАТУС"",
"ДатаОГРН": "2018-02-27",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, г. Майкоп, ул. Ж.попова, д.44",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ЮЛ": {
"ИНН": "0105080074",
"ОГРН": "1180105002032",
"НаимСокрЮЛ": "ООО "ПРЕЦЕДЕНТ"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ПРЕЦЕДЕНТ"",
"ДатаОГРН": "2018-07-20",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, г. Майкоп, ул. Жуковского, д.29, оф.7",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ИП": {
"ИНН": "502917348300",
"ОГРН": "318010500001710",
"ФИОПолн": "Кузнецов Ярослав Валерьевич",
"ДатаОГРН": "2018-01-26",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, Тахтамукайский район, пгт Яблоновский",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ИП": {
"ИНН": "010510000188",
"ОГРН": "318010500016463",
"ФИОПолн": "Датхужев Чиназ Довлетбиевич",
"ДатаОГРН": "2018-07-11",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, г Майкоп",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ИП": {
"ИНН": "010503972658",
"ОГРН": "318010500017807",
"ФИОПолн": "Рудяшко Леонид Леонидович",
"ДатаОГРН": "2018-07-25",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, Майкопский район, ст-ца Даховская",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ИП": {
"ИНН": "010300722765",
"ОГРН": "318010500019152",
"ФИОПолн": "Ахагов Аскербий Борокович",
"ДатаОГРН": "2018-08-10",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, г Майкоп",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ИП": {
"ИНН": "010510585931",
"ОГРН": "318010500019605",
"ФИОПолн": "Свиридчук Мария Васильевна",
"ДатаОГРН": "2018-08-16",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, г Майкоп",
"ОснВидДеят": "Деятельность в области права",
"ГдеНайдено": "Фильтр"
}
},
{
"ИП": {
"ИНН": "010503643727",
"ОГРН": "318010500009941",
"ФИОПолн": "Иманкулова Сусанна Ибрагимовна",
"ДатаОГРН": "2018-04-28",
"Статус": "Действующее",
"АдресПолн": "респ. Адыгея, г Майкоп",
"ОснВидДеят": "Деятельность по оказанию услуг в области бухгалтерского учета, по проведению финансового аудита, по налоговому консультированию",
"ГдеНайдено": "Фильтр"
}
}
],
"filter": "+ОКВЭД(69.10,69.20)+Регион(01)+ДатаРег<2019-01-01 и >2018-01-01+РеестрМСП+ЕстьEmail",
"Count": 8
}
Автодополнение
Позволяет получить список компаний, которые могут дополнить вводимое значение (автоподсказка).
На входе подается текстовая поисковая строка, на выходе — строка JSON.
Поиск компаний или ИП осуществляется только по первым буквам названия (более 2-х букв), полным названиям (любое количество букв), ФИО ИП (полное), цифрам ИНН (более 5-ти цифр). В результате выводится не более 100 значений.
Адрес сервиса: https://api-fns.ru/api/ac
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| q | string q= |
Поисковая строка (первые буквы названия) |
| filter | string filter=active |
Фильтрация вывода. Возможно указать следующие значения (разделяя символом +) active — выводит только действующие организации onlyul — выводит только юридические лица (без ИП) onlyip — выводит только ИП (без юридических лиц) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию из ЕГРЮЛ (ЕГРИП).
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска (например, при запросе по ИНН может быть возвращена не одна, а несколько записей) |
| ЮЛ, ИП или НР | object | Тип искомой компании (индивидуальный предприниматель — ИП, юридическое лицо — ЮЛ, НР — представительство иностранного юридического лица) |
| Поля для ИП: | (любое из полей может отсутствовать) | |
| ФИОПолн | String | Фамилия Имя Отчество индивидуального предпринимателя |
| ИННФЛ | String | ИНН физического лица |
| ОГРНИП | String | ОГРН ИП |
| ДатаОГРН | String | Дата выдачи ОГРН в формате YYYY-MM-DD |
| ДатаРег | String | Дата регистрации ИП в формате YYYY-MM-DD |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| КПП | String | КПП искомой компании |
| ОГРН | String | ОГРН искомой компании |
| НаимСокрЮЛ | String | Наименование ЮЛ полное (только для ЮЛ) |
| НаимПолнЮЛ | String | Наименование ЮЛ краткое (только для ЮЛ) |
| ДатаОГРН | String | Дата выдачи ОГРН в формате YYYY-MM-DD |
| ДатаРег | String | Дата регистрации ЮЛ в формате YYYY-MM-DD |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
Примеры запросов.
https://api-fns.ru/api/ac?q=тм1&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ИНН": "7017360678",
"ОГРН": "1147017017696",
"НаимСокрЮЛ": "ООО "ТМ1"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ТМ1"",
"ДатаОГРН": "2014-08-29",
"ГдеНайдено": "Наименование ЮЛ полное"
}
},
{
"ЮЛ": {
"ИНН": "7707331440",
"ОГРН": "1157746052199",
"НаимСокрЮЛ": "ООО "ТМ1"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ТМ1"",
"ДатаОГРН": "2015-01-26",
"ГдеНайдено": "Наименование ЮЛ полное"
}
},
{
"ЮЛ": {
"ИНН": "7705987396",
"ОГРН": "1127746413508",
"НаимСокрЮЛ": "АО "ТМ1"",
"НаимПолнЮЛ": "АКЦИОНЕРНОЕ ОБЩЕСТВО "ТМ1"",
"ДатаОГРН": "2012-05-29",
"ГдеНайдено": "Наименование ЮЛ полное"
}
},
{
"ЮЛ": {
"ИНН": "1841074813",
"ОГРН": "1171832026717",
"НаимСокрЮЛ": "ООО "ТМ18"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ТМ18"",
"ДатаОГРН": "2017-11-08",
"ГдеНайдено": "Наименование ЮЛ первые буквы"
}
}
],
"Count": 4
}
Данные о компании
Позволяет получить все данные из ЕГРЮЛ или ЕГРИП (включая исторические) о компании.
На входе подается ОГРН или ИНН компании, на выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/egr
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1026605606620 |
ОГРН или ИНН искомой компании (юридического лица или ИП) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию из ЕГРЮЛ (ЕГРИП).
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска (например, при запросе по ИНН может быть возвращена не одна, а несколько записей) |
| ЮЛ, ИП или НР | object | Тип искомой компании (индивидуальный предприниматель — ИП, юридическое лицо — ЮЛ, НР — представительство иностранного юридического лица) |
| Поля для ИП: | (любое из полей может отсутствовать) | |
| ФИОПолн | String | Фамилия Имя Отчество индивидуального предпринимателя |
| ИННФЛ | String | ИНН физического лица |
| ОГРНИП | String | ОГРН ИП |
| ДатаРег | String | Дата регистрации ИП в формате YYYY-MM-DD |
| ВидИП | Индивидуальный предприниматель или глава крестьянского фермерского хозяйства | |
| Пол | Мужской или Женский | |
| ВидГражд | Гражданин РФ или Иностранный гражданин | |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны гражданства (заполняется только для иностранного гражданина) |
| Статус | String | Статус ИП. Например, «Действующее», Прекратило деятельность и др. |
| СтатусДата | Дата актуальности статуса в формате YYYY-MM-DD | |
| СпОбрЮЛ | Способ образования юридического лица | |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| НО | object | Сведения о налоговых органах |
| Рег | String | Код и наименование регистрирующего (налогового) органа, внесшем запись о юридическом лице |
| РегДата | String | Дата внесения записи о регистрации |
| Учет | String | Код и наименование налогового органа, в котором юридическое лицо состоит (для ЮЛ, прекративших деятельность — состояло) на учете |
| УчетДата | String | Дата постановки на учет в налоговом органе |
| ПФ | object | Сведения о регистрации ИП в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации |
| РегНомПФ | String | Регистрационный номер в территориальном органе Пенсионного фонда Российской Федерации |
| ДатаРегПФ | String | Дата регистрации ИП в качестве страхователя |
| КодПФ | String | Код и наименование территориального органа Пенсионного фонда Российской Федерации |
| ФСС | object | Сведения о регистрации ИП в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации |
| РегНомФСС | String | Регистрационный номер в исполнительном органе Фонда социального страхования Российской Федерации |
| ДатаРегФСС | String | Дата регистрации ИП в качестве страхователя |
| КодФСС | String | Код и наименование исполнительного органа Фонда социального страхования Российской Федерации |
| КодыСтат | object | Сведения о кодах статистики, полученных после регистрации ИП |
| ОКПО | String | Код по Общероссийскому классификатору предприятий и организаций |
| ОКТМО | String | Код, присвоенный территории муниципального образования или населенному пункту, входящему в его состав |
| ОКФС | String | Код по Общероссийскому классификатору форм собственности, входящего в Единую систему кодирования РФ |
| ОКОГУ | String | Код по Общероссийскому классификатору органов государственной власти и управления |
| Адрес | object | Сведения об адресе в РФ, внесенные в ЕГРЮЛ |
| КодРегион | String | Код субъекта Российской Федерации |
| Индекс | String | Индекс |
| АдресПолн | object | Полный адрес (Регион, Район, Город, Населенный пункт, Улица, Дом, Корпус, Квартира) |
| Дата | String | Дата внесения информации в ЕГРЮЛ об адресе |
| String | Адрес электронной почты | |
| ОснВидДеят | object | Сведения об основном виде деятельности |
| Код | String | Код по Общероссийскому классификатору видов экономической деятельности |
| Текст | String | Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности |
| ДопВидДеят | array | Сведения о дополнительных видах деятельности |
| Код | String | Код по Общероссийскому классификатору видов экономической деятельности |
| Текст | String | Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности |
| СПВЗ | array | Сведения о причинах внесения записей в реестр ЕГРИП |
| Дата | String | Дата внесения записи в ЕГРЮЛ |
| Текст | String | Наименование вида записи (причины внесения записи в ЕГРИП) |
| Лицензии | array | Сведения о лицензиях, выданных ИП |
| НомерЛиц | String | Серия и номер лицензии |
| ВидДеятельности | String | Наименование лицензируемого вида деятельности, на который выдана лицензия |
| ДатаНачала | String | Дата начала действия лицензии |
| ДатаОконч | String | Дата окончания действия лицензии |
| МестоДейств | String | Сведения об адресах осуществления лицензируемого вида деятельности (если несколько, то адреса разделяются знаком вертикальной черты |) |
| История | object | Исторические сведения о компании |
| Статус | array | Прошлые статусы организации |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| Адрес | array | Исторические сведения о прошлых адресах компании |
| Период актуальности данных | object | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| АдресПолн | String | Адрес полный |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| КПП | String | КПП искомой компании |
| ОГРН | String | ОГРН искомой компании |
| НаимСокрЮЛ | String | Наименование ЮЛ краткое |
| НаимПолнЮЛ | String | Наименование ЮЛ полное |
| НаимСокрЮЛИн | String | Наименование ЮЛ краткое на английском языке |
| НаимПолнЮЛИн | String | Наименование ЮЛ полное на английском языке |
| ДатаРег | String | Дата регистрации ЮЛ в формате YYYY-MM-DD |
| ОКОПФ | Наименование по Общероссийскому классификатору организационно-правовых форм. Например, «Общества с ограниченной ответственностью» | |
| КодОКОПФ | Код по Общероссийскому классификатору организационно-правовых форм. Например, «12300» | |
| Статус | String | Статус ЮЛ (ИП). Например, «Действующее», «Ликвидировано», «В состоянии реорганизации» и др. |
| СтатусДата | Дата актуальности статуса в формате YYYY-MM-DD | |
| СпОбрЮЛ | Способ образования юридического лица | |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| СпПрекрЮЛ | String | Способ прекращения деятельности юридического лица |
| НО | object | Сведения о налоговых органах |
| Рег | String | Код и наименование регистрирующего (налогового) органа, внесшем запись о юридическом лице |
| РегДата | String | Дата внесения записи о регистрации |
| Учет | String | Код и наименование налогового органа, в котором юридическое лицо состоит (для ЮЛ, прекративших деятельность — состояло) на учете |
| УчетДата | String | Дата постановки на учет в налоговом органе |
| ПФ | object | Сведения о регистрации юридического лица в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации |
| РегНомПФ | String | Регистрационный номер в территориальном органе Пенсионного фонда Российской Федерации |
| ДатаРегПФ | String | Дата регистрации юридического лица в качестве страхователя |
| КодПФ | String | Код и наименование территориального органа Пенсионного фонда Российской Федерации |
| ФСС | object | Сведения о регистрации юридического лица в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации |
| РегНомФСС | String | Регистрационный номер в исполнительном органе Фонда социального страхования Российской Федерации |
| ДатаРегФСС | String | Дата регистрации юридического лица в качестве страхователя |
| КодФСС | String | Код и наименование исполнительного органа Фонда социального страхования Российской Федерации |
| КодыСтат | object | Сведения о кодах статистики, полученных после регистрации юридического лица |
| ОКПО | String | Код по Общероссийскому классификатору предприятий и организаций |
| ОКТМО | String | Код, присвоенный территории муниципального образования или населенному пункту, входящему в его состав |
| ОКФС | String | Код по Общероссийскому классификатору форм собственности, входящего в Единую систему кодирования РФ |
| ОКОГУ | String | Код по Общероссийскому классификатору органов государственной власти и управления |
| Капитал | object | Сведения о размере указанного в учредительных документах коммерческой организации уставного капитала |
| ВидКап | String | Вид капитала. Может принимать значения: «УСТАВНЫЙ КАПИТАЛ», «СКЛАДОЧНЫЙ КАПИТАЛ», «УСТАВНЫЙ ФОНД», «ПАЕВЫЕ ВЗНОСЫ» или «ПАЕВОЙ ФОНД» |
| СумКап | String | Размер капитала в рублях |
| Дата | String | Дата внесения информации о капитале |
| Адрес | object | Сведения об адресе в РФ, внесенные в ЕГРЮЛ |
| КодРегион | String | Код субъекта Российской Федерации |
| Индекс | String | Индекс |
| АдресПолн | object | Полный адрес (Регион, Район, Город, Населенный пункт, Улица, Дом, Корпус, Квартира) |
| ИдНомФИАС | String | Уникальный идентификатор адресного объекта в ГАР |
| АдресДетали | object | Детализация адреса по составным частям |
| Регион | String | Регион |
| Тип | String | Тип региона (область, город, республика, автономный округ и др.) |
| Наим | String | Наименование региона |
| Город | String | Город |
| Тип | String | Тип города (город) |
| Наим | String | Наименование города |
| Район | String | Район |
| Тип | String | Тип района (район, автономная область) |
| Наим | String | Наименование района |
| НаселПункт | String | Населенный пункт |
| Тип | String | Тип населенного пункта (поселок, село, станица, поселок городского типа и др.) |
| Наим | String | Наименование населенного пункта |
| Улица | String | Улица |
| Тип | String | Тип улицы (улица, переулок, проезд, проспект, площадь и др.) |
| Наим | String | Наименование населенного пункта |
| Дом | String | Номер дома |
| Корпус | String | Номер корпуса |
| Кварт | String | Номер квартиры (офиса и др.) |
| Дата | String | Дата внесения информации в ЕГРЮЛ об адресе |
| ПризнНедАдресЮЛ | object | Сведения о недостоверности адреса |
| Код | String | Признак недостоверности адреса |
| Текст | String | «Текст о недостоверности сведений Принимает значение: • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код =2): • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код =3).» |
| РешИзмАдрес | object | Сведения о принятии юридическим лицом решения об изменении места нахождения |
| НовыйАдрес | String | Полный адрес нового места нахождения |
| ДатаРеш | String | Дата решения об изменении адреса |
| Руководитель | object | Сведения о руководителе организации |
| ВидДолжн | String | Вид должности по справочнику СКФЛЮЛ |
| Должн | String | Наименование должности |
| ФИОПолн | String | Фамилия Имя Отчество должностного лица |
| ИННФЛ | String | ИНН должностного лица |
| Пол | String | Мужской или Женский |
| ВидГражд | String | Гражданин РФ или Иностранный гражданин |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны гражданства (заполняется только для иностранного гражданина) |
| ОГРНИП | String | ОГРН индивидуального предпринимателя — управляющего юридическим лицом |
| ПризнНедДанДолжнФЛ | object | Сведения о недостоверности данных о лице, имеющем право без доверенности действовать от имени юридического лица |
| Код | String | Признак недостоверности. Принимает значение: 1, 2 или 3 |
| Текст | String | «Принимает значение: • «сведения недостоверны (заявление физического лица о недостоверности сведений о нем)» — если сведения о недостоверности внесены по заявлению самого ФЛ (Р34001) (Код =1), • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код =2), • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код =3).» |
| ДатаНачДискв | String | Дата начала дисквалификации лица, имеющем право без доверенности действовать от имени юридического лица |
| ДатаОкончДискв | String | Дата окончания дисквалификации лица, имеющем право без доверенности действовать от имени юридического лица |
| Дата | String | Дата внесения в ЕГРЮЛ сведений о руководителе |
| ИныеРуководители | array | Сведения об иных руководителах в организации |
| ФИОПолн | String | Фамилия Имя Отчество должностного лица |
| ИННФЛ | String | ИНН должностного лица |
| Пол | String | Мужской или Женский |
| ВидГражд | String | Гражданин РФ или Иностранный гражданин |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны гражданства (заполняется только для иностранного гражданина) |
| Дата | String | Дата внесения в ЕГРЮЛ сведений о руководителе |
| ДопИнфо | String | Наименование должности |
| Учредители | array | Сведения об учредителях (участниках) юридического лица |
| УчрЮЛ | object | Сведения об учредителе (участнике) — российском юридическом лице |
| ОГРН | ОГРН ЮЛ | |
| ИНН | ИНН ЮЛ | |
| НаимСокрЮЛ | Наименование ЮЛ сокращенное (только для ЮЛ) | |
| Статус | Статус ЮЛ | |
| УчрИН | object | Сведения об учредителе (участнике) — иностранном юридическом лице |
| НаимПолнЮЛ | String | Наименование организации |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны |
| РегНомер | String | Регистрационный номер |
| ДатаРег | String | Дата регистрации |
| АдресПолн | String | Адрес (место нахождения) в стране происхождения |
| УчрФЛ | object | Сведения об учредителе (участнике) — физическом лице |
| ФИОПолн | String | Фамилия Имя Отчество учредителя |
| ИННФЛ | String | ИНН учредителя |
| Пол | String | Мужской или Женский |
| ВидГражд | String | Гражданин РФ или Иностранный гражданин |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны гражданства (заполняется только для иностранного гражданина) |
| УчрРФСубМО | String | Сведения об учредителе (участнике) — Российской Федерации, субъекте Российской Федерации, муниципальном образовании |
| СвОргОсущПр | object | Сведения об органе государственной власти, органе местного самоуправления или о юридическом лице, осуществляющем права учредителя (участника) |
| УчрЮЛ | object | Сведения о юридическом лице, осуществляющем права учредителя (участника) |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| УчрПИФ | object | Сведения о паевом инвестиционном фонде, в состав имущества которого включена доля в уставном капитале |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| СуммаУК | String | Номинальная стоимость доли в рублях |
| Процент | String | Размер доли (в процентах) |
| ПризнНедДанУчр | Сведения о недостоверности данных об учредителе (участнике) | |
| Код | String | Признак недостоверности. Принимает значение: 1, 2 или 3 |
| Текст | String | «Принимает значение: • «сведения недостоверны (заявление физического лица о недостоверности сведений о нем)» — если сведения о недостоверности внесены по заявлению самого ФЛ (Р34001) (Код=1), • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код=2), • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код=3).» |
| Дата | String | Дата внесения в ЕГРЮЛ сведений об учредителе (участнике) |
| Залогодержатели | array | Сведения о залогодержателе доли |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| ФИОПолн | String | Фамилия Имя Отчество залогодержателя (ФЛ) |
| ИННФЛ | String | ИНН залогодержателя (ФЛ) |
| НаимПолнЮЛ | String | Наименование организации залогодержателя (Иностранное лицо) |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны |
| РегНомер | String | Регистрационный номер |
| ДатаРег | String | Дата регистрации |
| АдресПолн | String | Адрес (место нахождения) в стране происхождения |
| ВидОбременения | String | Принимает значение: ЗАЛОГ | ИНОЕ ОБРЕМЕНЕНИЕ |
| СрокОбременения | String | Срок обременения или порядок определения срока |
| Дата | String | Дата внесения в ЕГРЮЛ записи, содержащей указанные сведения об обременении |
| Предшественники | array | Сведения о правопредшественниках |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| Преемники | array | Сведения о правопреемниках |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| УправлОрг | array | Сведения о доверительном управляющем |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| ДержРеестрАО | array | Сведения о держателе реестра акционеров акционерного общества |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| Участники в реорганизации | array | Сведения об участниках в реорганизации |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| НомТел | String | Номер контактного телефона |
| String | Адрес электронной почты | |
| ОснВидДеят | object | Сведения об основном виде деятельности |
| Код | String | Код по Общероссийскому классификатору видов экономической деятельности |
| Текст | String | Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности |
| ДопВидДеят | array | Сведения о дополнительных видах деятельности |
| Код | String | Код по Общероссийскому классификатору видов экономической деятельности |
| Текст | String | Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности |
| СПВЗ | array | Сведения о причинах внесения записей в реестр ЕГРЮЛ |
| Дата | String | Дата внесения записи в ЕГРЮЛ |
| Текст | String | Наименование вида записи (причины внесения записи в ЕГРЮЛ или ЕГРИП) |
| Филиалы | array | Сведения о филиалах и представительствах компании |
| Тип | String | Филиал или Представительство |
| Адрес | String | Адрес филиала или представительства |
| ОткрСведения | array | Сведения, ранее относившиеся к налоговой тайне, но разрешенные Федеральным законом от 1 мая 2016 года № 134-ФЗ |
| КолРаб | String | Среднесписочное количество работников юридического лица |
| СведСНР | String | Список специальных налоговых режимов, применяемых компанией: ЕСХН — применение системы налогообложения в виде единого сельскохозяйственного налога, УСН — упрощенной системы налогообложения, ЕНВД — применение системы налогообложения в виде единого налога на вмененный доход, СРП — системы налогообложения при выполнении соглашения о разделе продукции. Режимы перечисляются через запятую, если их несколько. Если нет специальных режимов, то указывается «Нет» |
| ПризнУчКГН | String | Да — при участии организации в консолидированной группе налогоплательщиков, иначе — Нет |
| Налоги | array | Информация об уплаченных компанией налогах и сборах за год (по каждому налогу и сбору), а также сведения о суммах недоимки и задолженности по пеням и штрафам (если таковые есть) |
| НаимНалог | String | Наименование налога или сбора |
| СумУплНал | String | Сумма уплаченного налога или сбора |
| СумНедНалог | String | Сумма недоимки по налогу |
| СумПени | String | Сумма задолженности по пеням |
| СумШтраф | String | Сумма штрафа из-за недоимки по налогу |
| ОбщСумНедоим | String | Общая сумма недоимки по налогу, пени и штрафу |
| СумДоход | String | Сумма доходов по данным бухгалтерской (финансовой) отчетности организации, которые предоставили данную отчетность в ФНС |
| СумРасход | String | Сумма расходов по данным бухгалтерской (финансовой) отчетности организации, которые предоставили данную отчетность в ФНС |
| ОтраслевыеПок | object | Сведения об отраслевых показателях, соответствующих основному виду деятельности компании |
| НалогНагрузка | object | Сведения о среднеотраслевой налоговой нагрузке |
| Рентабельность | object | Сведения о среднеотраслевой рентабельности |
| Дата | String | Дата, по состоянию на которую подготовлены данные (в формате YYYY-MM-DD) |
| Лицензии | array | Сведения о лицензиях, выданных ЮЛ |
| НомерЛиц | String | Серия и номер лицензии |
| ВидДеятельности | String | Наименование лицензируемого вида деятельности, на который выдана лицензия |
| ДатаНачала | String | Дата начала действия лицензии |
| ДатаОконч | String | Дата окончания действия лицензии |
| МестоДейств | String | Сведения об адресах осуществления лицензируемого вида деятельности (если несколько, то адреса разделяются знаком вертикальной черты |) |
| Участия | array | Сведения об организациях, в капитале которых участвует компания |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Процент | String | Размер доли (в процентах) |
| СуммаУК | String | Номинальная стоимость доли в рублях |
| История | object | Исторические сведения о компании |
| Капитал | array | Исторические сведения о капитале |
| Период актуальности данных | object | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| СумКап | String | Размер капитала в рублях |
| НаимЮЛПолн | array | Прошлые полные названия организации |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| НаимЮЛСокр | array | Прошлые сокращенные названия организации |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| Статус | array | Прошлые статусы организации |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| Адрес | array | Исторические сведения о прошлых адресах компании |
| Период актуальности данных | object | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| АдресПолн | String | Адрес полный |
| Руководитель | object | Исторические сведения о бывших руководителях |
| Период актуальности данных | array | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| ФИОПолн | String | Фамилия Имя Отчество бывшего должностного лица |
| ИННФЛ | String | ИНН бывшего должностного лица |
| Должн | String | Должность бывшего должностного лица |
| ПризнНедДанДолжнФЛ | String | Сведения об исторических данных о недостоверности руководителя |
| Код | String | Признак недостоверности. Принимает значение: 1, 2 или 3 |
| Текст | String | «Принимает значение: • «сведения недостоверны (заявление физического лица о недостоверности сведений о нем)» — если сведения о недостоверности внесены по заявлению самого ФЛ (Р34001) (Код =1), • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код =2), • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код =3).» |
| ДатаОкончДискв | object | Исторические (удаленные из ЕГРЮЛ) данные о дате окончания дисквалификации руководителя |
| НомТел | String | Прошлые номера контактного телефона |
| Период актуальности данных | array | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| String | Прошлые адреса электронной почты | |
| Период актуальности данных | array | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| ИныеРуководители | array | Сведения о прошлых иных руководителах в организации |
| ФИОПолн | String | Фамилия Имя Отчество должностного лица |
| ИННФЛ | String | ИНН должностного лица |
| Дата | String | Дата внесения в ЕГРЮЛ сведений о руководителе |
| ДатаОконч | String | Дата окончания сведений |
| ДопИнфо | String | Наименование должности |
| Учредители | array | Сведения о прошлых учредителях (участниках) юридического лица |
| УчрЮЛ | object | Сведения об учредителе (участнике) — российском юридическом лице |
| ОГРН | ОГРН ЮЛ | |
| ИНН | ИНН ЮЛ | |
| НаимСокрЮЛ | Наименование ЮЛ сокращенное (только для ЮЛ) | |
| Статус | Статус ЮЛ | |
| УчрИН | object | Сведения об учредителе (участнике) — иностранном юридическом лице |
| НаимПолнЮЛ | String | Наименование организации |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны |
| РегНомер | String | Регистрационный номер |
| ДатаРег | String | Дата регистрации |
| АдресПолн | String | Адрес (место нахождения) в стране происхождения |
| УчрФЛ | object | Сведения об учредителе (участнике) — физическом лице |
| ФИОПолн | String | Фамилия Имя Отчество учредителя |
| ИННФЛ | String | ИНН учредителя |
| УчрРФСубМО | String | Сведения об учредителе (участнике) — Российской Федерации, субъекте Российской Федерации, муниципальном образовании |
| СвОргОсущПр | object | Сведения об органе государственной власти, органе местного самоуправления или о юридическом лице, осуществляющем права учредителя (участника) |
| УчрЮЛ | object | Сведения о юридическом лице, осуществляющем права учредителя (участника) |
| ОГРН | ОГРН ЮЛ | |
| ИНН | ИНН ЮЛ | |
| НаимСокрЮЛ | Наименование ЮЛ сокращенное (только для ЮЛ) | |
| Статус | Статус ЮЛ | |
| СуммаУК | String | Номинальная стоимость доли в рублях |
| Процент | String | Размер доли (в процентах) |
| Дата | String | Дата внесения в ЕГРЮЛ сведений об учредителе (участнике) |
| ДатаОконч | String | Дата окончания участия учредителя |
| Предшественники | array | Сведения об исторических правопредшественниках |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| ДатаОконч | String | Дата окончания сведений |
| Преемники | array | Сведения об исторических правопреемниках |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| ДатаОконч | String | Дата окончания сведений |
| УправлОрг | array | Сведения об исторических доверительных управляющих |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| ДатаОконч | String | Дата окончания сведений |
| ДержРеестрАО | array | Сведения об исторических держателях реестра акционеров акционерного общества |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| ДатаОконч | String | Дата окончания сведений |
| Участники в реорганизации | array | Сведения об исторических участниках в реорганизации |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| Дата | String | Дата внесения сведений в ЕГРЮЛ |
| ДатаОконч | String | Дата окончания сведений |
| Поля для НР: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| КПП | String | КПП искомой компании |
| НЗА | String | Номер записи об аккредитации (НЗА) искомой компании |
| ПризАк | String | Принимает значение: «Филиал иностранного юридического лица»» или «Представительство иностранного юридического лица» |
| НО | object | Сведения об учете |
| Аккр | String | Код налогового органа, уполномоченного на аккредитацию филиалов/представительств иностранных юридических лиц |
| АккрДата | String | Дата аккредитации (внесения сведений об аккредитации в РАФП) |
| ДатаПрекрАккр | String | Дата прекращения действия аккредитации (внесения сведений о прекращении действия аккредитации в РАФП) |
| Учет | String | Код и наименование налогового органа, в котором юридическое лицо состоит (для ЮЛ, прекративших деятельность — состояло) на учете |
| УчетДата | String | Дата постановки на учет в налоговом органе |
| НаимПредПолн | String | Полное наименование филиала, представительства иностранного юридического лица |
| НаимПредСокр | String | Краткое наименование филиала, представительства иностранного юридического лица |
| НаимЮЛПолн | String | Полное наименование иностранного юридического лица |
| НаимЮЛСокр | String | Краткое наименование иностранного юридического лица |
| Адрес | object | Сведения об адресе места нахождения филиала, представительства на территории Российской Федерации |
| КодРегион | String | Код субъекта Российской Федерации |
| Индекс | String | Индекс |
| АдресПолн | object | Полный адрес (Регион, Район, Город, Населенный пункт, Улица, Дом, Корпус, Квартира) |
| АдресДетали | object | Детализация адреса по составным частям |
| Регион | String | Регион |
| Тип | String | Тип региона (область, город, республика, автономный округ и др.) |
| Наим | String | Наименование региона |
| Город | String | Город |
| Тип | String | Тип города (город) |
| Наим | String | Наименование города |
| Район | String | Район |
| Тип | String | Тип района (район, автономная область) |
| Наим | String | Наименование района |
| НаселПункт | String | Населенный пункт |
| Тип | String | Тип населенного пункта (поселок, село, станица, поселок городского типа и др.) |
| Наим | String | Наименование населенного пункта |
| Улица | String | Улица |
| Тип | String | Тип улицы (улица, переулок, проезд, проспект, площадь и др.) |
| Наим | String | Наименование населенного пункта |
| Дом | String | Номер дома |
| Корпус | String | Номер корпуса |
| Кварт | String | Номер квартиры (офиса и др.) |
| Руководитель | object | Сведения о руководителе организации |
| ФИОПолн | String | Фамилия Имя Отчество должностного лица |
| ИННФЛ | String | ИНН должностного лица |
| СвИнРабАкт | object | Численность иностранных граждан, являющихся работниками филиала, представительства иностранного юридического лица |
| История | object | Исторические сведения о компании |
| НаимПредПолн | array | Прошлые полные названия филиала, представительства иностранного юридического лица |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| НаимПредСокр | array | Прошлые краткие названия филиала, представительства иностранного юридического лица |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| НаимЮЛПолн | array | Прошлые полные названия организации |
| Период актуальности данных | String | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| Адрес | array | Исторические сведения о прошлых адресах компании |
| Период актуальности данных | object | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| АдресПолн | String | Адрес полный |
| Руководитель | object | Исторические сведения о бывших руководителях |
| Период актуальности данных | array | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
| ФИОПолн | String | Фамилия Имя Отчество бывшего должностного лица |
| ИННФЛ | String | ИНН бывшего должностного лица |
| СвИнРабАкт | array | Исторические сведения о прошлых численностях иностранных граждан, являющихся работниками филиала, представительства иностранного юридического лица |
| Период актуальности данных | object | В формате YYYY-MM-DD ~ YYYY-MM-DD (начальная и конечная даты, разделенные знаком ~ «тильда») |
Примеры запросов.
https://api-fns.ru/api/egr?req=1032502271548&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ИНН": "2540096950",
"КПП": "254001001",
"ОГРН": "1032502271548",
"ДатаРег": "2003-09-08",
"ОКОПФ": "Общества с ограниченной ответственностью",
"Статус": "Действующее",
"СпОбрЮЛ": "Создание юридического лица",
"НО": {
"Рег": "2536 (Инспекция Федеральной налоговой службы по Ленинскому району г.Владивостока)",
"РегДата": "2016-01-22",
"Учет": "2540 (Инспекция Федеральной налоговой службы по Фрунзенскому району г.Владивостока)",
"УчетДата": "2003-09-08"
},
"ПФ": {
"РегНомПФ": "035008012573",
"ДатаРегПФ": "2003-09-11",
"КодПФ": "035008 (Государственное учреждение-Управление Пенсионного фонда Российской Федерации по Фрунзенскому району г.Владивостока Приморского края)"
},
"ФСС": {
"РегНомФСС": "250440563225001",
"ДатаРегФСС": "2003-09-11",
"КодФСС": "2500 (Государственное учреждение - Приморское региональное отделение Фонда социального страхования Российской Федерации)"
},
"Капитал": {
"ВидКап": "Уставный капитал",
"СумКап": "12000",
"Дата": "2003-09-08"
},
"НаимСокрЮЛ": "ООО "ДАЛЬЧЕРМЕТ"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ДАЛЬЧЕРМЕТ"",
"Адрес": {
"КодРегион": "25",
"Индекс": "690106",
"АдресПолн": "край Приморский, г. Владивосток, пр-кт Океанский, д.69, оф.307",
"Дата": "2017-12-12"
},
"Руководитель": {
"ВидДолжн": "Руководитель юридического лица",
"Должн": "Директор",
"ФИОПолн": "Гатин Марат Рафаэльевич",
"ИННФЛ": "253904418281",
"Дата": "2015-03-26"
},
"Учредители": [
{
"УчрФЛ": {
"ФИОПолн": "Гатин Марат Рафаэльевич",
"ИННФЛ": "253904418281"
},
"СуммаУК": "12000",
"Процент": "100",
"Дата": "2009-12-21"
}
],
"НомТел": "8 423 2446377",
"E-mail": "INFO@DALCHERMET.RU",
"ОснВидДеят": {
"Код": "46.77",
"Текст": "Торговля оптовая отходами и ломом"
},
"ДопВидДеят": [
{
"Код": "38.32.2",
"Текст": "Обработка отходов и лома драгоценных металлов"
},
{
"Код": "38.32.3",
"Текст": "Обработка отходов и лома черных металлов"
},
{
"Код": "38.32.4",
"Текст": "Обработка отходов и лома цветных металлов"
},
{
"Код": "38.32.5",
"Текст": "Обработка вторичного неметаллического сырья"
},
{
"Код": "46.12",
"Текст": "Деятельность агентов по оптовой торговле топливом, рудами, металлами и химическими веществами"
},
{
"Код": "46.13",
"Текст": "Деятельность агентов по оптовой торговле лесоматериалами и строительными материалами"
},
{
"Код": "46.14",
"Текст": "Деятельность агентов по оптовой торговле машинами, промышленным оборудованием, судами и летательными аппаратами"
},
{
"Код": "46.18",
"Текст": "Деятельность агентов, специализирующихся на оптовой торговле прочими отдельными видами товаров"
},
{
"Код": "46.21",
"Текст": "Торговля оптовая зерном, необработанным табаком, семенами и кормами для сельскохозяйственных животных"
},
{
"Код": "46.62",
"Текст": "Торговля оптовая станками"
},
{
"Код": "46.71",
"Текст": "Торговля оптовая твердым, жидким и газообразным топливом и подобными продуктами"
},
{
"Код": "46.71.1",
"Текст": "Торговля оптовая твердым топливом"
},
{
"Код": "46.71.2",
"Текст": "Торговля оптовая моторным топливом, включая авиационный бензин"
},
{
"Код": "46.72",
"Текст": "Торговля оптовая металлами и металлическими рудами"
},
{
"Код": "46.73",
"Текст": "Торговля оптовая лесоматериалами, строительными материалами и санитарно-техническим оборудованием"
},
{
"Код": "46.75",
"Текст": "Торговля оптовая химическими продуктами"
},
{
"Код": "46.76",
"Текст": "Торговля оптовая прочими промежуточными продуктами"
},
{
"Код": "46.90",
"Текст": "Торговля оптовая неспециализированная"
},
{
"Код": "52.10",
"Текст": "Деятельность по складированию и хранению"
},
{
"Код": "52.24.2",
"Текст": "Транспортная обработка прочих грузов"
}
],
"СПВЗ": [
{
"Дата": "2017-12-12",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2016-09-23",
"Текст": "Государственная регистрация изменений, внесенных в учредительные документы юридического лица, связанных с внесением изменений в сведения о юридическом лице, содержащиеся в Едином государственном реестре юридических лиц, на основании заявления"
},
{
"Дата": "2016-02-26",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2015-03-26",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2013-04-23",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2010-12-14",
"Текст": "Представление лицензирующим органом сведений о переоформлении документов, подтверждающих наличие лицензии (сведений о продлении срока действия лицензии)"
},
{
"Дата": "2010-07-16",
"Текст": "Государственная регистрация изменений, внесенных в учредительные документы юридического лица, связанных с внесением изменений в сведения о юридическом лице, содержащиеся в Едином государственном реестре юридических лиц, на основании заявления"
},
{
"Дата": "2010-04-21",
"Текст": "Представление сведений о регистрации юридического лица в качестве страхователя в исполнительном органе Фонда социального страхования Российской Федерации"
},
{
"Дата": "2009-12-21",
"Текст": "Представление сведений о регистрации юридического лица в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации"
},
{
"Дата": "2009-12-21",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2009-11-25",
"Текст": "Государственная регистрация изменений, внесенных в устав общества с ограниченной ответственностью в целях приведения его в соответствие с положениями Федерального закона от 30.12.2008 № 312-ФЗ"
},
{
"Дата": "2009-11-25",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2009-01-23",
"Текст": "Представление сведений о регистрации юридического лица в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации"
},
{
"Дата": "2005-04-18",
"Текст": "Внесение изменений в сведения о юридическом лице, содержащиеся в Едином государственном реестре юридических лиц, в связи ошибками, допущенными регистрирующим органом"
},
{
"Дата": "2004-03-23",
"Текст": "Государственная регистрация изменений, внесенных в учредительные документы юридического лица, связанных с внесением изменений в сведения о юридическом лице, содержащиеся в Едином государственном реестре юридических лиц, на основании заявления"
},
{
"Дата": "2004-03-17",
"Текст": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
{
"Дата": "2003-09-08",
"Текст": "Создание юридического лица"
},
{
"Дата": "2003-09-08",
"Текст": "Представление сведений об учете юридического лица в налоговом органе"
}
],
"ОткрСведения": {
"КолРаб": "7",
"СведСНР": "Нет",
"ПризнУчКГН": "Нет",
"Дата": "2018-01-01"
},
"Участия": [
{
"ОГРН": "1041400024951",
"ИНН": "1402045606",
"НаимСокрЮЛ": "ООО "САХА-МЕТАЛЛ"",
"Статус": "Ликвидировано по 129-ФЗ",
"СуммаУК": "5100"
},
{
"ОГРН": "1051401181435",
"ИНН": "1426005190",
"НаимСокрЮЛ": "ООО "ХАНДЫГА-ДЧМ"",
"Статус": "Ликвидировано по суду",
"СуммаУК": "10000"
}
],
"История": {
"Адрес": {
"2003-09-08 ~ 2016-09-22": {
"АдресПолн": "край Приморский, г. Владивосток, ул. Станюковича, д.29, кор.А"
},
"2016-09-23 ~ 2017-12-11": {
"АдресПолн": "край Приморский, г. Владивосток, ул. Московская, д.1"
}
}
}
}
}
]
}
https://api-fns.ru/api/egr?req=317392600037860&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ИП": {
"ФИОПолн": "Мущинский Дмитрий Витальевич",
"ИННФЛ": "391706515344",
"ОГРНИП": "317392600037860",
"ДатаРег": "2017-09-07",
"ВидИП": "Индивидуальный предприниматель",
"Пол": "Мужской",
"ВидГражд": "Иностранный гражданин",
"ОКСМ": "112 (БЕЛОРУССИЯ)",
"Статус": "Действующее",
"НО": {
"Рег": "3926 (Межрайонная инспекция Федеральной налоговой службы № 1 по Калининградской области)",
"РегДата": "2017-09-07",
"Учет": "3905 (Межрайонная инспекция Федеральной налоговой службы №8 по г. Калининграду)",
"УчетДата": "2017-09-07"
},
"ПФ": {
"РегНомПФ": "049004033077",
"ДатаРегПФ": "2017-09-08",
"КодПФ": "049004 (Отдел Пенсионного фонда Российской Федерации Московского района г. Калининграда)"
},
"ФСС": {},
"Адрес": {
"КодРегион": "39",
"АдресПолн": "обл. Калининградская, г. Калининград",
"Дата": "2017-09-07"
},
"ОснВидДеят": {
"Код": "56.10",
"Текст": "Деятельность ресторанов и услуги по доставке продуктов питания"
},
"ДопВидДеят": [],
"СПВЗ": [
{
"Дата": "2017-09-21",
"Текст": "Представление сведений о регистрации в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации"
},
{
"Дата": "2017-09-07",
"Текст": "Представление сведений об учете в налоговом органе"
},
{
"Дата": "2017-09-07",
"Текст": "Государственная регистрация физического лица в качестве индивидуального предпринимателя"
}
],
"История": {}
}
}
]
}
Реквизиты группы компаний
Позволяет получить актуальные базовые данные из ЕГРЮЛ или ЕГРИП сразу по группе компаний (включая контактные данные).
На входе подается массив ОГРН или ИНН одной или нескольких компаний, либо строка, содержащая ОГРН или ИНН одной или нескольких компаний, разделенных запятыми (не более 100 компаний). На выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/multinfo
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req[]=7811230103&req[]=1157847305770 |
массив ОГРН или ИНН искомых компаний |
| req | string req=308663935100010, 7729473907, 7811230103, 1124025008689, 7743118911, 7724332980, 1157847305813 |
ОГРН или ИНН искомых компаний, разделенных запятыми |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию из ЕГРЮЛ (ЕГРИП).
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска (например, при запросе по ИНН может быть возвращена не одна, а несколько записей) |
| ЮЛ, ИП или НР | object | Тип искомой компании (индивидуальный предприниматель — ИП, юридическое лицо — ЮЛ, НР — представительство иностранного юридического лица) |
| Поля для ИП: | (любое из полей может отсутствовать) | |
| ФИОПолн | String | Фамилия Имя Отчество индивидуального предпринимателя |
| ИННФЛ | String | ИНН физического лица |
| ОГРНИП | String | ОГРН ИП |
| ДатаОГРН | String | Дата выдачи ОГРН в формате YYYY-MM-DD |
| ДатаРег | String | Дата регистрации ИП в формате YYYY-MM-DD |
| ВидИП | Индивидуальный предприниматель или глава крестьянского фермерского хозяйства | |
| Пол | Мужской или Женский | |
| ВидГражд | Гражданин РФ или Иностранный гражданин | |
| Статус | String | Статус ИП. Например, «Действующее», Прекратило деятельность и др. |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| Адрес | object | Сведения об адресе в РФ, внесенные в ЕГРЮЛ |
| КодРегион | String | Код субъекта Российской Федерации |
| Индекс | String | Индекс |
| АдресПолн | object | Полный адрес (Регион, Район, Город, Населенный пункт, Улица, Дом, Корпус, Квартира) |
| ОснВидДеят | object | Сведения об основном виде деятельности |
| Код | String | Код по Общероссийскому классификатору видов экономической деятельности |
| Текст | String | Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности (ОКВЭД) |
| ДопВидДеят | String | Коды дополнительных видов деятельности (ОКВЭД), перечисленные через запятую |
| РеестрМСП | String | Наличие компании в едином реестре малых и средних предприятий (МСП) |
| КатСубМСП | String | Категория субъекта МСП (Микропредприятие, Малое предприятие, Среднее предприятие) |
| ДатаСост | String | Дата состояния |
| Контакты | String | Контактная информация — телефоны и e-mail, перечисленные через запятую |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| КПП | String | КПП искомой компании |
| ОГРН | String | ОГРН искомой компании |
| НаимСокрЮЛ | String | Наименование ЮЛ полное (только для ЮЛ) |
| НаимПолнЮЛ | String | Наименование ЮЛ краткое (только для ЮЛ) |
| ДатаОГРН | String | Дата выдачи ОГРН в формате YYYY-MM-DD |
| ДатаРег | String | Дата регистрации ЮЛ в формате YYYY-MM-DD |
| Статус | String | Статус ЮЛ (ИП). Например, «Действующее», «Ликвидировано», «В состоянии реорганизации» и др. |
| СтатусДата | Дата актуальности статуса в формате YYYY-MM-DD | |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| Капитал | object | Сведения о размере указанного в учредительных документах коммерческой организации уставного капитала |
| СумКап | String | Размер капитала в рублях |
| Адрес | object | Сведения об адресе в РФ, внесенные в ЕГРЮЛ |
| КодРегион | String | Код субъекта Российской Федерации |
| Индекс | String | Индекс |
| АдресПолн | object | Полный адрес (Регион, Район, Город, Населенный пункт, Улица, Дом, Корпус, Квартира) |
| Руководитель | object | Сведения о руководителе организации |
| Должн | String | Наименование должности |
| ФИОПолн | String | Фамилия Имя Отчество должностного лица |
| ИННФЛ | String | ИНН должностного лица |
| ОснВидДеят | object | Сведения об основном виде деятельности |
| Код | String | Код по Общероссийскому классификатору видов экономической деятельности (ОКВЭД) |
| Текст | String | Наименование вида деятельности по Общероссийскому классификатору видов экономической деятельности |
| ДопВидДеят | String | Коды дополнительных видов деятельности (ОКВЭД), перечисленные через запятую |
| РеестрМСП | String | Наличие компании в едином реестре малых и средних предприятий (МСП) |
| КатСубМСП | String | Категория субъекта МСП (Микропредприятие, Малое предприятие, Среднее предприятие) |
| ДатаСост | String | Дата состояния |
| ОткрСведения | array | Некоторые открытые сведения по 134-ФЗ |
| КолРаб | String | Среднесписочное количество работников юридического лица |
| ДатаСост | String | Дата, по состоянию на которую подготовлены данные (в формате YYYY-MM-DD) |
| Финансы | array | Некоторые финансовые сведения |
| Выручка | String | Выручка в тыс. руб. |
| Год | String | Год, на которые предоставлены финансовые сведения (в формате YYYY) |
| Контакты | String | Контактная информация — сайт, телефоны и e-mail, перечисленные через запятую |
Примеры запросов.
https://api-fns.ru/api/multinfo?req=308661702400048,7811051680,1157746828722&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ИП": {
"ФИОПолн": "Копытина Нина Григорьевна",
"ИННФЛ": "661400076307",
"ОГРНИП": "308661702400048",
"ДатаРег": "2008-01-24",
"ВидИП": "Индивидуальный предприниматель",
"Пол": "Женский",
"ВидГражд": "Гражданин РФ",
"Статус": "Прекратило деятельность",
"ДатаПрекр": "2013-05-27",
"Адрес": {
"КодРегион": "66",
"АдресПолн": "обл. Свердловская, г. Карпинск, д.90, оф.3"
},
"ОснВидДеят": {
"Код": "93.04",
"Текст": "Физкультурно-оздоровительная деятельность"
}
}
},
{
"ЮЛ": {
"ИНН": "7811051680",
"КПП": "781101001",
"ОГРН": "1027806065242",
"ДатаРег": "1995-09-28",
"Статус": "Действующее",
"Капитал": {
"СумКап": "40000"
},
"НаимСокрЮЛ": "ООО "ЛЕГО"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЛЕГО"",
"Адрес": {
"КодРегион": "78",
"Индекс": "192029",
"АдресПолн": "г. Санкт-Петербург, пр-кт Большой Смоленский, д.2, лит.А"
},
"Руководитель": {
"ФИОПолн": "Тихонов Максим Александрович",
"ИННФЛ": "781435977548"
},
"ОснВидДеят": {
"Код": "46.74.2",
"Текст": "Торговля оптовая водопроводным и отопительным оборудованием и санитарно-технической арматурой"
}
}
},
{
"ЮЛ": {
"ИНН": "7721350886",
"КПП": "772001001",
"ОГРН": "1157746828722",
"ДатаРег": "2015-09-08",
"Статус": "Ликвидировано",
"ДатаПрекр": "2018-11-15",
"Капитал": {
"СумКап": "10000"
},
"НаимСокрЮЛ": "ООО "ОНЛАЙН ТРЕЙДИНГ"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ОНЛАЙН ТРЕЙДИНГ"",
"Адрес": {
"КодРегион": "77",
"Индекс": "111123",
"АдресПолн": "г. Москва, ул. Плеханова, д.4А, пом.XII ком.13"
},
"Руководитель": {
"ФИОПолн": "Кутыркина Марина Анатольевна",
"ИННФЛ": "680600435554"
},
"ОснВидДеят": {
"Код": "47.99",
"Текст": "Торговля розничная прочая вне магазинов, палаток, рынков"
}
}
}
]
}
Базовая проверка группы компаний
Позволяет провести базовую (упрощенную) проверку нескольких юридических лиц или индивидуальных предпринимателей.
На входе подается массив ОГРН или ИНН одной или нескольких компаний, либо строка, содержащая ОГРН или ИНН одной или нескольких компаний, разделенных запятыми (не более 100 компаний). На выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/multcheck
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req[]=7811230103&req[]=1157847305770 |
массив ОГРН или ИНН искомых компаний |
| req | string req=1047796296910,304532133100229,1085009004299, 1107746443958,7731483532,1077746404450,1072650001456 |
ОГРН или ИНН искомых компаний, разделенных запятыми |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию из ЕГРЮЛ (ЕГРИП).
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска (Внимание: выводятся только проблемные компании!) |
| ЮЛ или ИП | object | Тип искомой компании (юридическое лицо — ЮЛ или индивидуальный предприниматель — ИП) |
| Поля для ИП: | (любое из полей может отсутствовать) | |
| ФИОПолн | String | Фамилия Имя Отчество индивидуального предпринимателя |
| ИННФЛ | String | ИНН физического лица |
| ОГРНИП | String | ОГРН ИП |
| Статус | String | Статус ИП. Например, «Действующее», Прекратило деятельность и др. |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| ОГРН | String | ОГРН искомой компании |
| НаимСокрЮЛ | String | Наименование ЮЛ полное (только для ЮЛ) |
| НаимПолнЮЛ | String | Наименование ЮЛ краткое (только для ЮЛ) |
| Статус | String | Статус ЮЛ (ИП). Например, «Действующее», «Ликвидировано», «В состоянии реорганизации» и др. |
| ДатаПрекр | String | Дата прекращения деятельности ЮЛ (ИП) (если деятельность прекращена) в формате YYYY-MM-DD |
| Адрес | object | Сведения об адресе в РФ, внесенные в ЕГРЮЛ (только негатив, если есть) |
| РеестрМассАдрес | String | Да, если организация зарегистрирована по адресу массовой регистрации (по реестру массовых адресов ФНС) |
| ПризнНедАдресЮЛ | object | Сведения о недостоверности адреса |
| Код | String | Признак недостоверности адреса |
| Текст | String | «Текст о недостоверности сведений Принимает значение: • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код =2): • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код =3).» |
| Руководитель | object | Сведения о руководителе организации (только негатив, если есть) |
| ПризнНедДанДолжнФЛ | object | Сведения о недостоверности данных о лице, имеющем право без доверенности действовать от имени юридического лица |
| Код | String | Признак недостоверности. Принимает значение: 1, 2 или 3 |
| Текст | String | «Принимает значение: • «сведения недостоверны (заявление физического лица о недостоверности сведений о нем)» — если сведения о недостоверности внесены по заявлению самого ФЛ (Р34001) (Код =1), • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код =2), • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код =3).» |
| ДатаОкончДискв | object | Дата окончания дисквалификации лица, имеющем право без доверенности действовать от имени юридического лица |
| Учредители | array | Сведения об учредителях (участниках) юридического лица (только негатив, если есть) |
| ПризнНедДанУчр | Сведения о недостоверности данных об учредителе (участнике) | |
| Код | String | Признак недостоверности. Принимает значение: 1, 2 или 3 |
| Текст | String | «Принимает значение: • «сведения недостоверны (заявление физического лица о недостоверности сведений о нем)» — если сведения о недостоверности внесены по заявлению самого ФЛ (Р34001) (Код=1), • «сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)» — если сведения о недостоверности внесены по данным, выявленным НО (Код=2), • «сведения недостоверны (решение суда)» — если сведения о недостоверности внесены на основании решения суда (Код=3).» |
Примеры запросов.
https://api-fns.ru/api/multcheck?req=1047796296910,304532133100229,1085009004299,1107746443958,7731483532,1077746404450,1072650001456&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ИП": {
"ФИОПолн": "Попов Александр Михайлович",
"ИННФЛ": "532102101212",
"ОГРНИП": "304532133100229",
"Статус": "Прекратило деятельность",
"ДатаПрекр": "2004-12-15"
}
},
{
"ЮЛ": {
"ИНН": "7734143132",
"ОГРН": "1077746404450",
"Статус": "Ликвидировано по 129-ФЗ",
"ДатаПрекр": "2007-02-23",
"НаимСокрЮЛ": "ГЛАВСТРОЙ КОМПАНИЯ (14313/5070)",
"НаимПолнЮЛ": "ООО ГЛАВСТРОЙ КОМПАНИЯ"
}
},
{
"ЮЛ": {
"ИНН": "7705594934",
"ОГРН": "1047796296910",
"Статус": "Действующее",
"НаимСокрЮЛ": "ООО "ПОИСК-ТЕЛЕКОМ"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ПОИСК-ТЕЛЕКОМ"",
"Адрес": {
"ПризнНедАдресЮЛ": {
"Код": "2",
"Текст": "сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)"
}
}
}
},
{
"ЮЛ": {
"ИНН": "2626037441",
"ОГРН": "1072650001456",
"Статус": "Действующее",
"НаимСокрЮЛ": "ООО "ИНТЕРБИЗНЕС"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ИНТЕРБИЗНЕС"",
"Адрес": {
"ПризнНедАдресЮЛ": {
"Код": "2",
"Текст": "сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)"
}
}
}
},
{
"ЮЛ": {
"ИНН": "5009065210",
"ОГРН": "1085009004299",
"Статус": "Действующее",
"НаимСокрЮЛ": "ООО "ТОРГИНВЕСТ"",
"НаимПолнЮЛ": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ТОРГИНВЕСТ"",
"Руководитель": {
"ДатаОкончДискв": "2020-02-03"
}
}
},
{
"ЮЛ": {
"ИНН": "7720687171",
"ОГРН": "1107746443958",
"Статус": "Ликвидировано",
"ДатаПрекр": "2019-03-29",
"НаимСокрЮЛ": "ООО "ТК "МЕГАТРАНС"",
"НаимПолнЮЛ": "ООО "ТРАНСПОРТНАЯ КОМПАНИЯ "МЕГАТРАНС"",
"Адрес": {
"ПризнНедАдресЮЛ": {
"Код": "2",
"Текст": "сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)"
}
},
"Руководитель": {
"ПризнНедДанДолжнФЛ": {
"Код": "2",
"Текст": "сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)"
}
},
"ПризнНедДанУчр": {
"Код": "2",
"Текст": "сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)"
}
}
}
]
}
Проверка контрагента
Позволяет получить аналитическую информацию о компании: негативные и позитивные факторы, свидетельствующие о добросовестности контрагента, наличие компании в реестрах ФНС, отметки о недостоверных данных, признаки «массового» директора, учредителя, решений о ликвидации, реорганизации и прочие.
На входе подается ОГРН или ИНН компании, на выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/check
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1026605606620 |
ОГРН или ИНН искомой компании (юридического лица или ИП) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий аналитическую информацию по искомой компании.
Поля возвращаемого документа:
| Имя | Тип | Описание | |
|---|---|---|---|
| items | Array | Массив результатов поиска | |
| ЮЛ или ИП | object | Тип искомой компании (юридическое лицо или индивидуальные предприниматель) | |
| Поля для ИП: | (любое из полей может отсутствовать) | ||
| ИННФЛ | String | ИНН физического лица | |
| ОГРНИП | String | ОГРН ИП | |
| Позитив | object | Позитивная информация о ИП | |
| Лицензии | String | Есть при наличии действующих лицензий у ИП | |
| РеестрМСП | String | Наличие компании в едином реестре малых и средних предприятий (МСП) | |
| ДатаВклМСП | String | Дата включения в реестр МСП | |
| КатСубМСП | String | Категория субъекта МСП (Микропредприятие, Малое предприятие, Среднее предприятие) | |
| ПризНовМСП | String | Вновь созданное или нет | |
| СведСоцПред | String | Сведения о том, что индивидуальный предприниматель является социальным предприятием | |
| ССЧР | String | Сведения о среднесписочной численности работников | |
| ДатаСост | String | Дата состояния | |
| АдресМСП | String | Адрес предприятия в реестре МСП | |
| Текст | String | Сводная текстовая информация о всех найденных позитивных факторах, разделенных точкой с запятой | |
| Негатив | object | Негативная информация о ИП (факторы риска) | |
| Статус | String | Статус ИП в случае, если ИП недействующий | |
| ИсклИзРеестраМСП | String | Компания исключена из реестра МСП | |
| РегНедавно | String | Да, если ИП зарегистрирован менее 3 месяцев, 6 месяцев или менее 1 года назад | |
| РеестрМассРук | String | Да, если предприниматель находится реестре массовых руководителей | |
| РеестрМассУчр | String | Да, если предприниматель находится реестре массовых учредителей | |
| БлокСчета | String | Да, если в отношении ИП есть решение налоговой о приостановлении по счетам налогоплательщика (блокировки счетов с указанием банка и даты последней блокировки в этом банке). Внимание! Предоставляется только в платном аккаунте. |
|
| Банкрот | String | Да, при наличии процедуры банкротства в отношении контрагента в картотеке арбитражных дел. Внимание! Предоставляется только в платном аккаунте. |
|
| БанкротНамерение | String | Да, при наличии сообщений о намерении кредитора обратиться в суд с заявлением о банкротстве . Внимание! Предоставляется только в платном аккаунте. |
|
| Текст | String | Сводная текстовая информация о негативных факторах, разделенных точкой с запятой | |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | ||
| ИНН | String | ИНН искомой компании | |
| ОГРН | String | ОГРН искомой компании | |
| Позитив | object | Позитивная информация о ЮЛ | |
| Лицензии | String | Есть при наличии действующих лицензий у компании | |
| Филиалы | String | Есть при наличии филиалов (подразделений) у компании | |
| РеестрМСП | String | Наличие компании в едином реестре малых и средних предприятий (МСП) | |
| ДатаВклМСП | String | Дата включения в реестр МСП | |
| КатСубМСП | String | Категория субъекта МСП (Микропредприятие, Малое предприятие, Среднее предприятие) | |
| ПризНовМСП | String | Вновь созданное или нет | |
| СведСоцПред | String | Сведения о том, что юридическое лицо является социальным предприятием | |
| ССЧР | String | Сведения о среднесписочной численности работников | |
| ДатаСост | String | Дата состояния | |
| КапБолее50тыс | String | Да, если организация имеет уставный капитал более 50 тыс. руб. | |
| Текст | String | Сводная текстовая информация о всех найденных позитивных факторах, разделенных точкой с запятой | |
| Негатив | object | Негативная информация о ЮЛ (факторы риска) | |
| Статус | String | Статус ЮЛ в случае, если ЮЛ недействующее | |
| ИсклИзРеестраМСП | String | Компания исключена из реестра МСП | |
| РегНедавно | String | Да, если ЮЛ зарегистрировано менее 3 месяцев, 6 месяцев или менее 1 года назад | |
| ДисквРук | String | Да, если руководитель дисквалифицирован в организации | |
| ДисквРукДр | String | Да, если руководитель дисквалифицирован в других организациях | |
| ДисквРукДрБезИНН | String | Да, если руководитель с данным ФИО без указанного ИНН дисквалифицирован в других организациях | |
| РеестрМассАдрес | String | Да, если организация зарегистрирована по адресу массовой регистрации (по реестру массовых адресов ФНС) | |
| МассАдрес | String | Да, если организация зарегистрирована по адресу массовой регистрации (более 9 организаций по данному адресу из базы данных ФНС) | |
| РешИзмАдрес | String | Да, если организация приняла решение изменить адрес | |
| НедостоверАдрес | String | Да, если адрес организации признан недостоверным ФНС (по результатам проверки или на основании решения суда) | |
| СменаРег | String | Да, если произошла смена региона регистрации за последний год | |
| РеестрМассРук | String | Да, если руководитель организации находится в реестре массовых руководителей | |
| МассРук | String | Да, если руководитель организации руководит более чем 5-ю действующими организациями согласно базе ФНС | |
| МассРукБезИНН | String | Да, если руководитель с данным ФИО без указанного ИНН руководит боле чем 5-ю организациями согласно базе ФНС | |
| РукЛиквКомп | String | Да, если руководитель ранее руководил более чем 3-мя ликвидированными компаниями | |
| РукЛиквКомпБезИНН | String | Да, если руководитель с данным ФИО без указанного ИНН ранее руководил более чем 3-мя ликвидированными компаниями | |
| НедостоверРук | String | Да, если руководитель признан ФНС недостоверным (на основании его заявления, по результатам проверки или на основании решения суда) | |
| РеестрМассУчр | String | Да, если учредитель (учредители) организации находится в реестре массовых учредителей | |
| РеестрМассРукУчр | String | Да, если учредитель (учредители) организации находится в реестре массовых руководителей | |
| ДисквУчрДр | String | Да, если учредитель дисквалифицирован как руководитель в других организациях | |
| ДисквУчрДрБезИНН | String | Да, если учредитель с данным ФИО без указанного ИНН дисквалифицирован как руководитель в других организациях | |
| УчрЛиквКомп | String | Да, если учредитель ранее участвовал более чем в 3-х ликвидированных компаниях | |
| УчрЛиквКомпБезИНН | String | Да, если учредитель с данным ФИО без указанного ИНН ранее участвовал более чем в 3-х ликвидированных компаниях | |
| ОдноврСменаРукУчр | String | Да, если в организации одновременная смена руководителя и учредителя в течение года | |
| СменаРукГод | String | Да, если в организации произошла смена руководителя более 2-х раз за год | |
| РукУчр1Комп | String | Да, если руководитель компании является единственным учредителем исключительно только в этой компании | |
| НедостоверУчр | String | Да, если один из учредителей признан ФНС недостоверным (на основании его заявления, по результатам проверки или на основании решения суда) | |
| Обременения | String | Да, если имеются обременения доли любого действующего учредителя в УК | |
| НеПредостОтч | String | Да, если организация не представляет налоговую отчетность более года | |
| ЗадолжНалог | String | Да, если организация имеет задолженность по уплате налогов более 1000 руб./ | |
| РешУмКап | String | Да, если организация приняла решение об уменьшении уставного капитала | |
| КолРаб | String | Выводится количество, если среднесписочное количество сотрудников 0 или 1 (т.е. штатные сотрудники отсутствуют или он всего один) | |
| БлокСчета | String | Да, если в отношении компании есть решение налоговой о приостановлении по счетам налогоплательщика (блокировки счетов с указанием банка и даты последней блокировки в этом банке). Внимание! Предоставляется только в платном аккаунте. |
|
| Банкрот | String | Да, при наличии процедуры банкротства в отношении контрагента в картотеке арбитражных дел. Внимание! Предоставляется только в платном аккаунте. |
|
| БанкротНамерение | String | Да, при наличии сообщений о намерении кредитора обратиться в суд с заявлением о банкротстве . Внимание! Предоставляется только в платном аккаунте. |
|
| РискНалогПроверки | String | Да, в следующих случаях:
|
|
| НедоимкаНалог | String | Да, если общая сумма недоимки по налогу, пени и штрафу более 1 тыс.руб. (в скобках указывается сумма недоимки и дата состояния) | |
| Текст | String | Сводная текстовая информация о всех найденных негативных факторах риска, разделенных точкой с запятой |
Примеры запросов.
https://api-fns.ru/api/check?req=1027739471517&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ОГРН": "1027739471517",
"ИНН": "7719190113",
"Позитив": {},
"Негатив": {
"Статус": "Принято решение о предстоящем исключении недействующего юридического лица из ЕГРЮЛ",
"ДисквРук": "Да (до 2019-04-28)",
"РеестрМассАдрес": "Да (16 организаций)",
"МассАдрес": "Да (77 юрлиц)",
"НедостоверАдрес": "Да",
"РеестрМассРук": "Да (от 2018-03-24, 99 юрлиц)",
"РукЛиквКомп": "Да (552 юрлиц)",
"НедостоверРук": "Да",
"УчрЛиквКомп": "Да (Тургаев Сергей Арнольдович - 7 юрлиц) ",
"НеПредостОтч": "Да (от 2018-03-01)",
"Текст": "Принято решение о предстоящем исключении недействующего юридического лица из ЕГРЮЛ; Дисквалификация руководителя (до 2019-04-28); В реестре массовых адресов (16 юрлиц, в БД найдено - 77 юрлиц); Недостоверный адрес; Массовый руководитель (от 2018-03-24, 99 юрлиц); Руководитель в ликвидированных компаниях (552 юрлиц); Недостоверный руководитель; Участие учредителя в ликвидированных компаниях (Тургаев Сергей Арнольдович - 7 юрлиц); Не представляет налоговую отчетность более года (от 2018-03-01)"
}
}
}
]
}
https://api-fns.ru/api/check?req=7706148097&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"items": [
{
"ЮЛ": {
"ОГРН": "1037739326789",
"ИНН": "7706148097",
"Позитив": {
"Лицензии": "Есть",
"КапБолее50тыс": "Да",
"Текст": "Есть лицензии (2 шт.); Уставный капитал 6503 тыс. руб."
},
"Негатив": {
"МассРук": "Да (8 юрлиц)",
"РукЛиквКомп": "Да (8 юрлиц)",
"НедоимкаНалог": "Да (92479217.2 от 01.01.2018)",
"РискНалогПроверки": "Да (расходы больше доходов)",
"БлокСчета": "Да (от 23.11.2017, ООО "АТБ" БАНК); Да (от 23.11.2017, КБ "ЛОКО-БАНК" (АО)); Да (от 23.11.2017, ПАО СБЕРБАНК); Да (от 23.11.2017, ФИЛИАЛ ЦЕНТРАЛЬНЫЙ ПАО БАНКА "ФК ОТКРЫТИЕ"); Да (от 23.11.2017, АО "ОТП БАНК"); Да (от 23.11.2017, АО ЮНИКРЕДИТ БАНК); Да (от 23.11.2017, ПАО "ПРОМСВЯЗЬБАНК"); Да (от 23.11.2017, АО "АЛЬФА-БАНК"); Да (от 23.11.2017, ПАО "МОСКОВСКИЙ КРЕДИТНЫЙ БАНК"); Да (от 23.11.2017, АО "КРЕДИТ ЕВРОПА БАНК"); Да (от 19.12.2016, "СЕТЕЛЕМ БАНК" ООО); Да (от 24.07.2018, АКБ "АБСОЛЮТ БАНК" (ПАО)); Да (от 29.09.2016, ПАО "ХАНТЫ-МАНСИЙСКИЙ БАНК ОТКРЫТИЕ"); Да (от 29.09.2016, ФАКБ "АБСОЛЮТ БАНК" (ПАО) В Г.ЕКАТЕРИНБУРГЕ); ",
"Банкрот": "Да",
"Текст": "Массовый руководитель (8 действ. юрлиц); Руководитель в ликвидированных компаниях (8 юрлиц); Общая сумма недоимки по налогу, пени и штрафу более 1 тыс.руб. (92479217.2 от 01.01.2018); Риск налоговой проверки (расходы больше доходов); Блокировка счета (от 23.11.2017, ООО "АТБ" БАНК); Блокировка счета (от 23.11.2017, КБ "ЛОКО-БАНК" (АО)); Блокировка счета (от 23.11.2017, ПАО СБЕРБАНК); Блокировка счета (от 23.11.2017, ФИЛИАЛ ЦЕНТРАЛЬНЫЙ ПАО БАНКА "ФК ОТКРЫТИЕ"); Блокировка счета (от 23.11.2017, АО "ОТП БАНК"); Блокировка счета (от 23.11.2017, АО ЮНИКРЕДИТ БАНК); Блокировка счета (от 23.11.2017, ПАО "ПРОМСВЯЗЬБАНК"); Блокировка счета (от 23.11.2017, АО "АЛЬФА-БАНК"); Блокировка счета (от 23.11.2017, ПАО "МОСКОВСКИЙ КРЕДИТНЫЙ БАНК"); Блокировка счета (от 23.11.2017, АО "КРЕДИТ ЕВРОПА БАНК"); Блокировка счета (от 19.12.2016, "СЕТЕЛЕМ БАНК" ООО); Блокировка счета (от 24.07.2018, АКБ "АБСОЛЮТ БАНК" (ПАО)); Блокировка счета (от 29.09.2016, ПАО "ХАНТЫ-МАНСИЙСКИЙ БАНК ОТКРЫТИЕ"); Блокировка счета (от 29.09.2016, ФАКБ "АБСОЛЮТ БАНК" (ПАО) В Г.ЕКАТЕРИНБУРГЕ); Процедура банкротства"
}
}
}
]
}
Проверка блокировок счета
Позволяет получить более подробную информацию по блокировкам счетов (запрос о действующих решениях ФНС о приостановлении операций по счетам).
На входе подается ИНН компании, на выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/nalogbi
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| inn | string inn=7706148097 |
ИНН искомой компании (юридического лица или ИП) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий аналитическую информацию по искомой компании.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска |
| ЮЛ или ИП | object | Тип искомой компании (юридическое лицо или индивидуальные предприниматель) |
| Поля для ИП: | (любое из полей может отсутствовать) | |
| ИННФЛ | String | ИНН физического лица |
| Негатив | object | Негативная информация о ИП (факторы риска) |
| БлокСчета | String | Да, если в отношении ИП есть решение налоговой о приостановлении по счетам налогоплательщика (блокировки счетов с указанием банка и даты последней блокировки в этом банке). Внимание! Предоставляется только в платном аккаунте. |
| БлокСчетаИнфо | Array | Массив информации о блокировках счетов Внимание! Предоставляется только в платном аккаунте. |
| БИК | String | БИК банка, в который направлено решение |
| Банк | String | Название банка, в который направлено решение |
| НомерРеш | String | Номер решения о приостановлении |
| ДатаРеш | String | Дата решения о приостановлении |
| КодНО | String | Код налогового органа |
| ВремяИнф | String | Дата и время размещения информации в сервисе |
| КодОснов | String | Код основания для вынесения решения о приостановлении операций и переводов |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| Негатив | object | Негативная информация о ЮЛ (факторы риска) |
| БлокСчета | String | Да, если в отношении компании есть решение налоговой о приостановлении по счетам налогоплательщика (блокировки счетов с указанием банка и даты последней блокировки в этом банке). Внимание! Предоставляется только в платном аккаунте. |
| БлокСчетаИнфо | Array | Массив информации о блокировках счетов Внимание! Предоставляется только в платном аккаунте. |
| БИК | String | БИК банка, в который направлено решение |
| Банк | String | Название банка, в который направлено решение |
| НомерРеш | String | Номер решения о приостановлении |
| ДатаРеш | String | Дата решения о приостановлении |
| КодНО | String | Код налогового органа |
| ВремяИнф | String | Дата и время размещения информации в сервисе |
| КодОснов | String | Код основания для вынесения решения о приостановлении операций и переводов |
Вывод проверки блокировок счета в виде файла
Позволяет получить полную информацию о действующих решениях ФНС о приостановлении операций по счетам в виде файла zip с подписью ФНС (запрос о действующих решениях ФНС о приостановлении операций по счетам).
На входе подается ИНН компании, на выходе — файл ZIP.
Адрес сервиса: https://api-fns.ru/api/nalogbi_file
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| inn | string inn=7706148097 |
ИНН искомой компании (юридического лица или ИП) |
| bik | string bik=044525225 |
БИК банка, выполняющего запрос
Необязательное поле |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой файл ZIP, содержащий файл Сведений о наличии решений о приостановлении операций по счетам налогоплательщика в формате PDF и файл подписи SIG.
Отслеживание изменений
Позволяет получить изменения данных о компании в ЕГРЮЛ или ЕГРИП, а также сведения о поданном заявлении в орган ФНС для изменения сведений об организации (представлены документы для государственной регистрации).
На входе подается ОГРН или ИНН компании, на выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/changes
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1026605606620 |
ОГРН или ИНН искомой компании (юридического лица или ИП) |
| dat | string dat=2017-03-25 |
Дата в формате YYYY-MM-DD, начиная с которой вывести изменения о компании (при отсутствии параметра – выводятся все изменения) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о хронологии изменения параметров организации в ЕГРЮЛ (ЕГРИП), либо поданных заявлений об изменениях.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска |
| ЮЛ или ИП | object | Тип искомой компании (юридическое лицо или индивидуальные предприниматель) |
| Поля для ИП: | (любое из полей может отсутствовать) | |
| ИННФЛ | String | ИНН физического лица |
| ОГРНИП | String | ОГРН ИП |
| Изменения | array | Хронология изменений данных об ИП |
| <Дата> | object | Дата изменения параметров ИП в формате YYYY-MM-DD |
| Статус | String | Статус ИП с <Даты> |
| НО | object | Информация о налоговых органах |
| Рег | String | Код и наименование регистрирующего (налогового) органа с <Даты> |
| Учет | String | Код и наименование налогового органа, куда ИП встал на учет с <Даты> |
| ФСС | object | Информация о ФСС |
| РегНомФСС | String | Регистрационный номер в ФСС с <Даты> |
| ПФ | object | Информация о Пенсионном Фонде |
| РегНомПФ | String | Регистрационный номер в ПФ с <Даты> |
| Адрес | object | Информация об адресе ИП |
| АдресПолн | String | Адрес регистрации с <Даты> |
| СПВЗ | String | Сведения о причинах внесения записей в реестр на <Дату> |
| Заявление | object | Сведения о поданном заявлении в орган ФНС об изменении сведений об ИП (представлены документы для государственной регистрации) Внимание! Предоставляется только в платном аккаунте. |
| Форма | String | Форма заявления (например, Р21001, Р21002, Р24001, Р26001 или др.) |
| Способ | String | Способ представления (например, «Лично», «Почтовым отправлением», «В электронном виде» или др.) |
| ОтветФНС | String | Вид решения налогового органа (например, «Решение о государственной регистрации», «Решение об отказе в государственной регистрации») (пусто, если сведения еще не внесены в реестр-базу ЕГРИП) |
| ДатаРег | String | Дата внесения сведений в реестр (пусто, если сведения еще не внесены в реестр-базу ЕГРИП) |
| ДатаГотовности | String | Дата готовности документов (планируемая) |
| НО | String | Наименование налогового органа, куда подано заявление |
| Поля для ЮЛ: | (любое из полей может отсутствовать) | |
| ИНН | String | ИНН искомой компании |
| ОГРН | String | ОГРН искомой компании |
| Изменения | array | Хронология изменений данных о ЮЛ |
| <Дата> | object | Дата изменения параметров ЮЛ в формате YYYY-MM-DD |
| Статус | String | Статус ЮЛ с <Даты> |
| НО | object | Информация о налоговых органах |
| Рег | String | Код и наименование регистрирующего (налогового) органа с <Даты> |
| Учет | String | Код и наименование налогового органа, куда ЮЛ встало на учет с <Даты> |
| ФСС | object | Информация о ФСС |
| РегНомФСС | String | Регистрационный номер в ФСС с <Даты> |
| ПФ | object | Информация о Пенсионном Фонде |
| РегНомПФ | String | Регистрационный номер в ПФ с <Даты> |
| Адрес | object | Информация об адресе компании |
| АдресПолн | String | Адрес регистрации с <Даты> |
| Руководитель | object | Информация о руководителе компании |
| ФИОПолн | String | ФИО руководителя с <Даты> |
| ИННФЛ | String | ИНН руководителя с <Даты> |
| Учредители | String | Учредитель с с <Даты> |
| УчрИН | object | Сведения об учредителе (участнике) — иностранном юридическом лице |
| НаимПолнЮЛ | String | Наименование организации |
| ОКСМ | String | Код в соответствии с Общероссийским классификатором стран мира и наименование страны |
| РегНомер | String | Регистрационный номер |
| ДатаРег | String | Дата регистрации |
| АдресПолн | String | Адрес (место нахождения) в стране происхождения |
| УчрФЛ | object | Сведения об учредителе (участнике) — физическом лице |
| ФИОПолн | String | Фамилия Имя Отчество учредителя |
| ИННФЛ | String | ИНН учредителя |
| УчрРФСубМО | String | Сведения об учредителе (участнике) — Российской Федерации, субъекте Российской Федерации, муниципальном образовании |
| СвОргОсущПр | object | Сведения об органе государственной власти, органе местного самоуправления или о юридическом лице, осуществляющем права учредителя (участника) |
| УчрЮЛ | object | Сведения о юридическом лице, осуществляющем права учредителя (участника) |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| УчрПИФ | object | Сведения о паевом инвестиционном фонде, в состав имущества которого включена доля в уставном капитале |
| ОГРН | String | ОГРН ЮЛ |
| ИНН | String | ИНН ЮЛ |
| НаимСокрЮЛ | String | Наименование ЮЛ сокращенное (только для ЮЛ) |
| Статус | String | Статус ЮЛ |
| СуммаУК | String | Номинальная стоимость доли в рублях |
| Процент | String | Размер доли (в процентах) |
| СПВЗ | String | Сведения о причинах внесения записей в реестр на <Дату> |
| Заявление | object | Сведения о поданном заявлении в орган ФНС об изменении сведений об ЮЛ (представлены документы для государственной регистрации) Внимание! Предоставляется только в платном аккаунте. |
| Форма | String | Форма заявления (например, Р21001, Р21002, Р24001, Р26001 или др.) |
| Вид | String | Вид изменений (подробности об необходимых изменениях) (например, «Вносимые в учредительные документы (форма № Р13001), в том числе в части: уставного капитала (складочного капитала, уставного фонда, паевого фонда) участников юридического лица – физических лиц») |
| Способ | String | Способ представления (например, «Лично», «Почтовым отправлением», «В электронном виде» или др.) |
| ОтветФНС | String | Вид решения налогового органа (например, «Решение о государственной регистрации», «Решение об отказе в государственной регистрации») (пусто, если сведения еще не внесены в реестр-базу ЕГРИП) |
| ДатаРег | String | Дата внесения сведений в реестр (пусто, если сведения еще не внесены в реестр-базу ЕГРИП) |
| ДатаГотовности | String | Дата готовности документов (планируемая) |
| НО | String | Наименование налогового органа, куда подано заявление |
Примеры запросов.
https://api-fns.ru/api/changes?req=1076671015431&dat=2018-01-25&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ЮЛ": {
"ОГРН": "1076671015431",
"ИНН": "6671220492",
"Изменения": {
"2018-02-28": {
"Руководитель": {
"ФИОПолн": "Саргин Антон Евгеньевич"
},
"СПВЗ": "Изменение сведений о юридическом лице, содержащихся в Едином государственном реестре юридических лиц"
},
"2018-02-20": {
"Заявление": {
"Форма": "Р14001",
"Вид": "Вносимые в сведения реестра (форма № Р14001), в том числе в части: лица, имеющего право без доверенности действовать от имени юридического лица",
"ОтветФНС": "Решение о государственной регистрации. ГРН внесенной записи 2186658332342",
"ДатаРег": "2018-02-28",
"ДатаГотовности": "2018-03-01",
"НО": "ИФНС России по Верх-Исетскому району г.Екатеринбурга"
}
},
"2018-02-05": {
"Учредители": {
"УчрЮЛ": {
"ОГРН": "1069671055123",
"ИНН": "6671199917",
"НаимСокрЮЛ": "АО "КОРПОРАЦИЯ РАЗВИТИЯ"",
"Статус": "Действующее"
},
"СуммаУК": "12131971454.64",
"Процент": "100"
},
"Капитал": {
"СумКап": "12131971454.64"
},
"СПВЗ": "Государственная регистрация изменений, внесенных в учредительные документы юридического лица, связанных с внесением изменений в сведения о юридическом лице, содержащиеся в Едином государственном реестре юридических лиц, на основании заявления"
},
"2018-01-29": {
"Заявление": {
"Форма": "Р13001",
"Вид": "Вносимые в учредительные документы (форма № Р13001), в том числе в части: уставного капитала (складочного капитала, уставного фонда, паевого фонда) участников юридического лица - юридических лиц",
"ОтветФНС": "Решение о государственной регистрации. ГРН внесенной записи 2186658188638",
"ДатаРег": "2018-02-05",
"ДатаГотовности": "2018-02-06",
"НО": "ИФНС России по Верх-Исетскому району г.Екатеринбурга"
}
},
"2018-01-25": {
"Капитал": {
"СумКап": "12118263393.4"
},
"Учредители": {
"УчрЮЛ": {
"ОГРН": "1069671055123",
"ИНН": "6671199917",
"НаимСокрЮЛ": "АО "КОРПОРАЦИЯ РАЗВИТИЯ"",
"Статус": "Действующее"
},
"СуммаУК": "12118263393.4",
"Процент": "100"
},
"СПВЗ": "Государственная регистрация изменений, внесенных в учредительные документы юридического лица, связанных с внесением изменений в сведения о юридическом лице, содержащиеся в Едином государственном реестре юридических лиц, на основании заявления"
}
}
}
}
]
}
https://api-fns.ru/api/changes?req=318631300045956&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ИП": {
"ОГРНИП": "318631300045956",
"ИННФЛ": "632141401501",
"Изменения": {
"2018-04-09": {
"СПВЗ": "Изменение сведений об индивидуальном предпринимателе, содержащихся в Едином государственном реестре индивидуальных предпринимателей"
},
"2018-04-02": {
"Заявление": {
"Форма": "Р24001",
"Способ": "Лично",
"ОтветФНС": "Решение о государственной регистрации. ГРНИП внесенной записи 418631300332669",
"ДатаРег": "2018-04-09",
"ДатаГотовности": "2018-04-10",
"НО": "ИФНС России по Красноглинскому району г. Самары"
}
},
"2018-03-30": {
"СПВЗ": "Представление сведений о регистрации в качестве страхователя в территориальном органе Пенсионного фонда Российской Федерации"
},
"2018-03-29": {
"ПФ": {
"РегНомПФ": "077011150027"
}
},
"2018-03-28": {
"НО": {
"Учет": "6320 (Межрайонная инспекция Федеральной налоговой службы № 2 по Самарской области)"
},
"СПВЗ": "Представление сведений об учете в налоговом органе"
},
"2018-03-27": {
"НО": {
"Рег": "6313 (Инспекция Федеральной налоговой службы по Красноглинскому району г. Самары)"
},
"Адрес": {
"АдресПолн": "обл. Самарская, г. Тольятти"
},
"Статус": "Действующее",
"СПВЗ": "Государственная регистрация физического лица в качестве индивидуального предпринимателя"
},
"2018-03-22": {
"Заявление": {
"Форма": "Р21001",
"Способ": "Лично",
"ОтветФНС": "Решение о государственной регистрации. ГРНИП внесенной записи 318631300045956",
"ДатаРег": "2018-03-27",
"ДатаГотовности": "2018-03-28",
"НО": "ИФНС России по Красноглинскому району г. Самары"
}
}
}
}
}
]
}
Мониторинг изменений по списку организаций
Позволяет вести список организаций для мониторинга и отслеживать изменения в ЕГРЮЛ и ЕГРИП по этому списку. Мониторинг начинает действовать с момента внесения организации в список мониторинга.
На входе подается команда, на выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/mon
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| cmd | string cmd=list cmd=add&req=1076671015431 cmd=del&req=1076671015431 cmd=chd&dat=21.03.2020 |
Команда для управления списком или отображения результатов мониторинга:
|
| key | string | Ваш ключ доступа к API |
| cmd=list — дополнительных параметров нет | ||
| cmd=add или cmd=del | ||
| req | string req=1026605606620,1197746191147 |
ОГРН или ИНН организаций, разделенных запятыми |
| cmd=chd | ||
| dat | string dat=2020-03-25 |
Дата в формате DD.MM.YYYY или YYYY-MM-DD, на которую необходимо вывести изменения организаций из списка |
| type | string type=СвСтатус,СвНаимЮЛ |
Фильтр по типу изменений. Возможные значения: Заявление,СвНаимЮЛ,СвАдресЮЛ,СвРегОрг,СвУчетНО,СвРегПФ, СвРегФСС,СвУстКап,СведДолжнФЛ,СвНедДанДолжнФЛ,СвУчредит, СвНедДанУчр,СвОКВЭДОсн,СвОКВЭДДоп,СвЗапЕГРЮЛ,СвЛицензия, СвФЛ,СвАдрМЖ,СвРегПФ,СвЗапЕГРИП,СвСтатус |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о хронологии изменения параметров организации в ЕГРЮЛ (ЕГРИП), либо поданных заявлений об изменениях.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов операции |
| cmd=list | ||
| ОГРН или ОГРНИП | string | ОГРН организации в списке |
| ИНН или ИННФЛ | string | ИНН организации в списке |
| cmd=add | ||
| ОГРН или ОГРНИП | string | ОГРН добавляемой организации |
| ИНН или ИННФЛ | string | ИНН добавляемой организации |
| Результат | string | Результат: «Добавлено или «Уже в списке» |
| cmd=del | ||
| ОГРН или ОГРНИП | string | ОГРН удаленной организации |
| ИНН или ИННФЛ | string | ИНН удаленной организации |
| Результат | string | Результат: «Удалено» или «Нет в списке» |
| cmd=chbo | ||
| ОГРН или ОГРНИП | string | ОГРН организации, у которой произошли изменения на дату, заданной параметром dat |
| ИНН или ИННФЛ | string | ИНН организации, у которой произошли изменения на дату, заданной параметром dat |
| АктДатаБО | string | Дата актуализации бухгалтерской отчетности |
| cmd=chd | ||
| ОГРН или ОГРНИП | string | ОГРН организации, у которой произошли изменения на дату, заданной параметром dat |
| ИНН или ИННФЛ | string | ИНН организации, у которой произошли изменения на дату, заданной параметром dat |
| Тип | string | Тип изменения у организации — соответствует полю в методе egr: Заявление,СвНаимЮЛ,СвАдресЮЛ,СвРегОрг,СвУчетНО,СвРегПФ, СвРегФСС,СвУстКап,СведДолжнФЛ,СвНедДанДолжнФЛ,СвУчредит, СвНедДанУчр,СвОКВЭДОсн,СвОКВЭДДоп,СвЗапЕГРЮЛ,СвЛицензия, СвФЛ,СвАдрМЖ,СвРегПФ,СвЗапЕГРИП,СвСтатус |
| Текст | string | Текст изменения у организации — то, что стало |
Примеры запросов.
https://api-fns.ru/api/mon?cmd=add&req=1076671015431,410119683055,1060262018805&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ОГРНИП": "320527500036294",
"ИННФЛ": "525863911314",
"Результат": "Добавлено"
},
{
"ОГРН": "1180571014029",
"ИНН": "0543018258",
"Результат": "Добавлено"
},
{
"ОГРН": "1182724010358",
"ИНН": "2721236711",
"Результат": "Уже в списке"
}
]
}
https://api-fns.ru/api/mon?cmd=chd&dat=2020-03-25&type=СвСтатус,СвНаимЮЛ,СведДолжнФЛ,СвНедДанУчр&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ОГРН": "1197746181005",
"ИНН": "9701128742",
"Тип": "СвСтатус",
"Текст": "Регистрирующим органом принято решение о предстоящем исключении юридического лица из ЕГРЮЛ (наличие в ЕГРЮЛ сведений о юридическом лице, в отношении которых внесена запись о недостоверности)"
},
{
"ОГРН": "1197746183194",
"ИНН": "7703472930",
"Тип": "СвНаимЮЛ",
"Текст": "ООО "МОЦ" (полное: ООО "МОЦ")"
},
{
"ОГРН": "1191690023381",
"ИНН": "1659197777",
"Тип": "СведДолжнФЛ",
"Текст": "ГЕНЕРАЛЬНЫЙ ДИРЕКТОР: Каплиева Татьяна Федоровна"
},
{
"ОГРН": "1197746182798",
"ИНН": "7720456248",
"Тип": "СвНедДанУчр",
"Текст": "Брачков Денис Олегович: сведения недостоверны (результаты проверки достоверности содержащихся в ЕГРЮЛ сведений о юридическом лице)"
}
]
}
Выписка
Позволяет получить официальную выписку ФНС из ЕГРЮЛ или ЕГРИП.
На входе подается ОГРН или ИНН компании, на выходе — документ PDF.
Адрес сервиса: https://api-fns.ru/api/vyp
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1026605606620 |
ОГРН или ИНН искомой компании (юридического лица или ИП) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой выписку в формате PDF.
Выписка МСП
Позволяет получить официальную выписку реестра МСП: «Сведения из Единого реестра субъектов малого и среднего предпринимательства»,
«Сведения из Единого реестра субъектов малого и среднего предпринимательства — получателей поддержки», а также сведения о периодах нахождения организации в реестре МСП.
На входе подается ОГРН или ИНН компании, на выходе — документ PDF.
Адрес сервиса: https://api-fns.ru/api/mspinfo_file
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=3827024814 |
ОГРН или ИНН искомой компании (юридического лица или ИП) |
| type | string type=report |
Тип запрашиваемой выписки: type=report обычная выписка, type=period периоды нахождения в реестре, type=pp-report выписка как получателя поддержки)
Необязательное поле (по умолчанию type=report) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой выписку в формате PDF.
Бухгалтерская отчетность
Бухгалтерская отчетность организации по данным ФНС (только юридические лица). Отчетность приведена начиная с 2019 года (в которой присутствует также отчетность за предыдущий год, а по форме 1 — за 2 года), более ранняя отчетность — в API-Росстат. Доступна отчетность по формам 1 (Бухгалтерский баланс), 2 (Отчёт о прибылях и убытках), 3 (Отчет об изменениях капитала), 4 (Отчет о движении денежных средств).
На входе подается ОГРН или ИНН компании, на выходе — строка JSON.
Адрес сервиса: https://api-fns.ru/api/bo
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1027600787994 |
ОГРН или ИНН искомой компании (юридического лица) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий данные бухгалтерской отчетности.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| ИНН или ОГРН | object | В качестве поля приводится указанный в запросе ИНН или ОГРН организации |
| Год | object | В качестве поля приводится год бухгалтерской отчетности (например, 2018, 2019 и т.д.) |
| Код строки | object | В качестве поля приводится код строки бухгалтерской отчетности (например, 1230, 1600, 2110, 3600 и т.д.), в качестве значения — сумма по данной строке в бухгалтерской отчетности (в тыс. руб.) |
Примеры запросов.
https://api-fns.ru/api/bo?req=7605016030&key=<Ваш ключ>
Пример ответа сервера…
{
"7605016030": {
"2017": {
"1100": "520235",
"1150": "446518",
"1190": "73717",
"1200": "936144",
"1210": "174541",
"1220": "5458",
"1230": "546830",
"1250": "209315",
"1300": "846735",
"1310": "644",
"1370": "846091",
"1400": "239226",
"1410": "234075",
"1420": "5151",
"1500": "370418",
"1520": "370418",
"1600": "1456379",
"1700": "1456379",
"3600": "846735"
},
"2018": {
"1100": "571450",
"1150": "412754",
"1190": "158696",
"1200": "950321",
"1210": "144823",
"1220": "8804",
"1230": "607859",
"1250": "188835",
"1300": "1044256",
"1310": "644",
"1370": "1043612",
"1400": "7864",
"1420": "7864",
"1500": "469651",
"1520": "467823",
"1550": "1828",
"1600": "1521771",
"1700": "1521771",
"2100": "898515",
"2110": "5127030",
"2120": "4228515",
"2200": "346192",
"2210": "105",
"2220": "552218",
"2300": "315337",
"2320": "16953",
"2330": "415",
"2340": "20798",
"2350": "68191",
"2400": "220177",
"2411": "87045",
"2421": "-8596",
"2430": "-2712",
"2460": "-5403",
"2500": "220177",
"3600": "1044256",
"4100": "207338",
"4110": "6844527",
"4111": "6415655",
"4119": "428872",
"4120": "6637189",
"4121": "1540762",
"4122": "3137415",
"4123": "6137",
"4124": "60736",
"4129": "1892139",
"4200": "27500",
"4210": "27500",
"4213": "27500",
"4300": "-255318",
"4310": "34000",
"4311": "34000",
"4320": "289318",
"4322": "20828",
"4323": "268490",
"4400": "-20480",
"4450": "209315",
"4500": "188835"
},
"2019": {
"1100": "640789",
"1150": "453041",
"1190": "187748",
"1200": "1233409",
"1210": "136790",
"1230": "643775",
"1250": "452731",
"1260": "113",
"1300": "1273097",
"1310": "644",
"1370": "1272453",
"1400": "6728",
"1420": "6728",
"1500": "594373",
"1520": "594373",
"1600": "1874198",
"1700": "1874198",
"2100": "824214",
"2110": "6271037",
"2120": "5446823",
"2200": "460927",
"2210": "127",
"2220": "363160",
"2300": "378911",
"2320": "20780",
"2340": "34397",
"2350": "137193",
"2400": "228841",
"2411": "93672",
"2421": "-16754",
"2430": "1136",
"2460": "-57534",
"2500": "228841",
"3600": "1273097",
"4100": "263896",
"4110": "8215433",
"4111": "7676862",
"4119": "538571",
"4120": "7951537",
"4121": "2319854",
"4122": "4128654",
"4124": "193936",
"4129": "1309093",
"4400": "263896",
"4450": "188835",
"4500": "452731"
}
}
}
Бухгалтерская отчетность в виде файла
Позволяет получить бухгалтерскую отчетность организации в виде файла, заверенного подписью ФНС (только юридические лица). Отчетность приведена начиная с 2019 года. Доступна отчетность по формам 1 (Бухгалтерский баланс), 2 (Отчёт о прибылях и убытках), 3 (Отчет об изменениях капитала), 4 (Отчет о движении денежных средств), Пояснения к бухгалтерскому балансу и отчету о финансовых результатах, Аудиторское заключение.
На входе подается ОГРН или ИНН компании, на выходе — файл pdf или zip.
Адрес сервиса: https://api-fns.ru/api/bo_file
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| req | string req=1027600787994 |
ОГРН или ИНН искомой компании (юридического лица) |
| year | integer year=2019 |
Год отчетности |
| xls | integer xls=1 |
Если параметр указан, то будет выведена отчетность организации в формате xls (архивированнный в zip). Если параметр не указан, то будет выведена отчетность в pdf, заверенная подписью ФНС |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой файл отчетности в формате PDF, либо файл ZIP, содержащий отчетность в формате XLS, а также Пояснения к бухгалтерскому балансу и отчету о финансовых результатах, Аудиторское заключение в формате PDF.
Примеры запросов.
https://api-fns.ru/api/bo_file?req=7605016030&year=2019&xls=1&key=<Ваш ключ>
https://api-fns.ru/api/bo_file?req=1183926004085&year=2019&key=<Ваш ключ>
Узнать ИНН физического лица
Возвращает ИНН физического лица на основании введенных паспортных данных.
Адрес сервиса: https://api-fns.ru/api/innfl
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| fam | string fam=Иванов |
Фамилия |
| nam | string nam=Степан |
Имя |
| otch | string otch=Петрович |
Отчество. Если отчество отсутствует — укажите otch=нет |
| bdate | string bdate=02.01.1935 |
Дата рождения в формате ДД.ММ.ГГГГ |
| doctype | string doctype=21 |
Вид документа, удостоверяющего личность:
Необязательное поле (по умолчанию — код 21). |
| docno | string docno=4611123456 |
Серия и номер документа (можно вводить как с пробелами, так и без пробелов между серией и номером) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о найденном ИНН.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска |
| ИНН | String | ИНН искомого физического лица |
| error | String | Сообщение об ошибке, если введены некорректные данные |
Примеры запросов.
https://api-fns.ru/api/innfl?fam=Иванов&nam=Степан&otch=Петрович&bdate=02.01.1935&doctype=21&docno=7500548998&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ИНН": "504603092301"
}
]
}
Проверка паспорта на недействительность
Проверяет серию и номер паспорта по списку недействительных российских паспортов.
Адрес сервиса: https://api-fns.ru/api/mvdpass
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| docno | string docno=4611123456 |
Серия и номер паспорта (можно вводить как с пробелами, так и без пробелов между серией и номером) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о недействительности паспорта.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| result | String | Результат: «Cреди недействительных не значится», либо «Не действительный», если обнаружен в списке недействительных российских паспортов |
Примеры запросов.
https://api-fns.ru/api/mvdpass?docno=7500548998&key=<Ваш ключ>
Пример ответа сервера…
{
"result": "Cреди недействительных не значится"
}
Информация о паспорте
Проверяет серию и номер паспорта по списку недействительных российских паспортов и возвращает причину недействительности.
Адрес сервиса: https://api-fns.ru/api/mvdinfo
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| docno | string docno=4611123456 |
Серия и номер паспорта (можно вводить как с пробелами, так и без пробелов между серией и номером) |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о недействительности паспорта.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| docno | String | Серия и номер проверяемого паспорта |
| result | String | Результат: «Cреди недействительных не значится», либо «Не действительный (ПРИЧИНА)», если обнаружен в списке недействительных российских паспортов. Где ПРИЧИНА, например, ВЫДАН С НАРУШЕНИЕМ, ЗАМЕНЕН НА НОВЫЙ, ИЗЬЯТ, УНИЧТОЖЕН, ТЕХНИЧЕСКИЙ БРАК, ЧИСЛИТСЯ В РОЗЫСКЕ, ИСТЕК СРОК ДЕЙСТВИЯ, В СВЯЗИ СО СМЕРТЬЮ ВЛАДЕЛЬЦА и т.п. |
Примеры запросов.
https://api-fns.ru/api/mvdinfo?docno=7513280230&key=<Ваш ключ>
Пример ответа сервера…
{
"docno": "7513 № 280230",
"result": "Не действителен (ЧИСЛИТСЯ В РОЗЫСКЕ)"
}
Проверка статусов физического лица
Проверяет статусы физического лица: статус самозанятого, является ли физическое лицо индивидуальным предпринимателем, банкротство физического лица, а также недействительность ИНН.
Адрес сервиса: https://api-fns.ru/api/fl_status
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| inn | string inn=380470176844 |
ИНН физического лица |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о статусах физического лица.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| Корректность | object | Проверка корректности запрошенного ИНН |
| 12знаков | String | false, если ИНН состоит не из 12 знаков, иначе поле не выводится |
| КонтрСумма | Boolean | true, если контрольная сумма ИНН корректна, false — ИНН некорректен |
| Недействительный | Boolean | true, если ИНН недействительный (при снятии с учета физического лица в налоговом органе в связи с его смертью, в случае обнаружения у физического лица более одного ИНН) |
| НедейстДата | String | Дата признания ИНН недействительным |
| Текст | String | Текст, если ИНН некорректен |
| Самозанятость | object | Проверка статуса самозанятого (плательщика налога на профессиональный доход) |
| Статус | Boolean | true — если физическое лицо является самозанятым, false — не является |
| Текст | String | Текст сообщения о самозанятости физического лица |
| ИП | object | Проверка что физ. лицо является индивидуальным предпринимателем |
| Статус | Boolean | true — если физическое лицо является ИП, false — не является |
| Текст | String | Текст сообщения о ИП |
| Ссылка | String | Ссылка на описание найденного ИП |
| ДисквЛицо | object | Проверка по реестру дисквалифицированных лиц (руководители юридических лиц, подлежащих дисквалификации) |
| Статус | Boolean | true — если физическое лицо является дисквалифицированным лицом |
| Текст | String | Список ОГРН, гда физ лицо дисквалифицировано и дат окончания дисквалификации |
| Банкрот | object | Проверка наличия процедуры банкротства в отношении физического лица. Внимание! Предоставляется только в платном аккаунте. |
| Статус | Boolean | true — если физическое лицо является банкротом, false — не является |
| Текст | String | Текст сообщения о банкротстве |
| Ссылка | String | Ссылка на карточку банкрота-физического лица в едином федеральном реестре сведений о банкротстве |
| ПоддержкаМСП | array | Сведения суммарные о поддержке физического лица, являющихся индивидуальными предпринимателями или применяющих специальный налоговый режим «Налог на профессиональный доход», которым оказана поддержка органами исполнительной власти, органами местного самоуправления, организациями, образующими инфраструктуру поддержки субъектов малого и среднего предпринимательства. |
| ФормПод | String | Форма предоставленной поддержки |
| ВидПод | String | Вид предоставленной поддержки, в скобках указывается количество случаев поддержки |
| РазмПодСум | String | Размер предоставленной поддержки суммарно за все время с указанием единицы поддержки (руб., кв.м., ч.) |
| РазмПодСр | String | Размер предоставленной поддержки средний за все время с указанием единицы поддержки (%) |
| СрокПодМакс | String | Срок оказания поддержки максимальный по всем случаям поддержки |
| НарушПоддержкаМСП | String | Да, если имеется информация о наличии нарушения порядка и условий предоставления поддержки, в том числе о нецелевом использовании средств поддержки |
| ФИО | String | ФИО физического лица, полученное из открытых источников (если доступно). Внимание! Предоставляется только в платном аккаунте. |
Примеры запросов.
https://api-fns.ru/api/fl_status?inn=773208978609&key=<Ваш ключ>
Пример ответа сервера…
{
"Корректность": {
"КонтрСумма": true
"Недействительный": false
},
"Самозанятость": {
"Статус": true,
"Текст": "773208978609 является плательщиком налога на профессиональный доход"
},
"ИП": {
"Статус": false,
"Текст": "773208978609 не индивидуальный предприниматель"
},
"Банкрот": {
"Статус": true,
"Текст": "773208978609 является банкротом",
"Ссылка": "http://bankrot.fedresurs.ru/PrivatePersonCard.aspx?ID=EF3D8D32B48132693AC4C28F03C4ED2D"
}
}
Лицензии Федеральной службы по регулированию алкогольного рынка (ФСРАР)
Метод подключаем бесплатно по запросу к действующим тарифам API-Минимум, Оптимум, Профи, либо по индивидуальному тарифу.
Позволяет получить список лицензий, выданных на производство, оборот этилового спирта, алкогольной и спиртосодержащей продукции (в т.ч. розничную продажу, общепит). Информация из реестра актуальна по состоянию на 0:00 МСК текущей даты.
Адрес сервиса: https://api-fns.ru/api/fsrar
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| inn | string inn=2116493687 |
ИНН искомой компании |
| status | string nam=Степан |
Статус: одно из значений: действующая, аннулирована, срок действия истек, прекращена, переоформлена, приостановлена, истекла
Необязательное поле. При отсутствии выводятся все лицензии |
| kpp | string kpp=211645001 |
КПП искомой компании
Необязательное поле |
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о найденном ИНН.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| items | Array | Массив результатов поиска |
| ИНН | string | ИНН организации |
| КПП подразделения | string | КПП подразделения, имеющей лицензию ФСРАР |
| Адрес подразделения | string | Адрес подразделения, имеющей лицензию ФСРАР |
| Номер лицензии | string | Номер лицензии по данным ФСРАР |
| Вид лицензии | string | Вид лицензии (например: Розничная продажа, общепит; Розничная продажа алкоголя; закупка, хранение и поставки алкогольной продукции; производство, хранение и поставки произведенных вин (виноградных, плодовых) и т.п.) |
| Дата выдачи | string | Дата выдачи лицензии |
| Дата окончания | string | Дата окончания лицензии |
| Статус лицензии | string | Статус лицензии |
| Дата изменения | string | Дата последнего изменения |
| Основание изменения | string | Основание изменения (например: решение о выдаче лицензии; решение суда; Взамен выписана новая; решение о переоформлении лицензии и т.п.) |
| Орган выдавший лицензию | string | Орган, выдавший лицензию |
| История изменений сведений о действии лицензии | string | Орган, выдавший лицензию |
| string | e-mail организации для контактов |
Примеры запросов.
https://api-fns.ru/api/fsrar?inn=2116493687&status=действующая&key=<Ваш ключ>
Пример ответа сервера…
{
"items": [
{
"ИНН": "2116493687",
"КПП подразделения": "211601001",
"Адрес подразделения": "Россия,,Чувашская Республика - Чувашия,Чебоксарский Район,,Сюктерка Поселок,Солнечный берег Улица,1,,,",
"Номер лицензии": "21РПО0000339",
"Вид лицензии": "Розничная продажа, общепит",
"Дата выдачи": "2019-08-08",
"Дата окончания": "2021-10-06",
"Статус лицензии": "действующая",
"Дата изменения": "2019-10-07",
"Основание изменения": "решение о выдаче лицензии",
"e-mail": "solber@inbox.ru"
}
]
}
Статистика запросов (использования ключа)
Позволяет получить информацию о статистике использования ключа.
Адрес сервиса: https://api-fns.ru/api/stat
Используется запрос GET или POST.
Параметры запроса:
| Параметр | Тип данных и пример | Описание |
|---|---|---|
| key | string | Ваш ключ доступа к API |
Возвращаемый документ (HTTP response) представляет собой структурированный документ JSON, содержащий информацию о ключе и количестве доступных и истраченных запросов.
Поля возвращаемого документа:
| Имя | Тип | Описание |
|---|---|---|
| ДатаНач | string | Начальная дата использования API по заданному ключу |
| ДатаОконч | string | Конечная дата использования API |
| Статус | string | Ваш статус (FREE – бесплатное использование, VIP — платное) |
| Методы | array | Статистика использования методов API |
| search, egr, check, changes и др. | array | Метод (выводится информация по каждому из доступных методов) |
| Лимит | String | Ваш лимит запросов по этому методу |
| Истрачено | String | Количество истраченных запросов |
Примеры запросов.
https://api-fns.ru/api/stat?key=<Ваш ключ>
Пример ответа сервера…
{
"ДатаНач": "2018-02-28 11:36:02",
"ДатаОконч": "2019-02-28 11:36:02",
"Статус": "VIP",
"Методы": {
"search": {
"Лимит": "10000",
"Истрачено": "128"
},
"egr": {
"Лимит": "10000",
"Истрачено": "331"
},
"check": {
"Лимит": "10000",
"Истрачено": "143"
},
"changes": {
"Лимит": "10000",
"Истрачено": "31"
}
}
}
Веб-сервис для получения юридической информации об организации по ИНН
Данные о компании по ИНН
Автоматизированное формирование учетных документов
https://github.com/guleroman/innApi
Сервис по формированию данных компании и документов по API. Никакого UI.
- Получение по API ИНН
- Формирование данных компании по ИНН
- Отдача данных компании
- Формирование Документов
- Отдача ссылок на документы
Deployment with Dockerfile:
1.1 Download the full repository located on this page
D:> git clone https://github.com/guleroman/innApi.git
1.2 Build..
D:> cd innApi
D:innApi> docker build -t innapi .
D:innApi> docker build -t innapi_2 ./responser
1.3 ..then Run
D:innApi> docker run --name innapi_2 -p 8888:5000 -d innapi_2
D:innApi> docker run --name innapi -p 6060:6060 -d innapi
День добрый.
Существует множество сервисов (1С, контур и т.д.) предоставляющих поиск информации о контрагенте по ИНН.
Искал на сайте nalog.ru api, но не нашел. Есть ли API налоговой? Откуда можно взять самую актуальную информацию?
-
Вопрос заданболее трёх лет назад
-
67593 просмотра
↑ Все API
Ищет компании и индивидуальных предпринимателей:
- по ИНН, ОГРН и КПП;
- названию (полному и краткому);
- ФИО (для индивидуальных предпринимателей);
- ФИО руководителя компании;
- адресу до улицы.
Что умеет
✔️ Ищет по комбинации ИНН, названия и адреса в одном запросе («7736050003 Газ» → «ПАО Газпром», «вавилова сбер» → «ПАО Сбербанк»).
✔️ Находит конкретный филиал, если указать в запросе КПП («сбербанк 540602001» → «Сибирский банк ПАО Сбербанк»).
✔️ Понимает слитное и раздельное написание («альфабанк» = «Альфа-Банк»).
✔️ Ищет по частичному совпадению в ИНН / ОГРН («77094209» → «ООО Акварель») и названиях («росне» → «ПАО «НК «Роснефть»).
✔️ Подсказывает только организации или только ИП, или и тех и других. Умеет искать только в действующих или ликвидированных компаниях. Может ограничить подсказки кодом ОКВЭД или конкретным регионом России.
✔️ Учитывает, где вы находитесь (в связке с методом город по IP-адресу).
✔️ Возвращает основные реквизиты компании из ЕГРЮЛ: краткое и полное название, ОПФ, адрес, ОГРН, ИНН, КПП, ОКВЭД, статус организации, ФИО и должность руководителя.
✔️ В связке с методом организация по ИНН возвращает вагон дополнительной информации: количество сотрудников, все коды ОКВЭД, сведения о налоговой, ПФР и ФСС, документы и лицензии, учредители и руководители, финансовые показатели, реестр малого и среднего бизнеса.
❌ Для 25% компаний налоговая служба пока не сообщает КПП филиалов. Такие филиалы можно найти по ИНН, городу и улице филиала. Например, «7724261610 москва мясницкая» → «Филиал ФГУП «Почта России» (г Москва)».
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Пример запроса:
Песочница
{ «query»: «сбербанк» }
cURL
curl -X POST
-H "Content-Type: application/json"
-H "Accept: application/json"
-H "Authorization: Token ${API_KEY}"
-d '{ "query": "сбербанк" }'
https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party
.NET
// https://github.com/hflabs/dadata-csharp
var token = "${API_KEY}";
var api = new SuggestClientAsync(token);
var result = await api.SuggestParty("сбербанк");
Go
// https://github.com/ekomobile/dadata
// Использует API-ключ из переменной окружения DADATA_API_KEY
import (
"context"
dadata "github.com/ekomobile/dadata/v2"
"github.com/ekomobile/dadata/v2/api/suggest"
)
func main() {
api := dadata.NewSuggestApi()
params := suggest.RequestParams{Query: "сбербанк"}
result, err := api.Party(context.Background(), ¶ms)
}
JavaScript
var url = "https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/party";
var token = "${API_KEY}";
var query = "сбербанк";
var options = {
method: "POST",
mode: "cors",
headers: {
"Content-Type": "application/json",
"Accept": "application/json",
"Authorization": "Token " + token
},
body: JSON.stringify({query: query})
}
fetch(url, options)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log("error", error));
PHP
// https://github.com/hflabs/dadata-php
$token = "${API_KEY}";
$dadata = new DadataDadataClient($token, null);
$result = $dadata->suggest("party", "сбербанк");
Python
# https://github.com/hflabs/dadata-py
from dadata import Dadata
token = "${API_KEY}"
dadata = Dadata(token)
result = dadata.suggest("party", "сбербанк")
Укажите при вызове:
Content-Type: application/jsonилиapplication/xml.Accept— аналогично.${API_KEY}— API-ключ.
Тело запроса передавайте в кодировке UTF-8.
Параметры запроса
| Название | Тип | Обяз.? | По умолч. | Описание |
|---|---|---|---|---|
| query | string | ✓ | Текст запроса | |
| count | number | 10 | Количество результатов (максимум — 20) | |
| type | string | Ограничение по типу организации | ||
| status | array [string] | Ограничение по статусу организации | ||
| okved | array [string] | Ограничение по коду ОКВЭД | ||
| locations | array [object] | Ограничение по региону или городу | ||
| locations_boost | array [object] | Приоритет города при ранжировании |
Что в ответе
Объект с массивом подсказок в поле suggestions:
Пример ответа
{
"suggestions": [
{
"value": "ПАО СБЕРБАНК",
"unrestricted_value": "ПАО СБЕРБАНК",
"data": {
"kpp": "773601001",
"capital": null,
"management": {
"name": "Греф Герман Оскарович",
"post": "ПРЕЗИДЕНТ, ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ",
"disqualified": null
},
"founders": null,
"managers": null,
"predecessors": null,
"successors": null,
"branch_type": "MAIN",
"branch_count": 88,
"source": null,
"qc": null,
"hid": "145a83ab38c9ad95889a7b894ce57a97cf6f6d5f42932a71331ff18606edecc6",
"type": "LEGAL",
"state": {
"status": "ACTIVE",
"actuality_date": 1564012800000,
"registration_date": 677376000000,
"liquidation_date": null
},
"opf": {
"type": "2014",
"code": "12247",
"full": "Публичное акционерное общество",
"short": "ПАО"
},
"name": {
"full_with_opf": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"",
"short_with_opf": "ПАО СБЕРБАНК",
"latin": null,
"full": "СБЕРБАНК РОССИИ",
"short": "СБЕРБАНК"
},
"inn": "7707083893",
"ogrn": "1027700132195",
"okato": "45293554000",
"oktmo": "45397000000",
"okpo": "00032537",
"okogu": "4100104",
"okfs": "41",
"okved": "64.19",
"okveds": null,
"authorities": null,
"documents": null,
"licenses": null,
"finance": null,
"address": {
"value": "г Москва, ул Вавилова, д 19",
"unrestricted_value": "117312, г Москва, Академический р-н, ул Вавилова, д 19",
"data": { ... }
},
"phones": null,
"emails": null,
"ogrn_date": 1029456000000,
"okved_type": "2014",
"employee_count": null
}
},
...
]
}
| Название | Описание |
|---|---|
| Базовые поля | |
| 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.invalid |
Признак недостоверных сведений об организации (true/null) только на «Максимальном» тарифе |
| Дополнительные поля, заполняются только через метод «Организация по ИНН» | |
| data.employee_count | Среднесписочная численность работников |
| data.okveds[ ] | Коды ОКВЭД дополнительных видов деятельности |
| data.authorities | Сведения о налоговой, ПФР и ФСС |
| data.citizenship | Гражданство ИП |
| data.founders[ ] | Учредители компании |
| data.managers[ ] | Руководители компании |
| data.predecessors[ ] | Правопредшественники компании |
| data.successors[ ] | Правопреемники компании |
| data.capital | Уставной капитал компании |
| data.finance | Налоговый режим, доходы, расходы, долги и штрафы |
| data.documents | Документы и реестры |
| data.licenses[ ] | Лицензии |
| data.phones[ ] | Телефоны |
| data.emails[ ] | Адреса эл. почты |
| Не заполняются | |
| data.source | |
| data.qc |
Источники данных:
- ЕГРЮЛ и ЕГРИП Налоговой службы
- Реестр филиалов иностранных юрлиц
- Реестр субъектов малого и среднего предпринимательства
- Сведения о среднесписочной численности работников организации
- Сведения о специальных налоговых режимах
- Сведения о суммах недоимки и задолженности
- Сведения о налоговых правонарушениях
- Бухгалтерская отчетность (форма по ОКУД 0710002)
Коды ответа на запрос
| HTTP-код ответа | Описание |
|---|---|
| 200 | Запрос успешно обработан |
| 400 | Некорректный запрос (невалидный JSON или XML) |
| 401 | В запросе отсутствует API-ключ |
| 403 | В запросе указан несуществующий API-ключ Или не подтверждена почта Или исчерпан дневной лимит по количеству запросов |
| 405 | Запрос сделан с методом, отличным от POST |
| 413 | Слишком большая длина запроса или слишком много условий |
| 429 | Слишком много запросов в секунду или новых соединений в минуту |
| 5xx | Произошла внутренняя ошибка сервиса |
Примеры вызова
Заголовки и параметры
Фильтр: действующая / ликвидирована
Фильтр: компания / ИП
Фильтр: головная компания / филиал
Фильтр по ОКВЭД
Фильтр по региону
Приоритет города при ранжировании
-
Angular
-
C# / .NET
-
Excel VBA
-
Go
-
Java (Spring)
-
Laravel
-
Node.js
-
PHP
-
PHP (одним файлом)
-
Python
-
R
-
React
-
WinHttpRequest
-
Google Apps
-
Symfony
-
Symfony
Ограничения
Количество условий в параметрах locations и locations_boost — не более 10.
Длина запроса (параметр query) — не более 300 символов.
Количество запросов в день — в соответствии с тарифным планом.
Максимальная частота запросов — 30 в секунду с одного IP-адреса.
Максимальная частота создания новых соединений — 60 в минуту с одного IP-адреса.
Частые вопросы
Как часто обновляется справочник компаний (ЕГРЮЛ)?
По мере поступления обновлений от налоговой службы. Отставание от сайта налоговой (egrul.nalog.ru) не более 3 дней.
Почему не находится организация? Я точно знаю, она должна быть
Скорее всего, организация недавно зарегистрирована в ФНС, и мы еще не успели получить информацию о ней из налоговой. Отставание Дадаты от сайта налоговой (egrul.nalog.ru) не более 3 дней, так что организация скоро появится.
Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)
Возможные причины:
- Не подтверждён адрес эл. почты. Проверьте в личном кабинете. Если почта не подтверждена — посмотрите почтовый ящик и папку «спам», там должно быть письмо от «Дадаты».
- В запросе указан неправильный API-ключ. Проверьте в личном кабинете
- Исчерпан лимит запросов на день. Проверьте в личном кабинете
Что будет, если превысить 10 000 бесплатных запросов в день?
Подсказки перестанут подсказывать ツ До начала нового дня, затем снова заработают.
10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы…
Стоимость
Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.
Информация о юридических лицах. Сведения из ЕГРЮЛ, контакты, связи через руководителей и учредителей, налоги, реестр МСП, проверка факторов риска.
Формат запроса
Используются POST- или GET-запросы следующего вида
https://api.checko.ru/v2/company?key={API-ключ}&{параметры запроса}
| Параметр запроса | Описание |
|---|---|
|
ogrn |
Должен быть указан, если не указан ИНН ОГРН организации, является уникальным идентификатором для всех российских организаций. |
|
inn |
Должен быть указан, если не указан ОГРН Если вы не указали ОГРН, вы должны указать ИНН организации. В случае определения нескольких организаций с этим ИНН — такое бывает, например, если у нее есть филиалы — будет возвращена информация по головной организации. |
|
kpp |
Если вы указали ИНН организации, вы можете указать и ее КПП. Связка ИНН + КПП является уникальной и позволяет точно определить организацию. |
|
source |
При указании параметра
source=true вы получите ответ с добавлением исходного набора данных из ЕГРЮЛ. Подробнее об этом наборе данных читайте в примечаниях. |
Примеры запросов
https://api.checko.ru/v2/company?key={API-ключ}&ogrn=1224000000278
https://api.checko.ru/v2/company?key={API-ключ}&inn=4027148080
https://api.checko.ru/v2/company?key={API-ключ}&ogrn=1224000000278&source=true
Примечания
- API-ключ вы можете найти в личном кабинете после регистрации.
- Вы можете использовать как защищенное
https://
SSL-соединение, так и незащищенное
http://
соединение. Например, если при интеграции с 1С вы получаете «Ошибка инициализации SSL-соединения», воспользуйтесь незащищенным соединением через 80-й порт.
- При добавлении в запрос параметра source=true вы получите ответ с добавлением исходного набора данных из ЕГРЮЛ. Эти данные являются точной копией XML-данных, поставляемых ФНС, конвертированных в формат JSON. Документацию, описывающую структуру XML-данных ЕГРЮЛ можно скачать здесь.
- Контактные данные организаций получены из открытых источников и могут являться неполными или устаревшими. Вы можете предварительно оценить качество этих данных на страницах организаций портала «Чекко». Мы постоянно работаем над актуализацией контактных данных и обновляем несколько сотен записей в день.
Формат ответа
{
data: {
Основная информация ответа
ДатаРег: <STRING>,
Дата регистрации
ДатаОГРН: <STRING>,
Дата присвоения ОГРН
НаимСокр: <STRING>,
Сокращенное наименование
НаимПолн: <STRING>,
Полное наименование
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
Код: <STRING>,
Код статуса по справочнику СЮЛСТ
Наим: <STRING>
Описание статуса
Ликвид: {
Сведения о ликвидации
Дата: <STRING>,
Дата ликвидации
Наим: <STRING>
Причина ликвидации
Код: <STRING>,
Код региона РФ
Наим: <STRING>
Наименование региона РФ
ЮрАдрес: {
Юридический адрес
НасПункт: <STRING>,
Населенный пункт
АдресРФ: <STRING>,
Юридическийй адрес в РФ
ИдГАР: <STRING>,
Идентификатор ГАР (Государственный адресный реестр)
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>
Описание причины признания сведений недостоверными
ОКВЭД: {
Основной вид экономической деятельности
Наим: <STRING>,
Наименование вида деятельности согласно ОКВЭД
Версия: <STRING>
Версия справочника ОКВЭД, принимает значения «2001» или «2014»
ОКВЭДДоп: [ {
Дополнительные виды экономической деятельности
Наим: <STRING>,
Наименование вида деятельности согласно ОКВЭД
Версия: <STRING>
Версия справочника ОКВЭД, принимает значения «2001» или «2014»
ОКОПФ: {
Организационно-правовая форма
Наим: <STRING>
Наименование ОПФ
ОКФС: {
Форма собственности
Наим: <STRING>
Наименование формы собственности
ОКОГУ: {
Общероссийский классификатор органов государственной власти и управления
Наим: <STRING>
Наименование
ОКАТО: {
Общероссийский классификатор объектов административно-территориального деления
Наим: <STRING>
Наименование
ОКТМО: {
Общероссийский классификатор территорий муниципальных образований
Наим: <STRING>
Наименование
РегФНС: {
Постановка на учет в налоговом органе
КодОрг: <STRING>,
Код налогового органа
НаимОрг: <STRING>,
Наименование налогового органа
АдресОрг: <STRING>
Адрес налогового органа
РегПФР: {
Регистрация в ПФР
ДатаРег: <STRING>,
Дата регистрации
РегНомер: <STRING>,
Регистрационный номер
КодОрг: <STRING>,
Код территориального органа ПФР
НаимОрг: <STRING>
Наименование территориального органа ПФР
РегФСС: {
Регистрация в ПФР
ДатаРег: <STRING>,
Дата регистрации
РегНомер: <STRING>,
Регистрационный номер
КодОрг: <STRING>,
Код территориального органа ФСС
НаимОрг: <STRING>
Наименование территориального органа ФСС
УстКап: {
Уставный капитал
Тип: <STRING>,
Тип капитала, принимает значения «УСТАВНЫЙ КАПИТАЛ», «СКЛАДОЧНЫЙ КАПИТАЛ», «УСТАВНЫЙ ФОНД», «ПАЕВЫЕ ВЗНОСЫ» или «ПАЕВОЙ ФОНД»
Сумма: <INTEGER>
Размер капитала, руб.
УпрОрг: {
Управляющая организация
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
НаимПолн: <STRING>,
Полное наименование
ИнСтрана: <STRING>,
Страна, в том случае, если управляющая организация является иностранной
ИнАдрес: <STRING>,
Адрес, в том случае, если управляющая организация является иностранной
ИнРегНомер: <STRING>,
Регистрационный номер, в том случае, если управляющая организация является иностранной
ИнДатаРег: <STRING>,
Дата регистрации, в том случае, если управляющая организация является иностранной
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>
Описание причины признания сведений недостоверными
Руковод: [ {
Руководители (лица, имеющие право действовать без доверенности)
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
ВидДолжн: <STRING>,
Вид должности
НаимДолжн: <STRING>,
Должность
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>,
Описание причины признания сведений недостоверными
МассРуковод: <BOOLEAN>
Признак вхождения в список массовых руководителей от ФНС
ДисквЛицо: <BOOLEAN>
Признак дисквалификации
ДисквДатаНач: <STRING>,
Дата начала дисквалификации
ДисквДатаОконч: <STRING>,
Дата окончания дисквалификации
СвязРуковод: [ <STRING>, … ],
ОГРН других организаций, в которых это физлицо является руководителем
СвязУчред: [ <STRING>, … ]
ОГРН других организаций, в которых это физлицо является учредителем
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>,
Описание причины признания сведений недостоверными
МассУчред: <BOOLEAN>
Признак вхождения в список массовых учредителей от ФНС
Доля: {
Доля в уставном капитале
Номинал: <FLOAT>,
Номинальная стоимость доли, руб.
Процент: <FLOAT>
Размер доли, процент
СвязРуковод: [ <STRING>, … ],
ОГРН других организаций, в которых это физлицо является руководителем
СвязУчред: [ <STRING>, … ]
ОГРН других организаций, в которых это физлицо является учредителем
РосОрг: [ {
Российские юридические лица
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
НаимПолн: <STRING>,
Полное наименование
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>,
Описание причины признания сведений недостоверными
Доля: {
Доля в уставном капитале
Номинал: <FLOAT>,
Номинальная стоимость доли, руб.
Процент: <FLOAT>
Размер доли, процент
ИнОрг: [ {
Иностранные юридические лица
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
НаимПолн: <STRING>,
Полное наименование
РегНомер: <STRING>,
Регистрационный номер
ДатаРег: <STRING>,
Дата регистрации
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>,
Описание причины признания сведений недостоверными
Доля: {
Доля в уставном капитале
Номинал: <FLOAT>,
Номинальная стоимость доли, руб.
Процент: <FLOAT>
Размер доли, процент
ПИФ: [ {
Паевые инвестиционные фонды
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
Наим: <STRING>,
Наименование ПИФа
УпрКом: {
Управляющая компания
НаимПолн: <STRING>
Полное наименование
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>,
Описание причины признания сведений недостоверными
Доля: {
Доля в уставном капитале
Номинал: <FLOAT>,
Номинальная стоимость доли, руб.
Процент: <FLOAT>
Размер доли, процент
РФ: [ {
Российская Федерация, субъекты РФ и муниципальные образования
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
Тип: <STRING>,
Тип учредителя, принимает значения «РОССИЙСКАЯ ФЕДЕРАЦИЯ», «СУБЪЕКТ РФ» или «МУНИЦИПАЛЬНОЕ ОБРАЗОВАНИЕ»
Код: <STRING>,
Код региона РФ
Наим: <STRING>
Наименование региона РФ
ОргОсущПрав: [ {
Органы или юридические лица, осуществляющие права учредителя
НаимПолн: <STRING>
Полное наименование
ФЛОсущПрав: [ {
Физические лица, осуществляющие права учредителя
Недост: <BOOLEAN>,
Признак недостоверности сведений
НедостОпис: <STRING>,
Описание причины признания сведений недостоверными
Доля: {
Доля в уставном капитале
Номинал: <FLOAT>,
Номинальная стоимость доли, руб.
Процент: <FLOAT>
Размер доли, процент
СвязУпрОрг: [ {
Юридические лица, находящиеся под управлением данной организации
НаимСокр: <STRING>,
Сокращенное наименование
НаимПолн: <STRING>,
Полное наименование
ДатаРег: <STRING>,
Дата регистрации
ДатаЛикв: <STRING>,
Дата ликвидации
РегионКод: <STRING>,
Код региона РФ
ЮрАдрес: <STRING>,
Юридический адрес
ОКВЭД: <STRING>
Основной вид деятельности согласно ОКВЭД
СвязУчред: [ {
Юридические лица, учрежденные данной организацией
НаимСокр: <STRING>,
Сокращенное наименование
НаимПолн: <STRING>,
Полное наименование
ДатаРег: <STRING>,
Дата регистрации
ДатаЛикв: <STRING>,
Дата ликвидации
РегионКод: <STRING>,
Код региона РФ
ЮрАдрес: <STRING>,
Юридический адрес
ОКВЭД: <STRING>
Основной вид деятельности согласно ОКВЭД
ДержРеестрАО: {
Держатель реестра акционеров
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
НаимПолн: <STRING>
Полное наименование
Дата: <STRING>,
Дата выдачи
ЛицОрг: <STRING>,
Орган, выдавший лицензию
ВидДеят: [ <STRING>, … ]
Виды лицензируемой деятельности
Подразд: {
Подразделения организации
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
НаимПолн: <STRING>,
Полное наименование
Адрес: <STRING>,
Российский адрес
ИнАдрес: <STRING>
Иностранный адрес
Представ: [ {
Представительства организации
ОгрДоступ: <BOOLEAN>,
Признак ограничения доступа к сведениям от ФНС
НаимПолн: <STRING>,
Полное наименование
Адрес: <STRING>,
Российский адрес
ИнАдрес: <STRING>
Иностранный адрес
Правопредш: [ {
Правопредшественники
НаимПолн: <STRING>
Полное наименование
Правопреем: [ {
Правопреемники
НаимПолн: <STRING>
Полное наименование
ДатаВып: <STRING>,
Дата последней выписки из ЕГРЮЛ
Тел: [ <STRING>, … ],
Телефоны
Емэйл: [ <STRING>, … ],
Адреса электронной почты
ВебСайт: <STRING>,
Веб-сайт
Налоги: {
Информация о налогах и сборах
ОсобРежим: [ <STRING>, … ],
Применяемые ообые режимы налогообложения, такие как «ЕСХН», «УСН», «ЕНВД» и «СРП»
СведУпл: [ {
Уплаченные налоги и сборы за 2020 год
Наим: <STRING>,
Наименование налога
СумУпл: <FLOAT>,
Сумма уплаченных налогов и сборов за 2020 год
СумНедоим:<FLOAT>
Сумма недоимки по налогам и сборам за 2020 год
РМСП: {
Информация о включении в Единый реестр субъектов малого и среднего предпринимательства
Кат: <STRING>,
Категория реестра МСП, принимает значения «МИКРОПРЕДПРИЯТИЕ», «МАЛОЕ ПРЕДПРИЯТИЕ» или «СРЕДНЕЕ ПРЕДПРИЯТИЕ»
ДатаВкл: <STRING>
Дата включения в реестр
СЧР: <INTEGER>,
Среднесписочная численность работников организации
НедобПост: <BOOLEAN>,
Признак включения в реестр недобросовестных поставщиков
НедобПостЗап: [ {
Записи реестра недобросовестных поставщиков
РеестрНомер: <STRING>,
Реестровый номер
ДатаПуб: <STRING>,
Дата публикации
ДатаУтв: <STRING>,
Дата утверждения
ЗаказНаимСокр: <STRING>,
Сокращенное наименование заказчика
ЗаказНаимПолн: <STRING>,
Полное наименование заказчика
ЗаказИНН: <STRING>,
ИНН заказчика
ЗаказКПП: <STRING>,
КПП заказчика
ЗакупНомер: <STRING>,
Номер закупки
ЗакупОпис: <STRING>,
Описание закупки
ЦенаКонтр: <INTEGER>
Цена контракта, руб.
ДисквЛица: <BOOLEAN>,
Признак присутствия дисквалифицированных лиц в руководстве организации
МассРуковод: <BOOLEAN>,
Признак присутствия массовых руководителей
МассУчред: <BOOLEAN>
Признак присутствия массовых учредителей
source_data: {
Исходные данные ЕГРЮЛ
…
meta: {
Информация о результате запроса
status: <STRING>,
Статус ответа, принимает значения «ok» или «error»
today_request_count: <INTEGER>,
Количество успешно обработанных запросов с вашим API-ключом за сегодняшний день
message: <STRING>
Сообщение, поясняющее результат запроса, отсутствует в случае успешной обработки запроса и получении ответа, содержащего требуемые данные
}
Получить данные организации и ИП по ИНН, ОГРН (ОГРНИП).
Данная форма позволяет получить данные о любой организации или ИП зарегистрированной в России.
Осталось 20 бесплатных запросов до 04:05:22 13.05.23
Пример формы заполнения данных об организации:
Исходный код примера
<style> .valid{ box-shadow: 0 0 1px 1px #0A0; } .invalid{ box-shadow: 0 0 1px 1px #F00; } </style> <p>Пример формы заполнения данных об организации:</p> <form method="post" class="box" action="?" style="width:550px" onsubmit="return false;"> <label class="big">ИНН: <input class="noSpin" type="number" name="inn" size="12" required pattern="[0-9]{10,12}" onchange="isINN(this)"></label> <label>КПП: <input class="noSpin" type="number" name="kpp" size="9" required pattern="[0-9]{9}"></label> <br> <label>Наименование организации:<br> <input name="owner" style="width:500px" required></label><br> <label>Почтовый адрес с индексом:<br> <input name="address" style="width:500px"></label><br> <label>Руководитель:<br> <input name="seo" style="width:500px"></label><br> </form> <script> // Функция для проверки правильности ИНН function is_valid_inn(i) {i= i.toString(); if ( i.match(/D/) ) return false; var inn = i.match(/(d)/g); if ( inn.length == 10 ) { return inn[9] == String((( 2*inn[0] + 4*inn[1] + 10*inn[2] + 3*inn[3] + 5*inn[4] + 9*inn[5] + 4*inn[6] + 6*inn[7] + 8*inn[8] ) % 11) % 10); } else if ( inn.length == 12 ) { return inn[10] == String((( 7*inn[0] + 2*inn[1] + 4*inn[2] + 10*inn[3] + 3*inn[4] + 5*inn[5] + 9*inn[6] + 4*inn[7] + 6*inn[8] + 8*inn[9] ) % 11) % 10) && inn[11] == String((( 3*inn[0] + 7*inn[1] + 2*inn[2] + 4*inn[3] + 10*inn[4] + 3*inn[5] + 5*inn[6] + 9*inn[7] + 4*inn[8] + 6*inn[9] + 8*inn[10] ) % 11) % 10); } return false; } // функция на изменение поля ввода ИНН function isINN(t) { t.value=trim(t.value); if(is_valid_inn(t.value)){ addClass(t,'valid'); removeClass(t,'invalid'); // сайт с которого будете вызывать укажите в https://htmlweb.ru/user/#allowDomain fetch('//htmlweb.ru/json/service/org/?inn=' + t.value+'&api_key=0').then(function (e) { e.json().then(function (e) { console.log(e); // все что пришло выведу в консоль t.form.lastElementChild.innerHTML='Инфо: '+e.status+(e.error?' '+e.error:'')+(e.message?' '+e.message:''); if(e.status==='ACTIVE'){ t.form.kpp.value= e.kpp?e.kpp:0; t.form.owner.value= e.name; t.form.address.value= e.address; t.form.seo.value=(e.seo_post?e.seo_post:'')+' '+ (e.seo_name?e.seo_name:''); } }).catch(function(error) { console.warn('Request failed', error); }); }); return true; }else{ addClass(t,'invalid'); removeClass(t,'valid'); return false; } } function addClass(o, c){ if(!o.classList.contains(c)) o.classList.add(c); } function removeClass(o, c){ o.classList.remove(c); } </script>Пример заполнения данных банка по БИК
Перед обращением с целью экономии запросов и рекомендуем на стороне клиента проверить корректность данных с помощью
проверка ИНН, ОГРН на JavaScript.Входные параметры:
inn— ИНН
или
ogrn— ОГРНhttp://htmlweb.ru/api/service/org?inn=проверяемый_ИНН&api_key=API_KEY_из_профиляили
http://htmlweb.ru/api/service/org?ogrn=проверяемый_ОГРН&api_key=API_KEY_из_профиляВ ответе возможны следующие поля:
status — статус ошибки или организации:
- ACTIVE — действующая
- LIQUIDATING — ликвидируется
- LIQUIDATED — ликвидирована
- REORGANIZING — в процессе присоединения к другому юрлицу, с последующей ликвидацией
name
inn ИНН — Идентификационный номер налогоплательщика
kpp КПП — Код причины постановки на учёт
ogrn ОГРН — Основной государственный регистрационный номер
date_ogrn Дата выдачи ОГРН (дата регистрации)
okpo — Код по Общероссийский классификатор предприятий и организаций
okato — Код по Общероссийский классификатор объектов административно-территориального деления
okopf — Код по Общероссийский классификатор организационно-правовых форм
address — юридический адрес организаци
seo_name — ФИО руководителя
seo_post — должность руководителя
buh_name — ФИО руководителя
buh_post — должность руководителя
full_name — полное наименование, не у всех заполнено
rs=[[rs=,bic=],] — список расчетных счетов
phones — номера телефонов, массив
emails — электронные почтовые адреса, массив
sites — список сайтов, массив
okved — список ОКВЭД, массив
upd — дата актуальности
Примеры API запросов проверки организации по ИНН или ОГРН
Пример запроса в формате json: https://htmlweb.ru/json/service/org?inn=616301431999
Ответ:
{"status":"ACTIVE",
"inn":"616301431999",
"ogrn":"316619600268347",
"name":"ИП Колесников Дмитрий Геннадьевич",
"upd":"06.03.2020",
"okved":"47.91.2",
"address":"344000, г Ростов-на-Дону",
"full_name":"Индивидуальный предприниматель Колесников Дмитрий Геннадьевич",
"limit":98773,
"balans":24780.46}
Запрос: https://htmlweb.ru/json/service/org?inn=6167109768
Ответ:
{
"status": "ACTIVE",
"inn": 6167109768,
"ogrn": "1126195014747",
"name": "ООО "ЕТИ"",
"upd": "09.03.2020",
"kpp": 616701001,
"seo_name": "Колесников Дмитрий Геннадьевич",
"seo_post": "генеральный директор",
"date_ogrn": "14.12.2012",
"okved": 46.66,
"address": "344019, г Ростов-на-Дону, ул 10-я линия, д 8",
"full_name": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ЕТИ"",
"rs": [
{
"bic": "044525092",
"rs": "40702810470310000093"
}
],
"phones": [
"7(863)256-60-10",
"7(903)406-60-10"
],
"sites": [
"https://eaiti.ru/"
]
}
Сохранение и добавление информации по организациям и ИП
Вы можете передать недостающие данные, например, Вы получили данные по ИНН и Ваш пользователь дозаполнил незаполненное ОКПО, вызовите:
https://htmlweb.ru/json/service/org/?inn=616301431999&okpo=0107987279&api_key=ВАШ_КЛЮЧ
ОКПО будет сохранено в базу и будет выдаваться при последующих запросах.
Запрос не тарифицируется, api_key нужен для исключения несанкционированного доступа.
Будьте внимательны, изменить заполненные данные нельзя.
https://htmlweb.ru/json/service/org/?inn=616301431999&rs=40802810070310000694&bic=044525092&api_key=ВАШ_КЛЮЧ
р/c + БИК будет сохранено в базу и будет выдаваться при последующих запросах.
Общие параметры для всех API сервисов
Другие сервисы, доступные по API
Стоимость API запроса и тарифы
Вам может быть интересно:
- Проверка ИНН, КПП, ОГРН, БИК, к/с, р/с на PHP и JavaScript
- Информация о телефонном номере ( страна, регион, оператор )
- Информация о перенесенных телефонных номерах
- Проверка Email на валидность и существование
- API склонения и грамматики. Возможность получать слово в любом склонении, падеже, роде
- Написание чисел словами — форма и API
- Выписка из ЕГРЮЛ/ЕГРИП на сайте nalog.ru
- Справочник банков по API
- Заполнение данных банка по БИК
- Узнать ИНН физического лица по паспорту можно на сайте налоговой
Получение информации о компании из ЕГРЮЛ и ЕГРИП
Команда fetch/company позволяет получить о компании дополнительную информацию, имеющуюся в ЕГРЮЛ или ЕГРИП. К такой информации, например, относятся сведения об учредителях и их долях в уставном капитале, полный размер уставного капитала, сведения о руководителях, данные о регистрации в ФНС, ПФР и ФСС, коды ОКВЭД, а также информация о лицензиях, имеющихся у компании. Кроме этого, можно выяснить, действует ли в настоящий момент компания, или находится в процессе ликвидации.
Запросить эти сведения можно, если компания ранее была найдена в режиме подсказок посредством API-команды suggest/company, либо через наш JavaScript модуль подсказок ahunter_suggest.js. В таких случаях сервис возвращает уникальную сигнатуру компании sign, по которой можно запросить дополнительную информацию о ней с помощью команды fetch/company.
Также данная команда может использоваться независимо от подсказок, если просто требуется получить сведения о компании по её ОГРН или ИНН.
Использование в связке с подсказками по ЕГРЮЛ и ЕГРИП
Использование данной команды совместно с подсказками подразумевает следующий сценарий. Пользователь вводит информацию о юридическом лице или индивидуальном предпринимателе в некоторой форме в вашем приложении или на сайте. В процессе этого ввода ему предлагаются подсказки, из которых он может выбрать подходящую компанию.
Каждая подсказка, возвращаемая сервисом, кроме непосредственно подсказываемой компании снабжается уникальной сигнатурой sign, которая не отображается пользователю, но при этом доступна вашему сайту или приложению. Когда пользователь выбирает подходящую подсказку, приложение или сайт может запоминать соответствующую данной подсказке сигнатуру и использовать её в команде fetch/company для получения от сервиса полного комплекта сведений о выбранном юридическом лице или индивидуальном предпринимателе.
Приведённая ниже форма демонстрирует данный сценарий.
Выбранная компания
Нужно выбрать компанию в подсказках и нажать Enter, чтобы здесь появились её поля
Для отображения подсказок здесь используется наш JavaScript модуль ahunter_suggest.js. В данном модуле есть встроенная поддержка команды fetch/company, поэтому здесь достаточно реализовать колбэк on_fetch, который будет принимать результат выполнения данной команды, после того, как пользователь выберет подсказку с подходящей компанией. Ниже показан пример такой реализации.
//настраиваем модуль подсказок для работы с нашим сервисом var options = { //идентификатор поля, куда вводится компания id : "js-CompanyField", //колбэк при получении полных данных о компании on_fetch : function( Suggestion, Company ) { ... //выводим описатель Company на экран alert( JSON.stringify( Company ) ); ... } }; //запускаем модуль AhunterSuggest.Company.Solid( options );
Здесь полагается, что на форме есть текстовое поле с идентификатором js-CompanyField, куда будет вводиться информация о компании. Наш модуль настраивается так, чтобы отслеживать пользовательский ввод в этом поле и отображать подходящие подсказки. Более подробно об использовании подсказок для компаний можно посмотреть по следующей ссылке suggest/company.
Когда пользователь выбирает подходящую подсказку, наш модуль автоматически отсылает Ахантеру запрос fetch/company, после чего вызывает подготовленный нами колбэк on_fetch. Ему в качестве аргумента передаётся выбранная подсказка Suggestion и полный описатель компании Company, полученный в качестве результата работы команды fetch/company. В нашем примере мы берём информацию из этого описателя и просто выводим её на экран. Чтобы не усложнять пример, здесь отображается только небольшая часть сведений о компании.
Пример простого запроса
Приведенный ниже запрос отсылает сервису сигнатуру c1027700132195, которая соответствует юридическому лицу ПАО СБЕРБАНК. При этом используется минимальное количество параметров и опций.
https://ahunter.ru/site/fetch/company?output=json;query=c1027700132195
В данном запросе используются следующие параметры.
- output=json — сообщает сервису о том, что необходимо вернуть ответ в формате JSON.
- query=c1027700132195 — сигнатура запрашиваемого юридического лица. Поскольку сигнатура может содержать символы кириллицы, перед отправкой запроса необходимо закодировать её с использованием URL-encoding.
Рассмотрим более подробно все параметры, которые сервис может получать в рамках данной команды.
Параметры команды
Обязательные параметры для выполнения запроса.
- https://ahunter.ru/site/fetch/company — URL-команды.
-
output=json или
output=xml — формат, в котором требуется вернуть результат выполнения команды. - query=строка с сигнатурой — строка запроса, содержащая сигнатуру запрашиваемого юридического лица или ИП. Сигнатура позволяет запросить сведения для конкретного филиала или представительства юридического лица. Если такая детализация не требуется, и достаточно получить сведения о головном офисе компании, то вместо сигнатуры в рамках query можно передавать ОГРН или ИНН запрашиваемой компании.
Опциональные параметры.
-
user=API-токен — опциональный API-токен пользователя из личного кабинета. Данный параметр не является обязательным. Его следует использовать в случае, если по запрашиваемому юридическому лицу или индивидуальному предпринимателю нужно получить расширенную информацию, например, коды ОКВЭД, учредителей и перечень лицензий. Обработка такого запроса будет выполняться платно, поэтому сервис будет списывать со счёта аккаунта стоимость выполнения данной команды согласно цене, указанной в Профиле личного кабинета.
Если при отправке запроса не указывать данный параметр, то обработка будет выполняться бесплатно, однако по запрошенной компании сервис будет возвращать не все доступные сведения.
Данный параметр не следует использовать, если вы отсылаете ajax-запросы непосредственно из браузера с веб-страницы, публично доступной любому посетителю вашего веб-сайта. Поскольку в этом случае ваш API-токен может стать известен третьим лицам. Чтобы этого избежать, следует организовать отсылку этих запросов либо с backend-а вашего веб-сайта, либо с закрытой части веб-сайта, доступной, например, только вашим сотрудникам, выполняющим обработку заказов.
- output=pretty — опция требует, чтобы сервис выполнил «красивое» форматирование возвращаемого JSON или XML текста, расставив в нем переносы строк и отступы. Опция может быть полезна при отладке взаимодействия пользовательского приложения с сервисом.
-
output=cp1251 — опция применима только в случае использования XML
формата ответа сервиса. Данная опция требует, чтобы сервис вернул XML-ответ в кодировке windows-1251.
Пример запроса с дополнительными опциями
Приведенный ниже запрос отсылает сервису сигнатуру c1027700132195, которая соответствует юридическому лицу ПАО СБЕРБАНК с дополнительными параметрами.
https://ahunter.ru/site/fetch/company?user=demotoken;output=json|pretty;query=c1027700132195
В данном запросе используются следующие параметры.
- user=demotoken – сообщает сервису API-токен пользователя, поэтому в данном случае полагается, что запрос выполняется платно, так что после его выполнения с баланса будет списана его стоимость.
- output=json|pretty — сообщает сервису о том, что необходимо вернуть ответ в формате JSON, отформатировав его «красиво».
- query=c1027700132195 — сигнатура запрашиваемого юридического лица.
Результат запроса в формате JSON
Ниже приведен пример ответа сервиса с результатом обработки сигнатуры c1027700132195b126498, которая соответствует юридическому лицу УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК. Результирующий JSON-ответ получен с использованием опции output=json|pretty, позволяющей выполнить «красивое» форматирование JSON-текста.
Для краткости записи, в примере отображены не все лицензии, имеющиеся у данной компании.
{
"company" : {
"address" : {
"canonic" : "117312, г Москва, ул Вавилова, дом 19",
"name_precise" : true,
"nums_precise" : true,
"sign" : "77s924hдом:19",
"source" : "ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"
},
"branch" : {
"address" : {
"canonic" : "620026, обл Свердловская, г Екатеринбург,
ул Куйбышева, стр 67",
"country" : "rus",
"name_precise" : true,
"nums_precise" : true,
"sign" : "66c1s578uстр:67",
"source" : "ОБЛАСТЬ СВЕРДЛОВСКАЯ, ГОРОД ЕКАТЕРИНБУРГ,
УЛИЦА КУЙБЫШЕВА, ДОМ 67"
},
"full_name" : "УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК",
"kpp" : "667102008",
"reg_fns" : {
"code" : "6671",
"date" : "2005-03-22",
"name" : "Инспекция Федеральной налоговой службы
по Ленинскому району г.Екатеринбурга"
},
"type" : 0
},
"capital" : {
"sum" : 67760844800.00,
"type" : "УСТАВНЫЙ КАПИТАЛ"
},
"licenses" : [
{
"begin_date" : "2015-10-06",
"end_date" : "",
"licensor" : "Центральный банк Российской Федерации",
"number" : "045-02894-100000",
"types" : [
"Брокерская деятельность"
]
},
{
"begin_date" : "2015-10-06",
"end_date" : "",
"licensor" : "Центральный банк Российской Федерации",
"number" : "045-02768-000100",
"types" : [
"Депозитарная деятельность"
]
},
{
"begin_date" : "2015-10-06",
"end_date" : "",
"licensor" : "Центральный банк Российской Федерации",
"number" : "045-03004-010000",
"types" : [
"Дилерская деятельность"
]
],
"main" : {
"create_date" : "1991-06-20",
"fss" : "770600307277061",
"full_name" : "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"",
"inn" : "7707083893",
"kpp" : "773601001",
"ogrn" : "1027700132195",
"okfs" : "41",
"okogu" : "4100104",
"okpo" : "00032537",
"pfr" : "087705007215",
"short_name" : "ПАО СБЕРБАНК",
"state" : "Normal",
"state_date" : "",
"biz_scale" : "Common",
"staff_amount" : "0"
},
"managers" : [
{
"first_name" : "ГЕРМАН",
"inn" : "770303580308",
"last_name" : "ГРЕФ",
"patronym" : "ОСКАРОВИЧ",
"position_code" : "02",
"position_name" : "ПРЕЗИДЕНТ, ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ",
"position_type" : "Руководитель юридического лица"
}
],
"okveds" : [
{
"class" : "2014",
"code" : "64.19",
"name" : "Денежное посредничество прочее"
}
],
"opf" : {
"class" : "ОКОПФ",
"code" : "12247",
"full" : "Публичные акционерные общества"
},
"owners" : [
{
"fract" : "",
"inn" : "7702235133",
"name" : "ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ",
"ogrn" : "0",
"sum" : 605693376.00,
"type" : "RussianCompany"
}
],
"reg_fns" : {
"code" : "7736",
"date" : "2017-01-09",
"name" : "Инспекция Федеральной налоговой службы № 36 по г.Москве"
},
"reg_fss" : {
"code" : "7706",
"date" : "2001-01-04",
"name" : "Филиал №6 Государственного учреждения -
Московского регионального отделения Фонда
социального страхования Российской Федерации"
},
"reg_pfr" : {
"code" : "087705",
"date" : "2010-09-03",
"name" : "Государственное учреждение - Главное Управление
Пенсионного фонда РФ №4 Управление №1 по г. Москве
и Московской области муниципальный район Гагаринский
г.Москвы"
}
},
"query" : "c1027700132195",
"request_process_time" : 9
}
Результатом получения описателя юридического лица является JSON-объект со следующими элементами.
- company – объект, содержащий информацию о запрошенном юридическом лице или индивидуальном предпринимателе. Если в запросе будет указана некорректная сигнатура, либо сигнатура не существующей компании, то в ответе сервиса не будет содержаться данный объект.
- query – исходный запрос, полученный и обработанный сервисом.
- request_process_time – время обработки всего запроса в целом в миллисекундах.
Ниже приведено детальное описание этих элементов.
JSON-объект company: информация о компании из ЕГРЮЛ или ЕГРИП
Данный объект содержит всю информацию о запрошенной компании, которой располагает Ахантер. Данный объект содержит следующие дочерние элементы:
- company.main — основные сведения о компании, её полное и краткое название, ОГРН, ИНН, КПП и прочие реквизиты.
- company.opf — справочные сведения об организационно-правовой форме юридического лица. Данный объект не возвращается, если запрашиваются сведения об индивидуальном предпринимателе.
- company.address — информация о почтовом адресе компании.
- company.status — перечень статусов компании, присвоенных ей в рамках ЕГРЮЛ или ЕГРИП.
- company.inheritors — перечень правопреемников компании.
- company.reg_fns — сведения о постановке на учёт компании в ФНС.
- company.reg_pfr — сведения о регистрации компании в Пенсионном фонде РФ.
- company.reg_fss — сведения о регистрации компании в Фонде социального страхования РФ.
- company.managers — перечень руководителей юридического лица. Данный объект не возвращается, если запрашиваются сведения об индивидуальном предпринимателе.
- company.capital — информация об уставном капитале юридического лица. Данный объект не возвращается, если запрашиваются сведения об индивидуальном предпринимателе.
- company.owners — перечень учредителей юридического лица. Данный объект не возвращается, если запрашиваются сведения об индивидуальном предпринимателе.
- company.okveds — коды видов экономической деятельности компании и их описатели по классификатору ОКВЭД.
- company.licenses — перечень лицензий, выданных компании на определённые виды деятельности.
- company.branch — опциональный элемент, в рамках которого Ахантер возвращает информацию о филиале или представительстве юридического лица, если сигнатура, полученная в запросе, соответствует именно филиалу, а не головному офису юридического лица. Данный объект не возвращается, если запрашиваются сведения об индивидуальном предпринимателе.
- company.individual — опциональный элемент, в рамках которого Ахантер возвращает детализированную информацию об индивидуальном предпринимателе (пол, гражданство и др.). Данный объект не возвращается, если запрашиваются сведения о юридическом лице, а не о ИП.
JSON-объект company.main: основные сведения и реквизиты компании
Элементы данного объекта позволяют получить основную информацию о компании, такую как реквизиты, название и текущее состояние (действующая или ликвидируемая). Пример JSON-объекта company.main показан ниже.
{
"create_date" : "1991-06-20",
"fss" : "770600307277061",
"full_name" : "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"",
"inn" : "7707083893",
"kpp" : "773601001",
"ogrn" : "1027700132195",
"okfs" : "41",
"okogu" : "4100104",
"okpo" : "00032537",
"pfr" : "087705007215",
"short_name" : "ПАО СБЕРБАНК",
"state" : "Normal",
"state_date" : "",
"biz_scale" : "Common",
"staff_amount" : "0"
}
Объект содержит следующие элементы.
- full_name — полное название компании в том виде, в котором оно зарегистрировано в ЕГРЮЛ или ЕГРИП.
- short_name — краткое название компании в том виде, в котором оно зарегистрировано в ЕГРЮЛ или ЕГРИП.
- ogrn — основной государственный регистрационный номер юридического лица — ОГРН, либо основной государственный регистрационный номер индивидуального предпринимателя — ОГРНИП.
- inn — ИНН — индивидуальный номер налогоплательщика, присвоенный юридическому лицу или индивидуальному предпринимателю при регистрации в ФНС.
- kpp — КПП юридического лица. Для индивидуального предпринимателя не заполняется.
- pfr — регистрационный номер компании в ПФР.
- fss — регистрационный номер компании в ФСС.
- okpo — код компании по общероссийскому классификатору предприятий и организаций.
- okogu — код компании по общероссийскому классификатору органов государственной власти и управления.
- okfs — код компании по общероссийскому классификатору форм собственности.
- create_date — дата регистрации компании в формате XML Schema date.
-
state — текущее состояние компании, может принимать следующие значения:
- Normal — компания является действующей.
- Limitation — компания действует с ограничениями.
- Reorganization — компания находится в процессе реорганизации.
- Inherited — компания прекратила свою деятельность в результате реорганизации, но у компании есть хотя бы один правопреемник.
- Liquidation — компания находится в состоянии ликвидации.
- Finished — компания прекратила свою деятельность в результате ликвидации, либо исключена из ЕГРЮЛ или ЕГРИП по иным причинам, о которых можно узнать в объекте company.status.
- state_date — дата перехода компании в состояние state, может быть пустой строкой, если текущее состояние компании Normal.
-
biz_scale — категория, отражающая размер предприятия, может принимать одно из следующих значений:
- Micro — категория микропредприятий (обычно численность сотрудников — до 15 человек).
- Small — категория малых предприятий (обычно численность сотрудников — до 100 человек).
- Medium — категория средних предприятий (обычно численность сотрудников — до 250 человек).
- Common — компании, не зарегистрированные в реестре субъектов малого и среднего предпринимательства.
- staff_amount — среднесписочная численность сотрудников компании, значение 0 указывает на то, что сведения о численности сотрудников данной компании отсутствуют в соответствующем государственном реестре.
JSON-объект company.opf: организационно-правовая форма юр. лица
Данный объект сообщает информацию об организационно-правовой форме компании по классификатору ОКОПФ/КОПФ. Для индивидуального предпринимателя данный объект не возвращается, т.к. сведения данного типа не применимы к ИП. Пример JSON-объекта company.opf показан ниже.
{
"class" : "ОКОПФ",
"code" : "12247",
"full" : "Публичные акционерные общества"
}
Объект содержит следующие элементы.
- full — полное наименование организационно-правовой формы компании, в том виде, в котором оно представлено в классификаторе, например, «Публичные акционерные общества».
- code — код организационно-правовой формы по соответствующему классификатору.
- class — название классификатора организационно-правовых форм, в рамках которого определён код code. Может принимать значения ОКОПФ и КОПФ, в зависимости от того, по какому классификатору внесены сведения о компании в ЕГРЮЛ. Может быть пустым, если ОПФ компании введена в ЕГРЮЛ без использования классификатора.
JSON-объект company.address: почтовый адрес компании
Объект содержит адрес компании в том виде, в котором он указан в ЕГРЮЛ или ЕГРИП, а также адрес компании в стандартизованном виде, который получен при обработке исходного адреса функцией стандартизации Ахантера. Пример JSON-объекта company.address показан ниже.
{
"canonic" : "117312, г Москва, ул Вавилова, дом 19",
"name_precise" : true,
"nums_precise" : true,
"sign" : "77s924hдом:19",
"source" : "ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"
}
Объект включает в себя следующие элементы.
- source — исходный неструктурированный адрес компании, извлечённый из ЕГРЮЛ или ЕГРИП.
- canonic — адрес компании, обработанный алгоритмами стандартизации Ахантера.
- name_precise — если true, то в ходе стандартизации нечисловых адресных полей исходного адреса не было обнаружено ошибок и неточностей.
- nums_precise — если true, то номер дома, корпуса и строения исходного адреса успешно обработаны и проверены по ФИАС.
- sign — сигнатура стандартизованного адреса, которую можно передать Ахантеру в команде fetch/address, чтобы получить полные сведения об адресе, такие как, коды по КЛАДР, ФИАС, ОКАТО и ОКТМО, географические координаты и др.
-
country — объект с информацией о стране, которой принадлежит адрес, содержит следующие поля:
- name — название страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
- code — цифровой код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
- sign — трёхбуквенный код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
JSON-массив company.status: статус компании по ЕГРЮЛ или ЕГРИП
Данный массив содержит объекты, позволяющие отвечать на такие вопросы как, является ли компания действующей, находится ли она в процессе реорганизации или ликвидации. Если компания находится в нормальном действующем состоянии, то массив company.status не будет включаться в состав объекта company.
Каждый элемент массива company.status[i] описывает какой-то один статус компании, согласно справочнику СЮЛСТ для юридического лица, и согласно справочнику СИПСТ, для индивидуального предпринимателя. Пример JSON-массива company.status показан ниже.
[
{
"code" : "101",
"date" : "2019-01-16",
"name" : "Находится в стадии ликвидации"
}
]
Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.
- status[i].name — текстовое описание статуса компании.
- status[i].code — код статуса по справочнику СЮЛСТ или СИПСТ.
- status[i].date — дата присвоения компании данного статуса в формате XML-Schema date.
JSON-массив company.inheritors: правопреемники компании по ЕГРЮЛ
Массив содержит информацию о юридических лицах, являющихся правопреемниками данной компании. Обычно правопреемники появляются в результате ликвидации компании в форме реорганизации, однако, возможно наличие правопреемников и у действующего юридического лица.
Каждый элемент массива company.inheritors[i] содержит сведения по одному правопреемнику. В общем случае массив может содержать более одного элемента, это относится к случаям реорганизации сложного типа. Пример JSON-массива company.inheritors показан ниже.
[
{
"inn" : "7714456779",
"name" : "ООО "ПОКРОВКА"",
"ogrn" : "1197746755898",
"sign" : "c1197746755898",
"state" : 0
},
{
"inn" : "7726441590",
"name" : "ООО "ЭЛИДЖИО"",
"ogrn" : "1187746860531",
"sign" : "c1187746860531",
"state" : 0
},
{
"inn" : "",
"name" : "ООО "МУРАНОВСКАЯ"",
"ogrn" : "1197746755909",
"sign" : "c1197746755909",
"state" : 1
}
]
Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.
- inheritors[i].inn — ИНН правопреемника.
- inheritors[i].name — краткое наименование компании правопреемника.
- inheritors[i].ogrn — ОГРН правопреемника.
- inheritors[i].sign — уникальный идентификатор-сигнатура, позволяющая получить полные сведения о данном правопреемнике с помощью запроса fetch/company.
- inheritors[i].state — число, отражающее текущее состояние правопреемника, значение 0 указывает на то, что правопреемник является действующим.
JSON-объект company.reg_fns: сведения о постановке на учёт в ФНС
Данный объект содержит дату постановки компании на учёт в ФНС, а также код и название соответствующей налоговой инспекции. Пример JSON-объекта company.reg_fns показан ниже.
{
"code" : "7719",
"date" : "2017-01-06",
"name" : "Инспекция Федеральной налоговой службы № 19 по г.Москве"
}
Объект включает в себя следующие элементы.
- reg_fns.date — дата постановки на учёт в ФНС.
- reg_fns.code — код по справочнику СОУН соответствующей налоговой инспекции.
- reg_fns.name — название соответствующей налоговой инспекции.
JSON-объект company.reg_pfr: сведения о регистрации в ПФР
Данный объект содержит дату регистрации компании в ПФР, а также код и название соответствующего территориального органа ПФР. Пример JSON-объекта company.reg_pfr показан ниже.
{
"code" : "087415",
"date" : "2005-12-02",
"name" : "Государственное учреждение - Главное Управление
Пенсионного фонда РФ №4 Управление №1 по г. Москве
и Московской области муниципальный район Гагаринский
г.Москвы"
}
Объект включает в себя следующие элементы.
- reg_pfr.date — дата регистрации в ПФР.
- reg_pfr.code — код по справочнику СТОПФ соответствующего территориального органа ПФР.
- reg_pfr.name — название соответствующего территориального органа ПФР.
JSON-объект company.reg_fss: сведения о регистрации в ФСС
Данный объект содержит дату регистрации компании в Фонде социального страхования РФ, а также код и название соответствующего исполнительного органа ФСС. Пример JSON-объекта company.reg_fss показан ниже.
{
"code" : "7711",
"date" : "2018-09-01",
"name" : "Филиал №11 Государственного учреждения -
Московского регионального отделения Фонда
социального страхования Российской Федерации"
}
Объект включает в себя следующие элементы.
- reg_fss.date — дата регистрации в ФСС.
- reg_fss.code — код по справочнику СТОФСС соответствующего исполнительного органа ФСС.
- reg_fss.name — название соответствующего исполнительного органа ФСС.
JSON-массив company.managers: список руководителей компании
Массив содержит объекты с информацией о руководителях компании. Чаще всего данный массив будет содержать только один элемент. Для компании, являющейся индивидуальным предпринимателем, данный массив не выводится, поскольку у ИП руководителем является сам предприниматель. Пример JSON-массива company.managers показан ниже.
[
{
"first_name" : "МАКСИМ",
"patronym" : "АЛЕКСАНДРОВИЧ",
"last_name" : "ХАМЧИЧ",
"inn" : "262306749147",
"position_code" : "02",
"position_type" : "Руководитель юридического лица"
"position_name" : "ПРЕДСТАВИТЕЛЬ ЛИКВИДАТОРА",
}
]
Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.
- managers[i].first_name — имя руководителя.
- managers[i].patronym — отчество руководителя.
- managers[i].last_name — фамилия руководителя.
- managers[i].inn — ИНН руководителя.
- managers[i].position_code — код вида должности, которую занимает руководитель компании по справочнику СКФЛЮЛ.
- managers[i].position_type — название вида должности.
- managers[i].position_name — название должности, которую занимает руководитель.
- managers[i].disqual — флаг булевского типа, значение true которого указывает на то, что данная персона имеет запрет (дисквалифицию) на то, чтобы занимать руководящие должности.
JSON-объект company.capital: уставный капитал компании
Объект company.capital содержит сведения о размере и типе уставного капитала юридического лица. Для индивидуального предпринимателя данный объект не возвращается, т.к. сведения данного типа не применимы к ИП. Пример объекта показан ниже.
{
"sum" : 411461504.00,
"type" : "УСТАВНЫЙ КАПИТАЛ"
}
Объект включает в себя следующие элементы.
- capital.sum — размер уставного капитала в рублях.
- capital.type — наименование вида уставного капитала.
JSON-массив company.owners: учредители юридического лица
Массив содержит однотипные объекты со сведениями о лицах (физических или юридических), которые, согласно ЕГРЮЛ, являются учредителями компании. Для компании, являющейся индивидуальным предпринимателем, данный объект не выводится, поскольку у ИП нет учредителей. Ниже показан пример данного массива.
[
{
"fract" : "",
"inn" : "7702235133",
"name" : "ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ",
"ogrn" : "0",
"sum" : 605693376.00,
"type" : "RussianCompany"
}
]
Каждый элемент company.owners[i] данного массива является JSON-объектом со следующими дочерними элементами.
- owners[i].name — название учредителя, для физического лица будет содержать его ФИО, для юридического лица — полное или краткое название, согласно данным ЕГРЮЛ.
- owners[i].inn — ИНН учредителя.
- owners[i].ogrn — ОГРН учредителя, если тот является юридическим лицом. Если учредитель является физическим лицом, то данный элемент сервисом не возвращается.
-
owners[i].type — тип учредителя, может принимать одно из следующих значений:
- Person — учредитель является физическим лицом.
- RussianCompany — учредитель является российской компанией (организацией).
- ForeignCompany — учредитель является иностранной компанией.
- Russia — учредителем является Российская Федерация или её субъект.
- Pif — учредитель представляет собой паевый инвестиционный фонд.
- Self — владельцем доли в уставном капитале компании является сама компания.
- InvestPartnership — доля компании включена в состав общего имущества участников договора инвестиционного товарищества.
- owners[i].sum — размер в рублях доли в уставном капитале, принадлежащей данному учредителю.
-
owners[i].fract — величина доли в уставном капитале, принадлежащей данному учредителю, может быть записана одним из следующих способов:
- в виде процента, например, «50%«.
- в виде простой дроби, например, «1/3«.
- в виде десятичной дроби, например, «0.5«.
JSON-массив company.okveds: коды экономической деятельности ОКВЭД
Массив содержит однотипные объекты, содержащие коды видов деятельности компании по классификатору ОКВЭД, а также их расшифровку. Пример массива показан ниже.
[
{
"class" : "2014",
"code" : "62.01",
"name" : "Разработка компьютерного программного
обеспечения"
},
{
"class" : "2014",
"code" : "62.02",
"name" : "Деятельность консультативная и работы в
области компьютерных технологий"
},
{
"class" : "2014",
"code" : "63.11",
"name" : "Деятельность по обработке данных, предоставление
услуг по размещению информации и связанная с этим
деятельность"
}
]
Каждый объект company.okveds[i] данного массива содержит следующие дочерние элементы.
- okveds[i].code — код ОКВЭД, соответствующий данному виду деятельности.
- okveds[i].class — версия классификатора ОКВЭД, в рамках которого компании был присвоен данный код. Значение 2001 указывает на классификатор ОКВЭД ОК 029-2001. Значение 2014 — на классификатор ОКВЭД ОК 029-2014.
- okveds[i].name — наименование вида деятельности.
JSON-массив company.licenses: лицензии компании
Массив содержит объекты, содержащие сведения о выданных данной компании лицензиях. Если у компании нет лицензируемых видов деятельности, то данный массив не будет возвращаться сервисом. Пример массива приведён ниже.
[
{
"begin_date" : "2006-02-27",
"end_date" : "",
"licensor" : "Федеральное агентство по строительству и
жилищно-коммунальному хозяйству",
"locations" :
[
"УФА ГОРОД,ГАГАРИНА УЛИЦА,6"
],
"number" : "ГС-4-02-02-26-0-0276096959-006640-1",
"types" :
[
"Проектирование зданий и сооружений, за исключением
сооружений сезонного или вспомогательного назначения"
]
},
{
"begin_date" : "2006-12-25",
"end_date" : "",
"licensor" : "Федеральное агентство по строительству и
жилищно-коммунальному хозяйству",
"locations" :
[
"УФА ГОРОД,ГАГАРИНА УЛИЦА,6"
],
"number" : "ГС-4-02-02-28-0-0276096959-007849-1",
"types" :
[
"Инженерные изыскания для строительства зданий
и сооружений, за исключением сооружений сезонного
или вспомогательного назначения"
]
}
]
Каждый объект company.licenses[i] данного массива содержит следующие дочерние элементы.
- licenses[i].number — номер лицензии.
- licenses[i].licensor — наименование органа, выдавшего лицензию.
- licenses[i].begin_date — дата начала действия лицензии.
- licenses[i].end_date — дата прекращения действия лицензии. Может быть пустой строкой, если лицензия не имеет срока прекращения.
- licenses[i].suspend_date — дата приостановки действия лицензии. Возвращается сервисом только в случае, если в отношении данной лицензии было принято соответствующее решение компетентным органом.
- licenses[i].suspend_licensor — наименование органа, принявшего решение о приостановке действия лицензии. Сервис не возвращает данный элемент, если в отношении лицензии не принималось решений о её приостановке.
- licenses[i].locations — необязательный массив строк. Каждая строка данного массива содержит текстовое описание территории или адрес, в пределах которого действует лицензия.
- licenses[i].types — массив строк, содержащий наименования видов деятельности компании, на которые распространяется данная лицензия.
JSON-объект company.branch: филиал или представительство компании
Объект содержит информацию о филиале или представительстве компании, если сигнатура, полученная в рамках API-запроса, соответствует не головному офису компании, а указывает более детально на конкретный её филиал или представительство. Если сигнатура указывает на головной офис компании, то объект company.branch сервисом не возвращается. Также данный объект не возвращается, если запрошены данные не по юридическому лицу, а по индивидуальному предпринимателю, поскольку для ИП не предусмотрено наличие филиалов или представительств. Пример такого объекта показан ниже.
{
"address" : {
"canonic" : "664011, обл Иркутская, г Иркутск,
ул Нижняя Набережная, дом 10",
"country" : "rus",
"name_precise" : true,
"nums_precise" : true,
"sign" : "38c3s380hдом:10",
"source" : "ГОРОД ИРКУТСК, УЛИЦА НИЖНЯЯ НАБЕРЕЖНАЯ, 10"
},
"full_name" : "БАЙКАЛЬСКИЙ БАНК ПАО СБЕРБАНК",
"kpp" : "380843001",
"reg_fns" : {
"code" : "3808",
"date" : "2013-07-31",
"name" : "Межрайонная инспекция Федеральной налоговой службы
№ 20 по Иркутской области"
},
"type" : 0
}
Данный объект содержит следующие дочерние элементы:
- branch.full_name — полное наименование филиала.
- branch.kpp — КПП филиал, может быть пустым, если этих сведений в настоящий момент нет в ЕГРЮЛ.
- branch.type — тип объекта. Содержит 1, если данный объект соответствует представительству компании. Принимает значение 0, если объект содержит сведения о филиале.
- branch.reg_fns — JSON-объект, содержащий сведения о постановке на учёт данного филиала в ФНС. Состав данного объекта идентичен составу объекта company.reg_fns.
- branch.address — JSON-объект, содержащий сведения об адресе филиала. Состав данного объекта идентичен составу объекта company.address.
JSON-объект company.individual: сведения об индивидуальном предпринимателе
Данный объект возвращается сервисом, если запрошенная компания является индивидуальным предпринимателем. В этом случае данный объект содержит дополнительные сведения об ИП. Пример такого объекта показан ниже.
{
"citizenship" : {
"country" : {
"code" : "031",
"name" : "АЗЕРБАЙДЖАН",
"sign" : ""
},
"type" : "Foreign"
},
"gender" : "FEMALE",
"lat_name" : {
"first_name" : "AYTAN",
"last_name" : "HUSEYNOVA",
"patronym" : ""
},
"rus_name" : {
"first_name" : "АЙТАН",
"last_name" : "ГУСЕЙНОВА",
"patronym" : "РОВШАН КЫЗЫ"
},
"type" : {
"code" : "2",
"full" : "Глава крестьянского (фермерского) хозяйства",
"short" : "КФХ"
}
}
Данный объект содержит следующие дочерние элементы:
- individual.gender — строка, указывающая на пол предпринимателя. Для мужского пола принимает значение MALE, для женского — FEMALE.
-
individual.rus_name — объект, содержащий русскоязычное ФИО предпринимателя, имеет следующие поля:
- rus_name.first_name — имя предпринимателя.
- rus_name.last_name — фамилия предпринимателя.
- rus_name.patronym — отчество предпринимателя.
- individual.lat_name — аналог individual.rus_name, но содержит ФИО, записанное латиницей. В основном заполняется для ИП, являющихся иностранным гражданами.
-
individual.citizenship — объект с информацией о гражданстве предпринимателя. Имеет следующие поля:
-
citizenship.type — тип гражданства, может принимать одно из следующих значений:
- Russian — российское гражданство.
- Foreign — иностранное гражданство.
- Stateless — предприниматель не имеет гражданства.
-
citizenship.country — объект с информацией о стране, гражданином которой является предприниматель. Содержит следующие дочерние поля:
- country.name — название страны.
- country.code — цифровой код страны по классификатору ОКСМ.
- country.sign — трёхбуквенный код страны по классификатору ОКСМ.
-
citizenship.type — тип гражданства, может принимать одно из следующих значений:
-
individual.type — объект с информацией о виде предпринимательства. Содержит следующие дочерние поля:
- type.code — код вида предпринимательства, согласно ЕГРИП.
- type.full — полное наименование вида предпринимательства.
- type.short — краткое наименование вида предпринимательства.
Результат запроса в формате XML
Ниже приведен пример ответа сервиса с результатом обработки сигнатуры c1027700132195b126498, которая соответствует юридическому лицу УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК. Результирующий XML-ответ получен с использованием опции output=xml|pretty, позволяющей выполнить «красивое» форматирование XML-текста. Для краткости записи, в примере отображены не все лицензии, имеющиеся у данной компании.
<ProcessFetchResult> <Company> <Main> <OGRN val="1027700132195"/> <INN val="7707083893"/> <KPP val="773601001"/> <PFR val="087705007215"/> <FSS val="770600307277061"/> <OKPO val="00032537"/> <OKOGU val="4100104"/> <OKFS val="41"/> <CreateDate val="1991-06-20"/> <State date="" state="Normal"/> <Name full="ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"" short="ПАО СБЕРБАНК"/> <BizScale val="Common"/> <StaffAmount val="0"/> </Main> <Opf class="ОКОПФ" code="12247" full="Публичные акционерные общества"/> <Address> <Canonic name_precise="1" nums_precise="1" pretty="117312, г Москва, ул Вавилова, дом 19" sign="77s924hдом:19"/> <Source val="ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"/> </Address> <RegFNS code="7736" date="2017-01-09" name="Инспекция Федеральной налоговой службы № 36 по г.Москве"/> <RegPFR code="087705" date="2010-09-03" name="Государственное учреждение - Главное Управление Пенсионного фонда РФ №4 Управление №1 по г. Москве и Московской области муниципальный район Гагаринский г.Москвы"/> <RegFSS code="7706" date="2001-01-04" name="Филиал №6 Государственного учреждения - Московского регионального отделения Фонда социального страхования Российской Федерации"/> <Manager> <Person first_name="ГЕРМАН" inn="770303580308" last_name="ГРЕФ" patronym="ОСКАРОВИЧ"/> <Position code="02" name="ПРЕЗИДЕНТ, ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ" type="Руководитель юридического лица"/> </Manager> <Capital sum="67760844800" type="УСТАВНЫЙ КАПИТАЛ"/> <Owner fract="" inn="7702235133" name="ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ" ogrn="0" sum="605693376" type="RussianCompany"/> <OKVED class="2014" code="64.19" name="Денежное посредничество прочее"/> <License licensor="Центральный банк Российской Федерации" number="045-02894-100000"> <Date begin="2015-10-06" end=""/> <Type val="Брокерская деятельность"/> </License> <License licensor="Центральный банк Российской Федерации" number="045-02768-000100"> <Date begin="2015-10-06" end=""/> <Type val="Депозитарная деятельность"/> </License> <License licensor="Центральный банк Российской Федерации" number="045-03004-010000"> <Date begin="2015-10-06" end=""/> <Type val="Дилерская деятельность"/> </License> <Branch type="0"> <KPP val="667102008"/> <Name full="УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК"/> <RegFNS code="6671" date="2005-03-22" name="Инспекция Федеральной налоговой службы по Ленинскому району г.Екатеринбурга"/> <Address country="rus"> <Canonic name_precise="1" nums_precise="1" pretty="620026, обл Свердловская, г Екатеринбург, ул Куйбышева, стр 67" sign="66c1s578uстр:67"/> <Source val="ГОРОД ЕКАТЕРИНБУРГ, УЛИЦА КУЙБЫШЕВА, ДОМ 67"/> </Address> </Branch> </Company> <Query val="c1027700132195b126498"/> </ProcessFetchResult>
Результатом получения описателя юридического лица является XML-документ со следующими дочерними элементами.
- Company – элемент, содержащий информацию о запрошенной компании. Если в запросе будет указана некорректная сигнатура, либо сигнатура не существующей компании, то в ответе сервиса данный элемент будет опущен.
- Query – исходный запрос, полученный и обработанный сервисом.
Ниже приведено детальное описание этих элементов.
XML-элемент Company: информация о компании из ЕГРЮЛ или ЕГРИП
Данный элемент аналогичен JSON-объекту company, он содержит следующие дочерние элементы:
- Main — основные сведения о компании, её полное и краткое название, ОГРН, ИНН, КПП и прочие реквизиты.
- Opf — справочные сведения об организационно-правовой форме юридического лица.
- Address — информация о почтовом адресе компании.
- Status — множественный элемент, соответствующий перечню статусов компании, присвоенных ей в рамках ЕГРЮЛ или ЕГРИП.
- Inheritor — множественный элемент, соответствующий перечню правопреемников компании.
- RegFNS — сведения о регистрации компании в ФНС.
- RegPFR — сведения о регистрации компании в Пенсионном фонде РФ.
- RegFSS — сведения о регистрации компании в Фонде социального страхования РФ.
- Manager — множественный элемент, соответствующий перечню руководителей компании.
- Capital — информация об уставном капитале юридического лица.
- Owner — множественный элемент, соответствующий перечню учредителей юридического лица.
- OKVED — множественный элемент, соответствующий перечню кодов видов экономической деятельности компании и их описателей по классификатору ОКВЭД.
- License — множественный элемент, соответствующий перечню лицензий, выданных компании на определённые виды деятельности.
- Branch — опциональный элемент, в рамках которого Ахантер возвращает информацию о филиале или представительстве компании, если сигнатура, полученная в запросе, соответствует именно филиалу, а не головному офису юридического лица. Данный элемент не возвращается, если запрашиваются сведения об индивидуальном предпринимателе.
- Individual — опциональный элемент, в рамках которого Ахантер возвращает детализированную информацию об индивидуальном предпринимателе (пол, гражданство и др.). Данный элемент не возвращается, если запрашиваются сведения о юридическом лице, а не о ИП.
XML-элемент Main: основные сведения и реквизиты компании
Элемент содержит основную информацию о компании, такую как реквизиты, название и текущее состояние (действующая или ликвидируемая). Пример элемента показан ниже.
<Main> <OGRN val="1027700132195"/> <INN val="7707083893"/> <KPP val="773601001"/> <PFR val="087705007215"/> <FSS val="770600307277061"/> <OKPO val="00032537"/> <OKOGU val="4100104"/> <OKFS val="41"/> <CreateDate val="1991-06-20"/> <State date="" state="Normal"/> <Name full="ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"" short="ПАО СБЕРБАНК"/> <BizScale val="Common"/> <StaffAmount val="0"/> </Main>
Элемент содержит следующие дочерние XML-элементы. Большинство этих элементов содержат соответствующие значения в рамках атрибута val.
-
Name — сведения о названии компании. Представлены в рамках следующих атрибутов:
- full — полное название компании в том виде, в котором оно зарегистрировано в ЕГРЮЛ или ЕГРИП.
- short — краткое название компании.
- OGRN — основной государственный регистрационный номер юридического лица — ОГРН, либо основной государственный регистрационный номер индивидуального предпринимателя — ОГРНИП.
- INN — ИНН — индивидуальный номер налогоплательщика, присвоенный компании при регистрации в ФНС.
- KPP — КПП юридического лица.
- PFR — регистрационный номер компании в ПФР.
- FSS — регистрационный номер компании в ФСС.
- CreateDate — дата регистрации компании в формате XML Schema date.
-
State — содержит текущее состояние компании и дату перехода компании в данное состояние. Эта информация передаётся в следующих атрибутах:
- state — состояние компании, может принимать одно из предопределённых значений, описанных для JSON-элемента company.state.
- date — дата перехода компании в состояние state, может быть пустой строкой, если текущее состояние компании Normal.
-
BizScale — содержит категорию, отражающую размер компании. Эта информация передаётся с помощью атрибута val, который может принимать следующие значения:
- Micro — категория микропредприятий (обычно численность сотрудников — до 15 человек).
- Small — категория малых предприятий (обычно численность сотрудников — до 100 человек).
- Medium — категория средних предприятий (обычно численность сотрудников — до 250 человек).
- Common — компании, не зарегистрированные в реестре субъектов малого и среднего предпринимательства.
- StaffAmount — среднесписочная численность сотрудников компании, значение 0 указывает на то, что сведения о численности сотрудников данной компании отсутствуют в соответствующем государственном реестре.
XML-элемент Opf: организационно-правовая форма юр. лица
Данный элемент сообщает информацию об организационно-правовой форме компании по классификатору ОКОПФ/КОПФ. Для индивидуального предпринимателя данный элемент не возвращается, т.к. сведения данного типа не применимы к ИП. Пример элемента показан ниже.
<Opf class="ОКОПФ" code="12247" full="Публичные акционерные общества"/>
Элемент содержит следующие атрибуты, с помощью которых передаётся информация об организационно-правовой форме.
- full — полное наименование организационно-правовой формы компании, в том виде, в котором оно представлено в классификаторе, например, «Публичные акционерные общества».
- code — код организационно-правовой формы по соответствующему классификатору.
- class — название классификатора организационно-правовых форм, в рамках которого определён код code. Может принимать значения ОКОПФ и КОПФ, в зависимости от того, по какому классификатору внесены сведения о компании в ЕГРЮЛ. Может быть пустым, если ОПФ компании введена в ЕГРЮЛ без использования классификатора.
XML-элемент Address: почтовый адрес компании
Элемент содержит адрес компании в том виде, в котором он указан в ЕГРЮЛ или ЕГРИП, а также адрес компании в стандартизованном виде, который получен при обработке исходного адреса функцией стандартизации Ахантера. Пример элемента показан ниже.
<Address> <Canonic name_precise="1" nums_precise="1" pretty="117312, г Москва, ул Вавилова, дом 19" sign="77s924hдом:19"/> <Source val="ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"/> </Address>
Объект включает в себя следующие дочерние элементы.
- Source — исходный неструктурированный адрес компании, извлечённый из ЕГРЮЛ. Эта информация передаётся с помощью атрибута val данного элемента.
-
Canonic — адрес компании, обработанный алгоритмами стандартизации Ахантера и сопутствующие такой обработке служебные сведения. Эта информация передаётся с помощью следующих атрибутов данного элемента:
- name_precise — если 1, то в ходе стандартизации нечисловых адресных полей исходного адреса не было обнаружено ошибок и неточностей.
- nums_precise — если 1, то номер дома, корпуса и строения исходного адреса успешно обработаны и проверены по ФИАС.
- sign — сигнатура стандартизованного адреса, которую можно передать Ахантеру в команде fetch/address, чтобы получить полные сведения об адресе, такие как, коды по КЛАДР, ФИАС, ОКАТО и ОКТМО, географические координаты и др.
-
Country — необязательный элемент с информацией о стране, которой принадлежит данный адрес. Эти сведения передаются с помощью следующих атрибутов данного элемента:
- name — название страны.
- code — цифровой код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
- sign — трёхбуквенный код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
XML-элемент Status: статус компании по ЕГРЮЛ или ЕГРИП
Это множественный элемент, каждый экземпляр которого, позволяет отвечать на такие вопросы как, является ли компания действующей, находится ли она в процессе реорганизации или ликвидации. Если компания находится в нормальном действующем состоянии, то элементы Status не будут включаться в ответ сервиса.
Каждый экземпляр элемента Status описывает какой-то один статус компании, согласно справочнику СЮЛСТ для юридического лица, и согласно справочнику СИПСТ, для индивидуального предпринимателя. В общем случае компании может быть присвоено несколько статусов. Пример элемента показан ниже.
<Status code="101" date="2019-01-16" name="Находится в стадии ликвидации"/>
Информация о статусе передаётся с помощью следующих атрибутов данного элемента.
- name — текстовое описание статуса компании.
- code — код статуса по справочнику СЮЛСТ или СИПСТ.
- date — дата присвоения компании данного статуса в формате XML-Schema date.
XML-элемент Inheritor: правопреемник компании по ЕГРЮЛ
Это множественный элемент, каждый экземпляр которого представляет информацию об одном правопреемнике юридического лица. У компании может быть несколько правопреемников, в этом случае XML-ответ сервиса будет содержать несколько элементов данного типа.
Обычно правопреемники появляются в результате ликвидации компании в форме реорганизации, однако, возможно наличие правопреемников и у действующего юридического лица. Пример элемента показан ниже.
<Inheritor name="ООО ПОКРОВКА" ogrn="1197746755898" inn="7714456779" sign="c1197746755898" state="0"/>
Информация о правопреемнике передаётся с помощью следующих атрибутов данного элемента.
- inn — ИНН правопреемника.
- name — краткое наименование компании правопреемника.
- ogrn — ОГРН правопреемника.
- sign — уникальный идентификатор-сигнатура, позволяющая получить полные сведения о данном правопреемнике с помощью запроса fetch/company.
- state — число, отражающее текущее состояние правопреемника, значение 0 указывает на то, что правопреемник является действующим.
XML-элемент RegFNS: сведения о постановке на учёт в ФНС
Данный элемент содержит дату постановки компании на учёт в ФНС, а также код и название соответствующей налоговой инспекции. Пример элемента показан ниже.
<RegFNS code="7719" date="2017-01-06" name="Инспекция Федеральной налоговой службы №19 по г.Москве"/>
Элемент включает в себя следующие атрибуты.
- date — дата постановки на учёт в ФНС.
- code — код по справочнику СОУН соответствующей налоговой инспекции.
- name — название соответствующей налоговой инспекции.
XML-элемент RegPFR: сведения о регистрации в ПФР
Данный элемент содержит дату регистрации компании в ПФР, а также код и название соответствующего территориального органа ПФР. Пример элемента показан ниже.
<RegPFR code="087705" date="2010-09-03" name="Государственное учреждение - Главное Управление Пенсионного фонда РФ №4 Управление №1 по г. Москве и Московской области муниципальный район Гагаринский г.Москвы"/>
Элемент включает в себя следующие атрибуты.
- date — дата регистрации в ПФР.
- code — код по справочнику СТОПФ соответствующего территориального органа ПФР.
- name — название соответствующего территориального органа ПФР.
XML-элемент RegFSS: сведения о регистрации в ФСС
Данный элемент содержит дату регистрации компании в Фонде социального страхования РФ, а также код и название соответствующего исполнительного органа ФСС. Пример элемента показан ниже.
<RegFSS code="7706" date="2001-01-04" name="Филиал №6 Государственного учреждения - Московского регионального отделения Фонда социального страхования Российской Федерации"/>
Элемент включает в себя следующие атрибуты.
- date — дата регистрации в ФСС.
- code — код по справочнику СТОФСС соответствующего исполнительного органа ФСС.
- name — название соответствующего исполнительного органа ФСС.
XML-элемент Manager: список руководителей компании
Это множественный элемент, каждый экземпляр которого содержит информацию о руководителе компании. Чаще всего в ответе сервиса будет присутствовать только один элемент данного типа. Для компании, являющейся индивидуальным предпринимателем, данный массив не выводится, поскольку у ИП руководителем является сам предприниматель. Пример элемента показан ниже.
<Manager> <Person first_name="ГЕРМАН" inn="770303580308" last_name="ГРЕФ" patronym="ОСКАРОВИЧ"/> <Position code="02" name="ПРЕЗИДЕНТ, ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ" type="Руководитель юридического лица"/> </Manager>
Элемент Manager содержит следующие дочерние XML-элементы.
-
Person — с помощью данного элемента передаётся информация о самой персоне, занимающей должность руководителя. Данный элемент содержит следующие атрибуты.
- first_name — имя руководителя.
- patronym — отчество руководителя.
- last_name — фамилия руководителя.
- inn — ИНН руководителя.
-
Position — данный элемент сообщает информацию о должности руководителя. Элемент содержит следующие атрибуты.
- position_code — код вида должности, которую занимает руководитель компании по справочнику СКФЛЮЛ.
- position_type — название вида должности.
- position_name — название должности, которую занимает руководитель.
- disqual — необязательный атрибут. Значение 1 атрибута указывает на то, что данная персона имеет запрет (дисквалифицию) на то, чтобы занимать руководящие должности.
XML-элемент Capital: уставный капитал компании
Элемент Capital содержит сведения о размере и типе уставного капитала юридического лица. Для индивидуального предпринимателя данный элемент не возвращается, т.к. сведения данного типа не применимы к ИП. Пример элемента показан ниже.
<Capital sum="411461504" type="УСТАВНЫЙ КАПИТАЛ"/>
Элемент включает в себя следующие атрибуты.
- sum — размер уставного капитала в рублях.
- type — наименование вида уставного капитала.
XML-элемент Owner: учредитель юридического лица
Это множественный элемент, каждый экземпляр которого содержит информацию о лице (физическом или юридическом), которое, согласно ЕГРЮЛ, является учредителем компании. Для индивидуального предпринимателя данный объект не возвращается, т.к. сведения данного типа не применимы к ИП. Ниже показан пример данного элемента.
<Owner fract="" inn="7702235133" name="ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ" ogrn="0" sum="605693376" type="RussianCompany"/>
Каждый элемент Owner содержит следующие атрибуты.
- name — название учредителя, для физического лица будет содержать его ФИО, для юридического лица — полное или краткое название, согласно данным ЕГРЮЛ.
- inn — ИНН учредителя.
- ogrn — ОГРН учредителя, если тот является юридическим лицом. Если учредитель является физическим лицом, то данный элемент сервисом не возвращается.
-
type — тип учредителя, может принимать одно из следующих значений:
- Person — учредитель является физическим лицом.
- RussianCompany — учредитель является российской компанией (организацией).
- ForeignCompany — учредитель является иностранной компанией.
- Russia — учредителем является Российская Федерация или её субъект.
- Pif — учредитель представляет собой паевый инвестиционный фонд.
- Self — владельцем доли в уставном капитале компании является сама компания.
- InvestPartnership — доля компании включена в состав общего имущества участников договора инвестиционного товарищества.
- sum — размер в рублях доли в уставном капитале, принадлежащей данному учредителю.
-
fract — величина доли в уставном капитале, принадлежащей данному учредителю, может быть записана одним из следующих способов:
- в виде процента, например, «50%«.
- в виде простой дроби, например, «1/3«.
- в виде десятичной дроби, например, «0.5«.
XML-элемент OKVED: код экономической деятельности ОКВЭД
Это множественный элемент, каждый экземпляр которого содержит код вида деятельности компании по классификатору ОКВЭД, а также его расшифровку. Пример множества таких элементов показан ниже.
<OKVED class="2014" code="62.01" name="Разработка компьютерного программного обеспечения"/> <OKVED class="2014" code="62.02" name="Деятельность консультативная и работы в области компьютерных технологий"/> <OKVED class="2014" code="63.11" name="Деятельность по обработке данных, предоставление услуг по размещению информации и связанная с этим деятельность"/>
Каждый элемент OKVED содержит следующие атрибуты.
- code — код ОКВЭД, соответствующий данному виду деятельности.
- class — версия классификатора ОКВЭД, в рамках которого компании был присвоен данный код. Значение 2001 указывает на классификатор ОКВЭД ОК 029-2001. Значение 2014 — на классификатор ОКВЭД ОК 029-2014.
- name — наименование вида деятельности.
XML-элемент License: лицензии компании
Это множественный элемент, каждый экземпляр которого содержит сведения о выданных данной компании лицензиях. Если у компании нет лицензируемых видов деятельности, то данные элементы не будет возвращаться сервисом. Пример множества таких элементов показан ниже.
<License licensor="Федеральное агентство по строительству и жилищно-коммунальному хозяйству" number="ГС-4-02-02-26-0-0276096959-006640-1"> <Date begin="2006-02-27" end=""/> <Location val="УФА ГОРОД,ГАГАРИНА УЛИЦА,6"/> <Type val="Проектирование зданий и сооружений, за исключением сооружений сезонного или вспомогательного назначения"/> </License> <License licensor="Федеральное агентство по строительству и жилищно-коммунальному хозяйству" number="ГС-4-02-02-28-0-0276096959-007849-1"> <Date begin="2006-12-25" end=""/> <Location val="УФА ГОРОД,ГАГАРИНА УЛИЦА,6"/> <Type val="Инженерные изыскания для строительства зданий и сооружений, за исключением сооружений сезонного или вспомогательного назначения"/> </License>
Каждый элемент License содержит следующие атрибуты.
- number — номер лицензии.
- licensor — наименование органа, выдавшего лицензию.
Кроме атрибутов элемент License содержит дочерние XML-элементы.
-
Date — срок, на который выдана лицензия. Эта информация передаётся с помощью следующих атрибутов:
- begin_date — дата начала действия лицензии.
- end_date — дата прекращения действия лицензии. Может быть пустой строкой, если лицензия не имеет срока прекращения.
-
Suspend — информация о приостановке лицензии. Содержит следующие атрибуты:
- date — дата приостановки действия лицензии. Возвращается сервисом только в случае, если в отношении данной лицензии было принято соответствующее решение компетентным органом.
- licensor — наименование органа, принявшего решение о приостановке действия лицензии. Сервис не возвращает данный атрибут, если в отношении лицензии не принималось решений о её приостановке.
- Location — необязательный множественный элемент. Содержит текстовое описание территории или адреса, в пределах которого действует лицензия. Эта информация передаётся с помощью атрибута val данного элемента.
- Type — множественный элемент, содержащий наименование вида деятельности компании, на которое распространяется данная лицензия. Эта информация передаётся с помощью атрибута val данного элемента.
XML-элемент Branch: филиал или представительство компании
Элемент содержит информацию о филиале или представительстве компании, если сигнатура, полученная в рамках API-запроса, соответствует не головному офису компании, а указывает более детально на конкретный её филиал или представительство. Если сигнатура указывает на головной офис компании, то элемент Branch сервисом не возвращается. Также данный элемент не возвращается, если запрошены данные не по юридическому лицу, а по индивидуальному предпринимателю, поскольку для ИП не предусмотрено наличие филиалов или представительств. Пример такого элемента показан ниже.
<Branch type="0"> <KPP val="667102008"/> <Name full="УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК"/> <RegFNS code="6671" date="2005-03-22" name="Инспекция Федеральной налоговой службы по Ленинскому району г.Екатеринбурга"/> <Address country="rus"> <Canonic name_precise="1" nums_precise="1" pretty="620026, обл Свердловская, г Екатеринбург, ул Куйбышева, стр 67" sign="66c1s578uстр:67"/> <Source val="ГОРОД ЕКАТЕРИНБУРГ, УЛИЦА КУЙБЫШЕВА, ДОМ 67"/> </Address> </Branch>
Данный XML-элемент содержит следующие атрибуты:
- type — тип объекта. Принимает значение 1, если данный элемент соответствует представительству компании. Принимает значение 0, если элемент содержит сведения о филиале.
Данный XML-элемент также содержит следующие дочерние элементы:
-
Name — сведения о наименовании филиала. Содержит следующие атрибуты:
- full — полное наименование филиала.
- KPP — КПП филиал, может быть пустым, если этих сведений в настоящий момент нет в ЕГРЮЛ. Информация о КПП передаётся с помощью атрибута val.
- RegFNS — XML-элемент, содержащий сведения о постановке на учёт данного филиала в ФНС. Состав данного объекта идентичен составу XML-элемента RegFNS в рамках XML-элемента Company.
- Address — XML-элемент, содержащий сведения об адресе филиала. Структура данного элемента идентична структуре элемента Address в рамках XML-элемента Company.
XML-элемент Individual: сведения об ИП
Данный элемент возвращается сервисом, если запрошенная компания является индивидуальным предпринимателем. В этом случае данный объект содержит дополнительные сведения об ИП. Пример такого элемента показан ниже.
<Individual gender="FEMALE"> <RusName first_name="АЙТАН" last_name="ГУСЕЙНОВА" patronym="РОВШАН КЫЗЫ"/> <LatName first_name="AYTAN" last_name="HUSEYNOVA" patronym=""/> <Type code="2" full="Глава крестьянского (фермерского) хозяйства" short="КФХ"/> <Citizenship type="Foreign"> <Country code="031" name="АЗЕРБАЙДЖАН" sign=""/> </Citizenship> </Individual>
Данный XML-элемент содержит следующие атрибуты:
- gender — строка, указывающая на пол предпринимателя. Для мужского пола принимает значение MALE, для женского — FEMALE.
Данный XML-элемент также содержит следующие дочерние элементы:
-
RusName — элемент, содержащий русскоязычное ФИО предпринимателя, имеет следующие атрибуты:
- first_name — имя предпринимателя.
- last_name — фамилия предпринимателя.
- patronym — отчество предпринимателя.
- LatName — аналог RusName, но содержит ФИО, записанное латиницей. В основном заполняется для ИП, являющихся иностранным гражданами.
-
Citizenship — элемент с информацией о гражданстве предпринимателя. Имеет следующие атрибуты и дочерние элементы:
- type — атрибут, указывает на тип гражданства, может принимать одно из следующих значений: Russian — российское гражданство, Foreign — иностранное гражданство, Stateless — предприниматель не имеет гражданства.
-
Country — элемент с информацией о стране, гражданином которой является предприниматель. Содержит следующие атрибуты:
- name — название страны.
- code — цифровой код страны по классификатору ОКСМ.
- sign — трёхбуквенный код страны по классификатору ОКСМ.
-
Type — элемент с информацией о виде предпринимательства. Содержит следующие атрибуты:
- code — код вида предпринимательства, согласно ЕГРИП.
- full — полное наименование вида предпринимательства.
- short — краткое наименование вида предпринимательства.
{
"suggestions": [
{
"value": "ООО "СТЕКЛОКОН"",
"unrestricted_value": "ООО "СТЕКЛОКОН"",
"data": {
"kpp": "772501001",
"capital": null,
"management": {
"name": "Овсепян Хачатур Меликович",
"post": "Директор"
},
"branch_type": "MAIN",
"branch_count": 0,
"source": null,
"qc": null,
"hid": "85db648b39e183fc974a9c5711475cf4ace02101bb28695fb7b55d7c25c5c6eb",
"type": "LEGAL",
"state": {
"status": "ACTIVE",
"actuality_date": 1488326400000,
"registration_date": 728179200000,
"liquidation_date": null
},
"opf": {
"type": null,
"code": "12300",
"full": "Общество с ограниченной ответственностью",
"short": "ООО"
},
"name": {
"full_with_opf": "ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "СТЕКЛОКОН"",
"short_with_opf": "ООО "СТЕКЛОКОН"",
"latin": null,
"full": "СТЕКЛОКОН",
"short": "СТЕКЛОКОН"
},
"inn": "7725002343",
"ogrn": "1027739468877",
"okpo": null,
"okved": null,
"okveds": null,
"authorities": null,
"documents": null,
"licenses": null,
"address": {
"value": "г Москва, Даниловская наб, д 2 к 4",
"unrestricted_value": "г Москва, Даниловский р-н, Даниловская наб, д 2 к 4",
"data": {
"postal_code": "115114",
"country": "Россия",
"region_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"region_kladr_id": "7700000000000",
"region_with_type": "г Москва",
"region_type": "г",
"region_type_full": "город",
"region": "Москва",
"area_fias_id": null,
"area_kladr_id": null,
"area_with_type": null,
"area_type": null,
"area_type_full": null,
"area": null,
"city_fias_id": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5",
"city_kladr_id": "7700000000000",
"city_with_type": "г Москва",
"city_type": "г",
"city_type_full": "город",
"city": "Москва",
"city_area": "Южный",
"city_district_fias_id": null,
"city_district_kladr_id": null,
"city_district_with_type": "Даниловский р-н",
"city_district_type": "р-н",
"city_district_type_full": "район",
"city_district": "Даниловский",
"settlement_fias_id": null,
"settlement_kladr_id": null,
"settlement_with_type": null,
"settlement_type": null,
"settlement_type_full": null,
"settlement": null,
"street_fias_id": "fb4d2fdd-0b4a-4e8d-b8cd-e7a28cfd5798",
"street_kladr_id": "77000000000115400",
"street_with_type": "Даниловская наб",
"street_type": "наб",
"street_type_full": "набережная",
"street": "Даниловская",
"house_fias_id": "cb4d5826-4621-4eca-b60b-5957eaf6c9aa",
"house_kladr_id": "7700000000011540004",
"house_type": "д",
"house_type_full": "дом",
"house": "2",
"block_type": "к",
"block_type_full": "корпус",
"block": "4",
"flat_type": null,
"flat_type_full": null,
"flat": null,
"flat_area": null,
"square_meter_price": "177863",
"flat_price": null,
"postal_box": null,
"fias_id": "cb4d5826-4621-4eca-b60b-5957eaf6c9aa",
"fias_level": "8",
"kladr_id": "7700000000011540004",
"capital_marker": "0",
"okato": "45296559000",
"oktmo": "45914000",
"tax_office": "7725",
"tax_office_legal": null,
"timezone": "UTC+3",
"geo_lat": "55.7083638",
"geo_lon": "37.6421572",
"beltway_hit": "IN_MKAD",
"beltway_distance": null,
"qc_geo": "0",
"qc_complete": "5",
"qc_house": "2",
"history_values": null,
"unparsed_parts": null,
"source": "114115 ГОРОД МОСКВА, НАБЕРЕЖНАЯ ДАНИЛОВСКАЯ, дом 2 корп 4",
"qc": "0"
}
},
"phones": null,
"emails": null,
"ogrn_date": 1035763200000,
"okved_type": null
}
}
]
}
Если вы работаете с юридическими лицами, то вам постоянно приходится заполнять реквизиты контрагентов. И скорей всего мечтаете о волшебной кнопочке, которая заполнит все за вас. В данной статье я расскажу как реализовать автоматическое заполнение реквизитов по ИНН или любым другим данным организации.
Есть замечательный сервис DaData.ru, который умеет не только исправлять контактные данные типа ФИО, адреса, телефона и т.п., удалять дубликаты, но и ищет реквизиты организаций и ИП.
Данный сервис предоставляет доступ к API и дает бесплатно до 10 тыс. запросов в день по API-ключу. Этим мы и воспользуемся, чтобы реализовать автоматическое заполнение реквизитов по ИНН.
Получение API-ключа на Dadata.ru
Для начала необходимо зарегистрироваться на сервисе DaData. После регистрации в личном кабинете можно увидеть ваш API-ключ, который будет использоваться для запросов к сервису. А еще вам будет бонус 10 рублей на счет за использование API.
Ну а теперь можем приступить к написанию скрипта для отправки запроса и обработки ответа. Напоминаю, что писать код мы будем на Javascript.
Javascript для получения и заполнение реквизитов по ИНН
Создаем форму, в которой будет происходить заполнение реквизитов:
<div class="well well-sm col-md-6"> <div class="view"> </div> <div class="view"><p>Пожалуйста, заполняйте поля как можно более подробней. Это поможет нам быстрее и точнее отреагировать на ваше сообщение.</p></div> <form action="/ method="POST"> <div class="form-group"> <label for="company">Название компании* (реквизиты заполнятся автоматически):</label> <input class="form-control" type="text" name="company" id="company" value="" placeholder="Введите название, адрес, ИНН или ОГРН" required /> </div> <div class="form-group"> <label for="inn">ИНН:</label> <input class="form-control" type="text" name="inn" id="inn" value="" placeholder="Например, 1111111111" readonly required /> </div> <div class="form-group"> <label for="kpp">КПП:</label> <input class="form-control" type="text" name="kpp" id="kpp" value="" placeholder="Например, 111111111" readonly /> </div> <div class="form-group"> <label for="ogrn">ОГРН:</label> <input class="form-control" type="text" name="ogrn" id="ogrn" value="" placeholder="Например, 1111111111111" readonly required /> </div> <div class="form-group"> <label for="address">Адрес:</label> <input class="form-control" type="text" name="address" id="address" value="" placeholder="Невский пр., 1" required /> </div> <div class="form-group"> <label for="tel">Телефон для связи*:</label> <input class="form-control" type="text" name="tel" id="tel" value="" placeholder="Например, +7 812 111 1111" required /> </div> <div class="form-group"> <label for="email">Ваш email*:</label> <input class="form-control" type="text" name="email" id="email" value="" placeholder="Например, [email protected]" required /> </div> <div class="form-group"> <label for="url">Сайт:</label> <input class="form-control" type="text" name="url" id="url" value="" placeholder="Например, pogrommist.ru" /> </div> <div class="form-group"> <label for="comment">Дополнительные сведения:</label> <textarea class="form-control" type="text" name="comment" id="comment" rows="4" /></textarea> </div> <div class="form-group"> <div class="g-recaptcha" data-sitekey="тут ключ для капчи"></div> </div> <div class="form-group"> <button type="submit" name="addevent" class="btn btn-default">Отправить</button> </div> </form> </div>
Выглядеть наша форма будет примерно так:
Также нам понадобятся дополнительные стили и библиотеки:
<link href="https://cdn.jsdelivr.net/jquery.suggestions/17.2/css/suggestions.css" type="text/css" rel="stylesheet" /> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery/1.10.2/jquery.min.js"></script> <!--[if lt IE 10]> <script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/jquery-ajaxtransport-xdomainrequest/1.0.1/jquery.xdomainrequest.min.js"></script> <![endif]--> <script type="text/javascript" src="https://cdn.jsdelivr.net/jquery.suggestions/17.2/js/jquery.suggestions.min.js"></script>
Теперь пишем код, который будет отправлять запросы по мере заполнения первой графы и обрабатывать ответы.
<script>
function join(arr) {
var separator = arguments.length > 1 ? arguments[1] : ", ";
return arr.filter(function(n){return n}).join(separator);
}
function typeDescription(type) {
var TYPES = {
'INDIVIDUAL': 'Индивидуальный предприниматель',
'LEGAL': 'Организация'
}
return TYPES[type];
}
function showSuggestion(suggestion) {
console.log(suggestion);
var data = suggestion.data;
if (!data)
return;
$("#type").text(
typeDescription(data.type) + " (" + data.type + ")"
);
if (data.name)
//$("#company").val(join([data.opf && data.opf.short || "", data.name.short || data.name.full], " "));
$("#inn").val(data.inn);
$("#kpp").val(data.kpp);
$("#ogrn").val(data.ogrn);
if (data.address)
$("#address").val(data.address.value);
}
$("#company").suggestions({
token: "Здесь должен быть ваш API-ключ",
type: "PARTY",
count: 5,
onSelect: showSuggestion
});
</script>
При заполнении первой графы будут предложены 5 подсказок, за это отвечает переменная «count». Максимально можно выводить до 20 подсказок. При выборе одной из них в нашем варианте будут заполняться поля «Название компании», «ИНН», «ОГРН» и «адрес».
Какие данные еще можно получить?
| Название | Описание |
|---|---|
| value | Наименование компании одной строкой (как показывается в списке подсказок) |
| unrestricted_value | Наименование компании одной строкой (полное) |
| data.address.value | Адрес одной строкой:
Стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ. |
| data.address.unrestricted_value | Адрес одной строкой (полный, от региона) Стандартизован, поэтому может отличаться от записанного в ЕГРЮЛ. |
| data.address.data | Гранулярный адрес. Может отсутствовать |
| data.address.data.source | Адрес одной строкой как в ЕГРЮЛ |
| data.branch_count | Количество филиалов |
| data.branch_type | Тип подразделения
MAIN — головная организация BRANCH — филиал |
| data.inn | ИНН |
| data.kpp | КПП |
| data.ogrn | ОГРН |
| data.ogrn_date | Дата выдачи ОГРН |
| data.hid | Уникальный идентификатор в Дадате |
| data.management.name | ФИО руководителя |
| data.management.post | Должность руководителя |
| data.name.full_with_opf | Полное наименование с ОПФ |
| data.name.short_with_opf | Краткое наименование с ОПФ |
| data.name.latin | Наименование на латинице |
| data.name.full | Полное наименование |
| data.name.short | Краткое наименование |
| data.okpo | Код ОКПО (не заполняется) |
| data.okved | Код ОКВЭД |
| data.okved_type | Версия справочника ОКВЭД (2001 или 2014) |
| data.okveds | Коды ОКВЭД дополнительных видов деятельности (не заполняется) |
| data.opf.code | Код ОКОПФ |
| data.opf.full | Полное название ОПФ |
| data.opf.short | Краткое название ОПФ |
| data.opf.type | Не используется |
| data.state.actuality_date | Дата актуальности сведений |
| data.state.registration_date | Дата регистрации |
| data.state.liquidation_date | Дата ликвидации |
| data.state.status | Статус организации
ACTIVE — действующая LIQUIDATING — ликвидируется LIQUIDATED — ликвидирована |
| data.type | Тип организации
LEGAL — юридическое лицо INDIVIDUAL — индивидуальный предприниматель |
| data.capital | Уставной капитал, для организаций (не заполняется) |
| data.citizenship | Гражданство, для ИП (не заполняется) |
| data.authorities | Руководители, доверенные лица, управляющие организации (не заполняется) |
| data.documents | Документы (не заполняется) |
| data.licenses | Лицензии (не заполняется) |
| data.phones | Телефоны (не заполняется) |
| data.emails | Адреса эл. почты (не заполняется) |
| data.source | Не используется |
| data.qc | Не используется |
Данный сервис можно использовать для заполнения реквизитов контрагентов в 1С. Возможно в будущем я опишу как это реализовать в 1С:Бухгалтерия 3.0.
Параметры
| наименование | описание | требование |
|---|---|---|
| id | id документа, предварительно можно получить из результатов метода search. По факту id должен быть ИНН | обязательно |
| bik | Банковский идентификационный код (БИК) | обязательно |
| rs | Рассчетный счет компании | опционально |
Пример:
Запрос:
https://zachestnyibiznesapi.ru/paid/data/requisites?id=7719418209&bik=044525555&api_key=YOUR_API_KEY
Метод имеет возможность поиска только по ИНН.
Ответ:
JSON (и только JSON)
{
"status":"200",
"message":"Запрос выполнен успешно",
"body":{
"Юридический адрес":"105187, г Москва, улица Кирпичная, дом 32 КОРПУС 24",
"Фактический адрес":"105187, г Москва, улица Кирпичная, дом 32 КОРПУС 24",
"ОГРН":"1157746608645",
"ИНН":"7719418209",
"КПП":"771901001",
"ОКПО":"18980223",
"ОКВЭД":"62.01",
"БИК":"044525555",
"Корреспондентский счет":"30101810400000000555",
"Наименование банка":"ПАО "ПРОМСВЯЗЬБАНК"",
"Руководитель":"Русанов Сергей Владимирович",
"Должность":"Генеральный Директор"
}
}




