Отметить заявку выполненной

POST

https://secured-openapi.tbank.ru/api/v2/ndfl-3/requests/{taxRequestId}/declaration/workflow/acknowledge

Метод переводит заявку типа «Декларация» в статус Acknowledge.

Если заявка не будет найдена или её нельзя перевести в этот статус, вернётся ошибка. Если заявка уже в статусе Acknowledge, метод вернёт данные в 200 ответе. Если актуальная версия заявки не совпадает с версией, переданной в HTTP-заголовке, вернётся 422 ошибка.

Если передан параметр finalDocuments, данное вложение прикладывается к анкете в качестве финального пакета документов.

Авторизация

Security

Bearer API Token

MTLS-сертификат

RPS

Ограничение — 10 запросов в секунду

Scopes

Декларации 3-НДФЛ → Декларации 3-НДФЛ - Изменить статус заявки

Header parameters

Required

If-Match

String

Requirements: <= 50 characters

Версия заявки в формате ETag, которая используется для оптимистичных блокировок. Другое название — casVersion.

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику исполнения запроса.

Path parameters

Required

taxRequestId

String<uuid>

Уникальный идентификатор заявки.

Query parameters

finalDocuments

String<uuid>

Уникальный идентификатор вложения.

Ответ

200

400

Заявка не найдена

401

Ошибка аутентификации

403

Ошибка авторизации

422

Неверные данные заявки

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции