ModifyProducerStockListOperation v2

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

Операция ModifyProducerStockListOperation предназначена для ведения реестра наименований продукции в соответствии с номенклатурой производителя. Вести реестр наименований производимой продукции может хозяйствующий субъект - производитель данных наименований продукции, либо хозяйствующий субъект - владелец торговой марки (ТМ).

Если одно наименование продукции (ТМ) производится одним ХС-производителем на нескольких площадках, в реестре должна быть зарегистрирована строго одна запись. Если одно наименование продукции (ТМ), принадлежащее одному ХС-собственнику ТМ, производится несколькими ХС-производителями, в реестре должно быть зарегистрировано несколько записей по одной на каждого ХС-производителя.

Сформированный производителем реестр наименований выпускаемой продукции можно получить с помощью методов сервиса ProductionService. В рамках операции доступны следующие действия:

• добавление новой позиции в реестр производимой продукции;
• изменение существующей позиции в реестре производимой продукции;
• удаление существующей позиции из реестра производимой продукции.

На вход системы при этом передаются следующие сведения:

• информация о пользователе - инициаторе запроса;
• тип операции (добавление, удаление, изменение);
• информация о предприятии, на котором вырабатывается продукция.
• информация о наименовании продукции, которую необходимо добавить в реестр.
• идентификатор изменяемого наименования продукции, а так же сведения о наименовании продукции на которые необходимо заменить существующую запись.
• идентификатор и информация о наименовании продукции, которую необходимо удалить из реестра.

Результатом выполнения данной операции является:

• добавленные и/или измененные записи в реестре наименований производимой продукции.

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

1. Добавление новой позиции в реестр наименований производимой продукции.

1.1. Запрос успешно обработан. Наименование производимой продукции добавлено в реестр.

1.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

2. Обновление позиции в реестре наименований производимой продукции.

2.1. Запрос успешно обработан. Наименование производимой продукции обновлено.

2.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

3. Удаление позиции из реестра наименований производимой продукции.

3.1. Запрос успешно обработан. Наименование производимой продукции удалено из реестра.

3.2. Произошла ошибка при обработке запроса.

• Некорректный запрос.

• Внутренняя ошибка системы.

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

