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

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

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

Ниже — как устроена связка, что настроить перед первым обменом и как проходят приёмка, отгрузка и разбор расхождений.

Как 1С связывается с Меркурием через Ветис.API

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

Схема обмена простая:

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

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

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

• Цербер — реестр хозяйствующих субъектов и их площадок (поднадзорных объектов). Отсюда берутся идентификаторы ваших складов и контрагентов.
• Справочник продукции — перечень наименований подконтрольных товаров, к которому привязывается ваша номенклатура.

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

Что нужно получить и настроить до первого обмена

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

Что требуется от организации:

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

Когда доступ есть, обмен включается в самой 1С. В конфигурациях на «1С:Предприятии 8.3» (Бухгалтерия 3.0, Управление торговлей 11, Розница, ERP, Комплексная автоматизация) настройка живёт в разделе Администрирование — в группе настроек обмена с государственными информационными системами (в разных конфигурациях блок называется близко: «Обмен с ВетИС» или «Интеграция с ВетИС (Меркурий)»).

Там задаётся:

• флаг включения обмена с ВетИС;
• реквизиты доступа к Ветис.API (идентификатор и ключ);
• логины и пароли уполномоченных лиц;
• сопоставление ваших складов и подразделений с площадками из Цербера.

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

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

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

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

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

Основные типы исходящих ВСД:

• 🏭 производственный — оформляется при выработке продукции (переработка, фасовка, изготовление); в 1С его формируют из документа выпуска/производства;
• 🚚 транспортный — оформляется при перевозке и продаже готового товара; в 1С его создают из документа реализации (отгрузки);
• 🔁 возвратный — при возврате партии поставщику.

Порядок при отгрузке обычно такой:

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

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

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

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

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

Из 1С это делается при оформлении поступления:

1. Создаёте документ поступления товаров.
2. Запрашиваете из Ветис.API список входящих (неоплаченных) ВСД по вашей площадке.
3. Сопоставляете строки поступления с продукцией из ВСД.
4. Указываете фактически принятое количество и гасите документ.

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

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

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

Разбор расхождений и возвратные документы

На приёмке фактическое количество часто не сходится с тем, что указал поставщик. Меркурий это предусматривает, и 1С помогает оформить расхождение корректно.

Возможные ситуации:

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

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

Регламентные задания и автоматизация обмена

Чтобы не дёргать Ветис.API руками, обмен переводят на фоновый режим. За него отвечают регламентные задания 1С, которые работают по расписанию.

Что обычно автоматизируют:

• 🔄 получение результатов ранее отправленных заявок (из-за асинхронности ответ приходит не сразу);
• 📥 загрузку списка входящих ВСД по площадкам;
• 📚 обновление справочников продукции и хозяйствующих субъектов ВетИС.

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

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

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

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

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

Если ошибка сформулирована невнятно, посмотрите текст ответа Ветис.API — он сохраняется в документе обмена и обычно прямо указывает, какого реквизита не хватает или какое поле заполнено неверно.

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