GetVetDocumentChangesListOperation: различия между версиями
(не показано 11 промежуточных версий 3 участников) | |||
Строка 117: | Строка 117: | ||
</div> | </div> | ||
===Объект | ===Объект getVetDocumentChangesListRequest=== | ||
Корневой элемент содержимого заявки на получение списка версий, созданных или измененных за указанный интервал дат. | Корневой элемент содержимого заявки на получение списка версий, созданных или измененных за указанный интервал дат. | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 127: | Строка 127: | ||
| [[#Объект ..Request/initiator|'''initiator''']] || Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. | | [[#Объект ..Request/initiator|'''initiator''']] || Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. | ||
|| [[User|argc:User]] || 1 | || [[User|argc:User]] || 1 | ||
|- | |||
| [[#Объект ..Request/listOptions|'''listOptions''']] || Параметры запрашиваемого списка. || [[ListOptions|bs:ListOptions]] || 0..1 | |||
|- | |- | ||
| [[#Объект ..Request/updateDateInterval|'''updateDateInterval''']] || Интервал времени обновления. В список попадают все записи, дата обновлений которых попадает в указанный интервал. || [[DataInterval|bs:DataInterval]] || 1 | | [[#Объект ..Request/updateDateInterval|'''updateDateInterval''']] || Интервал времени обновления. В список попадают все записи, дата обновлений которых попадает в указанный интервал. || [[DataInterval|bs:DataInterval]] || 1 | ||
Строка 144: | Строка 146: | ||
|- | |- | ||
| '''login''' || Логин пользователя. Для авторизации достаточно указать один из параметров. Если указаны оба реквизита, то приоритет остаётся за UUID.|| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 0..1 | | '''login''' || Логин пользователя. Для авторизации достаточно указать один из параметров. Если указаны оба реквизита, то приоритет остаётся за UUID.|| [http://www.w3.org/TR/xmlschema-2/#NCName xs:NCName] || 0..1 | ||
|} | |||
=== Объект [[#Объект GetVetDocumentChangesListRequest|..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 | |||
|} | |} | ||
Строка 377: | Строка 395: | ||
| '''UUID''' || Идентификатор ВСД. || [[UUID|bs:UUID]] || 1 | | '''UUID''' || Идентификатор ВСД. || [[UUID|bs:UUID]] || 1 | ||
|- | |- | ||
| '''issueSeries''' || Серия ВСД. || [[String255|bs:String255]] || 1 | | '''issueSeries''' || Серия ВСД. || [[String255|bs:String255]] || 0..1 | ||
|- | |- | ||
| '''issueNumber''' || Номер ВСД. || [[String255|bs:String255]] || 1 | | '''issueNumber''' || Номер ВСД. || [[String255|bs:String255]] || 0..1 | ||
|- | |- | ||
| '''issueDate''' ||Дата оформления ВСД. || [http://www.w3.org/TR/xmlschema-2/#date xs:date] || 1 | | '''issueDate''' ||Дата оформления ВСД. || [http://www.w3.org/TR/xmlschema-2/#date xs:date] || 1 | ||
Строка 414: | Строка 432: | ||
* Для типа продукции "Живые животное" поле отсутствует. | * Для типа продукции "Живые животное" поле отсутствует. | ||
|| [http://www.w3.org/TR/xmlschema-2/#boolean xs:boolean] || 0..1 | || [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 | | [[#Объект ..Response/vetDocumentList/vetDocument/confirmedBy|'''confirmedBy''']]|| Государственный ветврач, подписавший ВСД.|| [[User|argc:User]] || 1 | ||
Строка 430: | Строка 452: | ||
| [[#Объект ..Response/vetDocumentList/vetDocument/consignor/businessEntity|'''businessEntity''']] || Информация о хозяйствующем субъекте-отправителе партии. || [[BusinessEntity|ent:BusinessEntity]] || 1 | | [[#Объект ..Response/vetDocumentList/vetDocument/consignor/businessEntity|'''businessEntity''']] || Информация о хозяйствующем субъекте-отправителе партии. || [[BusinessEntity|ent:BusinessEntity]] || 1 | ||
|- | |- | ||
| [[#Объект ..Response/vetDocumentList/vetDocument/consignor/enterprise|'''enterprise''']] || Информация о предприятии-отправителе партии. || [[Enterprise|ent:Enterprise]] || 1 | | [[#Объект ..Response/vetDocumentList/vetDocument/consignor/enterprise|'''enterprise''']] || Информация о предприятии-отправителе партии. || [[Enterprise|ent:Enterprise]] || 0..1 | ||
|} | |} | ||
Строка 463: | Строка 485: | ||
| [[#Объект ..Response/vetDocumentList/vetDocument/consignee/businessEntity|'''businessEntity''']] || Информация о хозяйствующем субъекте-получателе партии. || [[BusinessEntity|ent:BusinessEntity]] || 1 | | [[#Объект ..Response/vetDocumentList/vetDocument/consignee/businessEntity|'''businessEntity''']] || Информация о хозяйствующем субъекте-получателе партии. || [[BusinessEntity|ent:BusinessEntity]] || 1 | ||
|- | |- | ||
| [[#Объект ..Response/vetDocumentList/vetDocument/consignee/enterprise|'''enterprise''']] || Информация о предприятии-получателе партии. || [[Enterprise|ent:Enterprise]] || 1 | | [[#Объект ..Response/vetDocumentList/vetDocument/consignee/enterprise|'''enterprise''']] || Информация о предприятии-получателе партии. || [[Enterprise|ent:Enterprise]] || 0..1 | ||
|} | |} | ||
Строка 523: | Строка 545: | ||
| [[#Объект ..Response/vetDocumentList/vetDocument/batch/productMarkingList | '''productMarkingList''']] || Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1 | | [[#Объект ..Response/vetDocumentList/vetDocument/batch/productMarkingList | '''productMarkingList''']] || Список маркировки, доступный для данного производителя.|| [[ProductMarkingList|vetd:ProductMarkingList]] || 0..1 | ||
|- | |- | ||
|'''lowGradeCargo'''|| Является ли | |'''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 | | [[#Объект ..Response/vetDocumentList/vetDocument/batch/owner | '''owner''' ]] || Хозяйствующий субъект - владелец продукции. || [[BusinessEntity|ent:BusinessEntity]] || 1 | ||
Строка 664: | Строка 690: | ||
|} | |} | ||
===Объект [[#Объект getVetDocumentChangesListResponse|..Response]]/[[Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''broker'''=== | ===Объект [[#Объект getVetDocumentChangesListResponse|..Response]]/[[#Объект ..Response/vetDocumentList|vetDocumentList]]/[[#Объект ..Response/vetDocumentList/vetDocument|vetDocument]]/'''broker'''=== | ||
Объект содержит сведения о хозяйствующем субъекте-посреднике (перевозчик продукции). | Объект содержит сведения о хозяйствующем субъекте-посреднике (перевозчик продукции). | ||
{| class="wikitable" | {| class="wikitable" | ||
Строка 746: | Строка 772: | ||
|} | |} | ||
== | ==Примеры запросов== | ||
<div class="toccolours mw-collapsible mw-collapsed" style="width:100%"> | <div class="toccolours mw-collapsible mw-collapsed" style="width:100%"> | ||
Получение списка изменённых сертификатов - ветеринарное управление. | |||
<div class = "mw-collapsible-content"> | <div class = "mw-collapsible-content"> | ||
<syntaxhighlight lang="xml"> | <syntaxhighlight lang="xml"> | ||
Строка 769: | Строка 795: | ||
<app:issueDate>2015-01-10T17:03:00</app:issueDate> | <app:issueDate>2015-01-10T17:03:00</app:issueDate> | ||
<app:data> | <app:data> | ||
< | <mercvu:getVetDocumentChangesListRequest> | ||
< | <mercvu:localTransactionId>a10003</mercvu:localTransactionId> | ||
< | <mercvu:initiator> | ||
<com:login>mercury_user</com:login> | <com:login>mercury_user</com:login> | ||
</ | </mercvu:initiator> | ||
<base:updateDateInterval> | <base:updateDateInterval> | ||
<base:beginDate>2015-09-30T00:00:00</base:beginDate> | <base:beginDate>2015-09-30T00:00:00</base:beginDate> | ||
<base:endDate>2015-10-10T00:00:00</base:endDate> | <base:endDate>2015-10-10T00:00:00</base:endDate> | ||
</base:updateDateInterval> | </base:updateDateInterval> | ||
< | <mercvu:businessMember> | ||
<ent:businessEntity> | <ent:businessEntity> | ||
<base:guid>guid</base:guid> | <base:guid>guid</base:guid> | ||
Строка 785: | Строка 811: | ||
<base:guid>guid</base:guid> | <base:guid>guid</base:guid> | ||
</ent:enterprise> | </ent:enterprise> | ||
</ent: | </mercvu:businessMember> | ||
</mercvu:getVetDocumentChangesListRequest> | |||
</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:getVetDocumentChangesListRequest> | |||
<merc:localTransactionId>a10003</merc:localTransactionId> | |||
<merc:initiator> | |||
<com:login>mercury_user</com:login> | |||
</merc:initiator> | |||
<base:updateDateInterval> | |||
<base:beginDate>2015-09-30T00:00:00</base:beginDate> | |||
<base:endDate>2015-10-10T00:00:00</base:endDate> | |||
</base:updateDateInterval> | |||
<ent:enterpriseGuid>guid </ent:enterpriseGuid> | |||
</merc:getVetDocumentChangesListRequest> | </merc:getVetDocumentChangesListRequest> | ||
</app:data> | </app:data> |
Текущая версия на 15:41, 2 июня 2017
Общие сведения
Операция GetVetDocumentChangesListOperation предназначена для получения ветеринарно-сопроводительных документов (ВСД) предприятия, созданных или измененных за указанный интервал дат (получение истории изменений). На вход системы передаются следующие сведения:
- информация о пользователе - инициаторе запроса;
- информация о хозяйствующем субъекте и предприятии, для которых осуществляется поиск ВСД;
- временной интервал, за который будет осуществляться поиск ВСД.
Результатом выполнения данной операции является:
- пользователю передаются сведения о запрашиваемых ВСД.
Запрашиваться могут только те ВСД, где ветеринарное управление инициатор запроса обслуживает указанные в запросе предприятия.
Возможные сценарии
При обработке запроса возможны следующие сценарии:
- Запрос успешно обработан.
- Произошла ошибка при обработке запроса.
- Некорректный запрос.
- Внутренняя ошибка системы.
Используемые пространства имён и типы
|
|
Общие отличия между версией для хозяйствующих субъектов и ветеринарных управлений
Различающиеся параметры | Версия для хозяйствующих субъектов | Версия для ветеринарных управлений |
---|---|---|
Пространство имён | 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 |
Данные запроса
Структура данных запроса в формате ХML.
<mercvu:getVetDocumentChangesListRequest
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>
<com:login>{xs:NCName}</com:login>
</mercvu:initiator>
<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>
</mercvu:getVetDocumentChangesListRequest>
Объект getVetDocumentChangesListRequest
Корневой элемент содержимого заявки на получение списка версий, созданных или измененных за указанный интервал дат.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
localTransactionId | Идентификатор заявки в клиентской системе. | xs:NCName | 1 |
initiator | Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. | argc:User | 1 |
listOptions | Параметры запрашиваемого списка. | bs:ListOptions | 0..1 |
updateDateInterval | Интервал времени обновления. В список попадают все записи, дата обновлений которых попадает в указанный интервал. | bs:DataInterval | 1 |
businessMember | Идентификаторы обслуживаемых предприятия и ХС, по которым производится поиск ВСД. | bs:UUID | 1 - при работе от имени ветеринарного управления, указывается businessMember; если работа ведётся из ИС хозсубъекта, можно по-прежнему указывать enterpriseGuid. |
enterpriseGuid | Идентификатор предприятия, по которому производится поиск ВСД. | bs:UUID |
Объект ..Request/initiator
Объект содержит сведения о пользователе, инициирующем запрос к шлюзу.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
UUID | Идентификатор пользователя, зарегистрированного в системе Меркурий. | bs:UUID | 0..1 |
login | Логин пользователя. Для авторизации достаточно указать один из параметров. Если указаны оба реквизита, то приоритет остаётся за UUID. | xs:NCName | 0..1 |
Объект ..Request/listOptions
Объект содержит сведения о параметрах запрашиваемого списка ВСД.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
count | Максимальное запрашиваемое количество объектов в списке.
|
xs:nonNegativeInteger | 0..1 |
offset | Номер элемента, по которому осуществляется смещение первого элемента списка.
|
xs:nonNegativeInteger | 0..1 |
Объект ..Request/updateDateInterval
Объект содержит сведения об интервале времени, за который необходимо получить обновления.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
beginDate | Дата, начиная с которой пользователь получит историю изменений ВСД, на указанном предприятии. | bs:DataInterval | 1 |
endDate | Конец временного интервала. | bs:DataInterval | 0..1 |
Объект ..Request/businessMember
Объект содержит сведения о хозяйствующем субъекте, для которого запрашивается список ветеринарных сертификатов. Для хозяйствующих субъектов остаётся enterpriseGuid.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
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 |
Данные ответа
Структура данных ответа в формате ХML.
<getVetDocumentChangesListResponse xmlns:mercvu="http://api.vetrf.ru/schema/cdm/mercury/vu/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>1</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>true</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:String255}</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>
</getVetDocumentChangesListResponse>
Объект getVetDocumentChangesListResponse
Объект содержит сведения о результатах обработки запроса на получение истории изменений ВСД предприятия.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
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 | Тип ВСД. | 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:String255 | 0..1 |
waybillDate | Дата товарно-транспортной накладной. | xs:date | 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 | Является ли груз некачественным.
Элемент может не указываться. В этом случае значение по-умолчанию устанавливается 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 | Наименование продукции в соответствии с номенклатурой производителя | bs:String255 | 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 | Наименование конкретного вида упаковки | bs:String255 | 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 | Идентификатор записи в справочнике целей. | bs:UUID | 1 |
GUID | Глобальный идентификатор записи в справочнике целей. | bs:UUID | 1 |
Объект ..Response/vetDocumentList/vetDocument/broker
Объект содержит сведения о хозяйствующем субъекте-посреднике (перевозчик продукции).
Поле | Описание | Тип | Обязательность |
---|---|---|---|
UUID | Идентификатор хозяйствующего субъекта - перевозчика продукции (посредника). | bs:UUID | 1 |
GUID | Глобальный идентификатор хозяйствующего субъекта - перевозчика продукции (посредника). | bs:UUID | 1 |
Объект ..Response/vetDocumentList/vetDocument/transportInfo
Объект содержит информацию о транспорте в котором будет перемещаться партия продукции.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
transportType | Тип транспортного средства. | shp:TransportType | 1 |
transportNumber | Номер транспортного средства. | shp:TransportNumber | 1 |
Объект ..Response/vetDocumentList/vetDocument/transportInfo/transportNumber
Сведения о номере транспортного средства.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
vehicleNumber | Номер транспортного средства. | bs:String255 | 1 |
Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList
Объект содержит информацию о списке пунктов перегрузки.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
cargoReloadingPoint | Пункт перегрузки транспортной партии в другое транспортное средство. | shp:CargoReloadingPoint | 0..* |
Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint
Объект содержит информацию о пункте перегрузки.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
name | Название пункта перегрузки. | bs:String255 | 1 |
nextTransport | Сведения о дальнейшем транспорте. | shp:TransportInfo | 1 |
Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint/nextTransport
Объект содержит сведения о транспорте, которым далее последует транспортная партия.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
transportType | Тип транспортного средства. | shp:TransportType | 1 |
transportNumber | Номер транспортного средства. | shp:TransportNumber | 1 |
Объект ..Response/vetDocumentList/vetDocument/cargoReloadingPointList/cargoReloadingPoint/nextTransport/transportNumber
Сведения о номере транспортного средства.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
vehicleNumber | Номер транспортного средства. | bs:String255 | 1 |
Объект ..Response/vetDocumentList/vetDocument/confirmedBy
Объект содержит сведения о ветеринарном враче, оформившим ВСД.
Поле | Описание | Тип | Обязательность |
---|---|---|---|
fio | ФИО врача, оформившего ветеринарно-сопроводительный документ. | bs:String255 | 1 |
post | Должность врача, оформившего ветеринарно-сопроводительный документ. | bs:String255 | 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-vu.service</app:serviceId>
<app:issuerId>issuerId</app:issuerId>
<app:issueDate>2015-01-10T17:03:00</app:issueDate>
<app:data>
<mercvu:getVetDocumentChangesListRequest>
<mercvu:localTransactionId>a10003</mercvu:localTransactionId>
<mercvu:initiator>
<com:login>mercury_user</com:login>
</mercvu:initiator>
<base:updateDateInterval>
<base:beginDate>2015-09-30T00:00:00</base:beginDate>
<base:endDate>2015-10-10T00:00:00</base:endDate>
</base:updateDateInterval>
<mercvu:businessMember>
<ent:businessEntity>
<base:guid>guid</base:guid>
</ent:businessEntity>
<ent:enterprise>
<base:guid>guid</base:guid>
</ent:enterprise>
</mercvu:businessMember>
</mercvu:getVetDocumentChangesListRequest>
</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:getVetDocumentChangesListRequest>
<merc:localTransactionId>a10003</merc:localTransactionId>
<merc:initiator>
<com:login>mercury_user</com:login>
</merc:initiator>
<base:updateDateInterval>
<base:beginDate>2015-09-30T00:00:00</base:beginDate>
<base:endDate>2015-10-10T00:00:00</base:endDate>
</base:updateDateInterval>
<ent:enterpriseGuid>guid </ent:enterpriseGuid>
</merc:getVetDocumentChangesListRequest>
</app:data>
</app:application>
</ws:submitApplicationRequest>
</soapenv:Body>
</soapenv:Envelope>
Коды ошибок
В таблице содержатся коды ошибок, которые может вернуть приложение.
Код | Описание ошибки |
---|---|
MERC30303 | Начало временного интервала позже его окончания. |
MERC30180 | Предприятие с указанным идентификатором не найдено в реестре РСХН, либо идентификатор не соответствует установленному формату. |