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

Работа с сотрудниками

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

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

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

Выпустить сотруднику карту TБанка

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

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

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

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


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

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

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

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

Заплатить сотруднику

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

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

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

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

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

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

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

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

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

    Результат создания хранится в течение двух дней. В ответе возвращается статус подписания — ACCEPTED, ERROR или IN_PROGRESS.

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

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

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

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

  5. Оплатите реестр через метод Оплатить реестр.

    В назначении укажите слово «реестр» и номер реестра, который будет исполнен платежом. Например, «Оплата зарплаты согласно реестру №394 от 24.09.2020».

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

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

Добавить сотрудников в список

Вы можете добавить сотрудника к вам в список, создав его анкету через метод Создать черновики анкет сотрудников.

Если у сотрудника уже есть карта T‑Банка, он просто добавится к вам в список.

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

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

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

openapi@tbank.ru

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