Взять заявку в работу

POST

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

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

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

Авторизация

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>

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

Ответ

200

400

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

401

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

403

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

422

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

429

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

500

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

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

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

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