GetStockEntryChangesListOperation v2

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

Операция GetStockEntryChangesListOperation предназначена для получения списка версий записей складского журнала, созданных или измененных за указанный интервал дат (получение истории изменений).

Складской журнал продукции в системе Меркурий ведется с применением версионирования, это означает, что при каждом изменении записи складского журнала создается новая версия этой записи.

• GUID - глобальный идентификатор записи складского журнала. Данный идентификатор остается неизменным для всех версий записи складского журнала.
• UUID - идентификатор версии записи складского журнала. Данный идентификатор изменяется для каждой новой версии записи складского журнала.

Так же следует различать актуальную и неактуальную версию записи складского журнала. Для одной записи журнала может существовать только одна актуальная версия.

При выполнении операции GetStockEntryChangesListOperation на вход системы передаются следующие сведения:

• информация о пользователе - инициаторе запроса;
• информация о предприятии, на котором осуществляется поиск записей складского журнала;
• временной интервал, за который будет осуществляться поиск записей складского журнала.

Результатом выполнения данной операции является:

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

Возможные сценарии

При обработке запроса возможны следующие сценарии:

1. Получение истории изменений записей складского журнала.

1.1. Запрос успешно обработан. Пользователю вернулась история изменений записей журнала за запрашиваемый период.

1.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

Используемые пространства имен

