GetProductItemChangesList v2.0

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

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

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

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

  • параметры выводимого списка;
  • интервал дат, за который запрашиваются изменения;
  • идентификатор предприятия, по номенклатуре которого запрашивается список изменений;
  • идентификатор хозяйствующего субъекта, по номенклатуре которого запрашивается список изменений.

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

  • список наименований продукции, изменённых за указанный период.

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:getProductItemChangeListRequest>
002 ···<bs:listOptions> bs:ListOptions [0..1] Параметры запрашиваемого списка.
003 ······<bs:count>10</bs:count> xs:nonNegativeInteger [0..1]

Максимальное запрашиваемое количество объектов в списке.

  • По умолчанию значение 100;
  • Максимально возможное значение 1000.
004 ······<bs:offset>2</bs:offset> xs:nonNegativeInteger [0..1]

Номер элемента, по которому осуществляется смещение первого элемента списка.

  • По умолчанию значение 0.
005 ···</bs:listOptions>
006 ···<bs:updateDateInterval> bs:DataInterval [1..1]

Интервал времени обновления.

  • В список попадают все записи, дата обновлений которых попадает в указанный интервал.
007 ······<bs:beginDate>2017-07-07T00:00:00</bs:beginDate> xs:dateTime [1..1] Начало временного интервала.
008 ······<bs:endDate>2017-07-25T00:00:00</bs:endDate> xs:dateTime [0..1] Конец временного интервала.
009 ···</bs:updateDateInterval>
010 ···<dt:businessEntity> dt:BusinessEntity [0..1] Данные о хозяйствующем субъекте.
011 ······<bs:guid>GUID</bs:guid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта.
012 ···</dt:businessEntity>
013 ···<dt:enterprise> dt:Enterprise [0..1] Данные о предприятии-производителе продукции.
014 ······<bs:guid>GUID</bs:guid> bs:UUID [1..1] Глобальный идентификатор предприятия.
015 ···</dt:enterprise>
016 </ws:getProductItemChangeListRequest>

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

# Название XML-элемента Тип Обязат. Описание (нажмите [...] для отображения дополнительного описания)
001 <ws:getProductItemChangeListResponse>
002 ···<dt:productItemList total="2" offset="0" count="2"> dt:ProductItemList [1..1]

Список номенклатуры.

  • total - всего записей;
  • offset - смещение относительно первого элемента;
  • count - количество выводимых записей.
003 ······<dt:productItem> dt:ProductItem [0..*] Данные о номенклатуре производителя
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>100</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:globalID>85672854</dt:globalID> dt:GTINType [0..1]

Trade Identification Number (GTIN).

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

Артикул.

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

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

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

Продукция.

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

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

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

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

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

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

Запрос списка изменений номенклатуры по всему справочнику

Запрос первых трех записей номенклатуры производителей, измененных с 19.09.2017 по 19.10.2017 без смещения.

