API: товарный чек

POST /api/v1/documents/chek

Формирует печать товарного чека (без сохранения в кабинете) и возвращает PDF или XLSX.

Список шаблонов: GET /api/v1/documents/chek/templates

Пример

{
  "format": "pdf",
  "template": 430,
  "response": "json",
  "number": "15",
  "date": "2026-08-23",
  "currency": "643",
  "decimal_places": 2,
  "number_format": "apostrophe",
  "print_stamp": true,
  "seller": {
    "name": "ООО Ромашка",
    "inn": "7701234567",
    "kpp": "770101001",
    "address": "г. Москва, ул. Примерная, д. 1",
    "phone": "+7 495 000-00-00",
    "director": "Иванов Иван Иванович",
    "director_post": "Генеральный директор",
    "stamp_url": "https://example.com/stamp.png",
    "director_sign": "https://example.com/director.png",
    "bank": {
      "name": "ПАО Сбербанк",
      "bik": "044525225",
      "correspondent_account": "30101810400000000225",
      "checking_account": "40702810900000000001"
    }
  },
  "items": [
    {
      "article": "123",
      "name": "Сплит-система",
      "quantity": 2,
      "price": 10000,
      "vat": 20,
      "unit": "шт"
    }
  ]
}

items можно передать и объектом с числовыми ключами. Пустой массив ([]) не считается ошибкой: в таблицу попадёт одна пустая строка.

Покупатель для чека не обязателен: в печати используются реквизиты продавца и позиции.

Основные поля

Поле	Описание
format	pdf (по умолчанию) или xlsx
template	код печатной формы, по умолчанию 430
number	номер чека (алиас doc_number)
date	дата Y-m-d; если не передана — сегодня (алиас doc_date)
currency	код валюты, по умолчанию 643
print_stamp	печать и подписи
decimal_places	знаков после запятой в печати: 0–3; (алиасы decimals, znaki; см. Обзор)
number_format	отображение сумм: apostrophe (1'500.00) или space (1 500,00); (см. Обзор)
seller	реквизиты продавца — как в счёте на оплату
items	позиции; пустой массив печатает одну пустую строку
response	file или json

Шаблоны

template	Название
430	Товарный чек

Актуальный список всегда в GET /api/v1/documents/chek/templates.

Позиция

Поле	Описание
name	наименование
article	артикул (алиас art)
quantity	обязательно, кроме заголовка, подитога и пустой строки
price	обязательно, кроме заголовка, подитога и пустой строки
vat	ставка НДС: 20, +20, 0, - и т.п. (см. Обзор)
unit	ед. изм. (алиас unit_name)
is_header	строка-заголовок таблицы
is_subtotal	строка-подитог
vat_value	игнорируется, считается на сервере
sum	игнорируется, считается на сервере

Заголовок и подитог — как в счёте на оплату.

Для примера выше сумма будет 20000.00, НДС 3333.33.