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. Регистрация ИС в ГАС «Управление» Для регистрации информационной системы (ИС) должностному лицу, ответственному за организацию взаимодействия ИС Учреждения с ГАС «Управление», необходимо: • Получить квалифицированную ЭП, которой будут подписываться все передаваемые пакеты из ИС Учреждения в ГАС «Управление». • Сформировать заявку на регистрацию ИС в шаблоне, опубликованном на открытом портале ГАС «Управление» в разделе документов по интеграции. • Отправить на электронный адрес gasu@roskazna.ru в заархивированном виде заполненную заявку на регистрацию ИС и действующий сертификат ЭП (сертификат в формате .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. Регистрация ИС в ГАС «Управление» Актуализация данных учетных записей Учреждения или ИС: • Для изменения данных учетных записей Учреждения или ИС в ГАС «Управление» необходимо актуализировать соответствующую информацию в том же шаблоне заявки на регистрацию ИС в ГАС «Управление» и отправить эту заявку на электронный адрес службы поддержки gasu@roskazna.ru , при этом в письме нужно указать код ИС в ГАС «Управление». • По истечении срока действия ЭП нужно прислать для регистрации новый сертификат на электронный адрес службы поддержки gasu@roskazna.ru , при этом в письме нужно указать код ИС в ГАС «Управление». Для регистрации другой ИС Учреждения в ГАС «Управление» необходимо сформировать отдельную заявку и отослать ее вместе с сертификатом ЭП для соответствующей ИС. 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. Если в ответе на запрос указан другой код, то рекомендуется ознакомиться с условиями возникновения этого ответа в руководстве пользователя ЭС ГАС «Управление». В случае, если выявить причину ошибки не удается, то рекомендуется обратиться в техническую поддержку ГАС «Управление» по адресу gasu@roskazna.ru, приложив в архиве соответствующие 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 Спасибо за внимание!