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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

argc (http://api.vetrf.ru/schema/cdm/argus/common)
argpr (http://api.vetrf.ru/schema/cdm/argus/production)

bs (http://api.vetrf.ru/schema/cdm/base)
ent (http://api.vetrf.ru/schema/cdm/cerberus/enterprise)

ikar (http://api.vetrf.ru/schema/cdm/ikar)
- ikar:Country
vetd (http://api.vetrf.ru/schema/cdm/mercury/vet-document)

xs (http://www.w3.org/2001/XMLSchema)
- xs:boolean
- xs:date
- xs:int
- xs:NCName
- xs:string

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

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

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

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

Получение записи складского журнала по её идентификатору

</soapenv:Envelope>

Коды ошибок

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

@@ Строка 64: / Строка 64: @@
 {{столбцы/конец}}
 == Данные запроса ==
+{| class="wikitable"
+! #
+! Название XML-элемента
+! Тип
+! Кардинальность
+! Описание
+! Пример
+|-
+| 1
+| style="font-weight: bold; font-family: Courier;" | <merc:getStockEntryByGuidRequest>
+|
+|
+|
+|
+|-
+| 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:guid>
+| [[UUID|bs:UUID]]
+| [1..1]
+| Глобальный идентификатор записи складского журнала.
+| <bs:guid>9b7082e2-2d20-4182-be1a-c93974f8b8c6</bs:guid>
+|-
+| 7
+| 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>
+|-
+| 8
+| style="font-weight: bold; font-family: Courier;" | </merc:getStockEntryByGuidRequest>
+|
+|
+|
+|
+|}
 == Данные ответа ==