Exportcenter:GetLegalEntityList:v2.0

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску

Общие сведения

Операция GetLegalEntityList предназначена для получения списка хозяйствующих субъектов. В список попадают только актуальные записи (active = true). Поддерживается возможность постраничного вывода и фильтрации по шаблону. Выполнение операции заканчивается либо возвратом списка хозяйствующих субъектов, либо ошибкой, в случае если параметры запроса не корректны или произошла иная ошибка выполнения запроса.

Входные данные

  • параметры выводимого списка;
  • поля, по которым осуществляется фильтрация хозяйствующих субъектов.

Выходные данные

  • список хозяйствующих субъектов.

Спецификация запроса

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:CheckRegisterLegalEntityApplicationRequest>
002 ···<bs:listOptions> bs:ListOptions [0..1] Параметры запрашиваемого списка.
003 ······<bs:count>10</bs:count> xs:nonNegativeInteger [0..1]

Максимальное запрашиваемое количество объектов в списке.

  • По умолчанию значение 100;
  • Максимально возможное значение 1000.
004 ······<bs:offset>2</bs:offset> xs:nonNegativeInteger [0..1]

Номер элемента, по которому осуществляется смещение первого элемента списка.

  • По умолчанию значение 0.
005 ···</bs:listOptions>
006 ···<dt:businessEntity> dt:BusinessEntity [0..1] Данные о хозяйствующем субъекте.
007 ······<bs:uuid>UUID</bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта.
008 ······<bs:guid>GUID</bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта.
009 ······<dt:name>Наименование ХС</dt:name> bs:String255 [0..1]

Наименование хозяйствующего субъекта без указания организационно-правовой формы.

  • Указывается только для юридических лиц.
  • Для индивидуальных предпринимателей поле не указывается.
010 ······<dt:fullName>Полное наименование ХС</dt:fullName> bs:String255 [0..1]

Полное наименование хозяйствующего субъекта.

  • с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
011 ······<dt:fio>Иванов Иван Иванович</dt:fio> bs:String255 [0..1]

ФИО индивидуального предпринимателя.

  • Для юридических лиц поле не указывается.
012 ······<dt:inn>3312200096</dt:inn> bs:String255 [0..1] ИНН хозяйствующего субъекта.
013 ······<dt:ogrn>4085022240002</dt:ogrn> bs:String255 [0..1]

ОГРН или ОГРНИП.

  • Для ИП ОГРНИП может быть не указано.
014 ······<dt:juridicalAddress> dt:Address [1..1]

Юридический адрес.

  • адрес, по которому зарегистрирован хозяйствующий субъект.
015 ·········<dt:country> dt:Country [1..1] Страна.
016 ············<bs:guid>GUID</bs:guid> bs:UUID [0..1]

Глобальный идентификатор страны.

  • в соответствии со справочником РСХН.
017 ············<dt:code>RU</dt:code> dt:Code [1..1]

Код страны.

  • двухбуквенный код страны, соответствующий стандарту ISO 3166-1. В качестве кода используются буквы латинского алфавита.
018 ·········</dt:country>
019 ·········<dt:region> dt:Region [1..1] Регион (республика, область, край, автономная область).
020 ············<bs:guid>GUID</bs:guid> bs:UUID [1..1]

Глобальный идентификатор региона страны.

  • в соответствии со справочником РСХН.
021 ·········</dt:region>
022 ·········<dt:district> dt:Locality [0..1] Район региона.
023 ············<bs:guid>GUID</bs:guid> bs:UUID [1..1]

Глобальный идентификатор района региона.

  • в соответствии со справочником РСХН.
024 ·········</dt:district>
025 ·········<dt:locality> dt:Locality [0..1] Населённый пункт.
026 ············<bs:guid>GUID</bs:guid> bs:UUID [1..1]

Глобальный идентификатор города региона (города регионального подчинения) страны.

  • в соответствии со справочником РСХН.
027 ·········</dt:locality>
028 ·········<dt:subLocality> dt:Locality [0..1] Населённый пункт, подчиненный другогому населенному пункту (locality).
029 ············<bs:guid>GUID</bs:guid> bs:UUID [1..1]

Глобальный идентификатор населенного пункта.

  • в соответствии со справочником РСХН.
030 ·········</dt:subLocality>
031 ·········<dt:street> dt:Street [0..1] Улица.
032 ············<bs:guid>GUID</bs:guid> bs:UUID [1..1]

Глобальный идентификатор улицы города.

  • в соответствии со справочником РСХН.
033 ·········</dt:street>
034 ·········<dt:house>0</dt:house> bs:String255 [0..1] Номер дома.
035 ·········<dt:building>0</dt:building> bs:String255 [0..1] Номер строения.
036 ·········<dt:room>0</dt:room> bs:String255 [0..1] Номер квартиры / офиса.
037 ·········<dt:postIndex>000000</dt:postIndex> bs:String255 [0..1] Почтовый индекс.
038 ······</dt:juridicalAddress>
039 ···</dt:businessEntity>
040 </ws:CheckRegisterLegalEntityApplicationRequest>

Спецификация ответа

Описание ошибок

Ошибка Описание
InternalServiceFault Внутренняя ошибка сервиса.
IncorrectRequestFault Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям указанным в xsd, то есть сообщение не проходит валидацию.
OffsetOutOfRangeFault Заданный в запросе отступ больше числа записей в результате запроса.