Пособие на проведение летнего оздоровительного отдыха детей

smev3 link

smev manual

Атрибут Значение
Название pfr-epgu-ypos-summer-rest
Тип Адаптер для вида сведений к услуге на ЕПГУ
Наименование Пособие на проведение летнего оздоровительного отдыха детей
Поставщики Пенсионный фонд Российской Федерации
Потребители Министерство цифрового развития, связи и массовых коммуникаций Российской Федерации
Область применения Прием заявлений с ЕПГУ/МФЦ
Версия 1.0.0
Версия МР 3.0
flowchart LR; A((Пользователь)) <--> B[ЕПГУ]; B <--> C[СМЭВ]; C <--> D[Агредатор]; D <--> E[ИС организации];

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

Переменные окружения

Название Описание
CA_CERT сертификат центра сертификации для подключения к rabbitmq
CLIENT_CERT сертификат, используемый для подключения к rabbitmq
CLIENT_KEY ключ, используемый для подключения к rabbitmq
MQ_HOST хост rabbitmq
MQ_PORT порт rabbitmq
SMEV_SERVICE название смэв сервиса, на который будут отправляться запросы
DATABASE_URL строка подключения к БД
EMULATE_CLIENT флаг эмуляции ответа клиента

Переменные для конфигурирования отправки метрик в Elasticsearch:

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

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

В данном разделе приведены параметры, необходимые для формирования ответа на полученный запрос.

Параметр Описание Обязательное Пример
epgu_id Номер заявления с ЕПГУ + 2147483648
attachments Идентификаторы вложений, сохраненных в файловом хранилище агредатора - ["7ca24dd0450bf0cc509f384f6198ff9ac12dd52f0ef1fc10d3af8c14c49876aa"]
status_code Код статуса в ЛК ЕПГУ + 3
comment Комментарий к статусу - Тест

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

Данный сервис получает запрос от СМЭВ 3 и ожидает получения ответа. В данном разделе указаны параметры, получаемые в результате обработки запроса.

Параметр Описание Обязательное Пример
oktmo Код по ОКТМО региона, в котором оформлено заявление + 00000000000
delivery_type Способ подачи. Принимает значения:
- epgu - через ЕПГУ
- mfc - через МФЦ
+ epgu
mfc_id Идентификатор МФЦ -  
mfc_name Наименование МФЦ -  
data_request Запрос с отправкой данных на назначение выплаты -1 Составной элемент DataRequest
change_details_request Запрос с отправкой данных для внесения изменений в платежные реквизиты -1 Составной элемент ChangeDetailsRequest
attachments Данные, необходимые для получения вложений + Последовательность элементов AggredatorAttachment. Поле обязательно присутствует, но может быть пустым.

1 - обязательно должен присутствовать только один из элементов

Вложение в запросе является структурированным и представляет из себя бизнес-данные запроса вида сведений. Название файла в запросе статично – req.xml, файл будет помещен в zip-архив, способ передачи вложений - МТОМ или FTP.

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

Параметр Описание Обязательное Пример
additional_info Флаг для запроса доп.информации - false
order_id Номер заявления в ЛК ЕПГУ + 123123123
region_final Регион оказания услуги -  
department_id Ведомство, оказывающее услугу -  
service_id Номер услуги -  
territory_organ Территориальный орган ПФР - Составной элемент DataElement
current_date Дата подачи заявления + 2022-05-04
empowered_sign Заявление подает законный представитель + false
empowered_info Сведения о законном представителе заявителя - Составной элемент EmpoweredInfo
applicant_info Сведения о заявителе + Составной элемент PersonInfo
data_deceased_serviceman Данные умершего военнослужащего - Составной элемент DeceasedServiceman
get_military_disability Получена инвалидность при несении службы - false
data_military_service Данные о военной службе - Составной элемент MilitaryService
subsidies_info Способ получения выплат + Составной элемент SubsidiesInfo
dop_info Дополнительная информация - Тест
dop_information Дополнительные сведения - Тест
additional_attrs Дополнительные атрибуты - Составной элемент AdditionalAttrs
children_info Сведения о детях. Массив из не более чем 20 элементов - Массив элементов ChildrenInfo

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

