Как подключить Меркурий к 1С 8

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

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

Ниже разобраны все этапы: от регистрации хозяйствующего субъекта до проверки корректности обмена, а также типичные ошибки, из-за которых интеграция «молчит» или отклоняет документы.

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

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

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

Регистрация в Меркурии и получение ключей API

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

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

Настройка обмена в типовой конфигурации 1С

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

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

1. 1
   Зарегистрируйте хозяйствующего субъекта и площадки в Меркурии
2. 2
   Отправьте заявку в поддержку ВетИС и получите API Key, логин и пароль
3. 3
   Включите функциональность интеграции с ВетИС в настройках 1С
4. 4
   Введите параметры подключения в настройке обмена
5. 5
   Сопоставьте площадки Меркурия со складами 1С
6. 6
   Выполните загрузку классификаторов: продукция, предприятия, единицы измерения
7. 7
   Отправьте тестовый запрос и проверьте ответ системы

Первичная синхронизация справочников

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

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

Проверка работы обмена

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

Все запросы и ответы фиксируются в протоколе обмена 1С. Если документ «завис» в статусе ожидания, откройте протокол и посмотрите текст ответа ВетИС: там указывается код ошибки и её описание, например неверный идентификатор продукции или недостаточно остатков в записи журнала.

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

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

Загрузка входящих ВСД

Норма

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

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

Пустой ответ при наличии ВСД в веб-интерфейсе — проверьте ключи и площадки

Гашение ВСД

Норма

В Меркурии статус сменился на «погашен» в течение нескольких минут

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

Документ висит в очереди или вернулась ошибка в протоколе обмена

Остатки в журнале продукции

Норма

Остатки в 1С и в Меркурии совпадают по записям журнала

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

Расхождения — нужна инвентаризация и корректировка записей

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

Норма

Все подконтрольные позиции связаны с продукцией ВетИС

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

При отправке возникают ошибки «продукция не определена»

Типичные ошибки и ограничения

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

Учитывайте ограничения API ВетИС: система обрабатывает запросы асинхронно и с ограничением частоты обращений. Массовая отправка сотен документов подряд может привести к временным отказам — настраивайте обмен пакетами с паузами, а не «лобовой» выгрузкой всего за день.

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

Можно ли работать с Меркурием без интеграции с 1С?

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

Что делать, если в моей конфигурации нет модуля ВетИС?

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

Нужен ли отдельный ключ API для каждой площадки?

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

Почему документы отправляются, но статус не меняется?

API ВетИС работает асинхронно: запрос принимается в обработку, а результат приходит позже. Убедитесь, что в 1С настроено регламентное задание получения ответов, и проверьте протокол обмена — часто задержка объясняется ошибкой в ответе, а не «зависанием».

Как исправить расхождение остатков между 1С и Меркурием?

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