https://pastein.ru/t/xGA
Загрузка данных
Бизнес-требования к функционалу автоматизированного формирования реестров по упрощенному налоговому вычету в НПФ 360
Оглавление
1. Общие требования 3
2. Описание журнала 3
3. Формирование реестра 7
3.1. Логика формирования реестра 7
5.1. Параметры отбора. 9
6. Автоматическое формирование реестра и отправка в ГНИВЦ 9
6.1. Регламентное задание по формированию реестра. 9
Описание задания. 9
Уведомление. 10
7.3. Регламентное задание по регистрации и отправке реестра. 10
Описание задания. 10
Уведомление. 10
5. Отправка XML-файла в API ФНС. 11
6. Статусная модель 11
Приложение 1. Таблица статусов карточки в ЛКК. 11
Приложение 2 14
Таб. 1. «Ответы от системы Вычет» 14
Таб. 2. «Периодичность отправки повторного запроса для «Вычеты» при статусе «IN_PROGRESS»» 15
Приложение 3. «Формат представления негосударственным пенсионным фондом в налоговый орган сведений, необходимых в целях предоставления налогового вычета на долгосрочные сбережения граждан в сумме уплаченных сберегательных взносов по договору долгосрочных сбережений, предусмотренного подпунктом 2 пункта 1 статьи 219.2 Налогового кодекса Российской Федерации, в электронной форме» 16
Приложение 4. «Формат представления негосударственным пенсионным фондом в налоговый орган сведений, необходимых в целях предоставления налогового вычета на долгосрочные сбережения граждан в сумме уплаченных пенсионных взносов по договору негосударственного пенсионного обеспечения, предусмотренного подпунктом 1 пункта 1 статьи 219.2 Налогового кодекса Российской Федерации, в электронной форме» 28
Приложение 5. «Требования к формату отсоединенной подписи в рамках взаимодействия с Вычеты» 38
Термины и определения
Термин Определение
Пользователь Пользователь сайта – физическое лицо
API ФНС Прикладная система «Вычеты» от ГНИВЦ
Заявление ПДБР Заявление на изменение персональных данных и банковских реквизитов
ЕAPI фонда Внутренняя система ЕAPI (бекенд)
ПДС Программа долгосрочных сбережений
ДДС Договор долгосрочных сбережений
ЛКК Личный кабинет клиента
ЛК ФНС Личный кабинет налогоплательщика ФНС
УНВ Упрощённый налоговый вычет
1. Общие требования
В НПФ 360 (далее – система) необходимо реализовать формирование реестров, их отправку и получение сведений на предоставления упрощённого налогового вычета для повышения лояльности клиентов.
В рамках данных бизнес-требований должен быть реализован следующий функционал:
- Формирование реестров «Реестр на упрощённый налоговый вычет» за 3 предыдущих года;
- Передача и получение сведений в ФНС;
- Взаимодействие с ЛКК;
Схема процесса:
2. Описание журнала
В «НПФ 360» необходимо реализовать новый раздел, в котором будут отражаться сформированные реестры для ФНС по подаче заявлений на УНВ за прошедшие 3 года, исключая текущий год, в разрезе каждого договора НПО/ДС. Путь к разделу: Персонифицированный учет – Отчетность – ФНС– Реестр на упрощенный налоговый вычет (Рис. 1).
Рис. 1. Путь к разделу.
В разделе должен отображаться журнал реестров с информацией для ФНС. Макет целевого состояния журнала представлен на рис. 2.
Рис. 2. Макет целевого состояния журнала.
При создании реестра создается запись реестра в журнале «Реестры на упрощённый налоговый вычет». Описание полей журнала представлено в таб. 1.
Таб. 1. Описание полей журнала.
Наименование поля Тип данных Описание
№ 1 2 3
1. ID Текст Отображается идентификационный номер запроса;
2. Дата реестра Дата
Формат: DD.MM.YYYY Отображается дата создания реестра;
3. № реестра Целое число Отображается номер реестра;
4. Дата отправки в ФНС Дата
Формат: DD.MM.YYYY Отображается дата отправки реестра в ФНС;
5. Налоговый период (год) Дата
Формат: YYYY Отчётный период, за который собирается информация;
6. Документ в ФНС Бинарные данные Отображается иконка ссылки на сформированный файл xml. Файл хранится в БД в бинарном виде.
7. Статус Текст Отображается текущий статус реестра. Описание статусной модели в п.6.
8. Ответ ФНС Бинарные данные Отображается ссылка на файл с ошибками. Описание данных в приложении 2.
Файл хранится в БД в бинарном виде.
При выделении записи в таблице с реестрами необходимо чтобы ниже отображалась таблица с клиентами, включенными в данные реестр. Описание данных в таблице представлено ниже в Таб.2.
Таб. 2. Описание полей детализирующей таблицы с клиентами.
Наименование поля Тип данных Описание
№ 1. 2. 3.
1. Клиент ссылка Отображается ФИО клиента в виде ссылки на карточку ФЛ;
2. СНИЛС строка Отображается СНИЛС клиента. Данные тянутся из карточки ФЛ;
3. Вид деятельности строка Отображается вид деятельности договора;
4. № договора ссылка Отображается номер договора в виде ссылки на договор НПО/ПДС;
5. Размер взносов за год число Отображается сумма взносов за 1 год (налоговый период);
Взносы по ПДС необходимо учитывать из выписке по счету (карточке счета) по мнемонике - ПДС СВ , по НПО - ИПС_ФЛ;
6. Наличие ЛК ФНС логическое Отображается возможное значение по ответу из ФНС.
Возможные значения:
1 – имеется ЛК ФНС,
0 – не имеется ЛК ФНС,
null – по данному клиенту не было запроса в API ФНС о наличии ЛК ФНС,
99 – проверка на наличие ЛК ФНС не успешна.
7. Дата последней отправки Дата
дд.мм.гггг Отображается дата, когда по данному договору был отправлен XML-файл.
Null – значение, если по этому договору в этом году не было отправки XML-файла в API ФНС;
8. Значение ошибки Дата
дд.мм.гггг Отображается значение ошибки, которое прислала API ФНС;
Например – 02;
Значение ошибок см. в Приложении 2.
9. Описание ошибки строка Отображается расшифровка ошибки»
Например - Есть дата смерти физ. Лица;
Описание ошибок см. в Приложении 2.
10. Статус ошибки строка Значение «Не исправлено» – означает, что API ФНС вернул ошибку, она не была исправлена и не была повторно подана в API ФНС.
Значение «Исправлено» – означает, что API ФНС вернул ошибку, она была исправлена и была повторно подана в API ФНС.
При открытии журнала система не должна получать и отображать данные до установки фильтров.
Для удобства поиска над журналом требуется реализовать фильтр по отдельным полям:
- диапазон дат реестра (две даты) – с возможностью указать начальное и конечное значения диапазона. По умолчанию не заполнено. Обязательно к заполнению.
- номер реестра;
- диапазон дат отправки (две даты) – с возможностью указать начальное и конечное значения диапазона. По умолчанию не заполнено;
- налоговый период (год);
- статус – выпадающий список (описание статусной модели в п.6);
- значение ошибки;
- статус ошибки.
Под журналом необходимо расположить функциональные кнопки. Макет всех кнопок представлен на рис. 3. Описание кнопок в таб. 3.
Рис. 3. Кнопки журнала реестров.
Таб. 3. Функционал кнопок.
Кнопка Состояние Целевое действие
Создать По умолчанию активна Создание реестра УВН по параметрам отбора. Описание параметров отбора см. в п.3.2.
Отправить в ЛКК (в колокольчик) Активна при выборе реестра в журнале в статусе «Сформировано» Отправляет сведения по сформированному реестру в ЛКК
Отправить в ФНС Активна при выборе в журнале записи на статусе «Получен в ЛКК» Формирует и отправляет файл в формате xml в ФНС
Аннулировать Активна при выборе в журнале записи на статусах «Сформировано». Не активна, если реестр был отправлен в ЛКК /ФНС. -Аннулирует реестр из системы;
-Перед удалением обязательно должно выводиться уведомление для подтверждения действия;
Доступна для роли
3. Формирование реестра
3.1. Логика формирования реестра
Ежегодно, с 20 января, в системе должна запускаться регламентная задача, которая автоматически формирует реестр с названием «Реестр на упрощённый налоговый вычет» по договорам клиентов, по которым доступен налоговый вычет по ПДС и НПО.
По составленному реестру НПФ 360 должна ожидать ответ от ЛКК, что клиент нажал кнопку «Получить налоговый вычет», дал согласие на обработку данных и значение поля чек-бокса о получении УНВ ежегодно. В случае, если значение чек-бокса(в лкк пока не реализовано) «Получать вычет ежегодно» положительное, то автоматически договор попадает в реестр на следующий год, не ожидая кнопки «Получить налоговый вычет» и согласия клиента.
Важно: реестр формируется по клиенту за предшествующие 3 года текущему году. Например, если реестр формируется в 2028 году, то реестр необходимо собирать по данным за 2025, 2026 и 2027 годы. Если реестр формируется в 2029, то реестр необходимо собирать по данным за 2026, 2027 и 2028 и т.д. (по пришествию налогового года необходимо скрыть неактуальный год и отображать прядущие 3 года). Соответственно при формировании реестра по одному клиенту необходимо формировать записи по данным за предыдущие три года (в случае, если клиент проходит по отбору параметров, который описан ниже).
Необходимо иметь возможность просмотра неактуальных налоговых периодов (годов) при применении фильтра «Налоговый период (год)»;
3.2. Параметры отбора.
В реестр должны отбираться все договоры подходящие под следующие условия по договорам ПДС:
1. По ПДС есть личные взносы вкладчика за предыдущий год («Зачисление сберегательных взносов» (код операции PDS_DEPOSIT_ENROLLMENT, мнемоника «ПДС СВ» - «Взносы сберегательные»);
2. Нет зарегистрированного факта смерти в разделе «Все факты смерти»
3. У клиента в блоке «Персональный данные» есть СНИЛС на карточке ФЛ.
Условия, подходящие для отбора по договорам НПО:
1. По НПО есть личные взносы за предыдущий год уплаченных вкладчиком за отчётный период (код операции DEPOSIT_ENROLLMENT, мнемоника «ИПС_ФЛ» - «Взносы ФЛ на ИПС»);
2. Нет зарегистрированного факта смерти в разделе «Все факты смерти».
ВАЖНО: Перевод ОПС в ПДС, а также начисление бонусных рублей по каким-либо стимулирующим акциям Фонда, в т.ч. по акции 2000, возвраты, НЕ СЧИТАЮТСЯ взносами клиентов. Личным взносом клиента считается проведённый взнос через Эквайринг (в т.ч. автоплатеж), СБП (в т.ч. автоплатеж СБП) и оплата по реквизитам. Также личным взносом не считается софинансирование от государства, инвестиционный доход и взносы юридического лица).
3.3. Алгоритм действия системы с ЛКК и ФНС
1. Если в НПФ 360 пришел ответ от ЛКК, то выделить уникальные СНИЛСы, у которых значение поля «Наличие ЛК ФНС» соответствует значению «null», «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”, то система ожидает от ЛКК команду повторного запроса о наличии ЛК ФНС (когда клиент на фронте нажал кнопку «здесь»). Повторение запроса прекращается в случае, если системе по данному клиенту был зарегистрирован факт смерти в разделе «все факты смерти», а также в случае, если клиент не попал в новый реестр в следующем году.
4. По тем клиентам, у которых в реестре в поле «Наличие ЛК ФНС» есть значение 0, система должна дать команду в EAPI ЛКК поставить карточке договора на фронте статус «Зарегистрируйтесь в личном кабинете налогоплательщика» (см. таблицу статусов карточки в приложении 1.)
5. По тем клиентам, по которым в реестре ошибок в поле «Статус ошибки» стоит статус «Не исправлено», система должна автоматически направить уведомление письмо на почту ответственного администратора*.
Тема письма: Ошибка по API ФНС
Текст письма: По высланному в ФНС договору {номер договора} для получения упрощённого налогового вычета возникла ошибка. Зайдите в реестр ошибок.
Администратор должен иметь возможность в реестре ошибок изменить значение поля «Статус ошибки» с значения «Не исправлено» на «Исправлено».
6. По тем клиентам, у которых в реестре ошибок администратор в значение поля «Статус ошибки» поставил статус «Исправлено», система должна автоматически повторить процесс отправки XML-файла в API ФНС (см. параграф «Отправка XML-файла в API ФНС»).
По тем клиентам, по которым в реестре ошибок в поле «Значение ошибки» стоит значение «01» (см. значение ошибки в Таблица 1), система должна дать команду в ЕAPI ЛКК повесить в карточку договора ЛКК статус «Необходимо обновить персональные данные» (см. таблицу статусов карточки ЛКК в приложении 1).
7. После отправки уведомления из п.5, система должна ожидать по такому клиенту обновления ПДБР. Если данные клиента обновились, то система в реестре ошибок автоматически исправляет значение поля «Статус ошибки» на «Исправлено».
4. Автоматическое формирование реестра и отправка в ФНС
4.1 Регламентное задание по формированию реестра.
Необходимо добавить новую регламентную задачу (далее - РЗ). В рамках данной задачи в блоке «Параметры задания» необходимо реализовать параметры, описанные в таб. 4.
Таб. 4. Параметры регламентного задания по формированию реестров в ФНС.
Название задачи Описание задачи График выполнения Параметры
УНВ. Формирование реестра упрощенного налогового вычета Система отбирает договоры НПО/ПДС и формирует реестр в статусе «Сформирован» -20 января каждого года
-Раз в сутки в 08:00;
- количество повторных попыток при сбое (3); -.
Регламентная задача должна выполняться, ориентируясь на условие:
- «Налоговый период (год)» = (текущий год – 1,2,3).
При срабатывании задачи система отбирает договоры, подходящие под условия, описанные в п 3.2 и формирует реестр в статусе «Сформирован».
Уведомление.
После формирования реестра система должна направлять уведомление на группу рассылки с информацией об успешно выполненном здании. Текст «Сформирован реестр УНВ в ФНС».
Если возникли системные ошибки, то направляется уведомление об ошибке. Текст «Не удалось сформировать реестр УНВ в ФНС». Уведомление направляется по истечении 10 попыток выполнения задания каждые сутки.
4.2 Регламентное задание по регистрации и отправке реестра.
Необходимо добавить новую регламентную задачу. В рамках данной задачи в блоке «Параметры задания» необходимо реализовать параметры, описанные в таб. 5.
Таб. 5. Параметры регламентного задания по регистрации и отправке реестров в ЛКК/ФНС.
Название задачи Описание задачи График выполнения Параметры
УНВ. Отправка реестра получение сведений в ЛКК/ФНС Система осуществляет забор данных и их отправку из/в ФНС/ЛКК.
Описание действия системы детализированы в п.3.3. - каждый день в 9 00;
- количество повторных попыток при сбое (10);
-
Регламентная задача должна предпринимать повторные попытки выполнения в случае возникновения ошибки с периодичностью 1 раз в сутки в течении указанного периода.
При выполнении условий система должна присваивать реестру статусы в соответствии со статусной моделью, описанной в п.6.
Уведомление.
После отправки реестра система должна направлять уведомление на группу рассылки с информацией об успешно выполненном здании. Текст «Реестр УНВ № [номер реестра в виде ссылки] успешно отправлен в ФНС.».
Если возникли системные ошибки, то направляется уведомление об ошибке. Текст «Не удалось отправить реестр УНВ в ФНС № [номер реестра в виде ссылки]. Причина: [описание причины]».
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. Сформирован Присваивается в рамках регламентной задачи после формирования реестра. -Сформирован реестр отобранных договоров, запись отображается в журнале, но реестр еще не отправлен в ГНИВЦ;
2. Отправлен в ЛКК Присваивается по результату нажатия на кнопку «Отправить в ЛКК». Данные отправлены в ЛКК.
3. Принят в ЛКК Присваивается по результату получения и обработки данных из ЛКК. Данные приняты в ЛКК.
4. Отправлен в ФНС Присваивается по результату нажатия на кнопку «Отправить в ФНС». Данные отправлены в ФНС.
5. Принят в ФНС Присваивается по результату получения и обработки данных из ФНС. Данные приняты в ФНС.
6. Ответ ФНС Присваивается после обработки данных из ФНС.
- В случае успешной обработки данных записывается значение «успешно».
В случае наличия ошибок записывается значение – «Ошибка».
7. Удален Присваивается по результату нажатия на кнопку «Удалить». Кнопка отображается только для роли Реестр удален.
В системе необходимо реализовать сохранение истории изменения статусов. В интерфейс для пользователя должен отображаться только текущий статус.
Приложение 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 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 Физ. лицо не идентифицировано
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 бит
