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

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

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

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

```xml
<!-- Содержимое 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://mcp-everything.ru/integrations/vetis-mercury/scenarios/poluchit-spisok-vhodyaschih-vsd.md)
- [Погасить входящий ВСД при приёмке товара](https://mcp-everything.ru/integrations/vetis-mercury/scenarios/pogasit-vhodyaschiy-vsd-pri-priemke.md)

---

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