MercuryG2B:GetVetDocumentList:v3.0: различия между версиями
(Новая страница: «== Общие сведения == == Спецификация запроса == == Спецификация ответа == == Классификатор сп...») |
|||
Строка 2: | Строка 2: | ||
== Спецификация запроса == | == Спецификация запроса == | ||
{| class="wikitable" | |||
! # | |||
! Название XML-элемента | |||
! Тип | |||
! Обязат. | |||
! Описание (нажмите [...] для отображения дополнительного описания) | |||
|- | |||
|001 | |||
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''<{{color|#660e7a|merc:}}getVetDocumentListRequest>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|002 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|merc:}}localTransactionId>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|merc:}}localTransactionId>'''}} | |||
|xs:NCName | |||
|[1..1] | |||
| style="width:52em;"| Идентификатор заявки в клиентской системе | |||
|- | |||
|003 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|merc:}}initiator>'''}} | |||
|vd:User | |||
|[1..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос </span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Является ответственным за выполнение бизнес-операции. | |||
* Здесь потребуется логин ветврача или пользователя ХС. Логин для базовой аутентификации не подойдёт.</div> | |||
</div> | |||
|- | |||
|004 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}login>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}login>'''}} | |||
|xs:NCName | |||
|[1..1] | |||
| style="width:52em;"| Логин пользователя | |||
|- | |||
|005 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|merc:}}initiator>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|006 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|bs:}}listOptions>'''}} | |||
|bs:ListOptions | |||
|[0..1] | |||
| style="width:52em;"| Параметры запрашиваемого списка | |||
|- | |||
|007 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}count>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}count>'''}} | |||
|xs:nonNegativeInteger | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Максимальное запрашиваемое количество объектов в списке</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* По умолчанию значение 100; | |||
* Максимально возможное значение 1000.</div> | |||
</div> | |||
|- | |||
|008 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}offset>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}offset>'''}} | |||
|xs:nonNegativeInteger | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Номер элемента, по которому осуществляется смещение первого элемента списка</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* По умолчанию значение 0.</div> | |||
</div> | |||
|- | |||
|009 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|bs:}}listOptions>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|010 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}vetDocumentType>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}vetDocumentType>'''}} | |||
|vd:VetDocumentType | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Тип ВСД</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* входящий (INCOMING). | |||
* исходящий (OUTGOING). | |||
* производственный (PRODUCTIVE). | |||
* транспортный (TRANSPORT). | |||
* возвратный (RETURNABLE).</div> | |||
</div> | |||
|- | |||
|011 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}vetDocumentStatus>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}vetDocumentStatus>'''}} | |||
|vd:VetDocumentStatus | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Статус ВСД</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* подтверждён (CONFIRMED). | |||
* аннулирован (WITHDRAWN). | |||
* погашен (UTILIZED).</div> | |||
</div> | |||
|- | |||
|012 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}issueDateInterval>'''}} | |||
|vd:issueDateInterval | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Интервал времени оформления документа</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Максимальная длина интервала - 31 день.</div> | |||
</div> | |||
|- | |||
|013 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}beginDate>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}beginDate>'''}} | |||
|xs:dateTime | |||
|[1..1] | |||
| style="width:52em;"| Начало временного интервала | |||
|- | |||
|014 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|bs:}}endDate>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}endDate>'''}} | |||
|xs:dateTime | |||
|[1..1] | |||
| style="width:52em;"| Конец временного интервала | |||
|- | |||
|015 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}issueDateInterval>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|016 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}consignor>'''}} | |||
|dt:BusinessMember | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Сведения об отправителе транспортной партии</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Фильтрация осуществляется по глобальному идентификатору ХС (consignor/businessEntity/guid) и площадки (consignor/enterprise/guid). | |||
* Если производится поиск по производственным документам (установлен фильтр vetDocumentType = PRODUCTIVE), поле consignor игнорируется.</div> | |||
</div> | |||
|- | |||
|017 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}businessEntity>'''}} | |||
|dt:BusinessEntity | |||
|[0..1] | |||
| style="width:52em;"| Хозяйствующий субъект-отправитель транспортной партии | |||
|- | |||
|018 | |||
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | |||
|bs:UUID | |||
|[1..1] | |||
| style="width:52em;"| Глобальный идентификатор хозяйствующего субъекта | |||
|- | |||
|019 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|dt:}}businessEntity>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|020 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|dt:}}enterprise>'''}} | |||
|dt:Enterprise | |||
|[0..1] | |||
| style="width:52em;"| Предприятие-отправитель транспортной партии | |||
|- | |||
|021 | |||
|style="font-weight: ; font-family: Courier;" |·········{{color|#190dbf|'''<{{color|#660e7a|bs:}}guid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|bs:}}guid>'''}} | |||
|bs:UUID | |||
|[1..1] | |||
| style="width:52em;"| Глобальный идентификатор предприятия | |||
|- | |||
|022 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''</{{color|#660e7a|dt:}}enterprise>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|023 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}consignor>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|024 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|vd:}}referencedDocument>'''}} | |||
|vd:ReferencedDocument | |||
|[0..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Связанные документы</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
* Поддерживается поиск по связанным документам с отношением (relationshipType) равным 1 и 6. | |||
* Поддерживаемые типы документов: 1-5 (транспортный документ). | |||
* Для документа обязательными к заполнению являются поля тип (type), номер (issueNumber) и дата (issueDate). | |||
* При поиске по связанному документу обязательно заполнение фильтра vetDocumentType.</div> | |||
</div> | |||
|- | |||
|025 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}issueNumber>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}issueNumber>'''}} | |||
|bs:String255 | |||
|[1..1] | |||
| style="width:52em;"| Номер документа | |||
|- | |||
|026 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}issueDate>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}issueDate>'''}} | |||
|xs:date | |||
|[1..1] | |||
| style="width:52em;"| Дата оформления документа | |||
|- | |||
|027 | |||
|style="font-weight: ; font-family: Courier;" |······{{color|#190dbf|'''<{{color|#660e7a|vd:}}type>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|vd:}}type>'''}} | |||
|dt:DocumentType | |||
|[1..1] | |||
| style="width:52em;"| Тип документа | |||
|- | |||
|028 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''</{{color|#660e7a|vd:}}referencedDocument>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|029 | |||
|style="font-weight: ; font-family: Courier;" |···{{color|#190dbf|'''<{{color|#660e7a|dt:}}enterpriseGuid>'''}}{{color|#131313|?}}{{color|#190dbf|'''</{{color|#660e7a|dt:}}enterpriseGuid>'''}} | |||
|bs:UUID | |||
|[1..1] | |||
|<div class="mw-collapsible mw-collapsed" data-expandtext=" ... " data-collapsetext="свернуть" style="font-weight: bold; width:52em;"> | |||
<span style="white-space:nowrap; font-weight: normal;">Идентификатор предприятия, по которому производится поиск документа</span> | |||
<div class="mw-collapsible-content" style="font-weight: normal;"> | |||
В результирующий список попадут (в общем случае, если не установлено других критериев отбора): | |||
* Транспортные ВСД, для которых ХС-отправитель соответствует заявителю (issuer), предприятие-отправитель - указанному идентификатору (enterpriseGuid). | |||
* Транспортные ВСД, для которых ХС-получатель соответствует заявителю (issuer), предприятие-получатель - указанному идентификатору (enterpriseGuid). | |||
* Производственные ВСД, для которых ХС-производитель соответствует заявителю (issuer), предприятие-производитель - указанному идентификатору (enterpriseGuid).</div> | |||
</div> | |||
|- | |||
|030 | |||
|style="font-weight: ; font-family: Courier;" |{{color|#190dbf|'''</{{color|#660e7a|merc:}}getVetDocumentListRequest>'''}} | |||
| | |||
| | |||
| style="width:52em;"| | |||
|- | |||
|} | |||
== Спецификация ответа == | == Спецификация ответа == |
Версия 05:15, 25 октября 2023
Общие сведения
Спецификация запроса
# | Название XML-элемента | Тип | Обязат. | Описание (нажмите [...] для отображения дополнительного описания) |
---|---|---|---|---|
001 | <merc:getVetDocumentListRequest> | |||
002 | ···<merc:localTransactionId>?</merc:localTransactionId> | xs:NCName | [1..1] | Идентификатор заявки в клиентской системе |
003 | ···<merc:initiator> | vd:User | [1..1] | Пользователь, зарегистрированный в системе Меркурий и инициирующий запрос
|
004 | ······<vd:login>?</vd:login> | xs:NCName | [1..1] | Логин пользователя |
005 | ···</merc:initiator> | |||
006 | ···<bs:listOptions> | bs:ListOptions | [0..1] | Параметры запрашиваемого списка |
007 | ······<bs:count>?</bs:count> | xs:nonNegativeInteger | [0..1] | Максимальное запрашиваемое количество объектов в списке
|
008 | ······<bs:offset>?</bs:offset> | xs:nonNegativeInteger | [0..1] | Номер элемента, по которому осуществляется смещение первого элемента списка
|
009 | ···</bs:listOptions> | |||
010 | ···<vd:vetDocumentType>?</vd:vetDocumentType> | vd:VetDocumentType | [0..1] | Тип ВСД
|
011 | ···<vd:vetDocumentStatus>?</vd:vetDocumentStatus> | vd:VetDocumentStatus | [0..1] | Статус ВСД
|
012 | ···<vd:issueDateInterval> | vd:issueDateInterval | [0..1] | Интервал времени оформления документа
|
013 | ······<bs:beginDate>?</bs:beginDate> | xs:dateTime | [1..1] | Начало временного интервала |
014 | ······<bs:endDate>?</bs:endDate> | xs:dateTime | [1..1] | Конец временного интервала |
015 | ···</vd:issueDateInterval> | |||
016 | ···<vd:consignor> | dt:BusinessMember | [0..1] | Сведения об отправителе транспортной партии
|
017 | ······<dt:businessEntity> | dt:BusinessEntity | [0..1] | Хозяйствующий субъект-отправитель транспортной партии |
018 | ·········<bs:guid>?</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор хозяйствующего субъекта |
019 | ······</dt:businessEntity> | |||
020 | ······<dt:enterprise> | dt:Enterprise | [0..1] | Предприятие-отправитель транспортной партии |
021 | ·········<bs:guid>?</bs:guid> | bs:UUID | [1..1] | Глобальный идентификатор предприятия |
022 | ······</dt:enterprise> | |||
023 | ···</vd:consignor> | |||
024 | ···<vd:referencedDocument> | vd:ReferencedDocument | [0..1] | Связанные документы
|
025 | ······<vd:issueNumber>?</vd:issueNumber> | bs:String255 | [1..1] | Номер документа |
026 | ······<vd:issueDate>?</vd:issueDate> | xs:date | [1..1] | Дата оформления документа |
027 | ······<vd:type>?</vd:type> | dt:DocumentType | [1..1] | Тип документа |
028 | ···</vd:referencedDocument> | |||
029 | ···<dt:enterpriseGuid>?</dt:enterpriseGuid> | bs:UUID | [1..1] | Идентификатор предприятия, по которому производится поиск документа В результирующий список попадут (в общем случае, если не установлено других критериев отбора):
|
030 | </merc:getVetDocumentListRequest> |
Спецификация ответа
Классификатор справочников и перечислений Codelist
Описание классификатора и назначения опциональных атрибутов типа dt:CodeType (@listID, @listAgencyID, @listName, @listVersionID, @name) приведено на странице: MercuryG2B:Codelist:v2.4r1
Примеры запросов
TODO
См. также
Вернуться к началу ↑
Вернуться на страницу профиля API MercuryG2B:Services:v3.0