Обмен 1С 8.3 с ФГИС «Меркурий»: доступы, настройка и работа с ВСД
Содержание
Чтобы подключить Меркурий к 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-логин, сервис вернёт отказ по правам.
Регистрация в ВетИС и привязка предприятия
Без регистрации в ВетИС подключать нечего: 1С лишь отправляет заявки в систему, где организация, площадки и сотрудники уже должны существовать.
Регистрация организации и сотрудников
- Организация подаёт заявление на регистрацию в территориальное управление Россельхознадзора своего региона. Сейчас доступ к ВетИС также оформляют через Госуслуги — вход в систему идёт по учётной записи ЕСИА.
- Для каждого сотрудника, который будет работать с ВСД, заводится пользователь и назначаются права. Минимальный набор для приёмки — гашение ВСД; для отгрузки и переработки — оформление ВСД на соответствующие виды продукции.
- Управлять пользователями внутри организации удобно через компонент «Ветис.Паспорт»: там администратор хозяйствующего субъекта видит сотрудников и их права.
Привязка площадок к сотруднику
Каждая площадка — это «предприятие» в терминах ВетИС. Оно должно быть:
- 📌 внесено в реестр поднадзорных объектов с правильным адресом;
- 🔗 связано с вашим хозяйствующим субъектом;
- 👥 добавлено пользователю в список обслуживаемых предприятий.
Последний пункт часто забывают. Сотрудник с правами на гашение, но без нужной площадки в списке обслуживаемых, не сможет ничего сделать с товаром, пришедшим на этот склад. Ни в веб-интерфейсе Меркурия, ни через 1С.
Ключ Ветис.API
Ключ и учётную запись API-пользователя получают по отдельной заявке в Россельхознадзор (бланк и порядок подачи опубликованы на портале ВетИС). В ответ приходят APIKey, логин и пароль. Храните их как пароль от банка: с этими данными можно гасить и оформлять документы от имени организации.
Для отладки у ВетИС есть тестовый контур с отдельными ключами. Боевой ключ к нему не подходит, и наоборот. Если обмен «молча» не находит ваших предприятий — проверьте, к какому контуру подключена 1С.
Как подключить Меркурий в 1С 8.3: параметры обмена
Сама настройка в программе занимает 10–15 минут, если доступы уже на руках.
Включаем функциональность
- Откройте
НСИ и администрирование → Настройка интеграции. - Перейдите к разделу ВетИС и установите флажок использования ВетИС.
- Сохраните настройку — в программе появятся справочники и документы ВетИС.
Вводим параметры подключения
В настройках подключения к ВетИС укажите:
| Поле в 1С | Что вводить | Откуда взять |
|---|---|---|
| Ключ API | APIKey | ответ на заявку о доступе к Ветис.API |
| Логин и пароль API | технические логин и пароль | там же |
| Хозяйствующий субъект | GUID организации | реестр ВетИС, карточка ХС |
| Пользователь ВетИС | логин сотрудника | учётная запись в ВетИС |
Логин пользователя ВетИС задают для каждого пользователя 1С, который работает с ветдокументами. Если приёмкой занимаются три кладовщика, у каждого в 1С должен быть свой логин ВетИС — тогда в Меркурии видно, кто именно погасил сертификат.
Проверка связи
После ввода параметров выполните загрузку данных о своей организации. Если в ответ пришли реквизиты хозяйствующего субъекта и список предприятий — подключение работает. Пустой ответ или ошибка авторизации означают проблему в ключе, логинах или контуре.
Обмен с ВетИС асинхронный. 1С отправляет заявку, а результат забирает следующим запросом. Поэтому документ может несколько секунд или минут висеть в состоянии ожидания ответа — это нормально, повторно отправлять его не нужно.
Синхронизация справочников: площадки, склады и продукция
Без сопоставления 1С не поймёт, какой склад какой площадке соответствует и какая номенклатура какой продукции Меркурия. Это самый трудоёмкий этап, но делается он один раз.
Организации и склады
- Загрузите из ВетИС хозяйствующий субъект и его предприятия.
- Сопоставьте организацию 1С с хозяйствующим субъектом.
- Для каждого склада, где хранится подконтрольный товар, выберите предприятие ВетИС.
Если на одной площадке у вас два склада в 1С (например, «Основной» и «Холодильная камера»), оба привязываются к одному предприятию. Обратная ситуация — один склад на две площадки — работать не будет: разведите склады в 1С.
Продукция и номенклатура
Классификатор Меркурия трёхуровневый: тип продукции → продукция → вид продукции. Ниже идёт конкретное наименование продукции — то, что производитель заявил в системе, часто с GTIN.
Практичный порядок такой: не пытайтесь сопоставить весь справочник заранее. Сопоставление удобно делать прямо при первой приёмке: в документе по входящему ВСД 1С покажет продукцию поставщика, и вы один раз выберете для неё свою номенклатуру. Дальше связь подставится автоматически.
Следите за единицами. Если поставщик оформил ВСД в килограммах, а у вас номенклатура в штуках, при гашении нужен пересчёт. Ошибка в коэффициенте даёт расхождение остатков в складском журнале Меркурия, которое потом придётся исправлять инвентаризацией.
Работа с входящими ВСД: приёмка и гашение
Входящий ветеринарный сопроводительный документ оформляет поставщик. Ваша задача — погасить его, то есть подтвердить, что товар пришёл.
Порядок приёмки
- Загрузите входящие ВСД из Меркурия — по кнопке в журнале документов ВетИС или по расписанию.
- 1С создаст документ «Входящая транспортная операция ВетИС» на каждую поставку.
- Проверьте продукцию, количество, даты выработки и сроки годности.
- Сопоставьте позиции с номенклатурой, если это первая поставка.
- Погасите ВСД. Партия появится в складском журнале предприятия в Меркурии.
- Свяжите операцию с документом поступления в 1С — так учёт и Меркурий видят одну и ту же партию.
Если пришло не столько, сколько в ВСД
При недостаче, излишке или порче товар принимается фактически, а на расхождение оформляется акт несоответствия. В 1С это делается в той же входящей операции: вводится принятое количество, и программа отправляет гашение с актом.
Пример: в ВСД 120 кг охлаждённой курицы, на весах 118,5 кг. Гасите на 118,5 кг, разница 1,5 кг уходит в акт. Поставщик увидит её у себя.
Не гасите ВСД «как есть», если товар фактически не совпадает: исправить погашенный документ потом значительно сложнее, чем сразу оформить акт.
Возврат всей партии
Если товар не принимается целиком — например, нарушен температурный режим, — ВСД не гасится, а оформляется возврат поставщику. В 1С для этого во входящей операции выбирают полный отказ от приёмки; Меркурий формирует возвратный документ.
Исходящие ВСД, переработка и инвентаризация
Отгрузка покупателю
- Оформите реализацию в 1С как обычно.
- На её основании создайте «Исходящую транспортную операцию ВетИС».
- Укажите получателя — его хозяйствующий субъект и площадку в ВетИС. Если контрагент не сопоставлен, 1С предложит найти его в реестре по ИНН.
- Выберите партии из складского журнала: 1С подберёт их по сопоставленной номенклатуре.
- Заполните транспорт и маршрут, если они требуются для этого вида продукции.
- Отправьте операцию. Получатель увидит ВСД у себя и погасит его.
Списать в исходящий ВСД можно только то, что есть в складском журнале Меркурия на этой площадке. Остаток в 1С здесь ничего не решает.
Розничная продажа
При продаже конечному потребителю ВСД на каждую покупку не оформляется. Розница периодически списывает проданное из складского журнала — инвентаризацией или специальной операцией гашения остатков. Частоту такого списания определяет организация, но тянуть с ним месяц не стоит: накопленные «хвосты» трудно сверять.
Переработка и производство
Если вы делаете фарш, полуфабрикаты, колбасу, нужна производственная операция ВетИС. В ней указывают сырьё (списывается из журнала) и готовую продукцию (поступает в журнал). Права на оформление производственных ВСД у сотрудника должны быть выданы отдельно.
Инвентаризация
Документ «Инвентаризация продукции ВетИС» выравнивает складской журнал Меркурия с фактом: списывает испорченное, исправляет ошибки прошлых гашений, оприходует найденное. Делайте его хотя бы раз в месяц — до того, как расхождения начнут блокировать отгрузки.
Ошибки обмена 1С с Меркурием и что с ними делать
Ещё две ситуации, которые не выглядят как ошибка, но мешают работе:
- 🕒 Входящие не загружаются за старый период. 1С запрашивает ВСД за интервал дат. Если поставка была раньше начала интервала, расширьте период загрузки.
- 🔁 Задвоение партий. Возникает, когда операцию отправили повторно, не дождавшись ответа. Лишнюю запись убирают инвентаризацией в Меркурии, а дубль документа в 1С помечают на удаление.
Частые вопросы
Можно ли работать с Меркурием через 1С без ключа API?
Нужна ли отдельная лицензия 1С для обмена с ВетИС?
Одним ключом API можно обслуживать несколько организаций?
Что делать, если сотрудник уволился?
Можно ли гасить ВСД в Меркурии вручную, если 1С уже подключена?
Источники
- Закон РФ от 14.05.1993 № 4979-1 «О ветеринарии»