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

Работа с самозанятыми

С помощью методов API для работы с самозанятыми вы можете:

  • получать информацию по самозанятым и добавлять их по реквизитам;
  • создавать черновики анкет и платежных реестров;
  • подписывать и оплачивать реестры;
  • получать чеки по вы выплатам;
  • оплачивать налог за самозанятых со счетом в ТБанке.

Методы в документации

Выпустить самозанятому карту TБанка

Если самозанятый еще не клиент TБанка, привезем карту в день оформления или на следующий день. Обслуживание карт, выпущенных через этот метод, бесплатное.

  1. Создайте черновики анкет на выпуск карты для самозанятых через метод Создать черновики анкет самозанятых. В запросе укажите данные самозанятых, которым хотите выпустить карты.

Для иностранных граждан больше обязательных полей — например, birthPlace, citizenship, latinFirstName, latinLastName, documents.

Примеры запросов:

"correlationId": "cf99df08-0829-4614-8da3-0e440fd23fe1",
"recipients": {
"number": 1,
"firstName": "Иван",
"lastName": "Иванов",
"middleName": "Иванович",
"birthDate": "1967-12-25",
"birthPlace": "Санкт-Петербург",
"citizenship": "РФ",
},
"phones":
{
"type": "Мобильный",
"number": "+72565121024"
},
"addresses": {
},
"documents": {
"type": "Паспорт",
"serial": "2048",
"number": "131072",
"date": "2015-05-09",
"organization": "ФМС"}

Если при создании черновика произошла ошибка, проверьте данные и повторите запрос.

  1. Получите результат создания черновиков анкет самозанятых через метод Получить результат создания черновиков анкет самозанятых.

    Ответ на запрос создания хранится в течение двух дней.

    В ответе приходит массив c ФИО самозанятых и их статусами — QUEUED, CREATED или ERROR:

    • QUEUED — анкета еще в очереди на создание. Повторите запрос позже.
    • ERROR — произошла ошибка при заполнении. В поле errors можно посмотреть, в каком поле произошла ошибка.
    • CREATED — черновик успешно создан.
  2. Когда вы успешно создаете черновик заявки на выпуск карты TБанка, представитель компании отправляет его вам в личном кабинете TБизнеса в разделе Зарплатный проект → Самозанятые → Черновики.

Добавить самозанятого

Чтобы добавить свои данные для выплат, самозанятый заполняет анкету по ссылке, которую он получает от компании. Ссылка для компании доступна в личном кабинете TБизнес.

Чтобы самозанятый был успешно добавлен с внешним банком (не TБанком), перед отправкой анкеты ему нужно зарегистрироваться как самозанятый в Мой налог. Для самозанятых, которые добавляются по карте TБанка или с выпуском счета, такого ограничения нет. В анкете получатель может выбрать, чтобы банк самостоятельно зарегистрировал его как самозанятого.

Порядок добавления:

  1. Самозанятый заходит в анкету, чтобы добавить свои данные для выплат. Сейчас при переходе по ссылке отображается только добавление со счетом в TБанке.


  2. Выбирает, куда хочет получать выплаты — на счет в TБанке, на счет внешнего банка или выпустить себе карту TБанка, чтобы потом получать выплаты на ее счет.



  3. Вводит данные для получения выплат и отправляет их в TБанк.


Заплатить самозанятому

При выплате вы создаете черновик реестра и подписываете его, а после этого оплачиваете. При создании реестра вы можете выбрать удержание налога самозанятого с этой выплаты, чтобы TБанк оплатил его автоматически.

При создании черновика и его оплате мы автоматически проверяем статус самозанятого, а после выплаты формируем чеки.

  1. Создайте черновик платежного реестра через метод Создать черновик платежного реестра.

    Вы можете удержать налог, чтобы TБанк автоматически оплатил его за самозанятого. Для этого в поле taxHolding передайте true. Значение по умолчанию — false.

    В реестре могут быть только самозанятые в статусе ACTIVE — он означает, что самозанятому можно платить по указанному номеру счета.

    Проверить статус получателей можно самостоятельно одним из способов:

    • Через метод Получить информацию по самозанятым.
    • В поле registryCreateType передайте IGNORE_ERRORS. В этом случае проверка статуса будет проходить автоматически, и выплата по реестру будет проходить только самозанятым в статусе ACTIVE. Для самозанятых в других статусах выплаты будут игнорироваться.

Статус получателя ≠ статус самозанятости в налоговой.

