Обмен 1С с ФГИС «Меркурий»: от ключа Ветис.API до первого ВСД

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

Встроенная интеграция с ГИС Меркурий есть в торговых и производственных решениях: 1С:Управление торговлей 11, 1С:Комплексная автоматизация 2, 1С:ERP, а также в 1С:УНФ и 1С:Рознице. Обмен идёт напрямую с сервером Россельхознадзора через Ветис.API, без промежуточных программ.

Подготовка: доступы к ВетИС до открытия 1С

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

Что нужно получить

1. 🔑 Учётная запись администратора в «Ветис.Паспорт». Через неё руководитель или уполномоченный сотрудник управляет пользователями своего хозсубъекта. Вход — через Госуслуги (ЕСИА).
2. 🧾 Доступ к Ветис.API. Заявка подаётся в личном кабинете «Ветис.Паспорт». По итогам выдают три значения: APIKey, логин и пароль служебного API-пользователя. Доступ бесплатный.
3. 🏭 GUID хозяйствующего субъекта и GUID площадок. Это идентификаторы вашей организации и каждого склада, цеха или магазина в реестре Цербер. Найти их можно в карточке предприятия в веб-интерфейсе «Меркурий.ХС».
4. 👤 Логин пользователя «Меркурия» (сотрудника, от имени которого оформляются ВСД) с правами на нужные площадки. API-пользователь только передаёт запросы, а действия выполняются от имени этого сотрудника.

Проверьте площадки до настройки

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

Настройка подключения к Меркурию в 1С

Порядок одинаков для УТ 11, КА 2 и ERP, отличаются только названия разделов верхнего уровня.

Шаг 1. Включите ВетИС

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

Шаг 2. Введите параметры Ветис.API

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

Шаг 3. Загрузите хозсубъект и площадки

Откройте справочник хозяйствующих субъектов ВетИС и загрузите свою организацию по ИНН или GUID. Затем загрузите предприятия (площадки) по их GUID. Данные придут из реестра Цербер — вручную их не заполняют.

Шаг 4. Сопоставьте с объектами 1С

• 🏢 хозсубъект ВетИС → ваша организация;
• 🏬 предприятие ВетИС → склад или магазин, где лежит подконтрольный товар;
• 🙋 логин «Меркурия» → пользователь 1С, который будет оформлять документы.

Логин сотрудника вводится в его настройках ВетИС, а не в общих параметрах API.

Шаг 5. Свяжите номенклатуру с продукцией ВетИС

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

Шаг 6. Настройте регламентное задание

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

Нужна ли Java для обмена с ВетИС

Для типовой интеграции через Ветис.API Java не нужна. 1С сама формирует SOAP-запросы и отправляет их по HTTPS встроенными средствами платформы. Если инструкция или подрядчик требует поставить Java ради «Меркурия», уточните, о каком компоненте речь.

Java встречается в трёх ситуациях:

• 🍷 ЕГАИС. Универсальный транспортный модуль (УТМ) для алкоголя работает на Java. Это другая государственная система, с Меркурием она не связана, но их часто путают.
• 🔌 Сторонний шлюз. Некоторые отраслевые модули и «коробочные» коннекторы к ВетИС написаны на Java и ставятся как отдельная служба.
• 🧩 Внешние компоненты подрядчика в нетиповой доработке.

Если Java всё же нужна, ставьте ту разрядность, которой требует компонент, и только версию, которую указал её разработчик. Обновление Java «до последней» не раз ломало такие шлюзы.

Обмен ветеринарными документами: приёмка и отгрузка

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

Поставщик оформляет ВСД на ваш хозсубъект и площадку. Порядок в 1С такой:

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

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

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

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

Статусы заявок

Производственные операции и ВСД на выпуск

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

Как устроена производственная операция

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

В 1С для этого есть документ производственной операции ВетИС. Его создают на основании документа выпуска или заполняют вручную: сырьё — из остатков, продукция — из сопоставленной номенклатуры.

Тонкости производства

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

Ошибки обмена 1С с Меркурием и что с ними делать

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

Частые промахи при запуске

• ❌ Один логин на всех. Удобно в первый день, неудобно на первой проверке.
• ❌ Склад 1С без площадки. Если склад не связан с предприятием ВетИС, документы по нему не уходят в обмен, и это замечают через неделю.
• ❌ Гашение «на всякий случай» до приёмки. Погашенный ВСД с расхождением потом исправляют неделями.
• ❌ Разные единицы. В ВСД килограммы, в 1С — штуки или коробки. Без коэффициента пересчёта количество в журнале и в учёте разъедется.

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