bs (http://api.vetrf.ru/schema/cdm/base) bs:DataInterval bs:Decimal bs:ListOptions bs:String255 bs:UUID bs:UUID bs:VersionStatus dt (http://api.vetrf.ru/schema/cdm/dictionary) dt:Address dt:BusinessEntity dt:ComplexDate dt:Country dt:Day dt:Enterprise dt:EnterpriseRole dt:GTINType dt:Hour dt:Minute dt:Month dt:Package dt:PackageLevelType dt:PackageList dt:PackingCodeType

dt:PackingType dt:Producer dt:Product dt:ProductItem dt:ProductMarks dt:ProductType dt:SubProduct dt:Unit dt:User dt:Year vd (http://api.vetrf.ru/schema/cdm/mercury/vet-document) vd:Batch vd:BatchOrigin vd:GoodsDate vd:StockEntry vd:StockEntryList xs (http://www.w3.org/2001/XMLSchema) xs:boolean xs:boolean xs:DateTime xs:int xs:NCName xs:nonNegativeInteger xs:string

Данные запроса

#	Название XML-элемента	Тип	Кардинальность	Описание	Пример
1	<merc:getStockEntryChangesListRequest>
2	···<merc:localTransactionId>	xs:NCName	[1..1]	Идентификатор заявки в клиентской системе.	<bs:guid>A00001</bs:guid>
3	···<merc:initiator>	dt:User	[1..1]	Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
4	······<vd:login>	xs:NCName	[1..1]	Логин пользователя, зарегистрированного в системе Меркурий.	<vd:login>user_ab_150101</vd:login>
5	···</merc:initiator>
6	···<bs:listOptions>	bs:ListOptions	[0..1]	Параметры запрашиваемого списка.
7	······<bs:count>	xs:nonNegativeInteger	[0..1]	Максимальное запрашиваемое количество объектов в списке. По умолчанию значение 100; Максимально возможное значение 1000.	<bs:count>10</bs:count>
8	······<bs:offset>	xs:nonNegativeInteger	[0..1]	Номер элемента, по которому осуществляется смещение первого элемента списка. По умолчанию значение 0.	<bs:offset>2</bs:offset>
9	···<bs:listOptions>
10	···<bs:updateDateInterval>	bs:DataInterval	[1..1]	Интервал времени обновления. В список попадают все записи, дата обновлений которых попадает в указанный интервал.
11	······<bs:beginDate>	xs:dateTime	[0..1]	Начало временного интервала.	<bs:beginDate>2017-07-07T00:00:00</bs:beginDate>
12	······<bs:endDate>	xs:dateTime	[0..1]	Конец временного интервала.	<bs:endDate>2017-07-25T00:00:00</bs:endDate>
13	···<bs:updateDateInterval>
14	···<dt:enterpriseGuid>	bs:UUID	[1..1]	Идентификатор предприятия, по которому производится поиск записи.	<dt:enterpriseGuid>851cf860-e9a3-4981-b83e-3dc6cb06cf07</dt:enterpriseGuid>
15	</merc:getStockEntryChangesListRequest>

Данные ответа

#	Название XML-элемента	Тип	Обязат.	Описание	Пример
1	<merc:getStockEntryChangesListResponse>
2	···<merc:stockEntryList>	vd:StockEntryList	[1..1]	Список записей журнала.
3	······<merc:stockEntry>	vd:StockEntry	[0..*]	Сведения о записи журнала.
4	·········<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии записи журнала.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
5	·········<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор записи журнала.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
6	·········<bs:active>	xs:boolean	[1..1]	Является ли запись журнала активной: true - запись активна; false - запись не активна.	<bs:active>true</bs:active>
7	·········<bs:last>	xs:boolean	[1..1]	Последняя версия записи журнала: true - да; false - нет.	<bs:last>true</bs:last>
8	·········<bs:status>	bs:VersionStatus	[1..1]	Статус версии записи журнала.	<bs:status>200</bs:status>
9	·········<bs:createDate>	xs:DateTime	[1..1]	Дата создания записи журнала.	<bs:createDate>2017-07-07T12:00:00</bs:createDate>
10	·········<bs:updateDate>	xs:DateTime	[1..1]	Дата изменения записи журнала.	<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>
11	·········<bs:previous>	bs:UUID	[0..1]	Идентификатор предыдущей версии записи журнала.	<bs:previous>7c78bf3f-c1e8-496b-a5c1-173af60e95e4</bs:previous>
12	·········<bs:next>	bs:UUID	[0..1]	Идентификатор следующей версии записи журнала.	<bs:next>82c7af0d-7067-4a67-8a53-39f4a5bcd700</bs:next>
13	·········<vd:entryNumber>	xs:string	[0..1]	Номер записи журнала, доступный через веб-интерфейс.	<vd:entryNumber>85628322</vd:entryNumber>
14	·········<vd:batch>	vd:Batch	[1..1]	Сведения о партии продукции.
15	············<vd:productType>	dt:ProductType	[1..1]	Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.	<vd:productType>1</vd:productType>
16	············<vd:product>	dt:Product	[1..1]	Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
17	···············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии продукции.	<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
18	···············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
19	···············<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>говядина</dt:name>
20	············</vd:product>
21	············<vd:subProduct>	dt:SubProduct	[1..1]	Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
22	···············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции.	<bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
23	···············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.	<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
24	···············<dt:name>	bs:String255	[0..1]	Наименование вида продукции.	<dt:name>говядина на кости охлажденная</dt:name>
25	············</vd:subProduct>
26	············<vd:productItem>	dt:ProductItem	[0..1]	Наименование продукции в номенклатуре производителя.
27	···············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии номенклатуры продукции.	<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
28	···············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор номенклатуры продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
29	···············<dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) - идентификационный номер продукции производителя. По задумке создателей GTIN должен быть уникален для продукции всех производителей, но на практике встречаются случаи недокументированного использования GTIN внутри компаний, что не обеспечивает уникальность GTIN, поэтому уникальность поля не проверяется.	<dt:globalID>85672854</dt:globalID>
30	···············<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>Наименование</dt:name>
31	···············<dt:code>	bs:String255	[0..1]	Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя.	<dt:code>12</dt:code>
32	···············<dt:packaging>	dt:Packaging	[0..1]	Фасовка.
33	··················<dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки.	<dt:packagingType>1</dt:packagingType>
34	·····················<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии типа упаковки.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
35	·····················<dt:globalID>	dt:PackingCodeType	[0..1]	Уникальный идентификатор упаковки.	<dt:globalID>7B</dt:globalID>
36	·····················<dt:name>	bs:String255	[0..1]	Наименование упаковки.	<dt:name>Название</dt:name>
37	··················</dt:packagingType>
38	··················<dt:quantity>	xs:int	[0..1]	Количество единиц упаковки.	<dt:quantity>10</dt:quantity>
39	··················<dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара.	<dt:volume>50</dt:volume>
40	··················<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара.
41	·····················<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии единицы измерения.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
42	·····················<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор единицы измерения.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
43	··················</dt:unit>
44	···············</dt:packaging>
45	············</vd:productItem>
46	············<vd:volume>	bs:Decimal	[1..1]	Объем продукции.	<dt:volume>50</dt:volume>
47	············<vd:unit>	dt:Unit	[1..1]	Единица измерения объема партии продукции.
48	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии еиницы измерения.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
49	···············<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор еиницы измерения.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
50	···············<dt:name>	bs:String255	[0..1]	Наименование единицы измерения.	<dt:name>кг.</dt:name>
51	············</vd:unit>
52	············<vd:dateOfProduction>	vd:GoodsDate	[1..1]	Дата выработки продукции. Может быть указана датой или диапазоном дат. В случае точной даты выработки указывается только первая компонента - firstDate.
53	···············<vd:firstDate>	dt:ComplexDate	[1..1]	Начальная дата в интервале, либо единичная дата.
54	··················<dt:year>	dt:Year	[1..1]	Год.	<dt:year>2017</dt:year>
55	··················<dt:month>	dt:Month	[1..1]	Месяц.	<dt:month>07</dt:month>
56	··················<dt:day>	dt:Day	[0..1]	День.	<dt:day>07</dt:day>
57	··················<dt:hour>	dt:Hour	[0..1]	Час.	<dt:hour>12</dt:hour>
58	··················<dt:minute>	dt:Minute	[0..1]	Минута.	<dt:minute>41</dt:minute>
59	···············</vd:firstDate>
60	···············<vd:secondDate>	dt:ComplexDate	[0..1]	Конечная дата в интервале.
61	··················<dt:year>	dt:Year	[1..1]	Год.	<dt:year>2017</dt:year>
62	··················<dt:month>	dt:Month	[1..1]	Месяц.	<dt:month>07</dt:month>
63	··················<dt:day>	dt:Day	[0..1]	День.	<dt:day>08</dt:day>
64	··················<dt:hour>	dt:Hour	[0..1]	Час.	<dt:hour>12</dt:hour>
65	··················<dt:minute>	dt:Minute	[0..1]	Минута.	<dt:minute>41</dt:minute>
66	···············</vd:secondDate>
67	············</vd:dateOfProduction>
68	············<vd:expiryDate>	vd:GoodsDate	[1..1]	Дата окончания срока годности продукции. Может быть указана датой или диапазоном дат. В случае точной даты выработки указывается только первая компонента - firstDate.
69	···············<vd:firstDate>	dt:ComplexDate	[1..1]	Начальная дата в интервале, либо единичная дата.
70	··················<dt:year>	dt:Year	[1..1]	Год.	<dt:year>2018</dt:year>
71	··················<dt:month>	dt:Month	[1..1]	Месяц.	<dt:month>07</dt:month>
72	··················<dt:day>	dt:Day	[0..1]	День.	<dt:day>08</dt:day>
73	··················<dt:hour>	dt:Hour	[0..1]	Час.	<dt:hour>12</dt:hour>
74	··················<dt:minute>	dt:Minute	[0..1]	Минута.	<dt:minute>41</dt:minute>
75	···············</vd:firstDate>
76	···············<vd:secondDate>	dt:ComplexDate	[0..1]	Конечная дата в интервале.
77	··················<dt:year>	dt:Year	[1..1]	Год.	<dt:year>2018</dt:year>
78	··················<dt:month>	dt:Month	[1..1]	Месяц.	<dt:month>09</dt:month>
79	··················<dt:day>	dt:Day	[0..1]	День.	<dt:day>08</dt:day>
80	··················<dt:hour>	dt:Hour	[0..1]	Час.	<dt:hour>12</dt:hour>
81	··················<dt:minute>	dt:Minute	[0..1]	Минута.	<dt:minute>41</dt:minute>
82	···············</vd:secondDate>
83	············</vd:expiryDate>
84	············<vd:batchID>	bs:String255	[0..*]	Уникальный идентификатор производственной партии продукции.	<vd:batchID>ПП64219</vd:batchID>
85	············<vd:perishable>	xs:boolean	[1..1]	Описывает, является ли продукция скоропортящейся: true – скоропортящаяся; false – не скоропортящаяся.	<vd:perishable>false</vd:perishable>
86	············<vd:origin>	vd:BatchOrigin	[0..1]	Сведения о происхождении продукции.
87	···············<vd:productItem>	dt:ProductItem	[0..1]	Наименование продукции в номенклатуре производителя.
88	··················<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии номенклатуры продукции.	<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
89	··················<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор номенклатуры продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
90	··················<dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) - идентификационный номер продукции производителя. По задумке создателей GTIN должен быть уникален для продукции всех производителей, но на практике встречаются случаи недокументированного использования GTIN внутри компаний, что не обеспечивает уникальность GTIN, поэтому уникальность поля не проверяется.	<dt:globalID>85672854</dt:globalID>
91	··················<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>Наименование</dt:name>
92	··················<dt:code>	bs:String255	[0..1]	Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя.	<dt:code>12</dt:code>
93	···············</vd:productItem>
94	···············<vd:country>	dt:Country	[0..1]	Страна происхождения партии продукции.
95	··················<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии страны.	<bs:uuid>cbd91ac0-bec2-4308-a395-33b68871d76b</bs:uuid>
96	··················<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор страны.	<bs:guid>3aa0c3ce-8d01-4779-bfb7-df7f234cf86f</bs:guid>
97	··················<dt:name>	bs:String255	[0..1]	Наименование страны происхождения партии продукции.	<dt:name>Российская федерация</dt:name>
98	···············</vd:country>
99	···············<dt:producer>	dt:Producer	[0..*]	Производитель продукции.
100	··················<dt:enterprise>	dt:Enterprise	[1..1]	Информация о предприятие-производителе продукции. Обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID. При указании обоих полей, приоритет у UUID.
101	·····················<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии предприятия.	<bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
102	·····················<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор предприятия.	<bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
103	·····················<dt:name>	bs:String255	[0..1]	Наименование производителя.	<dt:name>Мясной цех №36</dt:name>
104	··················</dt:enterprise>
105	··················<dt:role>	dt:EnterpriseRole	[1..1]	Роль предприятия-производителя продукции.	<dt:role>PRODUCER</dt:role>
106	···············</dt:producer>
107	············</vd:origin>
108	············<vd:lowGradeCargo>	xs:boolean	[1..1]	Является ли груз некачественным. true – груз некачественный; false – груз качественный.	<vd:lowGradeCargo>false</vd:lowGradeCargo>
109	············<vd:packageList>	dt:PackageList	[0..1]	Список физической упаковки.
110	···············<dt:package>	dt:Package	[0..*]	Описание упаковки. Поддерживается указание многоуровневой упаковки и маркировки партии продукции. Всего предусмотрено шесть уровней упаковки (см. тип dt:PackageLevelType). Количество единиц упаковки и маркировка партии указывается для каждой упаковки конкретного уровня отдельно. На каждом уровне может быть произвольное количество типов упаковки, в том числе и ни одного, т.е. какого-то уровня упаковки в описании партии продукции может не быть.
111	··················<dt:level>	dt:PackageLevelType	[1..1]	Уровень упаковки.	<vd:level>4</vd:level>
112	··················<dt:packingType>	dt:PackingType	[1..1]	Тип упаковки.	<vd:packingType>1</vd:packingType>
113	·····················<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии упаковки.	<bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
114	·····················<dt:globalID>	dt:PackingCodeType	[1..1]	Уникальный идентификатор упаковки.	<dt:globalID>7B</dt:globalID>
115	·····················<dt:name>	bs:String255	[0..1]	Наименование упаковки.	<dt:name>Деревянный ящик</dt:name>
116	··················</dt:packingType>
117	··················<dt:quantity>	xs:int	[0..1]	Количество единиц упаковки.	<vd:quantity>1</vd:quantity>
118	··················<dt:productMarks class="UNDEFINED">	dt:ProductMarks	[0..*]	Маркировка партии продукции.	<vd:productMarks class="BN">ПАРТИЯ1251</vd:productMarks>
119	···············</dt:package>
120	············</vd:packageList>
121	············<vd:owner>	dt:BusinessEntity	[0..1]	Фирма-владелец продукции.
122	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии хозяйствующего субъекта-владельца.	<bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
123	···············<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор хозяйствующего субъекта-владельца.	<bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
124	············</vd:owner>
125	·········</vd:batch>
126	······</merc:stockEntry>
127	···<merc:stockEntryList>
128	</merc:getStockEntryChangesListResponse>

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

