Как подключить Меркурий к 1С и начать оформлять ВСД

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

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

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

Браузер или 1С: когда что выбирают

Работать с Меркурием можно двумя способами, и настройка интеграции нужна не всем.

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

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

Что сделать до настройки в 1С

Меркурий — это не самостоятельная база, а часть государственной системы ВетИС. Поэтому половина подготовки идёт вне программы.

• 🏢 Регистрация хозяйствующего субъекта. Организация или ИП должны быть зарегистрированы в компоненте «Цербер» и иметь оформленные поднадзорные объекты (площадки): склад, производство, магазин. Именно по этим площадкам потом ходят ВСД.
• 👤 Пользователь ВетИС. Нужна учётная запись с правами на оформление и гашение документов по вашим площадкам. От её имени 1С и будет работать.
• 🔑 Доступ к Vetis.API. Это главное отличие от ручной работы в браузере. Чтобы программа обменивалась данными автоматически, Россельхознадзор по вашей заявке выдаёт реквизиты доступа к шлюзу: идентификатор инициатора запросов (issuerId) и ключ apiKey. Заявка подаётся письмом от организации.

В какой конфигурации 1С есть обмен с Меркурием

Встроенная интеграция с ВетИС есть не везде. Проверьте свою программу до того, как искать настройки.

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

В торговых конфигурациях обмен включается функциональной опцией. В 1С:Рознице её ищут в разделе Администрирование, в УТ и ERP — в разделе НСИ и администрирование, в блоке настроек интеграции с государственными системами. После включения в программе появляется отдельное рабочее место для работы с ветеринарными документами.

Ввод реквизитов и авторизация в Vetis.API

Когда опция включена, в настройках интеграции заполняют параметры подключения к шлюзу. Здесь важно не перепутать данные доступа — это самое частое место отказа.

В карточке настройки обычно указывают:

1. Логин и пароль пользователя ВетИС — те, под которыми вы входите в Меркурий. Программа будет оформлять документы от имени этого пользователя.
2. issuerId — идентификатор инициатора запросов, выданный под вашу организацию.
3. apiKey — ключ доступа к Vetis.API из той же заявки.
4. Контур обмена — тестовый или рабочий (боевой). На тестовом контуре удобно проверить подключение, не затрагивая реальные документы.

После сохранения реквизитов запустите проверку соединения — в рабочем месте для этого есть команда проверки связи со шлюзом. Если связь есть, программа подтянет перечень ваших хозяйствующих субъектов. Это и есть сигнал, что авторизация прошла.

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

Синхронизация справочников: площадки и продукция

Обмен данными не заработает, пока 1С не поймёт, какие ваши объекты в Меркурии соответствуют объектам учёта в программе. Это два отдельных сопоставления.

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

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

Сопоставляйте номенклатуру заранее, по всему ассортименту поднадзорной продукции, а не в момент отгрузки. Иначе кладовщик упрётся в несопоставленную позицию при живом клиенте.

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

Гашение входящих ВСД при приёмке

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

В рабочем месте ВетИС есть список входящих документов по вашим площадкам. Порядок действий при приёмке:

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

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

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

Оформление исходящих ВСД при отгрузке и производстве

Исходящие свидетельства бывают нескольких видов, и путать их нельзя.

• 🚚 Транспортный ВСД — на перевозку партии: при отгрузке покупателю или перемещении между своими площадками.
• 🏭 Производственный ВСД — на продукцию, которую вы сами выработали или переработали (фасовка, изготовление). Он подтверждает происхождение новой партии.
• ↩️ Возвратный ВСД — при возврате продукции поставщику.

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

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

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

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

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

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

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

Все запросы к Vetis.API и ответы шлюза программа пишет в журнал обмена внутри рабочего места ВетИС. Если документ «завис» или не оформился, первым делом открывают этот журнал — там видно текст ошибки от самого Меркурия.

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