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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(Egorova-iv-150707 переименовал страницу GetVetDocumentListOperation в GetVetDocumentListOperation v1.2)
 
 
(не показано 16 промежуточных версий 2 участников)
Строка 1: Строка 1:
#перенаправление [[GetVetDocumentListOperation v1.2]]
<!--- #перенаправление [[GetVetDocumentListOperation v1.2]] -->
 
==Общие сведения==
Операция '''GetVetDocumentListOperation''' предназначена для получения всех ветеринарно-сопроводительных документов предприятия. При этом список ВСД может быть отфильтрован по следующим критериям:
* '''Тип ВСД''':
** входящий ВСД;
** исходящий ВСД;
** производственный ВСД;
** транспортный ВСД;
** возвратный ВСД.
* '''Статус ВСД''':
** оформлен;
** погашен;
** аннулирован.
На вход системы передаются следующие сведения:
* информация о пользователе - инициаторе запроса;
* информация о предприятии и хозяйствующем субъекте, где осуществляется поиск ВСД;
* параметры, по которым будет отфильтрован список ВСД.
Результатом выполнения данной операции является:
* пользователю передаются сведения о запрашиваемых ВСД.
 
Запрашиваться пользователем могут только те ВСД, где ветеринарное управление инициатор запроса обслуживает предприятия.
 
