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

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


==Коды ошибок==
В таблице ниже приведены коды ошибок, возвращаемые веб-сервисом при различных несоответствиях формату или бизнес-правилам.
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Таблица кодов ошибок для '''GetStockEntryVersionListOperation v2.0'''
<div class = "mw-collapsible-content">
{| class="wikitable"
|-
! Код ошибки !! Сообщение об ошибке
|-
|MERC35002 || В запросе отсутствуют сведения о хозяйствующем субъекте, ответственном за выполнение операции
|-
|MERC35004 || В запросе для хозяйствующого субъекта ответственного за выполнение операции указан идентификатор устаревшей версии записи реестра РСХН
|-
|MERC35005 || Хозяйствующий субъект, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату
|-
|MERC35008 || Запись складского журнала продукции с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату
|-
|MERC35047 || Обслуживаемое предприятие обязательно для заполнения
|-
|MERC35127 || Указанные предприятие и хозяйствующий субъект должны быть связаны друг с другом
|-
|MERC35174 || Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату
|-
|MERC35175 || В запросе для хозяйствующего субъекта указан идентификатор устаревшей версии записи реестра РСХН.
|-
|MERC35176 || Идентификатор хозяйствующего субъекта (GUID) обязателен для заполнения
|-
|MERC35180 || Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату
|-
|MERC35180 || В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
|-
|MERC35182 || Идентификатор предприятия (GUID) обязателен для заполнения
|-
|MERC35275 || Идентификатор записи складского журнала продукции обязателен для заполнения
|-
|MERC35304 || Отступ превышает количество записей
|-
|MERC35306 || Пользователь с указанным идентификатором заблокирован
|-
|MERC35320 || Идентификатор пользователя обязателен для заполнения
|-
|MERC35369 || Инициатор, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
|MERC35383 || Хозяйствующий субъект-инициатор запроса должен быть связан с обслуживающим предприятием
|-
|MERC35387 || Пользователь-инициатор запроса обязателен для заполнения
|-
|MERC35393 || В запросе указана организация пользователя и хозяйстующий субъект, должно быть указано что-то одно
|-
|MERC35394 || В запросе не указана ни организация пользователя, ни хозяйстующий субъект
|-
|MERC35395 || Организация пользователя-инициатора запроса не найдена в реестре РСХН
|-
|MERC35396 || В запросе указана неактивная организация пользователя-инициатора
|-
|MERC35397 || Указанный инициатор не связан с ГВЭ региона обслуживаемого предприятия
|-
|MERC35398 || Указанный инициатор не связан с ГВЭ региона указанной организации
|-
|MERC35399 || Инициатор запроса должен быть сотрудником ВУ или иметь доступ в ГВЭ
|-
|MERC35400 || Регион указанной организации и обслуживаемого предприятия должны совпадать
|-
|MERC35401 || Для хозяйствующео субъекта - инициатора запроса указана организация
|-
|MERC35402 || Указанный инициатор не связан с хозяйствующим субъектом
|}
</div>
</div>
==Пример запроса==
==Пример запроса==
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">

Версия 14:06, 27 ноября 2017

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

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

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

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

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

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

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

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

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

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

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

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


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

# Название XML-элемента Тип Кардинальность Описание Пример
1 <merc:getStockEntryVersionListRequest>
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:guid> bs:UUID [1..1] Глобальный идентификатор записи складского журнала. <bs:guid>9b7082e2-2d20-4182-be1a-c93974f8b8c6</bs:guid>
11 ···<dt:enterpriseGuid> bs:UUID [1..1] Идентификатор предприятия, по которому производится поиск записи. <dt:enterpriseGuid>851cf860-e9a3-4981-b83e-3dc6cb06cf07</dt:enterpriseGuid>
12 </merc:getStockEntryVersionListRequest>

Примечания к данным запроса

  • Параметры count и offset могут использоваться для получения полного списка записей журнала, когда их количество превышает максимальное значение, возвращаемое в ответе (1000 записей). Например, в журнале 1400 записей, запрос с count=1000 и offset=0 вернет первые 1000 записей, для получения оставшихся 400 необходимо указать count=400 (или больше) и offset=1000.

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

