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

Версия 12:26, 16 июля 2017

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

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

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

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

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

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

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

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

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

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

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

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	······<dt:login>	xs:NCName	[1..1]	Логин пользователя, зарегистрированного в системе Меркурий.	<dt:login>user_ab_150101</dt: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>

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

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

Получение списка версий записи складского журнала

Коды ошибок

Вернуться к началу ↑

@@ Строка 22: / Строка 22: @@
 == Данные запроса ==
+{| class="wikitable"
+! #
+! style="font-weight: bold; font-family: Courier;" | Название XML-элемента
+! Тип
+! Кардинальность
+! Описание
+! Пример
+|-
+| 1
+| style="font-weight: bold; font-family: Courier;" | <merc:getStockEntryVersionListRequest>
+|
+|
+|
+|
+|-
+| 2
+| style="font-weight: bold; font-family: Courier;" | ···<merc:localTransactionId>
+| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
+| [1..1]
+| Идентификатор заявки в клиентской системе.
+| <bs:guid>A00001</bs:guid>
+|-
+| 3
+| style="font-weight: bold; font-family: Courier;" | ···<merc:initiator>
+| [[User_v2.0|dt:User]]
+| [1..1]
+| Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
+|
+|-
+| 4
+| style="font-weight: bold; font-family: Courier;" | ······&lt;dt:login>
+| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
+| [1..1]
+| Логин пользователя, зарегистрированного в системе Меркурий.
+| &lt;dt:login>user_ab_150101</dt:login>
+|-
+| 5
+| style="font-weight: bold; font-family: Courier;" | ···</merc:initiator>
+|
+|
+|
+|
+|-
+| 6
+| style="font-weight: bold; font-family: Courier;" | ···<bs:listOptions>
+| [[ListOptions|bs:ListOptions]]
+| [0..1]
+| Параметры запрашиваемого списка.
+|
+|-
+| 7
+| style="font-weight: bold; font-family: Courier;" | ······<bs:count>
+| [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]
+| [0..1]
+| Максимальное запрашиваемое количество объектов в списке.
+* По умолчанию значение 100;
+* Максимально возможное значение 1000.
+| <bs:count>10</bs:count>
+|-
+| 8
+| style="font-weight: bold; font-family: Courier;" | ······<bs:offset>
+| [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]
+| [0..1]
+| Номер элемента, по которому осуществляется смещение первого элемента списка. * По умолчанию значение 0.
+| <bs:offset>2</bs:offset>
+|-
+| 9
+| style="font-weight: bold; font-family: Courier;" | ···<bs:listOptions>
+|
+|
+|
+|
+|-
+| 10
+| style="font-weight: bold; font-family: Courier;" | ···<bs:guid>
+| [[UUID|bs:UUID]]
+| [1..1]
+| Глобальный идентификатор записи складского журнала.
+| <bs:guid>9b7082e2-2d20-4182-be1a-c93974f8b8c6</bs:guid>
+|-
+| 11
+| style="font-weight: bold; font-family: Courier;" | ···&lt;dt:enterpriseGuid>
+| [[UUID|bs:UUID]]
+| [1..1]
+| Идентификатор предприятия, по которому производится поиск записи.
+| &lt;dt:enterpriseGuid>851cf860-e9a3-4981-b83e-3dc6cb06cf07</dt:enterpriseGuid>
+|-
+| 12
+| style="font-weight: bold; font-family: Courier;" | </merc:getStockEntryVersionListRequest>
+|
+|
+|
+|
+|}
 == Данные ответа ==