ФГИС Меркурий + 1С: интеграция и автоматизация

Для производителей, переработчиков, оптовых компаний, складов и других участников оборота подконтрольной продукции ФГИС «Меркурий» является частью обязательного ветеринарного документооборота. При этом основные хозяйственные операции компания часто ведет в 1С.

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

Интеграция через ВетИС.API позволяет сделать этот процесс машинным: 1С формирует запросы, интеграционный слой взаимодействует с ФГИС, а результат возвращается в учетную систему.

Что такое интеграция Меркурий + 1С

Для программного взаимодействия с компонентом «Меркурий» Россельхознадзор предоставляет интеграционный шлюз ВетИС.API. В актуальной документации для хозяйствующих субъектов опубликован профиль MercuryG2B:Services:v3.0; в продуктивном контуре перечислены сервисы обработки заявок, реестров хозяйствующих субъектов и предприятий, справочной информации, продукции, регионализации и адресной информации.

Это означает, что 1С может выступать учетной системой, а отдельный интеграционный модуль или middleware — связующим слоем между 1С и государственным API.

                    1С
                     │
                     │ запрос
                     ▼
             Integration Layer
                     │
                     │ ВетИС.API
                     ▼
            ФГИС «Меркурий»
                     │
                     │ результат
                     ▼
             Integration Layer
                     │
                     ▼
                    1С

Какие операции можно автоматизировать

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

На рынке существуют готовые модули 1С, которые используют именно такую модель. Например, в материалах Россельхознадзора для модуля «Такском-Ветис» описаны сопоставление номенклатуры, единиц измерения и площадок, просмотр и массовое гашение эВСД, а также создание документа поступления в 1С при гашении. Это пример функциональности конкретного готового решения, а не универсальное описание любого интеграционного модуля.

Архитектура интеграции 1С и Меркурий

Для небольшой компании интеграционный модуль может находиться непосредственно внутри 1С. Для более крупной архитектуры лучше выделить отдельный Integration Layer.

┌───────────────────────┐
│         1С            │
│                       │
│ Приход / закупка      │
│ Номенклатура          │
│ Контрагенты           │
│ Склады                │
└───────────┬───────────┘
            │
            │ REST / SOAP / adapter
            ▼
┌─────────────────────────────┐
│      Integration Layer      │
│                             │
│ Auth / credentials          │
│ Mapping                     │
│ Queue                       │
│ Retry                       │
│ Idempotency                 │
│ Audit                       │
│ Monitoring                  │
└─────────────┬───────────────┘
              │
              │ ВетИС.API
              ▼
┌─────────────────────────────┐
│       ФГИС «Меркурий»       │
│                             │
│ ЭВСД / справочники / заявки │
└─────────────────────────────┘

Такой подход особенно полезен, если помимо 1С к Меркурию подключаются несколько учетных баз, WMS, ERP или другие корпоративные системы.

Почему главный вопрос — mapping

Технически отправить запрос в API проще, чем корректно сопоставить сущности двух систем.

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

1С                                   Меркурий
──────────────────────────────────────────────────
Номенклатура
  Молоко 3,2%              ─────►  Продукция
Код 00001234                ─────►  GUID / идентификатор

Склад «Основной»            ─────►  Предприятие / площадка
КПП / адрес                 ─────►  GUID

ООО «Поставщик»             ─────►  Хозяйствующий субъект
ИНН / КПП                   ─────►  GUID

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

Сопоставление номенклатуры 1С и Меркурия

Номенклатура — один из наиболее трудоемких элементов проекта. Нельзя ограничиваться сопоставлением по названию: в учетной системе могут использоваться разные фасовки, единицы измерения, упаковки и внутренние коды.

Сопоставление контрагентов

Контрагентов также лучше связывать по устойчивым идентификаторам, а не по названию организации.

1С
│
├── ИНН
├── КПП
├── Наименование
└── Код
       │
       ▼
Mapping
       │
       ▼
Меркурий
│
├── Хозяйствующий субъект
├── GUID
└── Предприятие / площадка

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

Автоматическое гашение входящих эВСД

Один из наиболее востребованных сценариев — обработка входящих электронных ветеринарных сопроводительных документов.

Поступление в 1С
       │
       ▼
Получение входящих эВСД
       │
       ▼
Сопоставление:
товар + площадка + количество
       │
       ▼
Проверка расхождений
       │
   ┌───┴────┐
   │        │
   ▼        ▼
  OK     Расхождение
   │        │
   ▼        ▼
Гашение    ручная
эВСД       обработка
   │
   ▼
Документ поступления 1С

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

Частичное принятие и расхождения

Для интеграции важно предусмотреть не только успешный сценарий. Фактическое количество товара может отличаться от количества в документе, а часть партии может быть не принята.

В готовых решениях для 1С встречаются сценарии частичного приема, возврата непринятой части и фиксации расхождений. Например, такие функции перечислены в материалах по модулю «Такском-Ветис».

При собственной интеграции эти сценарии необходимо отдельно заложить в бизнес-логику и обработку статусов.

