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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
 
(не показано 6 промежуточных версий 2 участников)
Строка 67: Строка 67:
** [[Country|ikar:Country]]
** [[Country|ikar:Country]]
{{столбцы/конец}}
{{столбцы/конец}}
===Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений ===
{| class="wikitable"
|-
! Различающиеся параметры !! Версия для хозяйствующих субъектов !! Версия для ветеринарных управлений
|-
| '''Пространство имён''' || merc:http://api.vetrf.ru/schema/cdm/mercury/applications || mercvu:http://api.vetrf.ru/schema/cdm/mercury/vu/applications
|-
| '''Имя сервиса''' || mercury-g2b.service || mercury-vu.service
|-
|}


== Данные запроса ==
== Данные запроса ==
Строка 263: Строка 275:
| [[#Объект ..Request/stockDiscrepancy/resultingList/stockEntry|'''stockEntry''']] || Запись складского журнала продукции, измененная, либо полученная в результате инвентаризации. || [[StockEntry |vetd:StockEntry]] || 0..1
| [[#Объект ..Request/stockDiscrepancy/resultingList/stockEntry|'''stockEntry''']] || Запись складского журнала продукции, измененная, либо полученная в результате инвентаризации. || [[StockEntry |vetd:StockEntry]] || 0..1
|}
|}
'''Атрибуты списка resultingList'''
{{Ветис.API EntityList Attributes}}


===Объект [[#Объект resolveDiscrepancyRequest |..Request]]/[[#Объект ..Request/stockDiscrepancy|stockDiscrepancy]]/[[#Объект ..Request/stockDiscrepancy/resultingList|resultingList]]/'''stockEntry'''===
===Объект [[#Объект resolveDiscrepancyRequest |..Request]]/[[#Объект ..Request/stockDiscrepancy|stockDiscrepancy]]/[[#Объект ..Request/stockDiscrepancy/resultingList|resultingList]]/'''stockEntry'''===
Строка 324: Строка 340:
| [[#Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1
| [[#Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1
|-
|-
|'''lowGradeCargo'''|| Является ли продукция качественной. || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|'''lowGradeCargo'''|| Является ли груз некачественным.
*true – груз некачественный;
*false – груз качественный.
Элемент может не указываться. В этом случае значение по-умолчанию устанавливается false.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
|-
| [[#Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/owner | '''owner''']] ||  Хозяйствующий субъект-владелец продукции.|| [[BusinessEntity|ent:BusinessEntity]] || 1
| [[#Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/owner | '''owner''']] ||  Хозяйствующий субъект-владелец продукции.|| [[BusinessEntity|ent:BusinessEntity]] || 1
Строка 783: Строка 803:
| [[#Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| vetd:ProductMarkingList || 0..1
| [[#Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| vetd:ProductMarkingList || 0..1
|-
|-
|'''lowGradeCargo'''|| Является ли продукция качественной. || [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|'''lowGradeCargo'''|| Является ли груз некачественным.
*true – груз некачественный;
*false – груз качественный.
Элемент может не указываться. В этом случае значение по-умолчанию устанавливается false.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/owner | '''owner''']] ||  Хозяйствующий субъект-владелец продукции.|| [[BusinessEntity|ent:BusinessEntity]] || 1
| [[#Объект ..Response/stockEntryList/stockEntry/batch/owner | '''owner''']] ||  Хозяйствующий субъект-владелец продукции.|| [[BusinessEntity|ent:BusinessEntity]] || 1
Строка 910: Строка 934:


==Примеры запросов==
==Примеры запросов==
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Пример запроса для для ветеринарных управлений.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
                  xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions"
                  xmlns:app="http://api.vetrf.ru/schema/cdm/application"
                  xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/applications"
                  xmlns:base="http://api.vetrf.ru/schema/cdm/base"
                  xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
                  xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar"
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
                  xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">
  <soapenv:Header/>
  <soapenv:Body>
      <ws:submitApplicationRequest>
        <ws:apiKey>apiKey</ws:apiKey>
        <app:application>
            <app:serviceId>mercury-vu.service</app:serviceId>
            <app:issuerId>issuerId</app:issuerId>
            <app:issueDate>2017-01-13T17:03:00</app:issueDate>
            <app:data>
            <mercvu:resolveDiscrepancyRequest>       
              <mercvu:localTransactionId>transaction12345</mercvu:localTransactionId>
              <mercvu:initiator>
                  <com:login>login</com:login>
              </mercvu:initiator>
                <mercvu:businessEntity>
                    <base:guid>72c7e8cd-0583-45e2-99db-801f5939587e</base:guid>
                </mercvu:businessEntity>             
              <mercvu:enterprise>
                  <base:guid>9f0a0b32-8a29-40a6-9325-654434050d7c</base:guid>
              </mercvu:enterprise>
              <mercvu:inventoryDate>2017-01-13T00:00:00</mercvu:inventoryDate>
              <mercvu:responsible>
                  <com:login>login</com:login>
              </mercvu:responsible>
                <mercvu:stockDiscrepancy>
                    <vet:resultingList count="1" total="1" offset="0">                                                             
                        <vet:stockEntry>
                            <base:uuid>d918ee82-20ae-4375-8600-ab606fafacd5</base:uuid>
                            <vet:batch>
                              <vet:productType>5</vet:productType>
                              <vet:product>
                                <base:uuid>26b81265-a498-0a42-5b77-08da2eb03ab9</base:uuid>
                              </vet:product>
                              <vet:subProduct>
                                <base:uuid>fc444d07-093e-111c-1911-c156080040fc</base:uuid>
                              </vet:subProduct>
                              <vet:productItem>
                                <prod:name>пельмени по деревенски</prod:name>
                              </vet:productItem>
                              <vet:volume>0</vet:volume>
                              <vet:unit>
                                <base:uuid>0697a3da-053d-11e1-99b4-d8d385fbc9e8</base:uuid>
                              </vet:unit>
                              <vet:dateOfProduction>
                                <vet:firstDate>
                                    <base:year>2017</base:year>
                                    <base:month>1</base:month>
                                    <base:day>11</base:day>
                                    <base:hour>0</base:hour>
                                </vet:firstDate>
                              </vet:dateOfProduction>
                              <vet:expiryDate>
                                <vet:firstDate>
                                    <base:year>2021</base:year>
                                    <base:month>12</base:month>
                                    <base:day>1</base:day>
                                    <base:hour>0</base:hour>
                                </vet:firstDate>
                              </vet:expiryDate>
                              <vet:perishable>false</vet:perishable>
                              <vet:countryOfOrigin>
                                <base:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</base:uuid>
                              </vet:countryOfOrigin>
                              <vet:producerList>
                                <ent:producer>
                                    <ent:enterprise>
                                      <base:guid>9f0a0b32-8a29-40a6-9325-654434050d7c</base:guid>
                                    </ent:enterprise>
                                    <ent:role>PRODUCER</ent:role>
                                </ent:producer>
                              </vet:producerList>                             
                              <vet:productMarkingList>
                                <vet:productMarking>Тест</vet:productMarking>
                              </vet:productMarkingList>
                              <vet:lowGradeCargo>false</vet:lowGradeCargo>
                              <vet:owner>
                                <base:guid>72c7e8cd-0583-45e2-99db-801f5939587e</base:guid>
                              </vet:owner>
                          </vet:batch>
                        </vet:stockEntry>                       
                    </vet:resultingList>
                  </mercvu:stockDiscrepancy>
                  <mercvu:discrepancyReport>
                    <vet:issueSeries>95647</vet:issueSeries>
                    <vet:issueNumber>869588558</vet:issueNumber>
                    <vet:issueDate>2017-01-13</vet:issueDate>
                    <vet:reason>
                        <vet:name>причина</vet:name>
                    </vet:reason>
                    <vet:description>описание</vet:description>
                  </mercvu:discrepancyReport>
                  </mercvu:resolveDiscrepancyRequest>
            </app:data>
        </app:application>
      </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
<br/>
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Пример запроса для хозяйствующего субъекта.
Пример запроса для хозяйствующего субъекта.
Строка 946: Строка 1086:
                   <com:login>mercury_user_123456</com:login>
                   <com:login>mercury_user_123456</com:login>
               </merc:responsible>
               </merc:responsible>
                 <merc:stockDiscrepancy id="test1">
                 <merc:stockDiscrepancy>
                     <vet:resultingList count="1" total="1" offset="0">                                                               
                     <vet:resultingList count="1" total="1" offset="0">                                                               
                         <vet:stockEntry>
                         <vet:stockEntry>
Строка 1010: Строка 1150:
                     </vet:resultingList>
                     </vet:resultingList>
                   </merc:stockDiscrepancy>
                   </merc:stockDiscrepancy>
                   <merc:discrepancyReport for="test1">
                   <merc:discrepancyReport>
                     <vet:issueSeries>777</vet:issueSeries>
                     <vet:issueSeries>777</vet:issueSeries>
                     <vet:issueNumber>869588558</vet:issueNumber>
                     <vet:issueNumber>869588558</vet:issueNumber>
Строка 1035: Строка 1175:
|-
|-
!Код!! Описание ошибки
!Код!! Описание ошибки
|-
|MERC24025||Страна происхождения с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному
|-
|-
|MERC24055||В запросе отсутствуют сведения о результатах инвентаризации
|MERC24055||В запросе отсутствуют сведения о результатах инвентаризации

Текущая версия на 11:25, 16 февраля 2017

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

Операция ResolveDiscrepancyOperation предназначена для устранения возможных несоответствий сведений об объёмах в складском журнале продукции системы Меркурий и фактических объёмов продукции на складе предприятия, выявленных по результатам проведенной инвентаризации. В ходе проведения инвентаризации доступны следующие действия:

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

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

  • данные хозяйствующего субъекта и его предприятия, где проводится инвентаризация;
  • для объёмов продукции, которые не были ранее отражены в журнале, передается полностью информация о записи журнала;
  • для каждой изменяемой записи журнала должен быть указан её идентификатор в журнале продукции ИС «Меркурий», а также фактические сведения для этой записи;
  • при наличии «Акта о пересортице», оформляемого в ИС предприятия, должны быть переданы реквизиты данного документа, в случае отсутствия документа,он будет созданв ИС «Меркурий», а реквизиты будут назначены автоматически.

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

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

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

При формировании запроса возможны следующие сценарии.
1. Инвентаризация НЕ выявила неучтённых объёмов продукции,для которых отсутствует запись в журнале продукции в ИС Меркурий

  • Происходит изменение записей журнала продукции,оформляется акт о пересортице.

2. Инвентаризация выявила неучтённые объёмы продукции, для которых отсутствуют записи в журнале продукции в ИС Меркурий

  • Происходит добавление новых записей журнала продукции,оформляется акт о пересортице.

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


Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений

Различающиеся параметры Версия для хозяйствующих субъектов Версия для ветеринарных управлений
Пространство имён merc:http://api.vetrf.ru/schema/cdm/mercury/applications mercvu:http://api.vetrf.ru/schema/cdm/mercury/vu/applications
Имя сервиса mercury-g2b.service mercury-vu.service

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

Объект resolveDiscrepancyRequest

Объект содержит сведения о заявке на регистрацию несоответствий в записях складского журнала, выявленных в результате инвентаризации.

Поле Описание Тип Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. argc:User 1
businessEntity Хозяйствующий субъект, на площадке которого осуществляется инвентаризация .
  • Обязательно указывать, если запрос выполняется от имени ветеринарного управления. При выполнении запроса из информационной системы хозяйствующего субъекта достаточно указать enterprise.
 ent:BusinessEntity 0..1
enterprise Площадка на которой осуществляется инвентаризация . Указывается из списка мест осуществления деятельности для хозяйствующего субъекта.
  • Идентификатор предприятия, которое связано с хозяйствующим субъектом, инициировавшим запрос должен совпадать с идентификатором обслуживаемого вет. управлением предприятия, указанного в записи складского журнала участвующего в инвентаризации.
 ent:Enterprise 1
inventoryDate Дата проведения инвентаризации. xs:dateTime 1
responsible Ответственный за инвентаризацию. Указывается пользователь из списка пользователей для хозяйствующего субъекта - заявителя. argc:User 1
stockDiscrepancy Сведения о результате инвентаризации (по одному факту расхождения). vetd:StockDiscrepancy 1..*
discrepancyReport Сведения об акте несоответствия. vetd:DiscrepancyReport 1..*

Объект ..Request/initiator

Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.

Поле Описание Тип Обязательность
UUID Идентификатор пользователя, зарегистрированного в системе Меркурий. bs:UUID 1 - При авторизации достаточно указать один из параметров. Если указаны оба, то приоритет за UUID.
login Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. xs:NCName

Объект ..Request/businessEntity

Объект содержит сведения о хозйствующем субъекте, на площадке которого проводится инвентаризация. Необходимо указывать только при запросе от имени ветеринарного управления.

Поле Описание Тип Обязательность
GUID Глобальный идентификатор предприятия, на котором проводится инвентаризация. bs:UUID 1 - должен быть указан хотя бы один из идентификаторов. При указании обоих приоритет за UUID.
UUID Идентификатор версии записи предприятия в реестре, на котором проводится инвентаризация. bs:UUID

Объект ..Request/enterprise

Объект содержит сведения о площадке (поднадзорном объекте).

Поле Описание Тип Обязательность
GUID Глобальный идентификатор хозяйствующего субъекта, на предприятии которого проводится инвентаризация. bs:UUID 1 - обязательно указать один из идентификаторов. В случае, если указаны оба, приоритет будет за UUID
UUID Идентификатор версии записи хозяйствующего субъекта, на предприятии которго проводится инвентаризация. bs:UUID

Объект ..Request/responsible

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

Поле Описание Тип Обязательность
login Логин зарегистрированного в системе Меркурий пользователя хозяйствующего субъекта-заявителя. xs:NCName 1

Объект ..Request/stockDiscrepancy

Объект содержит сведения об изменениях, вносимых в складской журнал продукции.

Поле Описание Тип Обязательность
resultingList Одна или несколько записей складского журнала продукции, полученная, либо измененная в результате инвентаризации. vetd:StockEntryList 0..1

Объект ..Request/stockDiscrepancy/resultingList

Объект содержит сведения о записях складского журнала, полученных, либо измененных в результате инвентаризации .

Поле Описание Тип Обязательность
stockEntry Запись складского журнала продукции, измененная, либо полученная в результате инвентаризации. vetd:StockEntry 0..1

Атрибуты списка resultingList

Атрибут Описание Тип данных Обязательность
count Количество элементов списка, запрашиваемое или переданное. xs:int 1
total Общий размер списка. xs:long 1
offset Смещение первого элемента списка относительно его начала. xs:int 1

Объект ..Request/stockDiscrepancy/resultingList/stockEntry

Объект содержит сведения о записи складского журнала продукции в системе Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи складского журнала продукции.
  • Указывается в случае, если необходимо изменить существующую запись складского журнала, т.е. в том, случае, когда инвентаризация НЕ выявила неучтённых остатков.
  • Не указывается в случае добавления новой записи складского журнала продукции, т.е. когда при инвентаризации выявлены неучтённые остатки.
  • Если при наличии идентификатора указан объём больше нуля, тогда происходит редактирование записи складского журнала
  • Если при наличии идентификатора указан объём, равный нулю, происходит удаление записи складского журнала.
 bs:UUID 0..1
batch Сведения о партии продукции. vetd:Batch 1

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch

Объект содержит сведения о партии продукции.

Поле Описание Тип Обязательность
productType Тип продукции. Первый уровень иерархического справочника продукции РСХН. argpr:ProductType 1
product Продукция. Второй уровень иерархического справочника продукции РСХН. argpr:Product 1
subProduct Вид продукции. Третий уровень иерархического справочника продукции РСХН. argpr:SubProduct 1
productItem Наименование продукции в номенклатуре производителя. argpr:ProductItem 1
volume Объем продукции по результатам инвентаризации.
  • В случае, если указана запись складского журнала продукции и значение объема больше нуля, то объем данной записи изменяется на указанный.
  • В случае, если указана запись складского журнала продукции и значение объема указано ноль, то объем данной записи становится нулевым и запись переходит в статус "Оформлена".
  • В случае, если в запросе не указан идентификатор существующей записи складского журнала продукции, и указанный объём больше нуля, то происходит добавление новой записи, с указанным объемом в складской журнал продукции системы Меркурий.
 bs:Decimal 1
unit Единица измерения объема продукции. argc:Unit 1
packingList Список упаковок. argc:PackingFormList 0..1
packingAmount Общее количество единиц упаковки продукции. xs:int 0..1
dateOfProduction Дата выработки продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. vetd:GoodsDate 1
expiryDate Дата окончания срока годности продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. vetd:GoodsDate 1
perishable Описывает, является ли продукция скоропортящейся:
  • true – скоропортящаяся;
  • false – нескоропортящаяся.
 xs:boolean 1
countryOfOrigin Страна происхождения продукции. ikar:Country 1
producerList Список производителей продукции. ent:ProducerList 0..1
productMarkingList Список маркировки, доступный для данного производителя. vetd:ProductMarkingList 0..1
lowGradeCargo Является ли груз некачественным.
  • true – груз некачественный;
  • false – груз качественный.

Элемент может не указываться. В этом случае значение по-умолчанию устанавливается false.

xs:boolean 1
owner Хозяйствующий субъект-владелец продукции. ent:BusinessEntity 1

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/product

Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника продукции. bs:UUID 1 - Обязательно указать один из идентификаторов. В случае указания обоих приоритет у UUID
GUID Глобальный идентификатор записи справочника продукции. bs:UUID

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/subProduct

Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника вида продукции. bs:UUID 1 - Обязательно указать один из идентификаторов. В случае указания обоих приоритет у UUID
GUID Глобальный идентификатор записи справочника продукции. bs:UUID

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/productItem

Объект содержит сведения о наименовании продукции.

Поле Описание Тип Обязательность
UUID Уникальный идентификатор продукции. bs:UUID 1 - Обязательно указать один из параметров. В случае указания обоих приоритет у UUID
name Наименование продукции в соответствии с номенклатурой производителя.

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/unit

Объект содержит сведения о единице измерения объема продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника единиц измерения. bs:UUID 1 - обязателен к указанию один из идентификаторов. Если указаны оба, то приоритет за UUID.
GUID Глобальный идентификатор записи справочника единиц измерения. bs:UUID

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/packingList

Поле Описание Тип данных Обязательность
packingForm Описание способов упаковки argc:PackingForm 0..1

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/countryOfOrigin

Объект содержит сведения о стране-происхождения продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии страны происхождения. bs:UUID 1 - Обязательно указать один из идентификаторов. В случае указания обоих приоритет у UUID
GUID Глобальный идентификатор страны происхождения. bs:UUID

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/producerList

Объект содержит сведения о списке производителей продукции.

Поле Описание Тип Обязательность
producer Производитель продукции. ent:Producer 1

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/producerList/producer

Объект содержит сведения о производителе продукции.

Поле Описание Тип Обязательность
enterprise Информация о предприятие-производителе продукции. ent:Enterprise 1
role Роль предприятия-производителя продукции. ent:EnterpriseRole 1

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/producerList/producer/enterprise

Объект содержит сведение о предприятие-производителе продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия-производителя продукции. bs:UUID 1 - Обязательно указать один из идентификаторов. В случае указания обоих приоритет у UUID
GUID Глобальный идентификатор предприятия-производителя продукции. bs:UUID

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/productMarkingList

Объект содержит сведения о списке маркировки.

Поле Описание Тип Обязательность
productMarking Строка с маркировкой продукции. bs:String255 0..*

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/batch/owner

Объект содержит сведения о хозяйствующем субъекте-владельце продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - владельца продукции. bs:UUID 1 - Обязательно указать один из идентификаторов. В случае указания обоих приоритет у UUID
GUID Глобальный идентификатор хозяйствующего субъекта - владельца продукции. bs:UUID

Объект ..Request/stockDiscrepancy/resultingList/stockEntry/vetDocument

Объект содержит сведения о ветеринарно-сопроводительном документе.

Поле Описание Тип Обязательность
UUID Идентификатор ВСД. bs:UUID 1

Объект ..Request/discrepancyReport

Объект содержит сведения об акте несоответствия.

Поле Описание Тип Обязательность
issueSeries Серия акта несоответствия. bs:String255 0..1
issueNumber Номер акта несоответствия. bs:String255 0..1
issueDate Дата акта несоответствия. xs:date 0..1
reason Причина несоответствия (составления акта). vetd:DiscrepancyReason 0..1
description Детальное описание. xs:string 0..1

Данные ответа

Объект resolveDiscrepancyResponse

Объект содержит сведения о результатах обработки заявки на регистрацию несоответствий в записях складского журнала, выявленных в результате инвентаризации.

Поле Описание Тип Обязательность
stockEntryList Сведения о созданных и/или измененных записях складского журнала продукции. vetd:StockEntryList 1

Объект ..Response/stockEntryList

Объект содержит сведения о получаемых в результате инвентаризации записях складского журнала.

Поле Описание Тип Обязательность
stockEntry Запись складского журнала, полученная в результате инвентаризации. vetd:StockEntry 1..*

Объект ..Response/stockEntryList/stockEntry

Объект содержит сведения о созданной или измененной записи складского журнала продукции в системе Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи складского журнала продукции, в которую вносились изменения.
  • Передается в случае, если изменения вносились в существующую запись складского журнала.
 bs:UUID 0..1
GUID Глобальный идентификатор записи складского журнала продукции, в которую вносились изменения.
  • Передается в случае, если изменения вносились в существующую запись складского журнала.
 bs:UUID 0..1
active Является ли запись журнала, в которую вносились изменения, активной:
  • true - запись активна;
  • false - запись не активна.
  • Передается в случае в случае, если изменения вносились в существующую запись складского журнала.
 xs:boolean 0..1
last Последняя версия записи складского журнала:
  • true - да;
  • false - нет.
  • Передается в случае в случае, если изменения вносились в существующую запись складского журнала.
 xs:boolean 0..1
status Статус версии записи складского журнала.
  • Передается в случае в случае, если изменения вносились в существующую запись складского журнала.
 bs:VersionStatus 0..1
createDate Дата создания записи складского журнала.
  • Передается в случае, если изменения вносились в существующую запись складского журнала.
 xs:dateTime 0..1
updateDate Дата изменения записи складского журнала.
  • Передается в случае, если изменения вносились в существующую запись складского журнала.
 xs:dateTime 0..1
next Идентификатор последующей версии записи складского журнала.
  • Передается в случае, если изменения вносились в существующую запись складского журнала.
 bs:UUID 0..1
previous Идентификатор предыдущей версии записи складского журнала.
  • Не передается в случае, если в результате инвентаризации создавалась новая запись складского журнала.
 bs:UUID 0..1
entryNumber Номер записи складского журнала, доступный через веб-интерфейс vetd:StockentryNumber 1
batch Сведения о продукции. vetd:Batch 1

Объект ..Response/stockEntryList/stockEntry/batch

Объект содержит сведения о партии продукции.

Поле Описание Тип Обязательность
productType Тип продукции. Первый уровень иерархического справочника продукции РСХН. argpr:ProductType 1
product Продукция. Второй уровень иерархического справочника продукции РСХН. argpr:Product 1
subProduct Вид продукции. Третий уровень иерархического справочника продукции РСХН. argpr:SubProduct 1
productItem Наименование продукции в номенклатуре производителя. argpr:ProductItem 0..1
volume Объем продукции по результатам инвентаризации. bs:Decimal 1
unit Единица измерения объема продукции. argc:Unit 1
packingList Список упаковок. xs:int 0..1
packingAmount Общее количество единиц упаковки продукции. xs:int 0..1
dateOfProduction Дата выработки продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. vetd:GoodsDate 1
expiryDate Дата окончания срока годности продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate. vetd:GoodsDate 1
perishable Описывает, является ли продукция скоропортящейся:
  • true – скоропортящаяся;
  • false – не скоропортящаяся.
 xs:boolean 0..1
countryOfOrigin Страна происхождения продукции. ikar:Country 1
producerList Список производителей продукции. ent:ProducerList 1
productMarkingList Список маркировки, доступный для данного производителя. vetd:ProductMarkingList 0..1
lowGradeCargo Является ли груз некачественным.
  • true – груз некачественный;
  • false – груз качественный.

Элемент может не указываться. В этом случае значение по-умолчанию устанавливается false.

xs:boolean 1
owner Хозяйствующий субъект-владелец продукции. ent:BusinessEntity 1

Объект ..Response/stockEntryList/stockEntry/batch/product

Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника продукции. bs:UUID 1
GUID Глобальный идентификатор записи справочника продукции. bs:UUID 1

Объект ..Response/stockEntryList/stockEntry/batch/subProduct

Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника вида продукции bs:UUID 1
GUID Глобальный идентификатор записи справочника продукции bs:UUID 1

Объект ..Response/stockEntryList/stockEntry/batch/productItem

Объект содержит сведения о наименовании произведенной продукции.

Поле Описание Тип Обязательность
name Наименование продукции в соответствии с номенклатурой производителя xs:string 1

Объект ..Response/stockEntryList/stockEntry/batch/unit

Объект содержит сведения о единице измерения объема входящей партии.

Поле Описание Тип Обязательность
UUID Идентификатор версии записи справочника единиц измерения bs:UUID 1
GUID Глобальный идентификатор записи справочника единиц измерения bs:UUID 1

Объект ..Response/stockEntryList/stockEntry/batch/packingList

Поле Описание Тип данных Обязательность
packingForm Описание способов упаковки argc:PackingForm 0..1

Объект ..Response/stockEntryList/stockEntry/batch/countryOfOrigin

Объект содержит сведения о стране-происхождения продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии страны происхождения. bs:UUID 1
GUID Глобальный идентификатор страны происхождения. bs:UUID 1

Объект ..Response/stockEntryList/stockEntry/batch/producerList

Объект содержит сведения о списке производителей продукции.

Поле Описание Тип Обязательность
producer Производитель продукции. ent:Producer 1

Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer

Объект содержит сведения о производителе продукции.

Поле Описание Тип Обязательность
enterprise Информация о предприятие-производителе продукции. ent:Enterprise 1
role Роль предприятия-производителя продукции. ent:EnterpriseRole 1

Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer/enterprise

Объект содержит сведение о предприятие-производителе продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии предприятия-производителя продукции. bs:UUID 1
GUID Глобальный идентификатор предприятия-производителя продукции. bs:UUID 1

Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList

Объект содержит сведения о списке маркировки.

Поле Описание Тип Обязательность
productMarking Строка с маркировкой продукции. bs:String255 0..*

Объект ..Response/stockEntryList/stockEntry/batch/owner

Объект содержит сведения о хозяйствующем субъекте-владельце продукции.

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - владельца продукции. bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта - владельца продукции. bs:UUID 1

Объект ..Response/stockEntryList/stockEntry/vetDocument

Объект содержит сведения о ветеринарно-сопроводительном документе.

Поле Описание Тип Обязательность
UUID Идентификатор ВСД. bs:UUID 1

Примеры запросов

Пример запроса для для ветеринарных управлений. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions" 
                  xmlns:app="http://api.vetrf.ru/schema/cdm/application" 
                  xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/applications" 
                  xmlns:base="http://api.vetrf.ru/schema/cdm/base" 
                  xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common" 
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise" 
                  xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar" 
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document" 
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production" 
                  xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:submitApplicationRequest>
         <ws:apiKey>apiKey</ws:apiKey>
         <app:application>
            <app:serviceId>mercury-vu.service</app:serviceId>
            <app:issuerId>issuerId</app:issuerId>
            <app:issueDate>2017-01-13T17:03:00</app:issueDate>
            <app:data>
            <mercvu:resolveDiscrepancyRequest>         
               <mercvu:localTransactionId>transaction12345</mercvu:localTransactionId>
               <mercvu:initiator>
                  <com:login>login</com:login>
               </mercvu:initiator>
                <mercvu:businessEntity>
                    <base:guid>72c7e8cd-0583-45e2-99db-801f5939587e</base:guid>
                </mercvu:businessEntity>               
               <mercvu:enterprise>
                  <base:guid>9f0a0b32-8a29-40a6-9325-654434050d7c</base:guid>
               </mercvu:enterprise>
               <mercvu:inventoryDate>2017-01-13T00:00:00</mercvu:inventoryDate>
               <mercvu:responsible>
                  <com:login>login</com:login>
               </mercvu:responsible>
                <mercvu:stockDiscrepancy>
                     <vet:resultingList count="1" total="1" offset="0">                                                              
                        <vet:stockEntry>
                            <base:uuid>d918ee82-20ae-4375-8600-ab606fafacd5</base:uuid>
                            <vet:batch>
                              <vet:productType>5</vet:productType>
                              <vet:product>
                                 <base:uuid>26b81265-a498-0a42-5b77-08da2eb03ab9</base:uuid>
                              </vet:product>
                              <vet:subProduct>
                                 <base:uuid>fc444d07-093e-111c-1911-c156080040fc</base:uuid>
                              </vet:subProduct>
                              <vet:productItem>
                                 <prod:name>пельмени по деревенски</prod:name>
                              </vet:productItem>
                              <vet:volume>0</vet:volume>
                              <vet:unit>
                                 <base:uuid>0697a3da-053d-11e1-99b4-d8d385fbc9e8</base:uuid>
                              </vet:unit>
                              <vet:dateOfProduction>
                                 <vet:firstDate>
                                    <base:year>2017</base:year>
                                    <base:month>1</base:month>
                                    <base:day>11</base:day>
                                    <base:hour>0</base:hour>
                                 </vet:firstDate>
                              </vet:dateOfProduction>
                              <vet:expiryDate>
                                 <vet:firstDate>
                                    <base:year>2021</base:year>
                                    <base:month>12</base:month>
                                    <base:day>1</base:day>
                                    <base:hour>0</base:hour>
                                 </vet:firstDate>
                              </vet:expiryDate>
                              <vet:perishable>false</vet:perishable>
                              <vet:countryOfOrigin>
                                 <base:uuid>72a84b51-5c5e-11e1-b9b7-001966f192f1</base:uuid>
                              </vet:countryOfOrigin>
                              <vet:producerList>
                                 <ent:producer>
                                    <ent:enterprise>
                                       <base:guid>9f0a0b32-8a29-40a6-9325-654434050d7c</base:guid>
                                    </ent:enterprise>
                                    <ent:role>PRODUCER</ent:role>
                                 </ent:producer>
                              </vet:producerList>                              
                              <vet:productMarkingList>
                                 <vet:productMarking>Тест</vet:productMarking>
                              </vet:productMarkingList>
                              <vet:lowGradeCargo>false</vet:lowGradeCargo>
                              <vet:owner>
                                 <base:guid>72c7e8cd-0583-45e2-99db-801f5939587e</base:guid>
                              </vet:owner>
                           </vet:batch>
                        </vet:stockEntry>                        
                     </vet:resultingList>
                  </mercvu:stockDiscrepancy>
                  <mercvu:discrepancyReport>
                     <vet:issueSeries>95647</vet:issueSeries>
                     <vet:issueNumber>869588558</vet:issueNumber>
                     <vet:issueDate>2017-01-13</vet:issueDate>
                     <vet:reason>
                        <vet:name>причина</vet:name>
                     </vet:reason>
                     <vet:description>описание</vet:description>
                  </mercvu:discrepancyReport>
                  </mercvu:resolveDiscrepancyRequest>
            </app:data>
         </app:application>
      </ws:submitApplicationRequest>
   </soapenv:Body>
</soapenv:Envelope>


Пример запроса для хозяйствующего субъекта. 

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
                  xmlns:ws="http://api.vetrf.ru/schema/cdm/application/ws-definitions" 
                  xmlns:app="http://api.vetrf.ru/schema/cdm/application" 
                  xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications" 
                  xmlns:base="http://api.vetrf.ru/schema/cdm/base" 
                  xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common" 
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise" 
                  xmlns:ikar="http://api.vetrf.ru/schema/cdm/ikar" 
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document" 
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production" 
                  xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">
   <soapenv:Header/>
   <soapenv:Body>
      <ws:submitApplicationRequest>
          <ws:apiKey>apiKey</ws:apiKey>
         <app:application>
            <app:serviceId>mercury-g2b.service</app:serviceId>
            <app:issuerId>issuerId</app:issuerId>
            <app:issueDate>2015-12-04T17:03:00</app:issueDate>
            <app:data>
            <merc:resolveDiscrepancyRequest>         
               <merc:localTransactionId>transaction12345</merc:localTransactionId>
               <merc:initiator>
                  <com:login>mercury-user-123456</com:login>
               </merc:initiator>
               <merc:enterprise>
                  <base:guid>guid</base:guid>
               </merc:enterprise>
               <merc:inventoryDate>2015-11-10T00:00:00</merc:inventoryDate>
               <merc:responsible>
                  <com:login>mercury_user_123456</com:login>
               </merc:responsible>
                <merc:stockDiscrepancy>
                     <vet:resultingList count="1" total="1" offset="0">                                                              
                        <vet:stockEntry>
                            <base:uuid>73e94e6f-3f29-4aa7-802f-013030888206</base:uuid>
                            <vet:batch>
                              <vet:productType>1</vet:productType>
                              <vet:product>
                                 <base:uuid>3d327bce-e7cb-0c80-f352-1c7073bbb54d</base:uuid>
                              </vet:product>
                              <vet:subProduct>
                                 <base:uuid>379862a1-a979-65d8-e497-955dc8779e8b</base:uuid>
                              </vet:subProduct>
                              <vet:productItem>
                                 <prod:name>Мясо</prod:name>
                              </vet:productItem>
                              <vet:volume>73</vet:volume>
                              <vet:unit>
                                 <base:uuid>069792f0-053d-11e1-99b4-d8d385fbc9e8</base:uuid>
                              </vet:unit>
                              <vet:packingList>
                                 <com:packingForm>
                                    <base:uuid>fedf4616-053c-11e1-99b4-d8d385fbc9e8</base:uuid>
                                 </com:packingForm>
                              </vet:packingList>
                              <vet:packingAmount>78</vet:packingAmount>
                              <vet:dateOfProduction>
                                 <vet:firstDate>
                                    <base:year>2015</base:year>
                                    <base:month>3</base:month>
                                    <base:day>5</base:day>
                                    <base:hour>0</base:hour>
                                 </vet:firstDate>
                              </vet:dateOfProduction>
                              <vet:expiryDate>
                                 <vet:firstDate>
                                    <base:year>2017</base:year>
                                    <base:month>5</base:month>
                                    <base:day>15</base:day>
                                    <base:hour>0</base:hour>
                                 </vet:firstDate>
                              </vet:expiryDate>
                              <vet:perishable>false</vet:perishable>
                              <vet:countryOfOrigin>
                                 <base:uuid>b091ec32-0a35-c888-9548-7149b80089bf</base:uuid>
                              </vet:countryOfOrigin>
                              <vet:producerList>
                                 <ent:producer>
                                    <ent:enterprise>
                                       <base:guid>guid</base:guid>
                                    </ent:enterprise>
                                    <ent:role>PRODUCER</ent:role>
                                 </ent:producer>
                              </vet:producerList>                              
                              <vet:productMarkingList>
                                 <vet:productMarking>Тест</vet:productMarking>
                              </vet:productMarkingList>
                              <vet:lowGradeCargo>false</vet:lowGradeCargo>
                              <vet:owner>
                                 <base:guid>guid</base:guid>
                              </vet:owner>
                           </vet:batch>
                        </vet:stockEntry>                        
                     </vet:resultingList>
                  </merc:stockDiscrepancy>
                  <merc:discrepancyReport>
                     <vet:issueSeries>777</vet:issueSeries>
                     <vet:issueNumber>869588558</vet:issueNumber>
                     <vet:issueDate>2015-06-01</vet:issueDate>
                     <vet:reason>
                        <vet:name> причина1</vet:name>
                     </vet:reason>
                     <vet:description>описание1</vet:description>
                  </merc:discrepancyReport>
                  </merc:resolveDiscrepancyRequest>
            </app:data>
         </app:application>
      </ws:submitApplicationRequest>
   </soapenv:Body>
</soapenv:Envelope>

Коды ошибок

В таблице ниже приведены коды ошибок, возвращаемые веб-сервисом при различных несоответствиях формату или бизнес-правилам.

Код Описание ошибки
MERC24025 Страна происхождения с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному
MERC24055 В запросе отсутствуют сведения о результатах инвентаризации
MERC24081 Скоропортящаяся продукция или нет для записи складского журнала обязательно для заполнения.
MERC24082 Дата выработки для продукции обязательна для заполнения.
MERC24083 Дата окончания срока годности продукции обязательна для заполнения.
MERC24084 Дата рождения для продукции обязательна для заполнения.
MERC24085 Дата рождения для продукции указана неверно.
MERC24086 Дата выработки для продукции указана неверно.
MERC24087 Дата окончания срока годности продукции указана неверно.
MERC24088 Дата выработки должна быть раньше срока годности для вырабатываемой продукции.
MERC24089 Количество единиц упаковки для продукции указано неверно.
MERC24091 Объём продукции указан неверно.
MERC24094 Единицы измерения для записи складского журнала обязательны для заполнения.
MERC24095 Тип продукции для записи складского журнала обязателен для заполнения.
MERC24096 Продукция для записи складского журнала обязательна для заполнения.
MERC24097 Вид продукции для записи складского журнала обязателен для заполнения.
MERC24098 Наименование продукции для записи складского журнала обязательно для заполнения.
MERC24099 Наименование продукции для записи складского журнала превышает допустимую длину текста.
MERC24100 Примечание для записи складского журнала превышает допустимую длину текста.
MERC24124 Наименование продукции в сведениях о записи складского журнала имеет статус "не подтверждено"
MERC24125 Наименование продукции в сведениях о записи складского журнала имеет статус "отклонено"
MERC24126 Производитель в сведениях о записи складского журнала отсутствует в списке производителей наименования продукции
MERC24127 Предприятие и хозяйствующий субъект, указанные в сведеняих о результатах инвентаризации, должны быть связаны друг с другом
MERC24140 Записи складского журнала продукции не должны быть устаревшими
MERC24141 Записи складского журнала продукции не должны являться шаблонами
MERC24142 Записи складского журнала продукции должны быть в состоянии "создана" (т.е. не аннулированы)
MERC24143 Записи складского журнала не должны быть оформлены
MERC24144 Запись складского журнала продукции должна быть отправлена в ГВЭ
MERC24174 Хозяйствующий субъект с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC24175 В запросе для хозяйствующего субъекта указан идентификатор устаревшей версии записи реестра РСХН.
MERC24180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC24181 В запросе для предприятия указан идентификатор устаревшей версии записи реестра РСХН.
MERC24219 Страна происхождения продукции обязательна для заполнения.
MERC24220 Дата поступления продукции обязательна для заполнения.
MERC24221 Дата поступления продукции указана неверно.
MERC24229 При изменении записи складского журнала тип продукции должен совпадать с указанной в исходной записи.
MERC24230 При изменении записи складского журнала продукция должна совпадать с указанной в исходной записи.
MERC24233 При изменении записи складского журнала единица измерения должна быть совместимой с указанной в исходной записи.
MERC24263 Указанная единица измерения в сведениях о записи складского журнала не разрешена для данной продукции.
MERC24264 Для указанной единицы измерения в сведениях о записи складского журнала требуется указать целочисленный объем груза.
MERC24283 При указании упаковки необходимо указать ее идентификатор (UUID).
MERC24284 При указании количества единиц упаковки необходимо также указать вид упаковки
MERC24286 В сведениях о записи складского журнала указана упаковка для живых животных.
MERC24287 В сведениях о записи складского журнала указано количество упаковки для живых животных.
MERC24305 Пользователь с указанным идентификатором не найден в реестре РСХН, либо логин не соответствует установленному формату
MERC24306 Пользователь с указанным идентификатором заблокирован
MERC24307 В сведениях о результатах инвентаризации необходимо указать дату инвентаризации
MERC24308 В сведениях о результатах инвентаризации необходимо указать хозяйствующего субъекта
MERC24309 В сведениях о результатах инвентаризации необходимо указать обслуживаемое предприятие
MERC24310 В сведениях о результатах инвентаризации необходимо указать хотя бы одно несоответствие
MERC24311 В сведениях о несоответствии по инвентаризации необходимо указать производимую операцию
MERC24312 В сведениях о несоответствии по инвентаризации необходимо указать исходную запись складского журнала
MERC24313 В сведениях о несоответствии по инвентаризации необходимо указать фактические сведения о записи складского журнала
MERC24316 По одной из записей складского журнала указано несколько несоответствий
MERC24330 Ответственный пользователь не относится к указанному хозяйствующему субъекту


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

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