Получение списка записей складского журнала, изменённых за определённый период времени - для хозяйствующих субъектов

<SOAP-ENV:Envelope xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" 
                   xmlns:bs="http://api.vetrf.ru/schema/cdm/base" 
                   xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/g2b/applications/v2" 
                   xmlns:apldef="http://api.vetrf.ru/schema/cdm/application/ws-definitions" 
                   xmlns:apl="http://api.vetrf.ru/schema/cdm/application" 
                   xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2" 
                   xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <apldef:submitApplicationRequest>
      <apldef:apiKey>apiKey</apldef:apiKey>
      <apl:application>
        <apl:serviceId>mercury-g2b.service:2.0</apl:serviceId>
        <apl:issuerId>issuerId</apl:issuerId>
        <apl:issueDate>2017-09-04T08:49:47</apl:issueDate>
        <apl:data>
          <merc:getStockEntryChangesListRequest>
            <merc:localTransactionId>a10003</merc:localTransactionId>
            <merc:initiator>
              <vd:login>user_login</vd:login>
            </merc:initiator>
            <bs:listOptions>
              <bs:count>10</bs:count>
              <bs:offset>0</bs:offset>
            </bs:listOptions>
            <bs:updateDateInterval>
              <bs:beginDate>2016-01-01T00:00:00</bs:beginDate>
              <bs:endDate>2020-01-01T00:00:00</bs:endDate>
            </bs:updateDateInterval>
            <dt:enterpriseGuid>ac264dc6-a3eb-4b0f-a86a-9c9577209d6f</dt:enterpriseGuid>
          </merc:getStockEntryChangesListRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>