Компонент Ветис.API: различия между версиями

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
Строка 42: Строка 42:
'''2 шаг''' – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно).  
'''2 шаг''' – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно).  
Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье [[Подсистема обработки заявок в Ветис.API|Подсистема обработки заявок в Ветис.API]].
Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье [[Подсистема обработки заявок в Ветис.API|Подсистема обработки заявок в Ветис.API]].
<!--  
 
* WSDL: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.3_pilot.wsdl
 
* Описание типов заявок к информационной системе Меркурий для хозяйствующих субъектов:
* '''WSDL (ApplicationManagementsService) - пилотная версия''': http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.3_pilot.wsdl
* '''WSDL (ApplicationManagementsService) - боевая версия''': http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.2_production.wsdl
<!--* Описание типов заявок к информационной системе Меркурий для хозяйствующих субъектов:
http://api.vetrf.ru/schema/platform/mercury/g2b/applications_v1.3.xsd
http://api.vetrf.ru/schema/platform/mercury/g2b/applications_v1.3.xsd
* Описание типов заявок к информационной системе Меркурий для ветеринарных управлений:
* Описание типов заявок к информационной системе Меркурий для ветеринарных управлений:

Версия 09:19, 9 июня 2016

Основное назначение

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

Цели создания

  • Расширение возможностей платформы Ветис и ее компонентов за счет подключения сторонних информационных систем.
  • Автоматизация взаимодействия системы Меркурий с учетными системами хозяйствующих субъектов и ветеринарных служб субъектов для решения задач электронной ветеринарной сертификации.

Использование/возможности

Взаимодействие с системой Меркурий

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

Сервис предоставляет следующие операции: оформление производственной партии; оформление транспортной партии; оформление входящей партии; оформление результатов инвентаризации; объединение записей складского журнала; получение ВСД по его идентификатору; получение ВСД, созданных или измененных за указанный интервал дат (получение истории изменений); получение всех ВСД предприятия с возможностью фильтрации; получение конкретной версии записи складского журнала по ее идентификатору; получение последней (актуальной) версии записи складского журнала по ее идентификатору; получение всех версий записи складского журнала по ее идентификатору; получение актуального списка записей журнала; получение списка версий записей журнала, созданных или измененных за указанный интервал дат (получение истории изменений); добавление/изменение сведений о хозяйствующем субъекте; добавление/изменение сведений о поднадзорном объекте; аннулирование ВСД; создание/удаление связи с площадкой; добавление номенклатуры производителя в справочник.

Взаимодействие с системой Цербер

EnterpriseService позволяет обмениваться информацией с реестром хозяйствующих субъектов и поднадзорных объектов.

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

Взаимодействие с системой Икар

IkarService позволяет получать информацию из единого хранилища адресных данных, которые используются в информационных системах Россельхознадзора.

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

Структура

Шлюз состоит из двух подсистем: подсистемы обработки заявок и подсистемы работы со справочниками и реестрами.

Рис. 1. Структура Ветис.API

Подсистема обработки заявок

Это сервис для выполнения бизнес-операций в специализированных информационных системах Аргус, Меркурий, Веста и т.д. В подсистеме реализован сервис ApplicationManagementService суть работы которого заключается в приеме, авторизации и маршрутизации заявки к той или иной целевой специализированной информационной системе. Работа с этим сервисом реализована по псевдо-асинхронному принципу и осуществляется в два шага:

1 шаг – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно);

2 шаг – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно). Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье Подсистема обработки заявок в Ветис.API.


Подсистема работы со справочниками и реестрами

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

  • Цербер (EnterpriseService) - сервис получения реестра хозяйствующих субъектов и предприятий (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
  • Икар (IkarService) - сервис получения адресной справочной информации (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
  • DictionaryService - Сервис получения справочной информации (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
  • ProductService - Сервис получения реестра категорий продукции (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

Предоставление доступа

Доступ к шлюзу предоставляется в 2 этапа: при первичной подаче заявки доступ предоставляется только к тестовой версии шлюза Ветис.API. После завершения работ по тестированию и отладке взаимодействия клиенту предоставляется доступ к продуктивной версии шлюза.

Тестовая версия

Доступ к тестовой версии универсального шлюза для разработки и тестирования клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.

Заявка оформляется в свободной форме на бланке организации за подписью руководителя предприятия и печатью и содержит следующие сведения:Пример заявки на подключение к Ветис.API

  • Название организации, ответственной за формирование запросов к Ветис.API.
  • Реквизиты организации:
    • Юридический адрес;
    • ИНН;
    • ОГРН.
  • Контактное лицо (или контактные лица) по техническим и организационным вопросам.
  • Краткое название (платформа) подключаемой программной системы, осуществляющей запросы.
  • Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат).

Заявки принимаются на имя директора ФГБУ ВНИИЗЖ Лозового Д.А. по адресам:

  • почтовый адрес: 600901, г. Владимир, мкр. Юрьевец, ФГБУ «Федеральный центр охраны здоровья животных» (ФГБУ «ВНИИЗЖ»);
  • электронная почта: api@vetrf.ru;
  • факс: (4922) 26-38-77.

Продуктивная версия

Доступ к продуктивной версии предоставляется только после того, как клиент завершил разработку и отладку в тестовой версии шлюза.

Обновление системы

Перечень обновлений системы:

Планируемые функции

Предварительный перечень новых функций, запланированных на второе поколение системы (версии 2.x шлюза):

  1. Идентификация хозяйствующих субъектов по ИНН/КПП. Исключение необходимости синхронизации реестра хозяйствующих субъектов.
  2. Поддержка пакетного режима подачи и рассмотрения заявок.
  3. Поддержка идентификатора производственной партии, нанесенного на индивидуальную упаковку товара.
  4. Поддержка унифицированного классификатора продукции GS1 International (GPC).
  5. Поддержка стандарта GLN для идентификации площадок.
  6. Поддержка мониторинга доступности узлов системы.
  7. Возможность управления пользователями хозяйствующего субъекта через универсальный шлюз.
  8. Формирование справочника причин инвентаризации.
  9. Адаптация универсального шлюза для взаимодействия с информационными системами операторов 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/.

Ссылки

См. также

Вернуться к началу ↑