https://pastein.ru/t/yeB
Загрузка данных
Бизнес-требования к функционалу автоматического формирования реестров по упрощенному налоговому вычету в НПФ 360
Оглавление
1. Общие требования 3
2. Описание журнала 3
3. Формирование реестра 10
3.1. Логика формирования реестра 10
3.2. Параметры отбора. 10
3.3. Логика формирования xml- файла 11
3.4. Алгоритм действия системы с ЛКК и ФНС 11
4. Автоматическое формирование реестра 13
4.1 Регламентное задание по формированию реестра. 13
4.2 Регламентное задание по регистрации и отправке реестра в ЛКК. 14
4.3 Регламентное задание реестра в ФНС. 14
Уведомление. 15
Отработка ошибок, возвращённых от ФНС 15
5. Отправка XML-файла в API ФНС. 18
6. Статусная модель 18
Приложение 1. Таблица статусов карточки в ЛКК. 19
Приложение 2 22
Приложение 3. «Формат представления негосударственным пенсионным фондом в налоговый орган сведений, необходимых в целях предоставления налогового вычета на долгосрочные сбережения граждан в сумме уплаченных сберегательных взносов по договору долгосрочных сбережений, предусмотренного подпунктом 2 пункта 1 статьи 219.2 Налогового кодекса Российской Федерации, в электронной форме» 24
Приложение 4. «Формат представления негосударственным пенсионным фондом в налоговый орган сведений, необходимых в целях предоставления налогового вычета на долгосрочные сбережения граждан в сумме уплаченных пенсионных взносов по договору негосударственного пенсионного обеспечения, предусмотренного подпунктом 1 пункта 1 статьи 219.2 Налогового кодекса Российской Федерации, в электронной форме» 34
Приложение 5. «Требования к формату отсоединенной подписи в рамках взаимодействия с Вычеты» 44
Приложение 6. Клиентский путь оформления упрощённого налогового вычета в ЛКК. 45
Термины и определения
Термин Определение
Пользователь Пользователь сайта – физическое лицо
API ФНС Прикладная система «Вычеты» от ГНИВЦ
Заявление ПДН Заявление на изменение персональных данных и банковских реквизитов
ЕAPI фонда Внутренняя система ЕAPI (бекенд)
ПДС Программа долгосрочных сбережений
ДДС Договор долгосрочных сбережений
ЛКК Личный кабинет клиента (фронт)
ЛК ФНС Личный кабинет налогоплательщика ФНС
УНВ Упрощённый налоговый вычет
1. Общие требования
В НПФ 360 (далее – система) необходимо реализовать формирование реестров, их отправку и получение сведений на предоставления упрощённого налогового вычета для повышения лояльности клиентов.
В рамках данных бизнес-требований должен быть реализован следующий функционал:
- Формирование реестров «Реестр на упрощённый налоговый вычет» за 3 предыдущих года относительно настоящего;
- Передача и получение сведений в ФНС;
- Взаимодействие с ЛКК;
Схема процесса:
2. Описание журнала
В «НПФ 360» необходимо реализовать новый раздел, в котором будут отражаться сформированные реестры для ФНС по подаче заявлений на УНВ за прошедшие 3 года, исключая текущий год, в разрезе каждого договора НПО/ДС. Путь к разделу: Персонифицированный учет – Отчетность – ФНС– Реестр на упрощенный налоговый вычет (Рис. 1).
Рис. 1. Путь к разделу.
В разделе должен отображаться журнал реестров с детализирующими таблица относительно клиентов, вошедших в реестр и ошибок, по отправленным xml, полученных из ГНИВЦ. Макет целевого состояния журнала представлен на рис. 2.
Рис. 2. Макет целевого состояния журнала .
При создании реестра создается запись реестра в журнале «Реестры на упрощённый налоговый вычет». Описание полей журнала представлено в таб. 1.
Таб. 1. Описание полей журнала.
Наименование поля Тип данных Описание
№ 1 2 3
1. ID Текст Отображается идентификационный, порядковый номер реестра;
2. Дата Дата
Формат: DD.MM.YYYY Отображается дата создания реестра;
3. Налоговый период (год) Дата
Формат: YYYY Отчётный период, за который собирается информация;
В БД необходимо реализовать логический признак актуальности записей в реестрах.
Значения:
• new – присваивается записям в реестрах за предыдущие 3 года относительно текущего.
• old – присваивается неактуальным записям в реестрах, которые старше 3 лет относительно текущего года и исключаются для передачи данных в ЛКК.
Кнопка Состояние Целевое действие
Выбрать/снять По умолчанию активна Становится доступной при выделении участника (по нажатии выбранный участник отмечается галкой)
Выбрать все По умолчанию активна По нажатию выделяются все участники в таблице
Инвертировать По умолчанию активна Обратное действие (если был отмечен 1 участник из 5 имеющихся, то по нажатии данной кнопки будут отмечены 4).
Очистить По умолчанию активна Удаляет выбранные строки в таблице
При выделении записи в таблице с реестрами необходимо чтобы ниже отображалась таблица с клиентами, включенными в данные реестр за определённый налоговый период. Описание данных в таблице представлено ниже в Таб.3.
Таб. 3. Описание полей детализирующей таблицы с клиентами.
Наименование поля Тип данных Описание
№ 1. 2. 3.
1. ID записи число Отображается идентификационный, порядковый номер записи в составе реестра;
2. ИД реестра число Отображается идентификационный, порядковый номер реестра;
3. Клиент ссылка Отображается ФИО клиента в виде ссылки на карточку ФЛ;
4. СНИЛС строка Отображается СНИЛС клиента. Данные тянутся из карточки ФЛ;
5. Вид деятельности строка Отображается вид деятельности договора;
6. № договора ссылка Отображается номер договора в виде ссылки на договор НПО/ПДС;
7. Баланс счета число Отображается текущий баланс счета у договора по клиенту.
- значение необходимо тянуть из поля «Баланс», из карточки счета
8. Размер взносов за год число Отображается сумма взносов за 1 год (налоговый период);
Взносы по ПДС необходимо учитывать из выписке по счету (карточке счета) по мнемонике - ПДС СВ , по НПО - ИПС_ФЛ;
9. Предварительный размер вычета число Отображается сумма вычета вычисленная по формуле:
Размер вычета =∑взносов n*13%, где,
∑n- сумма взносов за рассчитываемый год по договору НПО или ПДС.
Важно: не учитывать выплаты, софинансирование и инвестиционный доход, перевод ОПС в ПДС. Только личная оплата взноса клиентом.
Описание мнемоник, которые необходимо взять для расчета, см в п. 3.2.
Важно: Максимальная сумма в поле «Предварительный расчёт» для НПО и для ПДС ровно 52 000 руб. Если по формуле исчислена сумма менее 52 000 руб, то показать итоговую сумму. Если расчёт составил более 52 000 руб, то показать ровно 52 000 руб.
Важно: Для клиентов, у которых НПО был заведен до 2025 года, предварительный расчет исчисляется также по формуле сумма взносов за выбранный налоговый период * 13%. Но если сумма расчёта превысила 19 500 руб, тогда оставить сумму ровно в 19 500 руб. Для НПО, заключенных после 2025 включительно, формула расчета ограничение такое же, как для ПДС.
10. Признак "Получать вычет ежегодно" логическое Отображается возможное значение по ответу из ЛКК.
Возможные значения:
1 – получать вычет,
0 – не получать.
- Значение по умолчанию – 0.
- Поле переключается в значение «1» при заполнении чек-бокса клиентом в ЛКК.
- При получении значения «1» необходимо, чтобы клиент попал по выбранному договору только в реестр в будущем периоде соответственно передавался в ЛКК. В текущие реестры клиент не попадает.
Важно: проставление чек-бокса завязано на конкретном договоре, выбранным клиентом в ЛКК.
Если у клиента имеются другие договоры и он не заполнял чек-бокс по ним, то в будущий реестр по этим договорам клиент не попадает.
Синхронизация значения поля «Получать вычет ежегодно» по последнему запросу из ЛКК.
При получении запроса от ЛЛК, в случае изменения значения чек-бокса, система должна одномоментно (атомарно) перезаписать значение поля во всех записях реестра, куда попал договор клиента.
11. Наличие ЛК ФНС логическое Отображается возможное значение по ответу из ФНС.
Возможные значения:
1 – имеется ЛК ФНС,
0 – не имеется ЛК ФНС,
null – по данному клиенту не было запроса в API ФНС о наличии ЛК ФНС,
99 – проверка на наличие ЛК ФНС не успешна.
12. Статус строка Отображается текущий статус последнего отправленного файла в реестре. Описание статусной модели в п.6.
13. Кол-во отправок число Отображается кол-во отправок сформированного файла xml.
Под журналом необходимо расположить функциональные кнопки. Описание кнопок в таб. 2.
Таб. 2. Функционал кнопок.
Кнопка Состояние Целевое действие
Создать По умолчанию активна Создание реестра УВН по параметрам отбора. Описание параметров отбора см. в п.3.2.
Отправить в ЛКК Активна при выборе реестра в журнале в статусе «Сформировано» Отправляет сведения по сформированному реестру в ЛКК
Отправить в ФНС Активна при выборе в журнале записи на статусе «Получен в ЛКК» Формирует и отправляет файл в формате xml в ФНС
Аннулировать Активна при выборе в журнале записи на статусах «Сформировано». Не активна, если реестр был отправлен в ЛКК /ФНС. -Аннулирует реестр из системы;
-Перед удалением обязательно должно выводиться уведомление для подтверждения действия;
- Доступна для роли ДСПД руководитель.
Экспорт в Exel (уже реализована) По умолчанию активна После таблицы начисления пенсии
Выбрать/снять По умолчанию активна Становится доступной при выделении участника (по нажатии выбранный участник отмечается галкой)
Выбрать все По умолчанию активна По нажатию выделяются все участники в таблице
Инвертировать По умолчанию активна Обратное действие (если был отмечен 1 участник из 5 имеющихся, то по нажатии данной кнопки будут отмечены 4).
Очистить По умолчанию активна Удаляет выбранные строки в таблице
В таблице необходимо реализовать историчность и фиксацию взаимодействия с ГНИВЦ. Детализирующая таблица по ошибкам в составе клиентов представлена в Таб.4.
Таб.4 Ошибки отправленных файлов
Наименование поля Тип данных Описание
№ 1. 2. 3.
1. ID реестра число Отображается идентификационный, порядковый номер реестра;
2. ID записи число Отображается идентификационный, порядковый номер записи в составе реестра;
3. ID ошибки число Отображается идентификационный, порядковый номер записи ошибки в разрезе клиента;
4. Дата отправки в ФНС Дата
Формат: DD.MM.YYYY Отображается дата отправки реестра в ФНС;
5. Документ в ФНС Бинарные данные Отображается иконка ссылки на сформированный файл xml. Файл хранится в БД в бинарном виде.
6. Статус строка Отображается текущий статус записи в реестре. Описание статусной модели в п.6.
7. Значение ошибки Дата
дд.мм.гггг Отображается значение ошибки, которое прислала API ФНС;
Например – 02;
Значение ошибок см. в Приложении 2.
8. Описание ошибки строка Отображается расшифровка ошибки»
Например - Есть дата смерти физ. Лица;
Описание ошибок см. в Приложении 2, столбец «Пояснения».
Кнопки к таблице с ошибками описаны в Таб.5.
Таб.5 Функциональные кнопки
Кнопка Состояние Целевое действие
Выбрать/снять По умолчанию активна Становится доступной при выделении участника (по нажатии выбранный участник отмечается галкой)
Выбрать все По умолчанию активна По нажатию выделяются все участники в таблице
Инвертировать По умолчанию активна Обратное действие (если был отмечен 1 участник из 5 имеющихся, то по нажатии данной кнопки будут отмечены 4).
Очистить По умолчанию активна Удаляет выбранные строки в таблице
При открытии журнала система не должна получать и отображать данные до установки фильтров.
Для удобства поиска над журналом требуется реализовать фильтры по отдельным полям:
- диапазон дат реестра (две даты) – с возможностью указать начальное и конечное значения диапазона. По умолчанию не заполнено. Обязательно к заполнению.
- ID реестра;
- налоговый период (год);
Фильтры в детализирующей таблице клиентов в составе реестра:
- ФИО клиента:
- Виду деятельности (НОП/ПДС):
- Номер договора
- Сумме предварительного вычета
- Получать вычет ежегодно
- диапазон дат отправки (две даты) – с возможностью указать начальное и конечное значения диапазона. По умолчанию не заполнено;
Фильтры в детализирующей таблице по ошибкам записей:
- Дата отправки в ФНС
- статус – выпадающий список (описание статусной модели в п.6);
- значение ошибки;
- описание ошибки;
3. Формирование реестра
3.1. Логика формирования реестра
Ежегодно, с 20 января, в системе должна запускаться регламентная задача, которая автоматически формирует реестр с названием «Реестр на упрощённый налоговый вычет» по договорам клиентов, по которым доступен налоговый вычет по ПДС и НПО за предшествующие 3 года, относительно текущего(отчетного) года . Параметры отбора для формирования реестра см в п. 3.2.
Важно: реестры формируются за предшествующие 3 года в текущем году . 1 реестр = 1 год (налоговый период). Первый раз система сформирует реестры за предшествующие 3 года, например, за 2023, 2024 и 2025 год. В следующем 2027 году, система проставит признак неактуальности реестру за 2023 год (чтобы такие клиенты не передавались в ЛКК) и сформирует реестр за 2026. Реестры за 2024 и 2025 формироваться не будут и остаются без изменений, так как уже были сформированы.
По составленному реестру НПФ 360 должна ожидать ответ от ЛКК, что клиент нажал кнопку «Получить налоговый вычет», дал согласие на обработку данных и значение поля чек-бокса о получении УНВ ежегодно. В случае, если значение чек-бокса «Получать вычет ежегодно» положительное, то автоматически договор попадает в реестр на следующий год, не ожидая кнопки «Получить налоговый вычет» и согласия клиента.
Необходимо иметь возможность просмотра неактуальных налоговых периодов (годов) при применении фильтра «Налоговый период (год)», либо по номеру реестра;
3.2. Параметры отбора.
В реестр должны отбираться все договоры подходящие под следующие условия по договорам ПДС:
1. По ПДС есть личные взносы вкладчика за предыдущие 3 года («Зачисление сберегательных взносов» (код операции PDS_DEPOSIT_ENROLLMENT, мнемоника «ПДС СВ» - «Взносы сберегательные»);
2. По которым ранее не было созданных реестров.
3. Нет зарегистрированного факта смерти в разделе «Все факты смерти»
4. У клиента в блоке «Персональный данные» есть СНИЛС на карточке ФЛ.
Условия, подходящие для отбора по договорам НПО:
1. По НПО есть личные взносы вкладчика за предыдущие 3 года (код операции DEPOSIT_ENROLLMENT, мнемоника «ИПС_ФЛ» - «Взносы ФЛ на ИПС»);
2. Нет зарегистрированного факта смерти в разделе «Все факты смерти».
3. По которым ранее не было созданных реестров.
Например, у клиента 2 личных договора ПДС (вкладчик=участнику) 1 личный договор НПО.
По № 1 договору ПДС были личные взносы только в 2024 году.
По № 2 договору ПДС были личные взносы в 2024 и 2025 году.
По договору НПО были взносы в 2023, 2024 и в 2025 году.
Клиент попадет в реестры:
2023г. – договор НПО.
2024г. – по договорам ПДС № 1 и 2 + договор НПО. (формируется 3 записи в реестре за 2024г. по 1 клиенту, потому что по параметрам отбора проходят 3 договора).
2025г. - договор № 2 ПДС + договор НПО. (формируется 2 записи в реестре за 2025г. по 1 клиенту, потому что по параметрам отбора проходят 2 договора).
Важно: при формировании реестра не учитывать взносы, которые были разнесены по документам неопознанных платежей в текущем году за предыдущий год. (Разнесение взносов описано в задаче № 51911, Формирование документов неопознанных платежей описаны в задаче № 93896). Такие взносы должны быть учтены при формировании реестра за будущий период.
Для сведения: Перевод ОПС в ПДС, а также начисление бонусных рублей по каким-либо стимулирующим акциям Фонда, в т.ч. по акции 2000, возвраты, НЕ СЧИТАЮТСЯ взносами клиентов. Личным взносом клиента считается проведённый взнос через Эквайринг (в т.ч. автоплатеж), СБП (в т.ч. автоплатеж СБП) и оплата по реквизитам. Также личным взносом не считается софинансирование от государства, инвестиционный доход и взносы юридического лица). (исключаем все мнемоники, кроме «ПДС СВ» по ПДС, «ИПС_ФЛ» - НПО).
3.3. Логика формирования xml- файла
1 xml = 1 соответствует строго 1 договору за 1 налоговый период. Если у клиента в рамках 1 налогового периода есть несколько договоров, по определенному договору формируется отдельный xml-файл за каждый налоговый период.
Пример заполненного файла xml
Структура заполнения xml приведены в приложениях 3 и 4.
3.4. Алгоритм действия системы с ЛКК и ФНС
1. Если в НПФ 360 пришел ответ от ЛКК о наличии кабинета налогоплательщика, то выделить уникальные договоры, у которых значение поля «Наличие ЛК ФНС» соответствует значению «null», «0», «99». (т.е. может быть такое, что по 1 договору пришел ответ «0» или «99», то системе необходимо на сформированные записи во всех реестрах по этому же клиенту записать значение, даже если клиент не нажимал кнопку «получить вычет» в ЛКК. По выделенным договорам НПФ 360 должна отправить запрос в API ФНС для проверки наличия у клиента ЛК ФНС. Данные для отправки запроса указаны в Таб. 3.
Таб.3. «Перечень данных для запроса наличия ЛК ФНС»
Содержание Тип Обязательность Описание
inn String Не обязательно ИНН физического лица налогоплательщика по кому проверяется наличие личного кабинета.
Может не передаваться, в таком случае будет осуществляться идентификация только по переданным паспортным данным, ФИО и дате рождения.
Пример, "526317984689"
lastName String Обязательно Фамилия физического лица налогоплательщика по кому проверяется наличие личного кабинета.
Пример, "Иванов"
firstName String Обязательно Имя физического лица налогоплательщика по кому проверяется наличие личного кабинета.
Пример, "Иван"
secondName String Не обязательно Отчество физического лица налогоплательщика по кому проверяется наличие личного кабинета
Может отсутствовать
Пример, "Иванович"
birthday String Обязательно Дата рождения физического лица налогоплательщика по кому проверяется наличие личного кабинета.
Формат даты «DD.MM.YYYY»
Пример ‘15.01.2000'
passportSerNum String Обязательно Серия и номер документа удостоверяющего личность налогоплательщика по кому проверяется наличие личного кабинета.
Формат для паспорта РФ «ssss nnnnnn»
Пример для паспорта РФ
«2200 414141»
ВАЖНО! для паспорта РФ между серией и номером должен быть пробел.
documentCode String Обязательно Код документа, удостоверяющего личность физического лица налогоплательщика, по кому проверяется наличие личного кабинета по справочнику «Справочник типов прилагаемых документов». Путь к справочнику: Персонифицированный учет - Справочники- Заявления - Справочник типов прилагаемых документов.
Пример для паспорта РФ:
«21».
2. Система должна получить ответ от API ФНС. Возможные ответы от API ФНС:
2.1. «Code»: «0». (Нет ЛК ФНС).
Если система получила ответ по клиенту со значением «0», то записать в реестр в поле «Наличие ЛК ФНС» значение 0.
2.2. «Code»: «1». (Есть ЛК ФНС).
Если система получила ответ по клиенту со значением «1», то записать в реестр в поле «Наличие ЛК ФНС» значение 1.
2.3. «Code»: «99». (проверка на наличие ЛК ФНС не успешна).
Если после повторного запроса снова вернулся “Code”: «99», то записать во все реестры, в которые попал клиент, в поле «Наличие ЛК ФНС» значение «99».
3. По тем клиентам, у которых по запросу на наличие ЛК ФНС вернулся ответ «Code»: «99» и\или «Code»: «0», то система ожидает от ЛКК команду повторного запроса о наличии ЛК ФНС (когда клиент в ЛКК нажал кнопку «Здесь », см. клиентский путь в Приложении 6.). Повторение запроса прекращается в случае, если системе по данному клиенту был зарегистрирован факт смерти в разделе «все факты смерти».
4. По тем клиентам, у которых в реестре в поле «Наличие ЛК ФНС» есть значение 0, система должна дать команду в EAPI ЛКК поставить карточке договора на фронте статус «Зарегистрируйтесь в личном кабинете налогоплательщика» (см. таблицу статусов карточки в приложении 1.)
По тем клиентам, по которым в реестре ошибок в поле «Значение ошибки» стоит значение «01» (см. значение ошибки в Таблица 1), система должна дать команду в ЕAPI ЛКК повесить в карточку договора ЛКК статус «Необходимо обновить персональные данные» (см. таблицу статусов карточки ЛКК в приложении 1).
5. После отправки уведомления из п.5, система должна ожидать по такому клиенту регистрации заявления ПД. Если данные клиента обновились, то система автоматически формирует и отправляет новый файл xml с актуальными данными клиента.
4. Автоматическое формирование реестра
4.1 Регламентное задание по формированию реестра.
Необходимо добавить новую регламентную задачу (далее - РЗ). В рамках данной задачи в блоке «Параметры задания» необходимо реализовать параметры, описанные в таб. 4.
Таб. 4. Параметры регламентного задания по формированию реестров.
Название задачи Описание задачи График выполнения Параметры
УНВ. Формирование реестра упрощенного налогового вычета Система отбирает договоры НПО/ПДС и формирует реестр в статусе «Сформирован» -20 января каждого года
-Раз в сутки в 08:00;
- необходимо иметь возможность настройки графика выполнения РЗ.
- количество повторных попыток при сбое (3); -.
Регламентная задача должна выполняться, ориентируясь на условие:
- «Налоговый период (год)» = (текущий год – 1,2,3 ).
При срабатывании задачи система отбирает договоры, подходящие под условия, описанные в п 3.2 и формирует реестр в статусе «Сформирован».
При формировании реестра необходимо проверять сумму взносов из справки о взносах и «Размер взносов за год» в реестре по каждому клиенту. Суммы должны быть равны, в случае, если суммы не равны необходимо выводить системное предупреждающее уведомление с текстом: «Сумма взносов в справке о взносах и размер взносов за год в реестре не равны». Также необходимо направлять рассылку заинтересованную группу лиц следующего вида:
Размер суммы взносов в справке о взносах «Размер взносов за год» в реестре Ссылка на справку о взносах в виде номера и даты справки Ссылка на реестр на упрощенный налоговый вычет в веди номера и даты реестра ФИО клиента
4.2 Регламентное задание по регистрации и отправке реестра в ЛКК.
Необходимо добавить новую регламентную задачу. В рамках данной задачи в блоке «Параметры задания» необходимо реализовать параметры, описанные в таб. 5.
Таб. 5. Параметры регламентного задания по регистрации и отправке реестров в ФНС .
Название задачи Описание задачи График выполнения Параметры
УНВ. Отправка реестра получение сведений в ЛКК Система осуществляет забор данных и их отправку из/в ЛКК.
Описание действия системы детализированы в п.3.3. - каждый день в 9 00;
- необходимо иметь возможность настройки графика выполнения РЗ.
- количество повторных попыток при сбое (10);
-
Регламентная задача должна предпринимать повторные попытки выполнения в случае возникновения ошибки с периодичностью 1 раз в сутки в течении указанного периода.
При выполнении условий система должна присваивать реестру статусы в соответствии со статусной моделью, описанной в п.6.
4.3 Регламентное задание реестра в ФНС.
Необходимо добавить новую регламентную задачу, Описание РЗ представлено в таб. 6.
Таб. 6. Параметры регламентного задания по регистрации и отправке реестров в ФНС .
Название задачи Описание задачи График выполнения Параметры
УНВ. Отправка реестра получение сведений в ФНС Система осуществляет забор данных и их отправку из/в ФНС.
Описание действия системы детализированы в п.3.3. - каждый день в 9 00;
- необходимо иметь возможность настройки графика выполнения РЗ.
- количество повторных попыток при сбое (10);
-
Регламентная задача должна предпринимать повторные попытки выполнения в случае возникновения ошибки с периодичностью 1 раз в сутки в течении указанного периода.
При выполнении условий система должна присваивать реестру статусы в соответствии со статусной моделью, описанной в п.6.
Уведомление.
После отправки реестра система должна направлять уведомление на группу рассылки с информацией об успешно выполненном здании. Текст «Реестр УНВ № [номер реестра в виде ссылки] успешно отправлен в ФНС.».
Если возникли системные ошибки у записей реестров, то направляется уведомление об ошибке.
Тема письма: Ошибка по API ФНС
Текст: «По высланному в ФНС договору {номер договора} для получения упрощённого налогового вычета возникла ошибка. Зайдите в реестр».
Отработка ошибок, возвращённых от ФНС
№ Статус ответа Значение ошибки Пояснение Действие НПФ 360
1 2 3 4
1 ОК null Документ прошел все проверки, налоговый орган принял сведения. Это финальное состояние обработки запроса, далее статус запроса меняться не будет. Отметить в БД успешную отправку.
2 IN_PROGRESS null Запрос в обработке. Промежуточное состояние обработки запроса Необходимо повторно сделать запрос статуса сообщения. Периодичность отправки повторных запросов описана в таб.2
3 WAIT_CONFIRM null Предварительные проверки пройдены положительно, запрос находится в ожидании поступления информации о доходах Ожидать статуса ОК или ERROR
4 ERROR application.xsd.failed Ошибка валидации. Документ не соответствует утвержденному формату или есть технические ошибки в структуре XML Система не производит никаких действий, данная ошибка остается на ручной разбор.
5 ERROR application.xsd.signature.failed Ошибка подписи. Электронная подпись не прошла проверку (возможно неверный сертификат). Система не производит никаких действий, данная ошибка остается на ручной разбор.
6 ERROR 01 Физ. лицо не идентифицировано Система заново формирует и переотправляет xml.
7 ERROR 02 Есть дата смерти физ. лица Система не производит никаких действий.
8 ERROR 07 У клиента нет личного кабинета налогоплательщика Система ждет сигнала от ЛЛК, о нажатии клиентом на кнопку «Здесь». См. п.3. 3.3
После получения сигнала формирует и отправляет xml.
9 ERROR 13 У ФНС нет сведений о договоре НПО у данного клиента. Системе необходимо проверить отправку отчетов (заключенных, вступивших в силу, прекративших действие) в ФНС.
Описание журнала, отчетов и их статусная модель находятся в задаче № 52283 В случае отправленного отчета по договору системе необходимо дождаться статуса у записи «Отправлено в СФР» и переотправить сформированный xml.
В случае, когда отправки отчета не было, системе необходимо повторно проверить наличие отчета на следующий день переотправить xml.
10 ERROR 14 У ФНС нет сведений о договоре ПДС у данного клиента. Алгоритм системы одинаковый как и при ошибке № 13. См. описание выше в данной таблице.
11 ERROR 15 У ФНС нет сведений о Фонде Система заново переотправляет xml
5. Отправка XML-файла в API ФНС.
1. По тем клиентам, у которых в реестре «Реестр на упрощённый налоговый вычет» за этот год в поле «Наличие ЛК ФНС» стоит значение «1» и статус = «Сформирован», система должна сформировать XML-файл (структура к файлу ПДС в Приложение 3, для НПО - в Приложение 4).
2. Сервис по взаимодействию с ФНС должен подписать каждый сформированный XML-файл квалифицированной электронной подписью (КЭП). Использовать подпись организации. Требования к КЭП представлены в Приложении 5.
3. Система должна отправить подписанный XML-файл в сервис по взаимодействию с ФНС.
4. После отправки XML-файлов, система должна получить ответ от API ФНС (возможные ответы от API ФНС представлены в Приложение 2, Таб. 1).
5. По тем клиентам, по которым система получила положительный ответ от API ФНС (в табл. 1 статус ответа «ОК»), система должен дать команду в EAPI ЛКК присвоить в карточку договора ЛКК статус «Данные успешно приняты ФНС» (см. Приложение 1).
Дополнительно.
Методы взаимодействия с ГНИВЦ:
1. /gnivc/check_person_has_fns_lk – проверка наличия ЛК в ФНС
2. /gnivc/tax_refund_register – отправка файла в ФНС (параметр documentType – отвечает за тип документа. Он берется из справочника по документации)
3. /gnivc/tax_refund_register/{request_id} – опрос результата отправки файла в ФНС.
6. Статусная модель
Таб. 5. Статусная модель реестров
Статус Описание Результат присваивания
№ 1. 2. 3.
1. Сформирован Присваивается в рамках регламентной задачи после формирования реестра. -Сформирован реестр отобранных договоров, запись отображается в журнале, но xml еще не отправлен в ГНИВЦ;
2. Отправлен в ЛКК Присваивается по результату нажатия на кнопку «Отправить в ЛКК». Данные отправлены в ЛКК.
3. Принят в ЛКК Присваивается по результату получения и обработки данных из ЛКК. Данные приняты в ЛКК.
4. Отправлен в ФНС Присваивается по результату нажатия на кнопку «Отправить в ФНС». Данные отправлены в ФНС.
5. Принят в ФНС Присваивается по результату получения и обработки данных из ФНС. Данные приняты в ФНС.
6. Успешно Присваивается после обработки данных из ФНС.
- В случае успешной обработки данных записывается значение «успешно» = значению ОК из приложения 2.
7. Ошибка В случае наличия ошибок записывается значение – «Ошибка» = «ERROR».
Ошибки описаны в приложении 2
8. Удален Присваивается по результату нажатия на кнопку «Удалить». Кнопка отображается только для роли ДСПД руководитель. Запись скрывается.
В системе необходимо реализовать сохранение истории изменения статусов. В интерфейсе для пользователя должен отображаться только текущий статус.
Приложение 1. Таблица статусов карточки в ЛКК.
Таблица статусов карточки в ЛКК
№ Действие клиента Статус ответа от API ФНС Значение статуса карточки на фронте
1 2 3
1 Клиент не нажал кнопку «Получить налоговый вычет» Не было ответа Ожидает вашего решения
2 Клиент нажал кнопку «Получить налоговый вычет» IN_PROGRESS или WAIT_CONFIRM Данные отправлены. Ожидание ответа от ФНС
3 Клиент нажал кнопку «Получить налоговый вычет» «ОК» Данные успешно приняты ФНС
4 Клиент нажал кнопку «Получить налоговый вычет» ERROR со значением ошибки «01» Необходимо обновить персональные данные
5 Клиент нажал кнопку «Получить налоговый вычет» ERROR со значением ошибки «07» Зарегистрируйтесь в личном кабинете налогоплательщика
6 Клиент нажал кнопку «Получить налоговый вычет» ERROR с любым значением ошибки, кроме «07» и «01» Данные отправлены. Ожидание ответа от ФНС
Описание подсказок, которые меняется в зависимости от статуса карточки на фронте.
Таблица подсказок
Значение карточки на фронте Текст подсказки Комментарий
№ 1 2 3
1 Ожидает вашего решения Нет подсказки Т.к. клиент еще не нажал кнопку
2 Данные отправлены. Ожидание ответа от ФНС Фонд направил данные в налоговый орган. Сейчас идет обработка информации. Как правило, мы получаем ответ в течении дня. Как только ФНС примет данные, то следующий шаг - формирование заявления на вычет в вашем личном кабинете налогоплательщика. Скоро тут появится информация о дальнейших действиях.
3 Данные успешно приняты ФНС Ваши данные успешно приняты ФНС! Если вы оформляли упрощенный налоговый вычет до 25 февраля, то после 20 марта ФНС сформирует и направит вам заявление. Если оформление вычета было после 25 февраля, то через 20 дней с даты принятия заявления. Следите за появлением заявления в личном кабинете налогоплательщика. Его нужно будет подписать и указать банковские реквизиты для получения вычета. Для увеличения размера налогового вычета в следующем году, рекомендуем реинвестировать вычет через пополнение счёта. Фрагмент «Пополнить счёт» сделать гиперссылкой. При нажатии должна открыться страница с оплатой по данному договору и в поле «Сумма платежа» должна быть сумма из поля «Предварительный расчёт». Сумма должна редактироваться.
4 Необходимо обновить персональные данные Необходимо обновить ваши персональные данные для корректной подачи информации в налоговый орган. Перейдите в раздел Заявления и выберете “Обновить персональные данные”. Обновите персональные данные легко с помощью Госуслуг. После обновления персональных данных, Фонд сам отправит данные в ФНС повторно. Фрагмент «Обновить персональные данные» сделать гиперссылкой. При нажатии перевести клиента на оформление заявления ПДБР в ЛКК
5 Зарегистрируйтесь в личном кабинете налогоплательщика Для получения налогового вычета в упрощённом порядке необходимо зарегистрироваться в личном кабинете налогоплательщика. Для этого откройте страницу входа в ЛК ФНС. нажмите кнопку “Получить доступ к сервису”. Вам будет предложены три способа получения доступа. Получите доступ. После осуществления регистрации, вернитесь в личный кабинет Фонда и нажмите здесь Фрагмент «входа в ЛК ФНС» сделать гиперссылкой. При нажатии необходимо открыть новую вкладку в браузере https://www.nalog.gov.ru/rn77/fl/interest/lk-account/ .
Фрагмент «здесь» сделать гиперссылкой. При нажатии происходит повторная попытка отправки данных в ФНС по процессу «Отправка XML-файла в API ФНС» и статус карточки меняется на «Данные отправлены. Ожидание ответа от ФНС»
Приложение 2
В соответствии с таб.1 необходимо реализовать справочник «Ответы от системы ГНИВЦ».
Таб. 1. «Ответы от системы ГНИВЦ»
№ Статус ответа Значение ошибки Пояснение
1 2 3
1 ОК null Документ прошел все проверки, налоговый орган принял сведения. Это финальное состояние обработки запроса, далее статус запроса меняться не будет.
2 IN_PROGRESS null Запрос в обработке. Промежуточное состояние обработки запроса
3 WAIT_CONFIRM null Предварительные проверки пройдены положительно, запрос находится в ожидании поступления информации о доходах
4 ERROR application.xsd.failed Ошибка валидации. Документ не соответствует утвержденному формату или есть технические ошибки в структуре XML
5 ERROR application.xsd.signature.failed Ошибка подписи. Электронная подпись не прошла проверку (возможно неверный сертификат).
6 ERROR 01 Физ. лицо не идентифицировано
7 ERROR 02 Есть дата смерти физ. лица
8 ERROR 07 У клиента нет личного кабинета налогоплательщика
9 ERROR 13 У ФНС нет сведений о договоре НПО у данного клиента.
10 ERROR 14 У ФНС нет сведений о договоре ПДС у данного клиента.
11 ERROR 15 У ФНС нет сведений о Фонде
Таб. 2. «Периодичность отправки повторного запроса для «Вычеты» при статусе «IN_PROGRESS»»
Вид налогового вычета Номер запроса по счету Время повторной отправки запроса статуса
Вычет по договорам НПО;
Вычет по договорам ПДС. 1 через 1 минуту после отправки запроса
2 через 10 минуту после запроса последнего статуса
3 через 10 минуту после запроса последнего статуса
4 через 1 час после запроса последнего статуса
n через 24 часа после запроса последнего статуса
Где n – каждый последующий номер запроса по счёту
Приложение 3. «Формат представления негосударственным пенсионным фондом в налоговый орган сведений, необходимых в целях предоставления налогового вычета на долгосрочные сбережения граждан в сумме уплаченных сберегательных взносов по договору долгосрочных сбережений, предусмотренного подпунктом 2 пункта 1 статьи 219.2 Налогового кодекса Российской Федерации, в электронной форме»
Таблица 1
Файл обмена (Файл)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Идентификатор документа ИдДок A T(1-255) О Содержит имя сформированного документа (без расширения), имеет следующий вид:
H_O_GGGGMMDD_N, где:
H - префикс, принимающий значение SVEDVYCH2.1.219.2;
О - идентификатор отправителя информации –идентификационный номер налогоплательщика (далее - ИНН);
GGGG - год, MM - месяц, DD - день направления сформированного документа;
N - глобальный уникальный идентификатор (GUID), содержит тридцать две шестнадцатеричных цифры
Версия формата ВерсФорм A T(1-5) О Принимает значение: 1.01
Состав и структура документа Документ С О Состав элемента представлен в таблице 2
Таблица 2
Состав и структура документа (Документ)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код формы отчетности по классификатору налоговых документов (КНД) КНД A О Типовой элемент <КНДТип>.
Принимает значение: 1184070
Дата формирования сведений ДатаСвед A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Время формирования сведений ВремяСвед A О Типовой элемент <ВремяТип>.
Время в формате ЧЧ:ММ:СС
Идентификатор сведений НомерСвед A N(10) О Уникальный идентификатор сведений внутри одного негосударственного пенсионного фонда - отправителя информации для конкретного физического лица, уплатившего сберегательные взносы по договору долгосрочных сбережений (далее – налогоплательщик, договор ДС соответственно), договора ДС и типа сведений. При направлении повторных, скорректированных сведений (в отношении одного и того же налогоплательщика, договора ДС и типа сведений) элемент «Идентификатор сведений» принимает значение, равное значению первичных сведений.
Идентификатор сведений = ИдФайл.
Значение «ИдФайл» необходимо тянуть из справки о взносах.
Сведения о негосударственном пенсионном фонде, с которым заключен договор ДС СвФонд С О Состав элемента представлен в таблице 3
Сведения об организации - уполномоченном представителе СвОргПред С Н Состав элемента представлен в таблице 4
Сведения о налогоплательщике СвНП П О Типовой элемент <ПерсДанФЛТип>.
Состав элемента представлен в таблице 9
Сведения о договоре ДС СвДог С О Состав элемента представлен в таблице 5
Таблица 3
Сведения о негосударственном пенсионном фонде, с которым заключен договор ДС (СвФонд)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Полное наименование негосударственного пенсионного фонда НаимФонд A T(1-1000) О
ИНН негосударственного пенсионного фонда ИННФонд A О Типовой элемент <ИННЮЛТип>
Код причины постановки на учет (далее - КПП) негосударственного пенсионного фонда КППФонд A О Типовой элемент <КППТип>
Таблица 4
Сведения об организации - уполномоченном представителе (СвОргПред)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Полное наименование организации - уполномоченного представителя НаимОргПред A T(1-1000) О
ИНН организации - уполномоченного представителя ИННОргПред A О Типовой элемент <ИННЮЛТип>
КПП организации - уполномоченного представителя КППОргПред A О Типовой элемент <КППТип>
Таблица 5
Сведения о договоре ДС (СвДог)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Дата договора ДС ДатаДог A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Номер договора ДС НомДог A T(1-50) О
Статус договора ДС СтатДС A T(=1) ОК Принимает значение:
1 – заключен первично |
2 – заключен с переводом
Налогоплательщик и физическое лицо, в пользу которого заключен договор ДС, являются одним лицом ПрЛиц A T(=1) ОК Принимает значение:
0 – нет |
1 – да
Сведения о физическом лице, в пользу которого заключен договор ДС СвФЛДС П Н Типовой элемент <ПерсДанФЛТип>.
Состав элемента представлен в таблице 9.
Элемент обязателен при <ПрЛиц>=0 и не заполняется при <ПрЛиц>=1
Сведения о договоре ДС, заключенном с негосударственным пенсионным фондом - предшественником СвДогПредш С Н Состав элемента представлен в таблице 6.
Элемент обязателен при значении элемента <СтатДС>=2
Сведения о фактических расходах налогоплательщика на уплату сберегательных взносов по договору ДС, необходимые в целях предоставления налогового вычета на долгосрочные сбережения граждан по налогу на доходы физических лиц СвРасх С О Состав элемента представлен в таблице 7
Таблица 6
Сведения о договоре ДС, заключенном с негосударственным пенсионным фондом - предшественником (СвДогПредш)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Полное наименование негосударственного пенсионного фонда - предшественника НаимФонд A T(1-1000) О
ИНН негосударственного пенсионного фонда - предшественника ИННФонд A О Типовой элемент <ИННЮЛТип>
КПП негосударственного пенсионного фонда - предшественника КППФонд A О Типовой элемент <КППТип>
Дата договора ДС ДатаДог A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Номер договора ДС НомДог A T(1-50) О
Таблица 7
Сведения о фактических расходах налогоплательщика на уплату сберегательных взносов по договору ДС, необходимые в целях предоставления налогового вычета на долгосрочные сбережения граждан по налогу на доходы физических лиц (СвРасх)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Налоговый период Период A О Типовой элемент <xs:gYear>.
Год в формате ГГГГ
Общая сумма расходов на уплату пенсионных взносов по договору ДС ОбщСумРасх С ОМ Состав элемента представлен в таблице 8
Таблица 8
Общая сумма расходов на уплату пенсионных взносов по договору ДС (ОбщСумРасх)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Дата уплаты сберегательных взносов по договору ДС ДатаУпл A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Дата уплаты = дате регистрации документа «Поступление взносов» (значение берется из журнала взносов из поля «Дата входящего платежного поручения»).
Сумма денежных средств СуммаДС A N(15.2) О Построчно собирается сумма взносов в разбивке по платежам за год.
Таблица 9
Персональные данные физического лица (ПерсДанФЛТип)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Дата рождения ДатаРожд A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
ИНН физического лица ИННФЛ A Н Типовой элемент <ИННФЛТип>
Фамилия, имя, отчество (при наличии) ФИО П О Типовой элемент <ФИОТип>.
Состав элемента представлен в таблице 11
Данные документа, удостоверяющего личность УдЛичнФЛ П Н Типовой элемент <УдЛичнФЛКТип>.
Состав элемента представлен в таблице 10.
Элемент обязателен при отсутствии элемента <ИННФЛ>
Таблица 10
Сведения о документе, удостоверяющем личность (УдЛичнФЛКТип)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код вида документа, удостоверяющего личность КодВидДок A ОК Типовой элемент <СПДУЛТип>.
Принимает значение в соответствии с кодами видов документов:
21 - паспорт гражданина Российской Федерации |
03 - свидетельство о рождении |
07 - военный билет |
08 - временное удостоверение, выданное взамен военного билета |
10 - паспорт иностранного гражданина |
11 - свидетельство о рассмотрении ходатайства о признании лица беженцем на территории Российской Федерации по существу |
12 - вид на жительство в Российской Федерации |
13 - удостоверение беженца |
14 - временное удостоверение личности гражданина Российской Федерации |
15 - разрешение на временное проживание в Российской Федерации |
19 - свидетельство о предоставлении временного убежища на территории Российской Федерации |
22 - загранпаспорт гражданина Российской Федерации |
23 - свидетельство о рождении, выданное уполномоченным органом иностранного государства |
24 - удостоверение личности военнослужащего Российской Федерации |
27 - военный билет офицера запаса |
91 - иные документы
Серия и номер документа СерНомДок A T(1-25) О
Таблица 11
Фамилия, имя, отчество (ФИОТип)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Фамилия Фамилия A T(1-60) О
Имя Имя A T(1-60) О
Отчество Отчество A T(1-60) Н
Приложение 4. «Формат представления негосударственным пенсионным фондом в налоговый орган сведений, необходимых в целях предоставления налогового вычета на долгосрочные сбережения граждан в сумме уплаченных пенсионных взносов по договору негосударственного пенсионного обеспечения, предусмотренного подпунктом 1 пункта 1 статьи 219.2 Налогового кодекса Российской Федерации, в электронной форме»
Таблица 1
Файл обмена (Файл)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Идентификатор документа ИдДок A T(1-255) О Содержит имя сформированного документа (без расширения), имеет следующий вид:
H_O_GGGGMMDD_N, где:
H - префикс, принимающий значение SVEDVYCH1.1.219.2;
О - идентификатор отправителя информации –идентификационный номер налогоплательщика (далее - ИНН);
GGGG - год, MM - месяц, DD - день направления сформированного документа;
N - глобальный уникальный идентификатор (GUID), содержит тридцать две шестнадцатеричных цифры
Версия формата ВерсФорм A T(1-5) О Принимает значение: 1.01
Состав и структура документа Документ С О Состав элемента представлен в таблице 2
Таблица 2
Состав и структура документа (Документ)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код формы отчетности по классификатору налоговых документов (КНД) КНД A ОК Типовой элемент <КНДТип>.
Принимает значение: 1184069
Дата формирования сведений ДатаСвед A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Время формирования сведений ВремяСвед A О Типовой элемент <ВремяТип>.
Время в формате ЧЧ:ММ:СС
Идентификатор сведений НомерСвед A N(10) О Уникальный идентификатор сведений внутри одного негосударственного пенсионного фонда - отправителя информации для конкретного физического лица, уплатившего пенсионные взносы по договору негосударственного пенсионного обеспечения, предусматривающему выплату негосударственной пенсии (далее – налогоплательщик, договор НПО соответственно), договора НПО, и типа сведений. При направлении повторных, скорректированных сведений (в отношении одного и того же налогоплательщика, договора НПО и типа сведений) элемент «Идентификатор сведений» принимает значение, равное значению первичных сведений
Идентификатор сведений = ИдФайл.
Значение «ИдФайл» необходимо тянуть из справки о взносах.
Сведения о негосударственном пенсионном фонде, с которым заключен договор НПО СвФонд С О Состав элемента представлен в таблице 3
Сведения об организации - уполномоченном представителе СвОргПред С Н Состав элемента представлен в таблице 4
Сведения о налогоплательщике СвНП П О Типовой элемент <ПерсДанФЛТип>.
Состав элемента представлен в таблице 8
Сведения о договоре НПО СвДог С О Состав элемента представлен в таблице 5
Таблица 3
Сведения о негосударственном пенсионном фонде, с которым заключен договор НПО (СвФонд)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Полное наименование негосударственного пенсионного фонда НаимФонд A T(1-1000) О
ИНН негосударственного пенсионного фонда ИННФонд A О Типовой элемент <ИННЮЛТип>
Код причины постановки на учет (далее - КПП) негосударственного пенсионного фонда КППФонд A О Типовой элемент <КППТип>
Таблица 4
Сведения об организации - уполномоченном представителе (СвОргПред)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Полное наименование организации - уполномоченного представителя НаимОргПред A T(1-1000) О
ИНН организации - уполномоченного представителя ИННОргПред A О Типовой элемент <ИННЮЛТип>
КПП организации - уполномоченного представителя КППОргПред A О Типовой элемент <КППТип>
Таблица 5
Сведения о договоре НПО (СвДог)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Дата договора НПО ДатаДог A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Номер договора НПО НомДог A T(1-50) О
Налогоплательщик и физическое лицо, в пользу которого заключен договор НПО, являются одним лицом ПрВыгодопр A T(=1) ОК Принимает значение:
0 – нет |
1 – да
Сведения о физическом лице, в пользу которого заключен договор НПО СвФЛНПО П Н Типовой элемент <ПерсДанФЛТип>.
Состав элемента представлен в таблице 8.
Элемент обязателен при <ПрВыгодопр>=0 и не заполняется при <ПрВыгодопр>=1
Сведения о фактических расходах налогоплательщика на уплату пенсионных взносов по договору НПО, необходимые в целях предоставления налогового вычета на долгосрочные сбережения граждан по налогу на доходы физических лиц СвРасх С О Состав элемента представлен в таблице 6
Таблица 6
Сведения о фактических расходах налогоплательщика на уплату пенсионных взносов по договору НПО, необходимые в целях предоставления налогового вычета на долгосрочные сбережения граждан по налогу на доходы физических лиц (СвРасх)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Налоговый период Период A О Типовой элемент <xs:gYear>.
Год в формате ГГГГ
Общая сумма расходов на уплату пенсионных взносов по договору НПО ОбщСумРасх С ОМ Состав элемента представлен в таблице 7
Таблица 7
Общая сумма расходов на уплату пенсионных взносов по договору НПО (ОбщСумРасх)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Дата уплаты пенсионных взносов по договору НПО ДатаУпл A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
Сумма денежных средств СуммаДС A N(15.2) О
Таблица 8
Персональные данные физического лица (ПерсДанФЛТип)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Дата рождения ДатаРожд A О Типовой элемент <ДатаТип>.
Дата в формате ДД.ММ.ГГГГ
ИНН физического лица ИННФЛ A Н Типовой элемент <ИННФЛТип>
Фамилия, имя, отчество (при наличии) ФИО П О Типовой элемент <ФИОТип>.
Состав элемента представлен в таблице 10
Данные документа, удостоверяющего личность УдЛичнФЛ П Н Типовой элемент <УдЛичнФЛКТип>.
Состав элемента представлен в таблице 9.
Элемент обязателен при отсутствии элемента <ИННФЛ>
Таблица 9
Сведения о документе, удостоверяющем личность (УдЛичнФЛКТип)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Код вида документа, удостоверяющего личность КодВидДок A ОК Типовой элемент <СПДУЛТип>.
Принимает значение в соответствии с кодами видов документов:
21 - паспорт гражданина Российской Федерации |
03 - свидетельство о рождении |
07 - военный билет |
08 - временное удостоверение, выданное взамен военного билета |
10 - паспорт иностранного гражданина |
11 - свидетельство о рассмотрении ходатайства о признании лица беженцем на территории Российской Федерации по существу |
12 - вид на жительство в Российской Федерации |
13 - удостоверение беженца |
14 - временное удостоверение личности гражданина Российской Федерации |
15 - разрешение на временное проживание в Российской Федерации |
19 - свидетельство о предоставлении временного убежища на территории Российской Федерации |
22 - загранпаспорт гражданина Российской Федерации |
23 - свидетельство о рождении, выданное уполномоченным органом иностранного государства |
24 - удостоверение личности военнослужащего Российской Федерации |
27 - военный билет офицера запаса |
91 - иные документы
Серия и номер документа, удостоверяющего личность СерНомДок A T(1-25) О
Таблица 10
Фамилия, имя, отчество (ФИО Тип)
Наименование элемента Сокращенное наименование (код) элемента Признак типа элемента Формат элемента Признак обязательности элемента Дополнительная информация
Фамилия Фамилия A T(1-60) О
Имя Имя A T(1-60) О
Отчество Отчество A T(1-60) Н
Приложение 5. «Требования к формату отсоединенной подписи в рамках взаимодействия с Вычеты»
Требования к используемой ЭЦП
1) Отсоединенная подпись, отправляемая вместе с заявлением на налоговый вычет, должна соответствовать стандарту CMS/PKCS#7
2) Допустимы следующие расширения ЭЦП:.p7s; .sig; .sign
3) Алгоритм подписи, Хэш-алгоритм и алгоритм подписи должен соответствовать ГОСТ Р 34.11-2012/ 34.10-2012 «Информационная технология. Криптографическая защита информации. Процессы формирования и проверка электронной цифровой подписи» в 256 бит.
Требования к открытому ключу сертификата
Для корректного прохождения проверки достоверности ЭЦП в заявлении на регистрацию налогового агента должен присутствовать открытый ключ сертификата. Открытый ключ должен соответствовать требованиям ГОСТ 34.11-2012 2 «Информационная технология. Криптографическая защита информации. Процессы формирования и проверки электронной цифровой подписи» в 256 бит.
Описание алгоритма работы с подписью
При регистрации участник ИО направляет «сертификат ключа проверки» в ПП «Вычеты» (метод /taxbenefits/v1/registration) в виде элемента, закодированного в base64. При прохождении всех проверок на стороне ПП «Вычеты» данный сертификат сохраняется в БД и используется при верификации направленных заявлений (метод /taxbenefits /v1/application/{documentType}) данным участником ИО.
При направлении заявления о налоговом вычете участник ИО создает xml документ, помещает его и приватный ключ в функцию подписи и создает подпись документа - набор байтов, который единственным образом определяет содержимое переданного документа xml и приватной подписи участника ИО. Это позволяет гарантировать неизменность направляемого файла и идентифицировать его отправителя.
Закодированный в base64 документ и, отдельным элементом, подпись (формат подписи описан ниже) направляются в ПП «Вычеты», где происходит ее верификация. В данном процессе используется исходный xml, подпись и открытый ключ, переданный при регистрации. Данная функция проверяет, отличается ли зашифрованный в подписи документ от переданного и соответствует ли подпись данному партнеру. Если ответ функции true, тогда проверка пройдена. Иначе фиксируется ошибка.
Общие требования к сертификату
1) Алгоритм подписи ГОСТ Р 34.11-2012/34.10-2012 256 бит
2) Хэш-алгоритм подписи ГОСТ Р 34.11-2012 256 бит
3) Открытый ключ ГОСТ Р 34.10-2012 256 бит
Приложение 6. Клиентский путь оформления упрощённого налогового вычета в ЛКК.
1. На главной странице ЛКК пользователь с договорами, по которым можно получить УНВ (условия для УНВ см. Создание реестра «Реестр на упрощённый налоговый вычет» п.1) должен увидеть баннер между верхним меню и информацией о своем профиле (см. макет баннера ниже)
Макет баннера
2. На баннере должен быть заголовок: «Упрощённый налоговый вычет в один клик в вашем личном кабинете»
Подзаголовок 1: «Подготовим и отправим все документы за вас»
Подзаголовок 2: «Без деклараций и визита в ФНС»
Кнопка: «За вычетом!». При нажатии на кнопку клиент переходит на новую страницу с сервисом по оформлению УНВ.
3. На главной странице, в карточке договора, которому доступен УНВ (условия доступности УНВ описаны в «Создание реестра «Реестр на упрощённый налоговый вычет» п.1) в сервисных функциях сделать кнопку «Упрощённый налоговый вычет». (см. макет ниже). При нажатии кнопки клиент попадает на новую страницу с сервисом по УНВ.
Макет кнопки
4. Пользователь переходит на страницу УНВ (по кнопкам из п.2 или п.3).
5. На странице УНВ сделать заголовок: «Упрощённый налоговый вычет»
Подзаголовок: «Уважаемый клиент!»
Текст: «Ниже указаны ваши договоры, по которым вы можете получить налоговый вычет в упрощённом порядке. Мы сами соберем всю информацию по вашему договору и отправим в Федеральную Налоговую Службу (ФНС) Справку об уплате взносов. Обращаем внимание, что налоговый вычет по НДФЛ в сумме уплаченных взносов можно получить по итогам прошедшего года в текущем году году.»
(окончательный вариант текста будет предоставлен позднее)
6. Клиент должен увидеть карточку договора, по которому доступен УНВ (условия доступности УНВ описаны в «Создание реестра «Реестр на упрощённый налоговый вычет» п.1).
7. На карточке договора должны быть поля и подсказки:
• Поле «Договор» – отображение номера договора ПДС или НПО.
• Поле «Накоплено всего» - отражается сумма всех накоплений по договору.
• Поле «Выберете налоговый период» - необходимо сделать выпадающий список с доступными для клиента годом в формате YYYY. Автоматически в этом списке должны появляться новые значения года, в зависимости от наступления нового года. Например, в 2025 году клиенту должен быть доступен выбор только 2024 года. В 2026 году клиенту должны быть доступны 2024 и 2025 годы на выбор и т.д.
Важно: клиенту должны быть доступны на выбор максимально последние 3 года. Например, если наступил 2028 год, то клиенту на выбор могут быть доступны только 2025, 2026 и 2027 (при наличии личных взносов). Если наступил 2029, то доступны 2026, 2027 и 2028 и т.д.
• Подсказка рядом с полем «Выберете налоговый период». Подсказка появляется при нажатии на знак информации. Текст подсказки: «Выберете год, за который хотите получить вычет. Обращаем внимание, что вычет в упрощённом порядке вы можете получить за предыдущий год. Например, в 2025 году, вы можете получить вычет за вносы, уплаченные в 2024 году. Чтобы узнать предварительную сумму вычета, выберите год в поле "Выберите налоговый период". Сервис рассчитает предварительную сумму вычета по каждому налоговому периоду.» (окончательный вариант текста будет предоставлен позднее)
• Поле «Взносы за период» - сумма взносов за выбранный налоговый период. Например, если клиент выбрал в поле «Выберете налоговый период» 2024 год, то в поле «Взносы за период» должна быть общая сумма уплаченных взносов за 2024 год. Важно: не учитывать выплаты, софинансирование и инвестиционный доход, перевод ОПС в ПДС. Только личная оплата взноса клиентом.
• Поле «Предварительный расчёт» - предварительная сумма, которую клиент может получить через налоговый вычет. Формула: сумма взносов за выбранный налоговый период * 13%. Например, если у клиента в 2024 году взносов было на 100 000 руб, то в поле «Предварительный расчёт» должна получиться цифра = 100 000 р * 13% = 13 000 р.
Важно: Максимальная сумма в поле «Предварительный расчёт» для НПО и для ПДС ровно 52 000 руб. Если по формуле исчислена сумма менее 52 000 руб, то показать итоговую сумму. Если расчёт составил более 52 000 руб, то показать ровно 52 000 руб.
Важно: Для клиентов, у которых НПО был заведен до 2025 года, предварительный расчет исчисляется также по формуле сумма взносов за выбранный налоговый период * 13%. Но если сумма расчёта превысила 19 500 руб, тогда оставить сумму ровно в 19 500 руб. Для НПО, заключенных после 2025 включительно, формула расчета ограничение такое же, как для ПДС.
• Подсказка рядом с полем «Предварительный расчёт». Подсказка появляется при нажатии на знак информации. Текст подсказки: «По выбранному вами налоговому периоду был произведен предварительный расчет. Сумма рассчитывается по формуле: сумма всех взносов за выбранный налоговый период умноженная на 13%. Обращаем внимание, что сумма предварительная. Окончательная сумма будет рассчитана Федеральной налоговой службой (ФНС).» (окончательный вариант текста будет предоставлен позднее).
• Чек-бокс «Получать вычет ежегодно». Кнопка «Включить» проставляет отметку в чек-бокс. Кнопка «Выключить» снимает отметку.
• Подсказка рядом с чек-боксом. Подсказка появляется при нажатии на знак информации. Текст подсказки: Ежегодно, Фонд сам будет отправлять данные по вашему договору в ФНС, начиная с выбранного вами налогового периода. Например, вы выбрали налоговый период 2024 год и поставить галочку "Получать вычет ежегодно". Значит за 2025 год и все налоговые периоды Фонд сам отправит по вам данные в ФНС. Фонд направляет данные, начиная с 20 января каждого нового года. Рекомендуем воспользоваться нашей услугой.» (окончательный вариант текста будет предоставлен позднее).
• Кнопка «Получить налоговый вычет». Под кнопкой «Получить налоговый вычет» сделать текст: «Нажимая на кнопку “Получить налоговый вычет” вы даете согласие обработку персональных данных и на отправку ваших данных в ФНС» (окончательный вариант текста будет предоставлен позднее).
Часть текста «обработку персональных данных» сделать гиперссылкой. При нажатии на гиперссылку должен скачиваться файл с согласием на обработку персональных данных в формате PDF. (Файл с согласием будет предоставлен позднее).
• Статус карточки (значение статусов отображено в таблице ниже). Макет карточки ниже.
Макет карточки (все макеты будут предоставлены при разработке)
8. При нажатии кнопки «Получить налоговый вычет» ЛКК должен сохранить данные в полях карточки и передать их в реестр на отправку (см «Создание реестра «Реестр на упрощённый налоговый вычет»). После нажатия пропадает кнопка и текст согласия. Статус меняется в соответствии с таблицей ниже (см. таблица статусов карточки).
9. В БД ЛКК должна быть отметка о том, что клиент дал согласие на обработку данных.
10. В БД ЛКК должна быть пометка о том, нажал ли клиент чек-бокс «Получать вычет ежегодно».
11. Если в БД ЛКК стоит отметка «Получать вычет ежегодно», то отправка данных по этому договору в ФНС должна происходить автоматически (описано в разделе «Создание реестра «Реестр на упрощённый налоговый вычет» п.3)
Таблица статусов карточки:
№ Действие клиента Статус ответа от API ФНС Значение статуса карточки на фронте
1 2 3
1 Клиент не нажал кнопку «Получить налоговый вычет» Не было ответа Ожидает вашего решения
2 Клиент нажал кнопку «Получить налоговый вычет» IN_PROGRESS или WAIT_CONFIRM Данные отправлены. Ожидание ответа от ФНС
3 Клиент нажал кнопку «Получить налоговый вычет» «ОК» Данные успешно приняты ФНС
4 Клиент нажал кнопку «Получить налоговый вычет» ERROR со значением ошибки «01» Необходимо обновить персональные данные
5 Клиент нажал кнопку «Получить налоговый вычет» ERROR со значением ошибки «07» Зарегистрируйтесь в личном кабинете налогоплательщика
6 Клиент нажал кнопку «Получить налоговый вычет» ERROR с любым значением ошибки, кроме «07» и «01» Данные отправлены. Ожидание ответа от ФНС
12. На месте убранных кнопки и текста согласия, должна появиться подсказка, которая меняется в зависимости от статуса карточки на фронте (см. таблица подсказок).
Таблица подсказок.
№ Значение карточки на фронте Текст подсказки Комментарий
1 2 3
1 Ожидает вашего решения Нет подсказки Т.к. клиент еще не нажал кнопку
2 Данные отправлены. Ожидание ответа от ФНС Фонд направил данные в налоговый орган. Сейчас идет обработка информации. Как правило, мы получаем ответ в течении дня. Как только ФНС примет данные, то следующий шаг - формирование заявления на вычет в вашем личном кабинете налогоплательщика. Скоро тут появится информация о дальнейших действиях.
3 Данные успешно приняты ФНС Ваши данные успешно приняты ФНС! Если вы оформляли упрощенный налоговый вычет до 25 февраля, то после 20 марта ФНС сформирует и направит вам заявление. Если оформление вычета было после 25 февраля, то через 20 дней с даты принятия заявления. Следите за появлением заявления в личном кабинете налогоплательщика. Его нужно будет подписать и указать банковские реквизиты для получения вычета. Для увеличения размера налогового вычета в следующем году, рекомендуем реинвестировать вычет через пополнение счёта. Фрагмент «Пополнить счёт» сделать гиперссылкой. При нажатии должна открыться страница с оплатой по данному договору и в поле «Сумма платежа» должна быть сумма из поля «Предварительный расчёт». Сумма должна редактироваться.
4 Необходимо обновить персональные данные Необходимо обновить ваши персональные данные для корректной подачи информации в налоговый орган. Перейдите в раздел Заявления и выберете “Обновить персональные данные”. Обновите персональные данные легко с помощью Госуслуг. После обновления персональных данных, Фонд сам отправит данные в ФНС повторно. Фрагмент «Обновить персональные данные» сделать гиперссылкой. При нажатии перевести клиента на оформление заявления ПДБР в ЛКК
5 Зарегистрируйтесь в личном кабинете налогоплательщика Для получения налогового вычета в упрощённом порядке необходимо зарегистрироваться в личном кабинете налогоплательщика. Для этого откройте страницу входа в ЛК ФНС. нажмите кнопку “Получить доступ к сервису”. Вам будет предложены три способа получения доступа. Получите доступ. После осуществления регистрации, вернитесь в личный кабинет Фонда и нажмите здесь Фрагмент «входа в ЛК ФНС» сделать гиперссылкой. При нажатии необходимо открыть новую вкладку в браузере https://www.nalog.gov.ru/rn77/fl/interest/lk-account/ .
Фрагмент «здесь» сделать гиперссылкой. При нажатии происходит повторная попытка отправки данных в ФНС по процессу «Отправка XML-файла в API ФНС» и статус карточки меняется на «Данные отправлены. Ожидание ответа от ФНС»
** окончательный текст подсказок будет предоставлен позднее.
