Получение информации о компании из ЕГРЮЛ и ЕГРИП

Команда fetch/company позволяет получить о компании дополнительную информацию, имеющуюся в ЕГРЮЛ или ЕГРИП. К такой информации, например, относятся сведения об учредителях и их долях в уставном капитале, полный размер уставного капитала, сведения о руководителях, данные о регистрации в ФНС, ПФР и ФСС, коды ОКВЭД, а также информация о лицензиях, имеющихся у компании. Кроме этого, можно выяснить, действует ли в настоящий момент компания, или находится в процессе ликвидации.

Запросить эти сведения можно, если компания ранее была найдена в режиме подсказок посредством API-команды suggest/company, либо через наш JavaScript модуль подсказок ahunter_suggest.js. В таких случаях сервис возвращает уникальную сигнатуру компании sign, по которой можно запросить дополнительную информацию о ней с помощью команды fetch/company.

Также данная команда может использоваться независимо от подсказок, если просто требуется получить сведения о компании по её ОГРН или ИНН.

Использование в связке с подсказками по ЕГРЮЛ и ЕГРИП

Использование данной команды совместно с подсказками подразумевает следующий сценарий. Пользователь вводит информацию о юридическом лице или индивидуальном предпринимателе в некоторой форме в вашем приложении или на сайте. В процессе этого ввода ему предлагаются подсказки, из которых он может выбрать подходящую компанию.

Каждая подсказка, возвращаемая сервисом, кроме непосредственно подсказываемой компании снабжается уникальной сигнатурой sign, которая не отображается пользователю, но при этом доступна вашему сайту или приложению. Когда пользователь выбирает подходящую подсказку, приложение или сайт может запоминать соответствующую данной подсказке сигнатуру и использовать её в команде fetch/company для получения от сервиса полного комплекта сведений о выбранном юридическом лице или индивидуальном предпринимателе.

Приведённая ниже форма демонстрирует данный сценарий.

Для отображения подсказок здесь используется наш 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, которая соответствует юридическому лицу ПАО СБЕРБАНК. При этом используется минимальное количество параметров и опций.

В данном запросе используются следующие параметры.

• 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=cfulladdr - опция сообщает сервису, чтобы он вернул стандартизованную версию адреса юридического лица или индивидуального предпринимателя, включая коды этого адреса по справочникам, географические координаты, часовую зону и прочие сведения, которые сервис обычно возвращает при стандартизации почтовых адресов и при получении адреса с помощью команды fetch/address.
• output=pretty - опция требует, чтобы сервис выполнил "красивое" форматирование возвращаемого JSON или XML текста, расставив в нем переносы строк и отступы. Опция может быть полезна при отладке взаимодействия пользовательского приложения с сервисом.
• output=cp1251 - опция применима только в случае использования XML формата ответа сервиса. Данная опция требует, чтобы сервис вернул XML-ответ в кодировке windows-1251.

Пример запроса с дополнительными опциями

Приведенный ниже запрос отсылает сервису сигнатуру c1027700132195, которая соответствует юридическому лицу ПАО СБЕРБАНК с дополнительными параметрами.

В данном запросе используются следующие параметры.

• user=demotoken – сообщает сервису API-токен пользователя, поэтому в данном случае полагается, что запрос выполняется платно, так что после его выполнения с баланса будет списана его стоимость.
• output=json|pretty|cfulladdr - сообщает сервису о том, что необходимо вернуть ответ в формате 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"",
  "address" : { ... стандартизованный адрес ... }
}

Объект включает в себя следующие элементы.

• source - исходный неструктурированный адрес компании, извлечённый из ЕГРЮЛ или ЕГРИП.
• canonic - адрес компании, обработанный алгоритмами стандартизации Ахантера.
• name_precise - если true, то в ходе стандартизации нечисловых адресных полей исходного адреса не было обнаружено ошибок и неточностей.
• nums_precise - если true, то номер дома, корпуса и строения исходного адреса успешно обработаны и проверены по ФИАС.
• sign - сигнатура стандартизованного адреса, которую можно передать Ахантеру в команде fetch/address, чтобы получить полные сведения об адресе, такие как, коды по КЛАДР, ФИАС, ОКАТО и ОКТМО, географические координаты и др.
• country - объект с информацией о стране, которой принадлежит адрес, содержит следующие поля:
  • name - название страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
  • code - цифровой код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
  • sign - трёхбуквенный код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
• address - вложенный объект, содержащий полную информацию о стандартизованном адресе. Структура данного объекта совпадает со структурой адреса, возвращаемой командами fetch/address и cleanse/address, её описание доступно здесь. Данный объект возвращается, если при отправке запроса использовалась опция output=cfulladdr. Аналогичный объект можно получить с помощью отдельного вызова API команды fetch/address, если передать ей в качестве запроса значение сигнатуры данного адреса из поля company.address.sign. Данный объект не возвращается, если исходный неструктурированный адрес компании source в ЕГРЮЛ представлен в виде, не позволяющем его стандартизовать средствами сервиса.

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>... стандартизованный адрес ...</Address>
</Address>

Объект включает в себя следующие дочерние элементы.

• Source - исходный неструктурированный адрес компании, извлечённый из ЕГРЮЛ. Эта информация передаётся с помощью атрибута val данного элемента.
• Canonic - адрес компании, обработанный алгоритмами стандартизации Ахантера и сопутствующие такой обработке служебные сведения. Эта информация передаётся с помощью следующих атрибутов данного элемента:
  • name_precise - если 1, то в ходе стандартизации нечисловых адресных полей исходного адреса не было обнаружено ошибок и неточностей.
  • nums_precise - если 1, то номер дома, корпуса и строения исходного адреса успешно обработаны и проверены по ФИАС.
  • sign - сигнатура стандартизованного адреса, которую можно передать Ахантеру в команде fetch/address, чтобы получить полные сведения об адресе, такие как, коды по КЛАДР, ФИАС, ОКАТО и ОКТМО, географические координаты и др.
• Country - необязательный элемент с информацией о стране, которой принадлежит данный адрес. Эти сведения передаются с помощью следующих атрибутов данного элемента:
  • name - название страны.
  • code - цифровой код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
  • sign - трёхбуквенный код страны по классификатору стран мира ОКСМ, которой принадлежит адрес.
• Address - необязательный элемент, содержащий полную информацию о стандартизованном адресе. Структура данного элемента совпадает со структурой адреса, возвращаемой командами fetch/address и cleanse/address, её описание доступно здесь. Поведение, назначение и содержание этого элемента аналогично JSON-объекту company.address.address.

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 - краткое наименование вида предпринимательства.