Параметр Описание Обязательное Пример
uuid Идентификатор файла в хранилище + 7ca24dd0450bf0cc509f384f6198ff9ac12dd52f0ef1fc10d3af8c14c49876aa
checksum Контрольная сумма + e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
created_at Время загрузки файла + 2020-11-16T12:27:20.726+03:00
tags Последовательность строк-тегов файла + ["test"]
filename Имя загруженного файла + test.txt
smev_id Идентификатор вложения, используемый в СМЭВ конверте + attachment.txt
Структура элемента DataElement
Параметр Описание Обязательное Пример
code Код элемента (для адресных данных – код из ФИАС). Обязательно к заполнению (для элемента адреса код и наименование не заполняются при отсутствии значения) + 01
value Наименование элемента. Обязательно к заполнению (для элемента адреса код и наименование не заполняются при отсутствии значения) + Паспорт гражданина РФ

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

Параметр Описание Обязательное Пример
empowered_kind Тип представителя + Составной элемент DataElement
lastname Фамилия +  
firstname Имя +  
middlename Отчество -  
birthday Дата рождения + 1993-05-04
gender Пол. Принимает значения:
- Мужской
- Женский
- Мужской
snils СНИЛС - 616-636-131 88
citizenship Гражданство - Составной элемент DataElement
phone Контактный телефон - +79123456789
email Адрес электронной почты - pochta@email.ru
birth_place Место рождения -  
address_info Адресные данные + Составной элемент AddressInfo
identity_doc_info Документ, удостоверяющий личность + Составной элемент PersonIdentityDocInfo
data_doc_empowered Документ, подтверждающий полномочия представителя + Составной элемент DocInfo
dop_info Дополнительная информация -  
dop_information Дополнительные сведения -  
Структура элемента AddressInfo
Параметр Описание Обязательное Пример
primary_address Адрес места проживания + Составной элемент DataElement
address_registration Адрес регистрации - Составной элемент Address
address_stay Адрес места жительства - Составной элемент Address
address_fact Адрес пребывания - Составной элемент Address
Структура элемента Address
Параметр Описание Обязательное Пример
full_address Полный адрес + г. Москва ул. Академика-Королева, 12 кв.43
index Индекс + 123123
region Регион + Составной элемент DataElement
area Район - Составной элемент DataElement
city Город - Составной элемент DataElement
city_area Городской район - Составной элемент DataElement
place Населенный пункт - Составной элемент DataElement
street Улица - Составной элемент DataElement
additional_area Дополнительная территория - Составной элемент DataElement
additional_street Улица дополнительной территории - Составной элемент DataElement
house Дом - Составной элемент DataElement
building1 Корпус -  
building2 Строение -  
apartment Квартира/помещение - 43
Структура элемента PersonIdentityDocInfo
Параметр Описание Обязательное Пример
type Наименование документа + Составной элемент DataElement
series Серия - 1234
number Номер + 123456
issue_date Дата выдачи + 2013-06-04
issuer Кем выдан - Отдел МВД Московской области
code_podr Код подразделения -  
Структура элемента DocInfo
Параметр Описание Обязательное Пример
type Тип документа + Составной элемент DataElement
series Серия -  
number Номер документа +  
issue_date Дата + 2020-01-05
issuer Орган, выдавший документ -  

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

Параметр Описание Обязательное Пример
lastname Фамилия + Иванова
firstname Имя + Яна
middlename Отчество - Ивановна
birthday Дата рождения + 1993-05-04
gender Пол. Принимает значения:
- Мужской
- Женский
- Женский
snils СНИЛС + 616-636-131 88
phone Контактный телефон - +79123456789
email Адрес электронной почты - pochta@email.ru
birth_place Место рождения - г. Москва
citizenship Гражданство - Составной элемент DataElement
address_info Адресные данные + Составной элемент AddressInfo
identity_doc_info Документ, удостоверяющий личность + Составной элемент PersonIdentityDocInfo
additional_information Дополнительная информация - Составной элемент AdditionalInformation
dop_info Дополнительная информация - Тест
dop_information Дополнительные сведения - Тест

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

Параметр Описание Обязательное Пример
related_connection Родственная связь по отношению к военнослужащему - Составной элемент DataElement
serviceman_appears_me Военнослужащий является мне - Составной элемент DataElement
receives_survivor_pension Получаю пенсию по случаю потери кормильца - false
been_disabled_since_childhood Являюсь инвалидом с детства (для детей старше 18 лет) - false
training_info Сведения об обучении - Составной элемент TrainingInfo
relation_info Данные об опеке - Составной элемент DocType
marriage_doc_act Данные о браке - Составной элемент DocType
category Категория заявителя - Составной элемент DataElement

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

