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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Egorova-iv-150707 переименовал страницу GetStockEntryChangesListOperation в GetStockEntryChangesListOperation v1.2)
 
Строка 1: Строка 1:
#перенаправление [[GetStockEntryChangesListOperation v1.2]]
== Общие сведения ==
Операция '''GetStockEntryChangesListOperation''' предназначена для получения списка версий записей складского журнала, созданных или измененных за указанный интервал дат (получение истории изменений).
 
Складской журнал продукции в системе Меркурий ведется с применением версионирования, это означает, что при каждом изменении записи складского журнала создается новая версия этой записи.
* GUID - глобальный идентификатор записи складского журнала. Данный идентификатор остается неизменным для всех версий записи складского журнала.
* UUID - идентификатор версии записи складского журнала. Данный идентификатор изменяется для каждой новой версии записи складского журнала.
Так же следует различать актуальную и неактуальную версию записи складского журнала. Для одной записи журнала может существовать только одна актуальная версия.
 
При выполнении операции '''GetStockEntryChangesListOperation''' на вход системы передаются следующие сведения:
* информация о пользователе - инициаторе запроса;
* информация о предприятии, на котором осуществляется поиск записей складского журнала;
* временной интервал, за который будет осуществляться поиск записей складского журнала.
Результатом выполнения данной операции является:
* пользователю передаются сведения о всех версиях записей складского журнала, созданных или измененных за указанный промежуток времени.
 
Запрашиваться могут только те записи складского журнала продукции, которые обслуживает ветеринарное управление.
 
=== Возможные сценарии ===
При обработке запроса возможны следующие сценарии:
# Запрос успешно обработан.<br />
# Произошла ошибка при обработке запроса.
::* Некорректный запрос.
::* Внутренняя ошибка системы.
 