<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:getProductItemChangesListRequest>
          <bs:listOptions>
            <bs:count>3</bs:count>
            <bs:offset>0</bs:offset>
         </bs:listOptions>
         <bs:updateDateInterval>
            <bs:beginDate>2017-09-19T00:00:00</bs:beginDate>
            <bs:endDate>2017-10-19T00:00:00</bs:endDate>
         </bs:updateDateInterval>   
      </ws:getProductItemChangesListRequest>
   </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:getProductItemChangesListResponse 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:productItemList count="3" total="34538" offset="0">
            <dt:productItem>
               <bs:uuid>c7b1851e-005e-4f50-bb73-828533a36a41</bs:uuid>
               <bs:guid>3762a01c-d6c3-4e20-af98-f00fb98f34c0</bs:guid>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2016-11-09T15:34:17+03:00</bs:createDate>
               <bs:updateDate>2017-10-01T22:57:45+03:00</bs:updateDate>
               <bs:next>535392c3-0234-4405-bd73-94c5f721862f</bs:next>
               <dt:name>Test interfaces promotion material</dt:name>
               <dt:productType>5</dt:productType>
               <dt:product>
                  <bs:uuid>31c94ff1-a217-f38d-6005-1aa5ca67e146</bs:uuid>
                  <bs:guid>d34504bb-7a93-e1c8-4859-339eafd97c6c</bs:guid>
               </dt:product>
               <dt:subProduct>
                  <bs:uuid>6e6cf1ff-d31f-477e-b506-ce3beb6efdb5</bs:uuid>
                  <bs:guid>5d80c18b-6c64-448d-a71c-d5835b9b5210</bs:guid>
               </dt:subProduct>
               <dt:correspondsToGost>false</dt:correspondsToGost>
               <dt:producing>
                  <dt:location>
                     <bs:uuid>1c59d146-28de-428b-b384-3bfafbf042b1</bs:uuid>
                     <bs:guid>ea28fac7-41bf-8285-a1e5-249d2cd956b3</bs:guid>
                  </dt:location>
               </dt:producing>
            </dt:productItem>
            <dt:productItem>
               <bs:uuid>ffbdb1fb-c290-4aba-8fe3-91529e5ebdbf</bs:uuid>
               <bs:guid>546a1deb-5ab2-409c-bedf-89c12f9dc4b5</bs:guid>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2016-11-18T12:51:56+03:00</bs:createDate>
               <bs:updateDate>2017-10-17T14:27:20+03:00</bs:updateDate>
               <bs:next>49944fbc-2225-42e7-9968-f3226faf3281</bs:next>
               <dt:name>цйуцйуйцу</dt:name>
               <dt:productType>1</dt:productType>
               <dt:product>
                  <bs:uuid>e42c2a82-2624-eeeb-9193-8187a888d276</bs:uuid>
                  <bs:guid>337f79dc-4376-6e33-dabe-d5447913b97d</bs:guid>
               </dt:product>
               <dt:subProduct>
                  <bs:uuid>d9078e32-353c-eb56-3839-9bc09e79bdf5</bs:uuid>
                  <bs:guid>bb7ab7a7-4d5c-f81d-50a9-da5bf9bbb1e9</bs:guid>
               </dt:subProduct>
               <dt:correspondsToGost>false</dt:correspondsToGost>
               <dt:producing>
                  <dt:location>
                     <bs:uuid>b37f72b7-e8fd-4654-b056-150d25dbcec4</bs:uuid>
                     <bs:guid>eb25985a-3eea-4c6c-8df8-ac930874eed7</bs:guid>
                  </dt:location>
               </dt:producing>
            </dt:productItem>
            <dt:productItem>
               <bs:uuid>48392926-0267-4993-9bec-957567311fd7</bs:uuid>
               <bs:guid>99cf4b30-e16a-414e-9338-edc3113e9556</bs:guid>
               <bs:active>false</bs:active>
               <bs:last>false</bs:last>
               <bs:status>200</bs:status>
               <bs:createDate>2017-03-29T14:18:47+03:00</bs:createDate>
               <bs:updateDate>2017-10-03T15:33:32+03:00</bs:updateDate>
               <bs:previous>3bae411d-c569-4eb8-8041-be05e86aef2f</bs:previous>
               <bs:next>4b4de49e-fb2c-4125-84b5-934b4ebe4210</bs:next>
               <dt:globalID>4607153856773</dt:globalID>
               <dt:name>Лойн трески 8*400г (Agama (c) 100% качество).</dt:name>
               <dt:code>00000000003</dt:code>
               <dt:productType>7</dt:productType>
               <dt:product>
                  <bs:uuid>787c1ce8-6d4e-4a63-9209-8566ff367b78</bs:uuid>
                  <bs:guid>67e95572-6dc6-732e-c1ae-0f9b25dcb7f5</bs:guid>
               </dt:product>
               <dt:subProduct>
                  <bs:uuid>48dc029e-a6f2-ef48-a36f-797c2a8bf75a</bs:uuid>
                  <bs:guid>1b8ad26d-a22f-b94e-9eaf-e0c5ab052589</bs:guid>
               </dt:subProduct>
               <dt:correspondsToGost>false</dt:correspondsToGost>
               <dt:gost/>
               <dt:producing>
                  <dt:location>
                     <bs:uuid>9fb7db02-42a4-44e1-a632-a90a1dca6cc2</bs:uuid>
                     <bs:guid>4bf88f74-d656-4a45-afae-3abafbfc118c</bs:guid>
                  </dt:location>
               </dt:producing>
            </dt:productItem>
         </dt:productItemList>
      </v2:getProductItemChangesListResponse>
   </soap:Body>
