Как настроить Меркурий в 1С: подключение и обмен данными

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

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

Инструкция подходит для типовых конфигураций «1С:Управление торговлей 11», «1С:Комплексная автоматизация 2», «1С:ERP» и «1С:Розница», в которые встроена подсистема интеграции с ВетИС (библиотека БЭД/ВетИС). Для старых или самописных конфигураций потребуется внешнее расширение или доработка.

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

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

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

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

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

Для обмена из 1С используется программный интерфейс ВетИС.API. Доступ к нему оформляется отдельно от доступа в веб-интерфейс Меркурия. Заявку подают через региональное ветеринарное управление или через оператора связи; для тестирования существует отдельная тестовая среда API.

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

Учтите, что обработка заявки занимает время, поэтому подавайте её заранее. Пока доступа к API нет, можно подготовить 1С: обновить конфигурацию, включить подсистему и заполнить справочники.

Включение подсистемы интеграции в 1С

В типовых конфигурациях перейдите в раздел «НСИ и администрирование» → «Интеграция» (в УТ 11 — «НСИ и администрирование» → «Настройка НСИ и разделов» → «Интеграция») и установите флажок «Ветеринарные сопроводительные документы» / «Интеграция с ФГИС ВетИС (Меркурий)». После этого в интерфейсе появится раздел «Интеграция с ВетИС».

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

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

Настройка обмена и загрузка справочников

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

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

Настройте расписание автоматического обмена: регламентные задания «Отправка и получение данных ВетИС» позволяют загружать входящие ВСД и отправлять ответы без участия пользователя. Для оптовой компании с большим потоком поставок автоматический обмен практически обязателен.

Работа с входящими и исходящими ВСД

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

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

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

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

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

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

Норма

Новые ВСД появляются в списке без ошибок, создаются транспортные операции

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

Ошибка авторизации API или пустой список при наличии ВСД в веб-кабинете

Гашение ВСД

Норма

После гашения статус ВСД меняется на «погашен», запись журнала создана

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

Заявка зависает в статусе «в обработке» или возвращается с ошибкой

Остатки журнала

Норма

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

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

Расхождения, отрицательные остатки, «зависшие» записи

Типичные ошибки и их устранение

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

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

Ограничения и когда нужна помощь специалиста

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

Обращайтесь к специалисту по 1С, если конфигурация сильно изменена, если нужен обмен через промежуточный сервис-оператор, или если после настройки ошибки повторяются системно. Самостоятельно безопасно выполнять подключение, сопоставление справочников и штатную работу с документами; изменение кода обмена без опыта — рискованно.

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

Можно ли работать с Меркурием в 1С без доступа к API?

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

Подходит ли интеграция для 1С:Розница и небольшого магазина?

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

Что делать, если ВСД не загружаются в 1С, хотя в веб-кабинете они есть?

Проверьте по порядку: корректность логина и пароля API, выбранную среду (продуктивная/тестовая), работу регламентного задания обмена и журнал ошибок обмена. Часто причина в том, что обмен настроен на тестовую среду, а ВСД приходят в продуктивную.

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

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

Нужно ли обновлять 1С для работы с Меркурием?

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

Можно ли настроить обмен через оператора вместо прямого подключения к API?

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