===Используемые пространства имён и типы===
{{столбцы}}
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/common|argc]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/common</nowiki>)
** [[PackingFormList|argc:PackingFormList]]
** [[Unit|argc:Unit]]
** [[User|argc:User]]
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/production|argpr]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/production</nowiki>)
** [[Product|argpr:Product]]
** [[ProductItem|argpr:ProductItem]]
** [[ProductType|argpr:ProductType]]
** [[SubProduct|argpr:SubProduct]]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/base|bs]] (<nowiki>http://api.vetrf.ru/schema/cdm/base</nowiki>)
** [[Decimal|bs:Decimal]]
** [[String255|bs:String255]]
** [[UUID|bs:UUID]]
** [[VersionStatus|bs:VersionStatus]]
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/cerberus/enterprise|ent]] (<nowiki>http://api.vetrf.ru/schema/cdm/cerberus/enterprise</nowiki>)
** [[BusinessEntity|ent:BusinessEntity]]
** [[Enterprise|ent:Enterprise]]
** [[EnterpriseRole|ent:EnterpriseRole]]
** [[ProducerList|ent:ProducerList]]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/ikar|ikar]] (<nowiki>http://api.vetrf.ru/schema/cdm/ikar</nowiki>)
** [[Country|ikar:Country]]
* [[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]]
** [[GoodsDate|vetd:GoodsDate]]
** [[PackingForm|vetd:PackingForm]]
** [[ProductMarkingList|vetd:ProductMarkingList]]
** [[Producer|vetd:Producer]]
** [[VetDocument|vetd:VetDocument]]
** [[StockEntry|vetd:StockEntry]]
** [[StockEntryNumber|vetd:StockEntryNumber]]
{{столбец}}
* [[NameSpaces#http://www.w3.org/2001/XMLSchema|xs]] (<nowiki>http://www.w3.org/2001/XMLSchema</nowiki>)
** [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean]
** [http://www.w3.org/TR/xmlschema-2/#dateTime xs:date]
**  [http://www.w3.org/TR/xmlschema-2/#int xs:int]
** [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
** [http://www.w3.org/TR/xmlschema-2/#string xs:string]
{{столбцы/конец}}
 
== Данные запроса ==
<!--
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных запроса в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<mercvu:getStockEntryChangesListRequest 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">                     
    <mercvu:localTransactionId>{xs:NCName}</mercvu:localTransactionId>
    <mercvu:initiator>
        <com:login>{xs:NCName}</com:login>
    </mercvu:initiator>
    <base:listOptions>
        <base:count>{xs:nonNegativeInteger}</base:count>
        <base:offset>{xs:nonNegativeInteger}</base:offset>
    </base:listOptions>                       
    <base:updateDateInterval>
        <base:beginDate>{xs:dateTime}</base:beginDate>
        <base:endDate>{xs:dateTime}</base:endDate>
    </base:updateDateInterval>
    <ent:businessMember>
      <ent:businessEntity>
          <base:guid>{bs:UUID}</base:guid>
      </ent:businessEntity>
        <ent:enterprise>
          <base:guid>{bs:UUID}</base:guid>
      </ent:enterprise>
    </ent:businessMember>
</merc:getStockEntryChangesListRequest>
</syntaxhighlight>
</div>
</div>
-->
===Объект getStockEntryChangesListRequest===
Корневой элемент содержимого заявки на получение списка версий записей складского журнала, созданных или измененных за указанный интервал дат.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''localTransactionId''' || Идентификатор заявки в клиентской системе. || [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 1
|-
| [[#Объект ..Request/initiator|'''initiator''']] || Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. || [[User|argc:User]] || 1
|-
| [[#Объект ..Request/listOptions|'''listOptions''']] || Параметры запрашиваемого списка. || [[ListOptions|bs:ListOptions]] || 0..1
|-
| [[#Объект ..Request/updateDateInterval|'''updateDateInterval''']]|| Интервал времени обновления. В список попадают все записи складского журнала, дата обновлений которых попадает в указанный интервал.  || [[DataInterval|bs:DataInterval]] || 1
|-
| [[#Объект ..Request/businessMember|'''businessMember''']] || Предприятие, по которому производится поиск записей. || [[BusinessMember|ent:BusinessMember]] || 0..1
|}
 
=== Объект [[#Объект getStockEntryChangesListRequest|..Request]]/'''initiator''' ===
Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID'''
| Идентификатор пользователя, зарегистрированного в системе Меркурий.
| [[UUID|bs:UUID]]
| rowspan=2 | 1 - обязательно должно быть заполнено хотя бы одно из полей, либо UUID, либо login.<br>
При указании обоих полей, приоритет у UUID.
|-
| '''login'''
| Логин пользователя.
| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|}
 
=== Объект [[#Объект getStockEntryChangesListRequest|..Request]]/'''listOptions'''===
Объект содержит сведения о параметрах запрашиваемого списка записей складского журнала.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''count''' || Максимальное запрашиваемое количество объектов в списке.
* По умолчанию значение 100;
* Максимально возможное значение 1000.
||[http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger] || 0..1
|-
| '''offset''' || Номер элемента, по которому осуществляется смещение первого элемента списка.
* По умолчанию значение 0.
|| [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]  || 0..1
|}
 
=== Объект [[#Объект getStockEntryChangesListRequest|..Request]]/'''updateDateInterval'''===
Объект содержит сведения об интервале времени, за который необходимо получить обновления.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''beginDate''' || Дата, начиная с которой пользователь получит историю изменений записей складского журнала, на указанном предприятии. || [[dataInterval|bs:DataInterval]] || 1
|-
| '''endDate''' || Конец временного интервала.
* В случае, если компонента endDate не указана, то используется текущая дата.
|| [[dataInterval|bs:DataInterval]] || 0..1
|}
 
=== Объект [[#Объект getStockEntryChangesListRequest|..Request]]/'''businessMember'''===
Объект содержит сведения о параметрах запрашиваемого списка записей складского журнала.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Request/businessMember/businessEntity|'''businessEntity''']] || Хозяйствующий субъект, для которого производится поиск записей складского журнала || [[BusinessEntity|ent:BusinessEntity]] || 0..1
|-
| [[#Объект ..Request/businessMember/enterprise|'''enterprise''']] || Предприятие, для которого осуществляется отбор записей складского журнала || [[Enterprise|ent:Enterprise]]  || 0..1
|}
 
=== Объект [[#Объект getStockEntryChangesListRequest|..Request]]/[[#Объект ..Request/businessMember|businessMember]]/'''businessEntity'''===
 
Объект описывает хозяйствующий субъект, для которого производится отбор записей складского журнала. Требуется только при запросе [[Различия_в_запросах_от_хозяйствующих_субъектов_и_ветеринарных_управлений#GetVetDocumentChangesListOperation|от имени ветеринарного управления]]. При запросе от имени хозяйствующего субъекта достаточно enterpriseGuid.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи хозяйствующего субъекта || [[UUID|bs:UUID]] || rowspan="2" | 1 - обязательно указать один из идентификаторов. В случае, если указаны оба, приоритет за UUID.
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта в реестре РСХН || [[UUID|bs:UUID]]
|}
 
=== Объект [[getStockEntryChangesListOperationForVetControl#Объект getStockEntryChangesListRequest|..Request]]/[[#Объект ..Request/businessMember|businessMember]]/'''enterprise'''===
 
Объект описывает предприятие, для которого производится отбор записей складского журнала.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи предприятия || [[UUID|bs:UUID]] || rowspan="2" | 1 - обязательно указать один из идентификаторов. В случае, если указаны оба, приоритет за UUID.
|-
| '''GUID''' || Глобальный идентификатор предприятия в реестре РСХН || [[UUID|bs:UUID]]
|}
 
==Данные ответа==
<!--
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных ответа в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<mercvu:getStockEntryChangesListResponse xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/applications"
                                  xmlns:vetd="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                                  xmlns:bs="http://api.vetrf.ru/schema/cdm/base"
                                  xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production"
                                  xmlns:argc="http://api.vetrf.ru/schema/cdm/argus/common"
                                  xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
    <vetd:stockEntryList>
        <vetd:stockEntry >
            <bs:uuid>{bs:UUID}</bs:uuid>
            <bs:guid>{bs:UUID}</bs:guid>
            <bs:active>{xs:boolean}</bs:active>
            <bs:last>{xs:boolean}</bs:last>
            <bs:status>{bs:VersionStatus}</bs:status>
            <bs:createDate>{xs:dateTime}</bs:createDate>
            <bs:updateDate>{xs:dateTime}</bs:updateDate>
            <bs:previous>{bs:UUID}</bs:previous>
            <bs:next>{bs:UUID}</bs:next>
            <vetd:batch>
                <vetd:productType>{argpr:ProductType}</vetd:productType>
                <vetd:product>
                    <bs:uuid>{bs:UUID}</bs:uuid>
                    <bs:guid>{bs:UUID}</bs:guid>
                </vetd:product>
                <vetd:subProduct>
                    <bs:uuid>{bs:UUID}</bs:uuid>
                    <bs:guid>{bs:UUID}</bs:guid>
                </vetd:subProduct>
                <vetd:productItem>
                    <prod:name >{bs:String255}</prod:name>
                </vetd:productItem>
                <vetd:volume>{bs:Decimal}</vetd:volume>
                <vetd:unit>
                    <bs:uuid>{bs:UUID}</bs:uuid>
                    <bs:guid>{bs:UUID}</bs:guid>
                </vetd:unit>
                <vetd:packingList>
                    <argc:packingForm >
                        <bs:uuid>{bs:UUID}</bs:uuid>
                        <argc:name>{bs:String255}</argc:name>
                    </argc:packingForm>
                </vetd:packingList>
                <vetd:packingAmount>{xs:int}</vetd:packingAmount>
                <vetd:dateOfProduction>
                    <vetd:firstDate>
                        <bs:year>{bs:Year}</bs:year>
                        <bs:month>{bs:Month}</bs:month>
                        <bs:day>{bs:Day}</bs:day>
                    </vetd:firstDate>
                </vetd:dateOfProduction>
                <vetd:expiryDate>
                    <vetd:firstDate>
                        <bs:year>{bs:Year}</bs:year>
                        <bs:month>{bs:Month}</bs:month>
                        <bs:day>{bs:Day}</bs:day>
                    </vetd:firstDate>
                </vetd:expiryDate>
                <vetd:perishable>{xs:boolean}</vetd:perishable>
                <vetd:countryOfOrigin>
                    <bs:uuid>{bs:UUID}</bs:uuid>
                    <bs:guid>{bs:UUID}</bs:guid>
                </vetd:countryOfOrigin>
                <vetd:producerList>
                    <ent:producer>
                        <ent:enterprise>
                            <bs:uuid>{bs:UUID}</bs:uuid>
                            <bs:guid>{bs:UUID}</bs:guid>
                        </ent:enterprise>
                        <ent:role>{ent:EnterpriseRole}</ent:role>
                    </ent:producer>
                </vetd:producerList>
                <vetd:productMarkingList>
                    <vetd:productMarking>{bs:String255}</vetd:productMarking>
                </vetd:productMarkingList>
                <vetd:lowGradeCargo>{xs:boolean}</vetd:lowGradeCargo>
                <vetd:owner>
                    <bs:uuid>{bs:UUID}</bs:uuid>
                    <bs:guid>{bs:UUID}</bs:guid>
                </vetd:owner>
            </vetd:batch>
        </vetd:stockEntry>
    </vetd:stockEntryList>
</mercvu:getStockEntryChangesListResponse>
</syntaxhighlight>
</div>
</div>
-->
===Объект GetStockEntryChangesListResponse===
Объект содержит сведения о результатах обработки запроса на получение истории изменений записей складского журнала.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|[[#Объект ..Response/stockEntryList |'''stockEntryList''']]|| Список записей складского журнала продукции.|| [[StockEntry|vetd:StockEntry]] || 1
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/'''stockEntryList'''===
Объект содержит сведения о списке записей складского журнала продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|[[#Объект ..Response/stockEntryList/stockEntry |'''stockEntry''']]|| Запись складского журнала продукции.|| [[StockEntry|vetd:StockEntry]] || 0..*
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/'''stockEntry''' ===
Объект содержит сведения о записи складского журнала продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|'''UUID'''|| Идентификатор версии записи  журнала.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID'''|| Глобальный идентификатор записи журнала. || [[UUID|bs:UUID]] || 1
|-
| '''active'''|| Является ли запись журнала активной:
* true - запись активна;
* false - запись не активна.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
|'''last'''|| Последняя версия записи журнала:
* true - да;
* false - нет.
|| [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
|-
|'''previous'''|| Идентификатор предыдущей версии записи журнала. || [[UUID|bs:UUID]]  || 0..1
|-
|'''next'''|| Идентификатор следующей версии записи журнала. || [[UUID|bs:UUID]]  || 0..1
|-
|'''entryNumber''' || Номер записи в складском журнале Меркурия
* Именно этот номер отображается в веб-интерфейсе в журнале складской продукции.
|| [[StockEntryNumber|vetd:StockEntryNumber]]  || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch|'''batch''']]|| Сведения о партии продукции.  || [[Batch|vetd:Batch]] || 1
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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''']]|| Единица измерения объема партии продукции. || [[Unitl|argc:Unit]] || 1
|-
|[[#Объект ..Response/stockEntryList/stockEntry/batch/packingList|'''packingList''']]|| Список видов упаковки.  || [[PackingFormList|argc:PackingFormList]] || 0..1
|-
| '''packingAmount'''||  Общее количество единиц упаковки. || [http://www.w3.org/TR/xmlschema-2/#int xs:int] || 0..1
|-
| '''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] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/countryOfOrigin |'''countryOfOrigin''']] || Страна происхождения партии продукции. ||[[Country|ikar:Country]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/producerList | '''producerList''']] || Список производителей продукции.|| [[ProducerList|ent:ProducerList]] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1
|-
|'''lowGradeCargo'''|| Является ли продукция некачественной.
* true – некачественная;
* false – качественная.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/owner | '''owner''' ]] ||  Хозяйствующий субъект-владелец продукции.  || [[businessEntity|ent:BusinessEntity]] || 1
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''productItem'''===
Объект содержит сведения о наименовании продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID'''
| Идентификатор версии наименования продукции.
| [[UUID|bs:UUID]]
|rowspan=2 | 1 - возвращается или UUID или name, либо оба значения.
|-
| '''name'''
| Наименование продукции в соответствии с номенклатурой производителя.
| [http://www.w3.org/TR/xmlschema-2/#string xs:string]
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[GetStockEntryChangesListOperationForVetControl#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''unit'''===
Объект содержит сведения о единице измерения объема партии продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии единицы измерения. || [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор единицы измерения. || [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''packingList'''===
Объект содержит сведения о списке видов упаковки, которые используются для партии продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/stockEntryList/stockEntry/batch/packingList/packingForm|'''packingForm''']] || Вид упаковки. || [[PackingForm|vetd:PackingForm]] || 0..*
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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''' || Наименование конкретного вида упаковки. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''producerList'''===
Объект содержит сведения о списке производителей продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|[[#Объект ..Response/stockEntryList/stockEntry/batch/producerList/producer|'''producer''' ]] || Производитель продукции.|| [[Producer|vetd:Producer]]  || 0..*
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..Response]]/[[#Объект ..Response/stockEntryList|stockEntryList]]/[[#Объект ..Response/stockEntryList/stockEntry|stockEntry]]/[[#Объект ..Response/stockEntryList/stockEntry/batch|batch]]/'''productMarkingList'''===
Объект содержит сведения о списке маркировки.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''productMarking''' || Строка с маркировкой продукции. || [[String255|bs:String255]] || 0..*
|}
 
===Объект [[#Объект GetStockEntryChangesListResponse|..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 id="scenario1">Получение списка записей складского журнала, изменённых за определённый период времени</div>
<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:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                  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">
  <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-01-10T17:03:00</app:issueDate>
            <app:data>
              <mercvu:getStockEntryChangesListRequest>                     
                  <mercvu:localTransactionId>123</mercvu:localTransactionId>
                  <mercvu:initiator>
                    <com:login>mercury</com:login>
                  </mercvu:initiator>
                  <base:listOptions>
                      <base:count>10</base:count>
                      <base:offset>0</base:offset>
                </base:listOptions>                       
                <base:updateDateInterval>
                    <base:beginDate>2015-10-01T00:00:00</base:beginDate>
                    <base:endDate>2015-10-10T00:00:00</base:endDate>
              </base:updateDateInterval>
              <ent:enterpriseGuid>enterpriseGUID</ent:enterpriseGuid>
            </mercvu:getStockEntryChangesListRequest>
          </app:data>
      </app:application>
    </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
 
 
==Коды ошибок ==
 
В таблице содержатся ошибки, которые могут возникать при работе с приложением через шлюз.
 
{| class="wikitable"
|-
! Код ошибки !! Ошибка
|-
| MERC36180 || Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC36303 || Начало временного интервала позже его окончания
|-
| MERC36304 || Отступ превышает количество записей.
|-
|}
 
[[#top|Вернуться к началу &uarr;]]
[[Category:Ветис.API]]
[[Category:Складской журнал]]
[[Category:Ветис.API для ветеринарных управлений]]

Версия 15:59, 3 июня 2016

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

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

Складской журнал продукции в системе Меркурий ведется с применением версионирования, это означает, что при каждом изменении записи складского журнала создается новая версия этой записи.

  • GUID - глобальный идентификатор записи складского журнала. Данный идентификатор остается неизменным для всех версий записи складского журнала.
  • UUID - идентификатор версии записи складского журнала. Данный идентификатор изменяется для каждой новой версии записи складского журнала.

Так же следует различать актуальную и неактуальную версию записи складского журнала. Для одной записи журнала может существовать только одна актуальная версия.

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

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

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

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

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

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

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

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

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

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

Объект getStockEntryChangesListRequest

Корневой элемент содержимого заявки на получение списка версий записей складского журнала, созданных или измененных за указанный интервал дат.

Поле Описание Тип Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, инициирующий запрос к шлюзу. Ответственный за выполнение бизнес-операции. Должен быть указан или идентификатор, или логин. argc:User 1
listOptions Параметры запрашиваемого списка. bs:ListOptions 0..1
updateDateInterval Интервал времени обновления. В список попадают все записи складского журнала, дата обновлений которых попадает в указанный интервал. bs:DataInterval 1
businessMember Предприятие, по которому производится поиск записей. ent:BusinessMember 0..1

Объект ..Request/initiator

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

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

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

login Логин пользователя. xs:NCName

Объект ..Request/listOptions

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

Поле Описание Тип Обязательность
count Максимальное запрашиваемое количество объектов в списке.
  • По умолчанию значение 100;
  • Максимально возможное значение 1000.
 xs:nonNegativeInteger 0..1
offset Номер элемента, по которому осуществляется смещение первого элемента списка.
  • По умолчанию значение 0.
 xs:nonNegativeInteger 0..1

Объект ..Request/updateDateInterval

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

Поле Описание Тип Обязательность
beginDate Дата, начиная с которой пользователь получит историю изменений записей складского журнала, на указанном предприятии. bs:DataInterval 1
endDate Конец временного интервала.
  • В случае, если компонента endDate не указана, то используется текущая дата.
 bs:DataInterval 0..1

Объект ..Request/businessMember

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

Поле Описание Тип Обязательность
businessEntity Хозяйствующий субъект, для которого производится поиск записей складского журнала ent:BusinessEntity 0..1
enterprise Предприятие, для которого осуществляется отбор записей складского журнала ent:Enterprise 0..1

Объект ..Request/businessMember/businessEntity

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

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

Объект ..Request/businessMember/enterprise

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

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

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

Объект GetStockEntryChangesListResponse

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

Поле Описание Тип Обязательность
stockEntryList Список записей складского журнала продукции. vetd:StockEntry 1

Объект ..Response/stockEntryList

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

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

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

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

Поле Описание Тип Обязательность
UUID Идентификатор версии записи журнала. bs:UUID 1
GUID Глобальный идентификатор записи журнала. bs:UUID 1
active Является ли запись журнала активной:
  • true - запись активна;
  • false - запись не активна.
 xs:boolean 1
last Последняя версия записи журнала:
  • true - да;
  • false - нет.
 xs:boolean 1
status Статус версии записи журнала. bs:VersionStatus 1
createDate Дата создания записи журнала. xs:DateTime 1
updateDate Дата изменения записи журнала. xs:DateTime 1
previous Идентификатор предыдущей версии записи журнала. bs:UUID 0..1
next Идентификатор следующей версии записи журнала. 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 Список видов упаковки. 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 1
productMarkingList Список маркировки, доступный для данного производителя. vetd:ProductMarkingList 0..1
lowGradeCargo Является ли продукция некачественной.
  • true – некачественная;
  • 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 1 - возвращается или UUID или name, либо оба значения.
name Наименование продукции в соответствии с номенклатурой производителя. xs:string

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

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

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

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

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

Поле Описание Тип Обязательность
packingForm Вид упаковки. vetd:PackingForm 0..*

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

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

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

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

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

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

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

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

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

Объект ..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

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

Получение списка записей складского журнала, изменённых за определённый период времени
<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:vet="http://api.vetrf.ru/schema/cdm/mercury/vet-document"
                  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">
   <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-01-10T17:03:00</app:issueDate>
            <app:data>
               <mercvu:getStockEntryChangesListRequest>                       
                  <mercvu:localTransactionId>123</mercvu:localTransactionId>
                  <mercvu:initiator>
                     <com:login>mercury</com:login>
                  </mercvu:initiator>
                  <base:listOptions>
                      <base:count>10</base:count>
                      <base:offset>0</base:offset>
                 </base:listOptions>                         
                <base:updateDateInterval>
                    <base:beginDate>2015-10-01T00:00:00</base:beginDate>
                    <base:endDate>2015-10-10T00:00:00</base:endDate>
               </base:updateDateInterval>
               <ent:enterpriseGuid>enterpriseGUID</ent:enterpriseGuid>
             </mercvu:getStockEntryChangesListRequest>
          </app:data>
       </app:application>
     </ws:submitApplicationRequest>
   </soapenv:Body>
</soapenv:Envelope>


Коды ошибок

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

Код ошибки Ошибка
MERC36180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC36303 Начало временного интервала позже его окончания
MERC36304 Отступ превышает количество записей.

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

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