Анализ XML-документов ФНС

Область: Парсинг и интерпретация XML-файлов Федеральной налоговой службы РФ. Дополняет skill tax_law_ru (нормативная база) и accounting_docs_ru (первичные документы).

Структура 2-НДФЛ (Справка о доходах)

Корневой элемент: <Файл> → <Документ> → <СвНА>, <ПолучДох>, <СведДох>, <СвВыч>, <СумИтог>

Элемент	Описание
<СвНА>	Сведения о налоговом агенте (работодатель): ИНН, КПП, наименование
<ПолучДох>	Получатель дохода (физлицо): ФИО, ИНН, дата рождения, паспорт
<СведДох>	Доходы по месяцам: <ДохВыч> с атрибутами Месяц, КодДоход, СумДоход
<СвВыч>	Налоговые вычеты: <ВычетСВ> с атрибутами КодВычет, СумВычет
<СумИтог>	Итоговые суммы: доход, облагаемая база, исчислено, удержано, перечислено

Атрибуты <Документ>

• ОтчетГод — налоговый период (год)
• Призн — признак (1 = обычная, 2 = невозможность удержания)
• НомКорр — номер корректировки (00 = первичная)

Структура 3-НДФЛ (Декларация)

Корневой элемент: <Файл> → <Документ> → разделы и приложения

Раздел	Описание
Раздел 1	Сведения о суммах налога, подлежащих уплате/возврату
Раздел 2	Расчёт налоговой базы и суммы налога
Приложение 1 (<ДохРФ>)	Доходы от источников в РФ
Приложение 2	Доходы от источников за пределами РФ
Приложение 3	Доходы от предпринимательской деятельности
Приложение 4	Необлагаемые доходы
Приложение 5 (<ВычСтанд>, <ВычСоц>)	Стандартные и социальные вычеты
Приложение 6 (<ВычИмущ>)	Имущественные вычеты при продаже
Приложение 7	Имущественные вычеты при покупке
Приложение 8	Расходы и вычеты по операциям с ЦБ

Коды доходов

Код	Значение
1010	Дивиденды
2000	Заработная плата
2002	Премия за производственные результаты
2003	Премия из прибыли (непроизводственная)
2012	Отпускные
2300	Пособие по временной нетрудоспособности (больничные)
2510	Оплата за налогоплательщика (аренда, питание)
2610	Материальная выгода от экономии на процентах
2760	Материальная помощь
2762	Материальная помощь при рождении ребёнка
3020	Проценты по вкладам
4800	Иные доходы

Коды вычетов

Код	Значение
126	На первого ребёнка (1 400 руб./мес.)
127	На второго ребёнка (1 400 руб./мес.)
128	На третьего и последующих (3 000 руб./мес.)
129	На ребёнка-инвалида
311	Имущественный вычет (расходы на приобретение)
312	Имущественный вычет (проценты по ипотеке)
320	Социальный вычет (обучение)
321	Социальный вычет (обучение детей)
324	Социальный вычет (лечение)
325	Социальный вычет (ДМС)
327	Социальный вычет (пенсионные взносы)
501	Вычет из стоимости подарков (до 4 000 руб.)
503	Вычет из материальной помощи (до 4 000 руб.)

Что проверять при анализе

Сверка данных

• Совпадение ИНН налогоплательщика между документами
• Корректность налогового периода (ОтчетГод)
• Сходимость: НалИсчисл = НалУдерж ± переплата/задолженность
• Полнота месяцев (все 12 месяцев при работе полный год)
• Соответствие ставки налога (13% / 15% / 30% / 35%)

Типичные ошибки

• Расхождение сумм СумДоход по месяцам и итогового СумДохОбщ
• Вычеты превышают допустимый лимит (например, 120 000 руб. для социальных)
• Отсутствие обязательных реквизитов (ИНН, КПП агента)
• Неправильный признак справки (Призн=1 vs Призн=2)

Сравнение 2-НДФЛ и 3-НДФЛ

• Общая сумма дохода в 2-НДФЛ должна совпадать с Приложением 1 в 3-НДФЛ
• Удержанный налог должен совпадать
• Вычеты у агента (2-НДФЛ) + дополнительные вычеты (3-НДФЛ) = итого вычетов

Кодировки

Формат	Кодировка	Примечание
Старые файлы ФНС (до ~2019)	windows-1251	В <?xml encoding="windows-1251"?>
Новые файлы ФНС	UTF-8	Стандарт с 2020+
BOM	UTF-8 BOM (EF BB BF)	Встречается редко

Система автоматически определяет кодировку по XML-декларации и содержимому файла.

Типичные задачи пользователей

Вопрос	Что делать
«Сколько заработал за год?»	Найти СумДохОбщ или суммировать СумДоход по месяцам
«Какие вычеты применены?»	Извлечь <СвВыч> → КодВычет + СумВычет, расшифровать коды
«Сходятся ли суммы?»	Проверить СумДохОбщ = сумма по месяцам, НалИсчисл ≈ НалОблБаз × ставка
«Есть ли расхождения?»	Сравнить данные 2-НДФЛ и 3-НДФЛ (суммы, вычеты, удержания)
«Правильно ли заполнена декларация?»	Проверить обязательные поля, формулы, лимиты вычетов

Другие XML-документы ФНС

Тип документа	Корневой элемент	Описание
Выписка из ЕГРЮЛ	<Файл> → <СвЮЛ>	Сведения о юрлице: название, ИНН, ОГРН, учредители, виды деятельности
Выписка из ЕГРИП	<Файл> → <СвИП>	Сведения об ИП: ФИО, ОГРНИП, виды деятельности
Требование о предоставлении документов	<Файл> → <Документ>	Перечень запрашиваемых документов, сроки представления
Акт сверки	<Файл> → <АктСвworking>	Расчёты по налогам и сборам, задолженности

Anti-patterns

• Не изменять XML-файлы ФНС — только читать и анализировать
• Не генерировать XML в формате ФНС — для этого нужны специализированные системы (1С, Контур)
• Не давать налоговых консультаций — только анализ данных из документа
• При неуверенности в интерпретации — рекомендовать обращение к налоговому специалисту