=== Возможные сценарии ===
При обработке запроса возможны следующие сценарии:
# Запрос успешно обработан.<br />
# Произошла ошибка при обработке запроса.
::* Некорректный запрос.
::* Внутренняя ошибка системы.
===Используемые пространства имён и типы===
{{столбцы}}
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/argus/common|argc]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/common</nowiki>)
** [[PackingFormList|argc:PackingFormList]]
** [[Purpose |argc:Purpose]]
** [[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]]
** [[ListOptions|bs:ListOptions]]
** [[String255|bs:String255]]
** [[UUID|bs:UUID]]
{{столбец}}
* [[NameSpaces#http://api.vetrf.ru/schema/cdm/cerberus/enterprise|ent]] (<nowiki>http://api.vetrf.ru/schema/cdm/cerberus/enterprise</nowiki>)
** [[BusinessEntity|ent:BusinessEntity]]
** [[BusinessMember|ent:BusinessMember]]
** [[Enterprise|ent:Enterprise]]
** [[EnterpriseRole|ent:EnterpriseRole]]
** [[Producer|ent:Producer]]
** [[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/argus/shipment|shp]] (<nowiki>http://api.vetrf.ru/schema/cdm/argus/shipment</nowiki>)
** [[ShipmentRoute|shp:ShipmentRoute]]
** [[TransportationStorageType|shp:TransportationStorageType]]
** [[TransportInfo|shp:TransportInfo]]
** [[TransportNumber|shp:TransportNumber]]
** [[TransportType|shp:TransportType]]
{{столбец}}
* [[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]]
** [[VetDocumentForm|vetd:VetDocumentForm]]
** [[VetDocumentList|vetd:VetDocumentList]]
** [[VetDocumentType|vetd:VetDocumentType]]
** [[VetDocumentStatus|vetd:VetDocumentStatus]]
{{столбец}}
* [[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/#nonNegativeInteger xs:nonNegativeInteger]
{{столбцы/конец}}
 
===Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений ===
 
{| 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:getVetDocumentListRequest 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}</mercvu:localTransactionId>
    <mercvu:initiator>
        <base:uuid>{bs:UUID}</base:uuid>
        <com:login>{xs:NCName}</com:login>
    </mercvu:initiator>
    <base:listOptions>
        <base:count>{xs:nonNegativeInteger}</base:count>
        <base:offset>{xs:nonNegativeInteger}</base:offset>
    </base:listOptions>
    <vet:vetDocumentType>{vetd:vetDocumentType}</vet:vetDocumentType>
    <vet:vetDocumentStatus>{vetd:vetDocumentStatus}</vet:vetDocumentStatus>
    <ent:businessMember>
      <ent:businessEntity>
          <base:guid>{bs:UUID}</base:guid>
      </ent:businessEntity>
      <ent:enterprise>
          <base:guid>{bs:UUID}</base:guid>
      </ent:enterprise>
    </ent:businessMember>
</mercvu:getVetDocumentListRequest>
</syntaxhighlight>
</div>
</div>
-->
===Объект getVetDocumentListRequest===
Корневой элемент содержимого заявки на получение всех ветеринарно-сопроводительных документов предприятия.
{| 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
|-
| '''vetDocumentType'''|| Тип ВСД:
* входящий (INCOMING);
* исходящий (OUTGOING);
* производственный (PRODUCTIVE)
|| [[VetDocumentType|vetd:VetDocumentType]] || 0..1
|-
| '''vetDocumentStatus''' || Статус ВСД:
<!-- * создан (CREATED); -->
* подтверждён (CONFIRMED);
* аннулирован (WITHDRAWN);
* погашен (UTILIZED)
|| [[VetDocumentStatus|vetd:VetDocumentStatus]] || 0..1
|-
| [[#Объект ..Request/businessMember|'''businessMember''']] || Идентификаторы предприятия и ХС, по которым производится поиск ВСД.  || [[BusinessMember|ent:BusinessMember]] || rowspan="2" | 1 - при запросе от имени ветеринарного управления необходимо указывать businessMember; при запросе от имени ХС по-прежнему указывается enterpriseGuid.
|-
| '''enterpriseGuid''' || Идентификатор предприятия, по которому производится поиск ВСД. || [[UUID|bs:UUID]]
|}
 
=== Объект [[#Объект getVetDocumentListRequest|..Request]]/'''initiator''' ===
Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор пользователя, зарегистрированного в системе Меркурий. || [[UUID|bs:UUID]] || rowspan="2" | 1- для авторизации достаточно одного параметра. Если указаны оба, то приоритете за UUID.
|-
| '''login''' || Логин пользователя. Для авторизации достаточно указать один из параметров. Если указаны оба реквизита, то приоритет остаётся за UUID.|| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName]
|}
 
=== Объект [[#Объект getVetDocumentListRequest|..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
|}
 
=== Объект [[#Объект getVetDocumentListRequest|..Request]]/'''businessMember'''===
Объект содержит сведения о хозяйствующем субъекте, для которого запрашивается список ветеринарных сертификатов. Указывается только если запрос выполняется [[Различия в запросах от хозяйствующих субъектов и ветеринарных управлений#GetVetDocumentListOperation|от имени ветеринарного управления]].
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Request/businessMember/businessEntity|'''businessEntity''']] || Сведения о хозяйствующем субъекте, для которого запрашивается список ВСД.
||[[BusinessEntity|ent:BusinessEntity]] || 0..1
|-
| [[#Объект ..Request/businessMember/enterprise|'''enterprise''']]  || Сведения о предприятии, для которого запрашивается список ветеринарных сертификатов.
|| [http://www.w3.org/TR/xmlschema-2/#nonNegativeInteger xs:nonNegativeInteger]  || 0..1
|}
 
=== Объект [[#Объект getVetDocumentListRequest|..Request]]/[[#Объект ..Request/businessMember|businessMember]]/'''businessEntity'''===
 
Объект описывает хозяйствующий субъект, для которого производится отбор записей складского журнала.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи хозяйствующего субъекта || [[UUID|bs:UUID]] || 0..1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта в реестре РСХН || [[UUID|bs:UUID]] || 0..1
|}
 
=== Объект [[#Объект getVetDocumentListRequest|..Request]]/[[#Объект ..Request/businessMember|businessMember]]/'''enterprise'''===
 
Объект описывает предприятия, для которого производится отбор записей складского журнала.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии записи хозяйствующего субъекта || [[UUID|bs:UUID]] || 0..1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта в реестре РСХН || [[UUID|bs:UUID]] || 0..1
|}
 
==Данные ответа==
<!--
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%">
Структура данных ответа в формате ХML.
<div class = "mw-collapsible-content">
<syntaxhighlight lang="xml">
<getVetDocumentListResponse xmlns="http://api.vetrf.ru/schema/cdm/mercury/applications">
    <vetDocumentList count="{xs:nonNegativeInteger}" total="{xs:nonNegativeInteger}" offset="{xs:nonNegativeInteger}" xmlns="http://api.vetrf.ru/schema/cdm/mercury/vet-document">
        <vetd:vetDocument xmlns:vetd="http://api.vetrf.ru/schema/cdm/mercury/vet-document">
            <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
            <vetd:issueSeries>{bs:String255}</vetd:issueSeries>
            <vetd:issueNumber>{bs:String255}</vetd:issueNumber>
            <vetd:issueDate>{xs:date}</vetd:issueDate>
            <vetd:form>{vetd:VetDocumentForm}</vetd:form>
            <vetd:type>{vetd:VetDocumentType}</vetd:type>
            <vetd:status>{vetd:VetDocumentStatus}</vetd:status>
            <vetd:consignor>
                <ent:businessEntity xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </ent:businessEntity>
                <ent:enterprise xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </ent:enterprise>
            </vetd:consignor>
            <vetd:consignee>
                <ent:businessEntity xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </ent:businessEntity>
                <ent:enterprise xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </ent:enterprise>
            </vetd:consignee>
            <vetd:batch>
                <vetd:productType>{argpr:ProductType}</vetd:productType>
                <vetd:product>
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </vetd:product>
                <vetd:subProduct>
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </vetd:subProduct>
                <vetd:productItem>
                    <prod:name xmlns:prod="http://api.vetrf.ru/schema/cdm/argus/production">{bs:String255}</prod:name>
                </vetd:productItem>
                <vetd:volume>{bs:Decimal}</vetd:volume>
                <vetd:unit>
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </vetd:unit>
                <vetd:packingList>
                    <argc:packingForm xmlns:argc="http://api.vetrf.ru/schema/cdm/argus/common">
                        <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{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 xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Year}</bs:year>
                        <bs:month xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Month}</bs:month>
                        <bs:day xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Day}</bs:day>
                        <bs:hour xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Hour}</bs:hour>
                    </vetd:firstDate>
                    <vetd:secondDate>
                        <bs:year xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Year}</bs:year>
                        <bs:month xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Month}</bs:month>
                        <bs:day xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Day}</bs:day>
                        <bs:hour xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Hour}</bs:hour>
                    </vetd:secondDate>
                </vetd:dateOfProduction>
                <vetd:expiryDate>
                    <vetd:firstDate>
                        <bs:year xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Year}</bs:year>
                        <bs:month xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Month}</bs:month>
                        <bs:day xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Day}</bs:day>
                        <bs:hour xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Hour}</bs:hour>
                    </vetd:firstDate>
                    <vetd:secondDate>
                        <bs:year xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Year}</bs:year>
                        <bs:month xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Month}</bs:month>
                        <bs:day xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Day}</bs:day>
                        <bs:hour xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:Hour}</bs:hour>
                    </vetd:secondDate>
                </vetd:expiryDate>
                <vetd:perishable>{xs:boolean}</vetd:perishable>
                <vetd:countryOfOrigin>
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </vetd:countryOfOrigin>
                <vetd:producerList>
                    <ent:producer xmlns:ent="http://api.vetrf.ru/schema/cdm/cerberus/enterprise">
                        <ent:enterprise>
                            <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                            <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                        </ent:enterprise>
                        <ent:role>{ent:EnterpriseRole}</ent:role>
                    </ent:producer>
                </vetd:producerList>
                <vetd:productMarkingList>
                    <vetd:productMarking>{bs:String355}</vetd:productMarking>
                </vetd:productMarkingList>
                <vetd:lowGradeCargo>{xs:boolean}</vetd:lowGradeCargo>
                <vetd:owner>
                    <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                    <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
                </vetd:owner>
            </vetd:batch>
            <vetd:purpose>
                <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
            </vetd:purpose>
            <vetd:broker>
                <bs:uuid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:uuid>
                <bs:guid xmlns:bs="http://api.vetrf.ru/schema/cdm/base">{bs:UUID}</bs:guid>
            </vetd:broker>
            <vetd:transportInfo>
                <shp:transportType xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">{shp:TransportType}</shp:transportType>
                <shp:transportNumber xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">
                    <shp:vehicleNumber>{bs:String255}</shp:vehicleNumber>
                </shp:transportNumber>
            </vetd:transportInfo>
            <vetd:transportStorageType>{shp:TransportationStorageType}</vetd:transportStorageType>
            <vetd:cargoReloadingPointList>
                <shp:cargoReloadingPoint xmlns:shp="http://api.vetrf.ru/schema/cdm/argus/shipment">
                    <shp:name>{bs:String255}</shp:name>
                    <shp:nextTransport>
                        <shp:transportType>{shp:TransportType}</shp:transportType>
                        <shp:transportNumber>
                            <shp:vehicleNumber>{bs:String255}</shp:vehicleNumber>
                        </shp:transportNumber>
                    </shp:nextTransport>
                </shp:cargoReloadingPoint>
            </vetd:cargoReloadingPointList>
            <vetd:waybillNumber>{bs:String255}</vetd:waybillNumber>
            <vetd:waybillDate>{xs:date}</vetd:waybillDate>
            <vetd:cargoExpertized>{xs:boolean}</vetd:cargoExpertized>
            <vetd:confirmedBy>
                <argc:fio xmlns:argc="http://api.vetrf.ru/schema/cdm/argus/common">{bs:String255}</argc:fio>
                <argc:post xmlns:argc="http://api.vetrf.ru/schema/cdm/argus/common">{bs:String255}</argc:post>
            </vetd:confirmedBy>
            <vetd:locationProsperity>{bs:String255}</vetd:locationProsperity>
            <vetd:specialMarks>{bs:String255}</vetd:specialMarks>
        </vetd:vetDocument>
    </vetDocumentList>
