Как подключить 1С к тестовому контуру ВетИС.API и исправить ошибки настройки администратора?

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

Решение проблемы с выбором администратора в настройках ВетИС.API

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

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

Рассмотрим подробнее, почему это происходит. Программа разделяет права доступа: государственные врачи имеют свой специфический набор функций и не могут выступать в роли администратора хозяйствующего субъекта (ХС) при настройке API-интерфейса для коммерческой организации. Как только вы снимаете этот признак, пользователь мгновенно появляется в списке выбора.

Помимо этого флага, проверим дополнительные параметры, которые влияют на корректность подключения:

1. Синхронизация с ВетИС.Паспорт: Убедимся, что у данного логина в веб-интерфейсе «ВетИС.Паспорт» активированы роли «Администрирование списка пользователей ХС» или «Управление правами пользователей». Без этих прав на стороне шлюза API может отклонять запросы, даже если в 1С настройки выглядят корректными.
2. Логин и API-key: Проверим, что логин администратора в 1С (обычно фамилия латиницей) в точности совпадает с логином в системе «Цербер»/«Паспорт». Помните, что для тестового контура (T2) выдаются отдельные идентификаторы (API-key, IssuerID), которые отличаются от «боевых».
3. Привязка к ХС: В карточке пользователя 1С должна быть четкая связь с тем Хозяйствующим Субъектом, для которого настраивается шлюз.

Устранение ошибки «Внутренняя ошибка поиска данных стран мира»

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

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

Алгоритм исправления ошибки:

1. Обновление классификатора: Перейдем в справочник Страны мира и выполним загрузку актуальных данных из классификатора ОКСМ. Это необходимо, чтобы обновить внутренние идентификаторы, которые могли устареть в старой версии конфигурации (например, 2.4.10).
2. Проверка карточки номенклатуры: Проанализируем настройки номенклатуры, участвующей в документе. На вкладке, связанной с ВетИС, обязательно должна быть указана страна происхождения (чаще всего — Россия). Если поле пустое, 1С передает некорректный блок данных в API.
3. Перезагрузка данных ВетИС: Воспользуемся панелью администрирования ВетИС в 1С. Разберем путь: Администрирование — Настройки ВетИС — Классификаторы — Загрузить. В списке классификаторов выберем «Страны мира» и инициируем полную синхронизацию с сервером «Меркурия». В тестовом контуре (T2) справочники могут отличаться, поэтому принудительное обновление часто решает проблему.

Особенности работы с тестовым контуром (T2)

При работе с тестовой средой важно понимать, что она не является полной копией рабочей базы и может работать нестабильно. Рассмотрим несколько практических советов по настройке:

Версия API: Если ваша конфигурация позволяет выбирать версию протокола, всегда выбирайте 2.0 и выше. Тестовый контур — это площадка для обкатки новых технологий, и поддержка старых версий (1.1) там отключается значительно раньше, чем в «боевой» среде.

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

Проверка связи: Используйте встроенную кнопку «Проверить связь» в форме настроек ВетИС.API. Если система выдает ошибку авторизации, проверьте адрес сервера. Для тестового контура он обычно содержит поддомен t2-api.vetrf.ru.

Посмотрим на пример того, как программно может выглядеть проверка прав пользователя, если вы решите кастомизировать процесс (только для ознакомления с логикой системы):

// Пример логики проверки флага ГосВетВрач
Если ПользовательВетис.ГосударственныйВетеринарныйВрач Тогда
    Предупреждение("Данный пользователь не может быть назначен администратором подключения!");
КонецЕсли;

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