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

ФГИС Меркурий — государственная система ветеринарного сопровождения, в которой оформляются электронные ветеринарные сертификаты (ВСД) на продукцию животного происхождения. Если предприятие торгует мясом, молоком, рыбой, яйцами или кормами, оно обязано гасить и оформлять ВСД. Делать это вручную через веб-интерфейс Меркурия долго и рискованно: при больших объёмах документов легко пропустить срок гашения и получить штраф.

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

Что нужно подготовить до подключения

До начала настройки в 1С должна быть выполнена регистрация в самой системе Меркурий. Организация или ИП регистрируются через Госуслуги или через ветеринарное управление региона, после чего получают логин и пароль для входа в веб-версию. Без действующей учётной записи в Меркурии доступ к API не выдадут.

Второй обязательный шаг — получение доступа к шлюзу Ветис.API. Заявку подают через форму на сайте ветеринарного надзора или через службу поддержки Меркурия. В ответ приходят ключи: API Key, Issuer ID (идентификатор хозяйствующего субъекта и площадок) и логин с паролем для авторизации приложения. Эти данные конфиденциальны: по ним любой сможет оформлять ВСД от имени организации.

Также проверьте версию вашей конфигурации 1С. В типовых решениях (Управление торговлей 11, Комплексная автоматизация, ERP, Розница) интеграция с Меркурием встроена начиная с определённых релизов — убедитесь, что конфигурация обновлена до версии, где подсистема присутствует. Для старых или самописных конфигураций потребуется внешний модуль.

Какие способы интеграции существуют

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

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

Третий вариант — собственная разработка напрямую через Ветис.API. Это оправдано для крупных предприятий с нестандартными процессами, но требует программиста, знакомого с протоколом SOAP/REST шлюза и механизмом асинхронных заявок. Для типовой торговли такой путь избыточен.

Сравнение вариантов

Типовая подсистема 1С

Подходит для УТ 11, КА, ERP, Розницы. Обновляется вместе с конфигурацией, поддержка от вендора. Ограничение — нужна актуальная версия конфигурации.

Внешний модуль

Подходит для доработанных и старых конфигураций. Ограничение — зависимость от стороннего разработчика и риск несовместимости с новыми версиями API.

Собственная разработка

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

Как включить и настроить интеграцию в типовой 1С

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

После включения появится форма настройки обмена. В неё вводят параметры подключения к Ветис.API: адрес шлюза, логин и пароль приложения, API Key, Issuer ID хозяйствующего субъекта и площадки. Если у организации несколько обособленных площадок (складов, магазинов), каждая настраивается отдельно и привязывается к своему складу в 1С.

Затем настраивается расписание автоматического обмена. Регламентное задание периодически отправляет подготовленные заявки и загружает ответы: входящие ВСД, результаты гашения, изменения справочников. Рекомендуемый интервал — от 5 до 15 минут: слишком частые обращения шлюз может отклонять, а редкие приводят к задержке гашения.

1. 1
   Зарегистрируйте организацию в Меркурии и проверьте вход в веб-версию
2. 2
   Подайте заявку на доступ к Ветис.API и получите API Key, Issuer ID, логин и пароль приложения
3. 3
   Обновите конфигурацию 1С до версии с подсистемой интеграции или установите внешний модуль
4. 4
   Включите функциональность интеграции в настройках администрирования
5. 5
   Введите параметры подключения и привяжите площадки к складам 1С
6. 6
   Настройте регламентное задание автоматического обмена
7. 7
   Выполните тестовый обмен и проверьте загрузку входящих ВСД

Сопоставление номенклатуры и продукции

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

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

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

Как проверить, что обмен работает

Первый признак успешной настройки — в 1С начали загружаться входящие ветеринарные сертификаты. Откройте журнал входящих ВСД и сравните его со списком в веб-версии Меркурия: документы должны совпадать по номерам, датам и объёмам. Если в веб-версии сертификаты есть, а в 1С пусто, проверьте параметры подключения и журнал ошибок обмена.

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

Контрольные точки

Как проверить результат

Входящие ВСД в 1С

Норма

Список совпадает с веб-версией Меркурия, новые сертификаты появляются автоматически

Тревожный признак

В 1С пусто или документы загружаются с задержкой в часы

Статус заявок на гашение

Норма

Заявки уходят в статус «выполнена» в течение нескольких минут

Тревожный признак

Заявки висят в статусе «передана» или отклоняются с ошибкой

Остатки в журнале продукции

Норма

Остатки в 1С и в Меркурии сходятся после инвентаризации

Тревожный признак

Остатки расходятся, появляются «висящие» объёмы записей журнала

Типичные ошибки и ограничения

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

Учтите ограничения самого шлюза: Ветис.API работает в асинхронном режиме, ответ на заявку приходит не мгновенно, а шлюз может ограничивать частоту запросов при массовых выгрузках. Не отправляйте одну и ту же заявку повторно, не дождавшись результата первой, — это создаёт дубли и ошибки.

Отдельный риск — работа с просроченными ВСД. Сертификат нужно погасить в течение суток с момента приёмки товара. Если обмен сломан и документы копятся, гасите их вручную через веб-версию, чтобы не нарушить срок, и только потом разбирайтесь с интеграцией.

Частые вопросы

Можно ли работать в Меркурии без интеграции с 1С?

Да, веб-версия Меркурия доступна бесплатно и позволяет гасить и оформлять ВСД вручную. Это приемлемо при небольшом числе документов в день. При десятках и сотнях сертификатов ручная работа ведёт к пропускам сроков гашения и штрафам, поэтому интеграция с учётной системой становится практической необходимостью.

Какие конфигурации 1С поддерживают обмен с Меркурием?

Встроенная подсистема интеграции есть в актуальных версиях Управления торговлей 11, Комплексной автоматизации, ERP, Розницы и ряда отраслевых решений. Для устаревших или сильно доработанных конфигураций используют внешние модули. Перед настройкой сверьтесь с документацией к вашему релизу — состав подсистемы меняется от версии к версии.

Что делать, если заявка зависла в статусе «передана»?

Подождите: шлюз обрабатывает заявки асинхронно, и при нагрузке ответ может задерживаться. Если статус не меняется несколько часов, проверьте протокол обмена на ошибки, убедитесь, что регламентное задание работает, и запросите результат заявки повторно штатной командой. Не создавайте дубликат заявки, пока не получен ответ по первой.

Нужен ли отдельный доступ к API для каждого магазина?

Доступ к Ветис.API выдаётся на хозяйствующий субъект, но каждая обслуживаемая площадка (магазин, склад) имеет собственный идентификатор. В 1С каждая площадка настраивается отдельно и привязывается к своему складу, иначе гашение будет проходить не по тому подразделению и остатки журнала разойдутся.

Чем грозит несвоевременное гашение ВСД?

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

Можно ли оформлять исходящие ВСД из 1С?

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