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 ······<vd:login> xs:NCName [1..1] Логин пользователя, зарегистрированного в системе Меркурий. <vd:login>user_ab_150101</vd:login>
005 ···</merc:initiator>
006 ···<dt:enterprise> dt:Enterprise [1..1] Информация о предприятии, на котором вырабатывается продукция.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
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> dt:ProductItemList [0..1] Список продукции, который должен быть получен в результате выполнения операции.
  • На данный момент разрешается добавлять только по одной позиции.
  • Используется при добавлении и редактировании записи.
012 ······<vd:productItem> dt:ProductItem [1..1] Сведения о наименовании продукции в соответствии с номенклатурой производителя.
013 ·········<bs:uuid> bs:UUID [0..1] Идентификатор версии номенклатуры. Указывается при изменении или удалении. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
014 ·········<dt:globalID> dt:GTINType [0..1] Trade Identification Number (GTIN) - идентификационный номер продукции производителя.
  • По задумке создателей GTIN должен быть уникален для продукции всех производителей, но на практике встречаются случаи недокументированного использования GTIN внутри компаний, что не обеспечивает уникальность GTIN, поэтому уникальность поля не проверяется.
 <dt:globalID>85672854</dt:globalID>
015 ·········<dt:name> bs:String255 [0..1] Наименование продукции. <dt:name>Название</dt:name>
016 ·········<dt:code> bs:String255 [0..1] Артикул (код) продукции в соответствии с внутренним кодификатором производителя.
  • Артикул продукции должен быть уникальным в пределах одного производителя.
 <dt:code>12</dt:code>
017 ·········<vd:productType> dt:ProductType [1..1] Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. <vd:productType>1</vd:productType>
018 ·········<vd:product> dt:Product [1..1] Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
019 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии продукции. <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid>
020 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор продукции. <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid>
021 ············<dt:name> bs:String255 [0..1] Наименование продукции. <dt:name>говядина</dt:name>
022 ·········</vd:product>
023 ·········<vd:subProduct> dt:SubProduct [1..1] Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
024 ············<bs:uuid> bs:UUID [1..1] Идентификатор версии вида продукции. <bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid>
025 ············<bs:guid> bs:UUID [1..1] Глобальный идентификатор вида продукции. <bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid>
026 ············<dt:name> bs:String255 [0..1] Наименование вида продукции. <dt:name>говядина на кости охлажденная</dt:name>
027 ·········</vd:subProduct>
028 ·········<vd:correspondsToGost> xs:boolean [1..1] Соответствует ли ГОСТу. <vd:correspondsToGost>true</vd:correspondsToGost>
029 ·········<vd:gost> bs:String255 [0..1] ГОСТ. <vd:gost>ГОСТ-621187/53</vd:gost>
030 ·········<vd:producer> dt:BusinessEntity [0..1] ХС-производитель продукции.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
031 ············<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
032 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
033 ·········</vd:producer>
034 ·········<vd:tmOwner> dt:BusinessEntity [0..1] ХС-собственник торговой марки.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
035 ············<bs:uuid> bs:UUID [0..1] Идентификатор версии хозяйствующего субъекта-владельца. <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid>
036 ············<bs:guid> bs:UUID [0..1] Глобальный идентификатор хозяйствующего субъекта-владельца. <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid>
037 ·········</vd:tmOwner>
038 ·········<vd:producing> dt:ProductItemProducing [0..*] Список площадок, на которых выпускается данная продукция.
039 ············<dt:location> dt:Enterprise [1..1] Площадка, осуществляющая выпуск продукции.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
040 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии предприятия. <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid>
041 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор предприятия. <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid>
042 ············</dt:location>
043 ·········</vd:producing>
044 ·········<dt:packaging> dt:Packaging [0..1] Фасовка.
045 ············<dt:packagingType> dt:PackingType [1..1] Тип упаковки. <dt:packagingType>1</dt:packagingType>
046 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии типа упаковки. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
046 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор типа упаковки. <bs:guid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:guid>
047 ···············<dt:globalID> dt:PackingCodeType [0..1] Уникальный идентификатор упаковки. <dt:globalID>7B</dt:globalID>
048 ···············<dt:name> bs:String255 [0..1] Наименование упаковки. <dt:name>Название</dt:name>
049 ············</dt:packagingType>
050 ············<dt:quantity> xs:int [0..1] Количество единиц упаковки. <dt:quantity>10</dt:quantity>
051 ············<dt:volume> bs:Decimal [0..1] Объём единицы упаковки товара. <dt:volume>50</dt:volume>
052 ············<dt:unit> dt:Unit [0..1] Единица измерения объёма единицы упаковки товара.
  • Обязательно должен быть указан один из идентификаторов: uuid или guid; при указании обоих приоритет у uuid.
053 ···············<bs:uuid> bs:UUID [0..1] Идентификатор версии единицы измерения. <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid>
054 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор единицы измерения. <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid>
055 ············</dt:unit>
056 ·········</dt:packaging>
057 ······</vd:productItem>
058 ···</vd:resultingList>
059 </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) - идентификационный номер продукции производителя. По задумке создателей GTIN должен быть уникален для продукции всех производителей, но на практике встречаются случаи недокументированного использования 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>
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>
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>
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>
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>
046 ···············<bs:guid> bs:UUID [0..1] Глобальный идентификатор типа упаковки. <bs:guid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:guid>
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=21486