Параметр Описание Обязательное Пример
studying_full_time Обучаюсь очно в общеобразовательной либо профессиональной образовательной организации, или образовательной организации высшего образования - true
state Статус - Составной элемент DataElement
form_training Форма обучения - Составной элемент DataElement
num_reference Номер справки -  
issue_date_reference Дата справки - 2020-05-30
issuer Кем выдана справка -  
name_addr_educational_institution Наименование и адрес учебного заведения -  
date_start Дата начала обучения - 2020-05-30
date_end Дата окончания обучения - 2020-05-30

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

Параметр Описание Обязательное Пример
number Номер +  
date Дата + 2020-05-30
issued Кем выдан +  

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

Параметр Описание Обязательное Пример
lastname Фамилия + Иванов
firstname Имя + Иван
middlename Отчество - Иванович
birthday Дата рождения + 1993-05-04
gender Пол. Принимает значения:
- Мужской
- Женский
- Мужской
snils СНИЛС + 616-636-131 88
citizenship Гражданство - Составной элемент DataElement
death Данные о смерти - Составной элемент DeathServiceman

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

Параметр Описание Обязательное Пример
deathday Дата смерти - 2015-09-02
number_act Номер акта - 53442
issue_date_act Дата акта - 2015-09-02
issuer Кем выдан - Составной элемент DataElement
died_military_service Погиб (умер) при исполнении обязанностей военной службы (вследствие военной травмы) - false

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

Параметр Описание Обязательное Пример
num_reference Номер справки - 75463524
issue_date_reference Дата выдачи справки - 2014-05-04
issuer Кем выдана справка - в\ч 03935242
date_start_service Дата начала службы - 2011-05-04
date_end_service Дата завершения службы - 2012-05-04
service_place Место службы - в\ч 03935242
type_service Тип службы - Составной элемент DataElement
citizen_missing_deceased_court Гражданин признан безвестно пропавшим или умершим в судебном порядке - false
date_start_period_missing Дата начала периода, в течение которого гражданин числился пропавшим без вести - 2012-05-04
date_end_period_missing Дата окончания периода, в течение которого гражданин числился пропавшим без вести - 2012-05-04
name_court Наименование суда - Наименование суда
date_decision Дата вынесения решения - 2012-05-04
case_num Номер дела - Номер дела
effective_date Дата вступления в законную силу - 2012-05-04
date_cancel_court_decision Дата отмены решения суда - 2012-05-04

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

Параметр Описание Обязательное Пример
radio Денежную выплату прошу выплачивать + Составной элемент DataElement
bank_info Данные кредитной организации -1 Составной элемент BankInfo
post_info Данные почтового отделения -1 Составной элемент PostInfo

1 - обязательно должен присутствовать только один из элементов

Структура элемента BankInfo
Параметр Описание Обязательное Пример
bank_name Наименование банка + БАНК ВТБ (ПАО)
bik БИК + 044525187
inn ИНН - 1231231231
kpp КПП банка - 320082573
account_number Номер банковского счета получателя + 12312312312312312312
card_number Номер банковской карты получателя -  
account_correspondent Номер корреспондентского счета -  
Структура элемента PostInfo
Параметр Описание Обязательное Пример
number_post Номер почтового отделения +  
subsidy_address Адрес получателя + Составной элемент Address

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

Параметр Описание Обязательное Пример
attr1 Дополнительный атрибут 1 - Составной элемент DataElement
attr2 Дополнительный атрибут 2 - Составной элемент DataElement
attr3 Дополнительный атрибут 3 - Составной элемент DataElement
attr4 Дополнительный атрибут 4 - Составной элемент DataElement
attr5 Дополнительный атрибут 5 - Составной элемент DataElement
attr6 Дополнительный атрибут 6 - Составной элемент DataElement
attr7 Дополнительный атрибут 7 - Составной элемент DataElement
attr8 Дополнительный атрибут 8 - Составной элемент DataElement
attr9 Дополнительный атрибут 9 - Составной элемент DataElement
attr10 Дополнительный атрибут 10 - Составной элемент DataElement
flag1 Дополнительный флаг 1 - false
flag2 Дополнительный флаг 2 - false
flag3 Дополнительный флаг 3 - true
flag4 Дополнительный флаг 4 - false
flag5 Дополнительный флаг 5 - false
flag6 Дополнительный флаг 6 - true
flag7 Дополнительный флаг 7 - false
flag8 Дополнительный флаг 8 - false
flag9 Дополнительный флаг 9 - false
flag10 Дополнительный флаг 10 - false
doc1 Дополнительный документ 1 - Составной элемент DocInfo
doc2 Дополнительный документ 2 - Составной элемент DocInfo
doc3 Дополнительный документ 3 - Составной элемент DocInfo
doc4 Дополнительный документ 4 - Составной элемент DocInfo
doc5 Дополнительный документ 5 - Составной элемент DocInfo
doc6 Дополнительный документ 6 - Составной элемент DocInfo
doc7 Дополнительный документ 7 - Составной элемент DocInfo
doc8 Дополнительный документ 8 - Составной элемент DocInfo
doc9 Дополнительный документ 9 - Составной элемент DocInfo
doc10 Дополнительный документ 10 - Составной элемент DocInfo

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

