Налоговые вычеты

Обновлено 28 мая 2026

Информация о продукте

Налоговые вычеты клиентам — сервис, предоставляющий возможность подтверждения юридическими лицами и индивидуальными предпринимателями расходов своих клиентов на оплату социально значимых услуг и отправку справок в ФНС России для предоставления социального налогового вычета.

Используя Sber API, вы можете интегрироваться с нашим продуктом для:

• Получения черновиков справок, созданных банком на основании заявлений клиентов (физических лиц) на получение налогового вычета;
• Информирования клиентов Сбера об отправке вами справок в ФНС;
• Использования инструментов СберБизнес для подписания и отправки справок в ФНС, подготовленных на стороне вашей автоматизированной системы.

Как подключить?

Для новых клиентов сервис доступен в рамках набора "Компаниям". Если вы уже подключены к Sber API, проверьте наличие сервиса TAX_DEDUCTION_INFO в наборе Компаниям в Личном кабинете, либо обратитесь на supportdbo2@sberbank.ru или к вашему менеджеру. Подробнее о подключении сервиса набора в соответствующем разделе документации.

Для корректной работы взаимодействие в Sber API должно быть  настроено под пользователем СберБизнес с одной из следующих ролей:

• Клиент Банка,
• Главный Бухгалтер,
• Менеджер по работе с налоговыми вычетами клиентам  

Схема работы сервиса

Варианты реализации

Ниже в общем виде описаны сценарии работы со справками, сформированными банком, на получение налоговых вычетов с использованием Sber API. Можно использовать разные триггеры запуска Sber API: действия пользователя, регламентный запуск по времени, наступление определенных событий и другие варианты. Статусы справок, отправляемые в банк из вашей автоматизированной системы, должны соответствовать статусной [модели] (ссылка).

Можно выделить 2 варианта взаимодействия:

• Подписание и отправка справок в ФНС происходит в СберБизнес.
• Подписание и отправка справок в ФНС происходит в системе или операторе ЭДО организации.

В обоих случая важно настроить взаимодействие между вашей автоматизированной системой и Sber API так, чтобы обе системы получали регулярные обновления справок. Рекомендации по настройке даны в соответствующих разделах документации:

• Получение списка справок
• Обновление/создание справок

Подписание и отправка справок в ФНС происходит в СберБизнес

Шаги

• Получить информацию по справкам из банка.
• Для каждой справки в статусе READY или EDITED, полученной от банка:
  • Проверить информацию по справке:
    • Данные плательщика,
    • Сумма(ы).
  • При необходимости заполнить данные получателя услуги.
  • Зафиксировать справку в статусе EDITED (если планируется дальнейшее уточнение информации по справке) или READY_TO_SEND.
• Отправить в банк обновленные данные по справкам.
• Выполнить подписание справки(ок) в интерфейсе Сбербизнес.
• Сбербизнес отправляет справки в ФНС.

Иллюстрация взаимодействия на уровне API

Особенности статусной модели

В данном варианте реализации следующие статусы проставляются на стороне АС Клиента:

• SIGNED;
• SENDING;
• SENT;
• ERROR_FNS;
• EDO_ERROR;
• APPROVED_FNS;
• NOT_CONFIRMED;
• WAITING_RESPONSE_TO_FNS;
• ERROR.

Подписание и отправка справок в ФНС происходит в системе или операторе ЭДО организации

Шаги

• Получить информацию по справкам.
• Для каждой справки в статусе READY или EDITED, полученной от банка:
  • Проверить информацию по справке:
    • Данные плательщика,
    • Сумма(ы).
  • При необходимости заполнить данные получателя услуги.
  • Зафиксировать справку в статусе EDITED или READY_TO_SEND.
• Отправить в банк обновленные данные по справкам.
• Выполнить подписание справки(ок) в вашей автоматизированной системе. Перевести справки в статус SIGNED.
• Отправить в банк обновленные данные по справкам.
• Инициировать отправку справок в ФНС через ЭДО Клиента. Перевести справки в статус SENDING.
• Отправить в банк обновленные данные по справкам.
• Обработать полученные от ФНС ответы по справкам. Перевести справки в соответствующий статус*.
• Отправить в банк обновленные данные по справкам.

Иллюстрация взаимодействия на уровне API

Особенности статусной модели

В данном варианте реализации следующие статусы проставляются на стороне СберБизнес:

