1. Saby
  2. База знаний
  3. API
  4. API Триггеры
  5. Объект «Чек»

Объект «Чек»

Объект «Чек»

Таблица содержит перечень ключевых полей объекта «Чек» с типом данных и описанием. Поля доступны для обращения в коде триггера.

Параметр

Тип

Описание

KktIdInt

ID кассового аппарата

DeviceIdInt

ID устройства

UserInnoptional<Inn>

ИНН организации

SpInnoptional<Inn>

ИНН торговой точки

KktRegIdoptional<kktregid>

Регистрационный номер ККТ

SerialNumberoptional<String>

Серийный номер ККТ

ReceiptJsonObject

Данные чека (JSON)

DocumentTypeenum

Тип документа

PrintModeenum

Режим печати: NORMAL — с печатью, NO_PRINT — без печати

Operatorstring

ФИО или должность кассира

OperatorInnoptional<inn>

ИНН кассира

DateTimeoptional<datetime>

Дата и время (только чтение)

FiscalDocumentNumberinteger

Номер фискального документа

FiscalSignoptional<fiscalsign>

Фискальный признак (только чтение)

ShiftNumberinteger

Номер смены

RequestNumberinteger

Номер чека в смене

RetailAddressstring

Адрес расчетов

Userstring

Название организации

FiscalDriveNumberoptional<fiscaldrivenumber>

Заводской номер фискального накопителя

RetailPlacestring

Место расчетов

FiscalDocumentFormatVerenum

Версия фискального формата

MachineNumberstring

Номер автомата

FnsUrlstring

Сайт ФНС

InternetSignbool | false

Признак онлайн-расчета

SellerAddressoptional<email>

Email отправителя чека

TotalSumoptional<money>

Общая сумма к оплате

CashTotalSumoptional<money>

Оплата наличными

EcashTotalSumoptional<money>

Оплата безналом

PrepaidSumoptional<money>

Сумма предоплаты

CreditSumoptional<money>

Покупка в кредит

ProvisionSumoptional<money>

Сумма по встречному предоставлению

EcashSubSumsJsonObject

Разбивка безналичной оплаты

AppliedTaxationTypeenum

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

Nds20optional<money>

НДС 20%

Nds10optional<money>

НДС 10%

Nds0optional<money>

НДС 0%

NdsNooptional<money>

Без НДС

Nds20_120optional<money>

НДС по ставке 20/120

Nds10_110optional<money>

НДС по ставке 10/110

BuyerPhoneOrAddressoptional<PhoneNumber|Email>

Контакты покупателя

Buyeroptional<String>

Имя покупателя

BuyerInnoptional<Inn>

ИНН покупателя

InfoJsonObject[]

Информация перед итогами

HeaderJsonObject[]

Информация в шапке чека

FooterJsonObject[]

Информация в подвале чека

CertificateListJsonObject[]

Сертификаты отдельным чеком

EnumsJsonObject[]

Константы с названиями

WorkplaceIdinteger

ID рабочего места

Структура объект receipt

Параметр
* — обязательный

Тип

Описание

DocumentType

enum

Тип документа. Возможные значения:

  • receipt_sale — чек продажи (прихода);
  • receipt_sale_return — чек возврата продажи (прихода);
  • receipt_buy — чек покупки (расхода);
  • receipt_buy_return — чек вовзрата покупки (расхода);
  • receipt_sale_non_fiscal — нефискальный чек продажи (прихода);
  • receipt_sale_return_non_fiscal — нефискальный чек возврата продажи (прихода).

PrintMode

enumРежим печати документа. Возможные значения: NORMAL (0) — нормальный режим печати, NO_PRINT (4) — регистрация (фискализация) документа без печати

Operator

stringФИО или должность кассира. Длина от 0 до 64 символов

OperatorInn

optional<inn>ИНН кассира

DateTime

optional<datetime>Дата и время (только для чтения)

FiscalDocumentNumber

integerПорядковый номер фискального документа (только для чтения). Диапазон значений от 1 до 4294967295

FiscalSign

optional<fiscalsign>Фискальный признак документа (только для чтения)

ShiftNumber

integerНомер смены (только для чтения). Диапазон значений от 1 до 65535

RequestNumber

integerНомер чека за смену (фискальные чеки/чеки коррекции) (только для чтения). Диапазон значений от 1 до 4294967295

RetailAddress

stringАдрес расчетов. Длина от 0 до 256 символов

