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

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


==Спецификация ответа==
==Спецификация ответа==
{| class="wikitable"
! #
! Название XML-элемента
! Тип
! Обязат.
! Описание
! Пример
|-
|1
|style="font-weight: bold; font-family: Courier;" |<ws:getProductItemByUuidResponse>
|
|
|
|style="font-family: Courier;" |
|-
|2
|style="font-weight: bold; font-family: Courier;" |···&lt;dt:productItem>
|[[ProductItem_v2.0|dt:ProductItem]]
|[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>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|4
|style="font-weight: bold; font-family: Courier;" |······<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор номенклатуры.
|style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</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;" |······&lt;dt:globalID>
|[[GTINType_v2.0|dt:GTINType]]
|[0..1]
|Trade Identification Number (GTIN) - идентификационный номер продукции производителя.
|style="font-family: Courier;" |&lt;dt:globalID>85672854</dt:globalID>
|-
|11
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:name>
|[[String255|bs:String255]]
|[0..1]
|Наименование продукции.
|style="font-family: Courier;" |&lt;dt:name>Название</dt:name>
|-
|12
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:code>
|[[String255|bs:String255]]
|[0..1]
|Артикул (код) продукции в соответствии с внутренним кодификатором производителя.
|style="font-family: Courier;" |&lt;dt:code>12</dt:code>
|-
|13
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:productType>
|[[ProductType_v2.0|dt:ProductType]]
|[1..1]
|Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.
|style="font-family: Courier;" |&lt;dt:productType>1</dt:productType>
|-
|14
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:product>
|[[Product_v2.0|dt:Product]]
|[1..1]
|Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
|style="font-family: Courier;" |
|-
|15
|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>
|-
|16
|style="font-weight: bold; font-family: Courier;" |·········<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор продукции.
|style="font-family: Courier;" |<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
|-
|17
|style="font-weight: bold; font-family: Courier;" |······</dt:product>
|
|
|
|style="font-family: Courier;" |
|-
|18
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:subProduct>
|[[SubProduct_v2.0|dt:SubProduct]]
|[1..1]
|Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
|style="font-family: Courier;" |
|-
|19
|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>
|-
|20
|style="font-weight: bold; font-family: Courier;" |·········<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор вида продукции.
|style="font-family: Courier;" |<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
|-
|21
|style="font-weight: bold; font-family: Courier;" |······</dt:subProduct>
|
|
|
|style="font-family: Courier;" |
|-
|22
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:correspondsToGost>
|[http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
|[1..1]
|Соответствует ли ГОСТу.
|style="font-family: Courier;" |&lt;dt:correspondsToGost>true</dt:correspondsToGost>
|-
|23
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:gost>
|[[String255|bs:String255]]
|[0..1]
|ГОСТ.
|style="font-family: Courier;" |&lt;dt:gost>ГОСТ-621187/53</dt:gost>
|-
|24
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:producer>
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[0..1]
|ХС-производитель продукции.
|style="font-family: Courier;" |
|-
|25
|style="font-weight: bold; font-family: Courier;" |·········<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии хозяйствующего субъекта-владельца.
|style="font-family: Courier;" |<bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
|-
|26
|style="font-weight: bold; font-family: Courier;" |·········<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор хозяйствующего субъекта-владельца.
|style="font-family: Courier;" |<bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
|-
|27
|style="font-weight: bold; font-family: Courier;" |······</dt:producer>
|
|
|
|style="font-family: Courier;" |
|-
|28
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:tmOwner>
|[[BusinessEntity_v2.0|dt:BusinessEntity]]
|[0..1]
|ХС-собственник торговой марки.
|style="font-family: Courier;" |
|-
|29
|style="font-weight: bold; font-family: Courier;" |·········<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии хозяйствующего субъекта-владельца.
|style="font-family: Courier;" |<bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
|-
|30
|style="font-weight: bold; font-family: Courier;" |·········<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор хозяйствующего субъекта-владельца.
|style="font-family: Courier;" |<bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
|-
|31
|style="font-weight: bold; font-family: Courier;" |······</dt:tmOwner>
|
|
|
|style="font-family: Courier;" |
|-
|32
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:producing>
|[[ProductItemProducing_v2.0|dt:ProductItemProducing]]
|[0..*]
|Список площадок, на которых выпускается данная продукция.
|style="font-family: Courier;" |
|-
|33
|style="font-weight: bold; font-family: Courier;" |········&lt;dt:location>
|[[Enterprise_v2.0|dt:Enterprise]]
|[1..1]
|Площадка, осуществляющая выпуск продукции.
|style="font-family: Courier;" |
|-
|34
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии предприятия.
|style="font-family: Courier;" |<bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
|-
|35
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор предприятия.
|style="font-family: Courier;" |<bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
|-
|36
|style="font-weight: bold; font-family: Courier;" |·········</dt:location>
|
|
|
|style="font-family: Courier;" |
|-
|37
|style="font-weight: bold; font-family: Courier;" |······</dt:producing>
|
|
|
|style="font-family: Courier;" |
|-
|38
|style="font-weight: bold; font-family: Courier;" |······&lt;dt:packaging>
|[[Packaging_v2.0|dt:Packaging]]
|[0..1]
|Фасовка.
|style="font-family: Courier;" |
|-
|39
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:packagingType>
|[[PackingType_v2.0|dt:PackingType]]
|[1..1]
|Тип упаковки.
|style="font-family: Courier;" |&lt;dt:packagingType>1</dt:packagingType>
|-
|40
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии типа упаковки.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|41
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор упаковки.
|style="font-family: Courier;" |<bs:guid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:guid>
|-
|42
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:globalID>
|[[PackingCodeType_v2.0|dt:PackingCodeType]]
|[1..1]
|Уникальный идентификатор упаковки.
|style="font-family: Courier;" |&lt;dt:globalID>7B</dt:globalID>
|-
|43
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[String255|bs:String255]]
|[1..1]
|Наименование упаковки.
|style="font-family: Courier;" |&lt;dt:name>Название</dt:name>
|-
|44
|style="font-weight: bold; font-family: Courier;" |·········</dt:packagingType>
|
|
|
|style="font-family: Courier;" |
|-
|45
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:quantity>
|[http://www.w3.org/TR/xmlschema-2/#int xs:int]
|[0..1]
|Количество единиц упаковки.
|style="font-family: Courier;" |&lt;dt:quantity>10</dt:quantity>
|-
|46
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:volume>
|[[Decimal |bs:Decimal]]
|[0..1]
|Объём единицы упаковки товара.
|style="font-family: Courier;" |&lt;dt:volume>50</dt:volume>
|-
|47
|style="font-weight: bold; font-family: Courier;" |·········&lt;dt:unit>
|[[Unit_v2.0|dt:Unit]]
|[0..1]
|Единица измерения объёма единицы упаковки товара.
|style="font-family: Courier;" |
|-
|48
|style="font-weight: bold; font-family: Courier;" |············<bs:uuid>
|[[UUID|bs:UUID]]
|[1..1]
|Идентификатор версии еиницы измерения.
|style="font-family: Courier;" |<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
|-
|49
|style="font-weight: bold; font-family: Courier;" |············<bs:guid>
|[[UUID|bs:UUID]]
|[1..1]
|Глобальный идентификатор еиницы измерения.
|style="font-family: Courier;" |<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
|-
|50
|style="font-weight: bold; font-family: Courier;" |············&lt;dt:name>
|[[String255|bs:String255]]
|[1..1]
|Наименование единицы измерения
|style="font-family: Courier;" |&lt;dt:name>кг</dt:name>
|-
|51
|style="font-weight: bold; font-family: Courier;" |·········</dt:unit>
|
|
|
|style="font-family: Courier;" |
|-
|52
|style="font-weight: bold; font-family: Courier;" |······</dt:packaging>
|
|
|
|style="font-family: Courier;" |
|-
|53
|style="font-weight: bold; font-family: Courier;" |···</dt:productItem>
|
|
|
|style="font-family: Courier;" |
|-
|54
|style="font-weight: bold; font-family: Courier;" |</ws:getProductItemByUuidResponse>
|
|
|
|style="font-family: Courier;" |
|-
|}


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

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

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

Операция GetProductItemByUuid предназначена для получения записи о номенклатуре производителя (4 уровень иерархического справочника) по уникальному идентификатору версии записи. Запись может быть не последней и/или не актуальной (last=false, active=false). Номенклатура может быть изменена при помощи метода ModifyProducerStockListOperation, при изменении глобальный идентификатор GUID останется прежним, идентификатор версии записи UUID изменится. Выполнение операции заканчивается либо возвратом объекта номенклатуры производителя, либо ошибкой, в случае если параметры запроса не корректны, если запись по запросу не найдена или произошла иная ошибка выполнения запроса.

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

  • уникальный идентификатор версии записи номенклатуры производителя.

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

  • данные записи номенклатуры производителя.

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

# Название XML-элемента Тип Обязат. Описание Пример
1 <ws:getProductItemByUuidRequest>
2 ···<bs:uuid> bs:UUID [1..1] Идентификатор версии номенклатуры <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
3 </ws:getProductItemByUuidRequest>

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

# Название XML-элемента Тип Обязат. Описание Пример
1 <ws:getProductItemByUuidResponse>
2 ···<dt:productItem> dt:ProductItem [1..1] Данные о номенклатуре производителя
3 ······<bs:uuid> bs:UUID [1..1] Идентификатор версии номенклатуры. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
4 ······<bs:guid> bs:UUID [1..1] Глобальный идентификатор номенклатуры. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
5 ······<bs:active> xs:boolean [1..1] Является ли запись активной:
  • true - запись активна;
  • false - запись не активна.
 <bs:active>true</bs:active>
6 ······<bs:last> xs:boolean [1..1] Является ли версия записи последней:
  • true - да;
  • false - нет.
 <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 ······<dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - идентификационный номер продукции производителя. <dt:globalID>85672854</dt:globalID>
11 ······<dt:name> bs:String255 [0..1] Наименование продукции. <dt:name>Название</dt:name>
12 ······<dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя. <dt:code>12</dt:code>
13 ······<dt:productType> dt:ProductType [1..1] Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. <dt:productType>1</dt:productType>
14 ······<dt:product> dt:Product [1..1] Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
15 ·········<bs:uuid> bs:UUID [1..1] Идентификатор версии продукции. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
16 ·········<bs:guid> bs:UUID [1..1] Глобальный идентификатор продукции. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
17 ······</dt:product>
18 ······<dt:subProduct> dt:SubProduct [1..1] Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
19 ·········<bs:uuid> bs:UUID [1..1] Идентификатор версии вида продукции. <bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
20 ·········<bs:guid> bs:UUID [1..1] Глобальный идентификатор вида продукции. <bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
21 ······</dt:subProduct>
22 ······<dt:correspondsToGost> xs:boolean [1..1] Соответствует ли ГОСТу. <dt:correspondsToGost>true</dt:correspondsToGost>
23 ······<dt:gost> bs:String255 [0..1] ГОСТ. <dt:gost>ГОСТ-621187/53</dt:gost>
24 ······<dt:producer> dt:BusinessEntity [0..1] ХС-производитель продукции.
25 ·········<bs:uuid> bs:UUID [1..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
26 ·········<bs:guid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
27 ······</dt:producer>
28 ······<dt:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки.
29 ·········<bs:uuid> bs:UUID [1..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
30 ·········<bs:guid> bs:UUID [1..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
31 ······</dt:tmOwner>
32 ······<dt:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция.
33 ········<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции.
34 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии предприятия. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
35 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор предприятия. <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
36 ·········</dt:location>
37 ······</dt:producing>
38 ······<dt:packaging> dt:Packaging [0..1] Фасовка.
39 ·········<dt:packagingType> dt:PackingType [1..1] Тип упаковки. <dt:packagingType>1</dt:packagingType>
40 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии типа упаковки. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
41 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор упаковки. <bs:guid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:guid>
42 ············<dt:globalID> dt:PackingCodeType [1..1] Уникальный идентификатор упаковки. <dt:globalID>7B</dt:globalID>
43 ············<dt:name> bs:String255 [1..1] Наименование упаковки. <dt:name>Название</dt:name>
44 ·········</dt:packagingType>
45 ·········<dt:quantity> xs:int [0..1] Количество единиц упаковки. <dt:quantity>10</dt:quantity>
46 ·········<dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара. <dt:volume>50</dt:volume>
47 ·········<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара.
48 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии еиницы измерения. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
49 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор еиницы измерения. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
50 ············<dt:name> bs:String255 [1..1] Наименование единицы измерения <dt:name>кг</dt:name>
51 ·········</dt:unit>
52 ······</dt:packaging>
53 ···</dt:productItem>
54 </ws:getProductItemByUuidResponse>

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

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

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

Запрос данных о номенклатуре производителя по его уникальному идентификатору.


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

Источник — http://help.vetrf.ru/index.php?title=GetProductItemByUuid_v2.0&oldid=22240