Компонент Ветис.API: различия между версиями
Строка 19: | Строка 19: | ||
== Структура == | == Структура == | ||
<!--- | |||
=== Базовые компоненты === | === Базовые компоненты === | ||
* Документ представляет собой набор базовых типов и элементов, на основе которых строятся веб-сервисы автоматизированных систем Россельхознадзора. Кроме этого, в документе описаны единые правила версионности для объектов, передаваемых через веб-сервис. ([[Media:Platform_base_requirements_1.1_v2.pdf|PDF]]) | * Документ представляет собой набор базовых типов и элементов, на основе которых строятся веб-сервисы автоматизированных систем Россельхознадзора. Кроме этого, в документе описаны единые правила версионности для объектов, передаваемых через веб-сервис. ([[Media:Platform_base_requirements_1.1_v2.pdf|PDF]]) | ||
--> | |||
Шлюз состоит из двух подсистем: [[#Подсистема обработки заявок|подсистемы обработки заявок]] и подсистемы работы со справочниками и реестрами. | |||
=== [[Подсистема обработки заявок в Ветис.API|Подсистема обработки заявок]] === | === [[Подсистема обработки заявок в Ветис.API|Подсистема обработки заявок]] === | ||
Это сервис для выполнения бизнес-операций в специализированных информационных системах Аргус, Меркурий, Веста и т.д. В подсистеме реализован сервис ApplicationManagementService суть работы которого заключается в приеме, авторизации и маршрутизации заявки к той или иной целевой специализированной информационной системе. Работа с этим сервисом реализована по псевдо-асинхронному принципу и осуществляется в два шага: | |||
# шаг – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно); | |||
# шаг – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно). | |||
Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье [[Подсистема обработки заявок в Ветис.API|Подсистема обработки заявок]]. | |||
<!-- | |||
* WSDL: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.3_pilot.wsdl | * WSDL: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.3_pilot.wsdl | ||
* Описание типов заявок к информационной системе Меркурий для хозяйствующих субъектов: | * Описание типов заявок к информационной системе Меркурий для хозяйствующих субъектов: | ||
Строка 34: | Строка 41: | ||
* Описание типов заявок к информационной системе Меркурий для ветеринарных управлений: | * Описание типов заявок к информационной системе Меркурий для ветеринарных управлений: | ||
http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.3.xsd | http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.3.xsd | ||
--> | |||
=== Подсистема работы со справочниками и реестрами === | |||
Это группа сервисов предназанчена для работы со справочниками и реестрами, использующимися в Ветис. Для работы с логическими группами справочников разработан отдельный сервис. | |||
* | * Цербер - сервис получения реестра хозяйствующих субъектов и предприятий ([[Media:Enterprise service requirements 1.1 v2.pdf|PDF]]): | ||
:WSDL: http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1 | :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 | |||
* Икар - сервис получения адресной справочной информации ([[Media:Ikar service requirements 1.1 v2.pdf|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 | |||
* Сервис получения справочной информации ([[Media:Dictionary_service_requirements_1.1_v2.pdf|PDF]]). | * Сервис получения справочной информации ([[Media:Dictionary_service_requirements_1.1_v2.pdf|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 | :WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/DictionaryService_v1.3_pilot.wsdl | ||
* Сервис получения | |||
* Сервис получения реестра категорий продукции ([[Media:Product_service_requirements_1.1_v2.pdf|PDF]]): | |||
:WSDL: http://api.vetrf.ru/schema/platform | :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 | |||
Список используемых упаковок размещён [[PackingForm#Список упаковок|на этой странице]] | Список используемых упаковок размещён [[PackingForm#Список упаковок|на этой странице]] | ||
Версия 16:22, 8 июня 2016
Основное назначение
Универсальный шлюз Ветис.API предоставляет возможность сторонним информационным системам обмениваться информацией с компонентами Ветис для выполнения прикладных задач, получения справочной информации и сведений из реестров.
Цели создания
- Расширение возможностей платформы Ветис и ее компонентов за счет подключения сторонних информационных систем.
- Автоматизация взаимодействия системы Меркурий с учетными системами хозяйствующих субъектов и ветеринарных служб субъектов для решения задач электронной ветеринарной сертификации.
Использование/возможности
Взаимодействие с системой Меркурий
Ветис.API позволяет сторонним информационным системам передавать информацию, необходимую для формирования электронных ветеринарных сертификатов в Меркурий, получать информацию об оформленных электронных сертификатах из Меркурия.
Взаимодействие с системой Цербер
Ветис.API позволяет обмениваться информацией с реестром хозяйствующих субъектов и поднадзорных объектов.
Взаимодействие с системой Икар
Ветис.API позволяет получать информацию из единого хранилища адресных данных, которые используются в информационных системах Россельхознадзора.
Структура
Шлюз состоит из двух подсистем: подсистемы обработки заявок и подсистемы работы со справочниками и реестрами.
Подсистема обработки заявок
Это сервис для выполнения бизнес-операций в специализированных информационных системах Аргус, Меркурий, Веста и т.д. В подсистеме реализован сервис ApplicationManagementService суть работы которого заключается в приеме, авторизации и маршрутизации заявки к той или иной целевой специализированной информационной системе. Работа с этим сервисом реализована по псевдо-асинхронному принципу и осуществляется в два шага:
- шаг – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно);
- шаг – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно).
Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье Подсистема обработки заявок.
Подсистема работы со справочниками и реестрами
Это группа сервисов предназанчена для работы со справочниками и реестрами, использующимися в Ветис. Для работы с логическими группами справочников разработан отдельный сервис.
- Цербер - сервис получения реестра хозяйствующих субъектов и предприятий (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/.