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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
(не показано 40 промежуточных версий 7 участников)
Строка 44: Строка 44:
'''2 шаг''' – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно).  
'''2 шаг''' – подача запроса на получение результатов обработки заявки/выполнения бизнес-операции (выполняется синхронно).  


Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье [[Подсистема обработки заявок в Ветис.API|Подсистема обработки заявок в Ветис.API]].
Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье [[Подсистема обработки заявок в Ветис.API|'''Подсистема обработки заявок в Ветис.API''']].
 
==== Сервис обработки заявок для хозяйствующих субъектов ====
{| class="wikitable"
|-
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v1''' || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl <br/>Описание типов заявок:<br/> http://api.vetrf.ru/schema/platform/mercury/g2b/applications_v1.4.xsd || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl <br/>Описание типов заявок:<br/> http://api.vetrf.ru/schema/platform/mercury/g2b/applications_v1.4.xsd
|-
| '''v2''' || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl <br/>Описание типов заявок: ''включено в WSDL'' || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ams-mercury-g2b.service_v2.0_pilot.wsdl <br/>Описание типов заявок: ''включено в WSDL''
|}
 
==== Сервис обработки заявок для ветеринарных управлений ====
{| class="wikitable"
|-
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v1''' || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl <br/>Описание типов заявок:<br/> http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.4.xsd || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl <br/>Описание типов заявок:<br/> http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.4.xsd
|-
| '''v2''' || WSDL: ''недоступен'' <br/>Описание типов заявок: ''включено в WSDL'' || WSDL: ''недоступен'' <br/>Описание типов заявок: ''включено в WSDL''
|}
 
==== Предыдущие версии ====


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


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


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


* '''Цербер (EnterpriseService)''' - сервис получения реестра хозяйствующих субъектов и предприятий ([[Media:Enterprise service requirements 1.1 v2.pdf|PDF]]):
* '''Цербер (EnterpriseService)''' - сервис получения реестра хозяйствующих субъектов и предприятий ([[Media:Enterprise service requirements 1.1 v2.pdf|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_production.wsdl
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1.3_pilot.wsdl
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1.4_pilot.wsdl


* '''Икар (IkarService)''' - сервис получения адресной справочной информации ([[Media:Ikar service requirements 1.1 v2.pdf|PDF]]):
* '''Икар (IkarService)''' - сервис получения адресной справочной информации ([[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_production.wsdl  
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.3_pilot.wsdl
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.4_pilot.wsdl


* '''DictionaryService''' - Сервис получения справочной информации ([[Media:Dictionary_service_requirements_1.1_v2.pdf|PDF]]):
* '''DictionaryService''' - Сервис получения справочной информации ([[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_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.4_pilot.wsdl


* '''ProductService''' - Сервис получения реестра категорий продукции ([[Media:Product_service_requirements_1.1_v2.pdf|PDF]]):
* '''ProductService''' - Сервис получения реестра категорий продукции ([[Media:Product_service_requirements_1.1_v2.pdf|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_production.wsdl  
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.3_pilot.wsdl
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.4_pilot.wsdl
<!-- [[Файл:Example.jpg]] -->
<!-- [[Файл:Example.jpg]] -->


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


Доступ к шлюзу предоставляется в 2 этапа: при первичной подаче заявки доступ предоставляется только к '''тестовой версии''' шлюза Ветис.API. После завершения работ по тестированию и отладке взаимодействия клиенту предоставляется доступ к '''продуктивной версии''' шлюза.
=== Ветис.API 2.0 ===
 
==== Продуктивный контур ====
* Сервис обработки заявок к сервису mercury-g2b.service: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl
* Сервис получения сведений из базовых справочников: http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_production.wsdl
* Сервис получения сведений из реестра хоз.субъектов и предприятий: http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_production.wsdl
* Сервис получения адресно-справочной информации: http://api.vetrf.ru/schema/platform/services/2.0-last/IkarService_v2.0_production.wsdl
* Сервис получения сведений из справочников продукции и номенклатуры: http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_production.wsdl
* Сервис получения сведений из реестра правил регионализации: http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_production.wsdl
 
 
Зависимости
* http://api.vetrf.ru/schema/platform/services/2.0-last/application_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/application_ws_definitions_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/ApplicationManagementService_v1.1.wsdl
* http://api.vetrf.ru/schema/platform/services/2.0-last/base_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/base_ws_definitions_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/dictionary_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/document_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/mercury-g2b.service_v2.0.wsdl
* http://api.vetrf.ru/schema/platform/services/2.0-last/mercury-vu.service_v2.0.wsdl
* http://api.vetrf.ru/schema/platform/services/2.0-last/mercury_g2b_applications_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/mercury_vu_applications_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/registry_ws_definitions_v2.0.xsd
 
 
==== Тестовый контур ====
На пилотном сервере с 01.08.2017 доступна версия 2.0 Ветис.API. Приглашаем всех желающих принять участие в тестировании.
 
* Сервис обработки заявок к сервису mercury-g2b.service: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ams-mercury-g2b.service_v2.0_pilot.wsdl
* Сервис обработки заявок к сервису mercury-vu.service: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ams-mercury-vu.service_v2.0_pilot.wsdl
* Сервис получения сведений из базовых справочников: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/DictionaryService_v2.0_pilot.wsdl
* Сервис получения сведений из реестра хоз.субъектов и предприятий: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/EnterpriseService_v2.0_pilot.wsdl
* Сервис получения адресно-справочной информации: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/IkarService_v2.0_pilot.wsdl
* Сервис получения сведений из справочников продукции и номенклатуры: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ProductService_v2.0_pilot.wsdl
* Сервис получения сведений из реестра правил регионализации: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/RegionalizationService_v2.0_pilot.wsdl
 
 
Зависимости
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/application_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/application_ws_definitions_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ApplicationManagementService_v1.1.wsdl
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/base_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/base_ws_definitions_v1.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/dictionary_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/document_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/mercury-g2b.service_v2.0.wsdl
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/mercury-vu.service_v2.0.wsdl
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/mercury_g2b_applications_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/mercury_vu_applications_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-RC-last/registry_ws_definitions_v2.0.xsd


===Тестовая версия===
== Предоставление доступа ==
Доступ к '''тестовой версии''' универсального шлюза для разработки и тестирования клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.  
Процедура предоставления доступа к Ветис:
#Доступ к Ветис.API предоставляется в 2 этапа: первый этап – подача заявки на предоставление доступа к тестовой версии ([[Медиа:Пример_заявки_на_Ветис_t2.API.pdf‎|Пример заявки на подключение к тестовой версии Ветис.API]]) Ветис.API для разработки и отладки, второй этап – подача заявки на предоставление доступа к продуктивной версии Ветис.API.
#Доступ к тестовой версии Ветис.API для разработки и отладки клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
#Заявка оформляется на бланке организации c подписью руководителя (или уполномоченного им лица) и печатью организации и предоставляется в ФГБУ «ВНИИЗЖ» по электронной почте на адрес [mailto:api@vetrf.ru api@vetrf.ru].
#Заявка должна содержать следующие данные:
##Название и реквизиты (Юридический адрес; ИНН; ОГРН) хозяйствующего субъекта или организации, ответственной за формирование запросов к Ветис.API.
##Контактное лицо (или контактные лица) по техническим и организационным вопросам (ФИО, место работы, адрес электронной почты, телефон).
##Название подключаемой программной системы (платформы), осуществляющей запросы.
##Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат). Согласие перечисленных хозяйствующих субъектов на обработку их данных в ВетИС.
#Регистрация производится должностными лицами ФГБУ "ВНИИЗЖ" в срок не более 5 рабочих дней после получения заявки.
#После регистрации организации или учреждению предоставляются:
##Реквизиты доступа к тестовой версии Ветис.API (реквизиты доступа направляются на адрес личной электронной почты контактного лица).
##Реквизиты доступа к веб-интерфейсу тестовой версии шлюза подсистемы Меркурий.ХС.
##Возможность использовать тестовую версию Ветис.API в соответствии с назначенной ролью и указанной "Зоной обслуживания".
#По окончании разработки и тестирования клиентского модуля организация или учреждение самостоятельно определяет свою готовность к переходу к продуктивной версии Ветис.API. Готовность определяется с учетом следующих критериев:
##Операции оформления ВСД и другие операции, реализованные из информационной системы организации или учреждения, не нарушают внутренние бизнес-процессы и не приводят к задержке производственных или логистических операций.
##Все необходимые для организации или учреждения операции протестированы и апробированы в достаточной мере: оформление ВСД из информационной системы осуществлялось в течение периода не менее 10 рабочих дней в режиме реального производственного процесса.
##В период апробации в режиме реального производственного процесса количество запросов с ошибками с кодом MERC не должно превышать 10% от общего количества запросов этого типа в сутки. Ошибки с кодом APL и APLM отсутствуют в период апробации.
#Доступ к продуктивной версии предоставляется только после того, как клиент завершил разработку и отладку в тестовой версии шлюза и только в том случае, если сторонняя информационная система и разработанный для ее интеграции с ФГИС Меркурий шлюз соответствуют следующим требованиям:
##Сторонняя информационная система должна обеспечивать отсутствие технической возможности внесения изменений в сертификат, оформление которого завершено, если такой сертификат хранится и на удаленных рабочих станциях сторонней информационной системы.
#При наличии обоснованной уверенности в готовности использовать продуктивную версию Ветис.API ([[Медиа:Ветис.API_production.pdf‎|Пример заявки на подключение к продуктивной версии Ветис.API]]) организация или учреждение сообщает об этом путем направления заявки на доступ к продуктивной версии Ветис.API, содержащей сведения, указанные в пункте 4.
#Регистрация производится должностными лицами ФГБУ "ВНИИЗЖ" в срок не более 5 рабочих дней после получения заявки.
#После регистрации организации или учреждению предоставляются:
##Реквизиты доступа к продуктивной версии Ветис.API (реквизиты доступа направляются на адрес указанной электронной почты контактного лица).
##Возможность использовать продуктивную версию Ветис.API в соответствии с назначенной ролью и указанной "Зоной обслуживания".
##Доступ к тестовой версии Ветис.API сохраняется.
##Доступ в веб-интерфейс для рабочего сервера необходимо получить по отдельной заявке. Инструкцию и шаблон заявки вы можете посмотреть [[Администрирование_списка_пользователей_хозяйствующего_субъекта_в_Ветис.Паспорт|здесь]]
#Регистрация может быть аннулирована в следующих случаях.
##Если общее количество любых ошибок при выполнении бизнес-операций в продуктивной версии Ветис.API превысило 10% от общего количества запросов этого типа за сутки. В этом случае организации или учреждению, ответственному за оформление запросов к шлюзу, выносится предупреждение. Если ошибки не устранены в течение 5 рабочих дней, производится отключение программной системы от продуктивной версии Ветис.API на срок не менее 1 месяца и до устранения ошибок. В этот период учреждению или организации доступна только тестовая версия Ветис.API.
#Для восстановления доступа к продуктивной версии Ветис.API необходимо отправить соответствующую заявку.


Заявка оформляется в свободной форме на бланке организации за подписью руководителя предприятия и печатью и содержит следующие сведения:[[Медиа:Заявка_на_тестовый_доступ_к_Ветис.API.pdf|Пример заявки на подключение к Ветис.API]]
== С чего начать ==
* Название организации, ответственной за формирование запросов к '''Ветис.API'''.
* Реквизиты организации:
** Юридический адрес;
** ИНН;
** ОГРН.
* Контактное лицо (или контактные лица) по техническим и организационным вопросам.
* Краткое название (платформа) подключаемой программной системы, осуществляющей запросы.
* Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат).
Заявки принимаются на имя директора ФГБУ ВНИИЗЖ Лозового Д.А. по адресам:
* почтовый адрес: 600901, г. Владимир, мкр. Юрьевец, ФГБУ «Федеральный центр охраны здоровья животных» (ФГБУ «ВНИИЗЖ»);
* электронная почта: [mailto:api@vetrf.ru api@vetrf.ru];
* факс: (4922) 26-38-77.


=== Продуктивная версия ===
ECR-Russia и лично координатор данной организации по вопросам, связанным с оформлением электронных ВСД, Юрий Кумпан, подготовил документ, который содержит практические шаги по реализации интеграционного проекта учетной системы предприятия с ФГИС "Меркурий", называется он [[Media:Ecr.pdf|«Первые шаги в проектах интеграции с ФГИС Меркурий»]].
Доступ к продуктивной версии предоставляется '''только после того, как клиент завершил разработку и отладку в тестовой версии шлюза'''.


== Обновление системы ==
== Обновление системы ==
Строка 131: Строка 214:
<big>'''Основной сервер'''</big>
<big>'''Основной сервер'''</big>


Версия Ветис.API: v1.2
Версия Ветис.API: v1.4 и v2.0


Версия ИС Меркурий: v4.3.10.3
Версия ИС Меркурий: v6.1.6


Статус сервера: доступен  
Статус сервера: доступен  


Точка доступа (Endpoint URL): https://api.vetrf.ru/platform/services/ApplicationManagementService
Точка доступа v1 (Endpoint URL): https://api.vetrf.ru/platform/services/ApplicationManagementService


WSDL-описание: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.2_production.wsdl
WSDL-описание v1: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl


Адрес ИС Меркурий: https://mercury.vetrf.ru/
Адрес ИС Меркурий: https://mercury.vetrf.ru/


Плановое обновление: август 2016, Ветис.API v1.3
Плановое обновление: ''не запланировано'' <!-- 08 сентября 2016, [[Ветис.API v1.3|Ветис.API v1.3]] -->




<big>'''Пилотный (тестовый) сервер'''</big>
<big>'''Пилотный (тестовый) сервер'''</big>


Версия Ветис.API: v1.3
Версия Ветис.API: v1.4 и v2.0


Версия ИС Меркурий: v4.3.10-GATEWAY
Версия ИС Меркурий: v5.3.8.5-t2


Статус сервера: доступен  
Статус сервера: доступен  


Точка доступа (Endpoint URL): https://api2.vetrf.ru:8002/platform/services/ApplicationManagementService
Точка доступа v1 (Endpoint URL): https://api2.vetrf.ru:8002/platform/services/ApplicationManagementService


WSDL-описание: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.3_pilot.wsdl
WSDL-описание v1: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl


Адрес ИС Меркурий: https://t2-mercury.vetrf.ru/.
Адрес ИС Меркурий: https://t2-mercury.vetrf.ru/.

Версия 00:42, 9 ноября 2017

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

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

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

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

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

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

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

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

Подробное описание предоставляемых бизнес-операций можно найти в статье "Подсистема обработки заявок в Ветис.API" / "Меркурий".

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

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

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

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

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

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

Структура

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

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

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

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

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

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

Подробно форматы запросов на подачу заявки и получение результатов ее обработки описаны в статье Подсистема обработки заявок в Ветис.API.

Сервис обработки заявок для хозяйствующих субъектов

Версия Продуктивный контур Тестовый контур
v1 WSDL:
http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl
Описание типов заявок:
http://api.vetrf.ru/schema/platform/mercury/g2b/applications_v1.4.xsd
WSDL:
http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl
Описание типов заявок:
http://api.vetrf.ru/schema/platform/mercury/g2b/applications_v1.4.xsd
v2 WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl
Описание типов заявок: включено в WSDL
WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ams-mercury-g2b.service_v2.0_pilot.wsdl
Описание типов заявок: включено в WSDL

Сервис обработки заявок для ветеринарных управлений

Версия Продуктивный контур Тестовый контур
v1 WSDL:
http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl
Описание типов заявок:
http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.4.xsd
WSDL:
http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl
Описание типов заявок:
http://api.vetrf.ru/schema/platform/mercury/vu/applications_v1.4.xsd
v2 WSDL: недоступен
Описание типов заявок: включено в WSDL
WSDL: недоступен
Описание типов заявок: включено в WSDL

Предыдущие версии

Документация по версии 1.2 находится здесь.

Полный список актуальных схем находится тут.

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

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

Подробно форматы запросов для обращения к справочникам и реестрам Ветис описаны в статье Подсистема работы со справочниками и реестрами в Ветис.API.

  • Цербер (EnterpriseService) - сервис получения реестра хозяйствующих субъектов и предприятий (PDF):
WSDL (продуктивная версия): http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1.3_production.wsdl
WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/cerberus/services/EnterpriseService_v1.4_pilot.wsdl
  • Икар (IkarService) - сервис получения адресной справочной информации (PDF):
WSDL (продуктивная версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.3_production.wsdl
WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.4_pilot.wsdl
  • DictionaryService - Сервис получения справочной информации (PDF):
WSDL (боевая версия): http://api.vetrf.ru/schema/platform/services/DictionaryService_v1.3_production.wsdl
WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/DictionaryService_v1.4_pilot.wsdl
  • ProductService - Сервис получения реестра категорий продукции (PDF):
WSDL (боевая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.3_production.wsdl
WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.4_pilot.wsdl


Ветис.API 2.0

Продуктивный контур


Зависимости


Тестовый контур

На пилотном сервере с 01.08.2017 доступна версия 2.0 Ветис.API. Приглашаем всех желающих принять участие в тестировании.


Зависимости

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

Процедура предоставления доступа к Ветис:

  1. Доступ к Ветис.API предоставляется в 2 этапа: первый этап – подача заявки на предоставление доступа к тестовой версии (Пример заявки на подключение к тестовой версии Ветис.API) Ветис.API для разработки и отладки, второй этап – подача заявки на предоставление доступа к продуктивной версии Ветис.API.
  2. Доступ к тестовой версии Ветис.API для разработки и отладки клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
  3. Заявка оформляется на бланке организации c подписью руководителя (или уполномоченного им лица) и печатью организации и предоставляется в ФГБУ «ВНИИЗЖ» по электронной почте на адрес api@vetrf.ru.
  4. Заявка должна содержать следующие данные:
    1. Название и реквизиты (Юридический адрес; ИНН; ОГРН) хозяйствующего субъекта или организации, ответственной за формирование запросов к Ветис.API.
    2. Контактное лицо (или контактные лица) по техническим и организационным вопросам (ФИО, место работы, адрес электронной почты, телефон).
    3. Название подключаемой программной системы (платформы), осуществляющей запросы.
    4. Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат). Согласие перечисленных хозяйствующих субъектов на обработку их данных в ВетИС.
  5. Регистрация производится должностными лицами ФГБУ "ВНИИЗЖ" в срок не более 5 рабочих дней после получения заявки.
  6. После регистрации организации или учреждению предоставляются:
    1. Реквизиты доступа к тестовой версии Ветис.API (реквизиты доступа направляются на адрес личной электронной почты контактного лица).
    2. Реквизиты доступа к веб-интерфейсу тестовой версии шлюза подсистемы Меркурий.ХС.
    3. Возможность использовать тестовую версию Ветис.API в соответствии с назначенной ролью и указанной "Зоной обслуживания".
  7. По окончании разработки и тестирования клиентского модуля организация или учреждение самостоятельно определяет свою готовность к переходу к продуктивной версии Ветис.API. Готовность определяется с учетом следующих критериев:
    1. Операции оформления ВСД и другие операции, реализованные из информационной системы организации или учреждения, не нарушают внутренние бизнес-процессы и не приводят к задержке производственных или логистических операций.
    2. Все необходимые для организации или учреждения операции протестированы и апробированы в достаточной мере: оформление ВСД из информационной системы осуществлялось в течение периода не менее 10 рабочих дней в режиме реального производственного процесса.
    3. В период апробации в режиме реального производственного процесса количество запросов с ошибками с кодом MERC не должно превышать 10% от общего количества запросов этого типа в сутки. Ошибки с кодом APL и APLM отсутствуют в период апробации.
  8. Доступ к продуктивной версии предоставляется только после того, как клиент завершил разработку и отладку в тестовой версии шлюза и только в том случае, если сторонняя информационная система и разработанный для ее интеграции с ФГИС Меркурий шлюз соответствуют следующим требованиям:
    1. Сторонняя информационная система должна обеспечивать отсутствие технической возможности внесения изменений в сертификат, оформление которого завершено, если такой сертификат хранится и на удаленных рабочих станциях сторонней информационной системы.
  9. При наличии обоснованной уверенности в готовности использовать продуктивную версию Ветис.API (Пример заявки на подключение к продуктивной версии Ветис.API) организация или учреждение сообщает об этом путем направления заявки на доступ к продуктивной версии Ветис.API, содержащей сведения, указанные в пункте 4.
  10. Регистрация производится должностными лицами ФГБУ "ВНИИЗЖ" в срок не более 5 рабочих дней после получения заявки.
  11. После регистрации организации или учреждению предоставляются:
    1. Реквизиты доступа к продуктивной версии Ветис.API (реквизиты доступа направляются на адрес указанной электронной почты контактного лица).
    2. Возможность использовать продуктивную версию Ветис.API в соответствии с назначенной ролью и указанной "Зоной обслуживания".
    3. Доступ к тестовой версии Ветис.API сохраняется.
    4. Доступ в веб-интерфейс для рабочего сервера необходимо получить по отдельной заявке. Инструкцию и шаблон заявки вы можете посмотреть здесь
  12. Регистрация может быть аннулирована в следующих случаях.
    1. Если общее количество любых ошибок при выполнении бизнес-операций в продуктивной версии Ветис.API превысило 10% от общего количества запросов этого типа за сутки. В этом случае организации или учреждению, ответственному за оформление запросов к шлюзу, выносится предупреждение. Если ошибки не устранены в течение 5 рабочих дней, производится отключение программной системы от продуктивной версии Ветис.API на срок не менее 1 месяца и до устранения ошибок. В этот период учреждению или организации доступна только тестовая версия Ветис.API.
  13. Для восстановления доступа к продуктивной версии Ветис.API необходимо отправить соответствующую заявку.

С чего начать

ECR-Russia и лично координатор данной организации по вопросам, связанным с оформлением электронных ВСД, Юрий Кумпан, подготовил документ, который содержит практические шаги по реализации интеграционного проекта учетной системы предприятия с ФГИС "Меркурий", называется он «Первые шаги в проектах интеграции с ФГИС Меркурий».

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

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

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

Предварительный перечень новых функций, запланированных на второе поколение системы (версии 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.4 и v2.0

Версия ИС Меркурий: v6.1.6

Статус сервера: доступен

Точка доступа v1 (Endpoint URL): https://api.vetrf.ru/platform/services/ApplicationManagementService

WSDL-описание v1: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_production.wsdl

Адрес ИС Меркурий: https://mercury.vetrf.ru/

Плановое обновление: не запланировано


Пилотный (тестовый) сервер

Версия Ветис.API: v1.4 и v2.0

Версия ИС Меркурий: v5.3.8.5-t2

Статус сервера: доступен

Точка доступа v1 (Endpoint URL): https://api2.vetrf.ru:8002/platform/services/ApplicationManagementService

WSDL-описание v1: http://api.vetrf.ru/schema/platform/services/ApplicationManagementService_v1.4_pilot.wsdl

Адрес ИС Меркурий: https://t2-mercury.vetrf.ru/.

Ссылки

См. также

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