Skip to main content

Получить информацию по самозанятым

POST

https://business.tinkoff.ru/openapi/api/v1/self-employed/recipients/list

Метод для получения информации по самозанятым. Вызывайте не чаще одного раза в 10 минут.

Заявка для добавления самозанятого создаётся в статусе DRAFT. После этого её нужно отправить в личном кабинете. Отправленный самозанятый перейдёт в статус ACTIVE.

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/self-employed/recipients/manageДобавление и получение информации о самозанятых компании с ИНН {inn} и КПП {kpp}.

Ограничение на использование метода — 1 запрос в секунду.

Авторизация

Security

Bearer API Token

Запрос

Request body schema application/json

recipientIds

Array

Список идентификаторов самозанятых.

inn

Array

ИНН самозанятых.

status

Array

Статусы самозанятых.

selfEmployedStatus

Array

Статусы самозанятости.

creationDate

Object (SelfEmployedCreationDate)

Период даты добавления.

from

String<date-time>

Дата начала периода.

to

String<date-time>

Дата окончания периода.

offset

Integer<int32>

Количество получателей, которых мы пропустим при выдаче с начала списка.

limit

Integer<int32>

Максимальное количество самозанятых, информацию по которым отдадим в ответе. Максимум и по умолчанию — 900.

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

Loading...

openapi@tinkoff.ru

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

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