Как подключить Меркурий к 1С:Розница

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

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

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

Что понадобится перед началом настройки

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

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

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

Шаг 1. Регистрация в Меркурии и получение доступа к API

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

В результате заявки вы получаете ключевые параметры подключения: Issuer ID (идентификатор заявителя, он же API-ключ), а также логин и пароль технологического пользователя API. Эти данные приходят на указанную в заявке электронную почту. Сроки рассмотрения заявки могут занимать несколько рабочих дней — учитывайте это при планировании запуска.

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

Шаг 2. Включение интеграции в 1С:Розница

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

В настройках подключения укажите параметры, полученные на предыдущем шаге: адрес сервера ВетИС (обычно подставляется автоматически, есть переключатель «продуктивный/тестовый» контур — работайте только с продуктивным), Issuer ID, логин и пароль API-пользователя. Нажмите «Проверить подключение»: программа должна сообщить об успешном соединении.

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

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

Шаг 3. Настройка автоматического обмена

Ручной обмен (кнопки «Отправить/Получить») подходит для старта, но в ежедневной работе удобнее автоматический обмен по расписанию. В настройках интеграции включите регламентное задание обмена с ВетИС и задайте периодичность — для розничного магазина обычно достаточно обмена каждые 15–30 минут в рабочее время.

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

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

Работа с входящими ВСД: гашение при поступлении товара

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

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

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

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

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

Проверка подключения в настройках обмена

Норма

Сообщение об успешном соединении с сервером ВетИС

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

Ошибка авторизации — перепроверьте Issuer ID и пароль API

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

Норма

Список совпадает с входящими в веб-интерфейсе Меркурия

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

В 1С пусто или документы старые — обмен не выполняется

Статус после гашения

Норма

В веб-интерфейсе Меркурия ВСД отображается погашенным

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

В 1С «погашен», в Меркурии — нет: ответ не ушёл, смотрите журнал обмена

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

Норма

Позиции ВСД автоматически связываются с товарами 1С

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

Каждый документ требует ручного поиска — доработайте сопоставление

Производство и перемещения: когда нужны исходящие ВСД

Если магазин не только продаёт, но и перерабатывает продукцию (например, готовит полуфабрикаты из мяса) или перемещает товар между своими площадками, потребуется оформление исходящих и производственных ВСД. В 1С:Розница для этого используются соответствующие документы ВетИС: производственная операция и транспортная операция (перемещение).

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

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

Типичные ошибки и их устранение

Большинство проблем при обмене связано не с 1С, а с данными и доступами. Ниже — самые частые ситуации и способы их решения.

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

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

Когда типовой интеграции недостаточно

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

Маршрут решения

Как выбрать действие

Один магазин, приёмка и гашение ВСД, простые перемещенияДостаточно типовой интеграции 1С:Розница — настройте обмен и регламентное задание

Несколько юрлиц или сложное производствоОцените доработку конфигурации или специализированные отраслевые решения на базе 1С

Обмен нестабилен из-за канала связиНастройте обмен на сервере с резервным каналом и контролируйте журнал обмена

Нужен только просмотр ВСД без автоматизацииМожно ограничиться веб-интерфейсом Меркурия, но учёт в 1С придётся вести вручную

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

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

Нужна ли отдельная лицензия или платный модуль для обмена с Меркурием?

Нет, функциональность интеграции с ВетИС входит в типовую поставку 1С:Розница. Дополнительно оплачивается только сама подписка на обновления конфигурации (если она требуется по вашему договору) и, при необходимости, услуги настройщика.

Можно ли подключить несколько магазинов одной сети к одной базе 1С?

Да. Все площадки одного хозяйствующего субъекта обслуживаются одним API-ключом. Каждую площадку из Меркурия нужно сопоставить с соответствующим магазином/складом в 1С, после чего входящие ВСД будут распределяться по площадкам автоматически.

Что делать, если ВСД погашен в 1С, но в Меркурии он остался открытым?

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

Работает ли обмен в файловой версии 1С:Розница?

Работает, но с ограничением: регламентные задания выполняются только пока запущен сеанс программы. Если магазин закрывается и все выходят из 1С, обмен останавливается до следующего запуска. Для непрерывного обмена оставьте запущенный сеанс на выделенном компьютере.

Как быть, если поставщик оформил ВСД с ошибкой?

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

Нужно ли гасить ВСД на маркированную продукцию отдельно?

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