Чек передается в авторизационном запросе, а также может передаваться в запросах на подтверждение и отмену платежа, создание счета или оплату через web-сервисы silentpay и tokenpay. При передаче данных чека в запросе появляются дополнительные параметры:

Название

Обязательное поле

Принимаемые значения

Значение по умолчанию

Описание

GenerateReceipt

Нет

0 или 1

1

Разрешение формирования фискального чека. При значении параметра 0 формирование фискального чека запрещено для данной операции.

Tax

Нет

10 символов

Определяется настройкой предприятия "Ставка налога по умолчанию" и используется в режиме без передачи позиций чека (вся сумма должна проводится с одной ставкой).

Идентификатор ставки налога, значение из справочника (novat, vat0, vat10, vat20, vat110, vat120).

ReceiptLine

Нет

128 символов

Определяется настройкой предприятия "Шаблон строки чека по умолчанию" и используется в режиме без передачи позиций чека.

Текстовое описание позиции чека, если по чеку проводится одна единственная позиция.

FPMode

Нет

Число

Определяется настройкой предприятия "Признак способа расчета по умолчанию" и используется в режиме без передачи позиций чека.

Признак способа расчета.

TaxationSystem

Да/Нет1

Число

Из настроек предприятия или ККТ

Система налогообложения .

ChequeitemsДа/Нет2Строка в формате JSON
Позиции чека, см. «Работа с чеком».
LastNameНет70 символовПустоФамилия покупателя
FirstNameНет70 символовПустоИмя покупателя
MiddleNameНет70 символовПустоОтчество покупателя
CustomerDocIDНет11 символовПустоСерия/номер паспорта покупателя
TaxpayerIDНет12 символовПустоИНН покупателя
CompanyNameНет256 символовПустоНаименование компании (если покупатель – юридическое лицо)
PaymentAddressНет256 символовПустоАдрес расчетов
PaymentPlaceНет256 символовПустоМесто расчетов
CashierНет64 символаПустоКассир
CashierINNНет12 символовПустоИНН кассира
PaymentTerminalНет20 символовПустоНомер автоматического устройства
TransferOperatorPhoneНет19 символовПустоТелефон оператора перевода
TransferOperatorNameНет64 символаПустоНаименование оператора перевода
TransferOperatorAddressНет256 символовПустоАдрес оператора перевода
TransferOperatorINNНет12 символовПустоИНН оператора перевода
PaymentReceiverOperatorPhoneНет19 символовПустоТелефон оператора по приёму платежей
PaymentAgentOperationНет24 символаПустоОперация платёжного агента
PaymentAgentPhoneНет19 символовПустоТелефон платёжного агента
SupplierPhoneНет19 символовПустоТелефон поставщика
PaymentAgentModeНетчислоПустоПризнак агента
DocumentRequisiteНет16 символовПустоДополнительный реквизит чека
UserRequisitesНетструктура {"name": <string(64)>, "value": <string(256)>}ПустоДополнительные реквизиты пользователя


1Если предприятие использует несколько систем налогообложения, передача этого параметра становится обязательной. Параметр TaxationSystem задается для всего чека в целом (не передается в позициях чека). Если параметр не передан, то его значение берется из настроек предприятия. Если у предприятия не настроено значение параметра TaxationSystem по умолчанию, то в ККТ этот параметр (тег 1055) не отправляется и ККТ будет проводить чек по собственным настройкам. Это возможно только в том случае, если в ККТ настроена только одна система налогообложения, в противном случае ККТ выдаст ошибку.


2Состав чека (поля с названием, стоимостью за единицу товара/услуги, ставкой налога и способом расчета по каждой позиции) определяется по следующим правилам.

  1. Если в запросе передана структура ChequeItems (см.  «Работа с чеком»), то формируется чек с количеством позиций по числу переданных в ChequeItems строк, в каждой позиции должны быть обязательно указаны параметры:
    • product и/или name;
    • price;
    • quantity;
    • amount;

при этом:

название каждой из позиций формируется как объединение параметров product и name через пробел (если переданы оба) или как один из параметров product или name соответственно (если передан только один);

если параметры Tax или FPmode не переданы в позициях, то они могут быть переданы в параметрах запроса (в этом случае значения этих параметров будут одинаковыми для всех позиций чека, переданных в ChequeItems);

если параметры Tax или FPmode не переданы в параметрах запроса, то их значения подставляются из настроек предприятия (значения этих параметров будут одинаковыми для всех позиций чека, переданных в ChequeItems);

если настройки предприятия для этих параметров отсутствуют, то обработка запроса завершается с ошибкой (недостаточно данных для выполнения операции).

2. Если в запросе не передана структура ChequeItems, то формируется чек с одной позицией, в которой:

    • название позиции подставляется из параметра ReceiptLine, если он передан в запросе; если параметр ReceiptLine не передан в запросе, то название позиции подставляется из настроек предприятия; если настройки предприятия для этих параметров отсутствуют, то в качестве названия подставляется строка "Оплата заказа";
    • стоимость единицы товара/услуги подставляется из параметра запроса Amount;
    • количество всегда равно 1;

если параметры Tax или FPmode не переданы в параметрах запроса, то их значения подставляются из настроек предприятия;

если настройки предприятия для этих параметров отсутствуют, то обработка запроса завершается с ошибкой (недостаточно данных для выполнения операции).

Передача данных по всем позициям чека

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

Описание параметра позиции чека

Как передается

Описание товара или услуги

Передается в структуре chequeitems в поле name

Цена за единицу

Передается в структуре chequeitems в поле price

Количество

Передается в структуре chequeitems в поле quantity

Ставка налога (НДС 10%/НДС 18% и.т.п.)

Передается в структуре chequeitems в поле tax или подставляется из настроек предприятия

Способ расчета (полный расчет, аванс и т.п.)

Передается в структуре chequeitems в поле fpmode или подставляется из настроек предприятия

Передача данных по одной позиции чека

При передаче данных по одной позиции чека используются следующие параметры:

Описание параметра позиции чека

Как передается

Описание товара или услуги

Передается в параметре заказа ReceiptLine

Цена за единицу

Передается в параметре заказа OrderAmount

Количество

Всегда = 1

Ставка налога (НДС 10%/НДС 18% и.т.п.)

Передается в параметре заказа Tax или подставляется из настроек предприятия

Способ расчета (полный расчет, аванс и т.п.)

Передается в параметре заказа FPMode или подставляется из настроек предприятия

Единственная позиция чека формируется по настройкам предприятия

Если предприятие не передает позиции чека, а единственная позиция чека формируется по настройкам предприятия, то используются следующие параметры:

Описание параметра позиции чека

Как передается

Описание товара или услуги

Формируется на основе описания, заданного в настройках предприятия. Если такое описание отсутствует, то подставляется значение «Оказанная услуга».

Цена за единицу

Передается в параметре заказа OrderAmount

Количество

Всегда = 1

Ставка налога (НДС 10%/НДС 18% и.т.п.)

Подставляется из настроек предприятия

Способ расчета (полный расчет, аванс и т.п.)

Подставляется из настроек предприятия

Наверх