ModifyProducerStockListOperation v2: различия между версиями
Строка 604: | Строка 604: | ||
| [[GTINType_v2.0|dt:GTINType]] | | [[GTINType_v2.0|dt:GTINType]] | ||
| [0..1] | | [0..1] | ||
| Trade Identification Number (GTIN) - идентификационный номер продукции производителя | | Trade Identification Number (GTIN) - идентификационный номер продукции производителя. | ||
| <dt:globalID>85672854</dt:globalID> | | <dt:globalID>85672854</dt:globalID> | ||
|- | |- |
Версия 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] | Информация о предприятии, на котором вырабатывается продукция.
|
|
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] | Тип операции.
|
<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) - идентификационный номер продукции производителя.
|
<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] | Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.
|
|
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] | Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
|
|
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] | ХС-производитель продукции.
|
|
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] | ХС-собственник торговой марки.
|
|
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] | Площадка, осуществляющая выпуск продукции.
|
|
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] | Единица измерения объёма единицы упаковки товара.
|
|
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] | Является ли запись номенклатуры активной:
|
<bs:active>true</bs:active> |
7 | ·········<bs:last> | xs:boolean | [1..1] | Последняя версия номенклатуры:
|
<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> |