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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 80: Строка 80:
Описание вида продукции.
Описание вида продукции.


{| class="wikitable"
{{Ветис.API ProductService Subproduct}}
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор версии записи вида продукции || [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный уникальный идентификатор вида продукции || [[UUID|bs:UUID]] || 1
|-
| '''active''' || Флаг, обозначающий активна ли запись, то есть является ли последней версией, описывающей объект || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| '''last''' || Флаг, указывающий, последняя ли запись || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| '''status''' || Статус записи. Обозначает причину появления текущей версии записи. || [http://www.w3.org/TR/xmlschema-2/#integer xs:integer] || 1
|-
| '''createDate''' || Дата создания записи || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|-
| '''updateDate''' || Дата обновления записи || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 0..1
|-
| '''previous''' || Идентификатор предыдущей версии записи || [[UUID|bs:UUID]] || 0..1
|-
| '''next''' || Идентификатор следующей версии записи || [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Название продукции || [[String255|bs:String255]] || 1
|-
| '''code''' || Код ТН ВЭД продукции || [[String255|bs:String255]] || 1
|-
| '''productGuid''' || Идентификатор продукции || [[Product|prod:Product]] || 1
|}


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

Версия 14:59, 17 ноября 2016

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

Операция GetSubProductByProductList предназаначена для получения списка видов продукции, отфильтрованного по указанному продукту. В список попадают только актуальные последние записи (active=true, last=true). Метод поддерживает возможность постраничного вывода.

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


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

Объект getSubProductByProductListRequest

Поле Описание Тип данных Обязательность
listOptions Параметры запрашиваемого списка. bs:ListOptions 0..1
productGuid Глобальный идентифкатор продукции, по которому производится отбор. prod:Product 1

Объект ..Request/listOptions

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

Поле Описание Тип данных Обязательность
count Количество значений в списке
  • По умолчанию значение равно 100;
  • Максимально допустимое значение равно 1000.
xs:nonNegativeInteger 0..1
offset Смещение в списке относительно начала. xs:nonNegativeInteger 0..1

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

Объект getSubProductByProductListResponse

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

Поле Описание Тип данных Обязательность
subProductList Список видов продукции указанной в запросе. prod:SubProductList 1

Объект ..Response/subProductList

Список продукции, полученной в результате запроса.

Поле Описание Тип данных Обязательность
subProduct Данные о продукции. prod:SubProduct 0..*

Объект ..Response/subProductList/subProduct

Описание вида продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи о продукции в реестре Россельхознадзора. bs:UUID 1
GUID Глобальный идентификатор продукции в реестре Россельхознадзора. bs:UUID 1
active Флаг, указывающий на то, активна ли запись. xs:boolean 1
last Флаг, указывающий на то, является ли запись последней. xs:boolean 1
status Статус версии записи. xs:string 1
createDate Дата создания записи о продукции в реестре Россельхознадзора. xs:date 1
updateDate Дата последнего обновления записи в реестре Россельхознадзора. xs:date 1
previous Идентификатор предыдущей версии записи. bs:UUID 0..1
name Название вида продукции. xs:string 1
code Код ТН ВЭД вида продукции. xs:string 1
englishName Английское название вида продукции. bs:String255 0..1
productGuid Идентификатор продукции (второй уровень иерархии справочника продукции). bs:UUID 1

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

Запрос данных о видах продукции

<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" 
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:getSubProductByProductListRequest>
        <base:listOptions>
            <base:count>100</base:count>
            <base:offset>0</base:offset>
         </base:listOptions>
         <prod:productGuid>337f79dc-4376-6e33-dabe-d5447913b97d</prod:productGuid>
      </ws:getSubProductByProductListRequest>
   </soapenv:Body>
</soapenv:Envelope>