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

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

Required

invoiceNumber

String

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

Номер счета.

dueDate

String<date>

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

invoiceDate

String<date>

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

accountNumber

String

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

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

payer

Object (InvoicePayerInternalInfoL29wZW5hcGktaW52b2ljaW5nLnlhbWwx)

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

name

String

Requirements: <= 512 characters

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

inn

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

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

kpp

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

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

items

Array of objects ()

Requirements: <= 100 items

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

Required

name

String

Requirements: <= 1000 characters

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

Required

price

Number

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

Required

unit

String

Requirements: <= 50 characters

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

Required

vat

String (VatL29wZW5hcGktaW52b2ljaW5nLnlhbWwx)

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

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

Required

amount

Number

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

contacts

Array of objects ()

Requirements: <= 10 items

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

String<string>

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

contactPhone

String

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

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

comment

String

Requirements: <= 1000 characters

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

customPaymentPurpose

String

Requirements: <= 512 characters

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

Ответ

200

Успешный запрос

400

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

401

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

403

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

422

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

429

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

500

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

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

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