GetVetDocumentListOperation v2: различия между версиями
Перейти к навигации
Перейти к поиску
Строка 30: | Строка 30: | ||
{| class="wikitable" | {| class="wikitable" | ||
! # | ! # | ||
! | ! Название XML-элемента | ||
! Тип | ! Тип | ||
! Кардинальность | ! Кардинальность |
Версия 19:56, 16 июля 2017
Общие сведения
Операция GetVetDocumentListOperation предназначена для получения всех ветеринарных сопроводительных документов (ВСД) предприятия. При этом список ВСД может быть отфильтрован по следующим критериям:
- Тип ВСД:
- входящий ВСД;
- исходящий ВСД;
- производственный ВСД;
- транспортный ВСД;
- возвратный ВСД.
- Статус ВСД:
- оформлен;
- погашен;
- аннулирован.
На вход системы передаются следующие сведения:
- информация о пользователе - инициаторе запроса;
- информация о предприятии и хозяйствующем субъекте, где осуществляется поиск ВСД;
- параметры, по которым будет отфильтрован список ВСД.
Результатом выполнения данной операции является:
- сведения о запрашиваемых ВСД.
Возможные сценарии
При обработке запроса возможны следующие сценарии:
- 1.1. Запрос успешно обработан. Пользователю вернулись все ВСД для запрашиваемой площадки.
- 1.2. Произошла ошибка при обработке запроса.
- • Некорректный запрос.
- • Внутренняя ошибка системы.
Данные запроса
# | Название XML-элемента | Тип | Кардинальность | Описание | Пример |
---|---|---|---|---|---|
1 | <merc:getVetDocumentListRequest> | ||||
2 | ···<merc:localTransactionId> | xs:NCName | [1..1] | Идентификатор заявки в клиентской системе. | <bs:guid>A00001</bs:guid> |
3 | ···<merc:initiator> | dt:User | [1..1] | Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос к шлюзу. Является ответственным за выполнение бизнес-операции. Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт. | |
4 | ······<dt:login> | xs:NCName | [1..1] | Логин пользователя, зарегистрированного в системе Меркурий. | <dt:login>user_ab_150101</dt:login> |
5 | ···</merc:initiator> | ||||
6 | ···<bs:listOptions> | bs:ListOptions | [0..1] | Параметры запрашиваемого списка. | |
7 | ······<bs:count> | xs:nonNegativeInteger | [0..1] | Максимальное запрашиваемое количество объектов в списке.
|
<bs:count>10</bs:count> |
8 | ······<bs:offset> | xs:nonNegativeInteger | [0..1] | Номер элемента, по которому осуществляется смещение первого элемента списка.
|
<bs:offset>2</bs:offset> |
9 | ···<bs:listOptions> | ||||
10 | ···<vd:vetDocumentType> | vd:VetDocumentType | [0..1] | Тип ВСД.
|
<vd:vetDocumentType>INCOMING</vd:vetDocumentType> |
11 | ···<vd:vetDocumentStatus> | vd:VetDocumentStatus | [0..1] |
|
<vd:vetDocumentStatus>CONFIRMED</vd:vetDocumentStatus> |
12 | ···<dt:enterpriseGuid> | bs:UUID | [1..1] | Идентификатор предприятия, по которому производится поиск документа. | <dt:enterpriseGuid>851cf860-e9a3-4981-b83e-3dc6cb06cf07</dt:enterpriseGuid> |
13 | </merc:getVetDocumentListRequest> |
Данные ответа
Примеры запросов
Получение списка всех входящих погашенных ВСД данного предприятия