Receipts
Фискальный чек формируется по платежу и, отдельно, по возврату. Состав чека передаётся при создании операции — иначе он будет собран из данных вашего аккаунта по умолчанию.
Состав чека
Чек
customer_email
string
optional
Электронный адрес покупателя. Обязателен, если не заполнен телефон.
customer_phone
string
optional
Телефон покупателя. Обязателен, если не заполнен email.
taxation_system
integer
optional
Система налогообложения. Если не указана — берётся из настроек аккаунта.
items
array
required
Позиции расчёта. Хотя бы одна.
| Name | Type | Required | Description |
|---|---|---|---|
customer_email
|
string
|
optional | Электронный адрес покупателя. Обязателен, если не заполнен телефон. |
customer_phone
|
string
|
optional | Телефон покупателя. Обязателен, если не заполнен email. |
taxation_system
|
integer
|
optional | Система налогообложения. Если не указана — берётся из настроек аккаунта. |
items
|
array
|
required | Позиции расчёта. Хотя бы одна. |
Позиция
label
string
required
Наименование предмета расчёта.
price
string
required
Цена за единицу с учётом скидок и наценок, строкой.
quantity
string
required
Количество.
vat
integer
required
Ставка НДС. Числовой код — см. ниже.
payment_method
integer
optional
Признак способа расчёта: предоплата, аванс, полный расчёт, кредит.
payment_object
integer
optional
Признак предмета расчёта: товар, работа, услуга и т. д.
unit
string
optional
Единица измерения.
marking_code
string
optional
Код маркировки для товаров, подлежащих маркировке.
| Name | Type | Required | Description |
|---|---|---|---|
label
|
string
|
required | Наименование предмета расчёта. |
price
|
string
|
required | Цена за единицу с учётом скидок и наценок, строкой. |
quantity
|
string
|
required | Количество. |
vat
|
integer
|
required | Ставка НДС. Числовой код — см. ниже. |
payment_method
|
integer
|
optional | Признак способа расчёта: предоплата, аванс, полный расчёт, кредит. |
payment_object
|
integer
|
optional | Признак предмета расчёта: товар, работа, услуга и т. д. |
unit
|
string
|
optional | Единица измерения. |
marking_code
|
string
|
optional | Код маркировки для товаров, подлежащих маркировке. |
⚠
Сумма позиций должна сходиться с суммой операции
Если произведение цены на количество по всем позициям не равно сумме платежа, чек не будет сформирован, а платёж при этом уже пройдёт. Проверяйте сходимость до отправки.
Ставки НДС
Ставка передаётся числовым кодом, а не процентом. Набор кодов включает основные ставки (20%, 10%, 5%, 7%), расчётные (20/120, 10/110, 5/105, 7/107), нулевую ставку и «без НДС». Точный код для вашего случая уточняйте у бухгалтера: неверная ставка в фискальном документе исправляется только чеком коррекции.
Результат
Поля чека
id
string
optional
Идентификатор документа.
state
enum
optional
new, in_progress, send, completed, error.
link
string
optional
Ссылка на чек для покупателя.
processed_at
string
optional
Время регистрации документа в фискальном накопителе.
document_number
string
optional
Номер фискального документа.
fiscal_sign
string
optional
Фискальный признак.
total
string
optional
Сумма расчёта по чеку.
| Name | Type | Required | Description |
|---|---|---|---|
id
|
string
|
optional | Идентификатор документа. |
state
|
enum
|
optional | new, in_progress, send, completed, error. |
link
|
string
|
optional | Ссылка на чек для покупателя. |
processed_at
|
string
|
optional | Время регистрации документа в фискальном накопителе. |
document_number
|
string
|
optional | Номер фискального документа. |
fiscal_sign
|
string
|
optional | Фискальный признак. |
total
|
string
|
optional | Сумма расчёта по чеку. |
✦
Чек приходит позже платежа
Формирование фискального документа асинхронно: платёж может быть completed, а чек ещё в in_progress. О готовности сообщает отдельное уведомление — см. Status Updates.
Готовый чек можно повторно отправить покупателю на указанный email.