Перейти к основному содержимому

Создать запрос на получение суммы доходов самозанятого за период

/api/v1/self-employed/taxpayers/{inn}/income-requests

POST

https://secured-openapi.tbank.ru/api/v1/self-employed/taxpayers/{inn}/income-requests

Метод для создания запроса на получение суммы доходов самозанятого из ФНС.

Запрос можно отправить только в ночное время — с 22:00 до 06:00 мск. Это связано с ограничениями от ФНС. Если отправить запрос в другое время, вернётся ошибка с кодом OPERATION_REJECTED.

Авторизация

Security

Bearer API Token

RPS

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

Scopes

СамозанятыеЗапросить сумму доходов самозанятого за период

Запрос

Header parameters

Required

Idempotency-Key

String<uuid>

Ключ идемпотентности.

X-Request-Id

String<uuid>

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

Path parameters

Required

inn

String

Requirements: Value must match regular expression ^(\d{12})$

ИНН.

Request body schema application/json

Required

year

Integer<int32>

Год, за который запрашивается сумма доходов.

Required

month

Integer<int32>

Месяц, за который запрашивается сумма доходов.

Ответ

201

Успешный запрос

400

Некорректный запрос

401

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

403

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

422

Ошибка при обработке данных

429

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

500

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

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

Loading...

openapi@tinkoff.ru

АО «Тинькофф Банк» использует файлы «cookie», с целью персонализации сервисов и повышения удобства пользования веб-сайтом. «Cookie» представляют собой небольшие файлы, содержащие информацию о предыдущих посещениях веб-сайта. Если вы не хотите использовать файлы «cookie», измените настройки браузера.