Работа с самозанятыми
Выпустить самозанятому карту T‑Банка
Если самозанятый ещё не клиент T‑Банка, привезём карту в день оформления или на следующий день. Обслуживание карт, выпущенных через этот метод, бесплатное.
- Создайте черновики анкет на выпуск карты для самозанятых через метод Создать черновики анкет самозанятых. В запросе укажите данные самозанятых, которым хотите выпустить карты.
Для иностранных граждан больше обязательных полей — например, 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": "ФМС"}
Если при создании черновика произошла ошибка, проверьте данные и повторите запрос.
Получите результат создания черновиков анкет самозанятых через метод Получить результат создания черновиков анкет самозанятых.
Ответ на запрос создания хранится в течение двух дней.
В ответе приходит массив c ФИО самозанятых и их статусами —
QUEUED
,CREATED
илиERROR
:QUEUED
— анкета ещё в очереди на создание. Повторите запрос позже.ERROR
— произошла ошибка при заполнении. В полеerrors
можно посмотреть, в каком поле произошла ошибка.CREATED
— черновик успешно создан.
Когда вы успешно создаёте черновик заявки на выпуск карты T‑Банка, представитель компании отправляет его вам в личном кабинете T‑Бизнеса в разделе Зарплатный проект → Самозанятые → Черновики.
Добавить самозанятого
Чтобы добавить свои данные для выплат, самозанятый заполняет анкету по ссылке, которую он получает от компании. Ссылка для компании доступна в личном кабинете T‑Бизнес.
Чтобы самозанятый был успешно добавлен с внешним банком (не T‑Банком), перед отправкой анкеты ему нужно зарегистрироваться как самозанятый в Мой налог. Для самозанятых, которые добавляются по карте T‑Банка или с выпуском счёта, такого ограничения нет. В анкете получатель может выбрать, чтобы банк самостоятельно зарегистрировал его как самозанятого.
Порядок добавления:
Самозанятый заходит в анкету, чтобы добавить свои данные для выплат. Сейчас при переходе по ссылке отображается только добавление со счётом в T‑Банке.
Выбирает, куда хочет получать выплаты — на счёт в T‑Банке, на счёт внешнего банка или выпустить себе карту T‑Банка, чтобы потом получать выплаты на её счёт.
Вводит данные для получения выплат и отправляет их в T‑Банк.
Заплатить самозанятому
При выплате вы создаёте черновик реестра и подписываете его, а после этого оплачиваете. При создании реестра вы можете выбрать удержание налога самозанятого с этой выплаты, чтобы T‑Банк оплатил его автоматически.
При создании черновика и его оплате мы автоматически проверяем статус самозанятого, а после выплаты формируем чеки.
Создайте черновик платёжного реестра через метод Создать черновик платёжного реестра.
Вы можете удержать налог, чтобы T‑Банк автоматически оплатил его за самозанятого. Для этого в поле
taxHolding
передайтеtrue
. Значение по умолчанию —false
.В реестре могут быть только самозанятые в статусе
ACTIVE
— он означает, что самозанятому можно платить по указанному номеру счёта.Проверить статус получателей можно самостоятельно одним из способов:
- Через метод Получить информацию по самозанятым.
- В поле
registryCreateType
передайтеIGNORE_ERRORS
. В этом случае проверка статуса будет проходить автоматически, и выплата по реестру будет проходить только самозанятым в статусеACTIVE
. Для самозанятых в других статусах выплаты будут игнорироваться.
Статус получателя ≠ статус самозанятости в налоговой.
За самозанятость отвечает параметр selfEmployedStatus
в методе Получить информацию по самозанятым. Сервис автоматически проверяет статус самозанятости при создании или подписании реестра и возвращает вам ошибки.
Проверьте, что платёжный реестр был создан через метод Получить результат создания черновика платёжного реестра.
Ответ на запрос создания хранится в течение двух дней.
В ответе приходит форма со статусом создания реестра —
CREATED
,ERROR
илиQUEUED
:QUEUED
— реестр ещё в очереди на создание. Повторите запрос позже.ERROR
— произошла ошибка при заполнении. В полеerrors
вы можете посмотреть поле, в котором произошла ошибка.CREATED
— платёжный реестр успешно создан.
Подпишите платёжный реестр самозанятых через метод Подписать платёжный реестр самозанятых.
Подписание реестра переводит его в статус
ACCEPTED
для дальнейшей оплаты.Получите результат подписания платёжного реестра самозанятых через метод Получить результат подписания платёжного реестра самозанятых.
Результат создания хранится в течение двух дней.
В ответе вы можете посмотреть статус подписания —
ACCEPTED
,ERROR
илиIN_PROGRESS
.IN_PROGRESS
— подписание ещё в очереди на выполнение. Повторите запрос позже. Если ответ возвращает этот статус в течение нескольких часов, вызовите метод Получить информацию по платёжному реестру — возможно, реестр уже перешёл вACCEPTED
и готов к оплате, но статус в системе не обновился по технической причине.ERROR
— произошла ошибка при подписании. Узнать причину ошибки можно в поляхerror
(общие ошибки, произошедшие при создании реестра) иpaymentErrors
(ошибки платежей внутри реестра).Если
errorCode=PAYMENT_ORDER_NOT_FOUND
, вызовите метод Получить информацию по платёжному реестру — возможно, реестр уже перешёл вACCEPTED
и готов к оплате, но статус в системе не обновился по технической причине.ACCEPTED
— платёжный реестр успешно подписан.
Оплатите реестр через метод Оплатить платёжный реестр.
"paymentRegistryId": 0,
"correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
- Проверьте результат оплаты через метод Получить результат оплаты платёжного реестра.
"correlationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
Также вы можете дополнительно проверить исполнение платёжного реестра через метод Получить информацию по платёжному реестру. Если статус ответа:
ACCEPTED
— реестр ещё исполняется. Обычно это занимает до 30 минут.EXECUTED
— реестр успешно оплачен.PART_EXEC
— реестр оплачен не полностью: в реестре есть платежи, которые банк отклонил.REJECTED
— реестр отклонён банком. Например, нет средств или все платежи в реестре отклонены.CANCELLED
— реестр отменён из личного кабинета T‑Бизнеса.DELETED
— реестр удалён из личного кабинета T‑Бизнеса.
Получить информацию по самозанятому
Используйте метод Получить информацию по самозанятым.
- Вызывайте метод не чаще одного раза в 10 минут.
- В качестве параметров укажите идентификатор самозанятого —
recipientId
. Его можно получить через метод Получить результат создания черновиков анкет самозанятых. Если самозанятый был добавлен другим способом, воспользоваться этим методом не получится.
В ответе придёт форма, из которой вы сможете узнать статус обработки анкеты самозанятого в банке, его статус самозанятости и основную информацию.
Получить чеки по выплатам
Мы автоматически формируем чеки по исполненным платежам внутри реестра после исполнения реестра.
Проверьте, что платёжный реестр исполнился, через метод Получить информацию по платёжному реестру. Если статус:
EXECUTED
— реестр успешно оплачен.PART_EXEC
— реестр оплачен не полностью: внутри реестра есть платежи, которые банк отклонил.- Другой — смотрите раздел Заплатить самозанятому.
Получите чеки по платёжному реестру самозанятых через метод Получить чеки по платёжному реестру самозанятых. В качестве входного параметра укажите номер платёжного реестра.
Получите результат запроса на получение чеков через метод Получить результат запроса на получение чеков. Если статус ответа:
FINISHED
— результат регистрации дохода можно посмотреть в полеreceipts
.IN_PROGRESS
— повторите запрос позже. Обработка запроса занимает не больше 5 минут.ERROR
— произошла ошибка. Текст ошибки можно посмотреть в полеerrors
.
Оплатить налог за самозанятых со счётом в Т‑Банке
При создании черновика платёжного реестра в поле taxHolding
передайте true
. Значение по умолчанию — false
.
Т‑Банк переведёт 6% от суммы платежа в налоговую копилку для последующей оплаты налогов. Подробнее.
Поставить самозанятого на учёт
Если вас интересуют способы постановки самозанятых на учёт через API, напишите на sme_smzn@tinkoff.ru.