Очередь запросов и асинхронная обработка

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

Лучше использовать очередь:

1С
 │
 │ создать операцию
 ▼
Integration Queue
 │
 ├── pending
 ├── processing
 ├── success
 └── failed
        │
        ▼
ВетИС.API
        │
        ▼
результат операции
        │
        ▼
Integration Queue
        │
        ▼
1С

Это позволяет не блокировать работу пользователя и отдельно обрабатывать временные ошибки, повторные запросы и операции, требующие дополнительной проверки.

Retry и идемпотентность

Государственный API и внешняя сеть не гарантируют, что каждый запрос завершится с первого раза. Поэтому интеграции нужны retry и idempotency.

Безопасность интеграции с ВетИС.API

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

Поэтому в production-архитектуре не следует хранить учетные данные и ключи доступа непосредственно в коде обработки 1С или в открытых конфигурационных файлах.

Готовый модуль 1С или собственная интеграция

Когда нужен отдельный Integration Layer

Отдельный слой имеет смысл, если 1С — только одна из систем в корпоративном контуре.

                       ФГИС Меркурий
                              ▲
                              │
                         ВетИС.API
                              │
                              ▼
                    ┌──────────────────┐
                    │ Integration Bus  │
                    │                  │
                    │ Mapping          │
                    │ Queue            │
                    │ Retry            │
                    │ Audit            │
                    │ Monitoring       │
                    └───────┬──────────┘
                            │
             ┌──────────────┼──────────────┐
             ▼              ▼              ▼
            1С ERP         WMS           CRM

В этом случае интеграционный слой становится единым местом для маршрутизации данных, а не отдельной обработкой внутри каждой системы.

Для такой архитектуры ModernERP может использовать Symfony как middleware между 1С, ВетИС.API и другими корпоративными системами: очереди, mapping, журнал обмена, retry и мониторинг находятся вне конкретной конфигурации 1С.

Стоимость интеграции Меркурий + 1С

Стоимость проекта определяется не самим фактом подключения к Меркурию, а количеством учетных систем, операций и бизнес-правил.

Как внедрить интеграцию Меркурий + 1С

1. Определить бизнес-процессы

Зафиксировать, какие операции должны автоматизироваться: получение эВСД, гашение, возвраты, расхождения, справочники и т.д.

2. Проверить доступ к ВетИС.API

Для продуктивной работы необходимо пройти установленную процедуру подключения к API. До продуктивного доступа предусмотрен тестовый контур.

3. Составить mapping

Связать номенклатуру, единицы измерения, склады, площадки и контрагентов между 1С и Меркурием.

4. Реализовать интеграционный модуль

Для простой архитектуры он может быть частью 1С. Для Enterprise-сценария целесообразно вынести его в отдельный Integration Layer.

5. Добавить очередь и журнал

Каждая операция должна иметь статус, идентификатор и результат обработки.

6. Протестировать реальные сценарии

Помимо успешного обмена необходимо проверить расхождения, повторные запросы, недоступность API, частичный прием и другие ошибки.

Типичные ошибки интеграции Меркурий и 1С

Что меняется в 2026 году

ВетИС продолжает обновляться. В опубликованных обновлениях Меркурия за 2026 год есть изменения интеграционного шлюза ВетИС.API, включая исправления при работе с запросами через API и изменения производительности.

Кроме того, в 2026 году развивается взаимодействие Меркурия с компонентом «Хорриот»: Россельхознадзор переводит отдельные сценарии на использование сведений о животных из реестра Хорриота. Это важно учитывать при разработке долгоживущей интеграционной архитектуры — интеграция с ВетИС является развивающимся государственным API, а не статичным интерфейсом.

FAQ

Можно ли интегрировать 1С с ФГИС Меркурий?

Да. Для программного взаимодействия используется ВетИС.API и профиль API компонента Меркурий. В актуальной документации опубликована версия профиля v3.0.

Можно ли автоматически гасить эВСД из 1С?

Такой сценарий может быть реализован в интеграционном модуле. Готовые решения для 1С на рынке реализуют получение и гашение эВСД, включая массовые операции. Конкретная реализация должна учитывать бизнес-правила компании и возможности используемого API.

Нужно ли отдельно сопоставлять номенклатуру?

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

Можно ли использовать готовый модуль 1С?

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

Зачем нужен Symfony?

Symfony нужен не для самого факта подключения к Меркурию, а для построения отдельного интеграционного слоя: mapping, очереди, retry, idempotency, audit и мониторинг.

Итог

ФГИС Меркурий + 1С — типовая задача интеграции для компаний, которые работают с подконтрольной ветеринарному надзору продукцией. Государственный контур хранит ветеринарные документы и связанные данные, а 1С — хозяйственные операции.

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

Для простого сценария может хватить готового модуля 1С. Для крупной компании с несколькими базами 1С, WMS и ERP целесообразнее отдельный Integration Layer, где централизованы mapping, очереди, retry, idempotency и журнал обмена.