Описание шаблона

Шаблон авансового чека

Шаблон имеет строго определенную, но расширяемую структуру. Шаблон чека описан в формате JSON и имеет обязательные переменные.

Пример авансового чека

Базовая структура шаблона чека:

{
    "margin_left": 0,
    "margin_right": 10,
    "variables": {
      "type_advance": "Avans"
    },
    "header":[  ],    
    "positions":[  ],    
    "position_totals":[  ],    
    "payments":[  ],    
    "footer":[  ]
}

Переменные, отвечающие за отображение данных:

  • "margin_left" - Отступ в пикселях от края слева.
  • "margin_right" - Отступ в пикселях от края справа.
  • "alignment" - выравнивание текста. 0 - по левому краю, 1 - по центру, 2 - по правому краю;
  • <SF> - заполнение пробелами (" ");
  • <DF> - заполнение прочерками ("-");
  • <UF> - заполнение знаком ("_");
  • <EF> - заполнение знаком равенства ("=");
  • <PF> - заполнение знаком плюс ("+");
  • <AF> - заполнение знаком звёздочка ("*").

Текстовые переменные:

  • "type_advance": "Avans" - текст переменной doc.type в авансовом чеке

Далее структура шаблона имеет следующие разделы:

1. header - Заголовок шаблона чека.

Может содержать информацию о смене, кассире, кассе, дате продажи.

Пример раздела header:

"header": [
    {
      "text": "",
      "font": "",
      "interval": 10,
      "img_src": "1",
      "alignment": 1,
      "img_width": 200,
      "img_height": 159
    },
    {
      "text": "<company.name> ",
      "font": "Lucida Console, 8pt, style=bold",
      "interval": -10,
      "alignment": 1
    }
]

В разделе доступны для использования следующие переменные:

  • doc.code - Код документа
  • doc.date - Дата регистрации чека
  • doc.time - Время регистрации чека
  • doc.session - Кассовая смена, в которой регистрируется чек
  • doc.cashier_name - Имя кассира
  • doc.cash_id - ID кассы
  • doc.type - Тип документа. Данные переменной берутся из переменных в начале шаблона
  • doc.fiscal_sign - Фискальный признак чека
  • doc.terminal_id - ID фискального модуля
  • doc.sn - Серйиный номер REGOS: VCR
  • doc.qr_code - QR код
  • doc.total_recieved - Сумма принятых оплат
  • doc.duplicate - Номер дубликата чека. Если чек печатается в первый раз, данная переменная не выводится
  • company.inn - ИНН компании
  • company.name - Наименование компании
  • company.address - Адрес торговой точки или компании
  • company.phone - Контактный номер

В данном разделе можно использовать собственные переменные, которые передаются непосредственно в чеке. Наименование такой переменной задаётся по следующему формату:
custom.<name>, где name - это значение поля name в custom_variables

Блок иображения

Если текстовый блок в данном разделе включает в себя следующие теги, то текстовое содержимое блока игнорируется и в блоке отображается указанное изображение:

  • "img_src":"\Cheque\regos.png" - Адрес изображения
  • "img_width":180 - ширина изображения в пикселях
  • "img_height":180 - высота изображения в пикселях

Пример блока изображения:

{
    "text" : "",
    "font" : "",
    "interval" : 30,
    "alignment": 1,
    "img_src":"\\Cheque\\regos.png",
    "img_width":180,
    "img_height":180
}
Блок штрих-кода

Если текстовый блок в данном разделе включает в себя следующие теги, то текстовое содержимое блока шифруется в указанный тип штрих-кода и отображается в блоке:

  • "barcode_height":50 - Высота штрих-кода в пикселях
  • "barcode_module":2 - Размер штрих-кода, коэффициент масштабирования. Минимальное значение 1.
  • "barcode_show_text":(true, false) - Отображать текст под штрих-кодом
  • "barcode_type":1 - Тип штрих-кода. 1 - Code128, 2 - EAN13, 3 - QRCode

Пример блока штрих-кода:

