/
SetTouch ◾️ Настройка отображения чека на экране кассы

Публичное пространство

SetTouch ◾️ Настройка отображения чека на экране кассы

https://crystals.atlassian.net/browse/SRTB-6210

https://crystals.atlassian.net/browse/SRTB-6247

https://crystals.atlassian.net/browse/CR-7858

10.3.19.0

Описание

Начиная с версии 10.3.19.0 появилась возможность настройки отображения чека на экране SetTouch. Данная функциональность позволяет управлять тем, какие данные отображаются на чековой форме, в каком месте, позволяет скрывать часть данных при определенных условиях. Также реализована возможность отображать дополнительную информацию о товаре, например, цвете и размере на экране кассира, для дополнительного контроля товаров. 

Описание формата шаблона

Для настройки отображения используются специализированные шаблоны в формате JSON.

Каждая позиция в форме чека на экране SetTouch представляет из себя набор строк, разделенных на столбцы. В разных строках может быть разное количество столбцов с разными параметрами (шириной, размером шрифта и т.д.). Шаблон описывает, сколько строк с данными будет отображаться для каждой позиции, и из каких столбцов они будут состоять.

В общем виде шаблон чека представляет из себя JSON следующего вида:

{ "position": { "lines": [ { "columns": [ {column1}, {column2},... ] }, {line2},... ] } }

Описание полей

{ "type": "template", "width": 20, "template": "x${'text'} ${'text'}", "items": [ "quantity", "measure" ], "color": "title", "font": "plain", "align": "right", "size": 16, "excludeNull": true, "excluded": [ { "name": "quantity", "value": "1" } ] }

Поле

Тип данных

Описание

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

type

String

Тип столбца. 

Допустимые значения:

  • template - текстовый шаблон для подстановки задается в поле "template"

  • text - используется текстовый шаблон "${'text'}"

Да

width

Number

Ширина столбца в процентах от общей ширины чековой формы

Да

template

String

Текстовый шаблон, в который будет осуществляться подстановка значений из позиции

Да для столбца с типом template

items

List [String]

Список параметров позиции (например, название, ШК и т.д.), которые требуется подставить в столбец.

Допустимые параметры позиции:

  • name - название товара

  • description - описание товара

  • item - артикул

  • barcode - штрихкод

  • quantity - количество

  • measure - мерность товара

  • priceWithDiscount - стоимость одной позиции товара со скидкой (или просто стоимость позиции до расчета скидок)

  • priceWithoutDiscount - стоимость одной позиции товара без скидок (не задано до расчета скидок). Для корректной работы в шаблон нужно добавить excludeNull

  • sum - стоимость позиции

  • discountValueSum - итоговая скидка по позиции

  • discountValuePercent - итоговая скидка по позиции в процентах

  • seller - ФИО продавца/табельный номер

Да

color

String

Название цвета текста в столбце.


Допустимые значения:

  • семантические: "title", "amount", "price", "discount";

  • HEX-код HTML. Например, красный цвет: #FF0000.

Цвет текста каждого атрибута позиции чека может быть изменён с помощью изменения значения поля “color”. Кроме семантических значений ("title", "amount", "price", "discount"), поле “color”  может принимать значение цвета в HEX кодировке. Например, красный цвет: #FF0000



Пример назначение красного цвета для выводимого атрибута в файле.

Да

font

String

Тип шрифта.

Допустимые значения:

  • plain - обычный 

  • bold - жирный

Да

align

String

выравнивание столбца относительно формы чека на кассе.

Допустимые значения:

  • left - выравнивание по левому краю

  • right - выравнивание по правому краю

Да

size

Number

Размер шрифта в пикселях

Да

excludeNull

Boolean

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

Нет

striked

Boolean

Флаг перечёркнутого текста. Значение по умолчанию - false.

https://crystals.atlassian.net/browse/SRTB-6246

10.3.20.0

Нет

excluded

List <Object>

Исключение столбца, при выполнении некоторых условий.

Пример:

"excluded": [ { "name": "quantity", "value": "1" } ]

 

При такой настройке, если у позиции количество равно "1"(строго "1", не "1.000"), то такой столбец будет целиком исключен.

Нет

© 1994-2025, ООО «Кристалл Сервис Интеграция».
Все права защищены.

Политика обработки персональных данных