</getVetDocumentListResponse>
</syntaxhighlight>
</div>
</div>
-->
=== Объект getVetDocumentListResponse===
Объект содержит сведения о результатах обработки запроса на получение списка ВСД предприятия.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|[[#Объект ..Response/vetDocumentList|'''vetDocumentList''']] || Список ВСД. || [[VetDocumentList|vetd:VetDocumentList]] || 1
|}
 
=== Объект [[#Объект getVetDocumentListResponse|..Response]]/'''vetDocumentList'''===
Объект содержит сведения об измененных или добавленных, в указанный промежуток времени, ВСД.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument|'''vetDocument''']] || ветеринарно-сопроводительный документ. || [[VetDocument|vetd:VetDocument]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse|..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/'''vetDocument''' ===
Объект содержит сведения о ВСД.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор ВСД. || [[UUID|bs:UUID]] || 1
|-
| '''issueSeries''' || Серия ВСД. || [[String255|bs:String255]] || 0..1
|-
| '''issueNumber''' || Номер ВСД. || [[String255|bs:String255]] || 0..1
|-
| '''issueDate''' ||Дата оформления ВСД. || [http://www.w3.org/TR/xmlschema-2/#date xs:date] || 1
|-
| '''form''' || Форма ВСД. || [[VetDocumentForm|vetd:VetDocumentForm]] || 1
|-
| '''type''' || Тип ВСД.
* Может быть возвращён один из следующих типов:
: PRODUCTIVE (производственный)
: TRANSPORT (транспортный)
: RETURNABLE (возвратный)
|| [[VetDocumentType|vetd:VetDocumentType]] || 1
|-
| '''status''' || Статус ВСД. || [[VetDocumentStatus|vetd:VetDocumentStatus]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/consignor|'''consignor''']]|| Сведения об отправителе продукции.
|| [[BusinessMember|ent:BusinessMember]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/consignee|'''consignee''']] || Сведения о получателе продукции.
|| [[BusinessMember|ent:BusinessMember]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch|'''batch''']]|| Сведения о партии продукции. || [[Batch|vetd:Batch]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/purpose|'''purpose''']]|| Цель. Назначение груза. || [[Purpose|argc:Purpose]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/broker|'''broker''']]|| Сведения о фирме-посреднике (перевозчике продукции). || [[BusinessEntity|ent:BusinessEntity]] || 0..1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/transportInfo|'''transportInfo''']]|| Сведения о транспорте. || [[TransportInfo|shp:TransportInfo]] || 0..1
|-
| '''transportStorageType'''|| Способ хранения продукции при перевозке. || [[TransportationStorageType|shp:TransportationStorageType]] || 0..1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList|'''cargoReloadingPointList''']]|| Сведения о маршруте следования (пунктах перегрузки). || [[ShipmentRoute|shp:ShipmentRoute]] || 0..1
|-
| '''waybillNumber'''|| Номер товарно-транспортной накладной. || [[Batch|vetd:Batch]] || 0..1
|-
| '''waybillDate'''|| Дата товарно-транспортной накладной. || [[Batch|vetd:Batch]] || 0..1
|-
| '''cargoExpertized''' || Проводилась ли ветсанэкспертиза.
* Для типа продукции "Живые животное" поле отсутствует.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 0..1
|-
| '''expertiseInfo''' || Результаты лабораторных исследований.
* Для типа продукции "Живые животные" поле отсутствует.
|| [[String255|bs:String255]] || 0..1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/confirmedBy|'''confirmedBy''']]|| Государственный ветврач, подписавший ВСД.|| [[User|argc:User]] || 1
|-
| '''locationProsperity'''|| Благополучие местности.|| [[String255|bs:String255]] || 1
|-
| '''specialMarks'''|| Особые отметки. || [[String255|bs:String255]] || 0..1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''consignor'''===
Объект содержит сведения об отправителе продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/consignor/businessEntity|'''businessEntity''']] || Информация о хозяйствующем субъекте-отправителе партии.  || [[BusinessEntity|ent:BusinessEntity]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/consignor/enterprise|'''enterprise''']] || Информация о предприятии-отправителе партии. || [[Enterprise|ent:Enterprise]] || 0..1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/consignor|consignor]]/'''businessEntity'''===
Объект содержит сведения о хозяйствующем субъекте.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/consignor|consignor]]/'''enterprise'''===
Объект содержит сведения о площадке (поднадзорном объекте).
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии предприятия.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор предприятия.|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''consignee'''===
Объект содержит сведения о получателе, в случае производственного сертификата объект будет содержать те же сведения, что и в объекте consignor.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/consignee/businessEntity|'''businessEntity''']] || Информация о хозяйствующем субъекте-получателе партии.  || [[BusinessEntity|ent:BusinessEntity]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/consignee/enterprise|'''enterprise''']] || Информация о предприятии-получателе партии. || [[Enterprise|ent:Enterprise]] || 0..1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/consignee|consignee]]/'''businessEntity'''===
Объект содержит сведения о хозяйствующем субъекте.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/consignee|consignee]]/'''enterprise'''===
Объект содержит сведения о площадке (поднадзорном объекте).
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии предприятия.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор предприятия.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''batch'''===
Объект содержит сведения о партии продукции, на которую был выдан запрашиваемый ВСД.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
|'''productType'''|| Тип продукции. Первый уровень иерархического справочника продукции ИС Меркурий.  || [[ProductType|argpr:ProductType]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/product|'''product''']]|| Продукция. Второй уровень иерархического справочника продукции ИС Меркурий.  || [[Product|argpr:Product]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/subProduct|'''subProduct''']]||Вид продукции. Третий уровень иерархического справочника продукции ИС Меркурий.  || [[SubProduct|argpr:SubProduct]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/productItem|'''productItem''']]||Наименование продукции в номенклатуре производителя. || [[ProductItem|argpr:ProductItem]] || 0..1
|-
| '''volume'''|| Объем продукции, на который был выдан ВСД. Значение должно быть больше нуля.  || [[Decimal|bs:Decimal]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/unit|'''unit''']]|| Единица измерения объема продукции. || [[Unitl|argc:Unit]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/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] || 0..1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/countryOfOrigin |'''countryOfOrigin''']] || Страна происхождения продукции. ||[[Country|ikar:Country]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/producerList | '''producerList''']] || Список производителей продукции.|| [[ProducerList|ent:ProducerList]] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/productMarkingList | '''productMarkingList''']] ||  Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1
|-
|'''lowGradeCargo'''|| Является ли груз некачественным.
*true – груз некачественный;
*false – груз качественный.
Элемент может не указываться. В этом случае значение по-умолчанию устанавливается false.
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/owner | '''owner''' ]] ||  Хозяйствующий субъект - владелец продукции.  || [[BusinessEntity|ent:BusinessEntity]] || 1
|}
 
=== Объект  [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''product''' ===
Объект содержит сведения о продукции; второй уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии продукции|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор продукции|| [[UUID|bs:UUID]]|| 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''subProduct'''===
Объект содержит сведения о видах продукции; третий уровень иерархического справочника продукции ИС Меркурий.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии вида продукции|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор продукции|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''productItem'''===
Объект содержит сведения о наименовании продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''name''' || Наименование продукции в соответствии с номенклатурой производителя || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''unit'''===
Объект содержит сведения о единице измерения объема продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии единицы измерения|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор единицы измерения|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''packingList'''===
Объект содержит сведения о списке видов упаковки, которые используются для партии продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/packingList/packingForm|'''packingForm''']] || Вид упаковки. || [[PackingForm|vetd:PackingForm]] || 0..1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch/packingList|packingList]]/'''packingForm'''===
Объект содержит сведения о виде упаковки, которая используются для партии продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор упаковки. || [[UUID|bs:UUID]] || 1
|-
| '''name''' || Наименование конкретного вида упаковки || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''countryOfOrigin'''===
Объект содержит сведения о стране-происхождения продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии страны происхождения.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор страны происхождения.|| [[UUID|bs:UUID]] || 1
|}
 
=== Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''producerList'''===
Объект содержит сведения о списке производителей продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/producerList/producer|'''producer''' ]] || Производитель продукции.|| [[Producer|vetd:Producer]]  || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch/producerList|producerList]]/'''producer'''===
Объект содержит сведения о производителе продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/producerList/producer/enterprise| '''enterprise''']] || Информация о предприятие-производителе продукции.|| [[Enterprise|ent:Enterprise]] || 1
|-
| '''role''' ||Роль предприятия-производителя продукции.||  [[EnterpriseRole|ent:EnterpriseRole]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch/producerList|producerList]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch/producerList/producer|producer]]/'''enterprise'''===
Объект содержит сведение о предприятие-производителе продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии  предприятия-производителя продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор предприятия-производителя продукции.|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''productMarkingList'''===
Объект содержит сведения о списке маркировки.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''productMarking''' || Строка с маркировкой продукции. || [[String255|bs:String255]] || 0..*
|}
 
=== Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/batch|batch]]/'''owner'''===
Объект содержит сведения о хозяйствующем субъекте-владельце продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор версии хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта - владельца продукции.|| [[UUID|bs:UUID]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''purpose'''===
Объект содержит сведения о цели перемещения транспортной партии.
 
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор записи в справочнике целей. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|-
| '''GUID''' || Глобальный идентификатор записи в справочнике целей. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''broker'''===
Объект содержит сведения о хозяйствующем субъекте-посреднике (перевозчик продукции).
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''UUID''' || Идентификатор хозяйствующего субъекта - перевозчика продукции (посредника).|| [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|-
| '''GUID''' || Глобальный идентификатор хозяйствующего субъекта - перевозчика продукции (посредника).|| [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''transportInfo'''===
Объект содержит информацию о транспорте в котором будет перемещаться партия продукции.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''transportType''' || Тип транспортного средства. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/transportInfo/transportNumber|'''transportNumber''']] || Номер транспортного средства.|| [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/transportInfo|transportInfo]]/'''transportNumber'''===
Сведения о номере транспортного средства.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''vehicleNumber''' || Номер транспортного средства. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''cargoReloadingPointList'''===
Объект содержит информацию о списке пунктов перегрузки.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint|'''cargoReloadingPoint''']] || Пункт перегрузки транспортной партии в другое транспортное средство.|| [[CargoReloadingPoint|shp:CargoReloadingPoint]] || 0..*
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList|cargoReloadingPointList]]/'''cargoReloadingPoint'''===
Объект содержит информацию о пункте перегрузки.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''name''' || Название пункта перегрузки. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|-
| [[#Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint/nextTransport|'''nextTransport''']]|| Сведения о дальнейшем транспорте. || [[TransportInfo | shp:TransportInfo ]]|| 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/[[#Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList|cargoReloadingPointList]]/[[#Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint|cargoReloadingPoint]]/'''nextTransport'''===
Объект содержит сведения о транспорте, которым далее последует транспортная партия.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''transportType''' || Тип транспортного средства. || [[TransportType|shp:TransportType]] || 1
|-
| '''transportNumber''' || Номер транспортного средства. || [[TransportNumber|shp:TransportNumber]] || 1
|}
 