bs (http://api.vetrf.ru/schema/cdm/base) bs:Decimal bs:RegisterModificationType bs:String255 bs:UUID bs:UUID bs:VersionStatus

dt (http://api.vetrf.ru/schema/cdm/dictionary) dt:Enterprise dt:GTINType dt:Packaging dt:PackingCodeType dt:PackingType dt:Product dt:ProductItem dt:ProductItemList dt:ProductType dt:SubProduct dt:Unit dt:User

xs (http://www.w3.org/2001/XMLSchema) xs:boolean xs:boolean xs:DateTime xs:int xs:NCName

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

#	Название XML-элемента	Тип	Кардинальность	Описание	Пример
1	<merc:modifyProducerStockListRequest>
2	···<merc:localTransactionId>	xs:NCName	[1..1]	Идентификатор заявки в клиентской системе.	<bs:guid>A00001</bs:guid>
3	···<merc:initiator>	dt:User	[1..1]	Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
4	······<dt:login>	xs:NCName	[1..1]	Логин пользователя, зарегистрированного в системе Меркурий.	<dt:login>user_ab_150101</dt:login>
5	···</merc:initiator>
6	···<dt:enterprise>	dt:Enterprise	[1..1]	Информация о предприятии, на котором вырабатывается продукция
7	······<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии предприятия.	<bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
8	······<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор предприятия.	<bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
9	···</dt:enterprise>
10	···<vd:type>	bs:RegisterModificationType	[1..1]	Тип операции. CREATE - создание новой записи в списке продукции; UPDATE - обновление записи о продукции в реестре; DELETE - удаление записи о продукции	<vd:type>CREATE</vd:type>
11	···<vd:affectedList>	dt:ProductItemList	[0..1]	Входящие записи для операции. На данный момент разрешается добавлять только по одной позиции. Используется только при удалении позиции
12	······<vd:productItem>	dt:ProductItem	[1..1]	cведения о наименовании продукции в соответствии с номенклатурой производителя.
13	·········<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии номенклатуры.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
14	·········<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор номенклатуры.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
15	·········<dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя. В отличие от поля code GTIN уникален для продукции всех производителей. Уникальность обеспечивается использованием префикса компании-производителя в составе GTIN.	<dt:globalID>85672854</dt:globalID>
16	·········<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>Название</dt:name>
17	·········<dt:code>	bs:String255	[0..1]	Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя.	<dt:code>12</dt:code>
18	·········<vd:productType>	dt:ProductType	[1..1]	Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.	<vd:productType>1</vd:productType>
19	·········<vd:product>	dt:Product	[1..1]	Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
20	············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии продукции.	<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
21	············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
22	············<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>говядина</dt:name>
23	·········</vd:product>
24	·········<vd:subProduct>	dt:SubProduct	[1..1]	Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
25	············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции.	<bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
26	············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.	<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
27	············<dt:name>	bs:String255	[0..1]	Наименование вида продукции.	<dt:name>говядина на кости охлажденная</dt:name>
28	·········</vd:subProduct>
29	·········<vd:correspondToGost>	xs:boolean	[1..1]	Соответствует ли ГОСТу.	<vd:correspondToGost>true</vd:correspondToGost>
30	·········<vd:gost>	bs:String255	[0..1]	ГОСТ.	<vd:gost>ГОСТ-621187/53</vd:gost>
31	·········<dt:packaging>	dt:Packaging	[0..1]	Фасовка.
32	············<dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки.	<dt:packagingType>1</dt:packagingType>
33	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии типа упаковки.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
34	···············<dt:globalID>	dt:PackingCodeType	[0..1]	Уникальный идентификатор упаковки.	<dt:globalID>7B</dt:globalID>
35	···············<dt:name>	bs:String255	[0..1]	Наименование упаковки.	<dt:name>Название</dt:name>
36	············</dt:packagingType>
37	············<dt:quantity>	xs:int	[0..1]	Количество единиц упаковки.	<dt:quantity>10</dt:quantity>
38	············<dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара.	<dt:volume>50</dt:volume>
39	············<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара.
40	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии единицы измерения.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
41	···············<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор единицы измерения.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
42	············</dt:unit>
43	·········</dt:packaging>
44	······</vd:productItem>
45	···</vd:affectedList>
46	···<vd:resultingList count="1" total="1" offset="0">	dt:ProductItemList	[0..1]	Список продукции, который должен быть получен в результате выполнения операции. На данный момент разрешается добавлять только по одной позиции. Используется при добавлении и редактировании записи.
47	······<vd:productItem>	dt:ProductItem	[1..1]	cведения о наименовании продукции в соответствии с номенклатурой производителя.
48	·········<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии номенклатуры.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
49	·········<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор номенклатуры.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
50	·········<dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя. В отличие от поля code GTIN уникален для продукции всех производителей. Уникальность обеспечивается использованием префикса компании-производителя в составе GTIN.	<dt:globalID>85672854</dt:globalID>
51	·········<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>Название</dt:name>
52	·········<dt:code>	bs:String255	[0..1]	Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя.	<dt:code>12</dt:code>
53	·········<vd:productType>	dt:ProductType	[1..1]	Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.	<vd:productType>1</vd:productType>
54	·········<vd:product>	dt:Product	[1..1]	Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
55	············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии продукции.	<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
56	············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
57	············<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>говядина</dt:name>
58	·········</vd:product>
59	·········<vd:subProduct>	dt:SubProduct	[1..1]	Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
60	············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции.	<bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
61	············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.	<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
62	············<dt:name>	bs:String255	[0..1]	Наименование вида продукции.	<dt:name>говядина на кости охлажденная</dt:name>
63	·········</vd:subProduct>
64	·········<vd:correspondToGost>	xs:boolean	[1..1]	Соответствует ли ГОСТу.	<vd:correspondToGost>true</vd:correspondToGost>
65	·········<vd:gost>	bs:String255	[0..1]	ГОСТ.	<vd:gost>ГОСТ-621187/53</vd:gost>
66	·········<dt:packaging>	dt:Packaging	[0..1]	Фасовка.
67	············<dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки.	<dt:packagingType>1</dt:packagingType>
68	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии типа упаковки.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
69	···············<dt:globalID>	dt:PackingCodeType	[0..1]	Уникальный идентификатор упаковки.	<dt:globalID>7B</dt:globalID>
70	···············<dt:name>	bs:String255	[0..1]	Наименование упаковки.	<dt:name>Название</dt:name>
71	············</dt:packagingType>
72	············<dt:quantity>	xs:int	[0..1]	Количество единиц упаковки.	<dt:quantity>10</dt:quantity>
73	············<dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара.	<dt:volume>50</dt:volume>
74	············<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара.
75	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии единицы измерения.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
76	···············<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор единицы измерения.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
77	············</dt:unit>
78	·········</dt:packaging>
79	······</vd:productItem>
80	···</vd:resultingList>
81	</merc:modifyProducerStockListRequest>

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

#	Название XML-элемента	Тип	Кардинальность	Описание	Пример
1	<merc:modifyProducerStockListResponse>
2	···<vd:productItemList>	dt:ProductItemList	[1..1]	Список продукции, в которую внесены изменения. На данный момент список может состоять только из одного элемента.
3	······<vd:productItem>	dt:ProductItem	[1..1]	Данные о номенклатуре производителя
4	·········<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии номенклатуры.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
5	·········<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор номенклатуры.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
6	·········<bs:active>	xs:boolean	[1..1]	Является ли запись номенклатуры активной: true - запись активна; false - запись не активна.	<bs:active>true</bs:active>
7	·········<bs:last>	xs:boolean	[1..1]	Последняя версия номенклатуры: true - да; false - нет.	<bs:last>true</bs:last>
8	·········<bs:status>	bs:VersionStatus	[1..1]	Статус версии номенклатуры.	<bs:status></bs:status>
9	·········<bs:createDate>	xs:DateTime	[1..1]	Дата создания номенклатуры.	<bs:createDate>2017-07-07T12:00:00</bs:createDate>
10	·········<bs:updateDate>	xs:DateTime	[1..1]	Дата изменения номенклатуры.	<bs:updateDate>2017-07-07T12:00:00</bs:updateDate>
11	·········<dt:globalID>	dt:GTINType	[0..1]	Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя. В отличие от поля code GTIN уникален для продукции всех производителей. Уникальность обеспечивается использованием префикса компании-производителя в составе GTIN.	<dt:globalID>85672854</dt:globalID>
12	·········<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>Название</dt:name>
13	·········<dt:code>	bs:String255	[0..1]	Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя.	<dt:code>12</dt:code>
14	·········<vd:productType>	dt:ProductType	[1..1]	Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.	<vd:productType>1</vd:productType>
15	·········<vd:product>	dt:Product	[1..1]	Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
16	············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии продукции.	<bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
17	············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор продукции.	<bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
18	············<dt:name>	bs:String255	[0..1]	Наименование продукции.	<dt:name>говядина</dt:name>
19	·········</vd:product>
20	·········<vd:subProduct>	dt:SubProduct	[1..1]	Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
21	············<bs:uuid>	bs:UUID	[1..1]	Идентификатор версии вида продукции.	<bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
22	············<bs:guid>	bs:UUID	[1..1]	Глобальный идентификатор вида продукции.	<bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
23	············<dt:name>	bs:String255	[0..1]	Наименование вида продукции.	<dt:name>говядина на кости охлажденная</dt:name>
24	·········</vd:subProduct>
25	·········<vd:correspondToGost>	xs:boolean	[1..1]	Соответствует ли ГОСТу.	<vd:correspondToGost>true</vd:correspondToGost>
26	·········<vd:gost>	bs:String255	[0..1]	ГОСТ.	<vd:gost>ГОСТ-621187/53</vd:gost>
27	·········<dt:packaging>	dt:Packaging	[0..1]	Фасовка.
28	············<dt:packagingType>	dt:PackingType	[1..1]	Тип упаковки.	<dt:packagingType>1</dt:packagingType>
29	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии типа упаковки.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
30	···············<dt:globalID>	dt:PackingCodeType	[0..1]	Уникальный идентификатор упаковки.	<dt:globalID>7B</dt:globalID>
31	···············<dt:name>	bs:String255	[0..1]	Наименование упаковки.	<dt:name>Название</dt:name>
32	············</dt:packagingType>
33	············<dt:quantity>	xs:int	[0..1]	Количество единиц упаковки.	<dt:quantity>10</dt:quantity>
34	············<dt:volume>	bs:Decimal	[0..1]	Объём единицы упаковки товара.	<dt:volume>50</dt:volume>
35	············<dt:unit>	dt:Unit	[0..1]	Единица измерения объёма единицы упаковки товара.
36	···············<bs:uuid>	bs:UUID	[0..1]	Идентификатор версии единицы измерения.	<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
37	···············<bs:guid>	bs:UUID	[0..1]	Глобальный идентификатор единицы измерения.	<bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
38	············</dt:unit>
39	·········</dt:packaging>
40	······</vd:productItem>
41	···</vd:productItemList>
42	</merc:modifyProducerStockListResponse>

Коды ошибок

Вернуться к началу ↑