Сценарии использования Информационная система -потребитель (ИС ФОИВ) вызывает сервис и передает системе-провайдеру (ИС ФНС России) запрос на получение сведений из декларации 3-НДФЛ.
Электронный сервис используется в режиме атомарного изменения
Взаимодействие в этом режиме реализовано по асинхронной схеме:
Метод sendReguest
Передача вызывающей стороной запроса в виде XML документа по схеме WS_NDFL3_2_210_10_04_01_01.xsd, содержащей идентификационные характеристики ФЛ, по которому необходимо предоставить сведения из декларации 3-НДФЛ.
Прием отвечающей стороной (ИС ФНС России) поступившего запроса
В случае отсутствия ошибок в полученном запросе отвечающей стороной передается ответ в виде XML документа по схеме WS_ NDFL3_2_210_11_04_01_01.xsd, содержащего идентификатор запроса, сформированный ФНС или Сведения об обработке запроса с кодом обработки = 99, означающий системную ошибку.
Метод getResponse - получение вызывающей стороной результата на запрос о предоставлении сведений из деклараций 3-НДФЛ. Вызывается при организации взаимодействия по асинхронной схеме в соответствии с установленным регламентом (по полученному ранее методом sendReguest идентификатору запроса).
Передача вызывающей стороной идентификатора запроса в виде XML документа по схеме WS_NDFL3_2_210_12_04_01_01.xsd, содержащего Идентификатор запроса, сформированный ФНС.
В случае успешного выполнения запроса отвечающей стороной осуществляется передача ответа в виде XML документа по схеме WS_NDFL3_2_210_13_04_01_01.xsd., содержащего сведения из декларации 3-НДФЛ (СвНДФЛ3).
В случае не выполнения запроса отвечающей стороной осуществляется передача сообщения в виде XML документа по схеме WS_NDFL3_2_210_13_04_01_01.xsd, содержащего Сведения об обработке запроса с кодами обработки, принимающие следующие значения:
01 – запрашиваемые сведения не найдены;
02 – запрашиваемое ФЛ не является предпринимателем;
52 – ответ не готов;
83 – отсутствует запрос с указанным идентификатором запроса и видом запрошенных сведений от данного органа ;
99 – системная ошибка. Схема взаимодействия
В рамках взаимодействия системы-потребителя (ИС ФОИВ) с системой-провайдером (ИС ФНС России) для получения сведений из декларации 3-НДФЛ в асинхронном режиме участвуют следующие типы сообщений:
- запрос на получение сведений из декларации 3-НДФЛ;
- ответ на запрос на получение сведений из декларации 3-НДФЛ, содержащий идентификатор запроса, присвоенный запросу на стороне системы-провайдера (в случае успешного поиска, элемент ИдЗапросФ xml-ответа), либо код результата обработки (элемент КодОбр xml-ответа);
- повторный запрос на получение результата запроса на получение сведений из декларации 3-НДФЛ по полученному ранее идентификатору запроса;
- ответ на повторный запрос на получение сведений из декларации о доходах физических лиц по форме 3-НДФЛ, содержащий сведения из декларации 3-НДФЛ (СвНДФЛ3) либо код результата обработки.
Схема взаимодействия при получении сведений из декларации 3-НДФЛ представлена на рисунке 1.
Рисунок 1 «Схема взаимодействия при получении
сведений из декларации 3-НДФЛ»
Связи с другими электронными сервисами Данный сервис не имеет связей с другими сервисами.
Руководство пользователя Операция «Передача запроса на получение сведений из декларации 3-НДФЛ» Общие сведения Код операции:
| sendReguest
| Наименование операции:
| Передача запроса на получение сведений из декларации 3-НДФЛ
| Назначение операции:
| Операция предназначена для передачи запроса на получение сведений из декларации 3-НДФЛ и получения результата (идентификатора запроса либо кода результата обработки).
| Описание входных параметров Входные данные: XML документ по схеме WS_NDFL3_2_210_10_04_01_01.xsd
№
| Код параметра
| Описание параметра
| Обязательность
| Способ заполнения/Тип
| Комментарий
| 1
| ВерсФорм
| Версия формата
| +
| xs:string
| До 5 символов
| 2
| ИдЗапросП
| Идентификатор запроса, сформированный запрашивающей стороной
| -
| xs:string
| До 36 символов
| 3
| ОтчетГод
| Отчетный налоговый период
| +
| xs:gYear
|
| 4
| ФИОФЛ
| Фамилия, имя, отчество физического лица
| +
| ФИОТип
| До 60 символов
| 5
| ИННФЛ│ КодВидДок
СерНомДок
| ИНН физического лица Код вида документа, удостоверяющего личность Серия и номер документа
| +
| ИННФЛТип
СПДУЛТип
xs:string
| 12 символов
2 символа
До 25 символов
| 6
| ДатаРожд
| Дата рождения
| +
| ДатаТип
| 10 символов
| Примечание: В случае, если не указан ИНН, поиск данных осуществляется по тому документу, удостоверяющему личность, с которым подавалась декларация, без учета изменения паспорта. Поэтому, для получения достоверных сведений необходимо указание в запросе ИНН. Описание выходных параметров Выходные данные: XML документ по схеме WS_ NDFL3_2_210_11_04_01_01.xsd
№
| Код параметра
| Описание параметра
| Обязательность
| Способ заполнения/Тип
| Комментарий
| 1
| ВерсФорм
| Версия формата
| +
| xs:string
| До 5 символов
| 2
| ИдЗапросФ
| Идентификатор запроса, сформированный ФНС
| +
| xs:integer
| До 20 символов
| 3
| КодОбр
| Код обработки
| +
| xs:string
| 2 символа
|
Коды возвратов №
| Код возврата
| Описание кода возврата
| Условия возникновения
| Комментарий
| 1
| 99
| Системная ошибка
| Возникает при наличии внутренних ошибок в ПО ИС ФНС России
|
|
|