Вопрос актуальности версий интеграционных шлюзов государственных информационных систем (ГИС) всегда стоит остро, особенно когда речь идет о ВетИС (Меркурий). Россельхознадзор регулярно обновляет форматы обмена, выводит из эксплуатации старые версии и анонсирует новые. В данной статье мы разберем, как точно определить, какая версия API реализована в вашей конфигурации 1С, и проясним ситуацию со статусом версии 3.0.
Многие пользователи и администраторы задаются вопросом: где в интерфейсе или коде программы найти точный номер используемой версии протокола? Часто в разделе "О программе" или в справке этой информации нет. Давайте рассмотрим технический способ проверки, который работает для большинства типовых конфигураций (1С:ERP, Комплексная автоматизация, Управление торговлей, Бухгалтерия), использующих библиотеку интеграции с ГосИС.
Версия протокола определяется параметром ServiceID, который передается в систему ВетИС на этапе установки соединения. Чтобы узнать его, нам необходимо обратиться либо к настройкам подключения, либо к анализу исходящих пакетов данных.
Разберем основные методы идентификации версии.
В настройках обмена с ВетИС (или непосредственно в программном коде модуля обмена) ищется специфическая строка подключения. Она выглядит следующим образом:
mercury-g2b.service:2.1
В этой строке:
mercury-g2b.service — это имя сервиса (G2B означает Government to Business).2.1) — это и есть номер используемой версии API.Если вы видите значение 2.0, это повод для тревоги, так как данная версия выведена из эксплуатации. Однако в современных актуальных релизах 1С (например, КА 2.5.12 и выше) повсеместно используется версия 2.1.
Самый надежный способ убедиться в используемой версии — посмотреть "сырые" данные, которые 1С отправляет на сервер Меркурия. Для этого включим логирование запросов или воспользуемся инструментами отладки, если у вас есть права программиста.
В исходящем XML-файле (конверте SOAP-сообщения) в заголовке или теле запроса также фигурирует указание версии схемы данных. Если вы откроете файл запроса, обратите внимание на пространство имен или атрибуты версии.
Пример (упрощенный) того, как это может выглядеть в структуре данных:
<v2:submitApplicationRequest xmlns:v2="http://api.vetrf.ru/schema/cdm/application/v2">
<v2:apiKey>...</v2:apiKey>
<v2:serviceId>mercury-g2b.service:2.1</v2:serviceId>
...
Наличие строки mercury-g2b.service:2.1 гарантирует, что ваша система работает по протоколу версии 2.1.
Теперь разберем путаницу вокруг версии 3.0. В сообществе часто возникают вопросы: "Где найти 3.0?", "Почему в 1С до сих пор 2.1?".
Проанализируем текущую ситуацию. Версия ВетИС.API 3.0 действительно существует, но ее назначение отличается от простого "обновления Меркурия".
Таким образом, если вы видите в своей 1С версию 2.1 — это нормально и правильно. Ждать специального релиза "с переходом на 3.0" для обычного оформления ВСД не нужно.
Хотя версия API может оставаться 2.1, требования к наполнению документов меняются постоянно. Рассмотрим ключевые причины, по которым необходимо переходить на свежие релизы конфигураций (например, КА версии 2.5.12 и выше), даже если цифра API не изменилась.
С 1 сентября 2023 года (с учетом переходного периода до осени 2024 года) изменились правила подписания документов. Теперь сотрудники подписывают документы сертификатом физического лица, прикладывая сведения о МЧД. В протоколе обмена (даже версии 2.1) появились новые поля для передачи информации о доверенности. Старые релизы 1С просто не умеют формировать такую структуру XML, что приведет к ошибкам при отправке данных.
Для предприятий АПК, занимающихся животноводством, критически важна интеграция с компонентом "Хорриот". Операции по регистрации животных, эмиссии номеров и учету происходят через новые методы API. В типовых конфигурациях 1С функциональность для работы с Хорриотом добавляется именно в свежих обновлениях.
Россельхознадзор регулярно включает "мягкие" и "жесткие" проверки на своей стороне:
Чтобы 1С могла корректно обработать ошибки, возвращаемые сервером при непрохождении этих проверок, или предупредить пользователя заранее, механизмы обмена внутри конфигурации должны быть актуализированы.
Подведем итог нашему исследованию:
mercury-g2b.service в логах или коде. Актуальное значение — 2.1.Рекомендуем своевременно устанавливать обновления библиотеки интеграции ГосИС, чтобы избежать остановок в отгрузке продукции из-за несоответствия новым законодательным требованиям.