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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 618: Строка 618:
| [[String255|bs:String255]]
| [[String255|bs:String255]]
| [0..1]
| [0..1]
| Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя.
| Артикул (код) продукции в соответствии с внутренним кодификатором производителя.  
| &lt;dt:code>12</dt:code>
| &lt;dt:code>12</dt:code>
|-
|-

Версия 15:47, 14 сентября 2017

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

Операция 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) - идентификационный номер продукции производителя. <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=21488