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

Какие данные нужны для подключения

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

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

Интеграция работает через ВетИС.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.
• Погасить — оформить гашение выбранного ветеринарного документа.
• Статус — фильтр документов: «Все», «Непогашенные», «Погашенные».
• Таблица ВСД — список полученных документов и сведения об их состоянии.

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

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

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

Подробная инструкция — «Журнал ВСД».

Официальная документация

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

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