Получить реквизиты по инн api

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 Дата внесения информации в ЕГРЮЛ об адресе
E-mail 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 Номер контактного телефона
E-mail 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 (начальная и конечная даты, разделенные знаком ~ «тильда»)
E-mail 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 Да, в следующих случаях:

  • низкая налоговая нагрузка — налоговая нагрузка меньше 90% от среднеотраслевой
  • расходы больше доходов
  • низкая рентабельность — рентабельность меньше 90% от среднеотраслевой
  • доходы близки к лимиту по УСН (140-150 млн. руб.)
  • среднемесячная зарплата менее 15 тыс.руб
НедоимкаНалог 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
Команда для управления списком или отображения результатов мониторинга:

  • add — добавление организации в список для мониторинга. Используйте параметр req для перечисления ИНН или ОГРН организаций через запятую.
  • del — удаление из списка мониторинга. Используйте параметр req для перечисления удаляемых ИНН или ОГРН организаций через запятую.
  • list — просмотр списка организаций на мониторинге (выдает первые 1000 организаций, параметр page=2 выдает следующие 1000 и т.д.)
  • chbo — узнать дату актализации отчетности у компаний на заданный год. Используйте параметр year для задания года требуемой отчетности. Будут выведены все организации, поставленные на мониторинг, у которых присутствует бухгалтерская отчетность на заданный год.
  • chd — проверка изменений у компаний на заданную дату (т.е. выдает результат мониторинга). Используйте параметр dat для задания даты, type — для вывода только определенных типов изменений. Дата должна быть больше даты постановки организации на мониторинг.
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
Вид документа, удостоверяющего личность:

  • 01 — Паспорт гражданина СССР
  • 03 — Свидетельство о рождении
  • 10 — Паспорт иностранного гражданина
  • 12 — Вид на жительство в Российской Федерации
  • 15 — Разрешение на временное проживание в Российской Федерации
  • 19 — Свидетельство о предоставлении временного убежища на территории Российской Федерации
  • 21 — Паспорт гражданина Российской Федерации
  • 23 — Свидетельство о рождении, выданное уполномоченным органом иностранного государства

Необязательное поле (по умолчанию — код 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 Орган, выдавший лицензию
e-mail 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(), &params)
}

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 — трёхбуквенный код страны по классификатору ОКСМ.
  • 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="ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО 
                  &quot;СБЕРБАНК РОССИИ&quot;" 
            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="ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО 
              &quot;СБЕРБАНК РОССИИ&quot;" 
        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.

Dadata личный кабинет API ключ

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

Javascript для получения и заполнение реквизитов по ИНН

Создаем форму, в которой будет происходить заполнение реквизитов:

<div class="well well-sm col-md-6">
  <div class="view">&nbsp;</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",
                    "Наименование банка":"ПАО "ПРОМСВЯЗЬБАНК"",
                    "Руководитель":"Русанов Сергей Владимирович",
                    "Должность":"Генеральный Директор"
                }
            }
            

Понравилась статья? Поделить с друзьями:

Вот еще несколько интересных статей нашего сайта:

  • Монгольские компании в москве
  • Мондиал бизнес консорциум ооо
  • Монетка реквизиты организации
  • Монополия на большую компанию
  • Монопольные компании в россии

  • 0 0 голоса
    Рейтинг статьи
    Подписаться
    Уведомить о
    guest

    0 комментариев
    Старые
    Новые Популярные
    Межтекстовые Отзывы
    Посмотреть все комментарии