Что нужно для подключения 1С к Меркурию: доступы, сертификаты, права, площадки

Перед тем как настраивать интеграцию 1С с «Меркурием», важно подготовить всё необходимое: доступы, сертификаты, права и площадки. Без этого обмен просто не будет работать. Разберем пошагово эту ситуацию вместе с ведущим программистом Иваном Николенко из компании OSMINOG PROJECT.

ФГИС «Меркурий» — это единая информационная система Россельхознадзора для контроля продукции животного происхождения — мяса, молока, рыбы, яиц, мёда и даже кормов для животных. Согласно Приказу Минсельхоза РФ № 248 от 27.04.2021, все участники оборота такой продукции обязаны оформлять ветеринарные сопроводительные документы (ВСД) в электронном виде.

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

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

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

1. Технические условия и доступ к API

Первый шаг — зарегистрироваться во ФГИС ВетИС. Для этого заполните заявку на подключение на портале Россельхознадзора. Организация должна быть аккредитована в системе как «хозяйствующий субъект» (ХС). После регистрации в системе создаётся заявка на доступ к API. Она рассматривается до 10 рабочих дней.

Что вы получите после одобрения:

— issuerID — уникальный идентификатор вашей организации в реестре Россельхознадзора;

— логин и пароль для доступа в систему;

— API-ключ для авторизации запросов;

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

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

2. Электронная подпись (КЭП)

Это, пожалуй, самый важный пункт. Для подписания ВСД в «Меркурии» и для авторизации при интеграции с 1С требуется **квалифицированная электронная подпись (КЭП)**.

Требования к сертификату:

— Сертификат должен быть выдан аккредитованным Минцифры удостоверяющим центром — ФНС России, Калуга Астра, Такском, Контур и другие【2†L1-L4】.

— Важно: не всякая ЭЦП (простая или неквалифицированная) подойдёт. Для «Меркурия» нужна именно КЭП, причём та, которую поддерживает API-шлюз системы.

— Срок действия сертификата должен перекрывать период интеграции. Проверьте, не истекает ли он в ближайшее время.

Что даёт КЭП для интеграции:

— Юридическую значимость ВСД, подписанных через 1С;

— Возможность авторизации при вызове API «Меркурия» (подпись запросов).

Если у вас нет КЭП, оформляйте её заранее. Процесс получения обычно занимает от 1 до 5 рабочих дней.

3. Роли и права пользователей в системе

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

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

4. Подготовка площадок и хозяйствующих субъектов

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

Что нужно сделать:

— Зайти в веб-интерфейс «Меркурия» под учётной записью администратора.

— Создать площадки для каждого места хранения продукции (возможно, для каждого юрлица или обособленного подразделения).

— Присвоить каждой площадке уникальный идентификатор (GUID площадки).

После этого в 1С, при настройке обмена, вы сопоставляете каждую площадку из «Меркурия» со своим конкретным складом в учётной системе.

5. Техническая готовность 1С

Не каждая версия 1С поддерживает интеграцию с «Меркурием» «из коробки». Полноценная двухсторонняя поддержка реализована в:

— 1С: ERP Управление холдингом 2.4 и выше;

— 1С: Комплексная автоматизация 2.4 и выше;

— 1С: Бухгалтерия КОРП (ограниченный функционал);

— 1С: Управление торговлей 11.4 (в режиме совместимости).

Что ещё нужно: доступ к шлюзу ВетИС.API по протоколу HTTPS, открытые порты для обмена (обычно 443), наличие КЭП на компьютере, где работает 1С (сервер или рабочее место пользователя), и правильно настроенные регламентные задания для автоматического обмена по расписанию.

Рассказывает ведущий программист 1С компании OSMINOG PROJECT

Иваном Николенко:

— Компания «Мясной Двор» — оптовый поставщик мясных полуфабрикатов. У них два склада, несколько десятков поставщиков и сотни клиентов. Но система учёта ВСД работала… никак.

Проблемы были классическими:

- Нет электронной подписи, оформленной по новым требованиям.

- Администратор ХС не назначен, права у пользователей не разграничены.

- Площадки не зарегистрированы в «Меркурии».

- Бухгалтер каждый день вручную заходил на сайт, вбивал данные из 1С и наоборот — это отнимало 3–4 часа ежедневно.

Компания обратилась к нам за помощью. И мы взялись за проект с горящими глазами и холодной головой.

Иван вспоминает:

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

Что стало итогом:

- Оформление ВСД ускорилось в 10 раз.

- Штрафы от сетей за задержку документов прекратились.

- Все подконтрольные товары теперь проходят по системе «автоматом», а бухгалтерия выдохнула с облегчением.

Главный вывод, который мы сделали: «Подготовка — это 80% успеха. Если вы сделаете всё правильно ещё до настройки 1С, интеграция пройдёт гладко. Если нет — будете мучиться с ошибками, которые не связаны с программой».

Игнорирование требований «Меркурия» — не вариант. За отсутствие ВСД или неправильное оформление ответственность серьёзная: для должностных лиц и ИП штраф составляет от 3000 до 10000 рублей, для юридических лиц — от 10000 до 20000 рублей. А систематические нарушения грозят приостановкой деятельности до 90 суток и изъятием продукции.

Итак, перед тем как открыть 1С и начать настраивать обмены, сверьтесь с этим чек-листом: есть ли КЭП? Зарегистрированы ли площадки? Назначены ли права пользователям? Получены ли API-ключи?

Если ответ на все пункты «да» — интеграция пройдёт быстро. Если нет — начните с подготовки. Экономия времени здесь только кажущаяся, а ошибки на этапе доступа могут парализовать работу склада на недели.