ЕСИА ЦПГ

Уведомление

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

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

Оформление подписки коммерческой организации на рассылку обновленных документов пользователя ЕСИА в рамках выданного согласия пользователя

Атрибут	Значение
Название	esia-subscription
Наименование	Оформление подписки коммерческой организации на рассылку обновленных документов пользователя ЕСИА в рамках выданного согласия пользователя
Тип	Адаптер для СМЭВ3 сервиса
Область применения	Межведомственное взаимодействие
Версия СМЭВ	СМЭВ3
Версия ВС	1.0.0
Версия МР	3.5
Поставщик	ЕСИА
Потребители	Коммерческие организации
Тип маршрутизации	Табличная
URI	`urn://mincomsvyaz/esia/Subscription/1.0.0`
Корневой элемент	SubscriptionRequest

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

ИС организации хочет подписаться на рассылку обновленных документов пользователя ЕСИА.

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

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

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

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

Доступные продукты

Продукты
Цифровой профиль гражданина

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

Параметр	Описание	Обязательное	Пример
routing_code	Код маршрутизации на cреду ЕСИА	+	DEV
oid	Идентификатор пользователя ЕСИА (ЮЛ или ФЛ)	+	1000567890
user_type	Тип пользователя ЕСИА (ЮЛ или ФЛ): FL - физическое лицо; UL - юридическое лицо	+	FL
permissions	Список выданных согласий пользователя для внешней ИС	+	Последовательность элементов Permission

Структура элемента Permission

Выданное согласие пользователя

Параметр	Описание	Обязательное	Пример
id	Идентификатор выданного согласия пользователя	+	9876543210
doc_types	Список типов документа для которых выдано согласие пользователя	+	Последовательность элементов DocType

Структура элемента DocType

Тип документа, для которого выдано согласие пользователя

Параметр	Описание	Обязательное	Пример
action_type	Тип действия: SUBSCRIBE – операция оформления подписки; CANCEL - операция аннулирования подписки.	+	SUBSCRIBE
data_type	Тип документа	+	ILS_PFR

Параметры ответа

Параметр	Описание	Обязательное	Пример
oid	Идентификатор пользователя ЕСИА (ЮЛ или ФЛ)	+	4294967295
user_type	Тип пользователя ЕСИА (ЮЛ или ФЛ): FL - физическое лицо; UL - юридическое лицо	+	FL
permissions	Список выданных согласий пользователя для внешней ИС	+	Последовательность элементов PermissionResponse

Структура элемента PermissionResponse

Выданное согласие пользователя

Параметр	Описание	Обязательное	Пример
id	Идентификатор выданного согласия пользователя	+	4294967295
doc_types	Список типов документа для которых выдано согласие пользователя	+	Последовательность элементов DocTypeResponse

Структура элемента DocTypeResponse

Тип документа, для которого выдано согласие пользователя

Параметр	Описание	Обязательное	Пример
action_type	Тип действия: SUBSCRIBE – операция оформления подписки; CANCEL - операция аннулирования подписки.	+	SUBSCRIBE
data_type	Тип документа	+	ILS_PFR
status_response	Статус выполнения операции: SUCCEEDED – операция успешно выполнена; ERROR - ошибка при выполнении операции.	+	SUCCEEDED
error_status_info	Детальная информация об ошибке	-	Составной элемент ErrorStatusInfo

Структура элемента ErrorStatusInfo

Детальная информация об ошибке

Параметр	Описание	Обязательное	Пример
code	Код ошибки	+	ESIA-201584
message	Описание ошибки	+	Отсутствует актуальное согласие пользователя на передачу персональных данных указанного типа

Примеры

Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.

Запрос:

{
  "routing_code": "DEV",
  "oid": "1000567890",
  "user_type": "FL",
  "permissions": [
    {
      "id": "9876543210",
      "doc_types": [
        {
          "action_type": "SUBSCRIBE",
          "data_type": "ILS_PFR"
        },
        {
          "action_type": "SUBSCRIBE",
          "data_type": "INCOME_REFERENCE"
        }
      ]
    },
    {
      "id": "1122334455",
      "doc_types": [
        {
          "action_type": "CANCEL",
          "data_type": "SNILS"
        }
      ]
    }
  ]
}

Ответ:

{
  "oid": "1000567890",
  "user_type": "FL",
  "permissions": [
    {
      "id": "9876543210",
      "doc_types": [
        {
          "action_type": "SUBSCRIBE",
          "data_type": "ILS_PFR",
          "status_response": "SUCCEEDED"
        },
        {
          "action_type": "SUBSCRIBE",
          "data_type": "INCOME_REFERENCE",
          "status_response": "ERROR",
          "error_status_info": {
            "code": "ESIA-201584",
            "message": "Отсутствует актуальное согласие пользователя на передачу персональных данных указанного типа"
          }
        }
      ]
    },
    {
      "id": "1122334455",
      "doc_types": [
        {
          "action_type": "CANCEL",
          "data_type": "SNILS",
          "status_response": "SUCCEEDED"
        }
      ]
    }
  ]
}