UserInn

optional<inn>ИНН пользователя (ИНН, на который зарегистрирована ККТ)

KktRegId

optional<kktregid>Регистрационный номер ККТ

FiscalDriveNumber

optional<fiscaldrivenumber>Заводской номер фискального накопителя

User

stringНаименование пользователя (организации, на которую зарегистрирована ККТ). Длина от 0 до 256 символов

RetailPlace

stringМесто расчетов. Длина от 0 до 256 символов

FiscalDocumentFormatVer

enumВерсия формата фискальных данных. Значение по умолчанию — FFD_1_2

MachineNumber

stringНомер автомата. Длина от 0 до 20 символов

FnsUrl

stringАдрес сайта ФНС. Длина от 0 до 256 символов

InternetSign

boolПризнак расчетов в интернете. Возможные значения: true, false. По умолчанию — false. Только для чтения

SellerAddress

optional<email>Адрес электронной почты отправителя чека

TotalSum

optional<money>Сумма расчета в рублях. Если в оплате присутствует сумма оплаты наличными (больше нуля), то поле TotalSum может использоваться для округления копеек (в пределах 0-99 копеек), при этом будет начислена сдача

CashTotalSum

optional<money>Сумма уплаченная наличными

EcashTotalSum

optional<money>Сумма уплаченная безналичными

PrepaidSum

optional<money>Сумма предоплаты (авансами)

CreditSum

optional<money>Сумма постоплаты (кредитами)

ProvisionSum

optional<money>Сумма по встречным предоставлением

EcashSubSums

JsonObjectУточнение суммы оплаты безналичными. Сумма всех подвидов безналичных должна быть равна EcashTotalSum
 

BankCardSum

optional<money>Сумма оплаты по банковской карте

SalarySum

optional<money>Сумма оплаты под зарплату

QrCodeSum

optional<money>Сумма оплаты по QR коду

InternetSum

optional<money>Сумма оплаты через Интернет

PaymentOrderSum

optional<money>Сумма оплаты платежного поручения через банковский расчетный счет

PrepaidQualification

JsonObjectУточнение для суммы предоплаты
 

CertificateSum

optional<money>Сумма оплаты сертификатом. Должно соблюдаться условие: PrepaidSum <= PrepaidQualification.CertificateSum

AppliedTaxationType

enumПрименяемая система налогообложения. Если не задана, то будет взята первая заданная CHO из тех, на которые зарегистрирована ККТ. Приоритетность выбора следующая: ОСН – УСН (доход) – УСН (доход минус расход) – ЕНВД – ЕСХН – ПСН

Nds1B

optional<money>Сумма НДС чека по ставке 20%

Nds10

optional<money>Сумма НДС чека по ставке 10%

Nds0

optional<money>Сумма расчета по чеку с НДС по ставке 0%

NdsNo

optional<money>Сумма расчета по чеку без НДС

Nds18118

optional<money>Сумма НДС чека по расчетной ставке 20/120

Nds18110

optional<money>Сумма НДС чека по расчетной ставке 10/110

Nds5

optional<money>Сумма НДС по ставке 5%

Nds7

optional<money>Сумма НДС по ставке 7%

Nds5105

optional<money>Сумма НДС по ставке 5/105

Nds7107

optional<money>Сумма НДС по ставке 7/107

BuyerPhoneOrAddress

optional<PhoneNumber|Email>Телефон или электронный адрес покупателя

Buyer

optional<String[0-256]>Наименование покупателя

Buyerinn

optional<Inn>ИНН покупателя

Items

JsonObject

Список предметов расчета

 

Quantity

quantityКоличество

Name

String[0-128]Наименование предмета расчета

Sum

optional<money>Стоимость товара с учетом скидок и наценок. Если не задана, то будет вычислена как `Items[i].Price * Items[i].Quantity`. Данным полем можно регулировать величину скидки/наценки

Price

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

ProductCode

optional<String>Код товара

ItemsProductCodeNew

JsonObjectКод товара
 

ItemsProductCodeNewUndefined

optional<String[0-32]>Нераспознанный код товара

ItemsProductCodeNewEan8

optional<String[0-8]>Код товара в формате EAN-8

ItemsProductCodeNewEan13

optional<String[0-13]>Код товара в формате EAN-13

ItemsProductCodeNewIt14

optional<String[0-14]>Код товара в формате ITF-14

ItemsProductCodeNewGs1

