GetProductItemByUuid v2.0

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

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

Операция GetProductItemByUuid предназначена для получения записи о номенклатуре производителя (4 уровень иерархического справочника) по уникальному идентификатору версии записи. Запись может быть не последней и/или не актуальной (last=false, active=false). Номенклатура может быть изменена при помощи метода ModifyProducerStockListOperation, при изменении глобальный идентификатор GUID останется прежним, идентификатор версии записи UUID изменится. Выполнение операции заканчивается либо возвратом объекта номенклатуры производителя, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

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

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

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

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

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

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

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:getProductItemByUuidResponse>
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></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 ······<bs:next>UUID</bs:next> bs:UUID [0..1] Идентификатор следующей версии записи.
012 ······<dt:globalID>85672854</dt:globalID> dt:GTINType [0..1]

Trade Identification Number (GTIN).

  • идентификационный номер продукции производителя
013 ······<dt:name>Название</dt:name> bs:String255 [0..1] Наименование продукции.
014 ······<dt:code>12</dt:code> bs:String255 [0..1]

Артикул.

  • код продукции в соответствии с внутренним кодификатором производителя
015 ······<dt:productType>1</dt:productType> dt:ProductType [1..1]

Тип продукции.

  • первый уровень иерархического справочника продукции ИС Меркурий
016 ······<dt:product> dt:Product [1..1]

Продукция.

  • второй уровень иерархического справочника продукции ИС Меркурий
017 ·········<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии продукции.
018 ·········<bs:guid>GUID</bs:guid> bs:UUID [1..1] Глобальный идентификатор продукции.
019 ······</dt:product>
020 ······<dt:subProduct> dt:SubProduct [1..1]

Вид продукции.

  • третий уровень иерархического справочника продукции ИС Меркурий
021 ·········<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии вида продукции.
022 ·········<bs:guid>GUID</bs:guid> bs:UUID [1..1] Глобальный идентификатор вида продукции.
023 ······</dt:subProduct>
024 ······<dt:correspondsToGost>true</dt:correspondsToGost> xs:boolean [1..1] Соответствует ли ГОСТу.
025 ······<dt:gost>ГОСТ-621187/53</dt:gost> bs:String255 [0..1] ГОСТ.
026 ······<dt:producer> dt:BusinessEntity [0..1] ХС-производитель продукции.
027 ·········<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии хозяйствующего субъекта-владельца.
028 ·········<bs:guid>GUID</bs:uuid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта-владельца.
029 ······</dt:producer>
030 ······<dt:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки.
031 ·········<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии хозяйствующего субъекта-владельца.
032 ·········<bs:guid>GUID</bs:uuid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта-владельца.
033 ······</dt:tmOwner>
034 ······<dt:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция.
035 ········<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции.
036 ············<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии предприятия.
037 ············<bs:guid>GUID</bs:uuid> bs:UUID [1..1] Глобальный идентификатор предприятия.
038 ·········</dt:location>
039 ······</dt:producing>
040 ······<dt:packaging> dt:Packaging [0..1] Фасовка.
041 ·········<dt:packagingType>1</dt:packagingType> dt:PackingType [1..1] Тип упаковки.
042 ············<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии типа упаковки.
043 ············<bs:guid>GUID</bs:uuid> bs:UUID [1..1] Глобальный идентификатор упаковки.
044 ············<dt:globalID>7B</dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки.
045 ············<dt:name>Название</dt:name> bs:String255 [1..1] Наименование упаковки.
046 ·········</dt:packagingType>
047 ·········<dt:quantity>10</dt:quantity> xs:int [0..1] Количество единиц упаковки.
048 ·········<dt:volume>50</dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара.
049 ·········<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара.
050 ············<bs:uuid>UUID</bs:uuid> bs:UUID [1..1] Идентификатор версии еиницы измерения.
051 ············<bs:guid>GUID</bs:uuid> bs:UUID [1..1] Глобальный идентификатор еиницы измерения.
052 ············<dt:name>кг</dt:name> bs:String255 [1..1] Наименование единицы измерения
053 ·········</dt:unit>
054 ······</dt:packaging>
055 ···</dt:productItem>
056 </ws:getProductItemByUuidResponse>

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

Ошибка Описание
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:getProductItemByUuidRequest>
         <bs:uuid>3aefb5af-4244-4563-8481-5e83bb28e2e9</bs:uuid>
      </ws:getProductItemByUuidRequest>
   </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:getProductItemByUuidResponse 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:getProductItemByUuidResponse>
   </soap:Body>
</soapenv:Envelope>