Ветис.API — Меркурий (ФГИС ВетИС): Сверить остатки и оформить отгрузку

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

Перед отгрузкой покупателю — проверить, что партия есть в складском журнале, и оформить транспортный ВСД.

Получи остатки площадки: заявка submitApplicationRequest с операцией GetStockEntryList (getStockEntryListRequest) — в результате актуальные записи складского журнала с объёмами и GUID записей.
Сверь их со своим складом: расхождение значит, что какая-то приёмка или списание не дошли до Меркурия.
Оформи отгрузку операцией PrepareOutgoingConsignment: в ней указываются запись складского журнала, из которой списывается объём, получатель и транспорт. Полная структура — в спецификации операции на help.vetrf.ru.
Справочные объекты (ХС, площадки, продукция) указывай по UUID или GUID; если передать оба, приоритет у UUID.
Отлаживай на тестовом контуре api2.vetrf.ru:8002 и проверяй результат в веб-интерфейсе t2-mercury.vetrf.ru.

<!-- Содержимое apl:data в submitApplicationRequest -->
<merc:getStockEntryListRequest>
  <merc:localTransactionId>stock20261024</merc:localTransactionId>
  <merc:initiator><vd:login>mercury_user</vd:login></merc:initiator>
  <bs:listOptions><bs:count>1000</bs:count><bs:offset>0</bs:offset></bs:listOptions>
  <dt:enterpriseGuid>ENTERPRISE_GUID</dt:enterpriseGuid>
</merc:getStockEntryListRequest>

Базовые 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 — PrepareOutgoingConsignment: оформление транспортной партии

Оформление исходящей партии и транспортного ВСД; структура — в спецификации операции.

POST /platform/services/3.0/ApplicationManagementService — GetStockEntryList: записи складского журнала

Актуальный список записей складского журнала площадки; структура — в спецификации операции.

Нюансы

Все операции передаются через 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