Уведомление

Все примеры «персональных данных», представленные на данном портале, являются тестовыми (не реальными)! Примеры представлены разработчикам для тестирования ИТ-систем. Доступ к реальным данным осуществляется в соответствии с законами РФ согласно «Методическим рекомендациям». Подробнее.

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

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

smev3 link

smev manual

Атрибут Значение
Название 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

Описание бизнес-процесса взаимодействия:

ИС организации хочет подписаться на предоставление уведомлений из ГИС ГМП

ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его к ГИС ГМП.

После получения запроса ГИС ГМП проверяет корректность полученных данных, далее через СМЭВ направляет в Агредатор статус подписки в ГИС ГМП, Агредатор направляет данную информацию в ИС организации.

Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.

flowchart LR; A[ИС организации] <--> B[Агредатор]; B <--> C[СМЭВ]; C <--> D[ГИС ГМП];

Принимаемые параметры

Параметр Описание Обязательное Пример
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": "Успешно (ТЕСТОВЫЕ ДАННЫЕ!)"
      }
    ]
  }
}