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

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

SRTB-6210 - Получение подробных данных проблемы… СТАТУС

SRTB-6247 - Получение подробных данных проблемы… СТАТУС

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"
        }
    ]
}
ПолеТип данныхОписаниеОбязательное
typeString

Тип столбца. 

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

  • templateтекстовый шаблон для подстановки задается в поле "template"
  • textиспользуется текстовый шаблон "${'text'}"
Да
widthNumberШирина столбца в процентах от общей ширины чековой формыДа
templateStringТекстовый шаблон, в который будет осуществляться подстановка значений из позицииДа для столбца с типом template
itemsList [String]

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

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

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

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

  • item - артикул

  • barcode - штрихкод

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

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

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

    • SRTB-6246 - Получение подробных данных проблемы… СТАТУС
    • 10.3.20.0
  • priceWithoutDiscount - стоимость одной позиции товара без скидок (не задано до расчета скидок). Для корректной работы в шаблон нужно добавить excludeNull

    • SRTB-6246 - Получение подробных данных проблемы… СТАТУС
    • 10.3.20.0
  • sum - стоимость позиции

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

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

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

Да
colorString

Название цвета текста в столбце. Конкретный цвет зависит от темы, настроенной на кассе.

Допустимые значения: "title", "amount", "price", "discount"

Да
fontString

Тип шрифта.

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

  • plain - обычный 
  • bold - жирный
Да
alignString

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

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

  • left - выравнивание по левому краю
  • right - выравнивание по правому краю
Да
sizeNumberРазмер шрифта в пикселяхДа
excludeNullBooleanИсключать ли столбец из отображения целиком, если одно из подставляемых значений отсутствует (например, величина скидки до расчета скидок)Нет
strikedBoolean

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

SRTB-6246 - Получение подробных данных проблемы… СТАТУС

10.3.20.0

Нет
excludedList <Object>

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

Пример:

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


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


Настройка

Загрузите из ERP товар с описанием в поле description, согласно интеграционной документации.

Пример XML товара с описанием.

Установка шаблона

  • Настройка функциональности может осуществляться или на кассе, или на сервере (централизованно, отдельно для каждого шаблона касс).
  • Если выполняется настройка на сервере, то скрипт на кассе выполнять не нужно!
  • Соответственно, если выполняется скрипт на кассе, аналогичный запрос в таблицу sales_management_properties на сервере выполнять не нужно.


Также обратите внимание, что любой триггер спуска с сервера шаблона касс означает, что все настройки, связанные с этим на всех кассах будут перезаписаны данными с сервера. В случае, если в таблице sales_management_properties НА КАССЕ в поле touchCheckTemplate значение null, то значит либо на сервере в таблице cash_template в поле touch_check_template нет шаблона, либо в таблице sales_management_properties НА СЕРВЕРЕ есть настройка touchCheckTemplate, чего быть не должно.

Настройка на отдельной кассе

Шаблон чека хранится в базе данных catalog → таблица sales_management_properties → параметры module_name = CASH_CONFIG, plugin_name = null, property_key=touchCheckTemplate.

1. Выполните скрипт на кассе по базе данных catalog.

2. Перезагрузите кассовый модуль.

Централизованная доставка с сервера

Настройка шаблона чека на сервере хранится в базе данных set → таблица cash_template → поле touch_check_template.

1. Выполните скрипт на сервере по базе данных set.

2. На сервере SetCentrum перейдите в Кассовый модуль → Шаблоны касс → кликните  напротив требуемого шаблона кассы → выберите пункт Переотправить в магазины.

Для топологии SetRetail ↔ Кассы выберите пункт Переотправить на кассы.

Функциональность переотправки шаблонов доступна с версии 10.3.24.0.

Для более ранних версий измените в шаблоне кассы какую-либо настройку → сохраните изменения.

3. Установите флажки магазинов для отправки шаблона → кликните .

4. Перезагрузите кассовый модуль.

Пример отображения формы чека

После выполнения скрипта поле чека будет выглядеть следующим образом:


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

При переходе к расчету появляется дополнительный блок с отображением скидки на товар в процентах, но так как ширина блока для скидки равняется 100%, отображение описания товара переходит на следующую строку.

Дополнительная информация

  • Если при загрузке шаблона будет обнаружено, что в нем есть ошибка, то автоматически будет загружен шаблон по умолчанию, и в логе кассы будет сообщение о том, что не удалось загрузить шаблон.
  • При задании шаблона важно следить, чтобы количество мест для подстановки в текстовом шаблоне, и количество элементов в items совпадало, иначе шаблон будет считаться некорректным и не будет загружен!
  • Если на экране кассы требуется отобразить символ “%” (например, для показа процента скидки), то его требуется экранировать, например “-${'text'}%%”.

Печать дополнительной информации о товаре в чеке

SRTZ-1942 - Получение подробных данных проблемы… СТАТУС

CR-7858 - Получение подробных данных проблемы… СТАТУС

10.3.18.0

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

Начиная с версии 10.3.19.0 доступна настройка печати в копии чека.

SRTZ-2094 - Получение подробных данных проблемы… СТАТУС

10.3.19.0

Настройка

1. Перейдите в раздел Кассовый модуль → Чековые формы → откройте на редактирование требуемую форму, например, форму чека продажи.

2. Создайте условие для описания товара → кликните .

3. Перейдите в редактор → в секции Позиции в разделе Список добавьте новую строку.

4. Добавьте подстановку Условие → выберите созданное условие Описание товара.

5. Добавьте подстановку Описание товара.

4. Кликните  → кликните .

5. В напечатанном чеке отобразится описание товара 

Дополнительная информация

Для ККТ, печатающих позиции по встроенному шаблону, в шаблонах чеков продажи и возврата у добавленных строк должен быть указан атрибут printerType.


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

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