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

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

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

Ответ

200

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

400

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

401

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

403

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

422

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

429

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

500

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

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

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

Получить консультацию по интеграции