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

С помощью зарплатных методов 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": "ФМС"}

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

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

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

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

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

3. Когда вы успешно создаете черновик заявки на выпуск карты 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‑Банка, он просто добавится к вам в список.

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

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

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

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