Обмен 1С 8.3 с ФГИС «Меркурий»: доступы, настройка и работа с ВСД

· 9 мин

Содержание

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

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

Механизм обмена с ВетИС встроен в конфигурации на библиотеке интеграции с государственными системами: «Управление торговлей 11», «Комплексная автоматизация 2», ERP, «Розница», УНФ. Дальше пути меню даны для УТ 11 и КА; в других программах формы те же, отличается только раздел, где лежит настройка.

Что подготовить до настройки: доступы, ключ API и сертификат

Частый вопрос — нужен ли сертификат электронной подписи . Для обмена через Ветис.API КЭП не нужна: заявки авторизуются ключом API и логином-паролем. Квалифицированная подпись понадобится разве что для входа и подачи заявлений через Госуслуги, если вы оформляете доступы этим путём.

Перед настройкой соберите:

  • 🔑 APIKey — ключ доступа к Ветис.API, выдаётся организации;
  • 👤 логин и пароль API-пользователя — отдельная техническая учётная запись, не совпадает с логином сотрудника;
  • 🧑‍💼 логин пользователя ВетИС — сотрудник, от имени которого 1С отправляет заявки (кладовщик, товаровед, уполномоченное лицо);
  • 🏢 GUID хозяйствующего субъекта — идентификатор вашей организации в реестре ВетИС;
  • 📍 GUID предприятий — идентификаторы площадок (склад, магазин, цех), где хранится подконтрольный товар.

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

Готовность к подключению
Выполнено: 0 / 6

Регистрация в ВетИС и привязка предприятия

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

Регистрация организации и сотрудников

  1. Организация подаёт заявление на регистрацию в территориальное управление Россельхознадзора своего региона. Сейчас доступ к ВетИС также оформляют через Госуслуги — вход в систему идёт по учётной записи ЕСИА.
  2. Для каждого сотрудника, который будет работать с ВСД, заводится пользователь и назначаются права. Минимальный набор для приёмки — гашение ВСД; для отгрузки и переработки — оформление ВСД на соответствующие виды продукции.
  3. Управлять пользователями внутри организации удобно через компонент «Ветис.Паспорт»: там администратор хозяйствующего субъекта видит сотрудников и их права.

Привязка площадок к сотруднику

Каждая площадка — это «предприятие» в терминах ВетИС. Оно должно быть:

  • 📌 внесено в реестр поднадзорных объектов с правильным адресом;
  • 🔗 связано с вашим хозяйствующим субъектом;
  • 👥 добавлено пользователю в список обслуживаемых предприятий.

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

Ключ Ветис.API

Ключ и учётную запись API-пользователя получают по отдельной заявке в Россельхознадзор (бланк и порядок подачи опубликованы на портале ВетИС). В ответ приходят APIKey, логин и пароль. Храните их как пароль от банка: с этими данными можно гасить и оформлять документы от имени организации.

Для отладки у ВетИС есть тестовый контур с отдельными ключами. Боевой ключ к нему не подходит, и наоборот. Если обмен «молча» не находит ваших предприятий — проверьте, к какому контуру подключена 1С.

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

Сама настройка в программе занимает 10–15 минут, если доступы уже на руках.

Включаем функциональность

  1. Откройте НСИ и администрирование → Настройка интеграции.
  2. Перейдите к разделу ВетИС и установите флажок использования ВетИС.
  3. Сохраните настройку — в программе появятся справочники и документы ВетИС.

Вводим параметры подключения

В настройках подключения к ВетИС укажите:

Поле в 1СЧто вводитьОткуда взять
Ключ APIAPIKeyответ на заявку о доступе к Ветис.API
Логин и пароль APIтехнические логин и парольтам же
Хозяйствующий субъектGUID организацииреестр ВетИС, карточка ХС
Пользователь ВетИСлогин сотрудникаучётная запись в ВетИС

Логин пользователя ВетИС задают для каждого пользователя 1С, который работает с ветдокументами. Если приёмкой занимаются три кладовщика, у каждого в 1С должен быть свой логин ВетИС — тогда в Меркурии видно, кто именно погасил сертификат.

Проверка связи

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

