Перейти к основному содержимому

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

/api/v1/invoice/send

POST

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

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

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

Чтобы использовать метод, нужен доступ — opensme/inn/[{inn}]/kpp/[{kpp}]/invoice/submitСоздание, отправка счёта на оплату и получение его информации в компании с ИНН {inn} и КПП {kpp}.

Ограничение на использование метода — 4 запроса в секунду.

Авторизация

Security

Bearer API Token

Запрос

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 (InvoicePayerInfo)

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

name

String

Requirements: non-empty and <= 512 characters

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

inn

String

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

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

kpp

String

Requirements: Value must match regular expression ^(\d{9})$

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

items

Array of objects ()

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

Required

name

String

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

Required

price

Number

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

Required

unit

String

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

Required

vat

String (Vat)

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

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

Required

amount

Number

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

contacts

Array of objects ()

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

email

String

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

contactPhone

String

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

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

comment

String

Requirements: non-empty and <= 1000 characters

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

Ответ

200

OK

400

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

401

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

403

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

422

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

429

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

500

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

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

Loading...

openapi@tinkoff.ru

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