Чек передается в авторизационном запросе, а также может передаваться в запросах на подтверждение и отмену платежа, создание счета или оплату через 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Состав чека (поля с названием, стоимостью за единицу товара/услуги, ставкой налога и способом расчета по каждой позиции) определяется по следующим правилам.
- Если в запросе передана структура 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% и.т.п.) | Подставляется из настроек предприятия |
Способ расчета (полный расчет, аванс и т.п.) | Подставляется из настроек предприятия |