За самозанятость отвечает параметр selfEmployedStatus в методе Получить информацию по самозанятым. Сервис автоматически проверяет статус самозанятости при создании или подписании реестра и возвращает вам ошибки.

  1. Проверьте, что платежный реестр был создан через метод Получить результат создания черновика платежного реестра.

    Ответ на запрос создания хранится в течение двух дней.

    В ответе приходит форма со статусом создания реестра — CREATED, ERROR или QUEUED:

    • QUEUED — реестр еще в очереди на создание. Повторите запрос позже.
    • ERROR — произошла ошибка при заполнении. В поле errors вы можете посмотреть поле, в котором произошла ошибка.
    • CREATED — платежный реестр успешно создан.
  2. Подпишите платежный реестр самозанятых через метод Подписать платежный реестр самозанятых.

    Подписание реестра переводит его в статус ACCEPTED для дальнейшей оплаты.

  3. Получите результат подписания платежного реестра самозанятых через метод Получить результат подписания платежного реестра самозанятых.

    Результат создания хранится в течение двух дней.

    В ответе вы можете посмотреть статус подписания — ACCEPTED, ERROR или IN_PROGRESS.

    • IN_PROGRESS — подписание еще в очереди на выполнение. Повторите запрос позже. Если ответ возвращает этот статус в течение нескольких часов, вызовите метод Получить информацию по платежному реестру — возможно, реестр уже перешел в ACCEPTED и готов к оплате, но статус в системе не обновился по технической причине.

    • ERROR — произошла ошибка при подписании. Узнать причину ошибки можно в полях error (общие ошибки, произошедшие при создании реестра) и paymentErrors (ошибки платежей внутри реестра).

      Если errorCode=PAYMENT_ORDER_NOT_FOUND, вызовите метод Получить информацию по платежному реестру — возможно, реестр уже перешел в ACCEPTED и готов к оплате, но статус в системе не обновился по технической причине.

    • ACCEPTED — платежный реестр успешно подписан.

  4. Оплатите реестр через метод Оплатить платежный реестр.

"paymentRegistryId": 0,
"correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  1. Проверьте результат оплаты через метод Получить результат оплаты платежного реестра.
"correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"

Также вы можете дополнительно проверить исполнение платежного реестра через метод Получить информацию по платежному реестру. Если статус ответа:

  • ACCEPTED — реестр еще исполняется. Обычно это занимает до 30 минут.
  • EXECUTED — реестр успешно оплачен.
  • PART_EXEC — реестр оплачен не полностью: в реестре есть платежи, которые банк отклонил.
  • REJECTED — реестр отклонен банком. Например, нет средств или все платежи в реестре отклонены.
  • CANCELLED — реестр отменен из личного кабинета TБизнеса.
  • DELETED — реестр удален из личного кабинета TБизнеса.

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

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

  • Вызывайте метод не чаще одного раза в 10 минут.
  • В качестве параметров укажите идентификатор самозанятого — recipientId. Его можно получить через метод Получить результат создания черновиков анкет самозанятых. Если самозанятый был добавлен другим способом, воспользоваться этим методом не получится.

В ответе придет форма, из которой вы сможете узнать статус обработки анкеты самозанятого в банке, его статус самозанятости и основную информацию.

Получить чеки по выплатам

Мы автоматически формируем чеки по исполненным платежам внутри реестра после исполнения реестра.

  1. Проверьте, что платежный реестр исполнился, через метод Получить информацию по платежному реестру. Если статус:

    • EXECUTED — реестр успешно оплачен.
    • PART_EXEC — реестр оплачен не полностью: внутри реестра есть платежи, которые банк отклонил.
    • Другой — смотрите раздел Заплатить самозанятому.
  2. Получите чеки по платежному реестру самозанятых через метод Получить чеки по платежному реестру самозанятых. В качестве входного параметра укажите номер платежного реестра.

  3. Получите результат запроса на получение чеков через метод Получить результат запроса на получение чеков. Если статус ответа:

    • FINISHED — результат регистрации дохода можно посмотреть в поле receipts.
    • IN_PROGRESS — повторите запрос позже. Обработка запроса занимает не больше 5 минут.
    • ERROR — произошла ошибка. Текст ошибки можно посмотреть в поле errors.

Оплатить налог за самозанятых со счетом в ТБанке

При создании черновика платежного реестра в поле taxHolding передайте true. Значение по умолчанию — false.

ТБанк переведет 6% от суммы платежа в налоговую копилку для последующей оплаты налогов. Подробнее.

Поставить самозанятого на учет

Если вас интересуют способы постановки самозанятых на учет через API, напишите на sme_smzn@tbank.ru.

openapi@tbank.ru

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