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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#	Название 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>

Коды ошибок

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

@@ Строка 19: / Строка 19: @@
 :: • Внутренняя ошибка системы.
-===Используемые пространства имён и типы===
-{{столбцы}}
-{{столбец}}
-* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/common|argc]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/common</nowiki>)
-** [[PackingFormList|argc:PackingFormList]]
-** [[Unit|argc:Unit]]
-** [[User|argc:User]]
-* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/production|argpr]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/production</nowiki>)
-** [[Product|argpr:Product]]
-** [[ProductItem|argpr:ProductItem]]
-** [[ProductType|argpr:ProductType]]
-** [[SubProduct|argpr:SubProduct]]
-{{столбец}}
-* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
-** [[Decimal|bs:Decimal]]
-** [[String255|bs:String255]]
-** [[UUID|bs:UUID]]
-** [[VersionStatus|bs:VersionStatus]]
-* [[NameSpaces#http://api.vetrf.ru/schema/cdm/cerberus/enterprise|ent]] (<nowiki>http://api.vetrf.ru/schema/cdm/cerberus/enterprise</nowiki>)
-** [[BusinessEntity|ent:BusinessEntity]]
-** [[Enterprise|ent:Enterprise]]
-** [[BusinessMember|ent:BusinessMember]]
-** [[EnterpriseRole|ent:EnterpriseRole]]
-** [[ProducerList|ent:ProducerList]]
-{{столбец}}
-* [[NameSpaces#http://api.vetrf.ru/schema/cdm/ikar|ikar]] (<nowiki>http://api.vetrf.ru/schema/cdm/ikar</nowiki>)
-** [[Country|ikar:Country]]
-* [[NameSpaces#http://api.vetrf.ru/schema/cdm/mercury/vet-document|vetd]] (<nowiki>http://api.vetrf.ru/schema/cdm/mercury/vet-document</nowiki>)
-** [[Batch|vetd:Batch]]
-** [[GoodsDate|vetd:GoodsDate]]
-** [[PackingForm|vetd:PackingForm]]
-** [[ProductMarkingList|vetd:ProductMarkingList]]
-** [[Producer|vetd:Producer]]
-** [[VetDocument|vetd:VetDocument]]
-** [[StockEntry|vetd:StockEntry]]
-** [[StockEntryNumber|vetd:StockEntryNumber]]
-{{столбец}}
-* [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>)
-** [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
-** [http://www.w3.org/TR/xmlschema-2/#dateTime xs:date]
-**  [http://www.w3.org/TR/xmlschema-2/#int xs:int]
-** [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
-** [http://www.w3.org/TR/xmlschema-2/#string xs:string]
-{{столбцы/конец}}
 == Данные запроса ==
 {| class="wikitable"