Обмен с ФГИС Меркурий из 1С: от получения доступа до погашенного ветеринарного документа

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

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

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

Обмен не заработает, пока у организации нет трёх вещей: регистрации в Меркурии, зарегистрированных площадок и доступа к API. Это оформляется вне 1С, в системе Россельхознадзора.

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

Работать с Меркурием обязаны все, кто производит, перевозит, хранит или продаёт подконтрольную продукцию, — от молокозавода до продуктового магазина. Поэтому доступ оформляют и крупные производители, и небольшая розница. Перед настройкой обмена проверьте готовность по короткому списку:

• ✅ хозяйствующий субъект зарегистрирован в ВетИС.Паспорт;
• ✅ все площадки заведены, у каждой есть свой идентификатор;
• ✅ создан пользователь ВетИС.API (есть apiKey и issuerId);
• ✅ у этого пользователя включены права на гашение и оформление;
• ✅ на руках логин и пароль доступа к API.

Если хоть один пункт не закрыт, обмен из 1С либо не авторизуется, либо не даст гасить документы.

Настройка обмена с Меркурием в 1С

Поддержка Меркурия встроена в торговые и учётные конфигурации: 1С:Розница, 1С:Управление торговлей, 1С:Комплексная автоматизация, 1С:ERP, 1С:Управление нашей фирмой, а также в свежие релизы 1С:Бухгалтерии. Набор полей и путь к настройке в них близки, но раздел называется по-разному.

Включение обмена делают в настройках интеграции (в УТ и КА — раздел НСИ и администрирование, в Рознице — Администрирование; точное название пункта может отличаться по релизу). Общая логика одна:

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

Если проверка связи вернула площадки — доступ рабочий. Пустой список или ошибка авторизации означают, что перепутаны учётные данные API либо у пользователя нет прав.

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

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

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

Что с чем связывается:

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

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

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

Оформление производственных и транспортных ВСД

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

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

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

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

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

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

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

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

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

Порядок приёмки:

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

Только после гашения товар доступен для дальнейшего оформления: его можно продать (транспортный ВСД) или пустить в производство.

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

Разбор ошибок обмена и журнал регистрации

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

Если обмен «молчит» — ни ошибок, ни документов — чаще всего выбран тестовый контур или истёк доступ API. Начните диагностику с команды проверки связи: она сразу показывает, видит ли 1С ваши площадки.

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