Работа с сотрудниками
С помощью зарплатных методов API вы можете:
- выпускать зарплатные карты Т‑Банка;
- получать информацию по сотрудникам и добавлять их по реквизитам;
- создавать черновики платежных реестров;
- подписывать и оплачивать реестры.
Выпустить сотруднику карту T‑Банка
Если сотрудник еще не клиент T‑Банка, привезем карту в день оформления или на следующий день. Обслуживание карт, которые выпущены через этот метод, бесплатное.
- Создайте черновики анкет на выпуск карты для сотрудников через метод Создать черновики анкет сотрудников. В запросе укажите данные сотрудников, которым хотите выпустить карты.
Для иностранных граждан больше обязательных полей — например, birthPlace
, citizenship
, latinFirstName
,
latinLastName
, documents
.
Примеры запросов:
Если при создании черновика произошла ошибка, проверьте данные и повторите запрос.
Получите результат создания черновиков анкет сотрудников через метод Получить результат создания черновиков анкет сотрудников.
Ответ на запрос создания хранится в течение двух дней. В ответе приходит массив c ФИО самозанятых и их статусами —
QUEUED
,CREATED
илиERROR
:QUEUED
— анкета еще в очереди на создание. Повторите запрос позже.ERROR
— произошла ошибка при заполнении. В полеerrors
можно посмотреть, в каком поле произошла ошибка.CREATED
— черновик успешно создан.
Когда вы успешно создаете черновик заявки на выпуск карты T‑Банка, представитель компании отправляет его вам в личном кабинете T‑Бизнеса в разделе Зарплатный проект → Сотрудники → Черновики.
Заплатить сотруднику
При выплате вы создаете черновик реестра, подписываете его и оплачиваете.
Создайте черновик платежного реестра через метод Создать черновик платежного реестра.
В реестре могут быть только сотрудники в статусе
ACTIVE
— он означает, что сотруднику можно платить по указанному номеру счета.Проверить статус получателей можно самостоятельно одним из способов:
- Через метод Получить информацию по сотрудникам.
- В поле
registryCreateType
передайтеIGNORE_ERRORS
. В этом случае проверка статуса будет проходить автоматически, и выплата по реестру будет проходить только сотрудникам в статусеACTIVE
. Для сотрудников в других статусах выплаты будут игнорироваться.
Проверьте, что платежный реестр создался, через метод Получить результат создания черновика платежного реестра.
Ответ на запрос создания хранится в течение двух дней. В ответе приходит форма со статусом создания реестра —
CREATED
,ERROR
илиQUEUED
:QUEUED
— реестр еще в очереди на создание. Повторите запрос позже.ERROR
— произошла ошибка при заполнении. В полеerrors
можно посмотреть поле, в котором произошла ошибка.CREATED
— платежный реестр успешно создан.
Подпишите платежный реестр сотрудников через метод Подписать платежный реестр сотрудников.
Подписание реестра переводит его в статус
ACCEPTED
для дальнейшей оплаты.Получите результат подписания платежного реестра сотрудников через метод Получить результат подписания платежного реестра сотрудников.
Результат создания хранится в течение двух дней. В ответе возвращается статус подписания —
ACCEPTED
,ERROR
илиIN_PROGRESS
.IN_PROGRESS
— подписание еще в очереди на выполнение. Повторите запрос позже. Если ответ возвращает этот статус в течение нескольких часов, вызовите метод Получить информацию по платежному реестру — возможно, реестр уже перешел вACCEPTED
и готов к оплате, но статус в системе не обновился по технической причине.ERROR
— произошла ошибка при подписании. Узнать причину ошибки можно в поляхerror
(общие ошибки, произошедшие при создании реестра) иpaymentErrors
(ошибки платежей внутри реестра).Если код ошибки —
PAYMENT_ORDER_NOT_FOUND
, вызовите метод Получить информацию по платежному реестру. Возможно, реестр уже перешел вACCEPTED
и готов к оплате, но статус в системе не обновился по технической причине.ACCEPTED
— платежный реестр успешно подписан.
Оплатите реестр через метод Оплатить реестр.
В назначении укажите слово «реестр» и номер реестра, который будет исполнен платежом. Например, «Оплата зарплаты согласно реестру №394 от 24.09.2020».
Проверьте, что платежный реестр исполнился, через метод Получить информацию по платежному реестру. Если статус ответа:
ACCEPTED
— реестр еще исполняется. Обычно это занимает до 30 минут.EXECUTED
— реестр успешно оплачен.PART_EXEC
— реестр оплачен не полностью: в реестре есть платежи, которые банк отклонил.REJECTED
— реестр отклонен банком. Например, нет средств или все платежи в реестре отклонены.CANCELLED
— реестр отменен в личном кабинете T‑Бизнеса.DELETED
— реестр удален из личного кабинета T‑Бизнеса.
Добавить сотрудников в список
Вы можете добавить сотрудника к вам в список, создав его анкету через метод Создать черновики анкет сотрудников.
Если у сотрудника уже есть карта T‑Банка, он просто добавится к вам в список.
Получить информацию по сотруднику
Используйте метод Получить информацию по сотрудникам.
- Вызывайте метод не чаще одного раза в 10 минут.
- В качестве параметров укажите идентификатор сотрудника —
employeeId
. Его можно получить через метод Получить результат создания черновиков анкет сотрудников. Если сотрудник был добавлен другим способом, воспользоваться этим методом не получится.
В ответе придет форма, из которой вы сможете узнать статус обработки анкеты сотрудника в банке и основную информацию.