optional<String[0-38]>Код товара в формате GSI, не подлежащий маркировке средствами идентификации

ItemsProductCodeNewGs1m

optional<String[0-38]>Код товара в формате GSI, подлежащий маркировке средствами идентификации

ItemsProductCodeNewKmk

optional<String[0-38]>КТ КМК

ItemsProductCodeNewMi

optional<String[0-20]>КТ МИ

ItemsProductCodeNewEgais2

optional<String[0-33]>КТ ЕГАИС-2.0

ItemsProductCodeNewEgais3

optional<String[0-14]>КТ ЕГАИС-3.0

ItemsProductCodeNewF1

optional<String[0-32]>КТ Ф.1

ItemsProductCodeNewF2

optional<String[0-32]>КТ Ф.2

ItemsProductCodeNewF3

optional<String[0-32]>КТ Ф.3

ItemsProductCodeNewF4

optional<String[0-32]>КТ Ф.4

ItemsProductCodeNewF5

optional<String[0-32]>КТ Ф.5

ItemsProductCodeNewF6

optional<String[0-32]>КТ Ф.6

PropertiesItem

optional<String[0-64]>Дополнительный реквизит предмета расчета

LabeledProdFractionalQuantity

JsonObjectДробное количество маркированного товара
 

FractionalPart

optional<String[0-64]>Дробная часть

Numerator

optional<int64>Числитель

Denominator

optional<int64>Знаменатель

ItemsQuantityMeasure

enumМера количества предмета расчета. Значение по умолчанию: ItemsQuantityMeasure::OTHER_UNITS_OF_MEASUREMENT

LabelCodeProcessMode

enumРежим обработки кода маркировки (только для чтения). Значение по умолчанию: LabelCodeProcessMode::DEFAULT

CheckingProdInformationResult

enumРезультат проверки сведений о товаре (только для чтения). Значение по умолчанию: CheckingProdInformationResultFlags::UNDEFINED

ControlCode

optional<String[0-4]>Контрольный код КМ (только для чтения)

Unit

optional<String[0-16]>Единица измерения товара

UnitNds

optional<Money>Размер НДС за единицу товара

Nds

enumСтавка НДС. Значение по умолчанию: Nds::VAT_RATE_NONE

NdsSum

optional<Money>Сумма НДС за товар

ProductType

enumПризнак предмета расчета. Значение по умолчанию: ProductType::MERCHANTABLE

PaymentType

enumПризнак способа расчета. Значение по умолчанию: PaymentType::FULL_PAYMENT

PaymentAgentByProductType

enumПризнак агента по предмету расчета. Значение по умолчанию: PaymentAgentFlags::NONE

PaymentAgentData

JsonObjectДанные агента
 

OperatorTransferAddress

optional<String[0-256]>Адрес оператора перевода

OperatorTransferInno

optional<Inn>ИНН оператора перевода

OperatorTransferName

optional<String[0-64]>Наименование оператора перевода

BankAgentOperation

optional<String[0-24]>Операция платежного агента

BankAgentPhone

PhoneNumber[]Список телефонов платежного агента

PaymentAgentPhone

PhoneNumber[]Список телефонов оператора по приему платежей

OperatorPhoneToTransfer

PhoneNumber[]Список телефонов оператора перевода

ProviderData

JsonObjectДанные поставщика
 

ProviderPhone

PhoneNumber[1][]Список телефонов поставщика

ProviderName

optional<String[0-256]>Наименование поставщика

ProviderInn

optional<Inn>ИНН поставщика

ExciseDuty

optional<Money>Акция

OriginCountryCode

optional<String[0-3]>Код страны происхождения товара

ItemsIndustryDetails

JsonObject|{} as IndustryReceiptDetailsОтраслевой реквизит предмета расчета

PositionNoteEx

JsonObject[] as TextArgs[]Область печати произвольной информации после предмета расчета

NomenclatureNumber

optional<String>Номер номенклатуры из каталога (обычно начинается с «X»)

Info

JsonObject[] as TextArgs[]Область печати произвольной информации между последним предметом расчета и суммами оплат (итог)

Header

JsonObject[] as TextArgs[]Область печати произвольной информации до чека

Footer

JsonObject[] as TextArgs[]Область печати произвольной информации после чека

CertificateList

JsonObject[] as TextArgs[]Печать сертификатов отдельным чеком
Нашли неточность? Выделите текст с ошибкой и нажмите ctrl + enter.