Как связать Меркурий и 1С: практическое руководство по интеграции

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

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

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

Как работает связка Меркурий + 1С и что понадобится

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

Для подключения потребуется:

• регистрация организации в системе «Меркурий» (ХС — хозяйствующий субъект) и хотя бы одна площадка;
• доступ в личный кабинет ВетИС с правами администратора;
• ключ API — выдаётся через заявку в личном кабинете ВетИС;
• конфигурация 1С, поддерживаемая выбранным решением (УТ 11, КА 2, ERP 2, Розница, УНФ и т.п.);
• права на установку расширений или внешних обработок в 1С.

Получаем доступ к ВетИС.API

Без ключа API ни одно решение работать не будет. Порядок действий: авторизуйтесь в личном кабинете ВетИС (через ЕСИА/Госуслуги), перейдите в раздел заявок на доступ к API и подайте заявку, указав хозяйствующий субъект и цель использования. Для тестирования доступна демо-среда ВетИС.API — рекомендуется сначала настроить обмен на ней, чтобы не отправлять ошибочные запросы в продуктивный контур.

После одобрения заявки вы получите идентификатор (issuer ID) и ключ. Эти данные вводятся в настройки модуля интеграции в 1С. Храните ключ как пароль: по нему можно выполнять любые операции от имени вашей организации, включая гашение и аннулирование ВСД.

Выбираем способ интеграции

Первый вариант — типовой модуль интеграции с Меркурием, который входит в состав актуальных релизов УТ 11, КА 2 и ERP 2 (подсистема «Интеграция с ВетИС»). Это официально поддерживаемое решение: оно обновляется вместе с конфигурацией и покрывает основные операции — гашение, оформление входящих и исходящих ВСД, инвентаризацию, объединение и разделение партий. Подходит большинству торговых и производственных компаний.

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

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

Сравнение вариантов

Типовой модуль 1С

Подходит для УТ 11, КА 2, ERP 2 актуальных релизов. Бесплатен, обновляется с конфигурацией. Ограничение: в старых и нетиповых конфигурациях может отсутствовать или требовать доработки.

Сторонний коннектор

Подходит для старых, нетиповых и отраслевых конфигураций. Быстрое внедрение, но платная лицензия и зависимость от поставщика решения.

Собственная разработка

Подходит при нестандартных процессах и наличии разработчика. Полная гибкость, но высокая стоимость внедрения и необходимость сопровождения.

Устанавливаем и настраиваем модуль в 1С

Если используете типовое решение, включите подсистему интеграции в настройках: «НСИ и администрирование» → «Интеграция» → включить обмен с ВетИС (точный путь зависит от конфигурации). Затем в разделе настроек обмена укажите параметры подключения: адрес сервиса (тестовый или продуктивный контур), issuer ID и ключ API, выберите хозяйствующий субъект и площадки.

Для стороннего решения установка обычно сводится к подключению внешней обработки или расширения через «Администрирование» → «Печатные формы, отчеты и обработки» либо «Расширения». После установки аналогично вводятся учётные данные API и выполняется первичная загрузка справочников.

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

Сопоставляем справочники: номенклатура, контрагенты, склады

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

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

Настраиваем обмен документами и регламентные задания

После сопоставления справочников настройте регламентное задание обмена: оно должно с заданной периодичностью отправлять подготовленные заявки и запрашивать их статусы. Рекомендуемый интервал — каждые 5–15 минут в рабочее время. Также настройте загрузку входящих ВСД: модуль периодически запрашивает у ВетИС список оформленных на вас документов и создаёт на их основании входящие ВСД в 1С.

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

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

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

Статус заявки на гашение в 1С

Норма

Заявка выполнена, ВСД имеет статус «погашен»

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

Заявка в статусе «отклонена» или долго «в обработке» — смотрите текст ошибки

Остатки партий

Норма

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

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

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

Входящие ВСД

Норма

Новые ВСД от поставщиков появляются в 1С автоматически

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

Документы видны в веб-интерфейсе Меркурия, но не загружаются в 1С — проверьте регламентное задание и ключ API

Проверяем работу и устраняем типичные проблемы

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

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

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

Часто задаваемые вопросы

Можно ли связать Меркурий с 1С без доработок, если конфигурация старая?

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

Сколько стоит подключение к ВетИС.API?

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

Чем тестовый контур отличается от продуктивного?

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

Что делать, если остатки в 1С и Меркурии разошлись?

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

Можно ли гасить ВСД частично из 1С?

Да, частичное гашение поддерживается: в заявке указывается фактически принятое количество, а расхождение оформляется как акт расхождения или возврат поставщику. Остаток партии при этом корректно уменьшается в журнале Меркурия.

Обязательно ли гасить ВСД, если пришла одна коробка?

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