Параметр Описание Обязательное Пример
lastname Фамилия + Иванов
firstname Имя + Аркадий
middlename Отчество - Иванович
birthday Дата рождения + 2012-05-04
gender Пол - Мужской
snils СНИЛС + 081-604-568 57
citizenship Гражданство - Гражданство
relation Являюсь опекуном или родителем - Родитель
foreign_act_custody Опека установлена компетентным органом иностранного государства - false
foreign_birth_doc_act Регистрация осуществлена компетентным органом иностранного государства - false
birth_doc_act Сведения о рождении - Составной элемент DocType
identity_doc_info Данные документа, удостоверяющего личность - Составной элемент PersonIdentityDocInfo
birth_place Место рождения - Место рождения
receives_survivor_pension Получает пенсию по случаю потери кормильца - false
child_serviceman Кем является ребенку умерший (погибший) военнослужащий? - Составной элемент DataElement
been_disabled_since_childhood Являюсь инвалидом с детства - false
training_info Сведения об обучении - Составной элемент TrainingInfo
relation_info Данные об опеке - Составной элемент DocType
dop_info Дополнительная информация -  
dop_information Дополнительные сведения -  

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

Параметр Описание Обязательное Пример
order_id Номер заявления в ЛК ЕПГУ + 123123123
region_final Регион оказания услуги -  
department_id Ведомство, оказывающее услугу -  
service_id Номер услуги -  
territory_organ Орган социальной защиты - Составной элемент DataElement
current_date Дата подачи заявления + 2021-02-18
applicant_info Сведения о заявителе + Составной элемент PersonInfo
subsidies_info Способ получения выплаты + Составной элемент SubsidiesInfo
dop_info Дополнительная информация - Тест
dop_information Дополнительные сведения - Тест

Примеры

Пример запроса c данными на назначение выплаты (поле request в теле запроса):

