ModifyProducerStockListOperation v2

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

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

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

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

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

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

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

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

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

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

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

1.1. Запрос успешно обработан. Наименование производимой продукции добавлено в реестр.
1.2. Произошла ошибка при обработке запроса.
• Некорректный запрос.
• Внутренняя ошибка системы.
2.1. Запрос успешно обработан. Наименование производимой продукции обновлено.
2.2. Произошла ошибка при обработке запроса.
• Некорректный запрос.
• Внутренняя ошибка системы.
3.1. Запрос успешно обработан. Наименование производимой продукции удалено из реестра.
3.2. Произошла ошибка при обработке запроса.
• Некорректный запрос.
• Внутренняя ошибка системы.

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


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

# Название XML-элемента Тип Кардинальность Описание Пример
001 <merc:modifyProducerStockListRequest>
002 ···<merc:localTransactionId> xs:NCName [1..1] Идентификатор заявки в клиентской системе. <bs:guid>A00001</bs:guid>
003 ···<merc:initiator> dt:User [1..1] Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.
004 ······<dt:login> xs:NCName [1..1] Логин пользователя, зарегистрированного в системе Меркурий. <dt:login>user_ab_150101</dt:login>
005 ···</merc:initiator>
006 ···<dt:enterprise> dt:Enterprise [1..1] Информация о предприятии, на котором вырабатывается продукция
007 ······<bs:uuid> bs:UUID [0..1] Идентификатор версии предприятия. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
008 ······<bs:guid> bs:UUID [0..1] Глобальный идентификатор предприятия. <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
009 ···</dt:enterprise>
010 ···<vd:type> bs:RegisterModificationType [1..1] Тип операции.
  • CREATE - создание новой записи в списке продукции;
  • UPDATE - обновление записи о продукции в реестре;
  • DELETE - удаление записи о продукции
 <vd:type>CREATE</vd:type>
011 ···<vd:resultingList count="1" total="1" offset="0"> dt:ProductItemList [0..1] Список продукции, который должен быть получен в результате выполнения операции.
  • На данный момент разрешается добавлять только по одной позиции.
  • Используется при добавлении и редактировании записи.
