# Меркурий (ВетИС)

**Раздел:** **Интеграции** (integracii.md)

Интеграция с государственной системой «Меркурий» позволяет получать входящие ветеринарные сопроводительные документы (ВСД) и гасить их непосредственно в Меркурий-ИИ. Обмен выполняется через ВетИС.API.

## Возможности и инструкции
Раздел предназначен для работы с входящими ветеринарными документами. Перед началом необходимо настроить доступ к ВетИС.API для склада.

- **Доступ к ВетИС** (vetis-access.md) — получение реквизитов подключения, выбор тестового или рабочего контура, настройка ключей склада.
- **Журнал ВСД** (vetis-journal.md) — получение входящих ветеринарных документов, просмотр их состояния и оформление гашения.

В окнах раздела предусмотрены кнопки **«?»**, открывающие соответствующие инструкции.

## Как открыть ВетИС
1. На главном экране Меркурия выберите склад, для которого требуется работа с ветеринарными документами.
2. Откройте раздел **«Интеграции»**.
3. Нажмите **«Меркурий (ВетИС)»**.

Откроется вкладка с настройками подключения и журналом входящих ВСД.

Кнопка **«?»** в заголовке вкладки открывает эту страницу справки.

## Настройка и работа с ВСД
Экран разделён на две основные части: настройки подключения к ВетИС и журнал входящих ветеринарных документов.

### Ключи склада
В раскрываемом блоке **«Ключи склада»** указываются реквизиты, необходимые для обмена с государственной системой.

Настройки включают:

- **Контур** — тестовый или рабочий (продуктивный).
- **API Login** — логин для доступа к ВетИС.API.
- **API Password** — пароль для доступа к API.
- **APIKey** — ключ доступа к сервису.
- **IssuerID** — идентификатор инициатора запросов.
- **GUID площадки** — идентификатор площадки в ВетИС.
- **Уполномоченный** — сведения об уполномоченном пользователе.

После заполнения реквизитов сохраните настройки.

**Важно:** обычный логин для входа на сайт хозяйствующего субъекта (ХС) не заменяет реквизиты доступа к ВетИС.API. Для интеграции необходимо получить соответствующие данные подключения.

На экране также есть ссылка **«Как получить тест»** с информацией о тестовом доступе.

Порядок получения ключей и описание всех полей приведены в инструкции **«Доступ к ВетИС»** (vetis-access.md).

### Журнал входящих ВСД
После настройки подключения можно работать с ветеринарными документами выбранного склада.

В журнале предусмотрены:

- получение входящих ВСД через ВетИС.API;
- просмотр списка документов и их статусов;
- поиск и фильтрация записей;
- гашение входящих ВСД.

Гашение используется для подтверждения получения продукции по ветеринарному сопроводительному документу.

Перед гашением проверьте документ и фактически поступившую продукцию. Подробный порядок действий описан в инструкции **«Журнал ВСД»** (vetis-journal.md).

### Если раздел недоступен
Если вместо журнала отображается сообщение о недоступности ВетИС, возможно, в базе данных ещё не подготовлена необходимая структура для работы интеграции.

В таком случае обратитесь в техническую поддержку Меркурия.