# Название XML-элемента Тип Обязат. Описание Пример
1 <merc:getStockEntryVersionListResponse>
2 ···<vd:stockEntryList total="3102" offset="0" count="10"> vd:StockEntryList [1..1] Список записей журнала.
  • total - всего записей;
  • offset - смещение относительно первого элемента;
  • count - количество выводимых записей.
3 ······<vd: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></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 [1..1] Наименование продукции в номенклатуре производителя.
27 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры продукции. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
28 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор номенклатуры продукции. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
29 ···············<dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - идентификационный номер продукции производителя. <dt:globalID>85672854</dt:globalID>
30 ···············<dt:name> bs:String255 [1..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 ·····················<bs:guid> bs:UUID [1..1] Глобальный идентификатор типа упаковки. <bs:guid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:guid>
36 ·····················<dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки. <dt:globalID>7B</dt:globalID>
37 ·····················<dt:name> bs:String255 [1..1] Наименование упаковки. <dt:name>Название</dt:name>
38 ··················</dt:packagingType>
39 ··················<dt:quantity> xs:int [0..1] Количество единиц упаковки. <dt:quantity>10</dt:quantity>
40 ··················<dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара. <dt:volume>50</dt:volume>
41 ··················<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара.
42 ·····················<bs:uuid> bs:UUID [1..1] Идентификатор версии единицы измерения. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
43 ·····················<bs:guid> bs:UUID [1..1] Глобальный идентификатор единицы измерения. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
44 ·····················<dt:name> bs:String255 [1..1] Наименование единицы измерения. <dt:name>кг.</dt:name>
45 ··················</dt:unit>
46 ···············</dt:packaging>
47 ············</vd:productItem>
48 ············<vd:volume> bs:Decimal [1..1] Объем продукции. <dt:volume>50</dt:volume>
49 ············<vd:unit> dt:Unit [1..1] Единица измерения объема партии продукции.
50 ···············<bs:uuid> bs:UUID [1..1] Идентификатор версии еиницы измерения. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
51 ···············<bs:guid> bs:UUID [1..1] Глобальный идентификатор еиницы измерения. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
52 ···············<dt:name> bs:String255 [1..1] Наименование единицы измерения. <dt:name>кг.</dt:name>
53 ············</vd:unit>
54 ············<vd:dateOfProduction> vd:GoodsDate [1..1] Дата выработки продукции.
  • Может быть указана датой или диапазоном дат. В случае точной даты выработки указывается только первая компонента - firstDate.
55 ···············<vd:firstDate> dt:ComplexDate [1..1] Начальная дата в интервале, либо единичная дата.
56 ··················<dt:year> dt:Year [1..1] Год. <dt:year>2017</dt:year>
57 ··················<dt:month> dt:Month [1..1] Месяц. <dt:month>07</dt:month>
58 ··················<dt:day> dt:Day [0..1] День. <dt:day>07</dt:day>
59 ··················<dt:hour> dt:Hour [0..1] Час. <dt:hour>12</dt:hour>
60 ··················<dt:minute> dt:Minute [0..1] Минута. <dt:minute>41</dt:minute>
61 ···············</vd:firstDate>
62 ···············<vd:secondDate> dt:ComplexDate [0..1] Конечная дата в интервале.
63 ··················<dt:year> dt:Year [1..1] Год. <dt:year>2017</dt:year>
64 ··················<dt:month> dt:Month [1..1] Месяц. <dt:month>07</dt:month>
65 ··················<dt:day> dt:Day [0..1] День. <dt:day>08</dt:day>
66 ··················<dt:hour> dt:Hour [0..1] Час. <dt:hour>12</dt:hour>
67 ··················<dt:minute> dt:Minute [0..1] Минута. <dt:minute>41</dt:minute>
68 ···············</vd:secondDate>
69 ············</vd:dateOfProduction>
70 ············<vd:expiryDate> vd:GoodsDate [1..1] Дата окончания срока годности продукции (кроме продукции типа "Живые животные").
  • Может быть указана датой или диапазоном дат. В случае точной даты выработки указывается только первая компонента - firstDate.
71 ···············<vd:firstDate> dt:ComplexDate [1..1] Начальная дата в интервале, либо единичная дата.
72 ··················<dt:year> dt:Year [1..1] Год. <dt:year>2018</dt:year>
73 ··················<dt:month> dt:Month [1..1] Месяц. <dt:month>07</dt:month>
74 ··················<dt:day> dt:Day [0..1] День. <dt:day>08</dt:day>
75 ··················<dt:hour> dt:Hour [0..1] Час. <dt:hour>12</dt:hour>
76 ··················<dt:minute> dt:Minute [0..1] Минута. <dt:minute>41</dt:minute>
77 ···············</vd:firstDate>
78 ···············<vd:secondDate> dt:ComplexDate [0..1] Конечная дата в интервале.
79 ··················<dt:year> dt:Year [1..1] Год. <dt:year>2018</dt:year>
80 ··················<dt:month> dt:Month [1..1] Месяц. <dt:month>09</dt:month>
81 ··················<dt:day> dt:Day [0..1] День. <dt:day>08</dt:day>
82 ··················<dt:hour> dt:Hour [0..1] Час. <dt:hour>12</dt:hour>
83 ··················<dt:minute> dt:Minute [0..1] Минута. <dt:minute>41</dt:minute>
84 ···············</vd:secondDate>
85 ············</vd:expiryDate>
86 ············<vd:batchID> bs:String255 [0..*] Уникальный идентификатор производственной партии продукции. <vd:batchID>ПП64219</vd:batchID>
87 ············<vd:perishable> xs:boolean [1..1] Описывает, является ли продукция скоропортящейся:
  • true – скоропортящаяся;
  • false – не скоропортящаяся.
 <vd:perishable>false</vd:perishable>
88 ············<vd:origin> vd:BatchOrigin [0..1] Сведения о происхождении продукции.
89 ···············<vd:productItem> dt:ProductItem [1..1] Наименование продукции в номенклатуре производителя.
90 ··················<bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры продукции. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
91 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор номенклатуры продукции. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
92 ··················<dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - идентификационный номер продукции производителя. <dt:globalID>85672854</dt:globalID>
93 ··················<dt:name> bs:String255 [1..1] Наименование продукции. <dt:name>Наименование</dt:name>
94 ··················<dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя. <dt:code>12</dt:code>
95 ···············</vd:productItem>
96 ···············<vd:country> dt:Country [1..1] Страна происхождения партии продукции.
97 ··················<bs:uuid> bs:UUID [1..1] Идентификатор версии страны. <bs:uuid>cbd91ac0-bec2-4308-a395-33b68871d76b</bs:uuid>
98 ··················<bs:guid> bs:UUID [1..1] Глобальный идентификатор страны. <bs:guid>3aa0c3ce-8d01-4779-bfb7-df7f234cf86f</bs:guid>
99 ··················<dt:name> bs:String255 [1..1] Наименование страны происхождения партии продукции. <dt:name>Российская федерация</dt:name>
100 ···············</vd:country>
101 ···············<dt:producer> dt:Producer [1..*] Производитель продукции.
102 ··················<dt:enterprise> dt:Enterprise [1..1] Информация о предприятие-производителе продукции.
103 ·····················<bs:uuid> bs:UUID [1..1] Идентификатор версии предприятия. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
104 ·····················<bs:guid> bs:UUID [1..1] Глобальный идентификатор предприятия. <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
105 ·····················<dt:name> bs:String255 [0..1] Наименование производителя. <dt:name>Мясной цех №36</dt:name>
106 ··················</dt:enterprise>
107 ··················<dt:role> dt:EnterpriseRole [1..1] Роль предприятия-производителя продукции. <dt:role>PRODUCER</dt:role>
108 ···············</dt:producer>
109 ············<vd:origin>
110 ············<vd:lowGradeCargo> xs:boolean [1..1] Является ли груз некачественным.
  • true – груз некачественный;
  • false – груз качественный.
 <vd:lowGradeCargo>false</vd:lowGradeCargo>
111 ············<vd:packageList> dt:PackageList [0..1] Список физической упаковки.
112 ···············<dt:package> dt:Package [1..*] Описание упаковки. Поддерживается указание многоуровневой упаковки и маркировки партии продукции. Всего предусмотрено шесть уровней упаковки (см. тип dt:PackageLevelType). Количество единиц упаковки и маркировка партии указывается для каждой упаковки конкретного уровня отдельно. На каждом уровне может быть произвольное количество типов упаковки, в том числе и ни одного, т.е. какого-то уровня упаковки в описании партии продукции может не быть.
113 ··················<dt:level> dt:PackageLevelType [1..1] Уровень упаковки. <vd:level>4</vd:level>
114 ··················<dt:packingType> dt:PackingType [1..1] Тип упаковки. <vd:packingType>1</vd:packingType>
115 ·····················<bs:uuid> bs:UUID [1..1] Идентификатор версии типа упаковки. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
116 ·····················<bs:guid> bs:UUID [1..1] Глобальный идентификатор типа упаковки. <bs:guid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:guid>
117 ·····················<dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки. <dt:globalID>7B</dt:globalID>
118 ·····················<dt:name> bs:String255 [1..1] Наименование упаковки. <dt:name>Деревянный ящик</dt:name>
119 ··················</dt:packingType>
120 ··················<dt:quantity> xs:int [0..1] Количество единиц упаковки. <vd:quantity>1</vd:quantity>
121 ··················<dt:productMarks class="UNDEFINED"> dt:ProductMarks [0..*] Маркировка партии продукции. <vd:productMarks class="BN">ПАРТИЯ1251</vd:productMarks>
122 ···············</dt:package>
123 ············</vd:packageList>
124 ············<vd:owner> dt:BusinessEntity [1..1] Фирма-владелец продукции.
125 ···············<bs:uuid> bs:UUID [1..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
126 ···············<bs:guid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
127 ············</vd:owner>
128 ·········</vd:batch>
129 ·········<vd:vetDocument> [0..1]
130 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии ветеринарного документа <bs:uuid>494169a7-0738-4d1d-9f7b-ce301e9cee22</bs:uuid>
131 ·········</vd:vetDocument>
132 ·········<vd:vetEventList> vd:StockEntryEventList [0..1] Список ветеринарных мероприятий для партии продукции.
133 ············<vd:laboratoryResearch> vd:LaboratoryResearchEvent [0..*] Сведения о проведенных лабораторных исследованиях.
134 ···············<vd:ID> bs:Identifier [1..1] Идентификатор события в разрезе записи складского журнала или вет.сертификата.
  • Не задаётся пользователем в запросах (кроме запросов на редактирование), формируется системой автоматически.
 <vd:ID>BZ52134</vd:ID>
135 ···············<vd:name> bs:String255 [0..1] Наименование мероприятия. <vd:name>Лабораторные исследования</vd:name>
136 ···············<vd:type> vd:VeterinaryEventType [1..1] Тип мероприятия. <vd:type>LBR</vd:type>
137 ···············<vd:actualDateTime> xs:DateTime [1..1] Дата события. <vd:actualDateTime>2017-07-07T12:00:00</vd:actualDateTime>
138 ···············<vd:location> dt:Location [0..1] Место проведения мероприятия.
139 ··················<dt:name> bs:String255 [0..1] Название места проведения мероприятия. <dt:name>Лаборатория №81</dt:name>
140 ··················<dt:address> dt:Address [0..1] Адрес места проведения мероприятия.
141 ·····················<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
142 ··················</dt:address>
143 ···············</vd:location>
144 ···············<vd:enterprise> dt:Enterprise [0..1] Сведения о предприятии, если место проведения - это зарегистрированное предприятие.
145 ··················<bs:uuid> bs:UUID [1..1] Идентификатор версии предприятия. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
146 ··················<bs:guid> bs:UUID [1..1] Глобальный идентификатор предприятия. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
147 ···············</vd:enterprise>
148 ···············<vd:operator> dt:Organization [0..1] Организация-оператор, осуществляющий мероприятие.
  • Например, лаборатория (в случае лаб.исследований) или СББЖ.
149 ··················<dt:name> bs:String255 [1..1] Название организации оператора. <dt:name>Лаборатория №81</dt:name>
150 ··················<dt:address> dt:Address [0..1] Адрес организации оператора.
151 ·····················<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
152 ··················</dt:address>
153 ···············</vd:operator>
154 ···············<vd:referencedDocument> vd:ReferencedDocument [0..*] Сведения о связанных документах.
155 ··················<vd:name> bs:String255 [0..1] Название документа. <dt:name>Документ 1</dt:name>
156 ··················<vd:issueSeries> bs:String255 [0..1] Серия документа. <vd:issueSeries>ABSC-ТТН-4</vd:issueSeries>
157 ··················<vd:issueNumber> bs:String255 [0..1] Номер документа. <vd:issueNumber>79498-97</vd:issueNumber>
158 ··················<vd:issueDate> xs:date [0..1] Дата оформления документа. <vd:issueDate>2017-07-07</vd:issueDate>
159 ··················<vd:type> dt:DocumentType [1..1] Тип документа.
  • Может быть указан только тип документа "Акт отбора проб" - 9
 <vd:type>2</vd:type>
160 ··················<vd:relationshipType> dt:ReferenceType [1..1] Тип отношения между документами. <vd:relationshipType>3</vd:relationshipType>
161 ···············</vd:referencedDocument>
162 ···············<vd:notes> bs:Text [0..1] Дополнительные сведения. <vd:notes>Доп.сведения</vd:notes>
163 ···············<vd:expertiseID> bs:String255 [0..1] Номер экспертизы. <vd:expertiseID>913-7613</vd:expertiseID>
164 ···············<vd:indicator> bs:String255 [0..1] Показатель безопасности.
165 ··················<bs:uuid> bs:UUID [0..1] Идентификатор показателя. <bs:uuid>cbd91ac0-bec2-4308-a395-33b68871d76b</bs:uuid>
166 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор показателя. <bs:guid>3aa0c3ce-8d01-4779-bfb7-df7f234cf86f</bs:guid>
167 ··················<dt:name> bs:String255 [1..1] Название показателя. <dt:name>Показатель 1</dt:name>
168 ···············</vd:indicator>
169 ···············<vd:method> dt:ResearchMethod [0..1] Метод исследования.
170 ··················<bs:uuid> bs:UUID [0..1] Идентификатор метода исследования. <bs:uuid>cbd91ac0-bec2-4308-a395-33b68871d76b</bs:uuid>
171 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор метода исследования. <bs:guid>3aa0c3ce-8d01-4779-bfb7-df7f234cf86f</bs:guid>
172 ··················<dt:name> bs:String255 [1..1] Название метода исследования. <dt:name>Метод 1</dt:name>
173 ···············</vd:method>
174 ···············<vd:result> dt:ResearchResult [0..1] Результат исследования. <vd:result>VSEFULL</vd:result>
175 ···············<vd:conclusion> bs:Text [0..1] Заключение. <vd:conclusion>Исследования прошли успешно.</vd:conclusion>
176 ············</vd:laboratoryResearch>
177 ············<vd:immunization> vd:AnimalMedicationEvent [0..*] Сведения о проведенной обработке/иммунизации животных.
178 ···············<vd:ID> bs:Identifier [1..1] Идентификатор события в разрезе записи складского журнала или вет.сертификата. Не задаётся пользователем в запросах (кроме запросов на редактирование), формируется системой автоматически. <vd:ID>BZ52134</vd:ID>
179 ···············<vd:name> bs:String255 [0..1] Наименование мероприятия. <vd:name>Иммуназация</vd:name>
180 ···············<vd:type> vd:VeterinaryEventType [1..1] Тип мероприятия. <vd:type>IMM</vd:type>
181 ···············<vd:actualDateTime> xs:DateTime [1..1] Дата события. <vd:actualDateTime>2017-07-07T12:00:00</vd:actualDateTime>
182 ···············<vd:location> dt:Location [0..1] Место проведения мероприятия.
183 ··················<dt:name> bs:String255 [0..1] Название места проведения мероприятия. <dt:name>Лаборатория №81</dt:name>
184 ··················<dt:address> dt:Address [0..1] Адрес места проведения мероприятия.
185 ·····················<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
186 ··················</dt:address>
187 ···············</vd:location>
188 ···············<vd:enterprise> dt:Enterprise [0..1] Сведения о предприятии, если место проведения - это зарегистрированное предприятие.
189 ··················<bs:uuid> bs:UUID [1..1] Идентификатор версии предприятия. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
190 ··················<bs:guid> bs:UUID [1..1] Глобальный идентификатор предприятия. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
191 ···············</vd:enterprise>
192 ···············<vd:operator> dt:Organization [1..1] Организация-оператор, осуществляющий мероприятие.
193 ··················<dt:name> bs:String255 [1..1] Название организации-оператора. <dt:name>Лаборатория №81</dt:name>
194 ··················<dt:address> dt:Address [0..1] Адрес организации-оператора.
195 ·····················<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
196 ··················</dt:address>
197 ···············</vd:operator>
198 ···············<vd:notes> bs:Text [0..1] Дополнительные сведения. <vd:notes>Дополнительные сведения.</vd:notes>
199 ···············<vd:disease> dt:AnimalDisease [1..1] Заболевание.
200 ··················<bs:uuid> bs:UUID [0..1] Идентификатор заболевания. <bs:uuid>cbd91ac0-bec2-4308-a395-33b68871d76b</bs:uuid>
201 ··················<bs:guid> bs:UUID [0..1] Глобальный идентификатор заболевания. <bs:guid>3aa0c3ce-8d01-4779-bfb7-df7f234cf86f</bs:guid>
202 ··················<dt:name> bs:String255 [1..1] Название заболевания. <dt:name>Ящур</dt:name>
203 ···············</vd:disease>
204 ···············<vd:medicinalDrug> dt:MedicinalDrug [0..1] Препарат.
205 ··················<dt:name> bs:String255 [0..1] Название препарата. <dt:name>Препарат 51</dt:name>
206 ··················<dt:series> bs:String255 [0..1] Номер серии препарата/вакцины <dt:series>92-12</dt:series>
207 ··················<dt:producer>
208 ·····················<dt:businessEntity> dt:BusinessEntity [1..1] Информация о хозяйствующем субъекте-производителе препарата.
209 ························<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта. <bs:uuid>9b7082e2-2d20-4182-be1a-c93974f8b8c6</bs:uuid>
210 ························<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта. <bs:guid>6956009e-0e30-4427-8623-91ddebf47471</bs:guid>
211 ························<dt:fullName> bs:String255 [0..1] Название производителя препарата. <dt:fullName>ООО Инлабс</dt:fullName>
212 ························<dt:juridicalAddress> dt:Address [0..1] Адрес производителя препарата.
213 ···························<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
214 ························</dt:juridicalAddress>
215 ·····················</dt:businessEntity>
216 ··················</dt:producer>
217 ···············</vd:medicinalDrug>
218 ···············<vd:effectiveBeforeDate> xs:DateTime [0..1] Срок действия препарата/вакцины. Указывается дата и время окончания срока действия. <vd:effectiveBeforeDate>2017-07-07T12:00:00</vd:effectiveBeforeDate>
219 ············</vd:immunization>
220 ·········</vd:vetEventList>
221 ······</vd:stockEntry>
222 ···</vd:stockEntryList>
223 </merc:getStockEntryVersionListResponse>

Коды ошибок

В таблице ниже приведены коды ошибок, возвращаемые веб-сервисом при различных несоответствиях формату или бизнес-правилам.

Таблица кодов ошибок для GetStockEntryVersionListOperation v2.0

Код ошибки Сообщение об ошибке
MERC35002 В запросе отсутствуют сведения о хозяйствующем субъекте, ответственном за выполнение операции
MERC35004 В запросе для хозяйствующого субъекта ответственного за выполнение операции указан идентификатор устаревшей версии записи реестра РСХН
MERC35005 Хозяйствующий субъект, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату
MERC35008 Запись складского журнала продукции с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату
MERC35047 Обслуживаемое предприятие обязательно для заполнения
MERC35127 Указанные предприятие и хозяйствующий субъект должны быть связаны друг с другом
MERC35174 Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату
MERC35175 В запросе для хозяйствующего субъекта указан идентификатор устаревшей версии записи реестра РСХН.
MERC35176 Идентификатор хозяйствующего субъекта (GUID) обязателен для заполнения
MERC35180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату
MERC35180 В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
MERC35182 Идентификатор предприятия (GUID) обязателен для заполнения
MERC35275 Идентификатор записи складского журнала продукции обязателен для заполнения
MERC35304 Отступ превышает количество записей
MERC35306 Пользователь с указанным идентификатором заблокирован
MERC35320 Идентификатор пользователя обязателен для заполнения
MERC35369 Инициатор, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC35383 Хозяйствующий субъект-инициатор запроса должен быть связан с обслуживающим предприятием
MERC35387 Пользователь-инициатор запроса обязателен для заполнения
MERC35393 В запросе указана организация пользователя и хозяйстующий субъект, должно быть указано что-то одно
MERC35394 В запросе не указана ни организация пользователя, ни хозяйстующий субъект
MERC35395 Организация пользователя-инициатора запроса не найдена в реестре РСХН
MERC35396 В запросе указана неактивная организация пользователя-инициатора
MERC35397 Указанный инициатор не связан с ГВЭ региона обслуживаемого предприятия
MERC35398 Указанный инициатор не связан с ГВЭ региона указанной организации
MERC35399 Инициатор запроса должен быть сотрудником ВУ или иметь доступ в ГВЭ
MERC35400 Регион указанной организации и обслуживаемого предприятия должны совпадать
MERC35401 Для хозяйствующео субъекта - инициатора запроса указана организация
MERC35402 Указанный инициатор не связан с хозяйствующим субъектом

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

Запрос 1. Получение списка версий записи складского журнала - для хозяйствующего субъекта
<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-15T11:59:42</apl:issueDate>
        <apl:data>
          <merc:getStockEntryVersionListRequest>
            <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:guid>e5adee26-b027-4d65-9f07-48fe58e75b95</bs:guid>
            <dt:enterpriseGuid>ac264dc6-a3eb-4b0f-a86a-9c9577209d6f</dt:enterpriseGuid>
          </merc:getStockEntryVersionListRequest>
        </apl:data>
      </apl:application>
    </apldef:submitApplicationRequest>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>


Ответ на запрос 1
<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:env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:vd="http://api.vetrf.ru/schema/cdm/mercury/vet-document/v2">
  <env:Header/>
  <env:Body>
    <apldef:receiveApplicationResultResponse>
      <apl:application>
        <apl:applicationId>ca388867-0a1d-4704-b3dd-3b011214a3bd</apl:applicationId>
        <apl:status>COMPLETED</apl:status>
        <apl:serviceId>mercury-g2b.service</apl:serviceId>
        <apl:issuerId>issuerId</apl:issuerId>
        <apl:issueDate>2017-09-15T11:59:42.000+03:00</apl:issueDate>
        <apl:rcvDate>2017-09-15T11:59:43.000+03:00</apl:rcvDate>
        <apl:prdcRsltDate>2017-09-15T11:59:43.000+03:00</apl:prdcRsltDate>
        <apl:result>
          <merc:getStockEntryVersionListResponse>
            <vd:stockEntryList total="1" offset="0" count="1">
              <vd:stockEntry>
                <bs:uuid>3560e60a-4339-41ec-b810-e293b32ebb1a</bs:uuid>
                <bs:guid>e5adee26-b027-4d65-9f07-48fe58e75b95</bs:guid>
                <bs:active>true</bs:active>
                <bs:last>true</bs:last>
                <bs:status>103</bs:status>
                <bs:createDate>2017-09-15T11:59:41+03:00</bs:createDate>
                <bs:updateDate>2017-09-15T11:59:41+03:00</bs:updateDate>
                <vd:entryNumber>18398299</vd:entryNumber>
                <vd:batch>
                  <vd:productType>5</vd:productType>
                  <vd:product>
                    <bs:uuid>31c94ff1-a217-f38d-6005-1aa5ca67e146</bs:uuid>
                    <bs:guid>d34504bb-7a93-e1c8-4859-339eafd97c6c</bs:guid>
                  </vd:product>
                  <vd:subProduct>
                    <bs:uuid>a3cecd19-98ca-46f9-ecd5-90c41fd95e13</bs:uuid>
                    <bs:guid>9540bfdd-4cd6-6f47-ae83-a32a36c36bfe</bs:guid>
                  </vd:subProduct>
                  <vd:productItem>
                    <bs:uuid>de407a38-bab4-4b48-9732-bdc71e253fa2</bs:uuid>
                    <bs:guid>93acfc5d-7b02-4767-8c7c-9449a02f5971</bs:guid>
                    <dt:name>Молоко ультрапастеризованное 1,5% холостятское</dt:name>
                    <dt:code>430deaca-95e5-4f83-8f3f-4b611187b622</dt:code>
                    <dt:packaging>
                      <dt:packagingType>
                        <bs:uuid>118124c8-ace0-44e1-b212-ee10dd5c1cdc</bs:uuid>
                        <bs:guid>933312a8-dc11-43ee-9daa-abb240bf9e3f</bs:guid>
                        <dt:globalID>43</dt:globalID>
                        <dt:name>Мешок большой для крупноразмерных навалочных грузов</dt:name>
                      </dt:packagingType>
                      <dt:quantity>12</dt:quantity>
                      <dt:volume>33.0</dt:volume>
                      <dt:unit>
                        <bs:uuid>069792f0-053d-11e1-99b4-d8d385fbc9e8</bs:uuid>
                        <bs:guid>21ed96c9-337b-4a27-8761-c6e6ad3c9f5b</bs:guid>
                        <dt:name>кг</dt:name>
                      </dt:unit>
                    </dt:packaging>
                  </vd:productItem>
                  <vd:volume>400.0</vd:volume>
                  <vd:unit>
                    <bs:uuid>069792f0-053d-11e1-99b4-d8d385fbc9e8</bs:uuid>
                    <bs:guid>21ed96c9-337b-4a27-8761-c6e6ad3c9f5b</bs:guid>
                  </vd:unit>
                  <vd:dateOfProduction>
                    <vd:firstDate>
                      <dt:year>2020</dt:year>
                      <dt:month>12</dt:month>
                      <dt:day>6</dt:day>
                    </vd:firstDate>
                  </vd:dateOfProduction>
                  <vd:expiryDate>
                    <vd:firstDate>
                      <dt:year>2021</dt:year>
                      <dt:month>12</dt:month>
                      <dt:day>6</dt:day>
                    </vd:firstDate>
                  </vd:expiryDate>
                  <vd:batchID>ASDF1234</vd:batchID>
                  <vd:perishable>false</vd:perishable>
                  <vd:origin>
                    <vd:productItem>
                      <dt:name>Молоко ультрапастеризованное 1,5% холостятское</dt:name>
                      <dt:code>430deaca-95e5-4f83-8f3f-4b611187b622</dt:code>
                    </vd:productItem>
                    <vd:country>
                      <bs:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</bs:uuid>
                      <bs:guid>74a3cbb1-56fa-94f3-ab3f-e8db4940d96b</bs:guid>
                      <dt:name>Российская Федерация</dt:name>
                    </vd:country>
                    <vd:producer>
                      <dt:enterprise>
                        <bs:uuid>8888c36c-df2e-442f-b0d9-faef5e063b43</bs:uuid>
                        <bs:guid>ac264dc6-a3eb-4b0f-a86a-9c9577209d6f</bs:guid>
                      </dt:enterprise>
                      <dt:role>PRODUCER</dt:role>
                    </vd:producer>
                  </vd:origin>
                  <vd:lowGradeCargo>false</vd:lowGradeCargo>
                  <vd:packageList>
                    <dt:package>
                      <dt:level>6</dt:level>
                      <dt:packingType>
                        <bs:uuid>118124c8-ace0-44e1-b212-ee10dd5c1cdc</bs:uuid>
                        <bs:guid>933312a8-dc11-43ee-9daa-abb240bf9e3f</bs:guid>
                        <dt:globalID>43</dt:globalID>
                        <dt:name>Мешок большой для крупноразмерных навалочных грузов</dt:name>
                      </dt:packingType>
                    </dt:package>
                    <dt:package>
                      <dt:level>1</dt:level>
                      <dt:packingType>
                        <bs:uuid>a7363144-e6a0-4af0-832f-0d403fdeb761</bs:uuid>
                        <bs:guid>f0b0ec9b-8341-4e95-bc0e-80898be598cb</bs:guid>
                        <dt:globalID>BE</dt:globalID>
                        <dt:name>Пакет (пачка/связка)</dt:name>
                      </dt:packingType>
                      <dt:productMarks class="UNDEFINED">7456873456-147885</dt:productMarks>
                    </dt:package>
                  </vd:packageList>
                  <vd:owner>
                    <bs:uuid>04ceb142-053d-11e1-99b4-d8d385fbc9e8</bs:uuid>
                    <bs:guid>fcd89443-218a-11e2-a69b-b499babae7ea</bs:guid>
                  </vd:owner>
                </vd:batch>
                <vd:vetDocument>
                  <bs:uuid>4bd8aa2c-fff6-4627-ae53-646badfdcbc8</bs:uuid>
                </vd:vetDocument>
              </vd:stockEntry>
            </vd:stockEntryList>
          </merc:getStockEntryVersionListResponse>
        </apl:result>
      </apl:application>
    </apldef:receiveApplicationResultResponse>
  </env:Body>
</env:Envelope>
Источник — http://help.vetrf.ru/index.php?title=GetStockEntryVersionListOperation_v2&oldid=22745