Операции по счёту

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

Операции по счёту можно получить двумя способами — через метод Получить выписку по счёту или вебхуки. Данные можно использовать, чтобы:

• подгружать их в 1С и вести бухгалтерскую сверку;
• анализировать финансовые показатели компании;
• оперативно узнавать о списаниях и пополнениях.

Статусы операций

Операция может находиться в двух статусах:

• Авторизация — неподтверждённая операция. Изменяет доступный остаток счёта, но не изменяет баланс счёта. Например, авторизацией списания воспользоваться не получится.
• Транзакция — подтверждённая операция.

Авторизации можно использовать для контроля движений по счёту, но нельзя предоставлять в качестве бухгалтерской отчётности — например, отдавать в налоговую или подгружать в 1С.

У каждой операции есть свой уникальный operationId. Он не меняется на протяжении всего жизненного цикла операции — например, при переходе из статуса Авторизация в статус Транзакция или при отмене операции operationId останется тем же.

operationId в методе Получить выписку по счёту равен operationId в вебхуках.

Этапы операций

Операция может совершаться в четыре этапа. Каждый из них имеет собственное время:

• docDate — подписание плательщиком распоряжения на вывод средств. 4-е поле платёжного документа по 862-П ЦБ.

• authorizationDate — авторизация, холдирование средств на счёте.

• trxnPostDate — транзакция, изменение баланса договора.

• operationDate — проведение по балансу банка, дата операции. 71-е поле платёжного документа по 862-П ЦБ. Финальный статус операции, может являться только рабочим днём банка:

  • drawDate — дата поступило, для исходящих операций;
  • chargeDate — дата списано, для входящих операций.

При сдаче отчётности в налоговую или 1С в качестве основной даты операции можно использовать только дату проведения по балансу банка. Например, authorizationDate понадобится, если нужно понять, когда курьер оплачивал товар картой, привязанной к расчётному счёту.

Обычно все даты появляются по очереди — по мере прохождения операции по статусной модели. Иногда от момента появления операции до перехода в финальный статус может пройти 3–4 дня. Это зависит не только от T‑Банка, но и от платёжных систем, которые передают информацию о платеже в банк.

Примеры статусной модели

• Авторизация — момент, когда карту прислонили к терминалу оплаты: понедельник, 10:00.
• Транзакция — момент, когда платёжная система подтвердила, что операцию можно исполнить: четверг, 16:00.
• Подписание плательщиком распоряжения на вывод средств — заполняется автоматически, равно дате транзакции.
• Проведение по балансу банка — четверг.

Две последние даты будут заполнены до 12:00 пятницы в связи с обработкой на стороне банка.

Категории операций

• cardOperation — оплата картой.

• cashOut — снятие наличных.

• fee — услуги банка.

• penalty — штрафы.

• contragentPeople — исходящие платежи:

  • selfIncomeOuter — перевод себе в другой банк;
  • selfTransferOuter — перевод между своими счетами в T‑Бизнесе;
  • salary — выплаты;
  • contragentOutcome — перевод контрагенту;
  • contragentRefund — возврат контрагенту.

• budget — платежи в бюджет.

• tax — налоговые платежи.

• creditPaymentOuter — погашение кредита.

• sme-c2c — с карты на карту.

• otherOut — другое.

• unspecifiedOut — без категории.

Метод Получить выписку по счёту

Для интеграции:

1. Выпустите токен: перейдите в раздел Интеграции → Выпуск токена и выберите доступ Счета и выписки — «Информация о счетах компании» и «Информация об операциях компании».
2. Настройте использование метода Получить выписку по счёту.
3. Отправьте первый запрос.

Вебхуки

Мы рекомендуем вебхуки, если:

• у вас больше 10 тысяч операций по счёту ежедневно;
• вам нужно узнавать об операции сразу — например, чтобы контролировать расходы или отправлять заказ после оплаты клиентом.

Вебхук Операция по счёту

Для интеграции:

1. Настройте URL, к которому будет обращаться вебхук с POST-запросом о новом событии. Он должен отвечать протоколу HTTPS. Авторизация необязательна, но мы поддерживаем -basic и -bearer авторизацию.

2. Отправьте письмо на openapi@tinkoff.ru с почты, которая привязана к аккаунту в банке. В письме укажите:

   • какое событие нужно подключить — вебхук «Операция по счёту»,
   • URL, который вы настроили,
   • данные для авторизации — если есть,
   • ИНН компании.

В течение 1 рабочего дня мы подключим вебхук и пришлём уведомление.

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