</soapenv:Envelope>


Запрос списка изменений номенклатуры по конкретному предприятию

Запрос первых трех записей номенклатуры заданного производителя, измененных с 19.09.2017 по 19.10.2017 без смещения.

<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:getProductItemChangesListRequest>
          <bs:listOptions>
            <bs:count>3</bs:count>
            <bs:offset>0</bs:offset>
         </bs:listOptions>
         <bs:updateDateInterval>
            <bs:beginDate>2017-09-19T00:00:00</bs:beginDate>
            <bs:endDate>2017-10-19T00:00:00</bs:endDate>
         </bs:updateDateInterval>   
          <dt:enterprise>
               <bs:guid>1ac126a3-8333-41fc-8cb5-a6fae47ee958</bs:guid>
          </dt:enterprise>
      </ws:getProductItemChangesListRequest>
   </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:getProductItemChangesListResponse 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:productItemList count="3" total="16" offset="0">
            <dt:productItem>
               <bs:uuid>2788eb78-f25c-47ce-b39e-bb90c9efd41a</bs:uuid>
               <bs:guid>c9fb68ca-3cb9-42e8-9703-d1b887dff780</bs:guid>
               <bs:active>true</bs:active>
               <bs:last>true</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2017-09-25T08:30:41+03:00</bs:createDate>
               <bs:updateDate>2017-09-25T08:30:41+03:00</bs:updateDate>
               <dt:name>Молоко супер пастеризованное</dt:name>
               <dt:code>R001019</dt:code>
               <dt:productType>5</dt:productType>
               <dt:product>
                  <bs:uuid>31c94ff1-a217-f38d-6005-1aa5ca67e146</bs:uuid>
                  <bs:guid>d34504bb-7a93-e1c8-4859-339eafd97c6c</bs:guid>
               </dt:product>
               <dt:subProduct>
                  <bs:uuid>a3cecd19-98ca-46f9-ecd5-90c41fd95e13</bs:uuid>
                  <bs:guid>9540bfdd-4cd6-6f47-ae83-a32a36c36bfe</bs:guid>
               </dt:subProduct>
               <dt:correspondsToGost>false</dt:correspondsToGost>
               <dt:gost>ГОСТ_Р_51187-98</dt:gost>
               <dt:producer>
                  <bs:uuid>3a8a1f55-0bec-4176-bd29-9599a297e5f0</bs:uuid>
                  <bs:guid>c585d4d5-e5db-4d28-b716-a1b5f3338e47</bs:guid>
               </dt:producer>
               <dt:tmOwner>
                  <bs:uuid>3a8a1f55-0bec-4176-bd29-9599a297e5f0</bs:uuid>
                  <bs:guid>c585d4d5-e5db-4d28-b716-a1b5f3338e47</bs:guid>
               </dt:tmOwner>
               <dt:producing>
                  <dt:location>
                     <bs:uuid>97851c2b-5fe2-42d9-9b4f-5a790a4dc3af</bs:uuid>
                     <bs:guid>1ac126a3-8333-41fc-8cb5-a6fae47ee958</bs:guid>
                  </dt:location>
               </dt:producing>
            </dt:productItem>
            <dt:productItem>
               <bs:uuid>f3c61102-289b-4183-9145-94f21d93c765</bs:uuid>
               <bs:guid>c81fe4e4-b407-4b2c-a8de-d1a3399f1be5</bs:guid>
               <bs:active>true</bs:active>
               <bs:last>true</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2017-10-06T14:47:59+03:00</bs:createDate>
               <bs:updateDate>2017-10-06T14:47:59+03:00</bs:updateDate>
               <dt:name>Молоко сырое 1.5%</dt:name>
               <dt:productType>5</dt:productType>
               <dt:product>
                  <bs:uuid>31c94ff1-a217-f38d-6005-1aa5ca67e146</bs:uuid>
                  <bs:guid>d34504bb-7a93-e1c8-4859-339eafd97c6c</bs:guid>
               </dt:product>
               <dt:subProduct>
                  <bs:uuid>6e6cf1ff-d31f-477e-b506-ce3beb6efdb5</bs:uuid>
                  <bs:guid>5d80c18b-6c64-448d-a71c-d5835b9b5210</bs:guid>
               </dt:subProduct>
               <dt:correspondsToGost>false</dt:correspondsToGost>
               <dt:gost>ГОСТ_Р_51184-98</dt:gost>
               <dt:producing>
                  <dt:location>
                     <bs:uuid>97851c2b-5fe2-42d9-9b4f-5a790a4dc3af</bs:uuid>
                     <bs:guid>1ac126a3-8333-41fc-8cb5-a6fae47ee958</bs:guid>
                  </dt:location>
               </dt:producing>
            </dt:productItem>
            <dt:productItem>
               <bs:uuid>08c61459-7e44-4589-8324-305616d85356</bs:uuid>
               <bs:guid>a09925bf-171b-4ffc-ad8e-9820b8dde70c</bs:guid>
               <bs:active>true</bs:active>
               <bs:last>true</bs:last>
               <bs:status>100</bs:status>
               <bs:createDate>2017-10-09T11:22:41+03:00</bs:createDate>
               <bs:updateDate>2017-10-09T11:22:41+03:00</bs:updateDate>
               <dt:name>Молоко супер пастеризованное</dt:name>
               <dt:code>R00050</dt:code>
               <dt:productType>5</dt:productType>
               <dt:product>
                  <bs:uuid>31c94ff1-a217-f38d-6005-1aa5ca67e146</bs:uuid>
                  <bs:guid>d34504bb-7a93-e1c8-4859-339eafd97c6c</bs:guid>
               </dt:product>
               <dt:subProduct>
                  <bs:uuid>a3cecd19-98ca-46f9-ecd5-90c41fd95e13</bs:uuid>
                  <bs:guid>9540bfdd-4cd6-6f47-ae83-a32a36c36bfe</bs:guid>
               </dt:subProduct>
               <dt:correspondsToGost>false</dt:correspondsToGost>
               <dt:gost>ГОСТ_Р_51187-98</dt:gost>
               <dt:producer>
                  <bs:uuid>3a8a1f55-0bec-4176-bd29-9599a297e5f0</bs:uuid>
                  <bs:guid>c585d4d5-e5db-4d28-b716-a1b5f3338e47</bs:guid>
               </dt:producer>
               <dt:tmOwner>
                  <bs:uuid>3a8a1f55-0bec-4176-bd29-9599a297e5f0</bs:uuid>
                  <bs:guid>c585d4d5-e5db-4d28-b716-a1b5f3338e47</bs:guid>
               </dt:tmOwner>
               <dt:producing>
                  <dt:location>
                     <bs:uuid>97851c2b-5fe2-42d9-9b4f-5a790a4dc3af</bs:uuid>
                     <bs:guid>1ac126a3-8333-41fc-8cb5-a6fae47ee958</bs:guid>
                  </dt:location>
               </dt:producing>
            </dt:productItem>
         </dt:productItemList>
      </v2:getProductItemChangesListResponse>
   </soap:Body>
</soapenv:Envelope>