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

POST

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

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

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

Авторизация

Security

Bearer API Token

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

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

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

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

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

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

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