Выставить счет

POST

https://business.tbank.ru/openapi/api/v1/invoice/send

Метод для выставления счетов — номер, срок оплаты, дата выставления, информация о плательщике и другое.

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

Как добавить логотип, подпись и печать

Авторизация

Security

Bearer API Token

RPS

Ограничение — 4 запроса в секунду

Scopes

Выставление счетов → Создание, отправка счета на оплату и получение его информации в компании с ИНН {inn} и КПП {kpp}

Запрос

Header parameters

X-Request-Id

String<uuid>

Уникальный идентификатор для трассировки запроса. Не влияет на логику его исполнения.

Request body schema application/json

items

Array of objects ()

Requirements: <= 100 items

Позиции счета.

Required

vat

String (Vat1301718711)

Requirements: [None, 0, 5, 7, 10, 18, 20, 22]

НДС. None — без НДС.

Required

name

String

Requirements: <= 1000 characters

Наименование.

Required

price

Number

Цена за единицу в рублях.

Required

amount

Number

Количество единиц.

Required

unit

String

Requirements: <= 50 characters

Единицы измерения.

contacts

Array of objects ()

Requirements: <= 10 items

Контакты для получения счета.

String<string>

Электронная почта.

customPaymentPurpose

String

Requirements: <= 512 characters

Текст, который попадет в назначение платежа при сканировании QR-кода или оплате через личный кабинет Т-Бизнеса.

comment

String

Requirements: <= 1000 characters

Комментарий.

dueDate

String<date>

Срок оплаты. Должен быть не меньше даты выставления счета.

accountNumber

String

Requirements: Value must match regular expression ^(\d{20}|\d{22})$

Рублевый расчетный счет отправителя. Если счет не указан, для выставления счета будет использоваться главный счет компании.

contactPhone

String

Requirements: Value must match regular expression ^((\+7)([0-9]){10})$

Номер мобильного телефона, на который придет СМС-сообщение со счетом.

payer

Object (InvoicePayerInternalInfo1301718711)

Информация о плательщике.

inn

String<^(\d{12}|\d{10})$>

ИНН плательщика.

kpp

String<^(\d{9})$>

КПП плательщика.

name

String

Requirements: <= 512 characters

Наименование плательщика.

Required

invoiceNumber

String

Requirements: Value must match regular expression ^\d{1,15}$

Номер счета.

invoiceDate

String<date>

Дата выставления счета. Если не указана, счет выставляется текущей датой.

withBnplBanner

Boolean

Переключатель, активен для счетов >=50 000 и <=10 000 000. Если активен, в PDF счёта добавляется кликабельный баннер с рассрочкой.

Ответ

200

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

502

Bad Gateway

503

Service Unavailable

504

Gateway Timeout

Это полезный материал?

Обратиться в поддержку