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

smev3 link

smev manual

Атрибут Значение
Название 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"
}