Интеграция 1С с Меркурием: как автоматизировать ветеринарный учёт

Интеграция 1С с Меркурием (часто пишут «интеграция 1с с меркурием») — это автоматический обмен данными между товароучётной системой 1С и государственной информационной системой «Меркурий» Россельхознадзора. Компании, работающие с продукцией животноводства, с 2018 года обязаны оформлять каждое движение товара электронным ветеринарным сопроводительным документом (эВСД). Ручной ввод в веб-интерфейс Меркурия отнимает до 10–15 минут на один сертификат, а при сотнях транзакций в день это превращается в отдельную должность. Интеграция передаёт нужные поля из 1С одним кликом — бухгалтер или кладовщик получает готовый эВСД, не покидая привычного учётного интерфейса.

Статья адресована ИТ-директорам и системным администраторам среднего бизнеса, которые отвечают за стабильность 1С и интеграции с внешними системами. Вы узнаете, какие варианты подключения существуют, что нужно подготовить в конфигурации 1С и как выстроить обмен так, чтобы он не останавливал отгрузки, даже если серверы Россельхознадзора временно недоступны.

Зачем бизнесу интеграция с ГИС Меркурий

Без интеграции процесс выглядит так: сотрудник выписывает накладную в 1С, затем переключается в веб-интерфейс Меркурия, вручную заполняет поля по номенклатуре, ветеринарным документам, датам выработки и получателю, подписывает сертификат и возвращается в 1С, чтобы проставить внешний идентификатор. Каждое переключение — риск опечатки: перепутанная дата или код продукции делает эВСД недействительным, а партию — неотгружаемой.

Интеграция 1С с Меркурием устраняет двойной ввод: система сама подтягивает из учёта номенклатуру, серии, объём и контрагента, формирует заявку, отправляет её в Меркурий через API и записывает полученный UUID сертификата обратно в документ 1С. Главные выгоды:

• Сокращение трудозатрат: на оформление одного сертификата уходит 5–15 секунд вместо нескольких минут;
• Исключение ошибок ручного ввода — расхождений по продукции и датам;
• Сквозная прослеживаемость: акты несоответствия сразу видны в цепочке движения;
• Экономия на штрафах: за отсутствие эВСД при проверке грозит административная ответственность по ст. 10.8 КоАП РФ.

Как устроен обмен данными между 1С и Меркурием

Обмен строится по модели «1С → шлюз / коннектор → ВетИС.API → Меркурий». 1С не обращается напрямую к государственной системе, а использует промежуточный слой — подсистему «ВетИС.API», принимающую запросы и возвращающую ответы в формате XML или JSON. В типовых конфигурациях этот слой реализован через внешнюю компоненту или HTTP-сервисы, которые обновляются вместе с релизами 1С.

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

Технически выделяют три потока:

1. Исходящие эВСД — формируются из документов 1С (реализация, перемещение);
2. Входящие эВСД — поступают от поставщиков, подлежат гашению;
3. Справочники — синхронизация номенклатуры, площадок, хозяйствующих субъектов (ХС) и поднадзорных объектов между 1С и реестром Россельхознадзора.

Чтобы обмен работал, нужны: действующий сертификат электронной подписи (УКЭП), зарегистрированный в ВетИС.Паспорт; актуальные версии конфигурации 1С (для 1С:Бухгалтерия 8 ред. 3.0 — не ниже рекомендуемой фирмой «1С»); стабильный интернет-канал — тайм-аут запроса к API составляет 30 секунд.

Способы интеграции 1С с Меркурием

Существуют три основных подхода. Выбор зависит от сложности вашего учёта, количества операций и бюджета на сопровождение.

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

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

Прямая интеграция через API Меркурия (ВетИС.API). Используется в нетиповых учётных системах или при глубокой кастомизации. Требует квалификации программиста: нужно реализовать подпись запросов, обработку ответов, повторные попытки. Подробнее о технических аспектах таких проектов мы писали в статье об API-интеграциях 1С.

Требования к конфигурации и подготовка 1С

Прежде чем настраивать обмен, убедитесь, что учётная система готова:

• Номенклатура в 1С должна иметь заполненные коды ВетИС (ГУИД) для каждой позиции, подлежащей ветеринарному контролю;
• Площадки (склады, цеха) зарегистрированы в реестре поднадзорных объектов и сопоставлены со структурными единицами в справочнике «Подразделения»;
• Хозяйствующие субъекты (ваша организация и контрагенты) имеют корректные ИНН и зарегистрированы в системе Цербер;
• Пользователь, от имени которого 1С подписывает запросы, обладает действующей УКЭП, выпущенной УЦ ФНС или его доверенным лицом.

