ModifyProducerStockListOperation: различия между версиями
Строка 87: | Строка 87: | ||
|| [[RegisterModificationType|bs:RegisterModificationType]] || 1 | || [[RegisterModificationType|bs:RegisterModificationType]] || 1 | ||
|- | |- | ||
| [[ModifyProducerStockListOperation#Объект ..Request/ | | [[ModifyProducerStockListOperation#Объект ..Request/modificationOperation/enterprise|'''enterprise''']] || Информация о предприятии, на котором вырабатывается продукция || [[Enterprise|ent:Enterprise]] || 1 | ||
|- | |- | ||
| [[ModifyProducerStockListOperation#Объект resultingList|'''resultingList''']] || Список продукции, добавляемой в справочник. На данный момент разрешается добавлять только по одной позиции. || [[ProductItemList|prod:ProductItemList]] || 1 | | [[ModifyProducerStockListOperation#Объект resultingList|'''resultingList''']] || Список продукции, добавляемой в справочник. На данный момент разрешается добавлять только по одной позиции. || [[ProductItemList|prod:ProductItemList]] || 1 |
Версия 10:30, 3 декабря 2015
Общие сведения
Данная операция предназнчена для отправки заявки на изменение реестра наименований продукции предприятия производителя. Используется для добавления новой позиции в номенклатуру проиводителя. Также может использоваться для обновления данных и для удаления позиции из списка номенклатуры производителя. Номенклатура производителя является четвёртым уровнем в справочнике продукции.
Возможные сценарии
- Добавление новой позиции в списки производителя.
- Успешное добавление новой продукци в списки производителя
- При повторном добавлении той же продукции в список ошибки не происходит.
- Обновление позиции списка
- Удаление позиции из списка
Входящая информация:
- идентификатор предприятия;
- реквизиты продукции
Данные запроса
Структура данных запроса в формате Х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 | Тип операции:
|
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 |