ЕПГУ-услуга Сведения из справки о доходах физического лица по форме 2-НДФЛ.
| Атрибут | Значение | |
|---|---|---|
| Название | epgu-ndfl2 | |
| Наименование 1 | Сведения из справки о доходах физического лица по форме 2-НДФЛ | |
| Наименование 2 | Получение государственной или муниципальной услуги для указанного пользователя или организации по инициативе третьей стороны (интеграционный модуль) | |
| Идентификаторы | serviceFormCode: 10000079172 serviceCode: -1348711933 | |
| Область применения | Межведомственное взаимодействие | |
| Версия | 1.0.1 | |
| Версия МР | 3.0 | |
| Версия СМЭВ | СМЭВ3 | |
| Доп. информация | Адаптер для услуги через модуль ЕПГУ(СМЭВ3) |
Сервис работает через адаптер "интеграционный модуль" в СМЭВ 3.
Общее описание и документация: https://partners.gosuslugi.ru/catalog/integration_module
Описание конкретных сервисов: https://gu-st.ru/content/partners/Opisanie%20parametrov%20zaprosa%20dlya%20IM.docx
Переменные окружения
| Название | Описание |
|---|---|
| EPGU_SERVICE | название ЕПГУ сервиса, на который будут отправляться запросы |
Переменные для конфигурирования подключения к БД и RabbitMq:
DATABASE_URL, CA_CERT, CLIENT_CERT, CLIENT_KEY, MQ_HOST, MQ_PORT
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
Полное описание параметров можно посмотреть в документации к сервису "Адаптер для работы с ЕПГУ через СМЭВ3".
Используется запрос на получение государственной или муниципальной услуги для указанной организации по инициативе третьей стороны
Запрос
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| routing_code | Код маршрутизации на ЕПГУ среду | - | DEV |
| confirm_type | Тип подтверждения | - | SMS |
| service_form_code | Идентификатор электронной формы услуги на ЕПГУ | - | 10000079172 |
| service_code | Идентификатор цели обращения услуги по ФРГУ | - | -1348711933 |
| author | Данные сотрудника-инициатора для поиска его в ЕСИА | + 1 | Сложный тип Person. |
| signer | Данные сотрудника-подписанта для поиска его в ЕСИА | + 2 | Сложный тип Person. |
| draft | Форма заявления | + | Сложный тип Draft |
| organization | Данные организации | - | Сложный тип Org |
Заполняется, если требуется сформировать заявление в ЛК сотрудника-инициатора организации.
Сотрудником-инциатором могут быть:
- руководитель указанной организации;
- сотрудник указанной организации, которому делегированы полномочия на подачу услуги;
- сотрудник указанной организации, включенный в группу доступа ЕСИА «Уполномоченный на создание черновиков заявления»;
Обязательно для заполнения, если заполнено поле author. Заполняется, если требуется сформировать заявление в ЛК сотрудника-подписанта организации.
Сотрудником-подписантом могут быть:
- руководитель указанной организации;
- сотрудник указанной организации, которому делегированы полномочия на подачу услуги;
Если сотрудник-подписант и сотрудник-инициатор является руководителем организации, то данные дублируются в поле author и signer
Структура элемента Person
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| snils | СНИЛС пользователя | - | 000-000-000 03 |
| first_name | Имя пользователя | + | Имя |
| last_name | Фамилия пользователя | + | Фамилия |
| second_name | Отчество пользователя | - | Отчество |
| bdate | Дата рождения | + | 2014-09-19 |
| phone | Номер мобильного телефона пользователя | + | +7 (912) 123-22-11 |
| passport | Паспорт гражданина РФ | + | Сложный тип Passport |
Структура элемента Passport
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| series | Серия документа | + | 22 33 |
| num | Номер документа | + | 112233 |
| issue_date | Код подразделения | + | 2008-09-29 |
| issue_code | Дата выдачи документа | + | 123-123 |
Структура элемента Org
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| ogrn | ОГРН организации | + | 0001234000009 |
| inn | ИНН организации | + | 3905074565 |
Структура элемента Draft
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| version | Версия формы услуги для интеграционного модуля | + | 1 |
| fields | Массив полей формы | + | Сложный тип Field |
Структура элемента Field
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| code | Код параметра формы | + | form.FormStep4.Panel1_FL.Panel1.Fias_0 |
| content | Массив частей параметра | + | Сложный тип Part |
Структура элемента Part
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| value | Значение параметра или его части | + | 465456, г. Москва, р-н. Внуковское, г. Москва, пр-кт. Андропова, д. 6, к. 1, стр. 5, кв. 45 |
| order_number | Порядок части параметра | + | 0 |
Для данного сервиса требуется передать в Draft следующие поля
| Код параметра формы | Описание | Обязательное | Значение параметра или его части |
|---|---|---|---|
| Form.ApplicantStep.ApplicantPanel.INNPanel.INN | ИНН гражданина в формате text_value:{значение} | + | text_value:123456789012 |
| Form.ApplicantStep.ApplicantPanel.YearListPanel.YearList | Отчетные года в формате text_value:{значение}. Может быть указано несколько элементов Part в content для данного поля | + | text_value:2018 |
| Form.ServiceStep.ServicePanel.OKTMO | Код идентификатора территории ОКТМО в формате value:{значение}. Должно быть передано значение, соответствующее местонахождению пользователя. Если его определить невозможно, то этот параметр может содержать значение value:00000000 | + | value:20701000 |
Параметры ответа
Параметры ответа совпадают с ответом сервису "Адаптер для работы с ЕПГУ через СМЭВ3".
Ответ зависит от конкретного сервиса. Описание находится тут: https://gu-st.ru/content/partners/Opisanie%20parametrov%20zaprosa%20dlya%20IM.docx
Примеры
Запрос
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"author": {
"firstName": "Имя",
"lastName": "Фамилия",
"secondName": "Отчество",
"bdate": "1989-03-20",
"passport": {
"series": "00 00",
"num": "000000",
"issueDate": "2014-08-13",
"issueCode": "360-037"
},
"phone": "+7 (900) 000-00-00"
},
"signer": {
"firstName": "Имя",
"lastName": "Фамилия",
"secondName": "Отчество",
"bdate": "1997-08-08",
"passport": {
"series": "00 00",
"num": "000696",
"issueDate": "2000-11-11",
"issueCode": "123-312"
},
"phone": "+7 (900) 000-00-00"
},
"organization": { "ogrn": "0001234000009", "inn": "3905074565" },
"serviceFormCode": "10000079172",
"serviceCode": "-1348711933",
"draft": {
"version": "1",
"fields": [
{
"code": "Form.ApplicantStep.ApplicantPanel.YearListPanel.YearList",
"content": [
{
"value": "text_value:2018",
"orderNumber": "0"
}
]
},
{
"code": "Form.ApplicantStep.ApplicantPanel.INNPanel.INN",
"content": [
{
"value": "text_value:123456789012",
"orderNumber": "0"
}
]
},
{
"code": "Form.ServiceStep.ServicePanel.OKTMO",
"content": [
{
"value": "value:20701000",
"orderNumber": "0"
}
]
}
]
}
}
В случае корректной настройки должен прийти следующий ответ:
{
"id": "1",
"statusCode": "NEW",
"limit": {
"day": "1000",
"month": "10000",
"total": "1000000"
},
"stat": {
"day": "5",
"month": "166",
"total": "1626"
},
"errorStatusInfo": {
"Code": "0",
"Message": "OK"
}
}