012 ······<vd:productItem> dt:ProductItem [1..1] cведения о наименовании продукции в соответствии с номенклатурой производителя.
013 ·········<bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
014 ·········<bs:guid> bs:UUID [0..1] Глобальный идентификатор номенклатуры. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
015 ·········<dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя. В отличие от поля code GTIN уникален для продукции всех производителей. Уникальность обеспечивается использованием префикса компании-производителя в составе GTIN. <dt:globalID>85672854</dt:globalID>
016 ·········<dt:name> bs:String255 [0..1] Наименование продукции. <dt:name>Название</dt:name>
017 ·········<dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя. <dt:code>12</dt:code>
018 ·········<vd:productType> dt:ProductType [1..1] Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. <vd:productType>1</vd:productType>
019 ·········<vd:product> dt:Product [1..1] Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
020 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии продукции. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
021 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор продукции. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
022 ············<dt:name> bs:String255 [0..1] Наименование продукции. <dt:name>говядина</dt:name>
023 ·········</vd:product>
024 ·········<vd:subProduct> dt:SubProduct [1..1] Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
025 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии вида продукции. <bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
026 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор вида продукции. <bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
027 ············<dt:name> bs:String255 [0..1] Наименование вида продукции. <dt:name>говядина на кости охлажденная</dt:name>
028 ·········</vd:subProduct>
029 ·········<vd:correspondToGost> xs:boolean [1..1] Соответствует ли ГОСТу. <vd:correspondToGost>true</vd:correspondToGost>
030 ·········<vd:gost> bs:String255 [0..1] ГОСТ. <vd:gost>ГОСТ-621187/53</vd:gost>
031 ·········<vd:producer> dt:BusinessEntity [0..1] ХС-производитель продукции.
032 ············<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
033 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
034 ············<dt:fullName> bs:String255 [0..1] Полное наименование хозяйствующего субъекта. <dt:fullName>Общество с ограниченной ответственностью "Первая торговая компания"</dt:fullName>
035 ············<dt:fio> bs:String255 [0..1] ФИО хозяйствующего субъекта. <dt:fio>Иванов Сергей Петрович</dt:fio>
036 ············<dt:juridicalAddress> dt:Address [0..1] Адрес фирмы.
037 ···············<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
038 ············</dt:juridicalAddress>
039 ·········</vd:producer>
040 ·········<vd:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки.
041 ············<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
042 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
043 ············<dt:fullName> bs:String255 [0..1] Полное наименование хозяйствующего субъекта. <dt:fullName>Общество с ограниченной ответственностью "Первая торговая компания"</dt:fullName>
044 ············<dt:fio> bs:String255 [0..1] ФИО хозяйствующего субъекта. <dt:fio>Иванов Сергей Петрович</dt:fio>
045 ············<dt:juridicalAddress> dt:Address [0..1] Адрес фирмы.
046 ···············<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
047 ············</dt:juridicalAddress>
048 ·········</vd:tmOwner>
049 ·········<vd:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция.
050 ············<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции.
051 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии предприятия. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
052 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор предприятия. <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
053 ············</dt:location>
054 ·········</vd:producing>
055 ·········<dt:packaging> dt:Packaging [0..1] Фасовка.
056 ············<dt:packagingType> dt:PackingType [1..1] Тип упаковки. <dt:packagingType>1</dt:packagingType>
057 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии типа упаковки. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
058 ···············<dt:globalID> dt:PackingCodeType [0..1] Уникальный идентификатор упаковки. <dt:globalID>7B</dt:globalID>
059 ···············<dt:name> bs:String255 [0..1] Наименование упаковки. <dt:name>Название</dt:name>
060 ············</dt:packagingType>
061 ············<dt:quantity> xs:int [0..1] Количество единиц упаковки. <dt:quantity>10</dt:quantity>
062 ············<dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара. <dt:volume>50</dt:volume>
063 ············<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара.
064 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии еиницы измерения. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
065 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор еиницы измерения. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
066 ············</dt:unit>
067 ·········</dt:packaging>
068 ······</vd:productItem>
069 ···</vd:resultingList>
070 </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 ·········<vd:producer> dt:BusinessEntity [0..1] ХС-производитель продукции.
28 ············<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
29 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
30 ············<dt:fullName> bs:String255 [0..1] Полное наименование хозяйствующего субъекта. <dt:fullName>Общество с ограниченной ответственностью "Первая торговая компания"</dt:fullName>
31 ············<dt:fio> bs:String255 [0..1] ФИО хозяйствующего субъекта. <dt:fio>Иванов Сергей Петрович</dt:fio>
32 ············<dt:juridicalAddress> dt:Address [0..1] Адрес фирмы.
33 ···············<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
34 ············</dt:juridicalAddress>
35 ·········</vd:producer>
36 ·········<vd:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки.
37 ············<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
38 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
39 ············<dt:fullName> bs:String255 [0..1] Полное наименование хозяйствующего субъекта. <dt:fullName>Общество с ограниченной ответственностью "Первая торговая компания"</dt:fullName>
40 ············<dt:fio> bs:String255 [0..1] ФИО хозяйствующего субъекта. <dt:fio>Иванов Сергей Петрович</dt:fio>
41 ············<dt:juridicalAddress> dt:Address [0..1] Адрес фирмы.
42 ···············<dt:addressView> bs:String255 [0..1] Представление адреса. <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView>
43 ············</dt:juridicalAddress>
44 ·········</vd:tmOwner>
45 ·········<vd:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция.
46 ············<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции.
47 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии предприятия. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
48 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор предприятия. <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
49 ············</dt:location>
50 ·········</vd:producing>
51 ·········<dt:packaging> dt:Packaging [0..1] Фасовка.
52 ············<dt:packagingType> dt:PackingType [1..1] Тип упаковки. <dt:packagingType>1</dt:packagingType>
53 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии типа упаковки. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
54 ···············<dt:globalID> dt:PackingCodeType [0..1] Уникальный идентификатор упаковки. <dt:globalID>7B</dt:globalID>
55 ···············<dt:name> bs:String255 [0..1] Наименование упаковки. <dt:name>Название</dt:name>
56 ············</dt:packagingType>
57 ············<dt:quantity> xs:int [0..1] Количество единиц упаковки. <dt:quantity>10</dt:quantity>
58 ············<dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара. <dt:volume>50</dt:volume>
59 ············<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара.
60 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии еиницы измерения. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
61 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор еиницы измерения. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
62 ············</dt:unit>
63 ·········</dt:packaging>
64 ······</vd:productItem>
65 ···</vd:productItemList>
66 </merc:modifyProducerStockListResponse>


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

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