{
  "oktmo": "00000000000",
  "delivery_type": "epgu",
  "data_request": {
    "additional_info": false,
    "order_id": "123123123",
    "current_date": "2022-05-04",
    "empowered_sign": false,
    "applicant_info": {
      "lastname": "Иванова",
      "firstname": "Яна",
      "middlename": "Ивановна",
      "birthday": "1993-05-04",
      "gender": "Женский",
      "snils": "616-636-131 88",
      "phone": "+79123456789",
      "email": "pochta@email.ru",
      "birth_place": "г. Москва",
      "address_info": {
        "primary_address": {
          "code": "1",
          "value": "Адрес регистрации"
        },
        "address_registration": {
          "full_address": "г. Москва ул. Академика-Королева, 12 кв.43",
          "index": "127427",
          "region": {
            "code": "fc5c5277-8b08-4d44-800e-9078b5fc42e1",
            "value": "г. Москва"
          },
          "city": {
            "code": "123",
            "value": "г. Москва"
          },
          "street": {
            "code": "123",
            "value": "Академика-Королева"
          },
          "house": {
            "code": "122",
            "value": "12"
          },
          "apartment": "43"
        }
      },
      "identity_doc_info": {
        "type": {
          "code": "01",
          "value": "Паспорт гражданина РФ"
        },
        "series": "1234",
        "number": "123456",
        "issue_date": "2013-06-04",
        "issuer": "Отдел МВД Московской области"
      },
      "additional_information": {
        "related_connection": {
          "code": "code127",
          "value": "relatedConnection0"
        },
        "serviceman_appears_me": {
          "code": "code129",
          "value": "servicemanAppearsMe0"
        },
        "receives_survivor_pension": false,
        "been_disabled_since_childhood": false,
        "training_info": {
          "studying_full_time": false,
          "state": {
            "code": "code131",
            "value": "state0"
          },
          "form_training": {
            "code": "code133",
            "value": "formTraining0"
          },
          "num_reference": "numReferen",
          "issue_date_reference": "2006-05-04",
          "issuer": "issuer3",
          "name_addr_educational_institution": "nameAddrEducationalInstitution0",
          "date_start": "2006-05-04",
          "date_end": "2006-05-04"
        },
        "relation_info": {
          "number": "number3",
          "date": "2006-05-04",
          "issued": "issued0"
        }
      }
    },
    "children_info": [
      {
        "lastname": "Иванов",
        "firstname": "Аркадий",
        "middlename": "Иванович",
        "birthday": "2012-05-04",
        "gender": "Мужской",
        "snils": "081-604-568 57",
        "relation": {
          "code": "1",
          "value": "Родитель"
        },
        "foreign_act_custody": false,
        "foreign_birth_doc_act": false,
        "birth_doc_act": {
          "number": "122321",
          "date": "2012-05-04",
          "issued": "Отдел Загс Московской области"
        },
        "receives_survivor_pension": false,
        "child_serviceman": {
          "code": "1",
          "value": "Родитель"
        },
        "training_info": {
          "studying_full_time": true,
          "state": {
            "code": "2",
            "value": "школьник"
          },
          "form_training": {
            "code": "1",
            "value": "очная"
          },
          "num_reference": "144342",
          "issue_date_reference": "2022-05-04",
          "issuer": "г. Москва гимназия №2",
          "name_addr_educational_institution": "г. Москва гимназия №2",
          "date_start": "2018-05-04",
          "date_end": "2029-05-04"
        }
      }
    ],
    "data_deceased_serviceman": {
      "lastname": "Иванов",
      "firstname": "Иван",
      "middlename": "Иванович",
      "birthday": "1993-05-04",
      "gender": "Мужской",
      "snils": "081-604-568 57",
      "death": {
        "deathday": "2013-05-04",
        "number_act": "53442",
        "issue_date_act": "2013-05-04",
        "issuer": {
          "code": "12321",
          "value": "Отдел Загс Московской области"
        },
        "died_military_service": false
      }
    },
    "data_military_service": {
      "num_reference": "75463524",
      "issue_date_reference": "2014-05-04",
      "issuer": \\ч 03935242",
      "date_start_service": "2011-05-04",
      "date_end_service": "2012-05-04",
      "service_place": \\ч 03935242",
      "type_service": {
        "code": "1",
        "value": "по призыву"
      },
      "citizen_missing_deceased_court": false
    },
    "subsidies_info": {
      "radio": {
        "code": "1",
        "value": "Через кредитную организацию"
      },
      "bank_info": {
        "bank_name": "БАНК ВТБ (ПАО)",
        "bik": "044525187",
        "account_number": "12312312312312312312"
      }
    }
  },
  "attachments": []
}

В случае получения запроса, содержащего данные для внесения изменений в способы получения выплаты, в request будет следующий json:

{
  "oktmo": "00000000000",
  "delivery_type": "epgu",
  "change_details_request": {
    "order_id": "123123123",
    "current_date": "2021-02-18",
    "applicant_info": {
      "lastname": "Иванова",
      "firstname": "Ирина",
      "middlename": "Ивановна",
      "birthday": "1987-08-13",
      "snils": "123-123-123 12",
      "birth_place": "г. Москва",
      "address_info": {
        "primary_address": {
          "code": "1",
          "value": "Адрес регистрации"
        },
        "address_registration": {
          "full_address": "г. Москва ул. Академика-Королева, 12 кв.43",
          "index": "127427",
          "region": {
            "code": "fc5c5277-8b08-4d44-800e-9078b5fc42e1",
            "value": "г. Москва"
          },
          "city": {
            "code": "123",
            "value": "г. Москва"
          },
          "street": {
            "code": "123",
            "value": "Академика-Королева"
          },
          "house": {
            "code": "122",
            "value": "12"
          },
          "apartment": "43"
        }
      },
      "identity_doc_info": {
        "type": {
          "code": "01",
          "value": "Паспорт гражданина РФ"
        },
        "series": "123",
        "number": "123123",
        "issue_date": "2017-08-13",
        "issuer": "Отдел МВД Московской области"
      }
    },
    "subsidies_info": {
      "radio": {
        "code": "1",
        "value": "Через кредитную организацию"
      },
      "bank_info": {
        "bank_name": "Тинькофф банк",
        "bik": "123123123",
        "account_number": "12312312312312312312"
      }
    }
  },
  "attachments": []
}

Пример ответа:

{
  "epgu_id": "123123123",
  "status_code": 3,
  "comment": "Заявление рассмотрено, пособие назначено."
}