Гайд 1С: Интеграция с ФГИС Меркурий через универсальный шлюз ВетИС
При взаимодействии типовых решений 1С с универсальным шлюзом ВетИС.API возникают сложности:
- Ошибки шлюза
MERC10005 / MERC10008: Запрашиваемая операция не может быть выполнена. - Превышение лимита времени ожидания ответа на асинхронную заявку (Application ID) в шлюзе ВетИС.
- Рассинхронизация остатков партий сырья в 1С и электронном журнале продукции ВетИС.
- Ошибки авторизации по реквизитам хозяйствующего субъекта (ХС) и предприятия.
1. Архитектурный принцип работы ВетИС.API 2.x
Шлюз ВетИС работает по асинхронной модели с использованием двух веб-сервисов SOAP:
- submitApplicationRequest: отправка пакета бизнес-данных (гашение ВСД, инвентаризация, производство) в очередь шлюза. Возвращает уникальный идентификатор заявки (
applicationId). - receiveApplicationResult: периодический запрос результата обработки заявки по ее
applicationId.
2. Настройка регламентных заданий обмена
В 1С перейдите в Администрирование -> Интеграция с ВетИС (Меркурий):
- Задайте реквизиты доступа:
API Key,Issuer ID,Service User Login / Password. - Настройте интервал опроса результатов заявок: не чаще одного раза в
3–5 секунд, чтобы избежать блокировки со стороны шлюза Россельхознадзора. - Включите автоматическое сопоставление номенклатуры 1С с 4-уровневым справочником продукции ВетИС.
3. Оптимизация пакетного гашения ВСД
Используйте групповое оформление и гашение ВСД: объединяйте до 100 записей в одну XML-заявку, что снижает нагрузку на сеть и ускоряет закрытие партий.
Частые вопросы (FAQ)
В чем разница между полномочиями 'Гашение ВСД' и 'Уполномоченное гашение'?
Стандартное гашение позволяет подтверждать поступление продукции на собственные склады предприятия. Уполномоченное гашение позволяет гасить ВСД за сторонних контрагентов по агентской схеме.
Что делать, если ВетИС.API возвращает статус заявки IN_PROCESS длительное время?
Шлюз ВетИС может испытывать пиковые нагрузки. Увеличьте количество повторных попыток вызова метода receiveApplicationResult и настройте экспоненциальную задержку между запросами.
Как исправить ошибку несоответствия единиц измерения номенклатуры 1С и ВетИС?
В справочнике сопоставления номенклатуры 1С настройте точный коэффициент пересчета между прикладной единицей (например, штуки/упаковки) и базовой единицей классификатора ВетИС (граммы/килограммы).
Можно ли гасить ВСД с расхождением по количеству?
Да. При гашении в 1С указывается фактически принятое количество и составляется электронный 'Акт несоответствия' (или оформляется возвратный ВСД на непринятый остаток).