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

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

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

POST

https://secured-openapi.tbank.ru/api/v1/self-employed/taxpayers/{inn}/receipts-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

from

String<date-time>

Дата и время начала периода по UTC в формате ISO-8601 yyyy-MM-ddTHH:mm<.fff><TZDSuffix>, где:

  • HH — часы в 24-часовой нотации. Допускаются значения от 00 до 23.
  • .fff — опциональная часть, которая содержит доли секунд. Допускается не больше трёх знаков.
  • TZDSuffix — опциональный суффикс. Допускается значение Z или +00:00.

Required

to

String<date-time>

Дата и время начала периода по UTC в формате ISO-8601 yyyy-MM-ddTHH:mm<.fff><TZDSuffix>, где:

  • HH — часы в 24-часовой нотации. Допускаются значения от 00 до 23.
  • .fff — опциональная часть, которая содержит доли секунд. Допускается не больше трёх знаков.
  • TZDSuffix — опциональный суффикс. Допускается значение Z или +00:00.

Ответ

201

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

400

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

401

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

403

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

422

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

429

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

500

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

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

Loading...

openapi@tinkoff.ru

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