Презентация Интеграция с ГАС «Управление

www.roskazna.ru
Интеграция с государственной
автоматизированной системой
«Управление»
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
Содержание
1.
2.
3.
4.
5.
6.
7.
8.
9.
Регистрация информационной системы в ГАС «Управление»
Общие принципы взаимодействия информационных систем потребителей и
поставщиков с ГАС «Управление»
Протоколы интеграции с ГАС «Управление»
Среда передачи сообщений
Структура SOAP сообщения
Часто задаваемые вопросы и типовые ошибки
Общесистемные справочники и показатели
Примеры сообщений
Прочая техническая информация
2
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
1. Регистрация ИС в ГАС «Управление»
Независимо от среды передачи сообщений (СМЭВ или Интернет):
• Юридическая значимость данных передаваемых в ГАС «Управление»
обеспечивается поставщиком путем использования квалифицированной
электронной подписи поставщика для подписания ЭС.
• ЭП используется в соответствии с документом «Методические рекомендации по
использованию электронной подписи при межведомственном электронном
взаимодействии» (версия 4.3).
• Формат соответствует документу «Методические рекомендации по разработке
электронных сервисов и применению технологии электронной подписи при
межведомственном электронном взаимодействии» (версия 2.5.6).
3
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
1. Регистрация ИС в ГАС «Управление»
Для регистрации информационной системы (ИС) должностному лицу,
ответственному за организацию взаимодействия ИС Учреждения с ГАС
«Управление», необходимо:
• Получить квалифицированную ЭП, которой будут подписываться все
передаваемые пакеты из ИС Учреждения в ГАС «Управление».
• Сформировать заявку на регистрацию ИС в шаблоне, опубликованном на
открытом портале ГАС «Управление» в разделе документов по интеграции.
• Отправить на электронный адрес [email protected] в заархивированном виде
заполненную заявку на регистрацию ИС и действующий сертификат ЭП
(сертификат в формате .cer).
4
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
1. Регистрация ИС в ГАС «Управление»
ГАС «Управление» рассматривает следующие виды ЭП:
• Электронная подпись уполномоченного лица органа власти (ЭП-СП);
• Электронная подпись органа власти (ЭП-ОВ).
Все ЭП, используемые в рамках информационного взаимодействия, должны быть
выданы УЦ, входящими в единое пространство доверия
Для проверки ЭП в ГАС «Управление» использован «Сервис проверки электронной
подписи», размещенный в СМЭВ:
http://smev.gosuslugi.ru/portal/services.jsp#!/F/543%D0%A1%D0%9F%D0%AD%D0%9F/1.
00/p00smev/SID0003318
Технические аспекты реализации приведены в технической части презентации.
5
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
1. Регистрация ИС в ГАС «Управление»
Обработка заявки на регистрацию ИС:
• После получения письма с заявкой специалист службы технической поддержки
ГАС «Управление» зарегистрирует учетную запись Учреждения, являющегося
владельцем системы, и учетную запись ИС вместе с сертификатом ЭП на
тестовом и промышленном сервисе ГАС «Управление».
• После завершения регистрации отправителю заявки будут присланы код
Учреждения и код ИС в ГАС «Управление».
Присвоенный ИС код необходимо указывать в поле DataSourceRef при
формировании сообщений на ЭС ГАС «Управление». Подписывать сообщения
необходимо зарегистрированным для соответствующей учетной записи ИС
сертификатом.
6
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
1. Регистрация ИС в ГАС «Управление»
Актуализация данных учетных записей Учреждения или ИС:
• Для изменения данных учетных записей Учреждения или ИС в ГАС
«Управление» необходимо актуализировать соответствующую информацию в
том же шаблоне заявки на регистрацию ИС в ГАС «Управление» и отправить эту
заявку на электронный адрес службы поддержки [email protected] , при этом в
письме нужно указать код ИС в ГАС «Управление».
• По истечении срока действия ЭП нужно прислать для регистрации новый
сертификат на электронный адрес службы поддержки [email protected] , при
этом в письме нужно указать код ИС в ГАС «Управление».
Для регистрации другой ИС Учреждения в ГАС «Управление» необходимо
сформировать отдельную заявку и отослать ее вместе с сертификатом ЭП для
соответствующей ИС.
7
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Прием и предоставление данных в ГАС «Управление» осуществляется через
единый электронный сервис ГАС «Управление» (за исключением случаев
отсутствия у поставщика технической возможности автоматизированной передачи
данных).
Данный электронный сервис разработан в соответствие с методическими
рекомендациями по разработке электронных сервисов и применению технологии
электронной подписи при межведомственном электронном взаимодействии версии
2.5.6. Данные документы доступны на Технологическом портале СМЭВ по адресу
http://smev.gosuslugi.ru.
8
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Перед началом использования ЭС техническим специалистам рекомендовано
ознакомится со следующими документами:
• Актуальной одобренной ТКМВ, размещенной на портале методической
поддержки по адресу http://gasu2.ru.
• Руководством пользователя ЭС ГАС «Управление», размещенном не
технологическом портале СМЭВ.
• Актуальной версией документа «Единые реестры, справочники,
классификаторы государственной автоматизированной ГАС «Управление»,
размещенному в открытой части портала ГАС «Управление» в разделе
документов по интеграции по адресу http://gasu.roskazna.ru/documentsintegration.
9
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Отладка технического взаимодействия информационной системы поставщика или
потребителя с ГАС «Управление» должна проводиться только с использованием
тестового ЭС ГАС «Управление», доступного через Интернет или СМЭВ.
Внимание! Проводить отладку взаимодействия с использованием
промышленного ЭС ГАС «Управление» запрещено.
10
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Основными объектами информационного взаимодействия, определенными в
документе «Регламент интеграции ведомственных информационных ресурсов с
Государственной автоматизированной системой «Управление» являются:
• Описание баз данных и электронных сервисов ИС Поставщика;
• Паспорта (метаданные) реестров, справочников и классификаторов;
• Измерения (размерности) показателей;
• Паспорта (метаданные) показателей;
• Записи реестров, справочников, классификаторов;
• Данные по показателям.
11
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Последовательность действий поставщика ФОИВ при передаче данных посредством
ЭС ГАС «Управление»:
• Передать на тестовый сервис в требуемых форматах паспорта (метаданные)
необходимых реестров, справочников, классификаторов и показателей.
• Передать на тестовый сервис в требуемых форматах выгрузку данных по
показателям в соответствии с утвержденной ТКМВ поставщика ФОИВ и требований
к единым реестрам, справочникам, классификаторам ГАС «Управление».
• В случае успешной публикации данных на тестовом сервисе произвести
вышеперечисленные действия на промышленном сервисе.
• После успешной публикации данных на тестовом и промышленном сервисах
сформировать протоколы тестовой и итоговой интеграции соответственно, затем
отправить протоколы в Центральный аппарат Федерального казначейства для
проверки и подписания.
12
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Последовательность действий поставщика РОИВ при передаче данных посредством
ЭС ГАС «Управление»:
• Все паспорта реестров, справочников, классификаторов и показателей ТКМВ
РОИВ уже зарегистрированы. Поэтому нужно передать на тестовый сервис только
выгрузку данных по своему региону по показателям ТКМВ РОИВ, при этом в поле
providerRef для показателей, коды которых начинаются с «РОИВ/-/…», нужно
указать значение ТРР (русскими буквами), для показателей коды которых
начинаются с «ГАСУ/…» или «РОИВ/ГУР/…», нужно указать значение GASU.
• В случае успешной публикации данных на тестовом сервисе произвести
вышеперечисленные действия на промышленном сервисе.
• После успешной публикации данных на тестовом и промышленном сервисах
сформировать протоколы тестовой и итоговой интеграции соответственно, затем
отправить протоколы в Центральный аппарат Федерального казначейства для
проверки и подписания.
13
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
2. Общие принципы взаимодействия
Последовательность действий потребителя при получении данных в ГАС
«Управление»:
• Определение кодов необходимых показателей в ГАС «Управление», кода ИС
источника данных соответствующих показателей в ГАС «Управление»;
• Получение метаданных показателей;
• Получение метаданных связанных с показателем измерений;
• Получение метаданных справочников, ассоциированных с измерениями
показателей;
• Получение данных, содержащихся в справочниках, ассоциированных с
измерениями показателя;
• Получение данных по показателям.
14
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
3. Протоколы интеграции с ГАС «Управление»
Протокол тестовой интеграции:
• После успешной передачи данных на тестовый сервис ГАС «Управление»
необходимо сформировать в двух экземплярах протокол тестовой интеграции
ИС поставщика с ГАС «Управление».
• Подписать оба экземпляра протокола и отправить в Центральный Аппарат
Федерального казначейства для проверки.
• После успешной проверки оба экземпляра протокола подписываются со
стороны Федерального казначейства и один из подписанных протоколов
высылается обратно отправителю.
15
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
3. Протоколы интеграции с ГАС «Управление»
Протокол итоговой интеграции:
• После успешной передачи всех данных по показателям ТКМВ поставщика на
промышленный сервис ГАС «Управление» необходимо сформировать в двух
экземплярах протокол итоговой интеграции ИС поставщика с ГАС «Управление»
• Подписать оба экземпляра протокола и отправить в Центральный Аппарат
Федерального казначейства для проверки.
• После успешной проверки оба экземпляра протокола подписываются со
стороны Федерального казначейства и один из подписанных протоколов
высылается обратно отправителю.
16
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
3. Протоколы интеграции с ГАС «Управление»
Шаблоны тестовой и итоговой интеграции опубликованы в разделе документов по
интеграции открытой части портала ГАС «Управление».
Для каждого типа интеграции используется свой шаблон протокола:
• Для поставщиков ФОИВ - протоколы интеграции ВИР с ГАС «Управление».
• Для поставщиков РОИВ с Типовым региональным решением ГАС «Управление» протоколы интеграции ТРР с ГАС «Управление».
• Для поставщиков РОИВ с собственной ИС - протоколы интеграции региональных
информационных ресурсов с ГАС «Управление».
Требования для подписания протоколов со стороны Федерального казначейства
изложены в тексте шаблонов соответствующих протоколов.
17
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
4. Среда передачи сообщений
1. Тестовый электронный сервис ГАС «Управление», доступный в СМЭВ:
http://smev-mvf.test.gosuslugi.ru:7777/gateway/services/SID0003565?wsdl
2. Промышленный электронный сервис ГАС «Управление», доступный в СМЭВ:
http://oraas.rt.ru:7777/gateway/services/SID0003808?wsdl
18
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
4. Среда передачи сообщений
Рекомендации по настройке взаимодействия с электронным сервисом ГАС
«Управление», доступного через СМЭВ:
• Создание защищенного канала
http://smev.gosuslugi.ru/portal/api/files/get/8021
• Методические рекомендации http://smev.gosuslugi.ru/portal/api/files/get/6671
• Руководство пользователя сервиса ГАС «Управление»
http://smev.gosuslugi.ru/portal/services.jsp#!/F/RKZNgasu2SOAP/1.00/p00smev/S
ID0003808
• Инструмент разработчика http://smev.gosuslugi.ru/portal/services-tools.jsp
• Подробнее http://smev.gosuslugi.ru/portal/
19
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
Наименование метода
publish
Описание метода электронного сервиса
Предназначен для публикации информации,
Входящее ЭС
GasuMessage
поступающей от ИС Поставщиков, в ГАС
«Управление»
query
Предназначен для запроса и получения ИС
GasuQueryMessage
Потребителем информации, опубликованной в ГАС
«Управление»
updates
Предназначен для получения информации об
GasuUpdatesMessage
изменении данных показателей в ГАС «Управление».
20
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
ИС
Поставщика
Вызов метода
gasu2:publish
gasu2:GasuMessage
ГАС
«Управление»
Обработка
gasu2:GasuTicket
21
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
Входящее сообщение метода publish
Элемент
Тип
Описание
AppHeader
AppHeaderType
Заголовок блока
MessageType
MessageTypeType
Тип сообщения
Body
Body
Тело блока, содержащее объект информационного взаимодействия
Исходящее сообщение метода publish
Элемент
Тип
Описание
RequestID
UIDType
Идентификатор сообщения, в ответ на которое сформирован данный ответ
GasuResponseCode
string
Код ответа, определяющий результаты обработки запроса
GasuResponseMessage
string
Текстовое сообщение, которое может содержать дополнительную информацию о
результатах обработки сообщения
PublishResponse
PublishResponseType
Блок структурированных сведений.
22
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
23
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
Входящее сообщение метода query
Элемент
Тип
Описание
Header
AppHeaderType
Заголовок блока
Query
QueryType
Запрос на предоставление информации об объекте информационного
взаимодействия
Исходящее сообщение метода query
Элемент
Тип
Описание
RequestID
UIDType
Идентификатор сообщения, в ответ на которое сформирован данный ответ
GasuResponseCode
string
Код ответа, определяющий результаты обработки запроса
GasuResponseMessage
string
Текстовое сообщение, которое может содержать дополнительную информацию о
результатах обработки сообщения
QueryResponse
QueryResponseType
Элемент, содержащий запрашиваемый объект информационного взаимодействия
24
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
ИС
Поставщика
Вызов метода
gasu2:updates
gasu2:GasuUpdatesMessage
ГАС
«Управление»
Обработка
gasu2:GasuTicket
25
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
Входящее сообщение метода updates
Элемент
Тип
Описание
Header
AppHeaderType
Заголовок блока
UpdatesFilter
UpdatesFilterType
Запрос на предоставление информации об изменениях данных показателей
Исходящее сообщение метода updates
Элемент
Тип
Описание
RequestID
UIDType
Идентификатор сообщения, в ответ на которое сформирован данный ответ
GasuResponseCode
string
Код ответа, определяющий результаты обработки запроса
GasuResponseMessage
string
Текстовое сообщение, которое может содержать дополнительную информацию о
результатах обработки сообщения
UpdatesResponse
UpdatesResponseType
Перечень периодов, связанных с данными показателей, измененных в рамках
временного интервала указанного в параметре запроса
26
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
5. Структура SOAP сообщения
Более подробная информация о структуре ЭС содержится в руководстве
пользователя сервиса ГАС «Управление»
http://smev.gosuslugi.ru/portal/services.jsp#!/F/RKZNgasu2SOAP/1.00/p00smev/SID0
003808.
В частности в руководстве пользователя сервиса ГАС «Управление» содержится
следующая информация:
• Подробное описание методов publish, query и updates;
• Коды возвратов и контрольные примеры для каждого метода ЭС;
• Методика испытаний на тестовой и промышленной среде;
• Описание сервиса (WSDL);
• Описание общих структур данных;
• Примеры публикации, запроса и удаления информации.
27
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
6. Часто задаваемые вопросы
• Что необходимо указывать в DataSourceRef и в providerRef?
В DataSourceRef код ИС участника взаимодействия в ГАС «Управление»
В providerRef код ИС поставщика объекта в ГАС «Управление».
• Каковы требования к сертификату ЭП, которым подписываются данные?
Рекомендации СМЭВ по использованию ЭП при межведомственном взаимодействии.
Сертификат, должен быть действующим и зарегистрирован в ГАС «Управление».
28
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
6. Часто задаваемые вопросы
• Как удалить данные по переданным показателям?
Необходимо на стороне поставщика сохранить идентификатор переданного набора
данных. В ГАС «Управление» в любой момент можно отозвать переданный набор
данных с использованием метода publish (инструкция delete).
• Как подтвердить успешность передачи данных?
После успешной публикации необходимо вызвать метод query ЭС либо просмотреть
переданные данные с использованием закрытой части портала ГАС «Управление».
29
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
6. Типовые ошибки
Коды и наименования справочников не соответствуют ТКМВ;
Состав и структура собственных справочников не соответствует ТКМВ;
Не используются единые (согласно ТКМВ) справочники ГАС «Управление»;
Регистрируется избыточное количество измерений (на каждый показатель
создаются свои измерения, что неверно).
Если запрос был выполнен успешно, в ответе от сервиса будет указан код возврата
200. Если в ответе на запрос указан другой код, то рекомендуется ознакомиться с
условиями возникновения этого ответа в руководстве пользователя ЭС ГАС
«Управление». В случае, если выявить причину ошибки не удается, то
рекомендуется обратиться в техническую поддержку ГАС «Управление» по адресу
[email protected], приложив в архиве соответствующие xml запрос/ответ.
•
•
•
•
30
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
7. Общесистемные справочники
Общероссийские классификаторы, дублирование которых не допустимо:
• ОКВЭД
• ОКТМО
• ОКСМ
• ОКЕИ
• …
Более подробная информация roskazna.ru/the-state-automated-system-ofmanagement/
31
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
7. Общесистемные справочники
Системные классификаторы ГАС Управление», обязательные к использованию:
• Периоды / время
• Территория / регионы / субъекты РФ
• Глава (ГРБС/ГАДБ/ГАИФ)
• Вид средств
• Бюджет
• Коды бюджетной классификации
32
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего запрос на получение метаданных об источнике данных,
публикуемых в ГАС «Управление»:
33
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего информацию об источнике данных, публикуемых в ГАС
«Управление»:
34
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего паспорт справочника (классификатора):
35
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего запрос на получение паспорта справочника
(классификатора):
36
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего список элементов справочника (классификатора):
37
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего запрос на получение элементов справочника
(классификатора):
38
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего паспорт показателя:
39
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего запрос на получение паспорта показателя:
40
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего данные по показателю:
41
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
8. Примеры сообщений
Фрагмент ЭС, содержащего запрос на получение данных по показателю:
42
ФЕДЕРАЛЬНОЕ КАЗНАЧЕЙСТВО
www.roskazna.ru
9. Прочая техническая информация
Электронная подпись SOAP сообщений:
• Подпись сообщений SOAP для СМЭВ с использованием КриптоПро JCP:
http://www.cryptopro.ru/blog/2012/07/02/podpis-soobshchenii-soap-dlya-smev-sispolzovaniem-kriptopro-jcp
•
Подпись сообщений SOAP для СМЭВ с использованием КриптоПро .NET:
http://www.cryptopro.ru/blog/2012/05/16/podpis-soobshchenii-soap-dlya-smev-sispolzovaniem-kriptopro-net
43
Спасибо за внимание!