НДФЛ ФЛ ФНС

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

smev3 link

smev manual

Атрибут Значение
Название fns-ndfl2
Тип Адаптер для вида сведений
Наименование Сведения о доходах физических лиц по справкам 2-НДФЛ
Область применения Межведомственное взаимодействие
Версия 4.1.1
Версия МР 3.0
Версия СМЭВ СМЭВ3
СМЭВ3 ns urn://x-artefacts-fns-ndfl2/root/260-10/4.1.1
СМЭВ3 root NDFL2Request / NDFL2Response

!!! warning "Требование подписания ЭП-СП"

Персональная подпись должна содержать OID `1.2.643.3.4.3.3.2`

Переменные окружения

Название Описание
CA_CERT сертификат центра сертификации для подключения к rabbitmq
CLIENT_CERT сертификат, используемый для подключения к rabbitmq
CLIENT_KEY ключ, используемый для подключения к rabbitmq
MQ_HOST хост rabbitmq
MQ_PORT порт rabbitmq
SMEV_SERVICE название смэв сервиса, на который будут отправляться запросы
USE_PERSONAL_SIGNATURE флаг необходимости отправки запроса на подпись пользователя. Устанавливать значение true для отправки на подпись
SIGN_SERVICE название сервиса, в котором будет производиться подпись, в случае отсутствия отправляется сервису, отправившему запрос

Переменные для конфигурирования подключения к БД:

DATABASE_HOST, DATABASE_PORT, DATABASE_NAME, DATABASE_USER, DATABASE_PASS.

Принимаемые параметры

Параметр Название Обязательное Пример
request_id Идентификатор запроса, сформированный запрашивающей стороной + 1
type Тип запроса + 1
Допустимые значения:
1 – запрос сведений о количестве представленных справок о доходах физических лиц по форме 2-НДФЛ
2 – запрос сведений о доходах ФЛ по справкам 2-НДФЛ
year Отчетный налоговый период + 2016
service_code Код услуги - 00000000000
person Сведения о физическом лице +1 Составной элемент Person
tax_agent_person Сведения о налоговом агенте - физическом лице +1 Составной элемент TaxAgentPerson
tax_agent_legal Сведения о налоговом агенте - организации +1 Составной элемент TaxAgentLegal

1 - допускается наличие только одного поля person, tax_agent_person или tax_agent_legal

Составной элемент Person

Параметр Название Обязательное Пример
birthdate Дата рождения + 1986-05-27
inn ИНН - 012345678910
snils СНИЛС - 00000000001
statement_number Номер заявления + 2
statement_date Дата заявления + 2012-01-01
surname Фамилия + Иванов
name Имя + Иван
patronymic Отчество - Иванович
doc_code Код вида документа, удостоверяющего личность физического лица по СПДУЛ + 21
doc_series_number Серия и номер документа физического лица + 0000 000000

Составной элемент TaxAgentPerson

Параметр Название Обязательное Пример
inn ИНН налогового агента - физического лица + 012345678910
snils СНИЛС - 00000000001
surname Фамилия + Иванов
name Имя + Иван
patronymic Отчество - Иванович

Составной элемент TaxAgentLegal

Параметр Название Обязательное Пример
name Наименование организации + ТестОрг
inn ИНН организации + 1000000000
kpp КПП + 100000000

Параметры ответа

Параметр Название Обязательное Пример
request_id Идентификатор запроса, сформированный ФНС - 1
docs_info Сведения о количестве представленных налоговым агентом справок о доходах физических лиц по форме 2-НДФЛ -1 Составной элемент DocsInfo
processing_code Код обработки запроса -1 Составной элемент ProcessingCode
income Сведения о доходах физического лица по справкам 2-НДФЛ -1 Составной элемент Income

1 Обязательно должен присутствовать один из элементов

Составной элемент DocsInfo

Параметр Название Обязательное Пример
report_year Отчетный налоговый период + 2013
count Количество справок, представленных налоговым агентом за запрашиваемый налоговый период + 1

Составной элемент ProcessingCode

Параметр Название Обязательное Пример
code Код обработки запроса + 01
description Описание кода + Запрашиваемые сведения не найдены

Допустимые значения пар code - description:

  • 01 – запрашиваемые сведения не найдены
  • 52 – ответ не готов (используется при асинхронном запросе)
  • 83 – отсутствует запрос с указанным идентификатором запроса и видом запрошенных сведений от данного органа (используется при асинхронном запросе)
  • 99 – системная ошибка

Составной элемент Income

Параметр Название Обязательное Пример
report_year Отчетный налоговый период + 2013
incomings_by_agent Сведения о доходах физического лица по справкам 2-НДФЛ по налоговому агенту + Множество составных элементов типа IncomingByAgent
recipient Данные о физическом лице - получателе дохода + Составной элемент Recipient

Составной элемент Recipient

Параметр Название Обязательное Пример
inn ИНН физического лица - 926976576187
birthdate Дата рождения + 1986-01-01
surname Фамилия + Иванов
name Имя + Иван
patronymic Отчество - Иванович
doc_code Код вида документа, удостоверяющего личность + 21
doc_series_number Серия и номер документа + 00 00 000000

Составной элемент IncomingByAgent

Параметр Название Обязательное Пример
tax_agent_legal Сведения о налоговом агенте – организации -1 Составной элемент TaxAgentLegal
tax_agent_person Сведения о налоговом агенте - физическом лице -1 Составной элемент TaxAgentPerson
incomings Сведения о доходах физического лица + Множество составных элементов Incoming

1 - должен присутствовать только 1 элемент

