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

Текущая версия на 16:20, 27 сентября 2020

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

Операция 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>