Ветис.API — Меркурий (ФГИС ВетИС): Погасить входящий ВСД при приёмке товара

Сценарий из mcp-everything. Актуально на 2026-10-24.

Кладовщик принял поставку мяса или молочной продукции — ВСД гасится из учётной системы, а товар попадает в складской журнал Меркурия.

Возьми данные ВСД из списка входящих (предыдущий сценарий): отправителя, получателя, партию, транспорт и сам документ.
Подай заявку submitApplicationRequest, в application.data — запрос операции ProcessIncomingConsignment (processIncomingConsignmentRequest): localTransactionId, initiator, delivery с фактическими данными (дата, отправитель, получатель, партия, транспорт, сопроводительные документы) и deliveryFacts.
В deliveryFacts укажи vetCertificatePresence = ELECTRONIC, результаты docInspection и vetInspection (CORRESPONDS, если всё совпало) и decision: ACCEPT_ALL — принять всё, PARTIALLY — частично, RETURN_ALL — вернуть.
Если факт расходится с ВСД больше чем на 5% по объёму, нужен discrepancyReport — акт несоответствия; при возврате — returnedDelivery. Номера транспортных средств обязательны.
Результат забери receiveApplicationResultRequest по applicationId. Ошибка бизнес-правил придёт в результате заявки, а не в ответе на подачу — проверяй именно его.

<!-- Содержимое apl:data в submitApplicationRequest; обёртка — как в сценарии выше -->
<merc:processIncomingConsignmentRequest>
  <merc:localTransactionId>inc20261024a</merc:localTransactionId>
  <merc:initiator><vd:login>mercury_user</vd:login></merc:initiator>
  <merc:delivery>
    <vd:deliveryDate>2026-10-24T09:30:00</vd:deliveryDate>
    <vd:consignor><!-- ХС и площадка отправителя из ВСД --></vd:consignor>
    <vd:consignee><!-- ХС и площадка получателя --></vd:consignee>
    <vd:consignment><!-- продукция, объём, единица измерения по факту --></vd:consignment>
    <vd:transportInfo><!-- тип и номер транспортного средства --></vd:transportInfo>
    <vd:accompanyingForms><!-- ссылка на гасимый ВСД и ТТН --></vd:accompanyingForms>
  </merc:delivery>
  <merc:deliveryFacts>
    <vd:vetCertificatePresence>ELECTRONIC</vd:vetCertificatePresence>
    <vd:docInspection><vd:result>CORRESPONDS</vd:result></vd:docInspection>
    <vd:vetInspection><vd:result>CORRESPONDS</vd:result></vd:vetInspection>
    <vd:decision>ACCEPT_ALL</vd:decision>
  </merc:deliveryFacts>
</merc:processIncomingConsignmentRequest>

Базовые URL

Боевой: https://api.vetrf.ru
Тестовый: https://api2.vetrf.ru:8002
WSDL v3.0: https://api.vetrf.ru/schema/platform/services/v3.0b-last/ams-mercury-g2b.service_v3.0.wsdl

Авторизация

Тип: Basic Auth

Базовая аутентификация логином и паролем, которые присылаются письмом после получения доступа; затем проверяется apiKey, передаваемый в теле запроса. Заявка на доступ подаётся через форму https://t2-aplms.vetrf.ru/pub/ (тестовый контур) или https://aplms.vetrf.ru/pub/ (продуктивный, нужна УКЭП руководителя). Поддержка — api@vetrf.ru.

Методы сценария

POST /platform/services/3.0/ApplicationManagementService — submitApplicationRequest: подача заявки

В ответе: applicationId, status, rcvDate.

Параметр	Где	Тип	Обяз.	Описание
`apiKey`	body	string	да	Ключ API
`application.serviceId`	body	string	да	mercury-g2b.service:3.0
`application.issuerId`	body	string	да	Идентификатор заявителя
`application.issueDate`	body	string	да	Дата подачи заявки
`application.data`	body	object	да	Тело заявки: запрос конкретной операции Меркурия

POST /platform/services/3.0/ApplicationManagementService — receiveApplicationResultRequest: результат заявки

Идентификатор заявки хранится 3 дня.

Параметр	Где	Тип	Обяз.	Описание
`apiKey`	body	string	да	Ключ API
`issuerId`	body	string	да	Идентификатор заявителя
`applicationId`	body	string	да	ID заявки из ответа submitApplicationRequest

POST /platform/services/3.0/ApplicationManagementService — ProcessIncomingConsignment: оформление входящей партии (гашение ВСД)

Параметр	Где	Тип	Обяз.	Описание
`localTransactionId`	body	string	да	ID заявки в клиентской системе
`initiator`	body	object	да	Пользователь Меркурия, оформляющий операцию
`delivery`	body	object	да	Фактические данные партии: дата, отправитель, получатель, транспорт, входящий ВСД
`deliveryFacts`	body	object	да	Результаты приёмки; решение ACCEPT_ALL, PARTIALLY или RETURN_ALL
`discrepancyReport`	body	object	нет	Акт несоответствия (если данные ВСД и факт расходятся)
`returnedDelivery`	body	object	нет	Возвратный ВСД при частичном или полном возврате

Нюансы

Все операции передаются через submitApplicationRequest (в application.data), а результат забирается receiveApplicationResultRequest; оба шага — синхронные вызовы.
Справочные объекты (ХС, площадки, продукция) указываются UUID или GUID; при обоих приоритет у UUID.
При гашении объём без акта несоответствия можно изменить не больше чем на 5%; номера транспортных средств обязательны.
Другие операции: RegisterProductionOperation, WithdrawVetDocument, GetVetDocumentByUuid, GetVetDocumentChangesList, GetStockEntryByGuid, GetStockEntryChangesList, MergeStockEntries, ResolveDiscrepancy, CheckShipmentRegionalization, управление пользователями ХС.
Тестовые веб-интерфейсы: https://t2-mercury.vetrf.ru/hs, https://t2-accounts.vetrf.ru.

Другие сценарии

Если этого недостаточно — официальная документация: https://help.vetrf.ru/wiki/Ветис.API Вся интеграция одним документом: https://mcp-everything.ru/integrations/vetis-mercury.md