Сведения о доходах физических лиц из налоговой декларации формы 3-НДФЛ
| Атрибут | Значение |
|---|---|
| Название | fns-ndfl3doh |
| Наименование | Сведения о доходах физических лиц из налоговой декларации формы 3-НДФЛ |
| Тип | Адаптер для СМЭВ3 сервиса |
| Версия СМЭВ | СМЭВ3 |
| Версия ВС | 4.0.3 |
| Версия МР | 3.5 |
| Поставщик | Федеральная налоговая служба |
| Потребители | По согласованию с ФНС России |
Описание бизнес-процесса взаимодействия:
ИС организации хочет узнать сведения о доходах физических лиц из налоговой декларации формы 3-НДФЛ.
ИС организации отправляет запрос через Агредатор, Агредатор в свою очередь отправляет запрос в СМЭВ к виду сведений, СМЭВ получает запрос и направляет его к ИС ФНС.
После получения запроса ИС ФНС проверяет корректность полученных данных, далее через СМЭВ направляет в Агредатор запрошенные сведения или отказ в предоставлении сведений, Агредатор направляет данную информацию в ИС организации.
Если отправка запроса не произошла, то Агредатор получит от СМЭВ сообщение об ошибке и передаст его в ИС организации.
Переменные окружения
| Название | Описание |
|---|---|
| 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 | Идентификатор запроса, сформированный запрашивающей стороной | - | 000000000000000000000000000000000001 |
| year | Отчетный налоговый период | + | 2021 |
| fio | Фамилия, имя, отчество физического лица | + | Cоставной элемент Fio |
| inn | ИНН физического лица | -1 | 100000000074 |
| person_info | Сведения о физическом лице (при отсутствии ИНН физического лица) | -1 | Cоставной элемент PersonInfo |
1 - обязательно должен присутствовать только один из элементов
Структура элемента Fio
Фамилия, имя, отчество физического лица
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| surname | Фамилия | + | ИВАНОВ |
| name | Имя | + | ИВАН |
| patronymic | Отчество | - | ИВАНОВИЧ |
Структура элемента PersonInfo
Сведения о физическом лице
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| birthday | Дата рождения | + | 1956-03-21 |
| id_doc | Сведения о документе, удостоверяющем личность физического лица | + | Cоставной элемент IdDoc |
Структура элемента IdDoc
Сведения о документе, удостоверяющем личность физического лица
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| type | Код вида документа, удостоверяющего личность | + | |
| series_number | Серия и номер документа, удостоверяющего личность | + |
Параметры ответа
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| request_id | Идентификатор запроса, сформированный запрашивающей стороной | + | 000000000000000000000000000000000001 |
| ndfl3 | Сведения по представленной физическим лицом налоговой декларации по налогу на доходы физических лиц (по форме 3-НДФЛ) | + | Массив (1..unbounded) составных элементов Ndfl3 |
Структура элемента Ndfl3
Сведения о документе, удостоверяющем личность физического лица
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| year | Отчетный налоговый период | + | |
| taxpayer_category_code | Код категории налогоплательщика | - | |
| person | Сведения о физическом лице, представившем налоговую декларацию по налогу на доходы физических лиц (по форме 3-НДФЛ) | + | Cоставной элемент Person |
| ndfl3_info | Данные налоговой декларации по налогу на доходы физических лиц (по форме 3-НДФЛ) | + | Cоставной элемент Ndfl3Info |
Структура элемента Person
Сведения о физическом лице
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| fio | Фамилия, имя, отчество физического лица | + | Cоставной элемент Fio |
| inn | ИНН физического лица | -1 | 100000000074 |
| person_info | Сведения о физическом лице (при отсутствии ИНН физического лица) | -1 | Cоставной элемент PersonInfo |
1 - обязательно должен присутствовать только один из элементов
Структура элемента Ndfl3Info
Данные налоговой декларации по налогу на доходы физических лиц (по форме 3-НДФЛ)
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| tax_base | Налоговая база | - | Массив (0..unbounded) составных элементов TaxBase |
| income_sources_rf | Доходы от источников в Российской Федерации | - | Массив (0..unbounded) составных элементов IncomeSourcesRf |
| income_sources_foreign | Доходы от источников за пределами Российской Федерации, облагаемые налогом по ставке | - | Массив (0..unbounded) составных элементов IncomeSourcesForeign |
| income_entrepreneur | Доходы, полученные от предпринимательской, адвокатской деятельности и частной практики, а также расчет профессиональных налоговых вычетов, установленных пунктами 2, 3 статьи 221 Налогового кодекса Российской Федерации | - | Cоставной элемент IncomeEntrepreneur |
Структура элемента TaxBase
Налоговая база
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| tax_base_previous | Налоговая база за предыдущие отчетные годы (до 2021 года) | -1 | Cоставной элемент TaxBasePrevious |
| tax_base | Налоговая база за отчетный год | -1 | Cоставной элемент TaxBaseReporting |
1 - обязательно должен присутствовать только один из элементов
Структура элемента TaxBasePrevious
Налоговая база за предыдущие отчетные годы
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| tax_rate | Налоговая ставка | - | |
| income_type | Вид дохода | - | |
| tax_base_calc | Налоговая база для исчисления налога | - |
Структура элемента TaxBaseReporting
Налоговая база за отчетный год
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| income_type | Вид дохода (строка 001 Раздела 2) | - | 01 |
| tax_base_calc | Налоговая база для исчисления налога (строка 060 Раздела 2) | - | 1000000.00 |
Структура элемента IncomeSourcesRf
Доходы от источников в Российской Федерации
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| income_sources_rf_previous | Доходы от источников в Российской Федерации за предыдущие отчетные годы (до 2021 года) | -1 | Cоставной элемент IncomeSources |
| income_sources_rf | Доходы от источников в Российской Федерации за отчетный год | -1 | Cоставной элемент IncomeSources |
1 - обязательно должен присутствовать только один из элементов
Структура элемента IncomeSources
Доходы от источников в Российской Федерации за предыдущие отчетные годы
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| tax_rate | Налоговая ставка | - | 13 |
| income_type | Код вида дохода | - | 01 |
| income | Сумма дохода | - | 1000000.00 |
| income_source_juridical | Сведения об источнике выплаты дохода - организации | -1 | Cоставной элемент IncomeSourceJuridical |
| income_source_physical | Сведения об источнике выплаты дохода - физическом лице / Сведения об источнике выплаты дохода, не имеющем представительства на территории Российской Федерации / Сведения об ином источнике выплаты дохода | -1 | Cоставной элемент IncomeSourcePhysical |
1 - обязательно должен присутствовать только один из элементов
Структура элемента IncomeSourceJuridical
Сведения об источнике выплаты дохода - организации
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| name | Наименование | - | ООО ТЕСТ |
| inn | ИНН организации | - | 1000000002 |
| kpp | КПП | - | 010101001 |
Структура элемента IncomeSourcePhysical
Сведения об источнике выплаты дохода - физическом лице
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| fio | Фамилия, имя, отчество физического лица / Наименование источника, не имеющего представительства на территории Российской Федерации / Иной источник | - | |
| inn | ИНН физического лица | - |
Структура элемента IncomeSourcesForeign
Доходы от источников за пределами Российской Федерации
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| tax_rate | Ставка налога | - | |
| calc_income_tax_foreign_previous | Расчет сумм доходов и налога за предыдущие отчетные годы (до 2021 года) | -1 | Массив (0..unbounded) составных элементов CalcIncomeTaxForeignPrevious |
| calc_income_tax_foreign | Расчет сумм доходов и налога | -1 | Массив (0..unbounded) составных элементов CalcIncomeTaxForeign |
1 - обязательно должен присутствовать только один из элементов
Структура элемента CalcIncomeTaxForeignPrevious
Расчет сумм доходов и налога за предыдущие отчетные годы
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| oksm | Код страны по классификатору ОКСМ | - | |
| income_type_code | Код вида дохода | - | |
| income_source_name | Наименование источника выплаты дохода | - | |
| income_foreign_currency_rubles | Сумма дохода, полученная в иностранной валюте в пересчёте в рубли | - | |
| income_exempt_60_217 | Сумма дохода, освобождаемая от налогообложения в соответствии с пунктом 60 статьи 217 Налогового кодекса Российской Федерации | - | |
| income_exempt_60_1_217 | Сумма дохода, освобождаемая от налогообложения в соответствии с пунктом 60.1 статьи 217 Налогового кодекса Российской Федерации | - | |
| income_exempt_66_217 | Сумма дохода, освобождаемая от налогообложения в соответствии с пунктом 66 статьи 217 Налогового кодекса Российской Федерации | - |
Структура элемента CalcIncomeTaxForeign
Расчет сумм доходов и налога
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| oksm | Код страны по классификатору ОКСМ | - | |
| income_type_code | Код вида дохода | - | |
| income_source_name | Наименование источника выплаты дохода | - | |
| income_foreign_currency_rubles | Сумма дохода, полученная в иностранной валюте в пересчёте в рубли | - | |
| exempt_type_code | Код вида освобождения от налогообложения | - | |
| income_exempt | Сумма дохода, освобождаемого от налогообложения | - |
Структура элемента IncomeEntrepreneur
Доходы, полученные от предпринимательской, адвокатской деятельности и частной практики
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| income_total | Итоговая общая сумма дохода | - | |
| calc_data_activity_type_previous | Показатели, используемые для расчёта налоговой базы и суммы налога по виду деятельности за предыдущие отчетные годы (до 2021 года) | -1 | Массив (0..unbounded) составных элементов CalcDataActivityTypePrevious |
| calc_data_activity_type | Показатели, используемые для расчёта налоговой базы и суммы налога по виду деятельности (за отчетный 2021 год) | -1 | Массив (0..unbounded) составных элементов CalcDataActivityType |
1 - обязательно должен присутствовать только один из элементов
Структура элемента CalcDataActivityTypePrevious
Показатели, используемые для расчёта налоговой базы и суммы налога по виду деятельности за предыдущие отчетные годы
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| activity_type | Код вида деятельности | - | |
| okved | Код основного вида экономической деятельности | - | |
| income | Сумма дохода | - | |
| expense_actual | Сумма фактически произведенных расходов, учитываемых в составе профессионального налогового вычета | - |
Структура элемента CalcDataActivityType
Показатели, используемые для расчёта налоговой базы и суммы налога по виду деятельности
| Параметр | Описание | Обязательное | Пример |
|---|---|---|---|
| activity_type | Код вида деятельности | - | |
| income | Сумма дохода | - | |
| expense_actual | Сумма фактически произведенных расходов, учитываемых в составе профессионального налогового вычета | - |
Примеры
Для проверки настройки сервиса можно в консоли отправки панели администрирования отправить запрос, соответствующий контрольному примеру, и получить соответствующий ответ.
{
"request_id": "000000000000000000000000000000000001",
"year": "2021",
"fio": {
"surname": "ИВАНОВ",
"name": "ИВАН",
"patronymic": "ИВАНОВИЧ"
},
"inn": "100000000074"
}
В случае корректной настройки должен прийти следующий ответ:
{
"request_id": "000000000000000000000000000000000001",
"ndfl3": [
{
"year": "2021",
"taxpayer_category_code": "760",
"person": {
"fio": {
"surname": "ИВАНОВ",
"name": "ИВАН",
"patronymic": "ИВАНОВИЧ"
},
"inn": "100000000074"
},
"ndfl3_info": {
"tax_base": [
{
"tax_base": {
"income_type": "01",
"tax_base_calc": "1000000.00"
}
}
],
"income_sources_rf": [
{
"income_sources_rf": {
"tax_rate": "13",
"income_type": "01",
"income": "1000000.00",
"income_source_juridical": {
"name": "ООО ТЕСТ",
"inn": "1000000002",
"kpp": "010101001"
}
}
}
]
}
}
]
}