# Как получить доступ к ВетИС.API

**Раздел:** **ВетИС** (vetis.md)

Для работы с ветеринарными сопроводительными документами (ВСД) из Меркурий-ИИ необходимо подключиться к государственной системе через ВетИС.API 2.1. Для этого нужно получить специальные реквизиты доступа, указать их в настройках склада и проверить работу интеграции на тестовом контуре.

## Какие данные нужны для подключения
Для работы в государственной системе «Меркурий» через браузер используется **личный кабинет хозяйствующего субъекта**.

Однако обычного логина и пароля от этого кабинета недостаточно для подключения Меркурий-ИИ.

Интеграция работает через **ВетИС.API**, для которого необходимо получить отдельные реквизиты:

- **API Login** — логин для программного доступа.
- **API Password** — пароль для API.
- **APIKey** — ключ доступа к сервису.
- **IssuerID** — идентификатор хозяйствующего субъекта.
- **GUID площадки** — идентификатор предприятия, с документами которого будет работать программа.
- **Логин уполномоченного** — пользователь, от имени которого выполняется гашение ВСД.

Реквизиты указываются для конкретного склада в Меркурий-ИИ.

## Получение тестового доступа
Начинать подключение следует с тестового контура ВетИС. Он позволяет проверить обмен документами и работу гашения без использования рабочего контура.

### Шаг 1. Подайте заявку
Откройте страницу подачи заявок:

**Получить тестовый доступ к ВетИС.API**

Заполните заявление на предоставление доступа. При указании информационной системы используйте название **«Меркурий-ИИ»**.

### Шаг 2. Получите реквизиты
После обработки заявки на указанную электронную почту поступят тестовые реквизиты для работы с API и сведения о доступе к тестовому кабинету хозяйствующего субъекта.

Сохраните полученные данные — они понадобятся для настройки интеграции.

### Шаг 3. Укажите ключи в Меркурии
1. На главном экране Меркурий-ИИ выберите нужный склад.
2. Откройте **«Интеграции → Меркурий (ВетИС)»**.
3. Раскройте блок **«Ключи склада»**.
4. Выберите контур **«Тест»**.
5. Заполните полученные реквизиты.
6. Нажмите **«Сохранить ключи»**.

**Важно:** не отправляйте пароль API в переписке с разработчиком или технической поддержкой. Вводите его непосредственно в настройках Меркурия.

## Настройка ключей склада
Блок **«Ключи склада»** находится в верхней части вкладки **«Меркурий (ВетИС)»**.

Настройки сохраняются для склада, который выбран в шапке Меркурий-ИИ.

### Контур
Выбор среды, с которой будет работать программа:

- **Тест** — проверка подключения и работы интеграции.
- **Прод** — рабочая система ВетИС для обработки реальных документов.

При первоначальной настройке выберите **«Тест»**.

### API Login
Логин для доступа к ВетИС.API. Укажите значение, полученное при оформлении доступа.

### API Password
Пароль для доступа к API.

При вводе символы скрываются. Если пароль уже сохранён и менять его не требуется, оставьте поле пустым — существующее значение сохранится.

### APIKey
Ключ доступа к ВетИС.API, выданный для подключения информационной системы.

### IssuerID (ХС)
Идентификатор хозяйствующего субъекта, от имени которого выполняются запросы к ВетИС.

### GUID площадки
Уникальный идентификатор предприятия (площадки), зарегистрированного в системе «Цербер».

Это должна быть площадка, соответствующая складу, выбранному в Меркурий-ИИ.

GUID можно найти в сведениях о площадке в государственной системе «Меркурий».

### Логин уполномоченного
Логин пользователя, от имени которого выполняются операции гашения ветеринарных документов.

Если оставить поле пустым, программа использует значение **API Login**.

### Сохранить ключи
После заполнения полей нажмите **«Сохранить ключи»**.

Если при сохранении возникнет ошибка, её описание появится в блоке настроек.

При настройке другого склада необходимо выбрать его в шапке Меркурия и указать соответствующие реквизиты.

### Если настройки недоступны
Если программа сообщает, что для работы ВетИС не подготовлена структура базы данных, может потребоваться обновление структуры (скрипт 00200).

Следуйте сообщению программы: закройте и снова откройте базу. Если проблема сохраняется, обратитесь в техническую поддержку.

## Переход на рабочий контур
После успешной проверки интеграции на тестовом контуре можно оформить доступ к рабочей системе ВетИС.

Для этого подаётся отдельная заявка с использованием **усиленной квалифицированной электронной подписи (УКЭП)**.

Рабочий контур использует собственные реквизиты подключения. Тестовые ключи для него не подходят.

После получения рабочего доступа:

1. Откройте **«Интеграции → Меркурий (ВетИС)»**.
2. Выберите нужный склад.
3. В блоке **«Ключи склада»** переключите контур на **«Прод»**.
4. Укажите продуктивные реквизиты доступа.
5. Нажмите **«Сохранить ключи»**.

**Важно:** не переключайте программу на рабочий контур до получения продуктивных ключей.

При работе с ВетИС.API необходимо следить за корректностью запросов. Если доля ошибок шлюза превышает установленный порог (около 10% за сутки), доступ к продуктивному контуру может быть ограничен.

## Проверка подключения и работа с ВСД
После сохранения ключей можно перейти к журналу входящих ветеринарных сопроводительных документов. Он находится на той же вкладке **«Меркурий (ВетИС)»**.

Основные элементы журнала:

- **Обновить** — запросить входящие ВСД через ВетИС.API.
- **Погасить** — оформить гашение выбранного ветеринарного документа.
- **Статус** — фильтр документов: «Все», «Непогашенные», «Погашенные».
- **Таблица ВСД** — список полученных документов и сведения об их состоянии.

Для первоначальной проверки нажмите **«Обновить»** и проверьте результат синхронизации.

Если обмен работает, можно переходить к обработке входящих документов.

Перед гашением ВСД обязательно сверяйте документ с фактически поступившей продукцией.

Подробная инструкция — **«Журнал ВСД»** (vetis-journal.md).

## Официальная документация
Подробные сведения о подключении, получении доступа и работе с государственной системой опубликованы в официальной справке Россельхознадзора:

**ВетИС.API — официальная документация**.