Сведения о доходах физических лиц из налоговой декларации формы 3-НДФЛ
Атрибут |
Значение |
Название |
fns-ndfl3 |
Тип |
Адаптер для вида сведений |
Наименование1 |
Сведения о доходах физических лиц из налоговой декларации формы 3-НДФЛ |
Наименование2 |
Получение сведений о доходах физического лица из налоговой декларации по форме 3-НДФЛ |
Версия ВС |
4.0.2 |
Версия СМЭВ |
СМЭВ3 |
СМЭВ3 ns |
urn://x-artefacts-fns-ndfl3doh/root/210-18/4.0.2 |
СМЭВ3 root |
NDFL3DOHRequest / NDFL3DOHResponse |
Переменные окружения
Название |
Описание |
CA_CERT |
сертификат центра сертификации для подключения к rabbitmq |
CLIENT_CERT |
сертификат, используемый для подключения к rabbitmq |
CLIENT_KEY |
ключ, используемый для подключения к rabbitmq |
MQ_HOST |
хост rabbitmq |
MQ_PORT |
порт rabbitmq |
SMEV_SERVICE |
название смэв сервиса, на который будут отправляться запросы |
Переменные для конфигурирования подключения к БД:
DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.
Переменные для конфигурирования отправки метрик в Elasticsearch:
ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX
Принимаемые параметры
Параметр |
Описание |
Обязательное |
Пример |
request_id |
Идентификатор запроса. Строка длиной до 36 символов |
-1 |
4e7d225a-63fa-4aa9-86d0-06aaa4a80944 |
inn |
ИНН физического лица, зарегистрированного в качестве индивидуального предпринимателя |
+2 |
100000000074 |
doc_code |
Код вида документа, удостоверяющего личность физического лица. Принимает значение в соответствии со справочником «Виды документов, удостоверяющих личность налогоплательщика» |
+2 |
21 |
doc_series_number |
Серия и номер документа физического лица |
+2 |
00 00 123456 |
birth_date |
Дата рождения в формате ГГГГ-ММ-ДД |
+2 |
1976-10-24 |
year |
Отчетный год |
+ |
2015 |
name |
Имя |
+ |
Иван3 |
surname |
Фамилия |
+ |
Иванов3 |
patronymic |
Отчество |
- |
Иванович3 |
1 - в тестовом контуре для тестирования значения должно быть равно 000000000000000000000000000000000001
2 - в запросе должен присутствовать inn или doc_code, doc_series_number, birth_date одновременно
3 - строки длиной до 60 символов
Параметры ответа
Параметр |
Описание |
Обязательное |
Пример |
RequestId |
Идентификатор запроса, сформированный ФНС |
- |
000000000000000000000000000000000001 |
SvNDFL3 |
Сведения о доходах физического лица |
+ |
Множественная группа. Состоит из элементов SvNDFL3 |
Структура элемента SvNDFL3
Параметр |
Описание |
Обязательное |
Пример |
DokPredst |
Код категории налогоплательщика.1 |
- |
760 |
OtchetGod |
Отчетный налоговый период |
+ |
2016 |
SvFL |
Сведения о физическом лице, представившем налоговую декларацию по налогу на доходы физ. лиц (по форме 3-НДФЛ) |
+ |
Составной элемент SvFL |
ItogUplVozv |
Данные налоговой декларации по налогу на доходы физ. лиц (по форме 3-НДФЛ) |
+ |
Cоставной элемент ItogUplVozv |
1 - Принимает значение в соответствии со справочником «Коды категории налогоплательщика» из приложения №1 к Порядку заполнения формы налоговой декларации по налогу на доходы физических лиц (форма 3-НДФЛ), а именно:
* 720 – физическое лицо, зарегистрированное в качестве индивидуального предпринимателя
* 730 – нотариус, занимающийся частной практикой, и другие лица, занимающиеся в установленном действующим законодательством порядке частной практикой
* 740 – адвокат, учредивший адвокатский кабинет
* 750 – арбитражный управляющий
* 760 – иное физическое лицо, декларирующее доходы в соответствии со статьями 227.1 и 228 Кодекса, а также с целью получения налоговых вычетов в соответствии со статьями 218 - 221 Кодекса или с иной целью
* 770 – физическое лицо, зарегистрированное в качестве индивидуального предпринимателя и являющееся главой крестьянского (фермерского) хозяйства
Структура элемента SvFL
Параметр |
Описание |
Обязательное |
Пример |
FIOFL |
Фамилия, имя, отчество |
+ |
Составной элемент FIOFL |
INNFL |
ИНН физического лица |
+1 |
100000000074 |
SvedFL |
Сведения о физическом лице (при отсутствии ИНН физического лица) |
+1 |
Составной элемент SvedFL |
1 - должен присутствовать один из элементов INNFL или SvedFL
Структура элемента FIOFL
Параметр |
Описание |
Обязательное |
Пример |
Name |
Имя |
+ |
Иван |
Surname |
Фамилия |
+ |
Иванов |
Patronymic |
Отчество |
- |
Иванович |
Структура элемента SvedFL
Параметр |
Описание |
Обязательное |
Пример |
DataRozhd |
Дата рождения |
- |
1976-10-04 |
MestoRozhd |
Место рождения |
- |
где-то |
UdLichn |
Сведения о документе, удостоверяющем личность физического лица |
+ |
Составной элемент UdLichn |
Структура элемента UdLichn
Параметр |
Описание |
Обязательное |
Пример |
DocumentCode |
Код вида документа, удостоверяющего личность физического лица |
+ |
21 |
SeriesNumber |
Серия и номер документа физического лица |
+ |
00 00 123456 |
Структура элемента ItogUplVozv
Параметр |
Описание |
Обязательное |
Пример |
NalBaza |
Налоговая база |
- |
Множественная группа. Состоит из составных элементов NalBaza |
DohodIstRF |
Сведения о доходах от источников в РФ из листа А налоговой декларации 3-НДФЛ |
- |
Множественная группа. Состоит из элементов DohotIstRF |
DohodIstIno |
Доходы от источников за пределами Российской Федерации |
- |
Множественная группа. Состоит из элементов DohodIstIno |
DohodPredpr |
Доходы, полученные от предпринимательской, адвокатской деятельности и частной практики, а также расчет профессиональных налоговых вычетов, установленных пунктами 2, 3 статьи 221 Налогового кодекса Российской Федерации (Приложение 3) |
- |
Составной элемент DohodPredpr |
Структура элемента NalBaza
Параметр |
Описание |
Обязательное |
Пример |
Stavka |
Налоговая ставка |
- |
13 |
VidDohod |
Вид Дохода1 |
- |
3 |
NalBazaIschisl |
Налоговая база для исчисления налога |
- |
1000000.00 |
1 - принимает значение:
* 1 – дивиденды
* 2 – доход в виде сумм прибыли контролируемых иностранных компаний
* 3 – иное
Структура элемента DohodIstRF
Параметр |
Описание |
Обязательное |
Пример |
Stavka |
Налоговая ставка |
- |
13 |
VidDohod |
Код вида дохода |
- |
04 |
Dohod |
Сумма дохода |
- |
1000000.00 |
IstYUL |
Сведения об источнике выплаты дохода - организации |
+1 |
Составной элемент IstYUL |
IstFLIn |
Сведения об источнике выплаты дохода - физическом лице / Сведения об источнике выплаты дохода, не имеющем представительства на территории Российской Федерации / Сведения об ином источнике выплаты дохода |
+1 |
Составной элемент IstFLIn |
1 - должен присутствовать один элемент IstYUL или IstFLIn
Структура элемента IstYUL
Параметр |
Описание |
Обязательное |
Пример |
INNYUL |
Сведения об источнике выплаты дохода - организации |
- |
1000000002 |
KPP |
КПП |
- |
010101001 |
Naim |
Наименование |
- |
ООО ТЕСТ |
Структура элемента IstFLIn
Параметр |
Описание |
Обязательное |
Пример |
FIOIn |
Фамилия, имя, отчество физического лица / Наименование источника, не имеющего представительства на территории Российской Федерации / Иной источник |
- |
|
INNFL |
ИНН физического лица |
- |
512997964852 |
Структура элемента DohodIstIno
Параметр |
Описание |
Обязательное |
Пример |
Stavka |
Налоговая ставка |
- |
13 |
RaschDohNalIno |
Расчет сумм дохода и налога |
- |
Множественная группа. Состоит из элементов RaschDohNalIno |
Структура элемента RaschDohNalIno
Параметр |
Описание |
Обязательное |
Пример |
OKSM |
Код страны по классификатору ОКСМ |
- |
643 |
KodVidDoh |
Код вида дохода |
- |
24 |
NaimIstDoh |
Наименование источника выплаты дохода |
- |
|
DohodInoRub |
Сумма дохода, полученная в иностранной валюте в пересчёте в рубли |
- |
|
DohodOsv60.217 |
Сумма дохода, освобождаемая от налогообложения в соответствии с пунктом 60 статьи 217 Налогового кодекса Российской Федерации |
- |
|
DohodOsv60.1.217 |
Сумма дохода, освобождаемая от налогообложения в соответствии с пунктом 60.1 статьи 217 Налогового кодекса Российской Федерации |
- |
|
DohodOsv66.217 |
Сумма дохода, освобождаемая от налогообложения в соответствии с пунктом 66 статьи 217 Налогового кодекса Российской Федерации |
- |
|
Структура элемента DohodPredpr
Параметр |
Описание |
Обязательное |
Пример |
DohodIt |
Итоговая общая сумма дохода |
- |
|
RaschVidDeyat |
Показатели, используемые для расчёта налоговой базы и суммы налога по виду деятельности |
- |
Множественная группа. Состоит из элементов RaschVidDeyat |
Структура элемента RaschVidDeyat
Параметр |
Описание |
Обязательное |
Пример |
VidDeyat |
Код вида деятельности1 |
- |
01 |
OKVED |
Код вида предпринимательской деятельности. Принимает значение в соответствии с Общероссийским классификатором видов экономической деятельности |
- |
|
Dohod |
Сумма дохода |
- |
|
RashFakt |
Сумма фактически произведенных расходов, учитываемых в составе профессионального налогового вычета |
- |
|
1 - Принимает значение:
- 01 – предпринимательская деятельность
- 02 – нотариальная деятельность
- 03 – адвокатская деятельность
- 04 – деятельность арбитражного управляющего
- 05 – деятельность главы крестьянского (фермерского) хозяйства
- 06 – иная деятельность, носящая характер частной практики
- 07 - описание не найдено
- 08 - описание не найдено
- 09 - описание не найдено
Примеры
Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:
{
"request_id": "000000000000000000000000000000000001",
"year": "2016",
"name": "Иван",
"surname": "Иванов",
"patronymic": "Иванович",
"inn": "100000000074"
}
В случае корректной настройки должен прийти следующий ответ:
{
"RequestId": "000000000000000000000000000000000001",
"SvNDFL3": [
{
"DokPredst": "760",
"OtchetGod": "2016",
"SvFL": {
"FIOFL": {
"Surname": "ИВАНОВ",
"Name": "ИВАН",
"Patronymic": "ИВАНОВИЧ"
},
"INNFL": "100000000074"
},
"ItogUplVozv": {
"NalBaza": [
{
"VidDohod": "3",
"NalBazaIschisl": "1000000.00",
"Stavka": "13"
}
],
"DohodIstRF": [
{
"VidDohod": "01",
"Dohod": "1000000.00",
"Stavka": "13",
"IstYUL": {
"INNYUL": "1000000002",
"KPP": "010101001",
"Naim": "ООО ТЕСТ"
}
}
]
}
}
]
}
Пример запроса без указания ИНН (ответ будет аналогичен предыдущему варианту для тестового контура):
{
"request_id": "000000000000000000000000000000000001",
"year": "2016",
"name": "Иван",
"surname": "Иванов",
"patronymic": "Иванович",
"birth_date": "1976-10-21",
"doc_code": "21",
"doc_series_number": "0000 123456"
}