{
    "font" : "Lucida Console, 8pt",
    "text" : "<doc.code>",
    "barcode_height":50,
    "barcode_module":2,
    "barcode_show_text":false,
    "barcode_type":1,
    "interval" : 30,
    "alignment": 1
}

2. positions - Список позиций.

Содержит информацию о списке номенклатуры, её количестве, цене.

Пример раздела positions:

"positions":[
    {
      "text": "<pos.n>. <pos.name> [<pos.unit>]",
      "font": "Lucida Console, 7pt",
      "interval": 15,
      "alignment": 0
    },
    {
      "text": "Sh.k: <pos.barcode>",
      "font": "Lucida Console, 7pt",
      "interval": 15,
      "alignment": 0
    }
]

В разделе доступны для использования следующие переменные:

  • pos.n - Номер позиции номенклатуры
  • pos.name - Наименование номенклатуры
  • pos.code - Код номенклатуры
  • pos.articul - Артикул номенклатуры
  • pos.unit - Единица измерения количества номенклатуры
  • pos.unit2 - Единица измерения количества номенклатуры с КДТ
  • pos.kdt - Количество номенклатуры с КДТ
  • pos.size - Размер номенклатуры
  • pos.color - Цвет номенклатуры
  • pos.brand - Бренд номенклатуры
  • pos.producer - Производитель номенклатуры
  • pos.country - Страна производителя номенклатуры
  • pos.department - Отдел номенклатуры
  • pos.group - Номенклатурная группа
  • pos.quantity - Количество номенклатуры
  • pos.price - Цена номенклатуры
  • pos.amount - Значение суммы цены номенклатуры (pos.quantity * pos.price)
  • pos.vat_value - Ставки НДС
  • pos.vat_amount - Значение суммы ставки НДС
  • pos.discount - Процент скидки
  • pos.amount_discount - Сумма скидки
  • pos.icps - ИКПУ. Примечание: данное поле указывать в отдельном блоке
  • pos.label - Маркировка. Примечание: данное поле указывать в отдельном блоке
  • pos.owner_type - Происхождение товара
  • pos.barcode - Штрих-код цифрами
  • pos.inn - ИНН комиссионера

3. position_totals - Итоги по списку позиций.

Содержит информацию о итоговой сумме, сумме скидки.

Пример раздела position_totals:

"position_totals":[
    {
      "text": "<DF>",
      "font": "Lucida Console, 8pt",
      "interval": -10,
      "alignment": 1
    },
    {
      "text": "Jami:<SF><pos.total_amount>",
      "font": "Lucida Console, 8pt",
      "interval": -10,
      "alignment": 0
    }
]

В разделе доступны для использования следующие переменные:

  • pos.total_amount - Значение полной суммы чека с учётом скидки
  • pos.total.discount - Значение суммы скидки
  • pos.total_recieved - Сумма принятых оплат
  • payment.total_other - Сумма оплат другими формами оплаты (пока не задействовано)
  • pos.total_price - К оплате
  • pos.total_vat - Сумма НДС

4. payments - Список позиций оплат.

Содержит информаци о списке оплат, сумме каждой оплаты и её типа.

Пример раздела payments:

"payments":[
    {
      "text": "<payment.type_name><SF><payment.value>",
      "font": "Lucida Console, 8pt",
      "interval": -10,
      "alignment": 0
    }
]

В разделе доступны для использования следующие переменные:

  • payment.type_name - Наименование типа оплаты
  • payment.value - Значение типа оплаты

Содержит дополнительную информацию.

Пример раздела footer:

"footer":[
    {
      "text": "FB:<doc.fiscal_sign>",
      "font": "Lucida Console, 8pt",
      "interval": -10,
      "alignment": 0
    },
    {
      "text": "FM chek raqami:<doc.id>",
      "font": "Lucida Console, 8pt",
      "interval": -10,
      "alignment": 0
    }
]

В разделе доступны для использования те же переменные, что и в блоке header.

Пример чека продажи(возврата)