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

Версия 23:22, 29 октября 2017

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

Операция GetProductItemList предназначена для получения списка наименований продукции с возможностью фильтрации по уровням продукции иерархического справочника, по номенклатуре определенного предприятия-производителя или всех предприятий определенного хозяйствующего субъекта. В список попадают только актуальные записи (active=true). Поддерживается возможность постраничного вывода. Добавить записи номенклатуры производителя можно с помощью операции ModifyProducerStockListOperation. Выполнение операции заканчивается либо возвратом списка наименований продукции, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

Входные данные

параметры выводимого списка;
идентификатор типа продукции (1 уровень иерархического справочника);
глобальный идентификатор продукции (2 уровень иерархического справочника).
глобальный идентификатор вида продукции (3 уровень иерархического справочника).
глобальный идентификатор предприятия-производителя.
глобальный идентификатор хозяйствующего субъекта.

Выходные данные

список продукции (4 уровень иерархического справочника), отфильтрованный по заданным параметрам.

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

#	Название XML-элемента	Тип	Обязат.	Описание	Пример
1	<ws:getProductItemListRequest>
2	···<bs:listOptions>	bs:ListOptions	[0..1]	Параметры запрашиваемого списка.
3	······<bs:count>	xs:nonNegativeInteger	[0..1]	Максимальное запрашиваемое количество объектов в списке. По умолчанию значение 100; Максимально возможное значение 1000.	<bs:count>10</bs:count>
4	······<bs:offset>	xs:nonNegativeInteger	[0..1]	Номер элемента, по которому осуществляется смещение первого элемента списка. По умолчанию значение 0.	<bs:offset>2</bs:offset>
5	···</bs:listOptions>
6	···<vd:productType>	dt:ProductType	[0..1]	Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.	<vd:productType>1</vd:productType>
7	···<vd:product>	dt:Product	[0..1]	Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
8	······<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
9	···</vd:product>
10	···<vd:subProduct>	dt:SubProduct	[0..1]	Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
11	······<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.	<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
12	···</vd:subProduct>
13	···<dt:businessEntity>	dt:BusinessEntity	[0..1]	Данные о хозяйствующем субъекте.
14	······<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор хозяйствующего субъекта.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
15	···</dt:businessEntity>
16	···<dt:enterprise>	dt:Enterprise	[0..1]	Данные о предприятии-производителе продукции
17	······<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор предприятия	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
18	···</dt:enterprise>
19	</ws:getProductItemListRequest>

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

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

Ошибка	Описание
InternalServiceFault	Внутренняя ошибка сервиса.
IncorrectRequestFault	Некорректный запрос. Происходит в случае, если запрос не соответствует требованиям указанным в xsd, то есть сообщение не проходит валидацию.
OffsetOutOfRangeFault	Заданный в запросе отступ больше числа записей в результате запроса.

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

Запрос на получение первой записи списка наименований продукции без смещения.

Ответ на запрос.

@@ Строка 95: / Строка 95: @@
 |-
 |8
-|style="font-weight: bold; font-family: Courier;" |······<bs:uuid>
-|[[UUID|bs:UUID]]
-|[1..1]
-|Идентификатор версии продукции.
-|style="font-family: Courier;" |<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
-|-
-|9
 |style="font-weight: bold; font-family: Courier;" |······<bs:guid>
 |[[UUID|bs:UUID]]
@@ Строка 108: / Строка 101: @@
 |style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
 |-
-|10
+|9
 |style="font-weight: bold; font-family: Courier;" |···</vd:product>
 |
@@ Строка 115: / Строка 108: @@
 |style="font-family: Courier;" |
 |-
-|11
+|10
 |style="font-weight: bold; font-family: Courier;" |···<vd:subProduct>
 |[[SubProduct_v2.0|dt:SubProduct]]
@@ Строка 122: / Строка 115: @@
 |style="font-family: Courier;" |
 |-
-|12
+|11
-|style="font-weight: bold; font-family: Courier;" |······<bs:uuid>
-|[[UUID|bs:UUID]]
-|[1..1]
-|Идентификатор версии вида продукции.
-|style="font-family: Courier;" |<bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
-|-
-|13
 |style="font-weight: bold; font-family: Courier;" |······<bs:guid>
 |[[UUID|bs:UUID]]
@@ Строка 136: / Строка 122: @@
 |style="font-family: Courier;" |<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
 |-
-|14
+|12
 |style="font-weight: bold; font-family: Courier;" |···</vd:subProduct>
 |
@@ Строка 143: / Строка 129: @@
 |style="font-family: Courier;" |
 |-
-|15
+|13
 |style="font-weight: bold; font-family: Courier;" |···&lt;dt:businessEntity>
 |[[BusinessEntity_v2.0|dt:BusinessEntity]]
@@ Строка 150: / Строка 136: @@
 |style="font-family: Courier;" |
 |-
-|16
+|14
-|style="font-weight: bold; font-family: Courier;" |······<bs:uuid>
-|[[UUID|bs:UUID]]
-|[0..1]
-|Идентификатор версии хозяйствующего субъекта.
-|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
-|-
-|17
 |style="font-weight: bold; font-family: Courier;" |······<bs:guid>
 |[[UUID|bs:UUID]]
-|[0..1]
+|[1..1]
 |Глобальный идентификатор хозяйствующего субъекта.
 |style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
 |-
-|18
+|15
 |style="font-weight: bold; font-family: Courier;" |···</dt:businessEntity>
 |
@@ Строка 171: / Строка 150: @@
 |style="font-family: Courier;" |
 |-
-|19
+|16
 |style="font-weight: bold; font-family: Courier;" |···&lt;dt:enterprise>
 |[[Enterprise_v2.0|dt:Enterprise]]
@@ Строка 178: / Строка 157: @@
 |style="font-family: Courier;" |
 |-
-|20
+|17
-|style="font-weight: bold; font-family: Courier;" |······<bs:uuid>
-|[[UUID|bs:UUID]]
-|[0..1]
-|Идентификатор версии предприятия
-|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
-|-
-|21
 |style="font-weight: bold; font-family: Courier;" |······<bs:guid>
 |[[UUID|bs:UUID]]
-|[0..1]
+|[1..1]
 |Глобальный идентификатор предприятия
 |style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
 |-
-|22
+|18
 |style="font-weight: bold; font-family: Courier;" |···</dt:enterprise>
 |
@@ Строка 199: / Строка 171: @@
 |style="font-family: Courier;" |
 |-
-|23
+|19
 |style="font-weight: bold; font-family: Courier;" |</ws:getProductItemListRequest>
 |