Дискретные подсказки для адреса
Команда 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, которая соответствует юридическому лицу ПАО СБЕРБАНК. При этом используется минимальное количество параметров и опций.
В данном запросе используются следующие параметры.
Рассмотрим более подробно все параметры, которые сервис может получать в рамках данной команды.
Обязательные параметры для выполнения запроса.
Опциональные параметры.
Если при отправке запроса не указывать данный параметр, то обработка будет выполняться бесплатно, однако по запрошенной компании сервис будет возвращать не все доступные сведения.
Данный параметр не следует использовать, если вы отсылаете ajax-запросы непосредственно из браузера с веб-страницы, публично доступной любому посетителю вашего веб-сайта. Поскольку в этом случае ваш API-токен может стать известен третьим лицам. Чтобы этого избежать, следует организовать отсылку этих запросов либо с backend-а вашего веб-сайта, либо с закрытой части веб-сайта, доступной, например, только вашим сотрудникам, выполняющим обработку заказов.
Приведенный ниже запрос отсылает сервису сигнатуру c1027700132195, которая соответствует юридическому лицу ПАО СБЕРБАНК с дополнительными параметрами.
В данном запросе используются следующие параметры.
Ниже приведен пример ответа сервиса с результатом обработки сигнатуры 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-объект со следующими элементами.
Ниже приведено детальное описание этих элементов.
Данный объект содержит всю информацию о запрошенной компании, которой располагает Ахантер. Данный объект содержит следующие дочерние элементы:
Элементы данного объекта позволяют получить основную информацию о компании, такую как реквизиты, название и текущее состояние (действующая или ликвидируемая). Пример 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" }
Объект содержит следующие элементы.
Данный объект сообщает информацию об организационно-правовой форме компании по классификатору ОКОПФ/КОПФ. Для индивидуального предпринимателя данный объект не возвращается, т.к. сведения данного типа не применимы к ИП. Пример JSON-объекта company.opf показан ниже.
{ "class" : "ОКОПФ", "code" : "12247", "full" : "Публичные акционерные общества" }
Объект содержит следующие элементы.
Объект содержит адрес компании в том виде, в котором он указан в ЕГРЮЛ или ЕГРИП, а также адрес компании в стандартизованном виде, который получен при обработке исходного адреса функцией стандартизации Ахантера. Пример JSON-объекта company.address показан ниже.
{ "canonic" : "117312, г Москва, ул Вавилова, дом 19", "name_precise" : true, "nums_precise" : true, "sign" : "77s924hдом:19", "source" : "ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19" }
Объект включает в себя следующие элементы.
Данный массив содержит объекты, позволяющие отвечать на такие вопросы как, является ли компания действующей, находится ли она в процессе реорганизации или ликвидации. Если компания находится в нормальном действующем состоянии, то массив company.status не будет включаться в состав объекта company.
Каждый элемент массива company.status[i] описывает какой-то один статус компании, согласно справочнику СЮЛСТ для юридического лица, и согласно справочнику СИПСТ, для индивидуального предпринимателя. Пример JSON-массива company.status показан ниже.
[ { "code" : "101", "date" : "2019-01-16", "name" : "Находится в стадии ликвидации" } ]
Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.
Массив содержит информацию о юридических лицах, являющихся правопреемниками данной компании. Обычно правопреемники появляются в результате ликвидации компании в форме реорганизации, однако, возможно наличие правопреемников и у действующего юридического лица.
Каждый элемент массива 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-объектов, включающих в себя следующие элементы.
Данный объект содержит дату постановки компании на учёт в ФНС, а также код и название соответствующей налоговой инспекции. Пример JSON-объекта company.reg_fns показан ниже.
{ "code" : "7719", "date" : "2017-01-06", "name" : "Инспекция Федеральной налоговой службы № 19 по г.Москве" }
Объект включает в себя следующие элементы.
Данный объект содержит дату регистрации компании в ПФР, а также код и название соответствующего территориального органа ПФР. Пример JSON-объекта company.reg_pfr показан ниже.
{ "code" : "087415", "date" : "2005-12-02", "name" : "Государственное учреждение - Главное Управление Пенсионного фонда РФ №4 Управление №1 по г. Москве и Московской области муниципальный район Гагаринский г.Москвы" }
Объект включает в себя следующие элементы.
Данный объект содержит дату регистрации компании в Фонде социального страхования РФ, а также код и название соответствующего исполнительного органа ФСС. Пример JSON-объекта company.reg_fss показан ниже.
{ "code" : "7711", "date" : "2018-09-01", "name" : "Филиал №11 Государственного учреждения - Московского регионального отделения Фонда социального страхования Российской Федерации" }
Объект включает в себя следующие элементы.
Массив содержит объекты с информацией о руководителях компании. Чаще всего данный массив будет содержать только один элемент. Для компании, являющейся индивидуальным предпринимателем, данный массив не выводится, поскольку у ИП руководителем является сам предприниматель. Пример JSON-массива company.managers показан ниже.
[ { "first_name" : "МАКСИМ", "patronym" : "АЛЕКСАНДРОВИЧ", "last_name" : "ХАМЧИЧ", "inn" : "262306749147", "position_code" : "02", "position_type" : "Руководитель юридического лица" "position_name" : "ПРЕДСТАВИТЕЛЬ ЛИКВИДАТОРА", } ]
Массив состоит из однотипных JSON-объектов, включающих в себя следующие элементы.
Объект company.capital содержит сведения о размере и типе уставного капитала юридического лица. Для индивидуального предпринимателя данный объект не возвращается, т.к. сведения данного типа не применимы к ИП. Пример объекта показан ниже.
{ "sum" : 411461504.00, "type" : "УСТАВНЫЙ КАПИТАЛ" }
Объект включает в себя следующие элементы.
Массив содержит однотипные объекты со сведениями о лицах (физических или юридических), которые, согласно ЕГРЮЛ, являются учредителями компании. Для компании, являющейся индивидуальным предпринимателем, данный объект не выводится, поскольку у ИП нет учредителей. Ниже показан пример данного массива.
[ { "fract" : "", "inn" : "7702235133", "name" : "ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ", "ogrn" : "0", "sum" : 605693376.00, "type" : "RussianCompany" } ]
Каждый элемент company.owners[i] данного массива является JSON-объектом со следующими дочерними элементами.
Массив содержит однотипные объекты, содержащие коды видов деятельности компании по классификатору ОКВЭД, а также их расшифровку. Пример массива показан ниже.
[ { "class" : "2014", "code" : "62.01", "name" : "Разработка компьютерного программного обеспечения" }, { "class" : "2014", "code" : "62.02", "name" : "Деятельность консультативная и работы в области компьютерных технологий" }, { "class" : "2014", "code" : "63.11", "name" : "Деятельность по обработке данных, предоставление услуг по размещению информации и связанная с этим деятельность" } ]
Каждый объект company.okveds[i] данного массива содержит следующие дочерние элементы.
Массив содержит объекты, содержащие сведения о выданных данной компании лицензиях. Если у компании нет лицензируемых видов деятельности, то данный массив не будет возвращаться сервисом. Пример массива приведён ниже.
[ { "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] данного массива содержит следующие дочерние элементы.
Объект содержит информацию о филиале или представительстве компании, если сигнатура, полученная в рамках 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 }
Данный объект содержит следующие дочерние элементы:
Данный объект возвращается сервисом, если запрошенная компания является индивидуальным предпринимателем. В этом случае данный объект содержит дополнительные сведения об ИП. Пример такого объекта показан ниже.
{ "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" : "КФХ" } }
Данный объект содержит следующие дочерние элементы:
Ниже приведен пример ответа сервиса с результатом обработки сигнатуры c1027700132195b126498, которая соответствует юридическому лицу УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК. Результирующий XML-ответ получен с использованием опции output=xml|pretty, позволяющей выполнить "красивое" форматирование XML-текста. Для краткости записи, в примере отображены не все лицензии, имеющиеся у данной компании.
<ProcessFetchResult> <Company> <Main> <OGRN val="1027700132195"/> <INN val="7707083893"/> <KPP val="773601001"/> <PFR val="087705007215"/> <FSS val="770600307277061"/> <OKPO val="00032537"/> <OKOGU val="4100104"/> <OKFS val="41"/> <CreateDate val="1991-06-20"/> <State date="" state="Normal"/> <Name full="ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"" short="ПАО СБЕРБАНК"/> <BizScale val="Common"/> <StaffAmount val="0"/> </Main> <Opf class="ОКОПФ" code="12247" full="Публичные акционерные общества"/> <Address> <Canonic name_precise="1" nums_precise="1" pretty="117312, г Москва, ул Вавилова, дом 19" sign="77s924hдом:19"/> <Source val="ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"/> </Address> <RegFNS code="7736" date="2017-01-09" name="Инспекция Федеральной налоговой службы № 36 по г.Москве"/> <RegPFR code="087705" date="2010-09-03" name="Государственное учреждение - Главное Управление Пенсионного фонда РФ №4 Управление №1 по г. Москве и Московской области муниципальный район Гагаринский г.Москвы"/> <RegFSS code="7706" date="2001-01-04" name="Филиал №6 Государственного учреждения - Московского регионального отделения Фонда социального страхования Российской Федерации"/> <Manager> <Person first_name="ГЕРМАН" inn="770303580308" last_name="ГРЕФ" patronym="ОСКАРОВИЧ"/> <Position code="02" name="ПРЕЗИДЕНТ, ПРЕДСЕДАТЕЛЬ ПРАВЛЕНИЯ" type="Руководитель юридического лица"/> </Manager> <Capital sum="67760844800" type="УСТАВНЫЙ КАПИТАЛ"/> <Owner fract="" inn="7702235133" name="ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ" ogrn="0" sum="605693376" type="RussianCompany"/> <OKVED class="2014" code="64.19" name="Денежное посредничество прочее"/> <License licensor="Центральный банк Российской Федерации" number="045-02894-100000"> <Date begin="2015-10-06" end=""/> <Type val="Брокерская деятельность"/> </License> <License licensor="Центральный банк Российской Федерации" number="045-02768-000100"> <Date begin="2015-10-06" end=""/> <Type val="Депозитарная деятельность"/> </License> <License licensor="Центральный банк Российской Федерации" number="045-03004-010000"> <Date begin="2015-10-06" end=""/> <Type val="Дилерская деятельность"/> </License> <Branch type="0"> <KPP val="667102008"/> <Name full="УРАЛЬСКИЙ БАНК ПАО СБЕРБАНК"/> <RegFNS code="6671" date="2005-03-22" name="Инспекция Федеральной налоговой службы по Ленинскому району г.Екатеринбурга"/> <Address country="rus"> <Canonic name_precise="1" nums_precise="1" pretty="620026, обл Свердловская, г Екатеринбург, ул Куйбышева, стр 67" sign="66c1s578uстр:67"/> <Source val="ГОРОД ЕКАТЕРИНБУРГ, УЛИЦА КУЙБЫШЕВА, ДОМ 67"/> </Address> </Branch> </Company> <Query val="c1027700132195b126498"/> </ProcessFetchResult>
Результатом получения описателя юридического лица является XML-документ со следующими дочерними элементами.
Ниже приведено детальное описание этих элементов.
Данный элемент аналогичен JSON-объекту company, он содержит следующие дочерние элементы:
Элемент содержит основную информацию о компании, такую как реквизиты, название и текущее состояние (действующая или ликвидируемая). Пример элемента показан ниже.
<Main> <OGRN val="1027700132195"/> <INN val="7707083893"/> <KPP val="773601001"/> <PFR val="087705007215"/> <FSS val="770600307277061"/> <OKPO val="00032537"/> <OKOGU val="4100104"/> <OKFS val="41"/> <CreateDate val="1991-06-20"/> <State date="" state="Normal"/> <Name full="ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО "СБЕРБАНК РОССИИ"" short="ПАО СБЕРБАНК"/> <BizScale val="Common"/> <StaffAmount val="0"/> </Main>
Элемент содержит следующие дочерние XML-элементы. Большинство этих элементов содержат соответствующие значения в рамках атрибута val.
Данный элемент сообщает информацию об организационно-правовой форме компании по классификатору ОКОПФ/КОПФ. Для индивидуального предпринимателя данный элемент не возвращается, т.к. сведения данного типа не применимы к ИП. Пример элемента показан ниже.
<Opf class="ОКОПФ" code="12247" full="Публичные акционерные общества"/>
Элемент содержит следующие атрибуты, с помощью которых передаётся информация об организационно-правовой форме.
Элемент содержит адрес компании в том виде, в котором он указан в ЕГРЮЛ или ЕГРИП, а также адрес компании в стандартизованном виде, который получен при обработке исходного адреса функцией стандартизации Ахантера. Пример элемента показан ниже.
<Address> <Canonic name_precise="1" nums_precise="1" pretty="117312, г Москва, ул Вавилова, дом 19" sign="77s924hдом:19"/> <Source val="ГОРОД МОСКВА, УЛИЦА ВАВИЛОВА, 19"/> </Address>
Объект включает в себя следующие дочерние элементы.
Это множественный элемент, каждый экземпляр которого, позволяет отвечать на такие вопросы как, является ли компания действующей, находится ли она в процессе реорганизации или ликвидации. Если компания находится в нормальном действующем состоянии, то элементы Status не будут включаться в ответ сервиса.
Каждый экземпляр элемента Status описывает какой-то один статус компании, согласно справочнику СЮЛСТ для юридического лица, и согласно справочнику СИПСТ, для индивидуального предпринимателя. В общем случае компании может быть присвоено несколько статусов. Пример элемента показан ниже.
<Status code="101" date="2019-01-16" name="Находится в стадии ликвидации"/>
Информация о статусе передаётся с помощью следующих атрибутов данного элемента.
Это множественный элемент, каждый экземпляр которого представляет информацию об одном правопреемнике юридического лица. У компании может быть несколько правопреемников, в этом случае XML-ответ сервиса будет содержать несколько элементов данного типа.
Обычно правопреемники появляются в результате ликвидации компании в форме реорганизации, однако, возможно наличие правопреемников и у действующего юридического лица. Пример элемента показан ниже.
<Inheritor name="ООО ПОКРОВКА" ogrn="1197746755898" inn="7714456779" sign="c1197746755898" state="0"/>
Информация о правопреемнике передаётся с помощью следующих атрибутов данного элемента.
Данный элемент содержит дату постановки компании на учёт в ФНС, а также код и название соответствующей налоговой инспекции. Пример элемента показан ниже.
<RegFNS code="7719" date="2017-01-06" name="Инспекция Федеральной налоговой службы №19 по г.Москве"/>
Элемент включает в себя следующие атрибуты.
Данный элемент содержит дату регистрации компании в ПФР, а также код и название соответствующего территориального органа ПФР. Пример элемента показан ниже.
<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>
Элемент Manager содержит следующие дочерние XML-элементы.
Элемент Capital содержит сведения о размере и типе уставного капитала юридического лица. Для индивидуального предпринимателя данный элемент не возвращается, т.к. сведения данного типа не применимы к ИП. Пример элемента показан ниже.
<Capital sum="411461504" type="УСТАВНЫЙ КАПИТАЛ"/>
Элемент включает в себя следующие атрибуты.
Это множественный элемент, каждый экземпляр которого содержит информацию о лице (физическом или юридическом), которое, согласно ЕГРЮЛ, является учредителем компании. Для индивидуального предпринимателя данный объект не возвращается, т.к. сведения данного типа не применимы к ИП. Ниже показан пример данного элемента.
<Owner fract="" inn="7702235133" name="ЦЕНТРАЛЬНЫЙ БАНК РОССИЙСКОЙ ФЕДЕРАЦИИ" ogrn="0" sum="605693376" type="RussianCompany"/>
Каждый элемент Owner содержит следующие атрибуты.
Это множественный элемент, каждый экземпляр которого содержит код вида деятельности компании по классификатору ОКВЭД, а также его расшифровку. Пример множества таких элементов показан ниже.
<OKVED class="2014" code="62.01" name="Разработка компьютерного программного обеспечения"/> <OKVED class="2014" code="62.02" name="Деятельность консультативная и работы в области компьютерных технологий"/> <OKVED class="2014" code="63.11" name="Деятельность по обработке данных, предоставление услуг по размещению информации и связанная с этим деятельность"/>
Каждый элемент OKVED содержит следующие атрибуты.
Это множественный элемент, каждый экземпляр которого содержит сведения о выданных данной компании лицензиях. Если у компании нет лицензируемых видов деятельности, то данные элементы не будет возвращаться сервисом. Пример множества таких элементов показан ниже.
<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 содержит следующие атрибуты.
Кроме атрибутов элемент License содержит дочерние XML-элементы.
Элемент содержит информацию о филиале или представительстве компании, если сигнатура, полученная в рамках 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-элемент содержит следующие атрибуты:
Данный XML-элемент также содержит следующие дочерние элементы:
Данный элемент возвращается сервисом, если запрошенная компания является индивидуальным предпринимателем. В этом случае данный объект содержит дополнительные сведения об ИП. Пример такого элемента показан ниже.
<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-элемент содержит следующие атрибуты:
Данный XML-элемент также содержит следующие дочерние элементы: