Как перейти на Ветис.API 3.0 в 1С и что делать пользователям 1С:УВС?

← На главную

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

Зачем нужен переход на Ветис.API 3.0?

Проанализируем основные причины обновления системы. Версия 3.0 была разработана Россельхознадзором для решения нескольких критических задач:

Повышение производительности: Система «Меркурий» испытывает колоссальные нагрузки после введения обязательной маркировки молочной продукции и интеграции с системой «Честный ЗНАК» (включая автоматическую отправку документов). Архитектура 3.0 спроектирована для более быстрой обработки «тяжелых» запросов.
Оптимизация структуры данных: В новой версии пересмотрена структура XML-сообщений. Это позволяет уменьшить избыточность передаваемой информации, что напрямую ускоряет парсинг ответов и чтение XML данных в учетных системах на базе 1С.
Улучшенная прослеживаемость: Внедрены расширенные поля для передачи кодов маркировки и агрегатов, для работы с которыми удобно использовать терминал сбора данных и мобильный клиент, что критично для производителей молочной продукции.
Групповые операции: В отличие от версии 2.1, в 3.0 расширена логика работы с пакетами данных, что снижает количество обращений к серверу при массовой регистрации ветеринарных сопроводительных документов (ВСД).

Технические ресурсы для разработчика: WSDL и XSD

Для начала работы нам необходимо получить актуальные файлы определений сервисов. На текущий момент официальная документация может запаздывать, поэтому рассмотрим способ получения схем напрямую с серверов Ветис. Для загрузки полного пакета файлов для версии 3.0 (бета) мы можем воспользоваться утилитой wget. Выполним следующие команды для загрузки необходимых компонентов:


wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/ams-mercury-g2b.service_v3.0.wsdl 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/ApplicationManagementService_v2.0.wsdl 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/mercury-g2b.service_v3.0.wsdl  
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/DictionaryService_v3.0.wsdl 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/IkarService_v3.0.wsdl 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/ProductService_v3.0.wsdl 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/EnterpriseService_v3.0.wsdl  
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/mercury_g2b_applications_v3.0.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/base_v2.0.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/application_v2.0.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/dictionary_v2.4.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/document_v2.4.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/application_ws_definitions_v2.0.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/base_ws_definitions_v2.0.xsd 
wget -nc http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/registry_ws_definitions_v2.4.xsd

Эти файлы позволят нам проимпортировать определения в среду 1С через объект WSСсылки. Разберем подробнее состав этих файлов: основные изменения сосредоточены в mercury-g2b.service_v3.0.wsdl и обновленном сервисе справочников DictionaryService_v3.0.wsdl. Последний теперь возвращает более детальную информацию о предприятиях и продукции, доступную ранее только через веб-интерфейс «Цербера».

Что делать пользователям 1С:УВС?

Выясним причину, по которой многие пользователи сейчас вынуждены искать альтернативу решению «1С:Управление ветеринарными сертификатами» (УВС). Как показывает практика и обсуждения экспертов, 1С:УВС разрабатывалась сторонним партнером в период, когда в типовых конфигурациях 1С (Бухгалтерия, ERP, КА) еще не было встроенной поддержки ВетИС.

Важный момент: на текущий момент развитие 1С:УВС практически остановлено, так как фирма «1С» интегрировала полноценный функционал взаимодействия с Меркурием в Библиотеку электронных документов (БЭД), которая входит в состав всех современных типовых решений.

Мы рекомендуем рассмотреть следующие варианты миграции:

Переход на встроенный функционал 1С:Бухгалтерии (БП): Как показывает опыт внедрений, для большинства предприятий (включая молочную отрасль) типового функционала БП 3.0 вполне достаточно. Доработки при переходе с УВС на БП минимальны.
Использование 1С:ERP или 1С:Комплексная автоматизация: Для крупных мясокомбинатов или молокозаводов, где требуется сложный учет производственных партий, лучше использовать эти конфигурации, так как механизмы прослеживаемости в них развиты наиболее полно.
Собственная разработка на базе нового API: Если у вас сильно кастомизированная база, стоит начать интеграцию Ветис.API 3.0 через создание собственных WS-прокси на основе полученных выше схем.

Особенности реализации интеграции в 1С

Разберем по шагам процесс подключения к новому сервису в среде 1С. Несмотря на то что состав методов в подсистеме обработки заявок (ApplicationManagementService) принципиально не изменился, нам нужно обратить внимание на маппинг полей.

Рассмотрим пример создания объекта прокси для работы с новой версией:


МестоположениеWSDL = "http://api.vetrf.ru/schema/platform/services/v3.0b-20231005/ams-mercury-g2b.service_v3.0.wsdl";
// В реальной задаче рекомендуется загрузить WSDL в объект WSСсылки в конфигураторе
Прокси = WSСсылки.Ветис_v3_0.СоздатьWSПрокси("http://api.vetrf.ru/schema/platform/services/3.0", "ApplicationManagementService", "ApplicationManagementServicePort");
Прокси.Пользователь = ЛогинAPI;
Прокси.Пароль = ПарольAPI;

При формировании заявок (объектов Application) в версии 3.0, обратите внимание на следующие нюансы:

Обработка ошибок: Система стала возвращать более детализированные коды ошибок. Это позволяет более точно диагностировать причины отказа в регистрации ВСД.
DictionaryService v3: При получении данных о продукции теперь необходимо использовать обновленные типы из dictionary_v2.4.xsd (или выше), которые поддерживают расширенные атрибуты МДЖ (массовой доли жира) и других характеристик.
Схемы XSD: Обратите внимание, что некоторые элементы изменили вложенность. Например, при передаче сведений о производителях в производственных транзакциях структура стала более плоской для повышения скорости парсинга.

Подводя итог, можно сказать, что переход на Ветис.API 3.0 не так страшен, как может показаться. Основная сложность заключается в необходимости тестирования всех цепочек документов с учетом новых схем. Для пользователей 1С:УВС сейчас самый подходящий момент, чтобы запланировать переход на встроенный функционал типовых конфигураций 1С, так как это обеспечит долгосрочную поддержку и своевременное обновление под требования законодательства.

← На главную