Обновить/создать справки на стороне банка
Запрос позволяет обновить имеющиеся на стороне банка справки, а также создать новые.
Чтобы использовать метод:
- В параметре
scopeссылки авторизации пользователя должен быть указан сервисTAX_DEDUCTION_INFOдля получения доступа к этому ресурсу. - Запросы должны отправляться с токеном доступа (
access_token) пользователя в параметреAuthorizationзаголовка. Подробнее об авторизации в соответствующем разделе документации.
Рекомендации по вызову метода
- Рекомендуется настроить расписание вызова метода таким образом, чтобы количество передаваемых в запросе для обновления/создания справок не превышало значение 100.
Для запроса установлена пропускная способность: 5tps
- Для получения ответа с ошибкой отправьте
deductionUuid = 00000000-0000-0000-0000-000000000000
Электронный документооборот (ЭДО) — это система обмена электронными документами через интернет или локальные сети, которая позволяет организациям и индивидуальным предпринимателям осуществлять безбумажный документооборот. В рамках ЭДО документы создаются, подписываются, отправляются и хранятся в цифровом формате.
Извещение о получении (ИОП) — электронный документ, формируемый и направляемый участником электронного документооборота (например, оператором ЭДО или получателем документа) в адрес отправителя. Оно подтверждает факт и время поступления электронного документа (например, справки на получение налогового вычета) в информационную систему получателя.
Квитанция о приеме (КОП) — электронный документ, формируемый ФНС России и направляемый ЮЛ в рамках электронного документооборота, подтверждающий факт и время получения налоговым органом документов (справки) для получения налогового вычета.
Уведомление об отказе (УОО) — электронный документ, формируемый ФНС России и направляемый ЮЛ в рамках автоматизированного обмена документами при оформлении налоговых вычетов, содержащий причину отказа в приеме документа.
Сообщение об ошибке (СОШ) — электронный документ, который формируется и направляется информационной системой ФНС России или оператора электронного документооборота (ЭДО) в адрес отправителя. В этом сообщении содержится информация о невозможности принять или обработать направленный электронный документ из-за выявленных нарушений.
Десятый документооборот — регламентированный электронный обмен между налогоплательщиком и Федеральной налоговой службой (ФНС), в рамках которого направляется результат обработки справки (и сопутствующих документов), поданных для получения налогового вычета, и который содержит мотивированный отказ в предоставлении вычета.
| Системное имя статуса | Бизнес смысл | Статус в СберБизнес |
|---|---|---|
| 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 | От ФНС пришел ответ (КОП или УОО), требуется расшифровка и ознакомление с ответом. Статус проставляется только при использовании ЭДО СберБизнес. |