Компонент Ветис.API
Основное назначение
Универсальный шлюз Ветис.API предоставляет возможность сторонним информационным системам обмениваться информацией с компонентами Ветис для выполнения прикладных задач, получения справочной информации и сведений из реестров.
Цели создания
- Расширение возможностей платформы Ветис и ее компонентов за счет подключения сторонних информационных систем.
- Автоматизация взаимодействия системы Меркурий с учетными системами хозяйствующих субъектов и ветеринарных служб субъектов для решения задач электронной ветеринарной сертификации.
Использование/возможности
Взаимодействие с системой Меркурий
Ветис.API позволяет сторонним информационным системам передавать информацию, необходимую для формирования электронных ветеринарных сертификатов в Меркурий, получать информацию об оформленных электронных сертификатах из Меркурия.
Взаимодействие с системой Цербер
Ветис.API позволяет обмениваться информацией с реестром хозяйствующих субъектов и поднадзорных объектов.
Взаимодействие с системой Икар
Ветис.API позволяет получать информацию из единого хранилища адресных данных, которые используются в информационных системах Россельхознадзора.
Структура
Шлюз состоит из двух подсистем: подсистемы обработки заявок и подсистемы работы со справочниками и реестрами.
Подсистема обработки заявок
Это сервис для выполнения бизнес-операций в специализированных информационных системах Аргус, Меркурий, Веста и т.д. В подсистеме реализован сервис ApplicationManagementService суть работы которого заключается в приеме, авторизации и маршрутизации заявки к той или иной целевой специализированной информационной системе. Работа с этим сервисом реализована по псевдо-асинхронному принципу и осуществляется в два шага:
1 шаг – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно); 2 шаг – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно). Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье Подсистема обработки заявок.
Подсистема работы со справочниками и реестрами
Это группа сервисов предназанчена для работы со справочниками и реестрами, использующимися в Ветис. Для работы с логическими группами справочников разработан отдельный сервис.
- Цербер - сервис получения реестра хозяйствующих субъектов и предприятий (PDF):
- WSDL (продуктивная версия): http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1.2_production.wsdl
- WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1.3_pilot.wsdl
- Икар - сервис получения адресной справочной информации (PDF).
- WSDL (продуктивная версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.2_production.wsdl
- WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.3_pilot.wsdl
- Сервис получения справочной информации (PDF).
- WSDL (боевая версия): http://api.vetrf.ru/schema/platform/services/DictionaryService_v1.2_production.wsdl
- WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/DictionaryService_v1.3_pilot.wsdl
- Сервис получения реестра категорий продукции (PDF):
- WSDL (боевая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.2_production.wsdl
- WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.3_pilot.wsdl
Список используемых упаковок размещён на этой странице
Предоставление доступа
Тестовая версия
Доступ к тестовой версии универсального шлюза для разработки и тестирования клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
Заявка оформляется в свободной форме на бланке организации за подписью руководителя предприятия и печатью и содержит следующие сведения:Пример заявки на подключение к Ветис.API
- Название организации, ответственной за формирование запросов к Ветис.API.
- Реквизиты организации:
- Юридический адрес;
- ИНН;
- ОГРН.
- Контактное лицо (или контактные лица) по техническим и организационным вопросам.
- Краткое название (платформа) подключаемой программной системы, осуществляющей запросы.
- Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат).
Заявки принимаются на имя директора ФГБУ ВНИИЗЖ Лозового Д.А. по адресам:
- почтовый адрес: 600901, г. Владимир, мкр. Юрьевец, ФГБУ «Федеральный центр охраны здоровья животных» (ФГБУ «ВНИИЗЖ»);
- электронная почта: api@vetrf.ru;
- факс: (4922) 26-38-77.
Боевая версия
Доступ к боевой версии выдаётся только после того, как хозяйствующий субъект поработал в тестовой.
Доступ предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
Заявка оформляется в свободной форме на бланке организации за подписью руководителя предприятия и печатью и содержит следующие сведения: Пример заявки на подключение к Ветис.API
- Название организации, ответственной за формирование запросов к Ветис.API.
- Реквизиты организации:
- Юридический адрес;
- ИНН;
- ОГРН.
- Контактное лицо (или контактные лица) по техническим и организационным вопросам.
- Краткое название (платформа) подключаемой программной системы, осуществляющей запросы.
- Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат).
Заявки принимаются на имя директора ФГБУ ВНИИЗЖ Лозового Д.А. по адресам:
- почтовый адрес: 600901, г. Владимир, мкр. Юрьевец, ФГБУ «Федеральный центр охраны здоровья животных» (ФГБУ «ВНИИЗЖ»);
- электронная почта: api@vetrf.ru;
- факс: (4922) 26-38-77.
Обновление системы
Перечень обновлений системы:
Планируемые функции
Предварительный перечень новых функций, запланированных на второе поколение системы (версии 2.x шлюза):
- Идентификация хозяйствующих субъектов по ИНН/КПП. Исключение необходимости синхронизации реестра хозяйствующих субъектов.
- Поддержка пакетного режима подачи и рассмотрения заявок.
- Поддержка идентификатора производственной партии, нанесенного на индивидуальную упаковку товара.
- Поддержка унифицированного классификатора продукции GS1 International (GPC).
- Поддержка стандарта GLN для идентификации площадок.
- Поддержка мониторинга доступности узлов системы.
- Возможность управления пользователями хозяйствующего субъекта через универсальный шлюз.
- Формирование справочника причин инвентаризации.
- Адаптация универсального шлюза для взаимодействия с информационными системами операторов EDI.
С предложениями по развитию Ветис.API обращайтесь по электронной почте на адрес api@vetrf.ru или на специализированный форум системы.
Сопровождение и поддержка
По техническим вопросам, связанным с использованием Ветис.API, обращайтесь по электронной почте на адрес api@vetrf.ru или на специализированный форум системы.
При наличии технической проблемы опишите в письме ее суть, приложите примеры SOAP-запросов и ответов. Свои предложения и пожелания по разработке Ветис.API вы можете также направлять по данному адресу.
Мониторинг доступности
Основной сервер
Версия Ветис.API: v1.2
Версия ИС Меркурий: v4.3.10.3
Статус сервера: доступен
Точка доступа (Endpoint URL): https://api.vetrf.ru/platform/services/ApplicationManagementService
WSDL-описание: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.2_production.wsdl
Адрес ИС Меркурий: https://mercury.vetrf.ru/
Плановое обновление: август 2016, Ветис.API v1.3
Пилотный (тестовый) сервер
Версия Ветис.API: v1.3
Версия ИС Меркурий: v4.3.10-GATEWAY
Статус сервера: доступен
Точка доступа (Endpoint URL): https://api2.vetrf.ru:8002/platform/services/ApplicationManagementService
WSDL-описание: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.3_pilot.wsdl
Адрес ИС Меркурий: https://t2-mercury.vetrf.ru/.