GetProductByUuid v2.0: различия между версиями
Перейти к навигации
Перейти к поиску
Строка 202: | Строка 202: | ||
<div class = "mw-collapsible-content"> | <div class = "mw-collapsible-content"> | ||
<syntaxhighlight lang="xml"> | <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"> | |||
<soapenv:Header/> | |||
<soapenv:Body> | |||
<ws:getProductByUuidRequest> | |||
<bs:uuid>b1253a77-0585-291f-57a4-53319e897866</bs:uuid> | |||
</ws:getProductByUuidRequest> | |||
</soapenv:Body> | |||
</soapenv:Envelope> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</div> | </div> | ||
Строка 211: | Строка 218: | ||
<div class = "mw-collapsible-content"> | <div class = "mw-collapsible-content"> | ||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> | |||
<soap:Body xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> | |||
<v2:getProductByUuidResponse xmlns:bs="http://api.vetrf.ru/schema/cdm/base" xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" xmlns:v2="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2"> | |||
<dt:product> | |||
<bs:uuid>b1253a77-0585-291f-57a4-53319e897866</bs:uuid> | |||
<bs:guid>362aa885-9b9f-ae95-05d0-f9570f4fbdc6</bs:guid> | |||
<bs:active>true</bs:active> | |||
<bs:last>true</bs:last> | |||
<bs:status>100</bs:status> | |||
<bs:createDate>2011-05-23T10:25:38+04:00</bs:createDate> | |||
<bs:updateDate>2011-05-23T10:25:38+04:00</bs:updateDate> | |||
<dt:name>говядина</dt:name> | |||
<dt:code>0201, 0202, 0206, 0210</dt:code> | |||
<dt:productType>1</dt:productType> | |||
</dt:product> | |||
</v2:getProductByUuidResponse> | |||
</soap:Body> | |||
</soapenv:Envelope> | |||
</syntaxhighlight> | </syntaxhighlight> | ||
</div> | </div> |
Версия 23:46, 29 октября 2017
Общие сведения
Операция GetProductByUuid предназначена для получения записи продукции (2 уровень иерархического справочника) по идентификатору версии записи. Выполнение операции заканчивается либо возвратом записи той версии, которая значится под указанным UUID, то есть запись может быть не последней и/или не актуальной (active=false, last=false), либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.
Входные данные
- уникальный идентификатор версии записи продукции.
Выходные данные
- данные о продукции.
Спецификация запроса
# | Название XML-элемента | Тип | Обязат. | Описание | Пример |
---|---|---|---|---|---|
1 | <ws:getProductByUuidRequest> | ||||
2 | ···<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии продукции
|
<bs:uuid>3008afa9-8a88-8586-5f75-08ce43189ac8</bs:uuid> |
3 | </ws:getProductByUuidRequest> |
Спецификация ответа
# | Название XML-элемента | Тип | Обязат. | Описание | Пример |
---|---|---|---|---|---|
1 | <ws:getProductByUuidResponse> | ||||
2 | ···<dt:product> | dt:Product | [1..1] | Продукция
|
|
3 | ······<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии продукции. | <bs:uuid>3008afa9-8a88-8586-5f75-08ce43189ac8</bs:uuid> |
4 | ······<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор продукции. | <bs:guid>362aa885-9b9f-ae95-05d0-f9570f4fbdc6</bs:guid> |
5 | ······<bs:active> | xs:boolean | [1..1] | Является ли запись активной:
|
<bs:active>true</bs:active> |
6 | ······<bs:last> | xs:boolean | [1..1] | Является ли версия записи последней:
|
<bs:last>true</bs:last> |
7 | ······<bs:status> | bs:VersionStatus | [1..1] | Статус версии записи. | <bs:status>100</bs:status> |
8 | ······<bs:createDate> | xs:DateTime | [1..1] | Дата создания записи. | <bs:createDate>2017-07-07T12:00:00</bs:createDate> |
9 | ······<bs:updateDate> | xs:DateTime | [1..1] | Дата изменения записи. | <bs:updateDate>2017-07-07T12:00:00</bs:updateDate> |
10 | ······<bs:previous> | bs:UUID | [0..1] | Идентификатор предыдущей версии записи. | <bs:previous>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:previous> |
11 | ······<bs:next> | bs:UUID | [0..1] | Идентификатор следующей версии записи. | <bs:next>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:next> |
12 | ······<dt:name> | bs:String255 | [1..1] | Название продукции. | <dt:name>готовые мясные продукты</dt:name> |
13 | ······<dt:code> | bs:String255 | [1..1] | Код ТН ВЭД продукции. | <dt:code>0210, 1601, 1602</dt:code> |
14 | ······<dt:productType> | dt:ProductType | [1..1] | Тип продукции
|
<dt:productType>5</dt:productType> |
15 | ···</dt:product> | ||||
16 | </ws:getProductByUuidResponse> |
Описание ошибок
Ошибка | Описание |
---|---|
InternalServiceFault | Внутренняя ошибка сервиса. |
IncorrectRequestFault | Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям указанным в xsd, то есть сообщение не проходит валидацию. |
EntityNotFoundFault | Объект с заданными параметрами не найден в базе. |
Пример запроса
Запрос на получение данных о продукции "Готовые мясные продукты".
<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">
<soapenv:Header/>
<soapenv:Body>
<ws:getProductByUuidRequest>
<bs:uuid>b1253a77-0585-291f-57a4-53319e897866</bs:uuid>
</ws:getProductByUuidRequest>
</soapenv:Body>
</soapenv:Envelope>
Ответ на запрос.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<v2:getProductByUuidResponse xmlns:bs="http://api.vetrf.ru/schema/cdm/base" xmlns:dt="http://api.vetrf.ru/schema/cdm/dictionary/v2" xmlns:v2="http://api.vetrf.ru/schema/cdm/registry/ws-definitions/v2">
<dt:product>
<bs:uuid>b1253a77-0585-291f-57a4-53319e897866</bs:uuid>
<bs:guid>362aa885-9b9f-ae95-05d0-f9570f4fbdc6</bs:guid>
<bs:active>true</bs:active>
<bs:last>true</bs:last>
<bs:status>100</bs:status>
<bs:createDate>2011-05-23T10:25:38+04:00</bs:createDate>
<bs:updateDate>2011-05-23T10:25:38+04:00</bs:updateDate>
<dt:name>говядина</dt:name>
<dt:code>0201, 0202, 0206, 0210</dt:code>
<dt:productType>1</dt:productType>
</dt:product>
</v2:getProductByUuidResponse>
</soap:Body>
</soapenv:Envelope>