GetProductByUuid v2.0 - История изменений

Romanov-av: /* Спецификация ответа */

2020-09-27T12:48:37Z

Спецификация ответа

Romanov-av: /* Спецификация запроса */

2020-09-27T12:47:54Z

Спецификация запроса

← Предыдущая версия		Версия от 12:47, 27 сентября 2020
Строка 29:		Строка 29:
	! Тип		! Тип
	! Обязат.		! Обязат.
	! Описание		! Описание (нажмите [...] для отображения дополнительного описания)
	~~! Пример~~
	\|-		\|-
	\|1		\|001
	\|style="font-weight: ~~bold~~; font-family: Courier;" \|<ws:getProductByUuidRequest>		\|style="font-weight: ; font-family: Courier;" \|{{color\|#190dbf\|'''<ws:getProductByUuidRequest>'''}}
	\|		\|
	\|		\|
	\|		\| style="width:52em;"\|
	\|style="~~font-family~~: ~~Courier~~;" \|
	\|-		\|-
	\|2		\|002
	\|style="font-weight: ~~bold~~; font-family: Courier;" \|···<bs:uuid>		\|style="font-weight: ; font-family: Courier;" \|···{{color\|#190dbf\|'''<{{color\|#660e7a\|bs:}}uuid>'''}}{{color\|#131313\|UUID}}{{color\|#190dbf\|'''</{{color\|#660e7a\|bs:}}uuid>'''}}
	\|[[UUID\|bs:UUID]]		\|[[UUID\|bs:UUID]]
	\|[1..1]		\|[1..1]
	\|Идентификатор версии продукции		\|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;">
	* второй уровень иерархического справочника продукции ИС Меркурий		<span style="white-space:nowrap; font-weight: normal;">Идентификатор версии продукции.</span>
	~~\|style="font-family: Courier;" \|~~<~~bs:uuid~~>~~3008afa9-8a88-8586-5f75-08ce43189ac8~~</~~bs:uuid~~>		<div class="mw-collapsible-content" style="font-weight: normal;">
			* второй уровень иерархического справочника продукции ИС Меркурий</div>
			</div>
	\|-		\|-
	\|3		\|003
	\|style="font-weight: ~~bold~~; font-family: Courier;" \|</ws:getProductByUuidRequest>		\|style="font-weight: ; font-family: Courier;" \|{{color\|#190dbf\|'''</ws:getProductByUuidRequest>'''}}
	\|
	\|		\|
	\|		\|
	\|style="~~font-family~~: ~~Courier~~;" \|		\| style="width:52em;"\|
	\|-		\|-
	\|}		\|}

Romanov-av: /* Пример запроса */

2017-10-29T20:46:26Z

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

@@ Строка 202: / Строка 202: @@
 <div class = "mw-collapsible-content">
 <syntaxhighlight lang="xml">
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2" xmlns:bs="http://api.vetrf.ru/schema/cdm/base">
 </syntaxhighlight>
 </div>
@@ Строка 211: / Строка 218: @@
 <div class = "mw-collapsible-content">
 <syntaxhighlight lang="xml">
+<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
 </syntaxhighlight>
 </div>

Romanov-av: /* Спецификация ответа */

2017-10-29T20:06:01Z

Спецификация ответа

← Предыдущая версия		Версия от 20:06, 29 октября 2017
Строка 57:		Строка 57:

	==Спецификация ответа==		==Спецификация ответа==
			{\| class="wikitable"
			! #
			! Название XML-элемента
			! Тип
			! Обязат.
			! Описание
			! Пример
			\|-
			\|1
			\|style="font-weight: bold; font-family: Courier;" \|<ws:getProductByUuidResponse>
			\|
			\|
			\|
			\|style="font-family: Courier;" \|
			\|-
			\|2
			\|style="font-weight: bold; font-family: Courier;" \|···<dt:product>
			\|[[Product_v2.0\|dt:Product]]
			\|[1..1]
			\|Продукция
			* второй уровень иерархического справочника продукции ИС Меркурий
			\|style="font-family: Courier;" \|
			\|-
			\|3
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:uuid>
			\|[[UUID\|bs:UUID]]
			\|[1..1]
			\|Идентификатор версии продукции.
			\|style="font-family: Courier;" \|<bs:uuid>3008afa9-8a88-8586-5f75-08ce43189ac8</bs:uuid>
			\|-
			\|4
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:guid>
			\|[[UUID\|bs:UUID]]
			\|[1..1]
			\|Глобальный идентификатор продукции.
			\|style="font-family: Courier;" \|<bs:guid>362aa885-9b9f-ae95-05d0-f9570f4fbdc6</bs:guid>
			\|-
			\|5
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:active>
			\|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
			\|[1..1]
			\|Является ли запись активной:
			* true - запись активна;
			* false - запись не активна.
			\|style="font-family: Courier;" \|<bs:active>true</bs:active>
			\|-
			\|6
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:last>
			\|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
			\|[1..1]
			\|Является ли версия записи последней:
			* true - да;
			* false - нет.
			\|style="font-family: Courier;" \|<bs:last>true</bs:last>
			\|-
			\|7
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:status>
			\|[[VersionStatus\|bs:VersionStatus]]
			\|[1..1]
			\|Статус версии записи.
			\|style="font-family: Courier;" \|<bs:status>100</bs:status>
			\|-
			\|8
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:createDate>
			\|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
			\|[1..1]
			\|Дата создания записи.
			\|style="font-family: Courier;" \|<bs:createDate>2017-07-07T12:00:00</bs:createDate>
			\|-
			\|9
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:updateDate>
			\|[http://www.w3.org/TR/xmlschema-2/#DateTime xs:DateTime]
			\|[1..1]
			\|Дата изменения записи.
			\|style="font-family: Courier;" \|<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>
			\|-
			\|10
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:previous>
			\|[[UUID\|bs:UUID]]
			\|[0..1]
			\|Идентификатор предыдущей версии записи.
			\|style="font-family: Courier;" \|<bs:previous>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:previous>
			\|-
			\|11
			\|style="font-weight: bold; font-family: Courier;" \|······<bs:next>
			\|[[UUID\|bs:UUID]]
			\|[0..1]
			\|Идентификатор следующей версии записи.
			\|style="font-family: Courier;" \|<bs:next>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:next>
			\|-
			\|12
			\|style="font-weight: bold; font-family: Courier;" \|······<dt:name>
			\|[[String255\|bs:String255]]
			\|[1..1]
			\|Название продукции.
			\|style="font-family: Courier;" \|<dt:name>готовые мясные продукты</dt:name>
			\|-
			\|13
			\|style="font-weight: bold; font-family: Courier;" \|······<dt:code>
			\|[[String255\|bs:String255]]
			\|[1..1]
			\|Код ТН ВЭД продукции.
			\|style="font-family: Courier;" \|<dt:code>0210, 1601, 1602</dt:code>
			\|-
			\|14
			\|style="font-weight: bold; font-family: Courier;" \|······<dt:productType>
			\|[[ProductType_v2.0\|dt:ProductType]]
			\|[1..1]
			\|Тип продукции
			* первый уровень иерархического справочника продукции ИС Меркурий
			\|style="font-family: Courier;" \|<dt:productType>5</dt:productType>
			\|-
			\|15
			\|style="font-weight: bold; font-family: Courier;" \|···</dt:product>
			\|
			\|
			\|
			\|style="font-family: Courier;" \|
			\|-
			\|16
			\|style="font-weight: bold; font-family: Courier;" \|</ws:getProductByUuidResponse>
			\|
			\|
			\|
			\|style="font-family: Courier;" \|
			\|-
			\|}

	==Описание ошибок==		==Описание ошибок==

Romanov-av: /* Спецификация запроса */

2017-10-29T20:05:17Z

Спецификация запроса

← Предыдущая версия		Версия от 20:05, 29 октября 2017
Строка 24:		Строка 24:

	==Спецификация запроса==		==Спецификация запроса==
			{\| class="wikitable"
			! #
			! Название XML-элемента
			! Тип
			! Обязат.
			! Описание
			! Пример
			\|-
			\|1
			\|style="font-weight: bold; font-family: Courier;" \|<ws:getProductByUuidRequest>
			\|
			\|
			\|
			\|style="font-family: Courier;" \|
			\|-
			\|2
			\|style="font-weight: bold; font-family: Courier;" \|···<bs:uuid>
			\|[[UUID\|bs:UUID]]
			\|[1..1]
			\|Идентификатор версии продукции
			* второй уровень иерархического справочника продукции ИС Меркурий
			\|style="font-family: Courier;" \|<bs:uuid>3008afa9-8a88-8586-5f75-08ce43189ac8</bs:uuid>
			\|-
			\|3
			\|style="font-weight: bold; font-family: Courier;" \|</ws:getProductByUuidRequest>
			\|
			\|
			\|
			\|style="font-family: Courier;" \|
			\|-
			\|}

	==Спецификация ответа==		==Спецификация ответа==

Romanov-av в 19:22, 29 октября 2017

2017-10-29T19:22:58Z

Внесённые изменения

Romanov-av: Новая страница: «==Общие сведения== Операция '''GetProductByUuid''' предназначена для получения записи продукции по…»

2017-10-29T19:06:25Z

Новая страница: «==Общие сведения== Операция '''GetProductByUuid''' предназначена для получения записи продукции по…»

Новая страница

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

Операция '''GetProductByUuid''' предназначена для получения записи продукции по идентификатору версии записи.Уникальный идентификатор версии записи продукции содержится в ветеринарных сертификатах. Выполнение операции заканчивается либо возвратом записи той версии, которая значится под указанным UUID, то есть запись может быть не последней и/или не актуальной (active=false, last=false), либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

===Используемые пространства имён и типы===
{{столбцы}}
{{столбец}}
* [[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:dateTime]
** [http://www.w3.org/TR/xmlschema-2/#string xs:string]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/production|prod]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/production</nowiki>)
** [[Product|prod:Product]]
** [[ProductType|prod:ProductType]]
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[UUID|bs:UUID]]
{{столбцы/конец}}

===[[#Объект getProductByUuidRequest|Входные данные]]===
* уникальный идентификатор версии записи продукции.

===[[#Объект getProductByUuidResponse |Выходные данные]]===
* данные о продукции.

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


===Объект getProductByUuidRequest===

Корневой элемент запроса.

{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор версии записи продукции в реестре Россельхознадзора. || [[UUID|bs:UUID]] || 1
|}

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



===Объект getProductByUuidResponse===

Корневой объект ответа. Содержит информацию о запрашиваемой продукции.

{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/product|'''product''']] || Объект, содержащий сведения о продукции. || [[Product|prod:Product]] || 1
|}

===Объект [[#Объект getProductByUuidResponse|..Response]]/'''product'''===

Объект содержит свойства возвращаемой продукции.

{{Ветис.API ProductService Product|1}}

==Описание ошибок==
{| class="wikitable"
|-
! Ошибка !! Описание
|-
| '''InternalServiceFault''' || Внутренняя ошибка сервиса.
|-
| '''IncorrectRequestFault''' || Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям указанным в xsd, то есть сообщение не проходит валидацию.
|-
| '''EntityNotFoundFault''' || Объект с заданными параметрами не найден в базе.
|}

==Пример запроса==
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Запрос на получение данных о продукции "Готовые мясные продукты".
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://api.vetrf.ru/schema/cdm/argus/production/ws-definitions"
xmlns:base="http://api.vetrf.ru/schema/cdm/base">
<soapenv:Header/>
<soapenv:Body>
<ws:getSubProductByUuidRequest>
<base:uuid>3008afa9-8a88-8586-5f75-08ce43189ac8</base:uuid>
</ws:getSubProductByUuidRequest>
</soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
<br />
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Ответ на запрос.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<ws:getProductByUuidResponse xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
xmlns:pro="http://api.vetrf.ru/schema/cdm/argus/production"
xmlns:ws="http://api.vetrf.ru/schema/cdm/argus/production/ws-definitions">
<pro:product>
<bs:uuid>3008afa9-8a88-8586-5f75-08ce43189ac8</bs:uuid>
<bs:guid>e9fa27c7-c0e0-2f64-308c-c6409de238ae</bs:guid>
<bs:active>true</bs:active>
<bs:last>true</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2011-05-23T10:35:08+03:00</bs:createDate>
<bs:updateDate>2011-05-23T10:35:08+03:00</bs:updateDate>
<pro:name>готовые мясные продукты</pro:name>
<pro:code>0210, 1601, 1602</pro:code>
<pro:productType>5</pro:productType>
</pro:product>
</ws:getProductByUuidResponse>
</S:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>

[[Category:Ветис.API]]
[[Category:ProductService]]