Для 1С:Бухгалтерия 8 ред. 3.0 и 1С:ERP Управление предприятием 2.5 интеграция поддерживается на типовых релизах без дополнительных модулей. Актуальные обновления включают изменения API Меркурия — например, переход на новую версию протокола в 2024 году. Проверьте, что номер релиза не ниже рекомендованного на сайте its.1c.ru.

На серверной стороне понадобится настройка прокси, если сеть организации изолирована. Адреса ВетИС.API: api.vetrf.ru и service.vetrf.ru должны быть доступны по портам 443 (HTTPS). Брандмауэр часто блокирует исходящие соединения — это первая причина, почему «ничего не отправляется».

Пошаговая настройка интеграции на примере типовой 1С

Для администратора процесс выглядит так (на примере 1С:Бухгалтерия 8, ред. 3.0 с включённой подсистемой ВетИС):

1. Получите доступ к ВетИС.Паспорт — зарегистрируйте предприятие и пользователя с адресом электронной почты. Выпустите сертификат УКЭП для сотрудника, ответственного за подписание эВСД.
2. В 1С перейдите в раздел «НСИ и администрирование» → «Интеграция с ИС» → «ВетИС». Включите флажок «Использовать обмен с ВетИС».
3. Заполните реквизиты подключения: идентификатор пользователя ВетИС, его пароль, адрес сервера api.vetrf.ru, порт 443.
4. Настройте учётную запись электронной подписи: выберите сертификат из хранилища личных сертификатов Windows, укажите путь к закрытому ключу.
5. Выполните начальную синхронизацию справочников: «Синхронизация номенклатуры» и «Синхронизация площадок». Убедитесь, что в логе нет ошибок сопоставления.
6. Создайте тестовый документ «Реализация товаров», заполните накладную и нажмите кнопку «Оформить эВСД». Лог обмена покажет статус: «Создан» или «Отклонён». При успехе в карточку реализации проставится UUID сертификата.
7. Проверьте гашение входящего эВСД: попросите контрагента прислать тестовый транспортный сертификат. В документе «Поступление товаров» нажмите «Запросить входящие эВСД» и выполните гашение.

После успешного теста перенесите настройки в продуктивную базу и обучите пользователей. Обратите внимание: кнопка «Оформить эВСД» должна быть доступна только в документах с подконтрольной номенклатурой — проверьте отборы в правах доступа.

Типичные проблемы и как их решать

Вот сбои, с которыми сталкиваются практически все внедрения:

Ошибка «Не найдена площадка». Возникает, если адрес склада в 1С не совпадает с площадкой в реестре ВетИС. Исправляется ручным сопоставлением в регистре сведений «Соответствие площадок ВетИС».

Дублирование сертификатов. При повторном нажатии кнопки система может создать второй эВСД на уже оформленную партию. Правильное поведение — не гасить дубликат вручную, а аннулировать его через 1С с причиной «ошибка оператора». Иначе гашение дубликата нарушит цепочку прослеживаемости.

Тайм-аут запроса к API. Сервер Меркурия иногда не укладывается в 30 секунд, особенно в часы пик. Настройте в параметрах обмена повторные попытки (3-5) с интервалом 60 секунд. В крайнем случае — переключитесь на резервный адрес, если он предоставляется.

Расхождение номенклатуры после обновления 1С. Новый релиз может изменить регистры учёта номенклатуры и сбросить привязки ГУИДов. Поэтому перед каждым глобальным обновлением конфигурации делайте резервное копирование и после обновления прогоните повторную синхронизацию номенклатуры.

Когда нужна доработка интеграции

Типовой модуль покрывает стандартные цепочки: «произвели → продали», «купили → гашение». Но у среднего бизнеса часто возникают особые сценарии: распределение сырья из нескольких партий на производственный заказ, возврат продукции с заменой сертификата, интеграция с весами и маркировкой «Честный знак», автоматическое формирование эВСД на основе план-факта производства.

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

Если ваша интеграция требует нетиповых сценариев или вы столкнулись с ошибками, с которыми не справляется штатная поддержка, команда «Интеграции» поможет провести аудит, обновить конфигурацию и добавить недостающие механизмы обмена. Мы работаем удалённо по всей России, на обслуживании 1С у нас более 1000 клиентов.