Программирование шаблона чека

ФР Атол

Для ФР Атол реализована настройка шаблонов кассовых чеков, которые программируются в Таблице 20. В ФР Атол используется 2 шаблона чека. 

Для работы с шаблонами предварительно нужно установить в Таблице 2 Ряд 1 Поле 111 значение 81 или 82, тем самым выбрав Шаблон 1 или Шаблон 2 соответственно (значения, указанные в официальной документации Атол, не используются). 
Пример указания шаблона чека 1 для АТОЛ FPrint-22ПТК
[HW.FR.commons.params]
param1 = "4.63.*.*$2.111.1:81" 

В Таблице 20 можно настроить внешний вид кассового чека: межстрочный интервал, шрифт и размер шрифта, выравнивание печатаемого текста в ограниченной области строки, яркость и т.д. Описание настроек приведено в официальной документации Атол.

Правила программирования параметров задаются в /linuxcash/cash/conf/fr.ini в секции [HW.FR.commons.params]. Параметры таблицы 20 программируются следующим образом:

<P>.<M>.<V>.<B>$<T>.<F>.<R>:<S>

Значения до символа $ определяются подключаемым ФР. Значения после символа $ определяют значения строк и полей таблицы 20.

ПараметрОписаниеПримечания
TНомер таблицыТаблица 20
FНомер колонки (поля) в таблице

№ байта из документации Атол.

  • Байт 2 программирует шрифты и множители по вертикали/горизонтали.
  • Байт 7 программирует форматирование текста.
  • Байт 8 программирует выравнивание текста и яркость.
RНомер строки (ряда) в таблицеНомер строки из таблицы 20. Например, строка 13, в которой укадывается цена позиции без скидки, т.е. при программировании будет производиться форматирование этого параметра в шаблоне чека.
SПрисваиваемое значениеРассчитывается для программируемых байтов
Пример программирования параметра

Пусть на ФР АТОЛ FPrint-22ПТК необходимо сумму налога выделять крупным шрифтом и печатать по центру.

Каждый из этих параметров задается в fr.ini отдельной строкой.

Изменение размера шрифта.

Необходимо запрограммировать байт 2. Размер шрифта задается полем 32 в таблице 20. Выберем размер 12х16 пикселей, значение 3.

Во 2 байте за размер шрифта отвечают с 7 по 4 бит. Значение 3 (в десятичной системе) в этом случае будет записано как 11 (в двоичной системе). 3 и 2 бит отвечают за увеличение по вертикали и горизонтали – их оставляем без изменения. 1 и 0 бит зарезервированы – они не изменяются.

В результате 2 байт будет заполнен следующим образом:

76543210
00110000

При переводе этого значения в десятичную систему получаем 48.

Строка для изменения размера шрифта в сумме налога будет выглядеть следующим образом:

param2 = "4.63.*.*$20.2.32:48"

ФР Атол, работающий по протоколу 5.0

Для ФР, работающего по протоколу Атол 5.0, при печати отчетов из стандартных шаблонов используется шрифт из Таблицы 1 Ряд 13 Поле 1 значение от 1 до 7. Значению 1 соответствует самый мелкий шрифт. Для задания шрифта необходимо с помощью правила программирования параметров в /linuxcash/cash/conf/fr.ini в секции [HW.FR.commons.params] указать следующие данные:

Пример программирования шрифта для АТОЛ FPrint-22ПТК, работающего по протоколу Атол 5.0
[HW.FR.commons.params]
param1 = "4.63.*.*$1.1.13:1" 

Загрузка шаблона чека

Загрузка шаблона чека возможна только в ФР с версией прошивки 4555 и выше.

Кассовое ПО Artix позволяет произвести в ФР Атол загрузку шаблона чека, который был ранее подготовлен в редакторе шаблонов T20Editor.

НаименованиеТип данныхВозможные значенияОписаниеПримечания

setCheckTemplate

логический
  • true
  • false
Программирование шаблона чекаПо умолчанию false

checkTemplateFile

строковый
Полный путь к файлу шаблона чека

checkTemplateNumber

целочисленный
  • 1
  • 2
Номер шаблона чека для программированияПо умолчанию значение не указано

Загрузка шаблона чека выполняется утилитой инициализации ФР frinit. Настройка загрузки чека в ФР осуществляется в конфигурационном файле /linuxcash/cash/conf/frinit.conf. Все параметры обязательны для указания.

Пример настройки
; Программирование шаблона чека. По умолчанию false
;setCheckTemplate = false; {true, false}
; Файл шаблона чека для программирования
;checkTemplateFile = /linuxcash/cash/conf/template.csv
; Номер шаблона чека для программирования
;checkTemplateNumber = 1

Для загрузки шаблона чека в ФР необходимо:

  1. Подготовить шаблон чека в редакторе T20Editor и разместить его по пути, указанном в параметре checkTemplateFile.
  2. Указать номер шаблона чека, который необходимо запрограммировать, в параметре checkTemplateNumber.
  3. Активировать программирование шаблона чека параметром setCheckTemplate, указав для него значение true.
  4. Перезапустить кассовую программу.

При запуске программы будет запущена процедура программирования шаблона чека в ФР. На время программирования шаблона на экран выводится сообщение о выполнении операции. После завершения процедуры в директории /linuxcash/cash/data/tmp создается файл-статус template.state. Файл-статус содержит информацию о статусе загрузки шаблона, его содержимом и номере шаблона чека в ФР, куда была выполнена загрузка.

Повторная загрузка шаблона чека будет произведена в том случае, если файл-статус отсутствует или изменены входные данные – номер шаблона чека или сам шаблон.

Загрузка шаблона чека в ФР – длительная процедура, в течение которой нельзя выключать кассу или ФР. В противном случае после включения оборудования загрузка шаблона чека начнет выполняться заново.

Если ФР не поддерживает загрузку чека или неверно указан номер шаблона чека, то программирование шаблона не выполняется. В frinit.log запишется статус операции.

  • No labels