GetStockEntryVersionListOperation v2

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

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

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

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

Коды ошибок

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