ResolveDiscrepancyOperation v2
Общие сведения
Операция ResolveDiscrepancyOperation предназначена для устранения возможных несоответствий в сведениях о партии продукции в складском журнале системы Меркурий и фактических сведениях о продукции, выявленных по результатам проведенной инвентаризации. В ходе проведения инвентаризации доступны следующие действия:
- добавление одной, либо нескольких записей в складской журнал продукции (пересортица при инвентаризации);
- изменение существующей записи журнала;
- списание всех остатков по записи журнала (удаление).
При выполнении операции ResolveDiscrepancyOperation на вход системы в зависимости от типа операции передаются следующие сведения:
- информация о пользователе - инициаторе запроса;
- данные хозяйствующего субъекта и предприятия, где проводится инвентаризация;
- для объёмов продукции, которые не были ранее отражены в журнале, передаются полные сведения о записи складского журнала;
- для каждой изменяемой записи журнала должен быть указан её идентификатор в журнале продукции ФГИС «Меркурий», а также фактические сведения для этой записи;
- при списании всех остатков с записи журнала передается идентификатор записи журнала продукции ФГИС «Меркурий»;
- при наличии «Акта о пересортице», оформляемого в ИС предприятия, должны быть переданы реквизиты данного документа, в случае отсутствия документа, он будет создан ФГИС «Меркурий», а реквизиты будут назначены автоматически.
Результатом выполнения данной операции является:
- добавленные или измененные записи складского журнала продукции;
- акт о пересортице.
Возможные сценарии
При обработке запроса возможны следующие сценарии:
- 1.1. Запрос успешно обработан. Пользователю вернулась сформированная запись журнала продукции и акт несоответствия.
- 1.2. Произошла ошибка при обработке запроса.
- • Некорректный запрос.
- • Внутренняя ошибка системы.
- 2.1. Запрос успешно обработан. Пользователю вернулась измененная запись журнала продукции и акт несоответствия.
- 2.2. Произошла ошибка при обработке запроса.
- • Некорректный запрос.
- • Внутренняя ошибка системы.
- 2.1. Запрос успешно обработан. Пользователю вернулась измененная запись журнала продукции и акт несоответствия.
- 2.2. Произошла ошибка при обработке запроса.
- • Некорректный запрос.
- • Внутренняя ошибка системы.
При формировании запроса возможны следующие сценарии.
Данные запроса
# | Название XML-элемента | Тип | Кардинальность | Описание | Пример |
---|---|---|---|---|---|
1 | <merc:resolveDiscrepancyRequest> | ||||
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:inventoryDate> | xs:DateTime | [1..1] | Дата проведения инвентаризации. | <vd:inventoryDate>2017-07-07T12:00:00<vd:inventoryDate> |
11 | ···<vd:responsible> | dt:User | [1..1] | Ответственный за инвентаризацию. Указывается пользователь из списка пользователей для хозяйствующего субъекта - заявителя. | |
12 | ······<dt:login> | xs:NCName | [0..1] | Логин пользователя, зарегистрированного в системе Меркурий. | <dt:login>user_ab_150101</dt:login> |
13 | ···</vd:responsible> | ||||
14 | ···<vd:stockDiscrepancy> | vetd:StockDiscrepancy | [1..*] | Сведения о результате инвентаризации (по одному факту расхождения). | |
15 | ······<vd:resultingList count="1" total="1" offset="0" | vd:StockEntryList | [0..1] | Одна или несколько записей складского журнала продукции, полученная, либо измененная в результате инвентаризации. | |
16 | ·········<merc:stockEntry> | vd:StockEntry | [1..1] | Сведения о записи журнала. | |
17 | ············<bs:uuid> | bs:UUID | [0..1] | Идентификатор версии записи складского журнала продукции.
|
<bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid> |
18 | ············<vd:batch> | vd:Batch | [1..1] | Сведения о партии продукции. | |
19 | ···············<vd:productType> | dt:ProductType | [1..1] | Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий. | <vd:productType>1</vd:productType> |
20 | ···············<vd:product> | dt:Product | [1..1] | Продукция. Второй уровень иерархического справочника продукции ИС Меркурий. | |
21 | ··················<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии продукции. | <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid> |
22 | ··················<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор продукции. | <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid> |
23 | ··················<dt:name> | bs:String255 | [0..1] | Наименование продукции. | <dt:name>говядина</dt:name> |
24 | ···············</vd:product> | ||||
25 | ···············<vd:subProduct> | dt:SubProduct | [1..1] | Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий. | |
26 | ··················<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии вида продукции. | <bs:uuid>d9d008eb-057a-4cd4-8cb2-d69364318bbe</bs:uuid> |
27 | ··················<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор вида продукции. | <bs:guid>6f5feda1-a3d4-4dfd-8625-de62777a205e</bs:guid> |
28 | ··················<dt:name> | bs:String255 | [0..1] | Наименование вида продукции. | <dt:name>говядина на кости охлажденная</dt:name> |
29 | ···············</vd:subProduct> | ||||
30 | ···············<vd:volume> | bs:Decimal | [1..1] | Объем продукции. | <dt:volume>50</dt:volume> |
31 | ···············<vd:unit> | dt:Unit | [1..1] | Единица измерения объема партии продукции. | |
32 | ··················<bs:uuid> | bs:UUID | [0..1] | Идентификатор версии еиницы измерения. | <bs:uuid>c9781d68-8f7d-4fb6-a007-d7a14f0815f6</bs:uuid> |
33 | ··················<bs:guid> | bs:UUID | [0..1] | Глобальный идентификатор еиницы измерения. | <bs:guid>8aaaac24-8e10-499e-b1a2-cda0bf3f5855</bs:guid> |
34 | ··················<dt:name> | bs:String255 | [0..1] | Наименование единицы измерения. | <dt:name>кг.</dt:name> |
35 | ···············</vd:unit> | ||||
36 | ···············<vd:dateOfProduction> | vd:GoodsDate | [1..1] | Дата выработки продукции. Может быть указана датой или диапазоном дат. В случае точной даты выработки указывается только первая компонента - firstDate. | |
37 | ··················<vd:firstDate> | dt:ComplexDate | [1..1] | Начальная дата в интервале, либо единичная дата. | |
38 | ·····················<dt:year> | dt:Year | [0..1] | Год. | <dt:year>2017</dt:year> |
39 | ·····················<dt:month> | dt:Month | [0..1] | Месяц. | <dt:month>07</dt:month> |
40 | ·····················<dt:day> | dt:Day | [0..1] | День. | <dt:day>07</dt:day> |
41 | ·····················<dt:hour> | dt:Hour | [0..1] | Час. | <dt:hour>12</dt:hour> |
42 | ·····················<dt:minute> | dt:Minute | [0..1] | Минута. | <dt:minute>41</dt:minute> |
43 | ··················</vd:firstDate> | ||||
44 | ··················<vd:secondDate> | dt:ComplexDate | [1..1] | Конечная дата в интервале. | |
45 | ·····················<dt:year> | dt:Year | [0..1] | Год. | <dt:year>2017</dt:year> |
46 | ·····················<dt:month> | dt:Month | [0..1] | Месяц. | <dt:month>07</dt:month> |
47 | ·····················<dt:day> | dt:Day | [0..1] | День. | <dt:day>08</dt:day> |
48 | ·····················<dt:hour> | dt:Hour | [0..1] | Час. | <dt:hour>12</dt:hour> |
49 | ·····················<dt:minute> | dt:Minute | [0..1] | Минута. | <dt:minute>41</dt:minute> |
50 | ··················</vd:secondDate> | ||||
51 | ···············</vd:dateOfProduction> | ||||
52 | ···············<vd:expiryDate> | vd:GoodsDate | [1..1] | Дата окончания срока годности продукции. Может быть указана датой или диапазоном дат. В случае точной даты выработки указывается только первая компонента - firstDate. | |
53 | ··················<vd:firstDate> | dt:ComplexDate | [1..1] | Начальная дата в интервале, либо единичная дата. | |
54 | ·····················<dt:year> | dt:Year | [0..1] | Год. | <dt:year>2018</dt:year> |
55 | ·····················<dt:month> | dt:Month | [0..1] | Месяц. | <dt:month>07</dt:month> |
56 | ·····················<dt:day> | dt:Day | [0..1] | День. | <dt:day>08</dt:day> |
57 | ·····················<dt:hour> | dt:Hour | [0..1] | Час. | <dt:hour>12</dt:hour> |
58 | ·····················<dt:minute> | dt:Minute | [0..1] | Минута. | <dt:minute>41</dt:minute> |
59 | ··················</vd:firstDate> | ||||
60 | ··················<vd:secondDate> | dt:ComplexDate | [1..1] | Конечная дата в интервале. | |
61 | ·····················<dt:year> | dt:Year | [0..1] | Год. | <dt:year>2018</dt:year> |
62 | ·····················<dt:month> | dt:Month | [0..1] | Месяц. | <dt:month>09</dt:month> |
63 | ·····················<dt:day> | dt:Day | [0..1] | День. | <dt:day>08</dt:day> |
64 | ·····················<dt:hour> | dt:Hour | [0..1] | Час. | <dt:hour>12</dt:hour> |
65 | ·····················<dt:minute> | dt:Minute | [0..1] | Минута. | <dt:minute>41</dt:minute> |
66 | ··················</vd:secondDate> | ||||
67 | ···············</vd:expiryDate> | ||||
68 | ···············<vd:productionBatchID> | bs:String255 | [0..*] | Уникальный идентификатор производственной партии продукции. | <vd:productionBatchID>ПП64219</vd:productionBatchID> |
69 | ···············<vd:perishable> | xs:boolean | [1..1] | Описывает, является ли продукция скоропортящейся:
|
<vd:perishable>false</vd:perishable> |
70 | ···············<vd:origin> | vd:BatchOrigin | [0..1] | Сведения о происхождении продукции. | |
71 | ··················<vd:productItem> | dt:ProductItem | [0..1] | Наименование продукции в номенклатуре производителя. | |
72 | ·····················<bs:uuid> | bs:UUID | [1..1] | Идентификатор версии номенклатуры продукции. | <bs:uuid>53557240-35e7-48c8-81ce-8b9948cfef90</bs:uuid> |
73 | ·····················<bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор номенклатуры продукции. | <bs:guid>2c779c29-1fc2-44a6-8add-92752657f089</bs:guid> |
74 | ·····················<dt:globalID> | dt:GTINType | [0..1] | Trade Identification Number (GTIN) - уникальный идентификационный номер продукции производителя. В отличие от поля code GTIN уникален для продукции всех производителей. Уникальность обеспечивается использованием префикса компании-производителя в составе GTIN. | <dt:globalID>85672854</dt:globalID> |
75 | ·····················<dt:name> | bs:String255 | [0..1] | Наименование продукции. | <dt:name>Наименование</dt:name> |
76 | ·····················<dt:code> | bs:String255 | [0..1] | Артикул (код) продукции в соответствии с внутренним кодификатором производителя. Артикул продукции должен быть уникальным в пределах одного производителя. | <dt:code>12</dt:code> |
77 | ··················</vd:productItem> | ||||
78 | ··················<vd:country> | dt:Country | [0..1] | Страна происхождения партии продукции. | |
79 | ·····················<bs:uuid> | bs:UUID | [0..1] | Идентификатор версии страны. | <bs:uuid>cbd91ac0-bec2-4308-a395-33b68871d76b</bs:uuid> |
80 | ·····················<bs:guid> | bs:UUID | [0..1] | Глобальный идентификатор страны. | <bs:guid>3aa0c3ce-8d01-4779-bfb7-df7f234cf86f</bs:guid> |
81 | ·····················<dt:name> | bs:String255 | [0..1] | Наименование страны происхождения партии продукции. | <dt:name>Российская федерация</dt:name> |
82 | ··················</vd:country> | ||||
83 | ··················<dt:producer> | dt:Producer | [0..*] | Производитель продукции. | |
84 | ·····················<dt:enterprise> | dt:Enterprise | [1..1] | Информация о предприятие-производителе продукции. Обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID. При указании обоих полей, приоритет у UUID. | |
85 | ························<bs:uuid> | bs:UUID | [0..1] | Идентификатор версии предприятия. | <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid> |
86 | ························<bs:guid> | bs:UUID | [0..1] | Глобальный идентификатор предприятия. | <bs:guid>12f04ea3-e236-4b71-b427-e04d41b26de4</bs:guid> |
87 | ························<dt:name> | bs:String255 | [0..1] | Наименование производителя. | <dt:name>Мясной цех №36</dt:name> |
88 | ·····················</dt:enterprise> | ||||
89 | ·····················<dt:role> | dt:EnterpriseRole | [1..1] | Роль предприятия-производителя продукции. | <dt:role>PRODUCER</dt:role> |
90 | ··················</dt:producer> | ||||
91 | ···············</vd:origin> | ||||
92 | ···············<vd:lowGradeCargo> | xs:boolean | [1..1] | Является ли груз некачественным.
|
<vd:lowGradeCargo>false</vd:lowGradeCargo> |
93 | ···············<vd:packageList> | dt:PackageList | [0..1] | Список физической упаковки. | |
94 | ··················<dt:package> | dt:Package | [0..*] | Описание упаковки. Поддерживается указание многоуровневой упаковки и маркировки партии продукции. Всего предусмотрено шесть уровней упаковки (см. тип dt:PackageLevelType). Количество единиц упаковки и маркировка партии указывается для каждой упаковки конкретного уровня отдельно. На каждом уровне может быть произвольное количество типов упаковки, в том числе и ни одного, т.е. какого-то уровня упаковки в описании партии продукции может не быть. | |
95 | ·····················<dt:level> | dt:PackageLevelType | [1..1] | Уровень упаковки. | <vd:level>4</vd:level> |
96 | ·····················<dt:packingType> | dt:PackingType | [1..1] | Тип упаковки. | <vd:packingType>1</vd:packingType> |
97 | ························<bs:uuid> | bs:UUID | [0..1] | Идентификатор версии упаковки. | <bs:uuid>9c706614-b995-4bdd-bda3-8fa9de70803a</bs:uuid> |
98 | ························<dt:globalID> | dt:PackingCodeType | [1..1] | Уникальный идентификатор упаковки. | <dt:globalID>7B</dt:globalID> |
99 | ························<dt:name> | bs:String255 | [0..1] | Наименование упаковки. | <dt:name>Деревянный ящик</dt:name> |
100 | ·····················</dt:packingType> | ||||
101 | ·····················<dt:quantity> | xs:int | [0..1] | Количество единиц упаковки. | <vd:quantity>1</vd:quantity> |
102 | ·····················<dt:productMarks class="UNDEFINED"> | dt:ProductMarks | [0..*] | Маркировка партии продукции. | <vd:productMarks class="BN">ПАРТИЯ1251</vd:productMarks> |
103 | ··················</dt:package> | ||||
104 | ···············</vd:packageList> | ||||
105 | ···············<vd:owner> | dt:BusinessEntity | [0..1] | Фирма-владелец продукции. | |
106 | ··················<bs:uuid> | bs:UUID | [0..1] | Идентификатор версии хозяйствующего субъекта-владельца. | <bs:uuid>dc400640-0496-4f06-b83c-d00107edc744</bs:uuid> |
107 | ··················<bs:guid> | bs:UUID | [0..1] | Глобальный идентификатор хозяйствующего субъекта-владельца. | <bs:guid>879b525c-248d-46a5-bbde-2ee02d4d0bf9</bs:guid> |
108 | ··················<dt:fullName> | bs:String255 | [0..1] | Полное наименование хозяйствующего субъекта. | <dt:fullName>Общество с ограниченной ответственностью "Первая торговая компания"</dt:fullName> |
109 | ··················<dt:fio> | bs:String255 | [0..1] | ФИО хозяйствующего субъекта. | <dt:fio>Иванов Сергей Петрович</dt:fio> |
110 | ··················<dt:juridicalAddress> | dt:Address | [0..1] | Адрес фирмы. | |
111 | ·····················<dt:addressView> | bs:String255 | [0..1] | Представление адреса. | <dt:addressView>Российская Федерация, Владимирская обл., г. Владимир, ул. Ленина ул., д. 44</dt:addressView> |
112 | ··················</dt:juridicalAddress> | ||||
113 | ···············</vd:owner> | ||||
114 | ············</vd:batch> | ||||
115 | ·········</merc:stockEntry> | ||||
116 | ······</vd:resultingList> | ||||
117 | ···</vd:stockDiscrepancy> | ||||
118 | ···<vd:discrepancyReport> | vd:DiscrepancyReport | [0..1] | Акт несоответствия.
|
|
119 | ······<vd:issueSeries> | bs:String255 | [0..1] | Серия акта несоответствия.
|
<vd:issueSeries>ABSC-ТТН-4</vd:issueSeries> |
120 | ······<vd:issueNumber> | bs:String255 | [0..1] | Номер акта несоответствия.
|
<vd:issueNumber>79498-97</vd:issueNumber> |
121 | ······<vd:issueDate> | xs:date | [0..1] | Дата акта несоответствия. | <vd:issueDate>2017-07-07</vd:issueDate> |
122 | ······<vd:reason> | vd:DiscrepancyReason | [1..1] | ||
123 | ·········<vd:name> | xs:string | [1..1] | Причина составления акта несоответствия. | |
124 | ······</vd:reason> | <vd:name>Расхождение в объеме</vd:name> | |||
125 | ······<vd:description> | xs:string | [1..1] | Описание несоответствия. | <vd:description>Часть партии увезли на другую площадку</vd:description> |
126 | ···</vd:discrepancyReport> | ||||
127 | </merc:resolveDiscrepancyRequest> |
Данные ответа
Примеры запросов
Добавление записи в складской журнал продукции (пересортица при инвентаризации)
Изменение записи в складском журнале продукции
Списание остатков по записи журнала