GetBusinessEntityByGUID v2
Общие сведения
Операция GetBusinessEntityByGUID предназначена для получения последней в истории записи хозяйствующего субъекта по её глобальному идентификатору (active=true, last=true). Выполнение операции заканчивается либо возвратом записи хозяйствующего субъекта, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.
Входные данные
- глобальный уникальный идентификатор хозяйствующего субъекта.
Выходные данные
- хозяйствующий субъект.
Спецификация запроса
# | Название XML-элемента | Тип | Обязат. | Описание (нажмите [...] для отображения дополнительного описания) |
---|---|---|---|---|
001 | <ws:getBusinessEntityByGuidRequest> | |||
002 | ···<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор хозяйствующего субъекта. |
003 | </ws:getBusinessEntityByGuidRequest> |
Спецификация ответа
# | Название XML-элемента | Тип | Обязат. | Описание (нажмите [...] для отображения дополнительного описания) |
---|---|---|---|---|
001 | <ws:getBusinessEntityByGuidResponse> | |||
002 | ···<dt:businessEntity> | dt:BusinessEntity | [1..1] | Данные о хозяйствующем субъекте. |
003 | ······<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Идентификатор версии хозяйствующего субъекта. |
004 | ······<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор хозяйствующего субъекта. |
005 | ······<bs:active>true</bs:active> | xs:boolean | [1..1] | Описывает, является ли запись активной.
|
006 | ······<bs:last>true</bs:last> | xs:boolean | [1..1] | Описывает, является ли версия записи последней.
|
007 | ······<bs:status>230</bs:status> | bs:VersionStatus | [1..1] | Статус версии хозяйствующего субъекта. |
008 | ······<bs:createDate>2017-07-07T12:00:00</bs:createDate> | xs:DateTime | [1..1] | Дата создания хозяйствующего субъекта. |
009 | ······<bs:updateDate>2017-07-07T12:00:00</bs:updateDate> | xs:DateTime | [1..1] | Дата изменения хозяйствующего субъекта. |
010 | ······<bs:previous>UUID</bs:previous> | bs:UUID | [0..1] | Идентификатор предыдущей версии записи реестра хозяйствующих субъектов. |
011 | ······<dt:type>1</dt:type> | dt:BusinessEntityType | [1..1] | Тип создаваемого или редактируемого хозяйствующего субъекта.
|
012 | ······<dt:name>Наименование ХС</dt:name> | bs:String255 | [0..1] | Наименование хозяйствующего субъекта без указания организационно-правовой формы.
|
013 | ······<dt:incorporationForm> | dt:IncorporationForm | [1..1] | Организационно-правовая форма хозяйствующего субъекта. |
014 | ·········<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Идентификатор версии организационно-правовой формы. |
015 | ·········<dt:name>Наименование ОПФ</dt:name> | bs:String255 | [1..1] | Название организационно-правовой формы предприятия.
|
016 | ·········<dt:code>12300</dt:code> | bs:String255 | [1..1] | Код организационно-правовой формы предприятия.
|
017 | ·········<dt:shortName>Краткое наименование ОПФ</dt:shortName> | bs:String255 | [0..1] | Краткое название организационно-правовой формы предприятия. |
018 | ······</dt:incorporationForm> | |||
019 | ······<dt:fullName>Полное наименование ХС</dt:fullName> | bs:String255 | [0..1] | Полное наименование хозяйствующего субъекта.
|
020 | ······<dt:fio>Иванов Иван Иванович</dt:fio> | bs:String255 | [0..1] | ФИО физического лица или индивидуального предпринимателя.
|
021 | ······<dt:inn>3312200096</dt:inn> | bs:String255 | [0..1] | ИНН хозяйствующего субъекта. |
022 | ······<dt:kpp>163501001</dt:kpp> | bs:String255 | [0..1] | Код причины постановки на учет (КПП). |
023 | ······<dt:ogrn>4085022240002</dt:ogrn> | bs:String255 | [0..1] | ОГРН или ОГРНИП.
|
024 | ······<dt:juridicalAddress> | dt:Address | [1..1] | Юридический адрес.
|
025 | ·········<dt:country> | dt:Country | [1..1] | Страна. |
026 | ············<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор страны.
|
027 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор страны.
|
028 | ············<dt:name>Страна</dt:name> | bs:String255 | [1..1] | Наименование страны.
|
029 | ·········</dt:country> | |||
030 | ·········<dt:region> | dt:Region | [1..1] | Регион. |
031 | ············<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор региона страны.
|
032 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор региона страны.
|
033 | ············<dt:name>Регион</dt:name> | bs:String255 | [1..1] | Наименование региона страны.
|
034 | ·········</dt:region> | |||
035 | ·········<dt:district> | dt:Locality | [0..1] | Район региона. |
036 | ············<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор района региона.
|
037 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор района региона.
|
038 | ············<dt:name>Район</dt:name> | bs:String255 | [1..1] | Наименование района региона.
|
039 | ·········</dt:district> | |||
040 | ·········<dt:locality> | dt:Locality | [0..1] | Населённый пункт. |
041 | ············<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор города региона (города регионального подчинения) страны.
|
042 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор города региона (города регионального подчинения) страны.
|
043 | ············<dt:name>Город</dt:name> | bs:String255 | [1..1] | Наименование города региона (города регионального подчинения) страны.
|
044 | ·········</dt:locality> | |||
045 | ·········<dt:subLocality> | dt:Locality | [0..1] | Населённый пункт, подчиненный другогому населенному пункту (locality). |
046 | ············<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор населенного пункта.
|
047 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор населенного пункта.
|
048 | ············<dt:name>Населенный пункт</dt:name> | bs:String255 | [1..1] | Наименование населенного пункта.
|
049 | ·········</dt:subLocality> | |||
050 | ·········<dt:street> | dt:Street | [0..1] | Улица. |
051 | ············<bs:uuid>UUID</bs:uuid> | bs:UUID | [1..1] | Уникальный идентификатор улицы города страны.
|
052 | ············<bs:guid>GUID</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор улицы города.
|
053 | ············<dt:name>Улица</dt:name> | bs:String255 | [1..1] | Наименование улицы города.
|
054 | ·········</dt:street> | |||
055 | ·········<dt:house>0</dt:house> | bs:String255 | [0..1] | Номер дома. |
056 | ·········<dt:building>0</dt:building> | bs:String255 | [0..1] | Номер строения. |
057 | ·········<dt:room>0</dt:room> | bs:String255 | [0..1] | Номер квартиры / офиса. |
058 | ·········<dt:postIndex>000000</dt:postIndex> | bs:String255 | [0..1] | Почтовый индекс. |
059 | ·········<dt:postBox>х/х 00</dt:postBox> | bs:String255 | [0..1] | Абонентский ящик. |
060 | ·········<dt:additionalInfo>Доп. инфо</dt:additionalInfo> | bs:String255 | [0..1] | Дополнительная информация. |
061 | ·········<dt:addressView>Адрес</dt:addressView> | bs:String255 | [0..1] | Строковое представление адреса. |
062 | ······</dt:juridicalAddress> | |||
063 | ···</dt:businessEntity> | |||
064 | </ws:getBusinessEntityByGuidResponse> |
Описание ошибок
Ошибка | Описание |
---|---|
InternalServiceFault | Внутренняя ошибка сервиса. |
IncorrectRequestFault | Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям, указанным в xsd. |
EntityNotFoundFault | Объект с заданными параметрами не найден в базе. |
Пример запроса
Запрос хозяйствующего субъекта по глобальному идентификатору.
<soapenv:Envelope xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Header/>
<soapenv:Body>
<ws:getBusinessEntityByGuidRequest>
<bs:guid>fd464254-218a-11e2-a69b-b499babae7ea</bs:guid>
</ws:getBusinessEntityByGuidRequest>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос.