Все примеры «персональных данных», представленные на данном портале, являются тестовыми (не реальными)! Примеры представлены разработчикам для тестирования ИТ-систем. Доступ к реальным данным осуществляется в соответствии с законами РФ согласно «Методическим рекомендациям». Подробнее.
Если у вас есть законные основания для подключения к Виду сведения, мы можем проконсультировать по техническим и организационным моментам подключения. Связаться с нами
Подписка на предоставление уведомлений
| Атрибут | Значение |
|---|---|
| Название | gis-gmp-subscription-service |
| Наименование | Подписка на предоставление уведомлений |
| Тип | Адаптер для СМЭВ3 сервиса |
| Версия СМЭВ | СМЭВ3 |
| Версия ВС | 2.6.0 |
| Версия МР | 3.5.0.1 |
| Поставщик | Федеральное казначейство |
| Потребители | ФОИВ, РОИВ, ОМСУ, ЗАГС, Суд, Торгово-промышленная палата РФ, Госкорпорация Роскосмос, МФЦ, КО, ПА, БПА, АО «Российский экспортный центр» |
| Тип маршрутизации | Фиксированная |
| URI | urn://roskazna.ru/gisgmp/xsd/services/SubscriptionService/2.6.0 |
| Корневой элемент | SubscriptionServiceRequest |
Описание бизнес-процесса взаимодействия:
ИС организации хочет подписаться на предоставление уведомлений из ГИС ГМП
ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его к ГИС ГМП.
После получения запроса ГИС ГМП проверяет корректность полученных данных, далее через СМЭВ направляет в Агредатор статус подписки в ГИС ГМП, Агредатор направляет данную информацию в ИС организации.
Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.
Принимаемые параметры
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| id | Идентификатор запроса | + | "G_5e8e6ede-db3a-4fd4-af74-4e76268368b0" |
| timestamp | Дата и время формирования запроса | + | "2021-07-30T16:03:25.932+03:00" |
| sender_identifier | УРН участника-отправителя запроса | + | "000009" |
| sender_role | Полномочие участника-отправителя сообщения, с которым происходит обращение к ГИС ГМП | + | "7" |
| export_subscriptions | Запрос на предоставление перечня доступных участнику вариантов уведомлений | -1 | "true" |
| create_subscription | Запрос на оформление подписки на предоставление уведомлений (или изменение, удаление подписки) с указанием значений параметров при необходимости | -1 | Составной элемент CreateSubscription |
| change_subscription | Запрос на изменение версии форматов направляемых уведомлений | -1 | Составной элемент ChangeSubscription |
1 - обязательно должен присутствовать только один из элементов
Структура элемента CreateSubscription
Запрос на оформление подписки на предоставление уведомлений
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| subscription_status | Cтатус подписки к варианту уведомлений. Возможные значения: 1-новая подписка, 2-изменение подписки, 3-удаление подписки | + | "1" |
| routing_code | Код маршрутизации участника в ВС "Предоставление из ГИС ГМП уведомлений по рассылке". Обязательно указывается для новой подписки (статус подписки "1"- добавить) | - | "45382000" |
| subscription_code | Код варианта уведомления. Указывается для новой подписки (для статуса подписки "1") | -1 | "NC0001" |
| subscription_identifier | Идентификатор подписки, присвоенный в ГИС ГМП. Указывается при изменении или удалении подписки (статус подписки "2" или "3") | -1 | |
| subscription_parameters | Значения параметра (группы параметров) подписки | - | Массив составных элементов SubscriptionParameter |
1 - обязательно должен присутствовать только один из элементов
Структура элемента ChangeSubscription
Запрос на изменение версии форматов направляемых уведомлений
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| subscription_identifier | Идентификатор подписки | + | |
| notice_uri | Наименование URI зарегистрированного в едином сервисе СМЭВ 3. Значение "0" указывается, если необходимо получать уведомления по актуальной версии форматов. | + | urn://roskazna.ru/gisgmp/xsd/services/ExportNotice/2.0.6 |
Структура элемента SubscriptionParameter
Значения параметра (группы параметров) подписки
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| status | Cтатус для обработки значения параметра (группы параметров). Возможные значения: 1-новое значение, 2-удаление значения | + | "1" |
| parameter_id | Идентификатор значения параметра (группы параметров) в пакете передаваемых значений | + | "P_e5792842-b9b1-4515-859f-a309afeaa9d7" |
| parameter_value | Значение параметра | + | Массив составных элементов ParameterValue |
Структура элемента ParameterValue
Значение параметра
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| parameter_code | Код параметра | + | "payerIdentifier" |
| value | Значение параметра | + | "1010000000000164921814" |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| id | Идентификатор ответа | + | "ID1" |
| rq_id | Идентификатор запроса | + | "a" |
| recipient_identifier | УРН участника получателя | + | "000000" |
| timestamp | Дата и время формирования ответа | + | "2001-12-17T09:30:47Z" |
| subscriptions | Ответ на запрос предоставления перечня доступных участнику вариантов уведомлений (0-unbounded элементов) | -1 | Массив составных элементов Subscription |
| create_subscription_result | Ответ с результатом обработки запроса о подписке (изменении/удалении подписки) участника | -1 | Составной элемент CreateSubscriptionResult |
| change_subscription_result | Ответ с результатом обработки запроса об изменении версии форматов направляемых уведомлений | -1 | Составной элемент ChangeSubscriptionResult |
| attachments | Информация о переданных файлах-вложениях, сохраненных в файловом хранилище Агредатора | - | Последовательность составных элементов AggredatorAttachment |
1 - обязательно должен присутствовать только один из элементов
При оформлении подписки на предоставление уведомлений об изменении нормативно-справочной информации в составе ответа на запрос по данному виду сведений, информация с полным справочником НСИ ГИС ГМП передается во вложении. Вложение содержит структурированный XML-документ. Файл-вложение может содержать один или несколько файлов с бизнес-данными (Справочник Участников бюджетного процесса (УБП) или Справочник ОКТМО). Максимальный объем одного или нескольких файлов-вложений не превышает 1 ГБ.
Структура элемента Subscription
Ответ на запрос предоставления перечня доступных участнику вариантов уведомлений
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| subscription_code | Код варианта уведомлений | + | |
| subscription_name | Наименование варианта | + | |
| subscription_operation | Описание типа уведомления | + | |
| subscription_parameter | Перечень параметров, значения которых необходимо указать при оформлении подписки (от 1 до 10 элементов) | - | Массив составных элементов SubscriptionParameter |
Структура элемента CreateSubscriptionResult
Ответ с результатом обработки запроса о подписке (изменении/удалении подписки) участника
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| dispatch_date | Дата и время добавления/удаления подписки или изменения значений параметров подписки | - | "2021-07-30T16:03:52.932+03:00" |
| expiry_date | Дата автоматического окончания срока действия значений параметров подписки в ГИС ГМП | - | |
| subscription_code | Код варианта уведомлений | - | "NC0001" |
| subscription_identifier | Идентификатор подписки | - | "000009NC0001" |
| subscription_protocol | Результат обработки запроса о подписке или уточнения/удаления подписки (от 1 до 250 элементов) | + | Массив составных элементов SubscriptionProtocol |
Структура элемента ChangeSubscriptionResult
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| subscription_identifier | Идентификатор подписки | - | "000009NC0001" |
| subscription_protocol | Результат обработки запроса об изменении версии форматов направляемых уведомлений | + | Составной элемент SubscriptionProtocol |
Структура элемента SubscriptionParameter (в ответе)
Перечень параметров, значения которых необходимо указать при оформлении подписки
| Параметр | Описание | Обязательное | Пример | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| parameter_code | Код параметра | + | "payerIdentifier" | |||||||
| parameter_name | Наименование параметра | + | "Идентификатор плательщика" | |||||||
| parameter_pattern | Формат параметра | - | "(1((0[1-9]) | (1[0-5]) | (2[12456789]) | (3[0]))[0-9a-zA-Zа-яА-Я]{19}) | (200\d{14}[A-Z0-9]{2}\d{3}) | (300\d{14}[A-Z0-9]{2}\d{3} | 3[0]{7}\d{9}[A-Z0-9]{2}\d{3}) | (4[0]{9}\d{12})" |
| required | Признак обязательности параметра: false - параметр необязательный; true - параметр обязательный. | + | "true" | |||||||
| parameter_description | Описание дополнительных ограничений для значений параметра | - |
Структура элемента SubscriptionProtocol
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| parameter_id | Идентификатор значения параметра (группы параметров) в пакете | - | "P_e5792842-b9b1-4515-859f-a309afeaa9d7" |
| code | Код результата обработки: 0 — если значение параметра (группы параметров) успешно принято или код ошибки в случае отказа в приеме к обработке значения параметра (группы параметров) | + | "0" |
| description | Описание результата обработки | + | "Успешно (ТЕСТОВЫЕ ДАННЫЕ!)" |
Структура элемента AggredatorAttachment
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| uuid | Идентификатор вложения в файловом хранилище Filator | + | 4833e4c4385dc47f2d2a08469f246e7cd1f66f416691d0b5a92a00d722f8d4ec |
| checksum | Контрольная сумма вложения, рассчитанная с помощью хеш-функции SHA‑256 (из SHA-2) в формате HEX-строки | + | e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 |
| mime_type | Mime/type вложения | + | text/plain |
| filename | Имя файла вложения | + | attachment.txt |
| type | Cпособ получения вложения (mtom - получено в ответе, fs - получено через ФХ СМЭВ) | + | fs |
| smev_id | Идентификатор вложения из xml сообщения СМЭВ (в случае mtom имя файла, в случае fs - идентификатор в ФХ СМЭВ) | + | attachment.txt |
Примеры
Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.
Тестовый сценарий 1. Успешное выполнение запроса на предоставление перечня доступных участнику вариантов уведомлений для оформления подписки
Запрос:
{
"id": "G_5e8e6ede-db3a-4fd4-af74-4e76268368b0",
"timestamp": "2021-07-30T16:03:25.932+03:00",
"sender_identifier": "000009",
"sender_role": "7",
"export_subscriptions": "true"
}
Ответ:
{
"id": "U_49655ef1-07fe-41f9-9538-c1bcdffb2b95",
"rq_id": "G_5e8e6ede-db3a-4fd4-af74-4e76268368b0",
"recipient_identifier": "000009",
"timestamp": "2021-07-30T16:04:25.932+03:00",
"subscriptions": [
{
"subscription_code": "NC0001",
"subscription_name": "Уведомления о начислениях по определенным значениям идентификатора плательщика (ТЕСТОВЫЕ ДАННЫЕ!)",
"subscription_operation": "Уведомления о поступлении извещения о начислении (ТЕСТОВЫЕ ДАННЫЕ!)",
"subscription_parameter": [
{
"parameter_code": "payerIdentifier",
"parameter_name": "Идентификатор плательщика",
"parameter_pattern": "(1((0[1-9])|(1[0-5])|(2[12456789])|(3[0]))[0-9a-zA-Zа-яА-Я]{19})|(200\\d{14}[A-Z0-9]{2}\\d{3})|(300\\d{14}[A-Z0-9]{2}\\d{3}|3[0]{7}\\d{9}[A-Z0-9]{2}\\d{3})|(4[0]{9}\\d{12})",
"required": "true"
}
]
}
]
}
Тестовый сценарий 2. Успешное выполнения операции оформления подписки на предоставление уведомлений с указанием значения параметра
{
"id": "U_7994af15-f7f2-4a10-a055-5aacf6057d4f",
"timestamp": "2021-07-30T16:03:25.932+03:00",
"sender_identifier": "000009",
"sender_role": "7",
"create_subscription": {
"subscription_status": "1",
"routing_code": "45382000",
"subscription_code": "NC0001",
"subscription_parameters": [
{
"status": "1",
"parameter_id": "P_e5792842-b9b1-4515-859f-a309afeaa9d7",
"parameter_value": [
{
"parameter_code": "payerIdentifier",
"value": "1010000000000164921814"
}
]
}
]
}
}
Ответ:
{
"id": "G_3df3e555-1dcd-48e1-8483-bb358a128b38",
"rq_id": "U_7994af15-f7f2-4a10-a055-5aacf6057d4f",
"recipient_identifier": "000009",
"timestamp": "2021-07-30T16:04:25.932+03:00",
"create_subscription_result": {
"dispatch_date": "2021-07-30T16:03:52.932+03:00",
"subscription_code": "NC0001",
"subscription_identifier": "000009NC0001",
"subscription_protocol": [
{
"parameter_id": "P_e5792842-b9b1-4515-859f-a309afeaa9d7",
"code": "0",
"description": "Успешно (ТЕСТОВЫЕ ДАННЫЕ!)"
}
]
}
}