===Объект [[#Объект getVetDocumentListResponse |..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''confirmedBy'''===
Объект содержит сведения о ветеринарном враче, оформившим ВСД.
{| class="wikitable"
|-
! Поле !! Описание !! Тип !! Обязательность
|-
| '''fio''' || ФИО врача, оформившего ветеринарно-сопроводительный документ. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|-
| '''post''' || Должность врача, оформившего ветеринарно-сопроводительный документ. || [http://www.w3.org/TR/xmlschema-2/#string xs:string] || 1
|}
 
==Коды ошибок==
 
В таблице содержится информация об ошибках, возникающих при работе с приложением.
 
{| class="wikitable"
|-
! Код ошибки !! Описание
|-
| MERC31180 || Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
|-
| MERC31270 || Указана фильтрация ветеринарно-сопроводительных документов по состоянию "создан".
|-
|}
 
== Примеры запросов ==
<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: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-vu.service</app:serviceId>
            <app:issuerId>issuerId</app:issuerId>
            <app:issueDate>2015-01-10T17:03:00</app:issueDate>
            <app:data>
                  <mercvu:getVetDocumentListRequest>
                      <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                      <mercvu:initiator>
                          <com:login>mercury_user</com:login>
                      </mercvu:initiator>
                      <base:listOptions>
                  <base:count>10</base:count>
                  <base:offset>0</base:offset>
              </base:listOptions>
                      <vet:vetDocumentType>OUTGOING</vet:vetDocumentType>
                      <vet:vetDocumentStatus>WITHDRAWN</vet:vetDocumentStatus>
                      <mercvu:businessMember>
                          <ent:businessEntity>
                              <base:guid>72c7e8cd-0583-45e2-99db-801f5939587e</base:guid>
                          </ent:businessEntity>
                          <ent:enterprise>
                              <base:guid>9f0a0b32-8a29-40a6-9325-654434050d7c</base:guid>
                          </ent:enterprise>
                      </mercvu:businessMember>     
                </mercvu:getVetDocumentListRequest>
            </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: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>
                <merc:getVetDocumentListRequest>
                  <merc:localTransactionId>a10003</merc:localTransactionId>
                  <merc:initiator>
                      <com:login>egorova-iv-150707</com:login>
                  </merc:initiator>
                  <base:listOptions>
              <base:count>10</base:count>
              <base:offset>0</base:offset>
          </base:listOptions>
                  <vet:vetDocumentType>INCOMING</vet:vetDocumentType>
                  <vet:vetDocumentStatus>UTILIZED</vet:vetDocumentStatus>
          <ent:enterpriseGuid>guid</ent:enterpriseGuid>
              </merc:getVetDocumentListRequest>
            </app:data>
        </app:application>
      </ws:submitApplicationRequest>
  </soapenv:Body>
</soapenv:Envelope>
</syntaxhighlight>
</div>
</div>
 
[[#top|Вернуться к началу &uarr;]]
[[Category:Ветис.API]]
[[Category:ВСД]]
[[Category:Ветис.API для ветеринарных управлений]]

Текущая версия на 12:41, 14 марта 2017


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

Операция GetVetDocumentListOperation предназначена для получения всех ветеринарно-сопроводительных документов предприятия. При этом список ВСД может быть отфильтрован по следующим критериям:

  • Тип ВСД:
    • входящий ВСД;
    • исходящий ВСД;
    • производственный ВСД;
    • транспортный ВСД;
    • возвратный ВСД.
  • Статус ВСД:
    • оформлен;
    • погашен;
    • аннулирован.

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

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

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

  • пользователю передаются сведения о запрашиваемых ВСД.

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

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

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

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

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

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

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

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

Объект getVetDocumentListRequest

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

Поле Описание Тип Обязательность
localTransactionId Идентификатор заявки в клиентской системе. xs:NCName 1
initiator Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. argc:User 1
listOptions Параметры запрашиваемого списка. bs:ListOptions 0..1
vetDocumentType Тип ВСД:
  • входящий (INCOMING);
  • исходящий (OUTGOING);
  • производственный (PRODUCTIVE)
 vetd:VetDocumentType 0..1
vetDocumentStatus Статус ВСД:
  • подтверждён (CONFIRMED);
  • аннулирован (WITHDRAWN);
  • погашен (UTILIZED)
 vetd:VetDocumentStatus 0..1
businessMember Идентификаторы предприятия и ХС, по которым производится поиск ВСД. ent:BusinessMember 1 - при запросе от имени ветеринарного управления необходимо указывать businessMember; при запросе от имени ХС по-прежнему указывается enterpriseGuid.
enterpriseGuid Идентификатор предприятия, по которому производится поиск ВСД. bs:UUID

Объект ..Request/initiator

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

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

Объект ..Request/listOptions

Объект содержит сведения о параметрах запрашиваемого списка ВСД.

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

Объект ..Request/businessMember

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

Поле Описание Тип Обязательность
businessEntity Сведения о хозяйствующем субъекте, для которого запрашивается список ВСД. ent:BusinessEntity 0..1
enterprise Сведения о предприятии, для которого запрашивается список ветеринарных сертификатов. xs:nonNegativeInteger 0..1

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

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

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

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

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

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

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

Объект getVetDocumentListResponse

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

Поле Описание Тип Обязательность
vetDocumentList Список ВСД. vetd:VetDocumentList 1

Объект ..Response/vetDocumentList

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

Поле Описание Тип Обязательность
vetDocument ветеринарно-сопроводительный документ. vetd:VetDocument 1

Объект ..Response/vetDocumentList/vetDocument

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

Поле Описание Тип Обязательность
UUID Идентификатор ВСД. bs:UUID 1
issueSeries Серия ВСД. bs:String255 0..1
issueNumber Номер ВСД. bs:String255 0..1
issueDate Дата оформления ВСД. xs:date 1
form Форма ВСД. vetd:VetDocumentForm 1
type Тип ВСД.
  • Может быть возвращён один из следующих типов:
PRODUCTIVE (производственный)
TRANSPORT (транспортный)
RETURNABLE (возвратный)
 vetd:VetDocumentType 1
status Статус ВСД. vetd:VetDocumentStatus 1
consignor Сведения об отправителе продукции. ent:BusinessMember 1
consignee Сведения о получателе продукции. ent:BusinessMember 1
batch Сведения о партии продукции. vetd:Batch 1
purpose Цель. Назначение груза. argc:Purpose 1
broker Сведения о фирме-посреднике (перевозчике продукции). ent:BusinessEntity 0..1
transportInfo Сведения о транспорте. shp:TransportInfo 0..1
transportStorageType Способ хранения продукции при перевозке. shp:TransportationStorageType 0..1
cargoReloadingPointList Сведения о маршруте следования (пунктах перегрузки). shp:ShipmentRoute 0..1
waybillNumber Номер товарно-транспортной накладной. vetd:Batch 0..1
waybillDate Дата товарно-транспортной накладной. vetd:Batch 0..1
cargoExpertized Проводилась ли ветсанэкспертиза.
  • Для типа продукции "Живые животное" поле отсутствует.
 xs:boolean 0..1
expertiseInfo Результаты лабораторных исследований.
  • Для типа продукции "Живые животные" поле отсутствует.
 bs:String255 0..1
confirmedBy Государственный ветврач, подписавший ВСД. argc:User 1
locationProsperity Благополучие местности. bs:String255 1
specialMarks Особые отметки. bs:String255 0..1

Объект ..Response/vetDocumentList/vetDocument/consignor

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

Поле Описание Тип Обязательность
businessEntity Информация о хозяйствующем субъекте-отправителе партии. ent:BusinessEntity 1
enterprise Информация о предприятии-отправителе партии. ent:Enterprise 0..1

Объект ..Response/vetDocumentList/vetDocument/consignor/businessEntity

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

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

Объект ..Response/vetDocumentList/vetDocument/consignor/enterprise

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

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

Объект ..Response/vetDocumentList/vetDocument/consignee

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

Поле Описание Тип Обязательность
businessEntity Информация о хозяйствующем субъекте-получателе партии. ent:BusinessEntity 1
enterprise Информация о предприятии-получателе партии. ent:Enterprise 0..1

Объект ..Response/vetDocumentList/vetDocument/consignee/businessEntity

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

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

Объект ..Response/vetDocumentList/vetDocument/consignee/enterprise

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

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

Объект ..Response/vetDocumentList/vetDocument/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 0..1
countryOfOrigin Страна происхождения продукции. ikar:Country 1
producerList Список производителей продукции. ent:ProducerList 1
productMarkingList Список маркировки, доступный для данного производителя. vetd:ProductMarkingList 0..1
lowGradeCargo Является ли груз некачественным.
  • true – груз некачественный;
  • false – груз качественный.

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/product

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/subProduct

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/productItem

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/unit

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/packingList

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/packingList/packingForm

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/countryOfOrigin

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/producerList

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/producerList/producer

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/producerList/producer/enterprise

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/productMarkingList

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

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

Объект ..Response/vetDocumentList/vetDocument/batch/owner

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

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

Объект ..Response/vetDocumentList/vetDocument/purpose

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

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

Объект ..Response/vetDocumentList/vetDocument/broker

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

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

Объект ..Response/vetDocumentList/vetDocument/transportInfo

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

Поле Описание Тип Обязательность
transportType Тип транспортного средства. xs:string 1
transportNumber Номер транспортного средства. xs:string 1

Объект ..Response/vetDocumentList/vetDocument/transportInfo/transportNumber

Сведения о номере транспортного средства.

Поле Описание Тип Обязательность
vehicleNumber Номер транспортного средства. xs:string 1

Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList

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

Поле Описание Тип Обязательность
cargoReloadingPoint Пункт перегрузки транспортной партии в другое транспортное средство. shp:CargoReloadingPoint 0..*

Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint

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

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

Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint/nextTransport

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

Поле Описание Тип Обязательность
transportType Тип транспортного средства. shp:TransportType 1
transportNumber Номер транспортного средства. shp:TransportNumber 1

Объект ..Response/vetDocumentList/vetDocument/confirmedBy

Объект содержит сведения о ветеринарном враче, оформившим ВСД.

Поле Описание Тип Обязательность
fio ФИО врача, оформившего ветеринарно-сопроводительный документ. xs:string 1
post Должность врача, оформившего ветеринарно-сопроводительный документ. xs:string 1

Коды ошибок

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

Код ошибки Описание
MERC31180 Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату.
MERC31270 Указана фильтрация ветеринарно-сопроводительных документов по состоянию "создан".

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

Пример запроса всех исходящих аннулированных ВСД предприятия от имени ветеринарного управления. 

<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-vu.service</app:serviceId>
            <app:issuerId>issuerId</app:issuerId>
            <app:issueDate>2015-01-10T17:03:00</app:issueDate>
            <app:data>
                  <mercvu:getVetDocumentListRequest>
                      <mercvu:localTransactionId>a10003</mercvu:localTransactionId>
                      <mercvu:initiator>
                          <com:login>mercury_user</com:login>
                      </mercvu:initiator>
                      <base:listOptions>
	                  <base:count>10</base:count>
	                  <base:offset>0</base:offset>
	              </base:listOptions>
                      <vet:vetDocumentType>OUTGOING</vet:vetDocumentType>
                      <vet:vetDocumentStatus>WITHDRAWN</vet:vetDocumentStatus>
                      <mercvu:businessMember>
                          <ent:businessEntity>
                              <base:guid>72c7e8cd-0583-45e2-99db-801f5939587e</base:guid>
                          </ent:businessEntity>
                          <ent:enterprise>
                              <base:guid>9f0a0b32-8a29-40a6-9325-654434050d7c</base:guid>
                          </ent:enterprise>
                      </mercvu:businessMember>      
                 </mercvu:getVetDocumentListRequest>
            </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: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>
                <merc:getVetDocumentListRequest>
                  <merc:localTransactionId>a10003</merc:localTransactionId>
                  <merc:initiator>
                      <com:login>egorova-iv-150707</com:login>
                  </merc:initiator>
                  <base:listOptions>
	               	<base:count>10</base:count>
	               	<base:offset>0</base:offset>
	          </base:listOptions>
                  <vet:vetDocumentType>INCOMING</vet:vetDocumentType>
                  <vet:vetDocumentStatus>UTILIZED</vet:vetDocumentStatus>
	          <ent:enterpriseGuid>guid</ent:enterpriseGuid>
               </merc:getVetDocumentListRequest>
            </app:data>
         </app:application>
      </ws:submitApplicationRequest>
   </soapenv:Body>
</soapenv:Envelope>

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

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