GetProductItemByGuid v2.0

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

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

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

• глобальный уникальный идентификатор номенклатуры производителя.

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

• данные номенклатуры производителя.

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemByGuidRequest>
002	···<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор номенклатуры.
003	</ws:getProductItemByGuidRequest>

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

#	Название XML-элемента	Тип	Обязат.	Описание (нажмите [...] для отображения дополнительного описания)
001	<ws:getProductItemByGuidResponse>
002	···<dt:productItem>	dt:ProductItem	[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]	Описывает, является ли запись активной. true - запись активна; false - запись не активна.
006	······<bs:last>true</bs:last>	xs:boolean	[1..1]	Описывает, является ли версия записи последней. true - да; false - нет.
007	······<bs:status>100</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:globalID>85672854</dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) идентификационный номер продукции производителя
012	······<dt:name>Название</dt:name>	bs:String255	[0..1]	Наименование продукции.
013	······<dt:code>12</dt:code>	bs:String255	[0..1]	Артикул . код продукции в соответствии с внутренним кодификатором производителя
014	······<dt:productType>1</dt:productType>	dt:ProductType	[1..1]	Тип продукции. первый уровень иерархического справочника продукции ИС Меркурий
015	······<dt:product>	dt:Product	[1..1]	Продукция. второй уровень иерархического справочника продукции ИС Меркурий
016	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии продукции.
017	·········<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции.
018	······</dt:product>
019	······<dt:subProduct>	dt:SubProduct	[1..1]	Вид продукции. третий уровень иерархического справочника продукции ИС Меркурий
020	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции.
021	·········<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.
022	······</dt:subProduct>
023	······<dt:correspondsToGost>true</dt:correspondsToGost>	xs:boolean	[1..1]	Соответствует ли ГОСТу.
024	······<dt:gost>ГОСТ-621187/53</dt:gost>	bs:String255	[0..1]	ГОСТ.
025	······<dt:producer>	dt:BusinessEntity	[0..1]	ХС-производитель продукции.
026	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии хозяйствующего субъекта-владельца.
027	·········<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта-владельца.
028	······</dt:producer>
029	······<dt:tmOwner>	dt:BusinessEntity	[0..1]	ХС-собственник торговой марки.
030	·········<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии хозяйствующего субъекта-владельца.
031	·········<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта-владельца.
032	······</dt:tmOwner>
033	······<dt:producing>	dt:ProductItemProducing	[0..*]	Список площадок, на которых выпускается данная продукция.
034	········<dt:location>	dt:Enterprise	[1..1]	Площадка, осуществляющая выпуск продукции.
035	············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии предприятия.
036	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор предприятия.
037	·········</dt:location>
038	······</dt:producing>
039	······<dt:packaging>	dt:Packaging	[0..1]	Фасовка.
040	·········<dt:packagingType>1</dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки.
041	············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии типа упаковки.
042	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор упаковки.
043	············<dt:globalID>7B</dt:globalID>	dt:PackingCodeType	[1..1]	Уникальный идентификатор упаковки.
044	············<dt:name>Название</dt:name>	bs:String255	[1..1]	Наименование упаковки.
045	·········</dt:packagingType>
046	·········<dt:quantity>10</dt:quantity>	xs:int	[0..1]	Количество единиц упаковки.
047	·········<dt:volume>50</dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара.
048	·········<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара.
049	············<bs:uuid>UUID</bs:uuid>	bs:UUID	[1..1]	Идентификатор версии единицы измерения.
050	············<bs:guid>GUID</bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор единицы измерения.
051	············<dt:name>	bs:String255	[1..1]	Наименование единицы измерения
052	·········</dt:unit>кг</dt:name>
053	······</dt:packaging>
054	···</dt:productItem>
055	</ws:getProductItemByGuidResponse>

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

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

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

Запрос данных о номенклатуре производителя по его глобальному идентификатору.

<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">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getProductItemByGuidRequest>
         <bs:guid>31be83d0-4867-43fb-a3b6-460a03bd260b</bs:guid>
      </ws:getProductItemByGuidRequest>
   </soapenv:Body>
</soapenv:Envelope>

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

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soap:Body xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
      <v2:getProductItemByGuidResponse xmlns:bs="http://api.vetrf.ru/schema/cdm/base" xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" xmlns:v2="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2">
         <dt:productItem>
            <bs:uuid>3aefb5af-4244-4563-8481-5e83bb28e2e9</bs:uuid>
            <bs:guid>31be83d0-4867-43fb-a3b6-460a03bd260b</bs:guid>
            <bs:active>false</bs:active>
            <bs:last>true</bs:last>
            <bs:status>400</bs:status>
            <bs:createDate>2017-08-23T19:53:23+03:00</bs:createDate>
            <bs:updateDate>2017-08-23T19:53:23+03:00</bs:updateDate>
            <bs:previous>3e8d9859-a635-4b61-9c5b-cf48fa186255</bs:previous>
            <dt:name>Филе Cциллы мороженое (100% качество)</dt:name>
            <dt:code>001122</dt:code>
            <dt:productType>7</dt:productType>
            <dt:product>
               <bs:uuid>339a2e35-d937-b97d-33eb-5bec659483ce</bs:uuid>
               <bs:guid>41fb53ea-31c3-b116-9ce2-7d7df18c5835</bs:guid>
            </dt:product>
            <dt:subProduct>
               <bs:uuid>ebf8177a-378e-034c-8c88-6e6a5349a571</bs:uuid>
               <bs:guid>9956d97a-6231-a1a3-7726-ad538a3ff3fc</bs:guid>
            </dt:subProduct>
            <dt:correspondsToGost>false</dt:correspondsToGost>
            <dt:producing>
               <dt:location>
                  <bs:uuid>33aff5fa-b9d5-4109-8c00-bca490c24107</bs:uuid>
                  <bs:guid>87e0bc14-5e9f-4861-ba2d-5766662475d9</bs:guid>
               </dt:location>
            </dt:producing>
         </dt:productItem>
      </v2:getProductItemByGuidResponse>
   </soap:Body>
</soapenv:Envelope>