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

smev3 link

smevmanual

АтрибутЗначение
Названиеfns-ndfl3
ТипАдаптер для вида сведений
Наименование1Сведения о доходах физических лиц из налоговой декларации формы 3-НДФЛ
Наименование2Получение сведений о доходах физического лица из налоговой декларации по форме 3-НДФЛ
Версия ВС4.0.2
Версия СМЭВСМЭВ3
СМЭВ3 nsurn://x-artefacts-fns-ndfl3doh/root/210-18/4.0.2
СМЭВ3 rootNDFL3DOHRequest / 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 символов-14e7d225a-63fa-4aa9-86d0-06aaa4a80944
innИНН физического лица, зарегистрированного в качестве индивидуального предпринимателя+2100000000074
doc_codeКод вида документа, удостоверяющего личность физического лица. Принимает значение в соответствии со справочником «Виды документов, удостоверяющих личность налогоплательщика»+221
doc_series_numberСерия и номер документа физического лица+200 00 123456
birth_dateДата рождения в формате ГГГГ-ММ-ДД+21976-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ИНН физического лица+1100000000074
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"
}