MergeOperationForVetControl

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

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

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

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

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

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

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

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

• Некорректный запрос.
• Запрос не прошёл проверку на бизнес-правила.
• Внутренняя ошибка системы.

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

vetd (http://api.vetrf.ru/schema/cdm/mercury/vet-document) vetd:Batch vetd:MergeStockEntriesOperation vetd:StockEntry vetd:StockEntryList vetd:StockeEntryNumber

bs (http://api.vetrf.ru/schema/cdm/base) bs:UUID argpr (http://api.vetrf.ru/schema/cdm/argus/production) argpr:SubProduct argpr:ProductItem

argc (http://api.vetrf.ru/schema/cdm/argus/common) argc:User xs (http://www.w3.org/2001/XMLSchema) xs:NCName xs:string

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

Объект mergeStockEntriesRequest

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

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

Объект ..Request/initiator

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

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

Объект ..Request/businessEntity

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

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

Объект ..Request/enterprise

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

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

Объект ..Request/mergeOperation

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Объект mergeStockEntriesResponse

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

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

Объект ..Response/stockEntryList

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

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

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

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

Поле	Описание	Тип	Обязательность
UUID	Идентификатор записи журнала продукции, которая была сформирована в результате объединения нескольких записей складского журнала. При этом поле "status" для объединенной записи содержит код 110 - CREATED_WHEN_MERGE согласно функциональной спецификации по базовым компонентам и версионности.	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: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: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	Объединяемые записи складского журнала не должны содержать повторяющиеся записи.

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