К содержимому
Инвойсбокс

Получение счёта

Счета читаются одним запросом — списком или по идентификатору:

  • метод: GET
  • ресурс: /v3/payment/api/invoice или /v3/payment/api/invoice/{invoiceId}
  • тело ответа - коллекция объектов InvoiceResponse в свойстве data, постраничность — в metaData (см. формат ответа выборки)
Пример запроса и ответа
GET /v3/payment/api/invoice/01771534-196a-1105-839a-82422289d6d9

В запросе возможно применения фильтров и сортировок.

Пример запроса с фильтром по идентификатору счёта

GET /v3/payment/api/invoice?id=01771534-196a-1105-839a-82422289d6d9

Пример запроса с фильтром по статусу

GET /v3/payment/api/invoice?status=paid

Пример запроса с фильтром по ИНН

GET /v3/payment/api/invoice?customer[type][eq]=legal&customer[vatNumber][eq]=2323232323

Пример запроса с фильтром по номеру телефона

GET /v3/payment/api/invoice?customer[type][eq]=private&customer[phone][eq]=79001231212

Ответ:

{
  "data": [
    {
      "id": "01771534-1a57-f184-dee3-ebeb91dded76",
      "number": "123-123212",
      "createdAt": "2026-08-01T10:00:00+03:00",
      "expirationDate": "2026-08-04T10:00:00+03:00",
      "description": "Оплата номера в отеле",
      "amount": 19658.45,
      "currencyId": "RUB",
      "status": "created"
    }
  ]
}

InvoiceResponse

СвойствоТипОписаниеПример значения
id *string(36)Идентификатор счёта01771534-1a57-f184-dee3-ebeb91dded76
number *string(50)Номер счёта123-123212
createdAt *datetimeДата создания счёта2026-08-30T00:00:00+00:00
expirationDate *datetimeСрок оплаты счёта2026-08-30T00:00:00+00:00
description *string(1000)Описание счётаОплата номера в отеле
amount *floatСумма счёта (к оплате)19658.45
vatAmount *floatСумма НДС в счёте156.56
currencyId *string(3) enumКод валюты счёта в соответствии с ISO 4217RUB, USD,EUR, GBP
customerCustomerИнформация о плательщике
paymentOrderTemplatePaymentOrderTemplateШаблон платёжного поручения (детали платежа)
statusstring(50) enumСтатус оплаты счёта (paid, pending, canceled, partial)paid
paymentUrl *string(1000)Ссылка для перехода на платёжный шлюз на страницу счёта

Customer

СвойствоТипОписаниеПример значения
type *string(10) enumТип заказчикаlegal - юр. лицо, private - физ лицо
namestring(500)Наименование или имяООО «Ромашка»
phonestring(100)Номер телефона79001112233
emailstring(100)Электронная почтаbuh@example.invbox.ru
vatNumberstring(20)ИНН7701234560
registrationAddressstring(1000)Юр. адрес190000, Санкт-Петербург, Невский пр. 147, офис 321

PaymentOrderTemplate

СвойствоТипОписаниеПример значения
type *string(10) enumТип получателяlegal - юр. лицо, private - физ лицо
amount *floatСумма счёта (к оплате)19658.45
currencyId *string(3) enumКод валюты счёта в соответствии с ISO 4217RUB, USD,EUR, GBP
name *string(500)НаименованиеООО Ромашка
vatNumber *string(20)ИНН7710044140
taxRegistrationReasonCode *string(9)КПП770001001
settlementAccount *string(20)Номер расчт. счёта40702810800190000253
correspondentAccount *string(20)Номер корр. счёта30101810700000000187
bankName *string(100)Наименование банкаПАО ВТБ
bic *string(9)БИК044039142
kbk *string(20)Код бюджетной классификации (КБК)18210501011011000110
oktmo *string(7)ОКТМО40000000
uin *string(25)УИН34934876203474
paymentPurpose *string(210)Назначение платежаОплата по счёту №10-2946153 за авиабилеты, НДС не выделяется
Страница помогла?