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

Материал из Справочная система Россельхознадзора
Перейти к навигации Перейти к поиску
 
(не показаны 82 промежуточные версии 7 участников)
Строка 4: Строка 4:
== Цели создания ==
== Цели создания ==
* Расширение возможностей платформы '''Ветис''' и ее компонентов за счет подключения сторонних информационных систем.
* Расширение возможностей платформы '''Ветис''' и ее компонентов за счет подключения сторонних информационных систем.
* Автоматизация взаимодействия системы [[Автоматизированная система Меркурий|'''Меркурий''']] с учетными системами хозяйствующих субъектов и ветеринарных служб субъектов для решения задач электронной ветеринарной сертификации.
* Автоматизация взаимодействия системы [[Компонент Меркурий|'''Меркурий''']] с учетными системами хозяйствующих субъектов и ветеринарных служб субъектов для решения задач электронной ветеринарной сертификации.


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


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


'''ApplicationManagementService''' предоставляет следующие операции: оформление производственной партии; оформление транспортной партии; оформление входящей партии; оформление результатов инвентаризации; объединение записей складского журнала; получение ВСД по его идентификатору; получение ВСД, созданных или измененных за указанный интервал дат (получение истории изменений); получение всех ВСД предприятия с возможностью фильтрации; получение конкретной версии записи складского журнала по ее идентификатору; получение последней (актуальной) версии записи складского журнала по ее идентификатору; получение всех версий записи складского журнала по ее идентификатору; получение актуального списка записей журнала; получение списка версий записей журнала, созданных или измененных за указанный интервал дат (получение истории изменений); добавление/изменение сведений о хозяйствующем субъекте; добавление/изменение сведений о поднадзорном объекте; аннулирование ВСД; создание/удаление связи с площадкой; добавление номенклатуры производителя в справочник.
'''ApplicationManagementService''' предоставляет следующие операции: оформление производственной партии; оформление транспортной партии; оформление входящей партии; оформление результатов инвентаризации; объединение записей складского журнала; получение ВСД по его идентификатору; получение ВСД, созданных или измененных за указанный интервал дат (получение истории изменений); получение всех ВСД предприятия с возможностью фильтрации; получение конкретной версии записи складского журнала по ее идентификатору; получение последней (актуальной) версии записи складского журнала по ее идентификатору; получение всех версий записи складского журнала по ее идентификатору; получение актуального списка записей журнала; получение списка версий записей журнала, созданных или измененных за указанный интервал дат (получение истории изменений); добавление/изменение сведений о хозяйствующем субъекте; добавление/изменение сведений о поднадзорном объекте; аннулирование ВСД; создание/удаление связи с площадкой; добавление номенклатуры производителя в справочник.
Строка 15: Строка 15:
Подробное описание предоставляемых бизнес-операций можно найти в статье [[Подсистема обработки заявок в Ветис.API#Меркурий|"Подсистема обработки заявок в Ветис.API" / "Меркурий"]].
Подробное описание предоставляемых бизнес-операций можно найти в статье [[Подсистема обработки заявок в Ветис.API#Меркурий|"Подсистема обработки заявок в Ветис.API" / "Меркурий"]].


=== Взаимодействие с системой [[Автоматизированная система Цербер|Цербер]] ===
=== Взаимодействие с компонентом [[Компонент Хорриот|Хорриот]] ===
'''Ветис.API''' позволяет сторонним информационным системам передавать информацию, необходимую для регистрации животных в компоненте '''Хорриот''', получать информацию о зарегистрированных животных и выполнять другие операции, предусмотренные в компоненте '''Хорриот'''.
 
Подробное описание предоставляемых в рамках сервиса '''ApplicationManagementService''' бизнес-операций кмомпонента '''Хорриот''' можно найти в статье [[Подсистема обработки заявок в Ветис.API#Хорриот|"Подсистема обработки заявок в Ветис.API" / "Хорриот"]].
 
 
Спецификация форматов взаимодействия: [[Herriot:Services:v1.0|'''herriot.service:1.0''']]
 
=== Взаимодействие с компонентом [[Компонент Цербер|Цербер]] ===
'''EnterpriseService''' позволяет обмениваться информацией с реестром хозяйствующих субъектов и поднадзорных объектов.
'''EnterpriseService''' позволяет обмениваться информацией с реестром хозяйствующих субъектов и поднадзорных объектов.


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


=== Взаимодействие с системой [[Автоматизированная система Икар|Икар]] ===
=== Взаимодействие с компонентом [[Компонент Икар|Икар]] ===
'''IkarService''' позволяет получать информацию из единого хранилища адресных данных, которые используются в информационных системах Россельхознадзора.  
'''IkarService''' позволяет получать информацию из единого хранилища адресных данных, которые используются в информационных системах Россельхознадзора.  


Строка 27: Строка 35:
== Структура ==
== Структура ==


Шлюз состоит из двух подсистем: [[#Подсистема обработки заявок|подсистемы обработки заявок]] и [[#Подсистема работы со справочниками и реестрами|подсистемы работы со справочниками и реестрами]].
'''Шлюз состоит из двух подсистем:'''
*[[#Подсистема обработки заявок|'''Подсистема обработки заявок''']]  
*[[#Подсистема работы со справочниками и реестрами|'''Подсистема работы со справочниками и реестрами''']].


[[Файл:gatewayStructure.png|center|frame|Рис. 1. Структура Ветис.API]]
[[Файл:gatewayStructure.png|center|frame|Рис. 1. Структура Ветис.API]]
Строка 34: Строка 44:
=== Базовые компоненты ===
=== Базовые компоненты ===


* Документ представляет собой набор базовых типов и элементов, на основе которых строятся веб-сервисы автоматизированных систем  Россельхознадзора. Кроме этого, в документе описаны единые правила версионности для объектов, передаваемых через веб-сервис. ([[Media:Platform_base_requirements_1.1_v2.pdf|PDF]])
* Документ представляет собой набор базовых типов и элементов, на основе которых строятся веб-сервисы компоненты ФГИС «ВетИС». Кроме этого, в документе описаны единые правила версионности для объектов, передаваемых через веб-сервис. ([[Media:Platform_base_requirements_1.1_v2.pdf|PDF]])
-->
-->
=== Подсистема обработки заявок ===
=== Подсистема обработки заявок ===


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


'''1 шаг''' – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно);  
'''1 шаг''' – подача заявки на выполнение бизнес-операции, получение результата приема заявки (выполняется синхронно);  
Строка 51: Строка 61:
! Версия !! Продуктивный контур !! Тестовый контур
! Версия !! Продуктивный контур !! Тестовый контур
|-
|-
| '''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.0'''  
|| '''WSDL:''' http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl <br/>'''Описание типов заявок:''' ''включено в WSDL'' <br/>'''ServiceId:''' mercury-g2b.service:2.0 <br/>'''URL точки доступа:''' https://api.vetrf.ru/platform/services/2.0/ApplicationManagementService
|| '''WSDL:''' http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ams-mercury-g2b.service_v2.0_pilot.wsdl <br/>'''Описание типов заявок:''' ''включено в WSDL'' <br/>'''ServiceId:''' mercury-g2b.service:2.0 <br/>'''URL точки доступа:''' https://api2.vetrf.ru:8002/platform/services/2.0/ApplicationManagementService
|-
|-
| '''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''
| '''v2.1'''  
|| '''WSDL:''' http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ams-mercury-g2b.service_v2.1_production.wsdl <br/>'''Описание типов заявок:''' ''включено в WSDL'' <br/>'''ServiceId:''' mercury-g2b.service:2.1 <br/>'''URL точки доступа:''' https://api.vetrf.ru/platform/services/2.1/ApplicationManagementService
|| '''WSDL:''' http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ams-mercury-g2b.service_v2.1_pilot.wsdl <br/>'''Описание типов заявок:''' ''включено в WSDL'' <br/>'''ServiceId:''' mercury-g2b.service:2.1 <br/>'''URL точки доступа:''' https://api2.vetrf.ru:8002/platform/services/2.1/ApplicationManagementService
|}
|}
* Версия сервиса определяется в первую очередь по '''serviceId'''.


==== Сервис обработки заявок для ветеринарных управлений ====
==== Сервис обработки заявок для ветеринарных управлений ====
Строка 61: Строка 77:
! Версия !! Продуктивный контур !! Тестовый контур
! Версия !! Продуктивный контур !! Тестовый контур
|-
|-
| '''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.0''' || WSDL: <br/> http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_production.wsdl <br/>Описание типов заявок: ''включено в WSDL'' || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_pilot.wsdl <br/>Описание типов заявок: ''включено в WSDL''
|-
|-
| '''v2''' || WSDL: ''недоступен'' <br/>Описание типов заявок: ''включено в WSDL'' || WSDL:<br/> http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_pilot.wsdl <br/>Описание типов заявок: ''включено в WSDL''
| '''v2.1''' || WSDL: <br/> ''недоступно'' || WSDL:<br/> ''недоступно''
|}
|}
 
<!--==== Предыдущие версии ====
==== Предыдущие версии ====
 
Документация по версии 1.2 находится [[Подсистема обработки заявок в Ветис.API v1.2|здесь]].
Документация по версии 1.2 находится [[Подсистема обработки заявок в Ветис.API v1.2|здесь]].
Полный список актуальных схем находится [[NameSpaces|'''тут''']].-->


Полный список актуальных схем находится [[NameSpaces|'''тут''']].
==== Сервис интеграции с государственной информационной системой "Маркировка товаров" (ГИС МТ) ====
{| class="wikitable"
|-
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v1.0'''
|| '''WSDL:''' ''недоступно'' <br/>'''Описание типов заявок:''' ''недоступно'' <br/>'''ServiceId:''' ''недоступно'' <br/>'''URL точки доступа:''' ''недоступно''
|| '''WSDL:''' https://api.vetrf.ru/schema/platform/crptgw/v1.0.0-crpt-latest/ams-crpt-gateway.service_v1.0_pilot.wsdl <br/>'''Описание типов заявок:''' ''включено в WSDL'' <br/>'''ServiceId:''' crpt-gateway.service <br/>'''URL точки доступа:''' https://api2.vetrf.ru:8002/platform/services/2.0/ApplicationManagementService
|-
|}


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


* '''Цербер (EnterpriseService)''' - сервис получения реестра хозяйствующих субъектов и предприятий ([[Media:Enterprise service requirements 1.1 v2.pdf|PDF]]):
* '''Цербер (EnterpriseService)''' - сервис получения реестра хозяйствующих субъектов и предприятий ([[Media:Enterprise service requirements 1.1 v2.pdf|PDF]]):
 
{| class="wikitable"
: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
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v2.0'''
|| '''WSDL:''' <br/> http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.0/EnterpriseService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.0/EnterpriseService 
|-
| '''v2.1'''
|| '''WSDL:''' <br/> http://api.vetrf.ru/schema/platform/services/2.1-RC-last/EnterpriseService_v2.1_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.1/EnterpriseService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/EnterpriseService_v2.1_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.1/EnterpriseService
|}


* '''Икар (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.3_production.wsdl  
{| class="wikitable"
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/ikar/services/IkarService_v1.4_pilot.wsdl
|-
 
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v2.0'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/IkarService_v2.0_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.0/IkarService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/IkarService_v2.0_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.0/IkarService
|-
| '''v2.1'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/IkarService_v2.1_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.1/IkarService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/IkarService_v2.1_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.1/IkarService
|}
* '''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.3_production.wsdl  
{| class="wikitable"
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/DictionaryService_v1.4_pilot.wsdl
|-
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v2.0'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.0/DictionaryService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.0/DictionaryService 
|-
| '''v2.1'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/DictionaryService_v2.1_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.1/DictionaryService
|| '''WSDL:''' <br/>  http:// http://api.vetrf.ru/schema/platform/services/2.1-RC-last/DictionaryService_v2.1_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.1/DictionaryService
|}


* '''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.3_production.wsdl  
{| class="wikitable"
:WSDL (тестовая версия): http://api.vetrf.ru/schema/platform/services/ProductService_v1.4_pilot.wsdl
|-
<!-- [[Файл:Example.jpg]] -->
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v2.0'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.0/ProductService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.0/ProductService
|-
| '''v2.1'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ProductService_v2.1_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.1/ProductService
|| '''WSDL:''' <br/>  http:// http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ProductService_v2.1_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.1/ProductService
|}
 
* '''RegionalizationService''' - Сервис проверки благополучия регионов и получения правил регионализации:
{| class="wikitable"
|-
! Версия !! Продуктивный контур !! Тестовый контур
|-
| '''v2.0'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.0/RegionalizationService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.0/RegionalizationService
|-
| '''v2.1'''
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/RegionalizationService_v2.1_production.wsdl <br/>'''URL точки доступа:''' <br/>https://api.vetrf.ru/platform/services/2.1/RegionalizationService
|| '''WSDL:''' <br/>  http://api.vetrf.ru/schema/platform/services/2.1-RC-last/RegionalizationService_v2.1_pilot.wsdl <br/>'''URL точки доступа:''' <br/>https://api2.vetrf.ru:8002/platform/services/2.1/RegionalizationService
|}


=== Ветис.API 2.1 ===
==== Продуктивный контур ====
* Сервис обработки заявок к сервису mercury-g2b.service:2.1: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ams-mercury-g2b.service_v2.1_production.wsdl
* Сервис получения сведений из базовых справочников: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/DictionaryService_v2.1_production.wsdl
* Сервис получения сведений из реестра хоз.субъектов и предприятий: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/EnterpriseService_v2.1_production.wsdl
* Сервис получения адресно-справочной информации: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/IkarService_v2.1_production.wsdl
* Сервис получения сведений из справочников продукции и номенклатуры: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ProductService_v2.1_production.wsdl
* Сервис получения сведений из реестра правил регионализации: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/RegionalizationService_v2.1_production.wsdl
Зависимости
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/application_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/application_ws_definitions_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ApplicationManagementService_v2.0.wsdl
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/base_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/base_ws_definitions_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/dictionary_v2.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/document_v2.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/mercury-g2b.service_v2.1.wsdl
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/mercury_g2b_applications_v2.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/registry_ws_definitions_v2.1.xsd
==== Тестовый контур ====
* Сервис обработки заявок к сервису mercury-g2b.service:2.1: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ams-mercury-g2b.service_v2.1_pilot.wsdl
* Сервис получения сведений из базовых справочников: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/DictionaryService_v2.1_pilot.wsdl
* Сервис получения сведений из реестра хоз.субъектов и предприятий: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/EnterpriseService_v2.1_pilot.wsdl
* Сервис получения адресно-справочной информации: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/IkarService_v2.1_pilot.wsdl
* Сервис получения сведений из справочников продукции и номенклатуры: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ProductService_v2.1_pilot.wsdl
* Сервис получения сведений из реестра правил регионализации: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/RegionalizationService_v2.1_pilot.wsdl
Зависимости
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ApplicationManagementService_v2.0.wsdl
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/application_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/application_ws_definitions_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/base_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/base_ws_definitions_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/dictionary_v2.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/document_v2.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/mercury_g2b_applications_v2.1.xsd
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/mercury-g2b.service_v2.1.wsdl
* http://api.vetrf.ru/schema/platform/services/2.1-RC-last/registry_ws_definitions_v2.1.xsd


=== Ветис.API 2.0 ===
=== Ветис.API 2.0 ===


==== Продуктивный контур ====
==== Продуктивный контур ====
* Сервис обработки заявок к сервису mercury-g2b.service: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl
* Сервис обработки заявок к сервису mercury-g2b.service:2.0: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl
* Сервис обработки заявок к сервису mercury-vu.service:2.0: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.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/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/EnterpriseService_v2.0_production.wsdl
Строка 106: Строка 222:
* Сервис получения сведений из справочников продукции и номенклатуры: 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/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/RegionalizationService_v2.0_production.wsdl


Зависимости
Зависимости
Строка 121: Строка 236:
* 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/mercury_vu_applications_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/registry_ws_definitions_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:2.0: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_pilot.wsdl
 
* Сервис обработки заявок к сервису mercury-vu.service:2.0: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_pilot.wsdl
* Сервис обработки заявок к сервису mercury-g2b.service: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_pilot.wsdl
* Сервис обработки заявок к сервису mercury-vu.service: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-vu.service_v2.0_pilot.wsdl
* Сервис получения сведений из базовых справочников: http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_pilot.wsdl
* Сервис получения сведений из базовых справочников: http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_pilot.wsdl
* Сервис получения сведений из реестра хоз.субъектов и предприятий: http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_pilot.wsdl
* Сервис получения сведений из реестра хоз.субъектов и предприятий: http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_pilot.wsdl
Строка 133: Строка 245:
* Сервис получения сведений из справочников продукции и номенклатуры: http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_pilot.wsdl
* Сервис получения сведений из справочников продукции и номенклатуры: http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_pilot.wsdl
* Сервис получения сведений из реестра правил регионализации: http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_pilot.wsdl
* Сервис получения сведений из реестра правил регионализации: http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_pilot.wsdl


Зависимости
Зависимости
Строка 148: Строка 259:
* 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/mercury_vu_applications_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/registry_ws_definitions_v2.0.xsd
* http://api.vetrf.ru/schema/platform/services/2.0-last/registry_ws_definitions_v2.0.xsd
=== Изменения в XSD-схемах для версии 2.1 по сравнению с версией 2.0 ===
* В перечислимый тип DocumentType добавлены новые типы документов.
* Добавлен элемент registryStatus в тип Enterprise.
* Добавлен тип EnterpriseStatus.
* Добавлены поля фильтрации для операции getVetDocumentList: issueDateInterval, consignor, referencedDocument.
* Добавлено поле фильтрации для операции getStockEntryList: searchPattern/receiptDateInterval.
* Добавлены поля фильтрации для операции getVetDocumentChangesList: vetDocumentType, vetDocumentStatus.
* Добавлены поля фильтрации для метода getProductItemList сервиса ProductService: producer, globalID.
* Добавлены методы getLocalityChangesListRequest, getStreetChangesListRequest сервиса IkarService.
* Добавлен элемент batch/applicableClassifications - дополнительные характеристики партии, включающее в себя элемент nonFoodSource - вид проиcхождения для непищевой продукции, технического сырья, кормов и кормовых добавок.
* Добавлены новые типы транспорта (речной и перегон).


== Предоставление доступа ==
== Предоставление доступа ==
Процедура предоставления доступа к Ветис:
 
#Доступ к Ветис.API предоставляется в 2 этапа: первый этап – подача заявки на предоставление доступа к тестовой версии ([[Медиа:Пример_заявки_на_Ветис_t2.API.pdf‎|Пример заявки на подключение к тестовой версии Ветис.API]]) Ветис.API для разработки и отладки, второй этап – подача заявки на предоставление доступа к продуктивной версии Ветис.API.
{{ambox
#Доступ к тестовой версии Ветис.API для разработки и отладки клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
|type      = notice
#Заявка оформляется на бланке организации c подписью руководителя (или уполномоченного им лица) и печатью организации и предоставляется в ФГБУ «ВНИИЗЖ» по электронной почте на адрес [mailto:api@vetrf.ru api@vetrf.ru].
|text      = '''Примечание.'''
#Заявка должна содержать следующие данные:
|text-small = О рассмотрении обращений в службе технической поддержки по вопросам электронной сертификации - http://vetrf.ru/vetrf/news/26826.html
##Название и реквизиты (Юридический адрес; ИНН; ОГРН) хозяйствующего субъекта или организации, ответственной за формирование запросов к Ветис.API.
}}
##Контактное лицо (или контактные лица) по техническим и организационным вопросам (ФИО, место работы, адрес электронной почты, телефон).
 
##Название подключаемой программной системы (платформы), осуществляющей запросы.
Доступ к ВетИС.API предоставляется '''в два этапа''':
##Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат). Согласие перечисленных хозяйствующих субъектов на обработку их данных в ВетИС.  
:'''Первый этап''' — предоставление доступа к тестовой версии ВетИС.API для разработки и отладки;
#Регистрация производится должностными лицами ФГБУ "ВНИИЗЖ" в срок не более 5 рабочих дней после получения заявки.
:'''Второй этап''' — предоставление доступа к продуктивной версии ВетИС.API.
#После регистрации организации или учреждению предоставляются:
 
##Реквизиты доступа к тестовой версии Ветис.API (реквизиты доступа направляются на адрес личной электронной почты контактного лица).
Процедура предоставления доступа к ВетИС следующая:
##Реквизиты доступа к веб-интерфейсу тестовой версии шлюза подсистемы Меркурий.ХС.
 
##Возможность использовать тестовую версию Ветис.API в соответствии с назначенной ролью и указанной "Зоной обслуживания".
:'''1.''' '''Доступ к тестовой версии ВетИС.API для разработки и отладки клиентских модулей''' предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
#По окончании разработки и тестирования клиентского модуля организация или учреждение самостоятельно определяет свою готовность к переходу к продуктивной версии Ветис.API. Готовность определяется с учетом следующих критериев:  
:1.1. Заявка к тестовой версии подается через публичную электронную форму, доступную по адресу: https://t2-aplms.vetrf.ru/pub/.  
##Операции оформления ВСД и другие операции, реализованные из информационной системы организации или учреждения, не нарушают внутренние бизнес-процессы и не приводят к задержке производственных или логистических операций.
:: Сведения, которые потребуются для оформления электронной заявки:
##Все необходимые для организации или учреждения операции протестированы и апробированы в достаточной мере: оформление ВСД из информационной системы осуществлялось в течение периода не менее 10 рабочих дней в режиме реального производственного процесса.
::* ИНН хозяйствующего субъекта, ответственного за формирование запросов к ВетИС.API (как правило, это собственник продукции, осуществляющий ветеринарную сертификацию).
##В период апробации в режиме реального производственного процесса количество запросов с ошибками с кодом MERC не должно превышать 10% от общего количества запросов этого типа в сутки. Ошибки с кодом APL и APLM отсутствуют в период апробации.
::* Контакты лиц, ответственных за технические и организационные вопросы (ФИО, место работы, адрес электронной почты, телефон).
#Доступ к продуктивной версии предоставляется только после того, как клиент завершил разработку и отладку в тестовой версии шлюза и только в том случае, если сторонняя информационная система и разработанный для ее интеграции с ФГИС Меркурий шлюз соответствуют следующим требованиям:
::* Название и вендор подключаемого клиентского интеграционного компонента, осуществляющей запросы к ВетИС.API.
##Сторонняя информационная система должна обеспечивать отсутствие технической возможности внесения изменений в сертификат, оформление которого завершено, если такой сертификат хранится и на удаленных рабочих станциях сторонней информационной системы.
<!--##Список хозяйствующих субъектов, обслуживаемых программной системой (название организации, юридический адрес, ИНН, ОГРН). Заполняются в случае, если через информационную систему работает не одно предприятие, а несколько (например, через систему холдинга могут быть подключены молокозавод и мясоперерабатывающий комбинат). Согласие перечисленных хозяйствующих субъектов на обработку их данных в ВетИС. -->
#При наличии обоснованной уверенности в готовности использовать продуктивную версию Ветис.API ([[Медиа:Ветис.API_production.pdf‎|Пример заявки на подключение к продуктивной версии Ветис.API]]) организация или учреждение сообщает об этом путем направления заявки на доступ к продуктивной версии Ветис.API, содержащей сведения, указанные в пункте 4.
:1.2. К электронной заявке необходимо прикрепить скан заявления, оформленного на бланке организации за подписью руководителя (или уполномоченного им лица) и печатью организации по [[Медиа:Пример заявки Ветис.API test 2022.docx.pdf‎|шаблону]].
#Регистрация производится должностными лицами ФГБУ "ВНИИЗЖ" в срок не более 5 рабочих дней после получения заявки.
:1.3. Регистрация производится должностными лицами ФГБУ «ВНИИЗЖ» в срок не более 5 рабочих дней после получения заявления.
#После регистрации организации или учреждению предоставляются:
:1.4. После регистрации организации или учреждению предоставляются:
##Реквизиты доступа к продуктивной версии Ветис.API (реквизиты доступа направляются на адрес указанной электронной почты контактного лица).
::* Реквизиты доступа к тестовой версии ВетИС.API (реквизиты доступа направляются на адрес электронной почты контактного лица).
##Возможность использовать продуктивную версию Ветис.API в соответствии с назначенной ролью и указанной "Зоной обслуживания".
::* Реквизиты доступа к веб-интерфейсу тестовой версии компонента [https://t2-mercury.vetrf.ru/hs Меркурий.ХС] и [https://t2-accounts.vetrf.ru ВетИС.Паспорт].
##Доступ к тестовой версии Ветис.API сохраняется.
:1.5. По окончании разработки и тестирования клиентского модуля организация или учреждение самостоятельно определяет свою готовность к переходу к продуктивной версии ВетИС.API. Готовность определяется с учетом следующих критериев:  
##Доступ в веб-интерфейс для рабочего сервера необходимо получить по отдельной заявке. Инструкцию и шаблон заявки вы можете посмотреть [[Администрирование_списка_пользователей_хозяйствующего_субъекта_в_Ветис.Паспорт|здесь]]
::* Операции оформления ВСД и другие операции, реализованные из информационной системы организации или учреждения, не нарушают внутренние бизнес-процессы и не приводят к задержке производственных или логистических операций.
#Регистрация может быть аннулирована в следующих случаях.
::* Все необходимые для организации или учреждения операции протестированы и апробированы в достаточной мере: оформление ВСД из информационной системы осуществлялось в течение периода не менее 10 рабочих дней в режиме реального производственного процесса.
##Если общее количество любых ошибок при выполнении бизнес-операций в продуктивной версии Ветис.API превысило 10% от общего количества запросов этого типа за сутки. В этом случае организации или учреждению, ответственному за оформление запросов к шлюзу, выносится предупреждение. Если ошибки не устранены в течение 5 рабочих дней, производится отключение программной системы от продуктивной версии Ветис.API на срок не менее 1 месяца и до устранения ошибок. В этот период учреждению или организации доступна только тестовая версия Ветис.API.
::* В период апробации в режиме реального производственного процесса количество запросов с ошибками с кодом MERC не должно превышать 10% от общего количества запросов этого типа в сутки. Ошибки с кодом APL и APLM отсутствуют в период апробации.
#Для восстановления доступа к продуктивной версии Ветис.API необходимо отправить соответствующую заявку.
 
{{ambox
|type      = warning
|text      = '''Обратите внимание!'''
|text-small = '''Доступ к продуктивной версии ВетИС.API''' предоставляется только после того, как '''клиент завершил''' разработку и отладку в тестовой версии шлюза, и только в том случае, если сторонняя информационная система и разработанный для ее интеграции с компонентом «Меркурий» шлюз '''соответствуют требованиям''':
* Сторонняя информационная система должна обеспечивать отсутствие технической возможности внесения изменений в сертификат, оформление которого завершено, если такой сертификат хранится и на удаленных рабочих станциях сторонней информационной системы.
}}
 
:'''2.''' '''Доступ к продуктивной версии ВетИС.API для осуществления электронной ветеринарной сертификации''' предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии при наличии обоснованной уверенности хозяйствующего субъекта в готовности использовать продуктивную версию ВетИС.API, подтверждая это при подаче заявления.
:2.1. Заявка подается через публичную электронную форму, доступную по адресу: https://aplms.vetrf.ru/pub/.
:2.2. К электронной заявке необходимо прикрепить скан заявления, оформленного на бланке организации за подписью руководителя (или уполномоченного им лица) и печатью организации по [[Медиа:Пример заявки Ветис.API production 2022.pdf‎|шаблону]]. Также вы можете подать заявку на получение доступа с помощью электронной подписи по [[Подача_заявки_на_получение_доступа_к_ВетИС.API_с_ЭП|инструкции]].
:2.3. Регистрация производится должностными лицами ФГБУ «ВНИИЗЖ» в срок не более 5 рабочих дней после получения заявки.
:2.4. После регистрации организации или учреждению предоставляются:
::* Реквизиты доступа к продуктивной версии ВетИС.API (реквизиты доступа направляются на адрес указанной электронной почты контактного лица).
::* Возможность использовать продуктивную версию ВетИС.API в соответствии с назначенной ролью и указанной зоной обслуживания.
::* Доступ к тестовой версии ВетИС.API сохраняется.
::* Доступ к веб-интерфейсу ВетИС для рабочего сервера необходимо получить по отдельной заявке. Инструкция и шаблон заявки доступны [[Администрирование_списка_пользователей_хозяйствующего_субъекта_в_Ветис.Паспорт|по ссылке]].
:2.5. Регистрация может быть аннулирована в следующих случаях:
::* Если общее количество любых ошибок при выполнении бизнес-операций в продуктивной версии ВетИС.API превысило 10% от общего количества запросов этого типа за сутки. В этом случае организации или учреждению, ответственному за оформление запросов к шлюзу, выносится предупреждение. Если ошибки не устранены в течение 5 рабочих дней, производится отключение программной системы от продуктивной версии ВетИС.API на срок не менее 1 месяца и до устранения ошибок. В этот период учреждению или организации доступна только тестовая версия ВетИС.API.
:2.6. Для восстановления доступа к продуктивной версии ВетИС.API необходимо отправить соответствующую заявку.


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


== Обновление системы ==
== Обновление компонента ==


Перечень обновлений системы:
Перечень обновлений компонента:
* [[Обновление системы Ветис.API за 2018 год |2018 год]]
[[Обновление компонента Ветис.API за 2023 год |2023 год]] | [[Обновление компонента Ветис.API за 2022 год |2022 год]] | [[Обновление компонента Ветис.API за 2021 год |2021 год]] | [[Обновление компонента Ветис.API за 2020 год |2020 год]] | [[Обновление компонента Ветис.API за 2019 год |2019 год]] | [[Обновление компонента Ветис.API за 2018 год |2018 год]] | [[Обновление компонента Ветис.API за 2016 год |2016 год]] | [[Обновление компонента Ветис.API за 2015 год |2015 год]] | [[Обновление компонента Ветис.API за 2014 год|2014 год]]
* [[Обновление системы Ветис.API за 2016 год |2016 год]]
* [[Обновление системы Ветис.API за 2015 год |2015 год]]
* [[Обновление системы Ветис.API за 2014 год|2014 год]]


=== Планируемые функции ===
=== Планируемые функции ===
[[ВетИС.API Backlog v2.x|Предварительный перечень функций, запланированных на второе поколение системы (версии 2.x шлюза)]]
[[ВетИС.API Backlog v3.x|Предварительный перечень функций, запланированных на второе поколение компонента (версии 3.x шлюза)]]


С предложениями по развитию '''Ветис.API''' обращайтесь по электронной почте на адрес [mailto:api@vetrf.ru api@vetrf.ru] или на специализированный [http://vetrf.ru/vetrf-forum/posts/list/6855.page форум системы].
С предложениями по развитию '''Ветис.API''' обращайтесь по электронной почте на адрес [mailto:api@vetrf.ru api@vetrf.ru] или на специализированный [http://vetrf.ru/vetrf-forum/posts/list/6855.page форум системы].
=== Предварительный список изменений для версии 6.7 и версии 2.1 интеграционного шлюза  ===
С выходом обновления 6.7 появятся значительные изменения, связанные с контролем маркировки продукции и сведениями о происхождении продукции. С предварительным списком и описанием изменений можно ознакомиться [[Release_67|здесь]].


== Сопровождение и поддержка ==
== Сопровождение и поддержка ==
По техническим вопросам, связанным с использованием '''Ветис.API''', обращайтесь по электронной почте на адрес [mailto:api@vetrf.ru api@vetrf.ru] или на специализированный [http://vetrf.ru/vetrf-forum/posts/list/6855.page форум системы].
По техническим вопросам, связанным с использованием '''Ветис.API''', обращайтесь по электронной почте на адрес [mailto:api@vetrf.ru api@vetrf.ru].  


При наличии технической проблемы опишите в письме ее суть, приложите примеры SOAP-запросов и ответов. Свои предложения и пожелания по разработке Ветис.API вы можете также направлять по данному адресу.
При наличии технической проблемы опишите в письме ее суть, приложите примеры SOAP-запросов и ответов. Свои предложения и пожелания по разработке Ветис.API вы можете также направлять по данному адресу.
 
<!--== Мониторинг доступности ==
== Мониторинг доступности ==
 
 


<big>'''Основной сервер'''</big>
<big>'''Основной сервер'''</big>
Строка 223: Строка 362:


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


Строка 238: Строка 376:


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


== Ссылки ==
== Ссылки ==
* [http://vetrf.ru/vetrf-forum/posts/list/6855.page Форум: Взаимодействие с учетными системами хозяйствующих субъектов]
* [http://vetrf.ru/vetrf-forum/posts/list/6855.page Форум: Взаимодействие с учетными системами хозяйствующих субъектов]
<!--* [http://help.vetrf.ru/index.php?title=%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F:RecentChangesLinked&days=30&limit=100&hideminor=1&target=%D0%9A%D0%B0%D1%82%D0%B5%D0%B3%D0%BE%D1%80%D0%B8%D1%8F%3A%D0%92%D0%B5%D1%82%D0%B8%D1%81.API История изменений документации по компоненту Ветис.API] -->


== См. также ==
== См. также ==
* [[Автоматизированная система Меркурий]]
* [[Компонент Меркурий]]
* Н.А. Власов: [http://www.fsvps.ru/fsvps/news/11786.html О запуске в пробную эксплуатацию «Универсального шлюза» ГИС Меркурий]
* Н. А. Власов: [http://www.fsvps.ru/fsvps/news/11786.html О запуске в пробную эксплуатацию «Универсального шлюза» ГИС Меркурий]


[[#top|Вернуться к началу &uarr;]]
[[#top|Вернуться к началу &uarr;]]
[[Category:Ветис.API]]
[[Category:Ветис.API]]

Текущая версия на 08:23, 19 января 2024

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

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

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

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

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

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

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

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

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

Взаимодействие с компонентом Хорриот

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

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


Спецификация форматов взаимодействия: herriot.service:1.0

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

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

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

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

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

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

Структура

Шлюз состоит из двух подсистем:

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

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

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

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

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

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

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

Версия Продуктивный контур Тестовый контур
v2.0 WSDL: http://api.vetrf.ru/schema/platform/services/2.0-last/ams-mercury-g2b.service_v2.0_production.wsdl
Описание типов заявок: включено в WSDL
ServiceId: mercury-g2b.service:2.0
URL точки доступа: https://api.vetrf.ru/platform/services/2.0/ApplicationManagementService
WSDL: http://api.vetrf.ru/schema/platform/services/2.0-RC-last/ams-mercury-g2b.service_v2.0_pilot.wsdl
Описание типов заявок: включено в WSDL
ServiceId: mercury-g2b.service:2.0
URL точки доступа: https://api2.vetrf.ru:8002/platform/services/2.0/ApplicationManagementService
v2.1 WSDL: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ams-mercury-g2b.service_v2.1_production.wsdl
Описание типов заявок: включено в WSDL
ServiceId: mercury-g2b.service:2.1
URL точки доступа: https://api.vetrf.ru/platform/services/2.1/ApplicationManagementService
WSDL: http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ams-mercury-g2b.service_v2.1_pilot.wsdl
Описание типов заявок: включено в WSDL
ServiceId: mercury-g2b.service:2.1
URL точки доступа: https://api2.vetrf.ru:8002/platform/services/2.1/ApplicationManagementService
  • Версия сервиса определяется в первую очередь по serviceId.

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

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

Сервис интеграции с государственной информационной системой "Маркировка товаров" (ГИС МТ)

Версия Продуктивный контур Тестовый контур
v1.0 WSDL: недоступно
Описание типов заявок: недоступно
ServiceId: недоступно
URL точки доступа: недоступно
WSDL: https://api.vetrf.ru/schema/platform/crptgw/v1.0.0-crpt-latest/ams-crpt-gateway.service_v1.0_pilot.wsdl
Описание типов заявок: включено в WSDL
ServiceId: crpt-gateway.service
URL точки доступа: https://api2.vetrf.ru:8002/platform/services/2.0/ApplicationManagementService

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

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

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

  • Цербер (EnterpriseService) - сервис получения реестра хозяйствующих субъектов и предприятий (PDF):
Версия Продуктивный контур Тестовый контур
v2.0 WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.0/EnterpriseService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/EnterpriseService_v2.0_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.0/EnterpriseService
v2.1 WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/EnterpriseService_v2.1_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.1/EnterpriseService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/EnterpriseService_v2.1_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.1/EnterpriseService
  • Икар (IkarService) - сервис получения адресной справочной информации (PDF):
Версия Продуктивный контур Тестовый контур
v2.0 WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/IkarService_v2.0_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.0/IkarService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/IkarService_v2.0_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.0/IkarService
v2.1 WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/IkarService_v2.1_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.1/IkarService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/IkarService_v2.1_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.1/IkarService
  • DictionaryService - Сервис получения справочной информации (PDF):
Версия Продуктивный контур Тестовый контур
v2.0 WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.0/DictionaryService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/DictionaryService_v2.0_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.0/DictionaryService
v2.1 WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/DictionaryService_v2.1_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.1/DictionaryService
WSDL:
http:// http://api.vetrf.ru/schema/platform/services/2.1-RC-last/DictionaryService_v2.1_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.1/DictionaryService
  • ProductService - Сервис получения реестра категорий продукции (PDF):
Версия Продуктивный контур Тестовый контур
v2.0 WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.0/ProductService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/ProductService_v2.0_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.0/ProductService
v2.1 WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ProductService_v2.1_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.1/ProductService
WSDL:
http:// http://api.vetrf.ru/schema/platform/services/2.1-RC-last/ProductService_v2.1_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.1/ProductService
  • RegionalizationService - Сервис проверки благополучия регионов и получения правил регионализации:
Версия Продуктивный контур Тестовый контур
v2.0 WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.0/RegionalizationService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.0-last/RegionalizationService_v2.0_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.0/RegionalizationService
v2.1 WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/RegionalizationService_v2.1_production.wsdl
URL точки доступа:
https://api.vetrf.ru/platform/services/2.1/RegionalizationService
WSDL:
http://api.vetrf.ru/schema/platform/services/2.1-RC-last/RegionalizationService_v2.1_pilot.wsdl
URL точки доступа:
https://api2.vetrf.ru:8002/platform/services/2.1/RegionalizationService

Ветис.API 2.1

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

Зависимости

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

Зависимости

Ветис.API 2.0

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

Зависимости

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

Зависимости

Изменения в XSD-схемах для версии 2.1 по сравнению с версией 2.0

  • В перечислимый тип DocumentType добавлены новые типы документов.
  • Добавлен элемент registryStatus в тип Enterprise.
  • Добавлен тип EnterpriseStatus.
  • Добавлены поля фильтрации для операции getVetDocumentList: issueDateInterval, consignor, referencedDocument.
  • Добавлено поле фильтрации для операции getStockEntryList: searchPattern/receiptDateInterval.
  • Добавлены поля фильтрации для операции getVetDocumentChangesList: vetDocumentType, vetDocumentStatus.
  • Добавлены поля фильтрации для метода getProductItemList сервиса ProductService: producer, globalID.
  • Добавлены методы getLocalityChangesListRequest, getStreetChangesListRequest сервиса IkarService.
  • Добавлен элемент batch/applicableClassifications - дополнительные характеристики партии, включающее в себя элемент nonFoodSource - вид проиcхождения для непищевой продукции, технического сырья, кормов и кормовых добавок.
  • Добавлены новые типы транспорта (речной и перегон).

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


Доступ к ВетИС.API предоставляется в два этапа:

Первый этап — предоставление доступа к тестовой версии ВетИС.API для разработки и отладки;
Второй этап — предоставление доступа к продуктивной версии ВетИС.API.

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

1. Доступ к тестовой версии ВетИС.API для разработки и отладки клиентских модулей предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии.
1.1. Заявка к тестовой версии подается через публичную электронную форму, доступную по адресу: https://t2-aplms.vetrf.ru/pub/.
Сведения, которые потребуются для оформления электронной заявки:
  • ИНН хозяйствующего субъекта, ответственного за формирование запросов к ВетИС.API (как правило, это собственник продукции, осуществляющий ветеринарную сертификацию).
  • Контакты лиц, ответственных за технические и организационные вопросы (ФИО, место работы, адрес электронной почты, телефон).
  • Название и вендор подключаемого клиентского интеграционного компонента, осуществляющей запросы к ВетИС.API.
1.2. К электронной заявке необходимо прикрепить скан заявления, оформленного на бланке организации за подписью руководителя (или уполномоченного им лица) и печатью организации по шаблону.
1.3. Регистрация производится должностными лицами ФГБУ «ВНИИЗЖ» в срок не более 5 рабочих дней после получения заявления.
1.4. После регистрации организации или учреждению предоставляются:
  • Реквизиты доступа к тестовой версии ВетИС.API (реквизиты доступа направляются на адрес электронной почты контактного лица).
  • Реквизиты доступа к веб-интерфейсу тестовой версии компонента Меркурий.ХС и ВетИС.Паспорт.
1.5. По окончании разработки и тестирования клиентского модуля организация или учреждение самостоятельно определяет свою готовность к переходу к продуктивной версии ВетИС.API. Готовность определяется с учетом следующих критериев:
  • Операции оформления ВСД и другие операции, реализованные из информационной системы организации или учреждения, не нарушают внутренние бизнес-процессы и не приводят к задержке производственных или логистических операций.
  • Все необходимые для организации или учреждения операции протестированы и апробированы в достаточной мере: оформление ВСД из информационной системы осуществлялось в течение периода не менее 10 рабочих дней в режиме реального производственного процесса.
  • В период апробации в режиме реального производственного процесса количество запросов с ошибками с кодом MERC не должно превышать 10% от общего количества запросов этого типа в сутки. Ошибки с кодом APL и APLM отсутствуют в период апробации.


2. Доступ к продуктивной версии ВетИС.API для осуществления электронной ветеринарной сертификации предоставляется по заявкам хозяйствующих субъектов и органов государственной власти субъектов Российской Федерации в сфере ветеринарии при наличии обоснованной уверенности хозяйствующего субъекта в готовности использовать продуктивную версию ВетИС.API, подтверждая это при подаче заявления.
2.1. Заявка подается через публичную электронную форму, доступную по адресу: https://aplms.vetrf.ru/pub/.
2.2. К электронной заявке необходимо прикрепить скан заявления, оформленного на бланке организации за подписью руководителя (или уполномоченного им лица) и печатью организации по шаблону. Также вы можете подать заявку на получение доступа с помощью электронной подписи по инструкции.
2.3. Регистрация производится должностными лицами ФГБУ «ВНИИЗЖ» в срок не более 5 рабочих дней после получения заявки.
2.4. После регистрации организации или учреждению предоставляются:
  • Реквизиты доступа к продуктивной версии ВетИС.API (реквизиты доступа направляются на адрес указанной электронной почты контактного лица).
  • Возможность использовать продуктивную версию ВетИС.API в соответствии с назначенной ролью и указанной зоной обслуживания.
  • Доступ к тестовой версии ВетИС.API сохраняется.
  • Доступ к веб-интерфейсу ВетИС для рабочего сервера необходимо получить по отдельной заявке. Инструкция и шаблон заявки доступны по ссылке.
2.5. Регистрация может быть аннулирована в следующих случаях:
  • Если общее количество любых ошибок при выполнении бизнес-операций в продуктивной версии ВетИС.API превысило 10% от общего количества запросов этого типа за сутки. В этом случае организации или учреждению, ответственному за оформление запросов к шлюзу, выносится предупреждение. Если ошибки не устранены в течение 5 рабочих дней, производится отключение программной системы от продуктивной версии ВетИС.API на срок не менее 1 месяца и до устранения ошибок. В этот период учреждению или организации доступна только тестовая версия ВетИС.API.
2.6. Для восстановления доступа к продуктивной версии ВетИС.API необходимо отправить соответствующую заявку.

С чего начать

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

Обновление компонента

Перечень обновлений компонента: 2023 год | 2022 год | 2021 год | 2020 год | 2019 год | 2018 год | 2016 год | 2015 год | 2014 год

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

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

С предложениями по развитию Ветис.API обращайтесь по электронной почте на адрес api@vetrf.ru или на специализированный форум системы.

Предварительный список изменений для версии 6.7 и версии 2.1 интеграционного шлюза

С выходом обновления 6.7 появятся значительные изменения, связанные с контролем маркировки продукции и сведениями о происхождении продукции. С предварительным списком и описанием изменений можно ознакомиться здесь.

Сопровождение и поддержка

По техническим вопросам, связанным с использованием Ветис.API, обращайтесь по электронной почте на адрес api@vetrf.ru.

При наличии технической проблемы опишите в письме ее суть, приложите примеры SOAP-запросов и ответов. Свои предложения и пожелания по разработке Ветис.API вы можете также направлять по данному адресу.

Ссылки

См. также

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