ВетИС API и автоматизация Меркурия для оптовика: интеграция с 1С

Кладовщик у монитора гасит десятое ВСД за час — вручную, через веб-интерфейс, проверяя каждую позицию глазами. При объёме в 5–10 партий в день это ещё терпимо. При росте до полусотни поставок ежедневно ручное гашение в личном кабинете «Меркурия» превращается в отдельную штатную единицу, а ошибки (о них — в статье про ГВЭ) начинают случаться просто от усталости и монотонности процесса.

Альтернатива — подключить учётную систему напрямую к «Меркурию» через ВетИС.API и гасить, оформлять и получать ВСД прямо из 1С, без переключения в браузер. Разбираем, как это работает технически и с чего начать.

Когда пора переходить с веб-интерфейса на API

Веб-интерфейс web.mercury.ru — бесплатный способ работы с «Меркурием», доступный сразу после регистрации хозяйствующего субъекта: оформление, подтверждение и аннулирование ВСД вручную, отправка запросов, закрытие партий. Для небольшого оборота этого достаточно, и типичные ошибки ручного гашения уже разобраны в отдельной статье про Меркурий ГВЭ.

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

Что такое ВетИС.API и что он умеет

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

Развитием и поддержкой шлюза занимается Россельхознадзор — по вопросам доработок и интеграционных проектов можно обращаться на api@vetrf.ru или на специализированный форум системы.

Как получить доступ: три шага

Подключение к ВетИС.API проходит в три этапа. Первый — регистрация хозяйствующего субъекта в системе «Меркурий», если это ещё не сделано (через территориальное управление Россельхознадзора или центральный отдел). Второй — добавление производственных площадок в системе «Цербер», где фиксируются все точки приёмки и отгрузки поднадзорной продукции. Третий — подача электронной заявки на доступ к ВетИС.API через форму на портале (aplms.vetrf.ru), где указываются ИНН организации, контакты ответственного лица и название используемого клиентского интеграционного решения — например, «1С:Предприятие» или готовый коммерческий шлюз.

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

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

APIKey и IssuerID: что это и откуда брать

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

Эти параметры нужно будет ввести в настройках вашей учётной системы или шлюза-посредника (1С, СБИС, StoreHouse и подобные) — без корректно указанных APIKey и IssuerID синхронизация с «Меркурием» просто не запустится.

Типичные сложности при настройке интеграции

Несколько узких мест, которые чаще всего замедляют запуск API-интеграции. Несовпадение площадок: в «Цербере» производственная площадка регистрируется под одним названием, а в учётной системе склада (1С, StoreHouse и подобные) — под другим или с иной привязкой к юридическому лицу; без явного сопоставления площадок входящие ВСД просто не будут разноситься по нужному подразделению автоматически. Устаревший сертификат электронной подписи: без действующей УКЭП заявку на доступ к продуктивному контуру не одобрят, а уже настроенная интеграция перестанет проходить авторизацию при истечении сертификата у ответственного лица.

Ещё одна частая проблема — попытка сразу запустить продуктивный контур, минуя тестовый: без отладки в песочнице легко столкнуться с ситуацией, когда реальная партия «зависает» из-за формата данных, который не был проверен заранее. Разработчики шлюза прямо рекомендуют переходить к продуктивной версии только после того, как организация убедилась в готовности клиентского модуля по результатам тестирования.

Сколько стоит подключение

Сам доступ к ВетИС.API бесплатен — Россельхознадзор не берёт плату за выдачу реквизитов подключения. Расходы возникают на стороне интеграции: специализированные модули для 1С и коммерческие шлюзы обычно продаются по лицензии или подписке, цена зависит от объёма обрабатываемых документов и вендора. Альтернатива с нулевыми прямыми затратами на ПО — использовать раздел «Меркурий», встроенный в уже оплаченную подписку на ЭДО-оператора (СБИС, Контур), если компания и так пользуется этим сервисом для документооборота и маркировки — тогда добавление модуля «Меркурий» обычно обходится дешевле отдельной интеграции с нуля.

Три способа интеграции с 1С

На практике есть три основных маршрута подключения. Первый — специализированные модули интеграции для 1С от сторонних разработчиков, которые регистрируются в ВетИС как отдельные клиентские системы и обеспечивают обмен ВСД прямо из привычного интерфейса 1С без переключения в другие программы. Второй — коммерческие ЭДО-платформы со встроенным модулем «Меркурий»: например, в СБИС достаточно включить раздел «Меркурий» и указать реквизиты доступа, а Контур.Маркет проводит через пошаговую заявку прямо в интерфейсе сервиса с отслеживанием статуса подключения. Третий — специализированные складские WMS-системы (например, StoreHouse Pro), где синхронизация с «Меркурием» обеспечивается отдельной фоновой службой, а входящие ВСД автоматически сопоставляются с конкретным подразделением склада по ИНН.

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

Права доступа: чтение и выполнение операций

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

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

Коротко

— Веб-интерфейс «Меркурия» бесплатен и подходит для небольшого оборота; API оправдан при десятках операций в день. — ВетИС.API — универсальный шлюз, позволяющий учётной системе (1С и другим) обмениваться данными с «Меркурием» без ручных действий в браузере. — Подключение проходит в три шага: регистрация субъекта → площадки в «Цербере» → заявка на доступ к API. — Сначала выдаётся доступ к тестовому контуру для отладки интеграции, только потом — к продуктивному. — APIKey и IssuerID — обязательные параметры подключения, которые приходят на почту после одобрения заявки. — Три маршрута интеграции с 1С: специализированные модули для 1С, коммерческие ЭДО-платформы со встроенным «Меркурием», складские WMS-системы.

В «Море Краба ОПТ» работа с Меркурием и ВетИС.API автоматизирована для обработки поставок в промышленном объёме — каждая партия рыбы, краба и икры сопровождается корректно оформленным и своевременно погашенным ВСД. Каталог: рыба и морепродукты оптом и крабовая продукция оптом.