GetBusinessEntityList v2: различия между версиями
Строка 52: | Строка 52: | ||
! Тип | ! Тип | ||
! Обязат. | ! Обязат. | ||
! Описание | ! Описание (нажмите [...] для отображения дополнительного описания) | ||
|- | |- | ||
| | |001 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<ws:getBusinessEntityListRequest>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |002 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|bs:}}listOptions>'''}} | ||
|[[ListOptions|bs:ListOptions]] | |[[ListOptions|bs:ListOptions]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Параметры запрашиваемого списка. | |||
|style=" | |||
|- | |- | ||
| | |003 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}count>'''}}{{color|#131313|10}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}count>'''}} | ||
|[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] | |[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] | ||
|[0..1] | |[0..1] | ||
|Максимальное запрашиваемое количество объектов в списке. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Максимальное запрашиваемое количество объектов в списке. | |||
</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* По умолчанию значение 100; | * По умолчанию значение 100; | ||
* Максимально возможное значение 1000. | * Максимально возможное значение 1000.</div> | ||
</div> | |||
|- | |- | ||
| | |004 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}offset>'''}}{{color|#131313|2}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}offset>'''}} | ||
|[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] | |[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] | ||
|[0..1] | |[0..1] | ||
|Номер элемента, по которому осуществляется смещение первого элемента списка. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Номер элемента, по которому осуществляется смещение первого элемента списка. | |||
</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* По умолчанию значение 0.</div> | |||
</div> | |||
|- | |- | ||
| | |005 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|bs:}}listOptions>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |006 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|dt:}}businessEntity>'''}} | ||
|[[BusinessEntity_v2.0|dt:BusinessEntity]] | |[[BusinessEntity_v2.0|dt:BusinessEntity]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Данные о хозяйствующем субъекте. | |||
|style=" | |||
|- | |- | ||
| | |007 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}uuid>'''}}{{color|#131313|UUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}uuid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Идентификатор версии хозяйствующего субъекта. | |||
|style=" | |||
|- | |- | ||
| | |008 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Глобальный идентификатор хозяйствующего субъекта. | |||
|style=" | |||
|- | |- | ||
| | |009 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}name>'''}}{{color|#131313|Наименование ХС}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}name>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
|Наименование хозяйствующего субъекта без указания организационно-правовой формы. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Наименование хозяйствующего субъекта без указания организационно-правовой формы. | |||
</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Указывается только для юридических лиц. | * Указывается только для юридических лиц. | ||
* Для физических лиц и для индивидуальных предпринимателей поле не указывается. | * Для физических лиц и для индивидуальных предпринимателей поле не указывается.</div> | ||
</div> | |||
|- | |- | ||
| | |010 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}fullName>'''}}{{color|#131313|Полное наименование ХС}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}fullName>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
|Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Полное наименование хозяйствующего субъекта.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП. </div> | |||
</div> | |||
|- | |- | ||
| | |011 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}fio>'''}}{{color|#131313|Иванов Иван Иванович}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}fio>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
|ФИО физического лица или индивидуального предпринимателя. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">ФИО физического лица или индивидуального предпринимателя. | |||
</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Для юридических лиц поле не указывается.</div> | |||
</div> | |||
|- | |- | ||
| | |012 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}inn>'''}}{{color|#131313|3312200096}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}inn>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| ИНН хозяйствующего субъекта. | |||
|style=" | |||
|- | |- | ||
| | |013 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}kpp>'''}}{{color|#131313|163501001}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}kpp>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
|Код причины постановки на учет (КПП). | | style="width:52em;"| Код причины постановки на учет (КПП). | ||
|- | |- | ||
| | |014 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}ogrn>'''}}{{color|#131313|4085022240002}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}ogrn>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
|ОГРН или ОГРНИП. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
* Для ИП ОГРНИП может быть не указано. | <span style="white-space:nowrap; font-weight: normal;">ОГРН или ОГРНИП. | ||
</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Для ИП ОГРНИП может быть не указано.</div> | |||
</div> | |||
|- | |- | ||
| | |015 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}juridicalAddress>'''}} | ||
|[[Address_v2.0|dt:Address]] | |[[Address_v2.0|dt:Address]] | ||
|[1..1] | |[1..1] | ||
|Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект. | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Юридический адрес.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* адрес, по которому зарегистрирован хозяйствующий субъект.</div> | |||
</div> | |||
|- | |- | ||
| | |016 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}country>'''}} | ||
|[[Country_v2.0|dt:Country]] | |[[Country_v2.0|dt:Country]] | ||
|[1..1] | |[1..1] | ||
| style="width:52em;"| Страна. | |||
|style=" | |||
|- | |- | ||
| | |017 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[1..1] | |[1..1] | ||
|Глобальный идентификатор страны | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Глобальный идентификатор страны.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* в соответствии со справочником РСХН.</div> | |||
</div> | |||
|- | |- | ||
| | |018 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}country>'''}} | ||
| | | | ||
| | | | ||
|style=" | | style="width:52em;"| | ||
|- | |- | ||
| | |019 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}region>'''}} | ||
|[[Region_v2.0|dt:Region]] | |[[Region_v2.0|dt:Region]] | ||
|[1..1] | |[1..1] | ||
|Регион (республика, область, край, автономная область) | | style="width:52em;"| Регион (республика, область, край, автономная область). | ||
|- | |- | ||
| | |020 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[1..1] | |[1..1] | ||
|Глобальный идентификатор региона страны | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Глобальный идентификатор региона страны.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* в соответствии со справочником РСХН.</div> | |||
</div> | |||
|- | |- | ||
| | |021 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}region>'''}} | ||
| | | | ||
| | | | ||
|style=" | | style="width:52em;"| | ||
|- | |- | ||
| | |022 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}district>'''}} | ||
|[[Locality_v2.0|dt:Locality]] | |[[Locality_v2.0|dt:Locality]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Район региона. | |||
|style=" | |||
|- | |- | ||
| | |023 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[1..1] | |[1..1] | ||
|Глобальный идентификатор района региона | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Глобальный идентификатор района региона.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* в соответствии со справочником РСХН.</div> | |||
</div> | |||
|- | |- | ||
| | |024 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}district>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |025 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}locality>'''}} | ||
|[[Locality_v2.0|dt:Locality]] | |[[Locality_v2.0|dt:Locality]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Населённый пункт. | |||
|style=" | |||
|- | |- | ||
| | |026 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[1..1] | |[1..1] | ||
|Глобальный идентификатор города региона (города регионального подчинения) страны | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Глобальный идентификатор города региона (города регионального подчинения) страны.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* в соответствии со справочником РСХН.</div> | |||
</div> | |||
|- | |- | ||
| | |027 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}locality>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |028 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}subLocality>'''}} | ||
|[[Locality_v2.0|dt:Locality]] | |[[Locality_v2.0|dt:Locality]] | ||
|[0..1] | |[0..1] | ||
|Населённый пункт, подчиненный другогому населенному пункту (locality) | | style="width:52em;"| Населённый пункт, подчиненный другогому населенному пункту (locality). | ||
|- | |- | ||
| | |029 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[1..1] | |[1..1] | ||
|Глобальный идентификатор населенного пункта | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Глобальный идентификатор населенного пункта.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* в соответствии со справочником РСХН.</div> | |||
</div> | |||
|- | |- | ||
| | |030 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}subLocality>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |031 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}street>'''}} | ||
|[[Street_v2.0|dt:Street]] | |[[Street_v2.0|dt:Street]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Улица. | |||
|style=" | |||
|- | |- | ||
| | |032 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |············{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|GUID}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | ||
|[[UUID|bs:UUID]] | |[[UUID|bs:UUID]] | ||
|[1..1] | |[1..1] | ||
|Глобальный идентификатор улицы города | |<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | ||
<span style="white-space:nowrap; font-weight: normal;">Глобальный идентификатор улицы города.</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* в соответствии со справочником РСХН.</div> | |||
</div> | |||
|- | |- | ||
| | |033 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''</{{color|#660e7a|dt:}}street>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |034 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}house>'''}}{{color|#131313|0}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}house>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Номер дома. | |||
|style=" | |||
|- | |- | ||
| | |035 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}building>'''}}{{color|#131313|0}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}building>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Номер строения. | |||
|style=" | |||
|- | |- | ||
| | |036 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}room>'''}}{{color|#131313|0}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}room>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Номер квартиры / офиса. | |||
|style=" | |||
|- | |- | ||
| | |037 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|dt:}}postIndex>'''}}{{color|#131313|000000}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}postIndex>'''}} | ||
|[[String255|bs:String255]] | |[[String255|bs:String255]] | ||
|[0..1] | |[0..1] | ||
| style="width:52em;"| Почтовый индекс. | |||
|style=" | |||
|- | |- | ||
| | |038 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|dt:}}juridicalAddress>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |039 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|dt:}}businessEntity>'''}} | ||
| | | | ||
| | | | ||
| style="width:52em;"| | |||
|style=" | |||
|- | |- | ||
| | |040 | ||
|style="font-weight: | |style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</ws:getBusinessEntityListRequest>'''}} | ||
| | | | ||
| | | | ||
|style=" | | style="width:52em;"| | ||
|- | |- | ||
|} | |} |
Версия 14:44, 8 ноября 2020
Общие сведения
Операция GetBusinessEntityList предназначена для получения списка хозяйствующих субъектов из реестра Россельхознадзора. В список попадают только актуальные записи (active = true). Поддерживается возможность постраничного вывода и фильтрации по шаблону. Выполнение операции заканчивается либо возвратом списка хозяйствующих субъектов, либо ошибкой, в случае если параметры запроса не корректны или произошла иная ошибка выполнения запроса.
Входные данные
- параметры выводимого списка;
- поля, по которым осуществляется фильтрация хозяйствующих субъектов.
Выходные данные
- список хозяйствующих субъектов.
Использование фильтрации в запросе
- В спецификации перечислены поля, по которым может быть осуществлена фильтрация хозяйствующих субъектов.
- ИНН и ОГРН не могут быть указаны вместе. Поиск может быть произведен только по одному из этих полей. Сочетания остальных полей могут быть любыми.
- Поиск может быть осуществлен по любому из указанных элементов адреса как отдельно, так и в совокупности.
Спецификация запроса
# | Название XML-элемента | Тип | Обязат. | Описание (нажмите [...] для отображения дополнительного описания) |
---|---|---|---|---|
001 | <ws:getBusinessEntityListRequest> | |||
002 | ···<bs:listOptions> | bs:ListOptions | [0..1] | Параметры запрашиваемого списка. |
003 | ······<bs:count>10</bs:count> | xs:nonNegativeInteger | [0..1] | Максимальное запрашиваемое количество объектов в списке.
|
004 | ······<bs:offset>2</bs:offset> | xs:nonNegativeInteger | [0..1] | Номер элемента, по которому осуществляется смещение первого элемента списка.
|
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:kpp>163501001</dt:kpp> | bs:String255 | [0..1] | Код причины постановки на учет (КПП). |
014 | ······<dt:ogrn>4085022240002</dt:ogrn> | bs:String255 | [0..1] | ОГРН или ОГРНИП.
|
015 | ······<dt:juridicalAddress> | dt:Address | [1..1] | Юридический адрес.
|
016 | ·········<dt:country> | dt:Country | [1..1] | Страна. |
017 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..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:getBusinessEntityListRequest> |
Спецификация ответа
# | Название XML-элемента | Тип | Обязат. | Описание | Пример |
---|---|---|---|---|---|
1 | <ws:getBusinessEntityChangesListResponse> | ||||
2 | ···<dt:businessEntityList count="10" total="1000" offset="0"> | dt:BusinessEntityList | [1..1] | Список хозяйствующих субъектов
|
|
3 | ······<dt:businessEntity> | dt:BusinessEntity | [1..1] | Данные о хозяйствующем субъекте. | |
4 | ·········<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии хозяйствующего субъекта. | <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid> |
5 | ·········<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор хозяйствующего субъекта. | <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid> |
6 | ·········<bs:active> | xs:boolean | [1..1] | Является ли запись активной:
|
<bs:active>true</bs:active> |
7 | ·········<bs:last> | xs:boolean | [1..1] | Является ли версия записи последней:
|
<bs:last>true</bs:last> |
8 | ·········<bs:status> | bs:VersionStatus | [1..1] | Статус версии хозяйствующего субъекта. | <bs:status>230</bs:status> |
9 | ·········<bs:createDate> | xs:DateTime | [1..1] | Дата создания хозяйствующего субъекта. | <bs:createDate>2017-07-07T12:00:00</bs:createDate> |
10 | ·········<bs:updateDate> | xs:DateTime | [1..1] | Дата изменения хозяйствующего субъекта. | <bs:updateDate>2017-07-07T12:00:00</bs:updateDate> |
11 | ·········<bs:previous> | bs:UUID | [0..1] | Идентификатор предыдущей версии записи реестра хозяйствующих субъектов. | <bs:previous>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:previous> |
12 | ·········<bs:next> | bs:UUID | [0..1] | Идентификатор следующей версии записи реестра хозяйствующих субъектов. | <bs:next>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:next> |
13 | ·········<dt:type> | dt:BusinessEntityType | [1..1] | Тип создаваемого или редактируемого хозяйствующего субъекта:
|
<dt:type>1</dt:type> |
14 | ·········<dt:name> | bs:String255 | [0..1] | Наименование хозяйствующего субъекта без указания организационно-правовой формы.
|
<dt:name>Гладиолус</dt:name> |
15 | ·········<dt:incorporationForm> | dt:IncorporationForm | [1..1] | Организационно-правовая форма хозяйствующего субъекта. | |
16 | ············<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии организационно-правовой формы | <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid> |
17 | ············<dt:name> | bs:String255 | [1..1] | Название организационно-правовой формы предприятия согласно справочнику ОКОПФ. | <dt:name>Общество с ограниченной ответственностью</dt:name> |
18 | ············<dt:code> | bs:String255 | [1..1] | Код организационно-правовой формы предприятия согласно справочнику ОКОПФ. | <dt:code>12300</dt:code> |
19 | ············<dt:shortName> | bs:String255 | [0..1] | Краткое название организационно-правовой формы предприятия. | <dt:shortName>ООО</dt:shortName> |
20 | ·········</dt:incorporationForm> | ||||
21 | ·········<dt:fullName> | bs:String255 | [0..1] | Полное наименование хозяйствующего субъекта с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП. | <dt:fullName>Общество с ограниченной ответственностью "Гладиолус"</dt:fullName> |
22 | ·········<dt:fio> | bs:String255 | [0..1] | ФИО физического лица или индивидуального предпринимателя.
|
<dt:fio>Иванов Сергей Петрович</dt:fio> |
23 | ·········<dt:inn> | bs:String255 | [0..1] | ИНН хозяйствующего субъекта. | <dt:inn>3312200096</dt:inn> |
24 | ·········<dt:kpp> | bs:String255 | [0..1] | Код причины постановки на учет (КПП). | <dt:kpp>163501001</dt:kpp> |
25 | ·········<dt:ogrn> | bs:String255 | [0..1] | ОГРН или ОГРНИП.
|
<dt:ogrn>4085022240002</dt:ogrn> |
26 | ·········<dt:juridicalAddress> | dt:Address | [1..1] | Юридический адрес - адрес, по которому зарегистрирован хозяйствующий субъект. | |
27 | ············<dt:country> | dt:Country | [1..1] | Страна | |
28 | ···············<bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор страны в соответствии со справочником РСХН. | <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid> |
29 | ···············<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор страны в соответствии со справочником РСХН. | <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid> |
30 | ···············<dt:name> | bs:String255 | [1..1] | Наименование страны в соответствии со справочником РСХН. | <dt:name>Российская Федерация</dt:name> |
31 | ············</dt:country> | ||||
32 | ············<dt:region> | dt:Region | [1..1] | Регион | |
33 | ···············<bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор региона страны в соответствии со справочником РСХН. | <bs:uuid>e440dcdb-31d6-39a4-db63-a1c0731d61d6</bs:uuid> |
34 | ···············<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор региона страны в соответствии со справочником РСХН. | <bs:guid>cbdf8cb6-fb9a-4f36-36d3-04488f6d1b82</bs:guid> |
35 | ···············<dt:name> | bs:String255 | [1..1] | Наименование региона страны в соответствии со справочником РСХН. | <dt:name>Владимирская область</dt:name> |
36 | ············</dt:region> | ||||
37 | ············<dt:district> | dt:Locality | [0..1] | Район региона | |
38 | ···············<bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор района региона в соответствии со справочником РСХН. | <bs:uuid>3cb373d5-32f1-ac2a-754c-58d4b33825dd</bs:uuid> |
39 | ···············<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор района региона в соответствии со справочником РСХН. | <bs:guid>90d82878-431a-0cf1-0974-16d4fdff3bc8</bs:guid> |
40 | ···············<dt:name> | bs:String255 | [1..1] | Наименование района региона в соответствии со справочником РСХН. | <dt:name>Собинский район</dt:name> |
41 | ············</dt:district> | ||||
42 | ············<dt:locality> | dt:Locality | [0..1] | Населённый пункт | |
43 | ···············<bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН. | <bs:uuid>70db962b-d3f3-9a13-93d1-f83a9bc6ed80</bs:uuid> |
44 | ···············<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор города региона (города регионального подчинения) страны в соответствии со справочником РСХН. | <bs:guid>a16545f3-8f9c-2778-099f-a5d302e58712</bs:guid> |
45 | ···············<dt:name> | bs:String255 | [1..1] | Наименование города региона (города регионального подчинения) страны в соответствии со справочником РСХН. | <dt:name>Владимир г</dt:name> |
46 | ············</dt:locality> | ||||
47 | ············<dt:subLocality> | dt:Locality | [0..1] | Населённый пункт, подчиненный другогому населенному пункту (locality) | |
48 | ···············<bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор населенного пункта в соответствии со справочником РСХН. | <bs:uuid>3a7b2d0c-2ebd-0dff-9e93-341097ee1db3</bs:uuid> |
49 | ···············<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор населенного пункта в соответствии со справочником РСХН. | <bs:guid>9f315346-b470-3a1c-56d0-ae1afe9579df</bs:guid> |
50 | ···············<dt:name> | bs:String255 | [1..1] | Наименование населенного пункта в соответствии со справочником РСХН. | <dt:name>Энергетик мкрн</dt:name> |
51 | ············</dt:subLocality> | ||||
52 | ············<dt:street> | dt:Street | [0..1] | Улица | |
53 | ···············<bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор улицы города страны в соответствии со справочником РСХН. | <bs:uuid>90d82878-431a-0cf1-0974-16d4fdff3bc8</bs:uuid> |
54 | ···············<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор улицы города в соответствии со справочником РСХН. | <bs:guid>b014d26b-5391-c852-caa4-60fc9bb0a7d4</bs:guid> |
55 | ···············<dt:name> | bs:String255 | [1..1] | Наименование улицы города в соответствии со справочником РСХН. | <dt:name>Энергетиков ул</dt:name> |
56 | ············</dt:street> | ||||
57 | ············<dt:house> | bs:String255 | [0..1] | Номер дома. | <dt:house>6</dt:house> |
58 | ············<dt:building> | bs:String255 | [0..1] | Номер строения. | <dt:building>1</dt:building> |
59 | ············<dt:room> | bs:String255 | [0..1] | Номер квартиры / офиса. | <dt:room>1</dt:room> |
60 | ············<dt:postIndex> | bs:String255 | [0..1] | Почтовый индекс. | <dt:postIndex>600037</dt:postIndex> |
61 | ············<dt:postBox> | bs:String255 | [0..1] | Абонентский ящик | <dt:postBox>а/я 56</dt:postBox> |
62 | ············<dt:additionalInfo> | bs:String255 | [0..1] | Дополнительная информация. | <dt:additionalInfo>Доп. инфо</dt:additionalInfo> |
63 | ············<dt:addressView> | bs:String255 | [0..1] | Строковое представление адреса. | <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView> |
64 | ·········</dt:juridicalAddress> | ||||
65 | ······</dt:businessEntity> | ||||
66 | ···</dt:businessEntityList> | ||||
67 | </ws:getBusinessEntityChangesListResponse> |
Описание ошибок
Ошибка | Описание |
---|---|
InternalServiceFault | Внутренняя ошибка сервиса. |
IncorrectRequestFault | Некорректный запрос. Возникает, если запрос не соответствует требованиям указанным в xsd. |
OffsetOutOfRangeFault | Заданный в запросе отступ больше числа записей в результате запроса. |
Примеры запросов
Поиск хозяйствующего субъекта по ИНН
Запрос хозяйствующего субъекта по ИНН
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">
<soapenv:Header/>
<soapenv:Body>
<ws:getBusinessEntityListRequest>
<dt:businessEntity>
<dt:inn>3325009322</dt:inn>
</dt:businessEntity>
</ws:getBusinessEntityListRequest>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос.
Поиск хозяйствующих субъектов, в названии которых содержится слово "Мясокомбинат"
Поиск хозяйствующего субъекта, в названии которого содержится слово "Мясокомбинат"
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">
<soapenv:Header/>
<soapenv:Body>
<ws:getBusinessEntityListRequest>
<dt:businessEntity>
<dt:name>Мясокомбинат</dt:name>
</dt:businessEntity>
</ws:getBusinessEntityListRequest>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос.
Поиск физических лиц и индивидуальных предпринимателей с фамилией "Иванов"
Поиск физических лиц и индивидуальных предпринимателей с фамилией "Иванов". Вывод первых трёх записей без смещения.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">
<soapenv:Header/>
<soapenv:Body>
<ws:getBusinessEntityListRequest>
<bs:listOptions>
<bs:count>3</bs:count>
<bs:offset>0</bs:offset>
</bs:listOptions>
<dt:businessEntity>
<dt:fio>Иванов</dt:fio>
</dt:businessEntity>
</ws:getBusinessEntityListRequest>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос.
Поиск хозяйствующих субъектов, расположенных на территории Владимирской области
Поиск хозяйствующих субъектов, расположенных на территории Владимирской области. Вывод первых трёх записей без смещения.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">
<soapenv:Header/>
<soapenv:Body>
<ws:getBusinessEntityListRequest>
<bs:listOptions>
<bs:count>3</bs:count>
<bs:offset>0</bs:offset>
</bs:listOptions>
<dt:businessEntity>
<dt:juridicalAddress>
<dt:region>
<bs:guid>b8837188-39ee-4ff9-bc91-fcc9ed451bb3</bs:guid>
</dt:region>
</dt:juridicalAddress>
</dt:businessEntity>
</ws:getBusinessEntityListRequest>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос.