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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Egorova-iv-150707 переименовал страницу MergeOperation в MergeOperation v1.2)
 
 
(не показаны 24 промежуточные версии 3 участников)
Строка 1: Строка 1:
#перенаправление [[MergeOperation v1.2]]
== Общие сведения ==
Операция '''MergeOperation''' предназначена для объединения в системе Меркурий нескольких записей складского журнала продукции в одну, для согласования особенностей партионного учёта, принятого в системе Меркурий и в учётной системе предприятия. Также операция может использоваться для присоединения  На вход системы передаются следующие сведения:
* данные о хозяйствующем субъекте и предприятии, в журнале которого будет производиться объединение записей;
* позиции в складском журнале системы Меркурий, которые необходимо объединить;
* наименование продукции для объединенной записи журнала и другая дополнительная информация.
Результатом выполнения данной операции является:
* добавление в складской журнал продукции записи, сформированной в результате объединения двух или более записей журнала, содержащей общий объем, даты выработки и срок годности.
 
=== Возможные сценарии ===
При выполнении операции '''MergeOperation''' возможны следующие сценарии:<br />
# Происходит объединение нескольких записей складского журнала продукции в одну, при этом в журнал входной продукции добавляется новая позиция с общим объемом и периодом дат выработки и срока годности.
# Происходит присоединение записей к первой по списку. В этом случае результирующая запись журнала будет иметь наименование продукции, то же наименование продукции, что и главная. Объём и количество упаковок будет просуммировано, вид упаковки, номера партий логически объединены в список.
# Произошла ошибка при обработке запроса.
::* Некорректный запрос.
::* Запрос не прошёл проверку на бизнес-правила.
::* Внутренняя ошибка системы.
 
===Используемые пространства имён и типы===
{{столбцы}}
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/mercury/vet-document|vetd]] (<nowiki>http://api.vetrf.ru/schema/cdm/mercury/vet-document</nowiki>)
** [[Batch|vetd:Batch]]
** [[MergeStockEntriesOperation|vetd:MergeStockEntriesOperation]]
** [[StockEntry|vetd:StockEntry]]
** [[StockEntryList|vetd:StockEntryList]]
** [[StockEntryNumber|vetd:StockeEntryNumber]]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[UUID|bs:UUID]]
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/production|argpr]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/production</nowiki>)
** [[SubProduct|argpr:SubProduct]]
** [[ProductItem|argpr:ProductItem]]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/common|argc]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/common</nowiki>)
** [[User|argc:User]]
* [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>)
** [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
** [http://www.w3.org/TR/xmlschema-2/#string xs:string]
{{столбцы/конец}}
 
===Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений ===
 
{| 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
|-
|}
 
== Данные запроса ==
<!--- <div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных запроса в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<mercvu:mergeStockEntriesRequest 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:shp="http://api.vetrf.ru/schema/cdm/argus/shipment"
                              xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                              xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
                              xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
                              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<mercvu:localTransactionId>{xs:NCName}</merc:localTransactionId>
    <mercvu:initiator>
        <base:uuid>{bs:UUID}</base:uuid>
        <com:login>{xs:NCName}</com:login>
    </mercvu:initiator>
    <mercvu:MergeStockEntriesRequest>
        <vet:sourceStockEntry>
            <base:uuid>{bs:UUID}</base:uuid>
        </vet:sourceStockEntry>
        <vet:sourceStockEntry>
            <base:uuid>{bs:UUID}</base:uuid>
        </vet:sourceStockEntry>
        <...>
        <vet:batch>
            <vet:subProduct>
                <base:uuid>{bs:UUID}</base:uuid>
            </vet:subProduct>
            <vet:productItem>
                <prod:name>{bs:String255}</prod:name>
            </vet:productItem>
        </vet:batch>
    </merc:mergeOperation>
</merc:mergeStockEntriesRequest>
</syntaxhighlight>
</div>
</div> -->
 
===Объект mergeStockEntriesRequest===
Объект содержит сведения об объединяемых складских записях журнала продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''localTransactionId''' || Идентификатор заявки в клиентской системе. || [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 1
|-
| [[#Объект ..Request/initiator|'''initiator''']] || Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.  || [[User|argc:User]] || 1
|-
| [[#Объект ..Request/businessEntity|'''businessEntity''']] || Хозяйствующий субъект, для предприятия которого выполняется операция объединения записей.
* Обязательно указывать при оформлении запросов от ветеринарного управления. Для хозяйствующих субъектов достаточно указать '''enterprise'''.
|| [[BusinessEntity|ent:BusinessEntity]] || 0..1
|-
| [[#Объект ..Request/enterprise|'''enterprise''']] || Предприятие, на котором выполняется операция объединения записей. || [[Enterprise|ent:Enterprise]] || 1
|-
| [[#Объект ..Request/mergeOperation|'''mergeOperation''']] || Сведения, необходимые для объединения нескольких записей журнала. || [[MergeStockEntriesOperation|vetd:MergeStockEntriesOperation]] || 1
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/'''initiator'''===
Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор пользователя, зарегистрированного в системе Меркурий. || [[UUID|bs:UUID]] || rowspan="2"| 1 - Для авторизации достаточно одного из параметров. Если используются оба, то приоритет будет за UUID.
|-
| '''login''' || Логин пользователя. || [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/'''businessEntity'''===
Объект содержит сведения о хозяйствующем субъекте. Требуется только при выполнении операции от имени [[Различия в запросах от хозяйствующих субъектов и ветеринарных управлений#MergeOperation|ветеринарного управления]].
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи хозяйствующего субъекта.|| [[UUID|bs:UUID]] || rowspan = "2" | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.
При указании обоих полей, приоритет у UUID.
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта.|| [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/'''enterprise'''===
Объект содержит сведения о хозяйствующем субъекте.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи предприятия в реестре РСХН.|| [[UUID|bs:UUID]] || rowspan = "2" | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.
При указании обоих полей, приоритет у UUID.
|-
| '''GUID''' || Глобальный идентификатор предприятия в реестре РСХН.|| [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/'''mergeOperation'''===
Объект содержит сведения, необходимые для объединения записей складского журнала продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
<!--|-
| '''type''' || Тип операции. Поддерживается два типа: MERGE и ATTACH.
* Если элемент не указан, по умолчанию значение принимается равным MERGE.
* В случае присоединения записей (ATTACH) главной записью журнала (к которой осуществляется присоединение), будет считаться первая запись sourceStockEntry из списка.
* В случае присоединения элемент batch не указывается, результирующая запись журнала будет иметь то же наименование продукции, что и главная. Объём и количество упаковок будет просуммировано, вид упаковки, номера партий логически объединены в список.
|| [[RegisterModificationType|bs:RegisterModificationType]] || 0..1 -->
|-
| [[#Объект ..Request/mergeOperation/sourceStockEntry|'''sourceStockEntry''']] || Позиции в складском журнале системы Меркурий, не менее двух. Указанные позиции будут объединены в одну. Представляют собой идентификатор версии записи (uuid) в ИС Меркурий.
* Указанная версия записи складского журнала продукции в ИС Меркурий должна быть актуальной, неаннулированной и неудалённой.
* Объединяемые записи журнала должны быть в статусе '''"создана"''' или '''"отправлена"'''.
* Объединяемые записи журнала должны быть в журнале входной продукции, для вырабатываемой продукции функция объединения отсутствует.
* Хозяйствующий субъект - владелец продукции в объединяемых записях должен совпадать.
* Объединяемые записи журнала продукции должны относится к одному типу продукции (первый уровень справочника продукции).
* Объединяемые записи журнала продукции должны относится к одной продукции (второй уровень справочника продукции).
* В объединяемых записях журнала продукции указанная ед. измерения должна относится к одной группе единиц измерения.
* Объединяемые записи журнала продукции должны относится к одной стране происхождения.
* Запрещено объединение записи журнала входной и вырабатываемой продукции.
* Запрещено объединение записей журнала относящихся к скоропортящейся и не скоропортящейся продукции.
* Запрещено объединение записей журнала относящихся к качественной и некачественной продукции;
|| [[StockEntry|vetd:StockEntry]] || 2..*
|-
| [[#Объект ..Request/mergeOperation/batch|'''batch''']] || Сведения, которые будут содержаться в объединенной записи журнала. Содержит информацию о виде продукции и его наименовании для объединенной записи.
<!-- * Не указывается, если тип операции - присоединение (type = ATTACH). -->
|| [[Batch|vetd:Batch]] || 0..1
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/[[#Объект ..Request/mergeOperation|mergeOperation]]/'''sourceStockEntry'''===
Объект содержит сведения о позициях складского журнала системы Меркурий, которые необходимо объединить.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи складского журнала. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/[[#Объект ..Request/mergeOperation|mergeOperation]]/'''batch'''===
Объект содержит сведения необходимые для объединения нескольких записей складского журнала.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Request/mergeOperation/batch/subProduct|'''subProduct''']] || Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
* Соответствующая версия вида продукции в ИС Меркурий должна быть актуальной и неудалённой.
* Вид продукции должен относится к той же продукции (второй уровень справочника продукции), что и в объединяемых записях складского журнала.
|| [[SubProduct|argpr:SubProduct]] || 1
|-
| [[#Объект ..Request/mergeOperation/batch/productItem|'''productItem''']] || Наименование продукции в номенклатуре производителя. || [[ProductItem|argpr:ProductItem]] || 0..1
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/[[#Объект ..Request/mergeOperation|mergeOperation]]/[[#Объект ..Request/mergeOperation/batch|batch]]/'''subProduct'''===
Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи справочника вида продукции.|| [[UUID|bs:UUID]] || rowspan = "2" | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо GUID.
При указании обоих полей, приоритет у UUID.
|-
| '''GUID''' || Глобальный идентифкатор предприятия в реестр РСХН || [[UUID|bs:UUID]]
|}
 
===Объект [[#Объект mergeStockEntriesRequest|..Request]]/[[#Объект ..Request/mergeOperation|mergeOperation]]/[[#Объект ..Request/mergeOperation/batch|batch]]/'''productItem'''===
Объект содержит сведения о наименовании продукции; четвертый уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''name''' || Наименование продукции в соответствии с номенклатурой производителя. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
==Данные ответа==
<!--- <div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных ответа в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<mergeStockEntriesResponse xmlns="http://api.vetrf.ru/schema/cdm/mercury/applications">
    <merc:stockEntryList xmlns:merc="http://api.vetrf.ru/schema/cdm/mercury/applications">
        <ns8:stockEntry xmlns:ns8="http://api.vetrf.ru/schema/cdm/mercury/vet-document">
            <base:uuid xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                      xmlns:ws="http://api.vetrf.ru/schema/cdm/mercury/ws-definitions"
                      xmlns:base="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</base:uuid>
        </ns8:stockEntry>
    </merc:stockEntryList>
</mergeStockEntriesResponse>
</syntaxhighlight>
</div>
</div> -->
 
 
===Объект mergeStockEntriesResponse===
Объект содержит сведения об объединенной записи складского журнала продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/stockEntryList|'''stockEntryList''']] || Позиция в складском журнале системы Меркурий. Указанная позиция сформирована в результате выполнения операции объединения.  || [[StockEntryList|vetd:StockEntryList]] || 1
|}
 
===Объект [[#Объект mergeStockEntriesResponse|..Response]]/'''stockEntryList'''===
Объект содержит сведения об объединенной записи складского журнала продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/stockEntryList/stockEntry|'''stockEntry''']] || Позиция в складском журнале системы Меркурий, сформирована в результате выполнения операции объединения. Представляет собой идентификатор версии записи (uuid) в ИС Меркурий.
|| [[StockEntry|vetd:StockEntry]] || 3..*
|}
 
===Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/'''stockEntry'''===
Объект содержит сведения о позиции продукции в складском журнале системы Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|| '''UUID''' || Идентификатор записи журнала продукции, которая была сформирована в результате объединения нескольких записей складского журнала.
* При этом поле "status" для объединенной записи содержит код '''110''' - '''CREATED_WHEN_MERGE''' согласно функциональной спецификации по [[Media:Platform_base_requirements_1.1_v2.pdf|базовым компонентам и версионности]].
|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор записи складского журнала продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''active'''|| Является ли запись журнала активной:
* 1 - запись активна;
* 0 - запись не активна.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
|'''last'''|| Последняя версия записи журнала:
* 1 - да;
* 0 - нет.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| '''status'''|| Статус версии записи журнала. || [[VersionStatus|bs:VersionStatus]] || 1
|-
|'''createDate'''|| Дата создания записи журнала. || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|-
|'''updateDate'''|| Дата изменения записи журнала. || [http://www.w3.org/TR/xmlschema-2/#dateTime xs:dateTime] || 1
|-
| '''entryNumber'''|| Номер записи журнала, доступный через веб-интерфейс. || [[StockEntryNumber|vetd:StockEntryNumber]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch|'''batch''']] || Сведения о продукции. || [[Batch|vetd:Batch]] || 1
|}
 
===Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/'''batch'''===
Объект содержит сведения об оформленной входящей партии продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|'''productType'''|| Тип продукции. Первый уровень иерархического справочника продукции РСХН.  || [[productType|argpr:ProductType]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/product|'''product''']]|| Продукция. Второй уровень иерархического справочника продукции РСХН.  || [[Product|argpr:Product]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/subProduct|'''subProduct''']]||Вид продукции. Третий уровень иерархического справочника продукции РСХН.  || [[SubProduct|argpr:SubProduct]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/productItem|'''productItem''']]||Наименование продукции в номенклатуре производителя. || [[ProductItem|argpr:ProductItem]] || 0..1
|-
| '''volume'''|| Оформленный объем входящей продукции.
* Значение должно быть больше нуля. 
|| [[Decimal|bs:Decimal]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/unit|'''unit''']]|| Единица измерения объема входящей партии.|| [[Unit|argc:Unit]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/packingList|'''packingList''']]||  Список упаковок объединённой партии.
* Если в объединение вошли партии с разными упаковками, то в список попадут все. Количество при этом просто суммируется.
|| [http://www.w3.org/TR/xmlschema-2/#int xs:int] || 0..1
|-
| '''packingAmount'''||  Общее количество единиц упаковки входящей партии. || [http://www.w3.org/TR/xmlschema-2/#int xs:int] || 0..1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/subProduct|'''dateOfProduction''']]|| Дата выработки продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate.|| [[GoodsDate|vetd:GoodsDate]] || 1
|-
|'''expiryDate'''|| Дата окончания срока годности продукции. Может быть указана тремя способами: датой, диапазоном дат, строкой. В случае точной даты выработки указывается только первая компонента - firstDate.  || [[GoodsDate|vetd:GoodsDate]] || 1
|-
| '''perishable'''|| Описывает, является ли продукция скоропортящейся:
*  true – скоропортящаяся;
*  false – не скоропортящаяся.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 0..1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/countryOfOrigin |'''countryOfOrigin''']] || Страна происхождения продукции. || [[Country|ikar:Country]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/producerList |'''producerList''']] || Список производителей продукции.|| [[ProducerList|ent:ProducerList]] || 0..1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..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
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''product''' ===
Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''subproduct''' ===
Объект содержит сведения о продукции; третий уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''productItem''' ===
Объект содержит сведения о номенклатуре; четвёртый уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи справочника продукции.|| [[UUID|bs:UUID]] || 0..1
|-
| '''name''' || Наименование номенклатуры производителя. || [[UUID|bs:UUID]] || 1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''unit''' ===
Объект содержит сведения о единицах измерения продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''packingList''' ===
 
Объект содержит список упаковок объединённой партии.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/packingList/packingForm|'''packingForm''']] || Объект содержит информацию об упаковке. || [[PackingForm|argc:PackingForm]] || 1..*
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[#Объект ..Response/stockEntryList/stockEntry/batch/packingList|packingList]]/'''packingForm''' ===
 
Объект содержит информацию о конкретном виде упаковки.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''UUID''' || Уникальный идентификатор версии записи об упаковке в реестре Россельхознадзора. || [[UUID|bs:UUID]] || 1
|-
| '''name''' || Название упаковки. || [[String255|bs:String255]] || 1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''dateOfProduction''' ===
 
Объект содержит информацию о интервале дат выработки продукции.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/stockEntryList/stockEntry/dateOfProduction/firstDate|'''firstDate''']] || Начальное значение интервала выработки|| [[ComplexDate|bs:ComplexDate]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/dateOfProduction/secondDate|'''secondDate''']] || Конечное значение интервала выработки|| [[complexDate|bs:ComplexDate]] || 0..1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[#Объект ..Response/stockEntryList/stockEntry/batch/dateOfProduction|dateOfProduction]]/'''firstDate'''===
 
Объект содержит информацию о начале интервала даты выработки
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''year''' || Год || [[Year|bs:Year]] || 0..1
|-
| '''month''' || Месяц || [[Month|bs:Month]] || 0..1
|-
| '''day''' || День || [[Day|bs:Day]] || 0..1
|-
| '''hour''' || Час || [[Hour|bs:Hour]] || 0..1
|}
 
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[#Объект ..Response/stockEntryList/stockEntry/batch/dateOfProduction|dateOfProduction]]/'''secondDate'''===
 
Объект содержит информацию о конечной дате интервала даты выработки
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип данных !! Обязательность
|-
| '''year''' || Год || [[Year|bs:Year]] || 0..1
|-
| '''month''' || Месяц || [[Month|bs:Month]] || 0..1
|-
| '''day''' || День || [[Day|bs:Day]] || 0..1
|-
| '''hour''' || Час || [[Hour|bs:Hour]] || 0..1
|}
 
=== Объект [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''countryOfOrigin''' ===
Объект содержит сведения о стране происхождения продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор записи справочника продукции.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект  [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''producerList''' ===
Объект содержит сведения о списке производителей продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer|'''producer''' ]] || Производитель продукции.|| [[Producer|ent:Producer]] || 1..*
|}
 
=== Объект  [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[#Объект ..Response/stockEntryList/stockEntry/batch/producerList|producerList]]/'''producer''' ===
 
Объект содержит сведения о производителе продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer/enterprise |'''enterprise''']] || Информация о предприятие-производителе продукции.|| [[Enterprise|ent:Enterprise]] || 1
|-
| '''role'''||Роль предприятия-производителя продукции.|| [[EnterpriseRole|ent:EnterpriseRole]] || 1
|}
 
=== Объект  [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/[[#Объект ..Response/stockEntryList/stockEntry/batch/producerList|producerList]]/[[#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer|producer]]/'''enterprise''' ===
 
Объект содержит сведение о предприятии-производителе продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии предприятия-производителя продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор предприятия-производителя продукции.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект  [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''productMarkingList'''===
 
Объект содержит сведения о списке маркировки.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''productMarking''' || Строка с маркировкой продукции. || [[String255|bs:String255]] || 1
|}
 
=== Объект  [[#Объект mergeStockEntriesResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''owner'''===
 
Объект содержит сведения о хозяйствующем субъекте-владельце продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|}
 
==Пример запроса==
 
<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:bs="http://api.vetrf.ru/schema/cdm/base"
                  xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common"
                  xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment"
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <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-13T00:00:00.000+04:00</app:issueDate>
            <app:data>
              <mercvu:mergeStockEntriesRequest>
                  <mercvu:localTransactionId>a1</mercvu:localTransactionId>
                  <mercvu:initiator>
                    <com:login>login</com:login>
                  </mercvu:initiator>
                  <mercvu:businessEntity>
                      <bs:guid>72c7e8cd-0583-45e2-99db-801f5939587e</bs:guid>
                  </mercvu:businessEntity>
                  <mercvu:enterprise>
                      <bs:guid>7465a13c-4cc9-4dc8-bc99-460d9b1dbc4e</bs:guid>
                  </mercvu:enterprise>
                  <mercvu:mergeOperation>
                    <vet:sourceStockEntry>
                        <bs:uuid>558dcbe2-f00a-4d4e-b064-3e778d76d510</bs:uuid>
                    </vet:sourceStockEntry>
                    <vet:sourceStockEntry>
                        <bs:uuid>e7a0f0f7-6c50-412c-a1cc-e0e1b6162b50</bs:uuid>
                    </vet:sourceStockEntry>
                    <vet:batch>
                        <vet:subProduct>
                          <bs:uuid>eb9d639e-45f2-2702-4a19-a8cbffec6626</bs:uuid>
                        </vet:subProduct>
                        <vet:productItem>
                          <prod:name>фарш свиной</prod:name>
                        </vet:productItem>
                    </vet:batch>
                  </mercvu:mergeOperation>
              </mercvu:mergeStockEntriesRequest>
            </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 = "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: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:shp="http://api.vetrf.ru/schema/cdm/argus/shipment"
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise"
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <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-06-18T00:00:00.000+04:00</app:issueDate>
            <app:data>
              <merc:mergeStockEntriesRequest>
                  <merc:localTransactionId>a1</merc:localTransactionId>
                  <merc:initiator>
                    <com:login>user</com:login>
                  </merc:initiator>
                  <merc:enterprise>
                    <base:guid>e4418e90-8e42-447c-91ed-b1fc8d2d12ea</base:guid>
                  </merc:enterprise>
                  <merc:mergeOperation>
                    <vet:sourceStockEntry>
                        <base:uuid>c0fcfedd-5d90-4754-a701-29acb5984520</base:uuid>
                    </vet:sourceStockEntry>
                    <vet:sourceStockEntry>
                        <base:uuid>c4b7dc3e-9a98-4fb2-8705-d785caa7ca1d</base:uuid>
                    </vet:sourceStockEntry>
                    <vet:batch>
                        <vet:subProduct>
                          <base:uuid>85bc61ca-49dc-2857-8589-8e7dd8c4ec4f</base:uuid>
                        </vet:subProduct>
                        <vet:productItem>
                          <prod:name>Конина охлаждённая</prod:name>
                        </vet:productItem>
                    </vet:batch>
                  </merc:mergeOperation>
              </merc:mergeStockEntriesRequest>
            </app:data>
        </app:application>
      </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
 
==Коды ошибок==
{| class="wikitable"
|-
!Код!! Описание ошибки
|-
|MERC17001||Объединять записи складского журнала может только их собственник.
|-
|MERC17002||В запросе отсутствуют сведения о хозяйствующем субъекте, ответственном за выполнение операции.
|-
|MERC17003||Отсутствует идентификатор (GUID) хозяйствующего субъекта, ответственного за выполнение операции.
|-
|MERC17004||В запросе для хозяйствующого субъекта ответственного за выполнение операции указан идентификатор устаревшей версии записи реестра РСХН.
|-
|MERC17005||Хозяйствующий субъект, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
|MERC17008||Запись складского журнала продукции с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
|MERC17009||В запросе для записи складского журнала продукции указан идентификатор (UUID) устаревшей версии записи реестра РСХН.
|-
|MERC17012||Цель с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
|MERC17013||В запросе для цели указан идентификатор устаревшей версии записи реестра РСХН.
|-
|MERC17018||Вид продукции с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
|MERC17019||В запросе для вида продукции указан идентификатор (UUID) устаревшей версии записи реестра РСХН.
|-
|MERC17034||Вид продукции в сведениях об объединенной записи складского журнала не совместим с продукцией из объединяемых записей складского журнала.
|-
|MERC17097 ||Вид продукции для записи складского журнала обязателен для заполнения.
|-
|MERC17098||Наименование продукции для записи складского журнала обязательно для заполнения.
|-
|MERC17099||Наименование продукции для записи складского журнала превышает допустимую длину текста.
|-
|MERC17100||Примечание для записи складского журнала превышает допустимую длину текста.
|-
|MERC17141||Объединяемые записи складского журнала не должны являться шаблонами.
|-
|MERC17142||Объединяемые записи складского журнала должны быть в состоянии "создана" (т.е. не аннулированы).
|-
|MERC17143||Объединяемые записи складского журнала должны быть в состоянии "создана" (т.е. не оформлены).
|-
|MERC17227 ||Обслуживающее предприятие должно совпадать для объединяемых записей складского журнала.
|-
|MERC17228||Собственник продукции должен совпадать для объединяемых записей складского журнала.
|-
|MERC17230||Продукция должна совпадать для объединяемых записей складского журнала.
|-
|MERC17233||Единица измерения должна быть совместимой для объединяемых записей складского журнала.
|-
|MERC17247 ||Пометка скоропортящейся продукции должна совпадать для объединяемых записей складского журнала.
|-
|MERC17248||Пометка некачественного груза должна совпадать для объединяемых записей складского журнала.
|-
|MERC17249||Страна происхождения продукции должна совпадать для объединяемых записей складского журнала.
|-
|MERC17274||В запросе отсутствуют сведения об объединенной записи складского журнала продукции.
|-
|MERC17275||Идентификатор записи складского журнала продукции (UUID) обязателен для заполнения.
|-
|MERC17276||Количество объединяемых записей складского журнала не должно быть меньше 2.
|-
|MERC17277||Объединяемые записи складского журнала должны быть по входной продукции.
|-
|MERC17278||Объединяемые записи складского журнала не должны содержать живых животных и другой вид продукции одновременно.
|-
|MERC17279||Объединяемые записи складского журнала не должны быть созданны в разных модулях.
|-
|MERC17280||Объединяемые записи складского журнала не должны частично состоять из заявок.
|-
|MERC17281||Цель в сведениях об объединенной записи складского журнала должна совпадать с одной из целей из объединяемых записей складского журнала.
|-
|MERC17282||Объединяемые записи складского журнала не должны содержать повторяющиеся записи.
|}
 
[[#top|Вернуться к началу &uarr;]]
[[Category:Ветис.API]]
[[Category:Объединение_записей_складского_журнала]]
[[Category:Ветис.API для ветеринарных управлений]]

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

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

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

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

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

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

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

При выполнении операции MergeOperation возможны следующие сценарии:

  1. Происходит объединение нескольких записей складского журнала продукции в одну, при этом в журнал входной продукции добавляется новая позиция с общим объемом и периодом дат выработки и срока годности.
  2. Происходит присоединение записей к первой по списку. В этом случае результирующая запись журнала будет иметь наименование продукции, то же наименование продукции, что и главная. Объём и количество упаковок будет просуммировано, вид упаковки, номера партий логически объединены в список.
  3. Произошла ошибка при обработке запроса.
  • Некорректный запрос.
  • Запрос не прошёл проверку на бизнес-правила.
  • Внутренняя ошибка системы.

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

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

Различающиеся параметры Версия для хозяйствующих субъектов Версия для ветеринарных управлений
Пространство имён 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

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

Объект mergeStockEntriesRequest

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

Поле Описание Тип Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. argc:User 1
businessEntity Хозяйствующий субъект, для предприятия которого выполняется операция объединения записей.
  • Обязательно указывать при оформлении запросов от ветеринарного управления. Для хозяйствующих субъектов достаточно указать enterprise.
 ent:BusinessEntity 0..1
enterprise Предприятие, на котором выполняется операция объединения записей. ent:Enterprise 1
mergeOperation Сведения, необходимые для объединения нескольких записей журнала. vetd:MergeStockEntriesOperation 1

Объект ..Request/initiator

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

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

Объект ..Request/businessEntity

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

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

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор хозяйствующего субъекта. bs:UUID

Объект ..Request/enterprise

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

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

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентификатор предприятия в реестре РСХН. bs:UUID

Объект ..Request/mergeOperation

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

Поле Описание Тип Обязательность
sourceStockEntry Позиции в складском журнале системы Меркурий, не менее двух. Указанные позиции будут объединены в одну. Представляют собой идентификатор версии записи (uuid) в ИС Меркурий.
  • Указанная версия записи складского журнала продукции в ИС Меркурий должна быть актуальной, неаннулированной и неудалённой.
  • Объединяемые записи журнала должны быть в статусе "создана" или "отправлена".
  • Объединяемые записи журнала должны быть в журнале входной продукции, для вырабатываемой продукции функция объединения отсутствует.
  • Хозяйствующий субъект - владелец продукции в объединяемых записях должен совпадать.
  • Объединяемые записи журнала продукции должны относится к одному типу продукции (первый уровень справочника продукции).
  • Объединяемые записи журнала продукции должны относится к одной продукции (второй уровень справочника продукции).
  • В объединяемых записях журнала продукции указанная ед. измерения должна относится к одной группе единиц измерения.
  • Объединяемые записи журнала продукции должны относится к одной стране происхождения.
  • Запрещено объединение записи журнала входной и вырабатываемой продукции.
  • Запрещено объединение записей журнала относящихся к скоропортящейся и не скоропортящейся продукции.
  • Запрещено объединение записей журнала относящихся к качественной и некачественной продукции;
 vetd:StockEntry 2..*
batch Сведения, которые будут содержаться в объединенной записи журнала. Содержит информацию о виде продукции и его наименовании для объединенной записи. vetd:Batch 0..1

Объект ..Request/mergeOperation/sourceStockEntry

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

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

Объект ..Request/mergeOperation/batch

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

Поле Описание Тип Обязательность
subProduct Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.
  • Соответствующая версия вида продукции в ИС Меркурий должна быть актуальной и неудалённой.
  • Вид продукции должен относится к той же продукции (второй уровень справочника продукции), что и в объединяемых записях складского журнала.
 argpr:SubProduct 1
productItem Наименование продукции в номенклатуре производителя. argpr:ProductItem 0..1

Объект ..Request/mergeOperation/batch/subProduct

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

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

При указании обоих полей, приоритет у UUID.

GUID Глобальный идентифкатор предприятия в реестр РСХН bs:UUID

Объект ..Request/mergeOperation/batch/productItem

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

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

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

Объект mergeStockEntriesResponse

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

Поле Описание Тип Обязательность
stockEntryList Позиция в складском журнале системы Меркурий. Указанная позиция сформирована в результате выполнения операции объединения. vetd:StockEntryList 1

Объект ..Response/stockEntryList

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

Поле Описание Тип Обязательность
stockEntry Позиция в складском журнале системы Меркурий, сформирована в результате выполнения операции объединения. Представляет собой идентификатор версии записи (uuid) в ИС Меркурий. vetd:StockEntry 3..*

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

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

Поле Описание Тип Обязательность
UUID Идентификатор записи журнала продукции, которая была сформирована в результате объединения нескольких записей складского журнала. bs:UUID 1
GUID Глобальный идентификатор записи складского журнала продукции. bs:UUID 1
active Является ли запись журнала активной:
  • 1 - запись активна;
  • 0 - запись не активна.
 xs:boolean 1
last Последняя версия записи журнала:
  • 1 - да;
  • 0 - нет.
 xs:boolean 1
status Статус версии записи журнала. bs:VersionStatus 1
createDate Дата создания записи журнала. xs:dateTime 1
updateDate Дата изменения записи журнала. xs:dateTime 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 0..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

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

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

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

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

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

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

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

Поле Описание Тип данных Обязательность
packingForm Объект содержит информацию об упаковке. argc:PackingForm 1..*

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

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

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

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

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

Поле Описание Тип Обязательность
firstDate Начальное значение интервала выработки bs:ComplexDate 1
secondDate Конечное значение интервала выработки bs:ComplexDate 0..1

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

Объект содержит информацию о начале интервала даты выработки

Поле Описание Тип данных Обязательность
year Год bs:Year 0..1
month Месяц bs:Month 0..1
day День bs:Day 0..1
hour Час bs:Hour 0..1


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

Объект содержит информацию о конечной дате интервала даты выработки

Поле Описание Тип данных Обязательность
year Год bs:Year 0..1
month Месяц bs:Month 0..1
day День bs:Day 0..1
hour Час bs:Hour 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 1

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

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

Поле Описание Тип Обязательность
UUID Идентификатор версии хозяйствующего субъекта - владельца продукции. bs:UUID 1
GUID Глобальный идентификатор хозяйствующего субъекта - владельца продукции. 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:bs="http://api.vetrf.ru/schema/cdm/base" 
                  xmlns:com="http://api.vetrf.ru/schema/cdm/argus/common" 
                  xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment" 
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document" 
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise" 
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production" 
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <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-13T00:00:00.000+04:00</app:issueDate>
            <app:data>
               <mercvu:mergeStockEntriesRequest>
                  <mercvu:localTransactionId>a1</mercvu:localTransactionId>
                  <mercvu:initiator>
                     <com:login>login</com:login>
                  </mercvu:initiator>
                  <mercvu:businessEntity>
                      <bs:guid>72c7e8cd-0583-45e2-99db-801f5939587e</bs:guid>
                  </mercvu:businessEntity>
                  <mercvu:enterprise>
                      <bs:guid>7465a13c-4cc9-4dc8-bc99-460d9b1dbc4e</bs:guid>
                  </mercvu:enterprise>
                  <mercvu:mergeOperation>
                     <vet:sourceStockEntry>
                        <bs:uuid>558dcbe2-f00a-4d4e-b064-3e778d76d510</bs:uuid>
                     </vet:sourceStockEntry>
                     <vet:sourceStockEntry>
                        <bs:uuid>e7a0f0f7-6c50-412c-a1cc-e0e1b6162b50</bs:uuid>
                     </vet:sourceStockEntry> 
                     <vet:batch>
                        <vet:subProduct>
                           <bs:uuid>eb9d639e-45f2-2702-4a19-a8cbffec6626</bs:uuid>
                        </vet:subProduct>
                        <vet:productItem>
                           <prod:name>фарш свиной</prod:name>
                        </vet:productItem>
                     </vet:batch> 
                  </mercvu:mergeOperation>
               </mercvu:mergeStockEntriesRequest>
            </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:shp="http://api.vetrf.ru/schema/cdm/argus/shipment" 
                  xmlns:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document" 
                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise" 
                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production" 
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <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-06-18T00:00:00.000+04:00</app:issueDate>
            <app:data>
               <merc:mergeStockEntriesRequest>
                  <merc:localTransactionId>a1</merc:localTransactionId>
                  <merc:initiator>
                     <com:login>user</com:login>
                  </merc:initiator>
                  <merc:enterprise>
                     <base:guid>e4418e90-8e42-447c-91ed-b1fc8d2d12ea</base:guid>
                  </merc:enterprise>
                  <merc:mergeOperation>
                     <vet:sourceStockEntry>
                        <base:uuid>c0fcfedd-5d90-4754-a701-29acb5984520</base:uuid>
                     </vet:sourceStockEntry>
                     <vet:sourceStockEntry>
                        <base:uuid>c4b7dc3e-9a98-4fb2-8705-d785caa7ca1d</base:uuid>
                     </vet:sourceStockEntry> 
                     <vet:batch>
                        <vet:subProduct>
                           <base:uuid>85bc61ca-49dc-2857-8589-8e7dd8c4ec4f</base:uuid>
                        </vet:subProduct>
                        <vet:productItem>
                           <prod:name>Конина охлаждённая</prod:name>
                        </vet:productItem>
                     </vet:batch> 
                  </merc:mergeOperation>
               </merc:mergeStockEntriesRequest>
            </app:data>
         </app:application>
      </ws:submitApplicationRequest>
   </soapenv:Body>
</soapenv:Envelope>

Коды ошибок

Код Описание ошибки
MERC17001 Объединять записи складского журнала может только их собственник.
MERC17002 В запросе отсутствуют сведения о хозяйствующем субъекте, ответственном за выполнение операции.
MERC17003 Отсутствует идентификатор (GUID) хозяйствующего субъекта, ответственного за выполнение операции.
MERC17004 В запросе для хозяйствующого субъекта ответственного за выполнение операции указан идентификатор устаревшей версии записи реестра РСХН.
MERC17005 Хозяйствующий субъект, ответственный за выполнение операции, с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC17008 Запись складского журнала продукции с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC17009 В запросе для записи складского журнала продукции указан идентификатор (UUID) устаревшей версии записи реестра РСХН.
MERC17012 Цель с указанным идентификатором не найдена в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC17013 В запросе для цели указан идентификатор устаревшей версии записи реестра РСХН.
MERC17018 Вид продукции с указанным идентификатором не найден в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC17019 В запросе для вида продукции указан идентификатор (UUID) устаревшей версии записи реестра РСХН.
MERC17034 Вид продукции в сведениях об объединенной записи складского журнала не совместим с продукцией из объединяемых записей складского журнала.
MERC17097 Вид продукции для записи складского журнала обязателен для заполнения.
MERC17098 Наименование продукции для записи складского журнала обязательно для заполнения.
MERC17099 Наименование продукции для записи складского журнала превышает допустимую длину текста.
MERC17100 Примечание для записи складского журнала превышает допустимую длину текста.
MERC17141 Объединяемые записи складского журнала не должны являться шаблонами.
MERC17142 Объединяемые записи складского журнала должны быть в состоянии "создана" (т.е. не аннулированы).
MERC17143 Объединяемые записи складского журнала должны быть в состоянии "создана" (т.е. не оформлены).
MERC17227 Обслуживающее предприятие должно совпадать для объединяемых записей складского журнала.
MERC17228 Собственник продукции должен совпадать для объединяемых записей складского журнала.
MERC17230 Продукция должна совпадать для объединяемых записей складского журнала.
MERC17233 Единица измерения должна быть совместимой для объединяемых записей складского журнала.
MERC17247 Пометка скоропортящейся продукции должна совпадать для объединяемых записей складского журнала.
MERC17248 Пометка некачественного груза должна совпадать для объединяемых записей складского журнала.
MERC17249 Страна происхождения продукции должна совпадать для объединяемых записей складского журнала.
MERC17274 В запросе отсутствуют сведения об объединенной записи складского журнала продукции.
MERC17275 Идентификатор записи складского журнала продукции (UUID) обязателен для заполнения.
MERC17276 Количество объединяемых записей складского журнала не должно быть меньше 2.
MERC17277 Объединяемые записи складского журнала должны быть по входной продукции.
MERC17278 Объединяемые записи складского журнала не должны содержать живых животных и другой вид продукции одновременно.
MERC17279 Объединяемые записи складского журнала не должны быть созданны в разных модулях.
MERC17280 Объединяемые записи складского журнала не должны частично состоять из заявок.
MERC17281 Цель в сведениях об объединенной записи складского журнала должна совпадать с одной из целей из объединяемых записей складского журнала.
MERC17282 Объединяемые записи складского журнала не должны содержать повторяющиеся записи.

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

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