• SIGNED;
• SENDING;
• SENT;
• ERROR_FNS;
• EDO_ERROR;
• APPROVED_FNS;
• NOT_CONFIRMED;
• WAITING_RESPONSE_TO_FNS;
• ERROR.

Терминология

Справка/вычет — набор данных, содержащих информацию о плательщике, получателе услуги, а также информации о самой услуге (сумма и вид), на основе которого формируется  электронный документ в формате xml, отправляемый в ФНС для получения ФЛ налогового вычета.

Электронный документооборот (ЭДО) — это система обмена электронными документами через интернет или локальные сети, которая позволяет организациям и индивидуальным предпринимателям осуществлять безбумажный документооборот. В рамках ЭДО документы создаются, подписываются, отправляются и хранятся в цифровом формате.

Извещение о получении (ИОП) —  электронный документ, формируемый и направляемый участником электронного документооборота (например, оператором ЭДО или получателем документа) в адрес отправителя. Оно подтверждает факт и время поступления электронного документа (например, справки на получение налогового вычета) в информационную систему получателя.

Квитанция о приеме (КОП) — это электронный документ, формируемый ФНС России и направляемый ЮЛ в рамках электронного документооборота, подтверждающий факт и время получения налоговым органом документов (справки) для получения налогового вычета.

Уведомление об отказе (УОО) — это электронный документ, формируемый ФНС России и направляемый ЮЛ в рамках автоматизированного обмена документами при оформлении налоговых вычетов, содержащий причину отказа в приеме документа.

Сообщение об ошибке (СОШ) — это  электронный документ, который формируется и направляется информационной системой ФНС России или оператора электронного документооборота (ЭДО) в адрес отправителя. В этом сообщении содержится информация о невозможности принять или обработать направленный электронный документ из-за выявленных нарушений.

Десятый документооборот — это регламентированный электронный обмен между налогоплательщиком и Федеральной налоговой службой (ФНС), в рамках которого направляется результат обработки справки (и сопутствующих документов), поданных для получения налогового вычета, и который содержит мотивированный отказ в предоставлении вычета.

Статусная модель

Системное имя статуса	Бизнес смысл	Статус в СберБизнес
APPROVED_FNS	ФНС приняла справку (получена КОП). При отправке в Банк справок в этом статусе должна быть указана receiptDate - дата получения ответа КОП.	Принята в ФНС
ARCHIVED	Сотрудник юридического лица не планирует работать со справкой и отправлять ее в ФНС. При простановке этого статуса рекомендуется дополнительно указывать причину перевода справки в архив и передавать ее в параметре statusDescription. Рекомендуемые значения причин архивации: * Клиент не найден, уточните данные получателя услуг * Услуг не найдено * Вычет уже получен	Архивирована
EDITED	Справка редактировался сотрудником юридического лица и была сохранена в процессе редактирования как черновик.	Черновик
EDO_ERROR	От ФНС пришло сообщение об ошибке (СОШ).	Ошибка
ERROR	Технический статус. При обработке справки на стороне Банка произошла ошибка.	-
ERROR_FNS	ФНС отклонила справку (получено УОО). При отправке в Банк справок в этом статусе должно быть указано значение для атрибута receiptDate - дата получения УОО.	Отказ ФНС
NOT_CONFIRMED	Поступил связанный со справкой пакет документов с результатом обработки справки по десятому документообороту из ФНС.	Не подтверждена
READY	На основании заявления физического лица и данных о транзакциях в пользу юридического лица банком создан черновик справки.	Получено заявление от клиента
READY_TO_SEND	Сотрудник юридического лица завершил редактирование справки (подтвердил ее). Справка готова к подписанию и отправке в ФНС. Если используется ЭДО, предоставляемое сервисом Налоговые вычеты в Сбербизнес, то справки, готовые к отправке в ФНС, должны приходить в СберБизнес именно в этом статусе.	Ожидает подписания
SENDING	Инициирована отправка подписанной справки в ФНС через ЭДО.	Отправка в ФНС
SENT	Справка отправлена в ФНС.	Отправлена в ФНС
SIGNED	Справка была подписана.	Подписана
WAITING_RESPONSE_TO_FNS	От ФНС пришел ответ (КОП или УОО), требуется расшифровка и ознакомление с ответом. Статус проставляется только при использовании ЭДО СберБизнес.

Смотрите также

Налоговые вычеты

Справочная документация по REST API