Сервис предоставления Сведений из декларации о доходах физических лиц 3-НДФЛ

Федеральная налоговая служба
ОПИСАНИЕ ФОРМАТА ЭЛЕКТРОННОГО СЕРВИСА СМЭВ
И
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
ЭЛЕКТРОННОГО СЕРВИСА СМЭВ
Сервис предоставления Сведений из декларации о
доходах физических лиц 3-НДФЛ
Дата: 26.03.2013
Версия: 1.2
Листов: 44.
1
АННОТАЦИЯ
Данный документ является руководством пользователя электронного сервиса
предоставления по запросам органов исполнительной власти сведений из декларации о
доходах физических лиц 3-НДФЛ, которое в соответствии с п. 48 Приказа Министерства
связи и массовых коммуникаций Российской Федерации от 27 декабря 2010 г. № 190 «Об
утверждении технических требований к взаимодействию информационных систем в единой
системе межведомственного электронного взаимодействия» является обязательным для
предоставления Поставщиком в адрес Оператора СМЭВ.
2
СОДЕРЖАНИЕ
ОБЩИЕ СВЕДЕНИЯ...................................................................................................................... 5
1.1 Руководящие документы ............................................................................................................5
1.2 Описание электронного сервиса ...............................................................................................5
1.3 Операции (методы) электронного сервиса ...............................................................................6
1.4 Сценарии использования ...........................................................................................................6
1.5 Связи с другими электронными сервисами..............................................................................8
2
РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ ............................................................................................ 8
2.1 Операция «Передача запроса на получение сведений из декларации 3-НДФЛ» .................8
2.1.1 Общие сведения ...................................................................................................................8
2.1.2 Описание входных параметров ..........................................................................................8
1
2.1.3 Описание выходных параметров ........................................................................................9
2.1.4 Коды возвратов ..................................................................................................................10
2.2 Операция «Получение результата обработки запроса на получение сведений из
декларации 3-НДФЛ» .....................................................................................................................10
2.2.1 Общие сведения .................................................................................................................10
2.2.2 Описание входных параметров ........................................................................................10
2.2.3 Описание выходных параметров ......................................................................................10
2.2.4 Коды возвратов ..................................................................................................................14
2.3 Контрольные примеры .............................................................................................................14
2.3.1 Запрашивается ФЛ с ИНН, данные найдены ..................................................................14
2.3.2 Запрашивается ФЛ без ИНН, данные найдены ...............................................................15
2.3.3 Запрашивается ФЛ с ИНН, данные не найдены (код возврата 01). ..............................15
3
МЕТОДИКА ИСПЫТАНИЙ ....................................................................................................... 17
3.1 Общие условия ..........................................................................................................................17
3.2 Параметры испытаний на продуктивной среде .....................................................................17
3.3 Особые условия .........................................................................................................................18
4
ПРИЛОЖЕНИЯ ............................................................................................................................ 18
4.1 Описание сервиса (WSDL) .......................................................................................................18
4.2 Описание общих структур данных .........................................................................................20
4.3 Описания справочников ...........................................................................................................24
4.4 Иные приложения .....................................................................................................................25
3
ИЗМЕНЕНИЯ
Версия
Дата
Автор
Изменения
1.0
1.0
01.02.2012
29.02.2012
Чудакова Е.Ю.
Чудакова Е.Ю.
1.1
15.11.2012
Сулим Е.И.
1.2
26.03.2013
Чудакова Е.Ю.
Исходный документ
Документ дополнен контрольными примерами,
методикой испытаний, приложениями
Обновлены контрольные примеры в связи с
выпуском новой тестовой ЭЦП
Внесены дополнительные комментарии в
Назначение сервиса (п.1.2) и примечание в
п.2.1.2
ТЕРМИНЫ/СОКРАЩЕНИЯ
Термин/сокращение
СМЭВ
Поставщик
WSDL
XSD
SOAP
XML
ИНН
ФЛ
ЭП
ФНС России
НО
РФ
Описание
Система межведомственного электронного взаимодействия
Организация-владелец электронного сервиса
Web Services Description Language — язык описания веб-сервисов.
XML Schema definition - язык описания структуры XML
документа.
Simple
Object
Access
Protocol
протокол
обмена
структурированными
сообщениями
в
распределённой
вычислительной среде.
eXtensible Markup Language — расширяемый язык разметки.
Идентификационный номер налогоплательщика
Физическое лицо
Электронная подпись
Федеральная налоговая служба
Налоговый орган
Российская Федерация
4
1 ОБЩИЕ СВЕДЕНИЯ
1.1 Руководящие документы
Основанием для разработки данного документа является требование п. 48 Приказа
Министерства связи и массовых коммуникаций Российской Федерации от 27 декабря 2010
г. № 190 «Об утверждении технических требований к взаимодействию информационных
систем в единой системе межведомственного электронного взаимодействия» в соответствии с
которым, для подключения информационной системы к системе межведомственного
электронного взаимодействия Поставщик предоставляет Оператору СМЭВ следующие
документы:
- паспорт электронного сервиса, регистрируемого в системе взаимодействия;
- методику испытаний электронного сервиса, регистрируемого в системе
взаимодействия, включая контрольные примеры обращения к электронному сервису;
- руководство пользователя электронного сервиса, регистрируемого в системе
взаимодействия.
Основанием для создания
перечисленные ниже документы.
и
использования
электронного
сервиса
являются
Нормативно-правовые документы:
- Постановление Правительства Российской Федерации от 8 сентября 2010 г. № 697
«О единой системе межведомственного электронного взаимодействия»;
- Приказ Министерства связи и массовых коммуникаций Российской Федерации от 27
декабря 2010 г. № 190 «Об утверждении технических требований к взаимодействию
информационных систем в единой системе межведомственного электронного
взаимодействия»;
- Распоряжение Правительства Российской Федерации от 17.03.2011 № 442-р.
1.2 Описание электронного сервиса
Наименование:
Предоставление сведений из декларации о доходах физических лиц 3НДФЛ
Назначение:
Сервис
предназначен
для
предоставления
по
запросам
органов
исполнительной власти сведений из декларации о доходах физических лиц
3-НДФЛ, в рамках единой системы межведомственного электронного
взаимодействия (СМЭВ). Данный сервис не предназначен для
предоставления сведений о доходах физических лиц, не являющихся
индивидуальными предпринимателями, адвокатами и другими
лицами, занимающимися частной практикой.
Поставщик:
Федеральная налоговая служба.
Область
Межведомственное взаимодействие.
5
применения:
1.3 Операции (методы) электронного сервиса
Электронный сервис предоставления сведений из декларации о доходах физических
лиц 3-НДФЛ, обеспечивает обмен данными между системами-потребителями (ИС ФОИВ) и
системой-провайдером (ИС ФНС России).
Электронный сервис включает методы, обеспечивающие:
- передачу запроса на получение сведений из декларации о доходах физических лиц 3НДФЛ;
- получение ответа с результатом обработки запроса на получение сведений из
декларации о доходах физических лиц 3-НДФЛ.
Метод
Назначение
Передача запроса на получение сведений из
Код: sendReguest
Наименование:
передача
запроса
на декларации о доходах физических лиц 3получение сведений из декларации о доходах НДФЛ
физических лиц 3-НДФЛ
Код: getResponse
Получение результата обработки запроса на
Наименование: получение сведений из получение сведений из деклараций 3-НДФЛ
декларации о доходах физических лиц 3НДФЛ
1.4 Сценарии использования
Информационная система -потребитель (ИС ФОИВ) вызывает сервис и передает
системе-провайдеру (ИС ФНС России) запрос на получение сведений из декларации 3-НДФЛ.
Электронный сервис используется в режиме атомарного изменения
Взаимодействие в этом режиме реализовано по асинхронной схеме:
1. Метод sendReguest
1.1. Передача вызывающей стороной запроса в виде XML документа по схеме
WS_NDFL3_2_210_10_04_01_01.xsd,
содержащей
идентификационные
характеристики ФЛ, по которому необходимо предоставить сведения из декларации
3-НДФЛ.
1.2. Прием отвечающей стороной (ИС ФНС России) поступившего запроса
1.3. В случае отсутствия ошибок в полученном запросе отвечающей стороной
передается
ответ
в
виде
XML
документа
по
схеме
WS_
NDFL3_2_210_11_04_01_01.xsd,
содержащего
идентификатор
запроса,
сформированный ФНС или Сведения об обработке запроса с кодом обработки = 99,
означающий системную ошибку.
6
2. Метод getResponse - получение вызывающей стороной результата на запрос о
предоставлении сведений из деклараций 3-НДФЛ. Вызывается при организации
взаимодействия по асинхронной схеме в соответствии с установленным
регламентом (по полученному ранее методом sendReguest идентификатору запроса).
2.1. Передача вызывающей стороной идентификатора запроса в виде XML
документа
по
схеме
WS_NDFL3_2_210_12_04_01_01.xsd,
содержащего
Идентификатор запроса, сформированный ФНС.
2.2. В случае успешного выполнения запроса отвечающей стороной
осуществляется передача ответа в виде XML документа по схеме
WS_NDFL3_2_210_13_04_01_01.xsd., содержащего сведения из декларации 3НДФЛ (СвНДФЛ3).
2.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.
7
Процесс информационного взаимодействия при направлении запроса
Система-потребитель
Система-провайдер
Формирование
первичного запроса
Передача запроса
(WS_NDFL3_2_210_10_04_01_01.xsd)
Передача ответа (id запроса)
(WS_NDFL3_2_210_11_04_01_01.xsd)
Прием данных,
формирование ответа c
ID или передача кода
обработки
Формирование
повторного запроса
Передача запроса по полученному ID
(WS_NDFL3_2_210_12_01_01.xsd)
Передача ответа со сведениями
(WS_NDFL3_2_210_13_04_01_01.xsd)
Формирование ответа
на запрос по
переданному
идентификатору
Рисунок 1 «Схема взаимодействия при получении
сведений из декларации 3-НДФЛ»
1.5 Связи с другими электронными сервисами
Данный сервис не имеет связей с другими сервисами.
2 РУКОВОДСТВО ПОЛЬЗОВАТЕЛЯ
2.1 Операция «Передача запроса на получение сведений из декларации 3НДФЛ»
2.1.1 Общие сведения
Код операции:
sendReguest
Наименование
операции:
Передача запроса на получение сведений из декларации 3-НДФЛ
Назначение операции:
Операция предназначена для передачи запроса на получение
сведений из декларации 3-НДФЛ и получения результата
(идентификатора запроса либо кода результата обработки).
2.1.2 Описание входных параметров
Входные данные: XML документ по схеме WS_NDFL3_2_210_10_04_01_01.xsd
8
№
1
Код параметра
ВерсФорм
ИдЗапросП
2
3
ОтчетГод
ФИОФЛ
4
ИННФЛ│
Версия формата
Идентификатор
запроса,
сформированный
запрашивающей
стороной
Отчетный
налоговый период
Фамилия,
имя,
отчество
физического лица
ИНН физического
лица
КодВидДок
Код вида документа,
удостоверяющего
личность
СерНомДок
Серия
и
документа
5
6
Описание
параметра
ДатаРожд
Обязат
Способ
ельност
заполнения/Тип
ь
До 5 символов
До 36 символов
+
-
xs:string
xs:string
+
xs:gYear
+
ФИОТип
До 60 символов
+
ИННФЛТип
12 символов
СПДУЛТип
2 символа
xs:string
До 25 символов
ДатаТип
10 символов
номер
Дата рождения
Комментарий
+
Примечание: В случае, если не указан ИНН, поиск данных осуществляется по тому
документу, удостоверяющему личность, с которым подавалась декларация, без учета
изменения паспорта. Поэтому, для получения достоверных сведений необходимо указание в
запросе ИНН.
2.1.3 Описание выходных параметров
Выходные данные: XML документ по схеме WS_ NDFL3_2_210_11_04_01_01.xsd
№
1
Код параметра
ВерсФорм
ИдЗапросФ
2
3
КодОбр
Описание
параметра
Версия формата
Идентификатор
запроса,
сформированный
ФНС
Код обработки
Обязатель
ность
Способ
заполнения/
Тип
Комментарий
+
+
xs:string
xs:integer
До 5 символов
До 20 символов
+
xs:string
2 символа
9
2.1.4 Коды возвратов
№
1
Код возврата
99
Описание кода
возврата
Системная ошибка
Условия
возникновения
Комментарий
Возникает при наличии
внутренних ошибок в
ПО ИС ФНС России
2.2 Операция «Получение результата обработки запроса на получение
сведений из декларации 3-НДФЛ»
2.2.1 Общие сведения
Код операции:
getResponse
Наименование
операции:
Получение результата обработки запроса на получение сведений
из декларации 3-НДФЛ
Назначение операции:
Операция предназначена для передачи идентификатора запроса
сведений из декларации 3-НДФЛ либо кода результата обработки).
2.2.2 Описание входных параметров
Входные данные: XML документ по схеме WS_NDFL3_2_210_12_04_01_01.xsd
№
1
Код параметра
ВерсФорм
ИдЗапросФ
2
Описание
параметра
Версия формата
Идентификатор
запроса,
сформированный
ФНС
Обязатель
ность
+
+
Способ
заполнения/
Тип
xs:string
xs:integer
Комментарий
До 5 символов
До 20 символов
2.2.3 Описание выходных параметров
Выходные данные: XML документ по схеме WS_NDFL3_2_210_13_04_01_01.xsd
№
1
Код параметра
ВерсФорм
ИдЗапросФ
2
3
СвНДФЛ3|
Описание
параметра
Версия формата
Идентификатор
запроса,
сформированный
ФНС
Сведения по
Обязатель
ность
+
+
+
Способ
заполнения/
Тип
xs:string
xs:integer
Комментарий
До 5 символов
До 20 символов
Состоит
из
10
КодОбр
4
ОтчетГод
СвФЛ
5
ИтогУплВозв
6
ФИОФЛ
7
СвАдрРФ
8
представленной
физическим лицом
налоговой
декларации по
налогу на доходы
физических лиц (по
форме 3-НДФЛ) |
элементов:
ОтчетГод,
СвФЛ,
ИтогУплВозв
Код обработки
Принимает
значение:
01 – запрашиваемые
сведения не найдены
│
02–запрашиваемое
ФЛ не является
предпринимателем
│
52 – ответ не готов │
83 – отсутствует
запрос с указанным
идентификатором
запроса и видом
запрошенных
сведений от данного
органа │
99
–
системная
ошибка
+
Отчетный
налоговый период
Сведения
о +
физическом
лице,
представившем
налоговую
декларацию
по
налогу на доходы
ФЛ (по форме 3НДФЛ)
Данные налоговой +
декларации
по
налогу на доходы
физических лиц (по
форме 3-НДФЛ
xs:gYear
Фамилия,
имя, +
отчество
физического лица
Сведения об адресе +
места
жительства
(места пребывания)
ФИОТип
Состоит
из
элементов:
ФИОФЛ, СвАдрРФ,
ИННФЛ│СведФЛ
Состоит
элементов:
НалБаза13,
НалБаза30,
НалБаза35,
НалБаза9,
НалБаза15,
СведДохВыч
из
Состоит
элементов:
ПрАдр, АдрРФ
из
11
ПрАдр
налогоплательщика
в РФ
Признак
адреса +
налогоплательщика
xs:string
9
АдрРФ
10
ИННФЛ│
СведФЛ
13
АдрРФТип
ИННФЛТип
12 символов
Сведения о ФЛ (при
отсутствии
ИНН
ФЛ)
ДатаРожд
Дата рождения
+
ДатаТип
Состоит
из
элементов:
ДатаРожд,
МестоРожд, УдЛичн
10 символов
МестоРожд
Место рождения
+
xs:string
До 128 символов
УдЛичн
Сведения
о +
документе,
удостоверяющем
личность
физического лица
Код вида документа, +
удостоверяющего
личность
УдЛичнФЛК Состоит
Тип
элементов:
КодВидДок,
СерНомДок
Серия
и
номер +
документа
Расчет
налоговой базы и суммы налога
xs:string
11
12
+
Адрес
налогоплательщика
в
Российской
Федерации
ИНН физического +
лица │
14
КодВидДок
СПДУЛТип
15
16
17
1 символ
Принимает
значение:
1 – адрес места
жительства в
Российской
Федерации |
2 – адрес места
пребывания
в
Российской
Федерации
СерНомДок
НалБаза13
из
2 символа
Принимает значение
в соответствии со
Справочником
«Коды документов»
из приложения №2 к
Порядку заполнения
формы
налоговой
декларации
по
налогу на доходы
ФЛ, утвержденному
приказом
ФНС
России от 10.11.2011
№ ММВ-7-3/760@
До 25 символов
Состоит
элементов:
из
12
НалБаза30
18
НалБаза35
19
НалБаза9
20
НалБаза15
21
22
23
ДоходОбщ
НалБаза
ДоходПредпр
24
25
ДоходИт
РасчВидДеят
26
КодВД
27
по
доходам,
облагаемым
по
ставке 13 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 30 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 35 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 9 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 15 %
Общая сумма дохода
Налоговая база
Доходы, полученные
от
предпринимательско
й
деятельности,
адвокатской
деятельности
и
частной
практики
(В)
Итоговая
общая
сумма дохода
Показатели,
используемые
для
расчёта налоговой
базы и суммы налога
по
виду
деятельности
Код
вида
деятельности
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
+
+
-
xs:decimal
xs:decimal
До 17 символов
До 17 символов
Состоит
из
элементов: ДоходИт
и РасчВидДеят
+
xs:decimal
До 17 символов
Состоит
из
элементов:
КодВД,
ОКВЭД,
Доход
+
+
xs:string
Равно 1
Принимает
значение:
1–
предпринимательска
я деятельность |
2 – нотариальная
деятельность |
3 – адвокатская
деятельность |
4
–
иная
13
ОКВЭД
Код
вида предпринимательско
й деятельности
ОКВЭДТип
Доход
Сумма дохода
xs:decimal
28
29
30
+
деятельность
До 8 символов
Принимает значение
в соответствии с
Общероссийским
классификатором
видов
экономической
деятельности
До 17 символов
2.2.4 Коды возвратов
№
Код возврата
1
01
2
02
3
52
4
83
5
99
Описание кода
возврата
Условия возникновения
Комментарий
Возникает при условии, если
данные о налогоплательщике
в запрашиваемом налоговом
периоде отсутствуют
Возникает при условии, если
значение реквизита «Код
Запрашиваемое
категории
ФЛ не является
налогоплательщика»
в
предпринимате
декларации 3-НДФЛ ФЛ,
лем
указанного в запросе, равно
760
Возникает при условии, что
Ответ не готов
ответ не готов
Отсутствует
запрос
с
Возникает при условии, что
указанным
запрос
с
указанным
идентификатор
идентификатором запроса и
ом запроса и
видом
запрошенных
видом
сведений от данного органа
запрошенных
не найден
сведений
от
данного органа
Возникает
при
наличии
Системная
внутренних ошибок в ПО ИС
ошибка
ФНС России
Запрашиваемые
сведения не
найдены
2.3 Контрольные примеры
2.3.1 Запрашивается ФЛ с ИНН, данные найдены
Запрос
sig_sendRequest_Àáàêóìîâ.xml
14
Получение ответа с идентификатором запроса:
sig_sendRequest_Àáàêóìîâ_response.xml
Передача запроса с полученным идентификатором:
sig_getResponse_Àáàêóìîâ.xml
Получение ответа с данными декларации:
sig_getResponse_Àáàêóìîâ_response.xml
2.3.2 Запрашивается ФЛ без ИНН, данные найдены
Запрос
sig_sendRequest_Ñòèêîâà.xml
Получение ответа с идентификатором запроса:
sig_sendRequest_Ñòèêîâà_response.xml
Передача запроса с полученным идентификатором:
sig_getResponse_Ñòèêîâà.xml
Получение ответа с данными декларации:
sig_getResponse_Ñòèêîâà_response.xml
2.3.3 Запрашивается ФЛ с ИНН, данные не найдены (код возврата 01).
Запрос:
sig_sendRequest_Èâàíîâ.xml
Получение ответа с идентификатором запроса:
sig_sendRequest_Иванов_response.xml
15
Передача запроса с полученным идентификатором:
sig_getResponse_Èâàíîâ.xml
Ответ на запрос с кодом возврата 01 (запрашиваемые сведения не найдены):
sig_getResponse_Èâàíîâ_response.xml
16
3 МЕТОДИКА ИСПЫТАНИЙ
3.1 Общие условия
Проведение контрольных испытаний при регистрации электронного сервиса
регламентировано Приказом Министерства связи и массовых коммуникаций Российской
Федерации от 27 декабря 2010 г. № 190 «Об утверждении технических требований к
взаимодействию информационных систем в единой системе межведомственного электронного
взаимодействия».
Порядок проведения типовых испытаний предполагает следующие этапы:
Проверка комплектности предоставленной документации;
Проверка сетевой связности между узлом СМЭВ и точкой размещения электронного
сервиса;
Регистрация сервиса и тестирование сервиса на контрольном примере.
[Параметры испытаний на тестовой среде
Проведение испытаний на тестовой среде перед регистрацией электронного сервиса в
продуктивной среде СМЭВ является необходимым действием, обеспечивающим повышение
качества и эффективности процесса и позволяющим выявлять ошибки и несоответствия
разработанного сервиса заранее, а не в продуктивном контуре.
Контактное лицо: Актиев Фират Фаисович, e-mail: firat@unisoftware.ru,
тел. 8 (347) 293 49 89.
-Адрес тестового экземпляра: http://94.125.90.50:6336/FNS3NDFLWS?wsdl.
- Режим функционирования тестовой среды: 8/256. Особых условий доступности не
определено.
Для того чтоб протестировать сервис, необходимо:
- зарегистрировать сервис на тестовой среде во время ее доступности согласно
режиму функционирования;
- протестировать все операции на основании контрольных примеров, приведенных в
разделе 2.3.

3.2 Параметры испытаний на продуктивной среде
Для проведения испытаний на продуктивной среде СМЭВ:
- Контактное лицо: Сулим Евгения Игоревна, e-mail: smev@nalog.ru,
тел: +7(495)913-0000 доб. 32-02.
- Адрес тестового экземпляра:
http://188.254.16.92:7777/gateway/services/SID0003136?wsdl.
Для того чтоб протестировать сервис, необходимо:
17
- зарегистрировать сервис на продуктивной среде во время ее доступности согласно
режиму функционирования;
- протестировать все операции на основании контрольных примеров, приведенных в
разделах 2.3.
3.3 Особые условия
Особые условия и правила проведения контрольных испытаний не предусмотрены.
4 ПРИЛОЖЕНИЯ
4.1 Описание сервиса (WSDL)
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:smev="http://smev.gosuslugi.ru/rev111111" xmlns:tns="http://ws.unisoft/" targetNamespace="http://ws.unisoft/">
<wsdl:documentation>Веб-сервис ФНС России - Сервис предоставления сведений из деклараций о доходах
физических лиц 3-НДФЛ. СМЭВ версия от 11.11.2011</wsdl:documentation>
<wsdl:types>
<xs:schema targetNamespace="http://ws.unisoft/">
<xs:import namespace="http://smev.gosuslugi.ru/rev111111" schemaLocation="smevbridge.xsd"/>
<xs:element name="sendRequest" type="smev:sendRequestType"/>
<xs:element name="sendRequestResponse" type="smev:sendRequestResponseType"/>
<xs:element name="getResponse" type="smev:getResponseType"/>
<xs:element name="getResponseResponse" type="smev:getResponseResponseType"/>
<xs:element name="TestRequest">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="TestResponse">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="1"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:schema>
</wsdl:types>
<wsdl:message name="sendRequest">
<wsdl:part name="sendRequestParams" element="tns:sendRequest"/>
</wsdl:message>
<wsdl:message name="sendRequestResponse">
<wsdl:part name="sendRequestResponseParams" element="tns:sendRequestResponse"/>
</wsdl:message>
<wsdl:message name="getResponse">
<wsdl:part name="getResponseParams" element="tns:getResponse"/>
</wsdl:message>
<wsdl:message name="getResponseResponse">
<wsdl:part name="sgetResponseResponseParams" element="tns:getResponseResponse"/>
</wsdl:message>
<wsdl:message name="TestIn">
<wsdl:part name="TestParams" element="tns:TestRequest"/>
18
</wsdl:message>
<wsdl:message name="TestOut">
<wsdl:part name="TestResponseParams" element="tns:TestResponse"/>
</wsdl:message>
<wsdl:portType name="FNS3NDFLWSPort">
<wsdl:operation name="sendRequest">
<wsdl:input message="tns:sendRequest"/>
<wsdl:output message="tns:sendRequestResponse"/>
</wsdl:operation>
<wsdl:operation name="getResponse">
<wsdl:input message="tns:getResponse"/>
<wsdl:output message="tns:getResponseResponse"/>
</wsdl:operation>
<wsdl:operation name="Test">
<wsdl:input message="tns:TestIn"/>
<wsdl:output message="tns:TestOut"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="FNS3NDFLWSSoap11" type="tns:FNS3NDFLWSPort">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http"/>
<wsdl:operation name="sendRequest">
<soap:operation soapAction="sendRequest" style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="getResponse">
<soap:operation soapAction="getResponse" style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="Test">
<soap:operation soapAction="Test" style="document"/>
<wsdl:input>
<soap:body use="literal"/>
</wsdl:input>
<wsdl:output>
<soap:body use="literal"/>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="FNS3NDFLWS">
<wsdl:port name="FNS3NDFLWSPort" binding="tns:FNS3NDFLWSSoap11">
<soap:address/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Приведенный WSDL содержит ссылки (import) на другие файлы форматов данных
(XSD):
WS_NDFL3_2_210_10_04_01_01.xsd
19
WS_NDFL3_2_210_11_04_01_01.xsd
WS_NDFL3_2_210_12_04_01_01.xsd
WS_NDFL3_2_210_13_04_01_01.xsd
Описания всех перечисленных элементов приведены в разделе 4.2.
4.2 Описание общих структур данных
1.
sendReguest, WS_NDFL3_2_210_10_04_01_01.xsd
Код параметра
ВерсФорм
ИдЗапросП
ОтчетГод
ФИОФЛ
ИННФЛ│
Описание параметра
Версия формата
Идентификатор
запроса,
сформированный
запрашивающей
стороной
Отчетный налоговый
период
Фамилия,
имя,
отчество физического
лица
ИНН
физического
лица
КодВидДок
Код вида документа,
удостоверяющего
личность
СерНомДок
Серия
и
документа
ДатаРожд
2.
№
1
Способ
заполнения/Тип
+
-
xs:string
xs:string
+
xs:gYear
+
ФИОТип
До 60 символов
+
ИННФЛТип
12 символов
СПДУЛТип
2 символа
xs:string
До 25 символов
ДатаТип
10 символов
номер
Дата рождения
+
Комментарий
До 5 символов
До 36 символов
sendReguest, WS_ NDFL3_2_210_11_04_01_01.xsd
Код параметра
ВерсФорм
ИдЗапросФ
2
Обязате
льность
Описание
параметра
Версия формата
Идентификатор
запроса,
сформированный
ФНС
Обязатель
ность
+
+
Способ
заполнения/
Тип
xs:string
xs:integer
Комментарий
До 5 символов
До 20 символов
20
КодОбр
3
3.
ВерсФорм
ИдЗапросФ
№
1
xs:string
2 символа
Описание параметра
Версия формата
Идентификатор
запроса,
сформированный
ФНС
Обязательн
ость
Способ
заполнения/
Тип
+
+
xs:string
xs:integer
Комментарий
До 5 символов
До 20 символов
getResponse, WS_ NDFL3_2_210_13_04_01_01.xsd
Код параметра
ВерсФорм
ИдЗапросФ
2
СвНДФЛ3|
КодОбр
Описание
параметра
Версия формата
Идентификатор
запроса,
сформированный
ФНС
Сведения по
представленной
физическим лицом
налоговой
декларации по
налогу на доходы
физических лиц (по
форме 3-НДФЛ) |
Код обработки
3
+
getResponse, WS_ NDFL3_2_210_12_04_01_01.xsd
Код параметра
4.
Код обработки
Обязатель
ность
+
+
+
Способ
заполнения/
Тип
xs:string
xs:integer
Комментарий
До 5 символов
До 20 символов
Состоит
из
элементов:
ОтчетГод,
СвФЛ,
ИтогУплВозв
Принимает
значение:
01 – запрашиваемые
сведения не найдены
│
02–запрашиваемое
ФЛ не является
предпринимателем
│
52 – ответ не готов │
83 – отсутствует
запрос с указанным
идентификатором
запроса и видом
запрошенных
сведений от данного
21
органа │
99
–
системная
ошибка
4
ОтчетГод
СвФЛ
5
ИтогУплВозв
6
ФИОФЛ
7
СвАдрРФ
8
ПрАдр
+
Отчетный
налоговый период
Сведения
о +
физическом
лице,
представившем
налоговую
декларацию
по
налогу на доходы
ФЛ (по форме 3НДФЛ)
Данные налоговой +
декларации
по
налогу на доходы
физических лиц (по
форме 3-НДФЛ
xs:gYear
Фамилия,
имя, +
отчество
физического лица
Сведения об адресе +
места
жительства
(места пребывания)
налогоплательщика
в РФ
Признак
адреса +
налогоплательщика
ФИОТип
+
Адрес
налогоплательщика
в
Российской
Федерации
ИНН физического +
лица │
АдрРФТип
Состоит
из
элементов:
ФИОФЛ, СвАдрРФ,
ИННФЛ│СведФЛ
xs:string
9
АдрРФ
10
ИННФЛ│
СведФЛ
11
Сведения о ФЛ (при
отсутствии
ИНН
ФЛ)
ИННФЛТип
Состоит
элементов:
НалБаза13,
НалБаза30,
НалБаза35,
НалБаза9,
НалБаза15,
СведДохВыч
из
Состоит
элементов:
ПрАдр, АдрРФ
из
1 символ
Принимает
значение:
1 – адрес места
жительства в
Российской
Федерации |
2 – адрес места
пребывания
в
Российской
Федерации
12 символов
Состоит
из
элементов:
ДатаРожд,
МестоРожд, УдЛичн
22
12
13
ДатаРожд
Дата рождения
+
ДатаТип
10 символов
МестоРожд
Место рождения
+
xs:string
До 128 символов
УдЛичн
Сведения
о +
документе,
удостоверяющем
личность
физического лица
Код вида документа, +
удостоверяющего
личность
УдЛичнФЛК Состоит
Тип
элементов:
КодВидДок,
СерНомДок
Серия
и
номер
документа
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 13 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 30 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 35 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 9 %
Расчет
налоговой
базы и суммы налога
по
доходам,
облагаемым
по
ставке 15 %
Общая сумма дохода
Налоговая база
xs:string
14
КодВидДок
СПДУЛТип
15
16
СерНомДок
НалБаза13
17
НалБаза30
18
НалБаза35
19
НалБаза9
20
НалБаза15
21
22
23
ДоходОбщ
НалБаза
+
из
2 символа
Принимает значение
в соответствии со
Справочником
«Коды документов»
из приложения №2 к
Порядку заполнения
формы
налоговой
декларации
по
налогу на доходы
ФЛ, утвержденному
приказом
ФНС
России от 10.11.2011
№ ММВ-7-3/760@
До 25 символов
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
-
Состоит
из
элементов:
ДоходОбщ, НалБаза
+
+
xs:decimal
xs:decimal
До 17 символов
До 17 символов
23
ДоходПредпр
24
25
ДоходИт
РасчВидДеят
26
КодВД
Доходы, полученные
от
предпринимательско
й
деятельности,
адвокатской
деятельности
и
частной
практики
(В)
Итоговая
общая
сумма дохода
Показатели,
используемые
для
расчёта налоговой
базы и суммы налога
по
виду
деятельности
Код
вида
деятельности
Состоит
из
элементов: ДоходИт
и РасчВидДеят
-
+
xs:decimal
Состоит
из
элементов:
КодВД,
ОКВЭД,
Доход
+
+
xs:string
27
ОКВЭД
Код
вида предпринимательско
й деятельности
ОКВЭДТип
Доход
Сумма дохода
xs:decimal
28
29
+
До 17 символов
Равно 1
Принимает
значение:
1–
предпринимательска
я деятельность |
2 – нотариальная
деятельность |
3 – адвокатская
деятельность |
4
–
иная
деятельность
До 8 символов
Принимает значение
в соответствии с
Общероссийским
классификатором
видов
экономической
деятельности
До 17 символов
4.3 Описания справочников
1. Общероссийский классификатор стран мира (ОКСМ).
2. Общероссийский классификатор видов экономической деятельности (ОКВЭД).
3. Справочник «Коды документов», приведенный в приложении №2 к Порядку
заполнения формы налоговой декларации по налогу на доходы физических лиц (форма
3-НДФЛ), утвержденному приказом ФНС России от 10.11.2011 № ММВ-7-3/760@.
4. Справочник «Коды регионов», приведенный в приложении №3 к Порядку заполнения
формы налоговой декларации по налогу на доходы физических лиц (форма 3-НДФЛ),
24
утвержденному приказом ФНС России от 10.11.2011 № ММВ-7-3/760@.
4.4 Иные приложения
Отсутствуют.
25