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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 87: Строка 87:
  || [[RegisterModificationType|bs:RegisterModificationType]] || 1
  || [[RegisterModificationType|bs:RegisterModificationType]] || 1
|-
|-
| [[ModifyProducerStockListOperation#Объект enterprise|'''enterprise''']] || Информация о предприятии, на котором вырабатывается продукция || [[Enterprise|ent:Enterprise]] || 1
| [[ModifyProducerStockListOperation#Объект ..Request/modifcationOperation/enterprise|'''enterprise''']] || Информация о предприятии, на котором вырабатывается продукция || [[Enterprise|ent:Enterprise]] || 1
|-
|-
| [[ModifyProducerStockListOperation#Объект resultingList|'''resultingList''']] || Список продукции, добавляемой в справочник. На данный момент разрешается добавлять только по одной позиции. || [[ProductItemList|prod:ProductItemList]] || 1
| [[ModifyProducerStockListOperation#Объект resultingList|'''resultingList''']] || Список продукции, добавляемой в справочник. На данный момент разрешается добавлять только по одной позиции. || [[ProductItemList|prod:ProductItemList]] || 1
Строка 105: Строка 105:
|}
|}


===Объект resultingList===
===Объект [[ModifyProducerStockListOperation#Объект modifyProducerStockListRequest|..Request]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation|modificationOperation]]/resultingList===


Объект содержит список единиц продукции, которую нужно добавить в справочник. На данный момент список может содержать только один элемент.
Объект содержит список единиц продукции, которую нужно добавить в справочник. На данный момент список может содержать только один элемент.
Строка 113: Строка 113:
! Поле !! Описание !! Тип данных !! Обязательность
! Поле !! Описание !! Тип данных !! Обязательность
|-
|-
| [[ModifyProducerStockListOperation#Объект productItem|'''productItem'']]' || Объект, содержащий данные о продукции || [[ProductItem|prod:ProductItem]] || 1
| [[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList/productItem|'''productItem''']] || Объект, содержащий данные о продукции || [[ProductItem|prod:ProductItem]] || 1
|}
|}


===Объект productItem===
===Объект [[ModifyProducerStockListOperation#Объект modifyProducerStockListRequest|..Request]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList|resultingList]]/productItem===


===Объект product===
Объект содержит необходимую справочную информацию для номенклатуры производителя.
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''name''' || Название вносимой в справочник продукции. Присваивается самим производителем. || [[String255|bs:String255]] || 1
|-
| '''code''' || Артикул вносимой продукции. Присваивается производителем.  || [[String255|bs:String255]] || 1
|-
| '''productType''' || Тип вносимой продукции, один из восьми. || [[ProductType|prod:ProductType]] || 1
|-
| [[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList/productItem/product|'''product''']] || Вид вносимой продукции.  || [[Product|prod:Product]] || 1
|-
| [[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList/productItem/subproduct|'''subProduct''']] || Подвид продукции || [[subProduct|prod:subProduct]] || 1
|-
| '''correspondToGost''' || флаг, указывающий, что продукция производится согласно || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| '''gost''' || ГОСТ, согласно которому производится вносимая в справочник продукция || [[String255|bs:String255]] || 0..1
|}
 
===Объект [[ModifyProducerStockListOperation#Объект modifyProducerStockListRequest|..Request]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList/productItem|productItem]]/product===
 
Объект содержит информацию о виде продукции. Является вторым уровнем иерархии справочника продукции.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор версии записи о продукции в справочнике. || [[UUID|bs:UUID]] || 0..1
|-
| '''GUID''' || Глобальный уникальный идентификатор продукции || [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Название вида продукции || [[String255|bs:String255]] || 0
|-
| '''code''' || Код ТНВЭД вида продукции || [[String255|bs:String255]] || 0
|-
| '''englishName''' || Название вида продукции на английском || [[String255|bs:String255]] || 0
|-
| '''productType''' || Тип продукции, к которому относится данная продукция || [[ProductType|prod:ProductType]] || 0
|}
 
===Объект [[ModifyProducerStockListOperation#Объект modifyProducerStockListRequest|..Request]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation|modificationOperation]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList|resultingList]]/[[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/resultingList/productItem|productItem]]/subproduct===
 
Объект содержит информацию о подвиде продукции. Это третий уровень иерархии справочника продукции.


===Объект subproduct===
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор версии записи о подвиде продукции в справочнике. || [[UUID|bs:UUID]] || 0..1
|-
| '''GUID''' || Глобальный уникальный идентификатор продукции || [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Название подвида продукции || [[String255|bs:String255]] || 0
|-
| '''code''' || Код ТНВЭД подвида продукции || [[String255|bs:String255]] || 0
|-
| '''englishName''' || Название подвида продукции на английском || [[String255|bs:String255]] || 0
|-
| '''productGuid''' || Уникальный идентификатор вида продукции, к которому относится данный подвид || [[UUID|bs:UUID]] || 0
|}


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

Версия 10:23, 3 декабря 2015

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

Данная операция предназнчена для отправки заявки на изменение реестра наименований продукции предприятия производителя. Используется для добавления новой позиции в номенклатуру проиводителя. Также может использоваться для обновления данных и для удаления позиции из списка номенклатуры производителя. Номенклатура производителя является четвёртым уровнем в справочнике продукции.

Возможные сценарии

  1. Добавление новой позиции в списки производителя.
    1. Успешное добавление новой продукци в списки производителя
    2. При повторном добавлении той же продукции в список ошибки не происходит.
  1. Обновление позиции списка
  2. Удаление позиции из списка

Входящая информация:

  • идентификатор предприятия;
  • реквизиты продукции

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

Структура данных запроса в формате ХML.

<merc:modifyBusinessEntityRequest xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications" 
                                  xmlns:base="http://api.vetrf.ru/schema/cdm/base"				  
                                  xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common" 			          
                                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
                                  xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar"> 
    <merc:localTransactionId>{xs:NCName}</merc:localTransactionId>
    <merc:initiator>
        <base:uuid>{bs:UUID}</base:uuid>
        <com:login>{xs:NCName}</com:login>
    </merc:initiator>
    <merc:modifyProducerStockListRequest>
      <merc:modificationOperation>
           <prod:type>{bs:type}</prod:type>
              <prod:enterprise>
                 <base:guid>{bs:GUID}</base:guid>
              </prod:enterprise>
              <prod:resultingList>
                 <prod:productItem>
                       <prod:name>{bs:String255}</prod:name>
                           <prod:code>{bs:String255}</prod:code>
                           <prod:productType>{prod:productType}</prod:productType>
                           <prod:product>
                              <base:guid>{bs:GUID}</base:guid>
                           </prod:product>
                           <prod:subProduct>
                              <base:guid>{bs:GUID}</base:guid>
                           </prod:subProduct>
                           <prod:correspondToGost>{xs:boolean}</prod:correspondToGost>
                           <prod:gost>{bs:String255}</prod:gost>
                        </prod:productItem>
                     </prod:resultingList>
                  </merc:modificationOperation>
               </merc:modifyProducerStockListRequest>

Объект modifyProducerStockListRequest

Корневой элемент содержимого заявки. Содержит сведения для добавления, изменения списка производимой продукции.

Поле Описание Тип данных Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. argc:User 1
modificationOperation Описание операции добавления/изменения информации о продукции. prod:PSLModificationOperation 1

Объект ..Request/modificationOperation

Объект содержит общую информацию о выполняемой операции: тип операции, причину внесения записи в реестр и информацию о продукции.

Поле Описание Тип данных Обязательность
type Тип операции:
  • CREATE - создание новой записи в списке продукции;
  • UPDATE - обновление записи о продукции в реестре;
  • DELETE - удаление записи о продукции
bs:RegisterModificationType 1
enterprise Информация о предприятии, на котором вырабатывается продукция ent:Enterprise 1
resultingList Список продукции, добавляемой в справочник. На данный момент разрешается добавлять только по одной позиции. prod:ProductItemList 1

Объект ..Request/modificationOperation/enterprise

Объект содержит информацию об идентификаторе предприятия-площадки, на котором производится продукция.

Поле Описание Тип данных Обязательность
GUID Уникальный идентификатор предприятия-площадки в реестре РСХН bs:UUID 0..1
UUID Уникальный идентификатор записи предприятия-площадки bs:UUID 0..1

Объект ..Request/modificationOperation/resultingList

Объект содержит список единиц продукции, которую нужно добавить в справочник. На данный момент список может содержать только один элемент.

Поле Описание Тип данных Обязательность
productItem Объект, содержащий данные о продукции prod:ProductItem 1

Объект ..Request/modificationOperation/resultingList/productItem

Объект содержит необходимую справочную информацию для номенклатуры производителя.

Поле Описание Тип данных Обязательность
name Название вносимой в справочник продукции. Присваивается самим производителем. bs:String255 1
code Артикул вносимой продукции. Присваивается производителем. bs:String255 1
productType Тип вносимой продукции, один из восьми. prod:ProductType 1
product Вид вносимой продукции. prod:Product 1
subProduct Подвид продукции prod:subProduct 1
correspondToGost флаг, указывающий, что продукция производится согласно xs:boolean 1
gost ГОСТ, согласно которому производится вносимая в справочник продукция bs:String255 0..1

Объект ..Request/modificationOperation/resultingList/productItem/product

Объект содержит информацию о виде продукции. Является вторым уровнем иерархии справочника продукции.

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор версии записи о продукции в справочнике. bs:UUID 0..1
GUID Глобальный уникальный идентификатор продукции bs:UUID 0..1
name Название вида продукции bs:String255 0
code Код ТНВЭД вида продукции bs:String255 0
englishName Название вида продукции на английском bs:String255 0
productType Тип продукции, к которому относится данная продукция prod:ProductType 0

Объект ..Request/modificationOperation/resultingList/productItem/subproduct

Объект содержит информацию о подвиде продукции. Это третий уровень иерархии справочника продукции.

Поле Описание Тип данных Обязательность
UUID Уникальный идентификатор версии записи о подвиде продукции в справочнике. bs:UUID 0..1
GUID Глобальный уникальный идентификатор продукции bs:UUID 0..1
name Название подвида продукции bs:String255 0
code Код ТНВЭД подвида продукции bs:String255 0
englishName Название подвида продукции на английском bs:String255 0
productGuid Уникальный идентификатор вида продукции, к которому относится данный подвид bs:UUID 0

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

Коды ошибок

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