Обмен с ВетИС асинхронный. 1С отправляет заявку, а результат забирает следующим запросом. Поэтому документ может несколько секунд или минут висеть в состоянии ожидания ответа — это нормально, повторно отправлять его не нужно.

Синхронизация справочников: площадки, склады и продукция

Без сопоставления 1С не поймёт, какой склад какой площадке соответствует и какая номенклатура какой продукции Меркурия. Это самый трудоёмкий этап, но делается он один раз.

Организации и склады

  1. Загрузите из ВетИС хозяйствующий субъект и его предприятия.
  2. Сопоставьте организацию 1С с хозяйствующим субъектом.
  3. Для каждого склада, где хранится подконтрольный товар, выберите предприятие ВетИС.

Если на одной площадке у вас два склада в 1С (например, «Основной» и «Холодильная камера»), оба привязываются к одному предприятию. Обратная ситуация — один склад на две площадки — работать не будет: разведите склады в 1С.

Продукция и номенклатура

Классификатор Меркурия трёхуровневый: тип продукции → продукция → вид продукции. Ниже идёт конкретное наименование продукции — то, что производитель заявил в системе, часто с GTIN.

Сопоставление полей
Наименование продукции ВетИС→Номенклатура 1С
Вид продукции ВетИС→Вид номенклатуры или группа
Единица измерения ВетИС→Единица хранения 1С
Производитель ВетИС→Производитель номенклатуры
GTIN→Штрихкод номенклатуры

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

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

Работа с входящими ВСД: приёмка и гашение

Входящий ветеринарный сопроводительный документ оформляет поставщик. Ваша задача — погасить его, то есть подтвердить, что товар пришёл.

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

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

Если пришло не столько, сколько в ВСД

При недостаче, излишке или порче товар принимается фактически, а на расхождение оформляется акт несоответствия. В 1С это делается в той же входящей операции: вводится принятое количество, и программа отправляет гашение с актом.

Пример: в ВСД 120 кг охлаждённой курицы, на весах 118,5 кг. Гасите на 118,5 кг, разница 1,5 кг уходит в акт. Поставщик увидит её у себя.

Не гасите ВСД «как есть», если товар фактически не совпадает: исправить погашенный документ потом значительно сложнее, чем сразу оформить акт.

Возврат всей партии

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

Исходящие ВСД, переработка и инвентаризация

Отгрузка покупателю

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

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

Розничная продажа

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

Переработка и производство

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

Инвентаризация

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

Ошибки обмена 1С с Меркурием и что с ними делать

Диагностика: выберите симптом

Ещё две ситуации, которые не выглядят как ошибка, но мешают работе:

  • 🕒 Входящие не загружаются за старый период. 1С запрашивает ВСД за интервал дат. Если поставка была раньше начала интервала, расширьте период загрузки.
  • 🔁 Задвоение партий. Возникает, когда операцию отправили повторно, не дождавшись ответа. Лишнюю запись убирают инвентаризацией в Меркурии, а дубль документа в 1С помечают на удаление.

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

Можно ли работать с Меркурием через 1С без ключа API?
Нет. Обмен идёт только через Ветис.API, и ключ выдаётся организации по заявке. Без него остаётся веб-интерфейс Меркурия.
Нужна ли отдельная лицензия 1С для обмена с ВетИС?
Нет, механизм входит в типовые конфигурации, где поддерживается интеграция с ВетИС. Платить Россельхознадзору за доступ к API тоже не нужно.
Одним ключом API можно обслуживать несколько организаций?
Ключ выдаётся конкретному хозяйствующему субъекту. Для каждой организации в одной базе 1С указываются её собственные идентификаторы и пользователи.
Что делать, если сотрудник уволился?
Отключите его учётную запись в ВетИС и пропишите логин другого сотрудника у тех пользователей 1С, которые работают с ветдокументами. Уже погашенные ВСД остаются записанными на прежнего сотрудника.
Можно ли гасить ВСД в Меркурии вручную, если 1С уже подключена?
Можно, но тогда загрузите операцию в 1С заново, чтобы программа узнала о гашении. Иначе 1С попытается погасить уже погашенный документ.

Источники

  • Закон РФ от 14.05.1993 № 4979-1 «О ветеринарии»