GetBusinessMemberByGLN v2: различия между версиями

Текущая версия на 12:01, 1 июня 2023

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

Операция GetBusinessMemberByGLN предназначена для получения пары "хозяйствующий субъект - площадка" по GLN. Выполнение операции заканчивается либо возвратом записи типа dt:BusinessMember, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

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

GLN, по которому будет производиться поиск площадки.

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

объект типа dt:BusinessMember.

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getBusinessMemberByGLNRequest>
002	···<dt:globalID>4607009526782</dt:globalID>	dt:GLNType	[1..1]	Global Location Number (GLN). уникальный номер площадки хозяйствующего субъекта, на которой он осуществляет деятельность. См. http://www.gs1.org/gln.
003	</ws:getBusinessMemberByGLNRequest>

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getBusinessMemberByGLNResponse>
002	···<dt:businessMember>	dt:BusinessMember	[1..1]	Сведения об отправителе (владельце). Содержит сведения о хозяйствующем субъекте-владельце продукции и предприятии-отправителе.
003	······<dt:businessEntity>	dt:BusinessEntity	[1..1]	Данные о хозяйствующем субъекте.
004	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии хозяйствующего субъекта.
005	·········<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта.
006	·········<bs:active>true</bs:active>	xs:boolean	[1..1]	Описывает, является ли запись активной. true - запись активна; false - запись не активна.
007	·········<bs:last>true</bs:last>	xs:boolean	[1..1]	Описывает, является ли версия записи последней. true - да; false - нет.
008	·········<bs:status>200</bs:status>	bs:VersionStatus	[1..1]	Статус версии хозяйствующего субъекта.
009	·········<bs:createDate>2017-07-07T12:00:00</bs:createDate>	xs:DateTime	[1..1]	Дата создания хозяйствующего субъекта.
010	·········<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>	xs:DateTime	[1..1]	Дата изменения хозяйствующего субъекта.
011	·········<bs:previous>UUID</bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи реестра хозяйствующих субъектов.
012	·········<bs:next>UUID</bs:next>	bs:UUID	[0..1]	Идентификатор следующей версии записи реестра хозяйствующих субъектов.
013	·········<dt:type>1</dt:type>	dt:BusinessEntityType	[1..1]	Тип создаваемого или редактируемого хозяйствующего субъекта. 1 - юридическое лицо; 2 - физическое лицо; 3 - индивидуальный предприниматель.
014	·········<dt:name>Наименование ХС</dt:name>	bs:String255	[0..1]	Наименование хозяйствующего субъекта без указания организационно-правовой формы. Возвращается только для юридических лиц. Для физических лиц и для индивидуальных предпринимателей поле не возвращается.
015	·········<dt:incorporationForm>	dt:IncorporationForm	[1..1]	Организационно-правовая форма хозяйствующего субъекта.
016	············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии организационно-правовой формы.
017	············<dt:name>Акционерное общество</dt:name>	bs:String255	[1..1]	Название организационно-правовой формы предприятия согласно справочнику ОКОПФ.
018	············<dt:code>12300</dt:code>	bs:String255	[1..1]	Код организационно-правовой формы предприятия согласно справочнику ОКОПФ.
019	············<dt:shortName>АО</dt:shortName>	bs:String255	[0..1]	Краткое название организационно-правовой формы предприятия.
020	·········</dt:incorporationForm>
021	·········<dt:fullName>Акционерное общество "Наименование ХС"</dt:fullName>	bs:String255	[0..1]	Полное наименование хозяйствующего субъекта . с указанием ОПФ так, как оно значится в ЕГРЮЛ/ЕГРИП.
022	·········<dt:fio>Иванов Иван Иванович</dt:fio>	bs:String255	[0..1]	ФИО физического лица или индивидуального предпринимателя. Для юридических лиц поле не возвращается.
023	·········<dt:inn>3312200096</dt:inn>	bs:String255	[0..1]	ИНН хозяйствующего субъекта.
024	·········<dt:kpp>163501001</dt:kpp>	bs:String255	[0..1]	Код причины постановки на учет (КПП).
025	·········<dt:ogrn>4085022240002</dt:ogrn>	bs:String255	[0..1]	ОГРН или ОГРНИП. Для ИП ОГРНИП может быть не указано.
026	·········<dt:juridicalAddress>	dt:Address	[1..1]	Юридический адрес. адрес, по которому зарегистрирован хозяйствующий субъект.
027	············<dt:country>	dt:Country	[1..1]	Страна.
028	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор страны. в соответствии со справочником РСХН.
029	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор страны. в соответствии со справочником РСХН.
030	···············<dt:name>Страна</dt:name>	bs:String255	[1..1]	Наименование страны. в соответствии со справочником РСХН.
031	············</dt:country>
032	············<dt:region>	dt:Region	[1..1]	Регион (республика, область, край, автономная область).
033	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор региона страны. в соответствии со справочником РСХН.
034	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор региона страны. в соответствии со справочником РСХН.
035	···············<dt:name>Регион</dt:name>	bs:String255	[1..1]	Наименование региона страны. в соответствии со справочником РСХН.
036	············</dt:region>
037	············<dt:district>	dt:Locality	[0..1]	Район региона.
038	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор района региона. в соответствии со справочником РСХН.
039	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор района региона. в соответствии со справочником РСХН.
040	···············<dt:name>Район</dt:name>	bs:String255	[1..1]	Наименование района региона. в соответствии со справочником РСХН.
041	············</dt:district>
042	············<dt:locality>	dt:Locality	[0..1]	Населённый пункт.
043	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор города региона (города регионального подчинения) страны. в соответствии со справочником РСХН.
044	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор города региона (города регионального подчинения) страны . в соответствии со справочником РСХН.
045	···············<dt:name>Город</dt:name>	bs:String255	[1..1]	Наименование города региона (города регионального подчинения) страны. в соответствии со справочником РСХН.
046	············</dt:locality>
047	············<dt:subLocality>	dt:Locality	[0..1]	Населённый пункт, подчиненный другому населенному пункту (locality).
048	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор населенного пункта. в соответствии со справочником РСХН.
049	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор населенного пункта. в соответствии со справочником РСХН.
050	···············<dt:name>Населенный пункт</dt:name>	bs:String255	[1..1]	Наименование населенного пункта. в соответствии со справочником РСХН.
051	············</dt:subLocality>
052	············<dt:street>	dt:Street	[0..1]	Улица.
053	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор улицы города страны. в соответствии со справочником РСХН.
054	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор улицы города. в соответствии со справочником РСХН.
055	···············<dt:name>Улица</dt:name>	bs:String255	[1..1]	Наименование улицы города. в соответствии со справочником РСХН.
056	············</dt:street>
057	············<dt:house>6</dt:house>	bs:String255	[0..1]	Номер дома.
058	············<dt:building>1</dt:building>	bs:String255	[0..1]	Номер строения.
059	············<dt:room>1</dt:room>	bs:String255	[0..1]	Номер квартиры / офиса.
060	············<dt:postIndex>000000</dt:postIndex>	bs:String255	[0..1]	Почтовый индекс.
061	············<dt:postBox>а/я 00</dt:postBox>	bs:String255	[0..1]	Абонентский ящик.
062	············<dt:additionalInfo>Доп. инфо</dt:additionalInfo>	bs:String255	[0..1]	Дополнительная информация.
063	············<dt:addressView>Адрес</dt:addressView>	bs:String255	[0..1]	Строковое представление адреса.
064	·········</dt:juridicalAddress>
065	······</dt:businessEntity>
066	······<dt:enterprise>	dt:Enterprise	[1..1]	Данные о поднадзорном объекте.
067	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии поднадзорного объекта.
068	·········<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор поднадзорного объекта.
069	·········<bs:active>true</bs:active>	xs:boolean	[1..1]	Описывает, является ли запись активной. true - запись активна; false - запись не активна.
070	·········<bs:last>true</bs:last>	xs:boolean	[1..1]	Описывает, является ли версия записи последней. true - да; false - нет.
071	·········<bs:status>200</bs:status>	bs:VersionStatus	[1..1]	Статус версии поднадзорного объекта.
072	·········<bs:createDate>2017-07-07T12:00:00</bs:createDate>	xs:DateTime	[1..1]	Дата создания поднадзорного объекта.
073	·········<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>	xs:DateTime	[1..1]	Дата изменения поднадзорного объекта.
074	·········<bs:previous>UUID</bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи реестра поднадзорных объектов.
075	·········<bs:next>UUID</bs:next>	bs:UUID	[0..1]	Идентификатор следующей версии записи реестра поднадзорных объектов.
076	·········<dt:name>Наименование ПО</dt:name>	bs:String255	[1..1]	Полное наименование поднадзорного объекта.
077	·········<dt:type>1</dt:type>	dt:EnterpriseType	[1..1]	Тип поднадзорного объекта. 1 - предприятие; 2 - рынок; 3 - СББЖ; 4 - судно.
078	·········<dt:numberList>	dt:EnterpriseNumberList	[0..1]	Список номеров предприятия.
079	············<dt:enterpriseNumber>RU751</dt:enterpriseNumber>	bs:String255	[1..*]	Номер предприятия.
080	·········</dt:numberList>
081	·········<dt:address>	dt:Address	[1..1]	Фактический адрес расположения поднадзорного объекта.
082	············<dt:country>	dt:Country	[1..1]	Страна.
083	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор страны. в соответствии со справочником РСХН.
084	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор страны. в соответствии со справочником РСХН.
085	···············<dt:name>Страна</dt:name>	bs:String255	[1..1]	Наименование страны. в соответствии со справочником РСХН.
086	············</dt:country>
087	············<dt:region>	dt:Region	[1..1]	Регион (республика, область, край, автономная область).
088	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор региона страны. в соответствии со справочником РСХН.
089	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор региона страны. в соответствии со справочником РСХН.
090	···············<dt:name>Регион</dt:name>	bs:String255	[1..1]	Наименование региона страны. в соответствии со справочником РСХН.
091	············</dt:region>
092	············<dt:district>	dt:Locality	[0..1]	Район региона.
093	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор района региона. в соответствии со справочником РСХН.
094	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор района региона. в соответствии со справочником РСХН.
095	···············<dt:name>Район</dt:name>	bs:String255	[1..1]	Наименование района региона. в соответствии со справочником РСХН.
096	············</dt:district>
097	············<dt:locality>	dt:Locality	[0..1]	Населённый пункт.
098	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор города региона (города регионального подчинения) страны. в соответствии со справочником РСХН.
099	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор города региона (города регионального подчинения) страны. в соответствии со справочником РСХН.
100	···············<dt:name>Город</dt:name>	bs:String255	[1..1]	Наименование города региона (города регионального подчинения) страны. в соответствии со справочником РСХН.
101	············</dt:locality>
102	············<dt:subLocality>	dt:Locality	[0..1]	Населённый пункт, подчиненный другому населенному пункту (locality).
103	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор населенного пункта. в соответствии со справочником РСХН.
104	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор населенного пункта. в соответствии со справочником РСХН.
105	···············<dt:name>Населенный пункт</dt:name>	bs:String255	[1..1]	Наименование населенного пункта. в соответствии со справочником РСХН.
106	············</dt:subLocality>
107	············<dt:street>	dt:Street	[0..1]	Улица.
108	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Уникальный идентификатор улицы города страны. в соответствии со справочником РСХН.
109	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор улицы города. в соответствии со справочником РСХН.
110	···············<dt:name>Улица</dt:name>	bs:String255	[1..1]	Наименование улицы города. в соответствии со справочником РСХН.
111	············</dt:street>
112	············<dt:house>6</dt:house>	bs:String255	[0..1]	Номер дома.
113	············<dt:building>1</dt:building>	bs:String255	[0..1]	Номер строения.
114	············<dt:room>1</dt:room>	bs:String255	[0..1]	Номер квартиры / офиса.
115	············<dt:postIndex>000000</dt:postIndex>	bs:String255	[0..1]	Почтовый индекс.
116	············<dt:postBox>а/я 00</dt:postBox>	bs:String255	[0..1]	Абонентский ящик.
117	············<dt:additionalInfo>Доп. информация</dt:additionalInfo>	bs:String255	[0..1]	Дополнительная информация.
118	············<dt:addressView>Адрес</dt:addressView>	bs:String255	[0..1]	Строковое представление адреса.
119	·········</dt:address>
120	·········<dt:activityList total="2" offset="0" count="2">	dt:EnterpriseActivityList	[1..1]	Виды деятельности поднадзорного объекта.
121	············<dt:activity>	dt:EnterpriseActivity	[1..*]	Деятельность, осуществляемая предприятием.
122	···············<dt:name>Реализация пищевых продуктов</dt:name>	bs:NText	[1..1]	Название вида деятельности.
123	············</dt:activity>
124	·········</dt:activityList>
125	·········<dt:owner>	dt:BusinessEntity	[0..1]	ХС-владелец поднадзорного объекта.
126	············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор хозяйствующего субъекта.
127	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта.
128	············<dt:name>Наименование ХС</dt:name>	bs:String255	[0..1]	Наименование хозяйствующего субъекта.
129	············<dt:juridicalAddress>	dt:Address	[0..1]	Юридический адрес.
130	···············<dt:addressView>Адрес</dt:addressView>	bs:String255	[0..1]	Строковое представление адреса.
131	············</dt:juridicalAddress>
132	·········</dt:owner>
133	·········<dt:officialRegistration>	dt:EnterpriseOfficialRegistration	[0..*]	Факт постановки на учёт в налоговом органе.
134	············<dt:ID>6789198</dt:ID>	dt:GRNType	[0..1]	Государственный номер регистрации ФНС.
135	············<dt:businessEntity>	dt:BusinessEntity	[1..1]	Хозяйствующий субъект, поставивший площадку на учёт в налоговом органе.
136	···············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор хозяйствующего субъекта.
137	···············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта.
138	············</dt:businessEntity>
139	············<dt:kpp>163501001</dt:kpp>	bs:String255	[1..1]	Код причины постановки на учёт (КПП).
140	·········<dt:officialRegistration>
141	······</dt:enterprise>
142	······<dt:globalID>4607009526782</dt:globalID>	dt:GLNType	[1..1]	Global Location Number (GLN). уникальный номер площадки хозяйствующего субъекта, на которой он осуществляет деятельность. См. http://www.gs1.org/gln.
143	···</dt:businessMember>
144	</ws:getBusinessMemberByGLNResponse>

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

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

Пример запроса

Поиск предприятия по GLN.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2" 
                  xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getBusinessMemberByGLNRequest>
         <dt:globalID>1234567890123</dt:globalID>
      </ws:getBusinessMemberByGLNRequest>
   </soapenv:Body>
</soapenv:Envelope>

Ответ на запрос.