Меркурий интеграция 1С 2026: автоматическая выгрузка ВСД без программиста

Интеграция 1С с ФГИС «Меркурий» нужна не для красивой выгрузки, а для ежедневной операционной дисциплины: оформить исходящий транспортный эВСД, принять входящий ВСД, вернуть часть партии, сохранить запись складского журнала и не сорвать срок гашения. У компаний с десятками поставок в день ручной веб-интерфейс быстро превращается в узкое место: оператор копирует UUID, номера машин, площадки, партии и сроки годности, а ошибка в одном справочнике возвращается кодом MERC, APL или APLM.

По текущей справке Россельхознадзора промышленной версией шлюза является ВетИС.API 2.1; ВетИС.API 2.0 в справке помечен как выведенный из эксплуатации. Поэтому при новой настройке в 2026 году я проверяю не только «есть ли модуль Меркурий в 1С», а весь контур: версию API, права пользователя, сопоставление ХС и площадок, GUID/UUID справочников, правила гашения и очередь повторной отправки.

Ключевые факты

• ВетИС.API нужен сторонним информационным системам, чтобы передавать данные в компоненты ВетИС и получать сведения из реестров. Для Меркурия через ApplicationManagementService доступны оформление производственной, транспортной и входящей партии, инвентаризация, объединение записей журнала, получение ВСД и другие операции.
• Входящая партия гасится операцией ProcessIncomingConsignmentOperation: результатом может быть гашение электронного ВСД, добавление записи во входящий журнал, возвратный ВСД или акт несоответствия.
• Гашение транспортного ВСД должно быть выполнено в течение 24 часов после доставки партии. Если во время этого срока официально объявлен аварийный режим ФГИС ВетИС, срок переносится: не более 24 часов с момента возобновления работы системы.
• В сценариях ProcessIncomingConsignment расхождение по объему до 5% считается допустимой погрешностью, на которую система не реагирует. Если расхождение больше, нужно оформлять акт несоответствия или возврат по подходящему сценарию, а не «подгонять» остатки в 1С.
• С обновления Меркурия 6.92 от 06.03.2025 при передаче автомобильных номеров Литвы, Чехии и Китая через ВетИС.API обязательны коды страны регистрации транспорта: LT/LTU, CZ/CZE, CN/CHN.
• Для перехода в продуктивный контур ВетИС.API нужна апробация минимум 10 рабочих дней в реальном процессе: MERC-ошибок не больше 10% от запросов этого типа в сутки, ошибок APL и APLM в период апробации быть не должно.
• ВетИС.API 2.1 использует GUID как постоянный идентификатор сущности, а UUID как идентификатор версии записи. Это важно для 1С: старый UUID номенклатуры или площадки может давать ошибку даже при визуально правильном названии.

Практическая диагностика перед запуском

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

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

Проверочный минимум:

1. В 1С у организации заполнены ИНН, ХС, площадка, пользователь ВетИС и права на выполнение операций, а не только на чтение.
2. Справочник номенклатуры сопоставлен с продукцией Меркурия до нужного уровня детализации; в логах видны GUID и UUID, а не только русские названия.
3. Для транспорта передаются тип ТС, номер, страна регистрации при необходимости, перевозчик и маршрут, особенно при иностранных номерах.
4. Гашение входящего ВСД проверено двумя сценариями: полная приемка без расхождений и приемка с фактическим объемом, который отличается от ВСД.
5. В очереди обмена есть повторная отправка для временных 5xx/недоступности ВетИС, но нет бесконечного ретрая на бизнес-ошибки MERC/APL.
6. Оператор получает понятный текст ошибки в Telegram: какой документ 1С, какой UUID ВСД, какой код ВетИС и что исправлять в справочнике или документе.

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

Риски и диагностика ошибок

Как настроить интеграцию с Меркурий за 3 шага

Шаг 1. Напишите @onoutnoxon: версия 1С (БП / УТ / Розница / УНФ / другая), способ публикации 1С, реквизиты доступа к ВетИС.API, ИНН ХС, список площадок, типовые сценарии ВСД и пример проблемного документа.

Шаг 2. Я поднимаю тестовый обмен, проверяю права пользователя, сопоставление организаций и площадок, GUID/UUID справочников, сценарии полного и частичного гашения, транспортные реквизиты и очереди повторной отправки.

Шаг 3. После тестовой партии включаем рабочий контур: исходящие ВСД создаются из документов 1С, входящие гасятся при оприходовании, а ошибки MERC/APL, просрочка 24 часов и длительная недоступность ВетИС уходят в Telegram с номером документа и кодом причины.

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

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

