Skip to main content

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

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

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

  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. Когда вы успешно создаёте черновик заявки на выпуск карты Тинькофф, представитель компании отправляет его вам в личном кабинете Тинькофф Бизнеса в разделе Зарплатный проект → Самозанятые → Черновики.

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

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

Чтобы самозанятый был успешно добавлен с внешним банком (не Тинькофф), перед отправкой анкеты ему нужно зарегистрироваться как самозанятый в Мой налог. Добавление по ссылке с внешним банком появится в декабре.

Для самозанятых, которые добавляются по карте Тинькофф или с выпуском счёта, такого ограничения нет. В анкете получатель может выбрать, чтобы банк самостоятельно зарегистрировал его как самозанятого.

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


  2. В целевом сценарии самозанятый выбирает, куда хочет получать выплаты — на счёт в Тинькофф, на счёт внешнего банка или выпустить себе карту Тинькофф, чтобы потом получать выплаты на её счёт.



  3. Самозанятый вводит данные и отправляет их в Тинькофф.


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    В ответе вы можете посмотреть статус подписания — 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 — реестр отменён из личного кабинета Тинькофф Бизнес.
  • DELETED — реестр удалён из личного кабинета Тинькофф Бизнеса.

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

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

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

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

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

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

  1. Проверьте, что платёжный реестр исполнился через метод Получить информацию по платёжному реестру.
  • Если статус - EXECUTED, то реестр успешно оплачен.
  • Если статус - PART_EXEC, то реестр оплачен не полностью: внутри реестра есть платежи, которые банк отклонил.
  • При других статусах - смотрите сюжет “Заплатить самозанятому”
  1. Получите чеки по платёжному реестру самозанятых через метод Получить чеки по платёжному реестру самозанятых. В качестве входного параметра укажите номер платёжного реестра.

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

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

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

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

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

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

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

openapi@tinkoff.ru

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

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