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. Создайте черновик платёжного реестра через метод Создать черновик платёжного реестра.

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

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

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

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

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

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

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

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

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

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

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

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

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

openapi@tinkoff.ru

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

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