Какие документы ВетИС поддерживаются? Для Меркурия через ApplicationManagementService доступны операции с производственными, транспортными и входящими партиями, инвентаризацией, объединением записей журнала и получением сведений по ВСД. Конкретный набор в проекте зависит от прав пользователя и версии API.

Нужен ли партионный учёт в 1С? Да, если вы производите, храните или отгружаете партии с разными сроками годности, производителями и качественными характеристиками. Без нормального партионного учета интеграция будет постоянно просить оператора выбрать партию вручную.

Что делать при сбое ВетИС? В интеграции должна быть очередь повторной отправки и ручной статус «ждем восстановления ВетИС». Если оператор ФГИС ВетИС официально разместил информацию об аварийном режиме, гашение допускается в пределах 24 часов после возобновления работы системы.

Как пройти апробацию для перехода в продуктивный режим? Минимум 10 рабочих дней реальных операций, доля MERC-ошибок ≤ 10% от типа запроса в сутки, ошибок APL/APLM — 0.

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

Почему тестовый контур не гарантирует быстрый запуск на бою? По FAQ ВетИС.API идентификаторы тестовой и продуктивной версий не совпадают и справочники после перехода на бой нужно обновлять. Поэтому я отдельно проверяю продуктивные GUID/UUID перед включением реальных документов.

Смотрите также

• Интеграция 1С и Честный знак
• Интеграция 1С через API
• Выгрузка из 1С в СБИС
• Интеграция 1С и Диадок
• Экспорт из 1С в XML: форматы УПД и накладных

Стоимость интеграции — 30 000 ₽ за проект, включая разбор ошибок MERC/APL и настройку алёртов. Напишите в Telegram: @onoutnoxon.

Подробнее о возможностях — на странице Синхрон1С.

Источники:

• Компонент ВетИС.API, версии 2.1/2.0, операции ApplicationManagementService, порядок доступа и критерии апробации: https://help.vetrf.ru/wiki/%D0%9A%D0%BE%D0%BC%D0%BF%D0%BE%D0%BD%D0%B5%D0%BD%D1%82_%D0%92%D0%B5%D1%82%D0%B8%D1%81.API
• ProcessIncomingConsignmentOperation: гашение входящих ВСД, возврат, акт несоответствия, допустимое расхождение 5%: https://help.vetrf.ru/wiki/ProcessIncomingConsignment_v2
• ProcessIncomingDeliveryOperation: пакетное гашение ВСД в рамках одной поставки: https://help.vetrf.ru/wiki/ProcessIncomingDelivery_v2.1
• Приказ Минсельхоза России от 13.12.2022 N 862: срок гашения транспортного ВСД 24 часа и правило аварийного режима ФГИС ВетИС: https://help.vetrf.ru/images/e/e2/Order862_20221218.pdf
• Обновления компонента Меркурий за 2025 год: alpha-2/alpha-3 коды для номеров Литвы, Чехии и Китая: https://help.vetrf.ru/wiki/%D0%9E%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F_%D0%BA%D0%BE%D0%BC%D0%BF%D0%BE%D0%BD%D0%B5%D0%BD%D1%82%D0%B0_%D0%9C%D0%B5%D1%80%D0%BA%D1%83%D1%80%D0%B8%D0%B9_%D0%B7%D0%B0_2025_%D0%B3%D0%BE%D0%B4
• FAQ ВетИС.API: различие GUID/UUID и несовпадение идентификаторов тестового и продуктивного контуров: https://help.vetrf.ru/wiki/%D0%A7%D0%B0%D1%81%D1%82%D0%BE_%D0%B7%D0%B0%D0%B4%D0%B0%D0%B2%D0%B0%D0%B5%D0%BC%D1%8B%D0%B5_%D0%B2%D0%BE%D0%BF%D1%80%D0%BE%D1%81%D1%8B_%D0%BF%D0%BE_%D0%92%D0%B5%D1%82%D0%B8%D1%81.API
• 1С о ВЕТИС: кто работает с ФГИС «Меркурий» и какие группы товаров обычно попадают под контроль: https://v8.1c.ru/podderzhka-i-obuchenie/integratsiya-s-gosinformsistemami-gis/fgis-merkuriy/

Для статьи использован AI-ассистент для структуры и поиска источников. Версии ВетИС.API, срок 24 часа, расхождение 5%, alpha-2/alpha-3 коды, критерии апробации и различие GUID/UUID проверены вручную по справке Россельхознадзора, приказу Минсельхоза и материалам 1С. Финальную редактуру выполнил Александр Руин, основатель habab.ru. Обновлено: 2026-05-04.