ВетИС.API 3.0 развивается: что изменилось в интеграции с ФГИС «Меркурий»

ВетИС.API 3.0: от планов 2024 года до актуальной продуктивной редакции интеграционного профиля ФГИС «Меркурий». Из данной  статьи Вы узнаете, что меняется для разработчиков и бизнеса.

Развитие интеграционного шлюза ВетИС.API 3.0 продолжается уже несколько лет. Еще в 2024 году участники рынка обсуждали сроки перехода на новую версию API, затем появилась документация протокола и началась опытная эксплуатация.

Важно уточнить формулировку: речь идет не о новой версии самого «Меркурия», а о профиле API интеграционного шлюза ВетИС.API для хозяйствующих субъектов, работающих с компонентом ФГИС «Меркурий». В официальной документации Россельхознадзора сейчас опубликована продуктивная схема v3.0b-20260220, обозначенная как последняя версия production для профиля v3.0.

Для предприятий, которые работают с ФГИС «Меркурий» через учетные системы и интеграционные решения, это означает необходимость учитывать не только техническое обновление API, но и новые возможности самого государственного компонента.

От планов 2024 года — к актуальной версии API

Редакция ASP NEWS последовательно освещает развитие ВетИС.API 3.0 с момента подготовки перехода на новую версию.

31 января 2024 года мы писали о планах Россельхознадзора по переходу на новую версию интеграционного шлюза. Тогда сообщалось, что в марте 2024 года ВетИС.API 3.0 планировалось вывести в режим пилотной эксплуатации, а в апреле — в продуктивный контур. После этого хозяйствующие субъекты должны были получить возможность подключения к новой версии.

При этом уже на тот момент оставался важный вопрос о порядке перехода. Скорость подключения и режим — принудительный или опциональный — предполагалось определить с учетом темпов модернизации информационных систем хозяйствующих субъектов.

Эта тема получила продолжение в последующих публикациях ASP NEWS.

Мы отдельно рассказывали о переходе интеграционного шлюза ВетИС.API с версий 2.0 и 2.1 на 3.0, в декабре 2023 года публиковали описание протокола ВетИС.API 3.0 на основе официальной информации Россельхознадзора, а затем в апреле 2024 г. сообщали о том, что ВетИС.API 3.0 работает в статусе опытной эксплуатации.

Теперь официальная документация позволяет посмотреть на этот процесс уже с позиции актуального состояния API.

Что представляет собой ВетИС.API 3.0

ВетИС.API обеспечивает программное взаимодействие сторонних информационных систем с государственными компонентами ВетИС. Для бизнеса это означает возможность интегрировать внутренние учетные решения с ФГИС «Меркурий» и автоматизировать обмен необходимыми сведениями.

В официальной справочной системе Россельхознадзора для профиля MercuryG2B:Services:v3.0 опубликованы XSD-схемы и WSDL, необходимые для разработки интеграционного взаимодействия. В состав профиля входят сервисы работы с заявками, реестрами предприятий и хозяйствующих субъектов, справочной информацией, продукцией, регионализацией и адресными данными.

То есть использование актуальной редакции ВетИС.API 3.0 — это прежде всего изменение технического интерфейса взаимодействия с «Меркурием», которое необходимо учитывать разработчикам интеграционных решений.

Профиль включает несколько сервисов, в том числе:

• ApplicationManagementService — работа с заявками и операциями ФГИС «Меркурий»;
• EnterpriseService — работа с реестрами хозяйствующих субъектов и предприятий;
• DictionaryService — получение справочной информации;
• ProductService — работа с реестрами категорий и видов продукции;
• RegionalizationService — получение правил регионализации и информации о статусах регионов;
• IkarService — получение адресной информации.

Для интеграционных разработчиков это означает, что речь идет о полноценном техническом профиле взаимодействия с государственным компонентом, а не просто о смене номера версии.

Одно из заметных изменений 2026 года во ФГИС “Меркурий”: развитие производственных операций

Практическое значение версии ВетИС.API 3.0 можно увидеть на примере обновления ФГИС «Меркурий» до версии 6.99, которое состоялось 22 июля 2026 года.

Россельхознадзор расширил функциональность нового протокола, добавив возможность передачи и получения сведений о назначении номенклатуры, а также данных о массовой доле жира (МДЖ) и массовой доле белка (МДБ) в номенклатуре продукции.

Россельхознадзор сообщил о начале внедрения нового механизма отражения производственных процессов на основе технологических операций. Для разных производственных процессов система предусматривает специализированные сценарии оформления и набор соответствующих правил. Первой реализованной операцией стала «Добыча (вылов) водных биологических ресурсов».

До этого оформление производственных эВСД на партии добытых водных биоресурсов выполнялось с использованием производственных транзакций типа «Переработка/производство».

Теперь для соответствующих операций предусмотрен специализированный тип.

И это непосредственно касается интеграционного контура.

Россельхознадзор прямо указал, что изменения распространяются не только на пользователей веб-интерфейса ФГИС «Меркурий», но и на пользователей интеграционных решений. Для пользователей интеграционных решений Россельхознадзор предусмотрел поддержку:

• новый тип производственной операции «Добыча (вылов) водных биоресурсов»;
• передача атрибута «Режим промысла»;
• передача атрибута «Район промысла».

При этом для текущей версии ВетИС.API 2.1 Россельхознадзор сохраняет действующий сценарий оформления производственных эВСД через транзакции типа «Переработка/производство».

API развивается вместе с бизнес-логикой ФГИС «Меркурий»

Важный момент заключается в том, что обновление API нельзя рассматривать исключительно как техническую задачу для разработчиков.

Вместе с развитием интерфейса меняются и возможности самого ФГИС «Меркурий».

Например, в рамках обновления 6.99 система получила механизм контроля объемов добычи водных биоресурсов. При превышении объема квоты предусмотрены последовательные меры: сначала пользователь получает предупреждение с возможностью продолжить оформление производственных эВСД, а на следующем этапе при превышении квоты возможность оформления может быть ограничена.

Для интеграционных систем это означает, что необходимо учитывать не только структуру XML-сообщений и доступные методы API, но и новые правила обработки производственных операций.

Что это означает для разработчиков

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

В частности, если информационная система предприятия работает с добычей водных биоресурсов, потребуется обеспечить поддержку нового типа производственной операции и новых атрибутов.

Россельхознадзор отдельно рекомендует пользователям интеграционных решений обеспечить такую поддержку при работе на версии ВетИС.API 3.0.

Кроме того, разработчикам необходимо учитывать актуальную документацию профиля. В официальной справочной системе для ApplicationManagementService, например, предусмотрены операции формирования и обработки производственных и транспортных операций, получения ветеринарных документов, работы со списками ВСД и другими данными. Поэтому обновление интеграции — это не только изменение адреса подключения или версии схемы. Необходимо проверить, как учетная система формирует запросы, какие данные передает, как обрабатывает ответы ФГИС «Меркурий» и каким образом сохраняет полученные сведения.

АСП.Шлюз (Меркурий) в новом интеграционном контуре

Для предприятий, которые используют АСП.Шлюз (Меркурий), развитие ВетИС.API 3.0 является частью постоянного обновления интеграционного взаимодействия с государственными системами.

Интеграционный модуль АСП.Шлюз (Меркурий) автоматизирует обмен данными между любой учетной системой предприятия и ФГИС «Меркурий», сокращая объем ручных операций при работе с ветеринарными документами.

При этом принципиально важно разделять роли программного решения и государственной системы. АСП.Шлюз не заменяет ВетИС.API или ФГИС «ВетИС». Форматы обмена, доступные операции и требования к передаваемым сведениям определяются Россельхознадзором.

Задача интеграционного решения АСП — обеспечить корректную работу предприятия в соответствии с актуальными требованиями государственного API. Поэтому появление новых операций и атрибутов в ВетИС.API 3.0 означает необходимость своевременно проверять совместимость корпоративного контура с актуальной версией интеграционного интерфейса.

Что говорит актуальная документация

Сегодня в справочной системе Россельхознадзора для ВетИС.API 3.0 указана продуктивная схема v3.0b-20260220. При этом для ряда сервисов документация содержит отдельные сведения о продуктивном и тестовом контурах, а некоторые продуктивные точки доступа в настоящее время обозначены как временно недоступные. Из официальной документации: для ApplicationManagementService продуктивный endpoint указан, а для EnterpriseService, DictionaryService, ProductService, RegionalizationService и IkarService продуктивные точки доступа обозначены как «временно недоступно».  Поэтому при технической интеграции необходимо ориентироваться непосредственно на актуальную официальную документацию, а не на старые параметры подключения.

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

Что стоит проверить предприятиям

Официальная документация Россельхознадзора показывает, что v3.0 уже имеет продуктивную редакцию, а развитие функциональности продолжается. В справочной системе последней продуктивной схемой для профиля v3.0 указана v3.0b-20260220.

Для компаний, которые используют автоматизированный обмен с ФГИС «Меркурий», актуальными становятся несколько практических вопросов:

1. Какая версия ВетИС.API используется учетной системой сейчас.
2. Поддерживает ли интеграционное решение актуальный профиль 3.0.
3. Корректно ли обрабатываются новые типы производственных операций.
4. Есть ли возможность передавать новые обязательные или предусмотренные API атрибуты.
5. Корректно ли учетная система обрабатывает ответы и ошибки государственного сервиса.
6. Не используются ли в интеграции устаревшие схемы или параметры подключения.

Развитие ВетИС.API 3.0 показывает, что интеграция с ФГИС «Меркурий» постепенно становится более детализированной.

Развитие ВетИС.API 3.0 позволяет интеграционным системам поддерживать новые виды операций и передавать дополнительные сведения, предусмотренные актуальной функциональностью ФГИС «Меркурий».

Для разработчиков это означает необходимость следить за официальными схемами, WSDL и сообщениями Россельхознадзора. Для предприятий — регулярно проверять готовность учетных систем к изменениям.

АСП.Шлюз (Меркурий) в таком контуре остается инструментом автоматизации взаимодействия предприятия с ФГИС «Меркурий». А актуальность интеграции становится одним из ключевых условий стабильной работы с государственным ветеринарным документооборотом.

С уважением к Вашему делу, Ника Виноградова

Материал подготовлен на основе официальной документации Россельхознадзора и справочной системы ВетИС. В статье намеренно используется термин «ВетИС.API 3.0»: именно так профиль обозначен в официальной документации Россельхознадзора, тогда как ФГИС «Меркурий» является компонентом ФГИС «ВетИС».