Составной элемент TaxAgentLegal
Параметр Название Обязательное Пример
inn ИНН организации + 1000000000
name Наименование организации + Тестовая организация
kpp КПП + 100000000
Составной элемент TaxAgentPerson
Параметр Название Обязательное Пример
inn ИНН физического лица + 680918138144
snils Страховой номер индивидуального лицевого счета + 02767095678
surname Фамилия налогового агента - физического лица + Петров
name Имя налогового агента - физического лица + Петр
patronymic Отчество налогового агента - физического лица - Петрович
Составной элемент Incoming
Параметр Название Обязательное Пример
tax_rate Ставка налога + 13
by_month Сведения о суммах дохода по месяцам и кодам дохода + Множество составных элементов MonthIncoming
deduction Стандартные, социальные и имущественные налоговые вычеты + Составной элемент SocialDeduction
by_tax_period Общие суммы дохода и налога по итогам налогового периода + Составной элемент PeriodIncoming
Составной элемент MonthIncoming
Параметр Название Обязательное Пример
month Месяц + 2 символа. Принимает значение 01 – январь, 02 – февраль, 03 – март, 04 – апрель, 05 – май, 06 – июнь, 07 – июль, 08 – август, 09 – сентябрь, 10 – октябрь, 11 – ноябрь, 12 – декабрь
code Код дохода + 2000
sum Сумма дохода + 1000
deductions Сведения о суммах вычета - Множество составных элементов Deduction
Составной элемент Deduction
Параметр Название Обязательное Пример
code Код вычета + 200
sum Сумма вычета + 100
Составной элемент SocialDeduction
Параметр Название Обязательное Пример
sums Суммы предоставленных налогоплательщику налоговых вычетов + Множество элементов Deduction
notification Сведения об Уведомлении, подтверждающем право на имущественный налоговый вычет - Составной элемент Notification
Составной элемент Notification
Параметр Название Обязательное Пример
number Номер уведомления, подтверждающего право на имущественный налоговый вычет + 42
date Дата выдачи уведомления 2013-04-28  
ifns_code Код налогового органа, выдавшего уведомление + 0000
Составной элемент PeriodIncoming
Параметр Название Обязательное Пример
total_income Общая сумма дохода + 10000
tax_base Налоговая база + 1300
calculated_tax_amount Сумма налога исчисленная + 1300
witheld_tax_amount Сумма налога удержанная - 0
listed_tax_amount Сумма налога перечисленная - 0
retained_by_agent_tax_amount Сумма налога, излишне удержанная налоговым агентом - 0
not_retained_by_agent_tax_amount Сумма налога, не удержанная налоговым агентом + 100

Примеры

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "year": "2013",
  "request_id": "1",
  "type": "2",
  "service_code": "00000000000",
  "person": {
    "birthdate": "1986-01-01",
    "inn": "123456789012",
    "snils": "00000000000",
    "statement_number": "1",
    "statement_date": "2012-01-01",
    "surname": "ИВАНОВ",
    "name": "ИВАН",
    "patronymic": "ИВАНОВИЧ",
    "doc_code": "21",
    "doc_series_number": "00 00 000000"
  }
}

В случае корректной настройки должен прийти следующий ответ:

{
  "request_id": "2",
  "income": {
    "report_year": 2013,
    "recipient": {
      "surname": "ИВАНОВ",
      "name": "ИВАН",
      "patronymic": "ИВАНОВИЧ",
      "birthdate": "1986-01-01",
      "doc_code": "21",
      "doc_series_number": "00 00 000000"
    },
    "incomings_by_agent": [
      {
        "tax_agent_legal": {
          "name": "ТестОрг",
          "inn": "1000000000",
          "kpp": "100000000"
        },
        "incomings": [
          {
            "tax_rate": "13",
            "by_month": [
              {
                "month": "01",
                "code": "2000",
                "sum": "1000",
                "deductions": [
                  {
                    "code": "200",
                    "sum": "100"
                  }
                ]
              }
            ],
            "by_tax_period": {
              "total_income": "10000",
              "tax_base": "1300",
              "calculated_tax_amount": "1300",
              "not_retained_by_agent_tax_amount": "100"
            }
          }
        ]
      }
    ]
  }
}

Пример тестового запроса:

{
  "year": "2013",
  "request_id": "1",
  "type": "1",
  "service_code": "00000000000",
  "tax_agent_legal": {
    "name": "ТестОрг",
    "inn": "1000000000",
    "kpp": "100000000"
  }
}

Ответ:

{
  "request_id": "1",
  "documents_info": {
    "report_year": "2013",
    "count": "1"
  }
}

Пример тестового запроса:

{
  "year": "2013",
  "request_id": "3",
  "type": "2",
  "service_code": "00000000000",
  "person": {
    "birthdate": "1986-01-01",
    "snils": "00000000001",
    "statement_number": "2",
    "statement_date": "2012-01-01",
    "surname": "ПЕТРОВ",
    "name": "ПЕТР",
    "doc_code": "21",
    "doc_series_number": "00 00 000001"
  }
}

Ответ

{
  "request_id": "3",
  "processing_code": {
    "code": "01",
    "description": "Запрашиваемые данные не найдены"
  }
}
  • Сведения о доходах физических лиц по справкам 2-НДФЛ
  • Переменные окружения
  • Принимаемые параметры
  • Составной элемент Person
  • Составной элемент TaxAgentPerson
  • Составной элемент TaxAgentLegal
  • Параметры ответа
  • Составной элемент DocsInfo
  • Составной элемент ProcessingCode
  • Составной элемент Income
  • Составной элемент Recipient
  • Составной элемент IncomingByAgent
  • Примеры
    • Подавай заявку сейчас

    Оставьте свои контактные данные и наш менеджер свяжется с вами в ближайшее время