Всё о переменных шаблона печати СМАРТ Л2
История обновлений документа:
-
06.08.24: добавлены все основные параметры
-
14.11.24: добавлены aggregation_capacity, code_128, custom_attribute
-
23.05.25:
1) Общая структура файла
В папке /template-vars рядом с smartl2.jar файл example.vars представляет собой JSON следующего формата:
{
"label": {
"height": "320",
"width": "640"
},
"variables": {
"название_переменной_1": {
"type": "тип_переменной"
},
"название_переменной_2": {
"type": "тип_переменной"
},
"название_переменной_3": {
"type": "date",
"format": "dd/MM"
},
"название_переменной_4": {
"type": "text",
"value": "годен до: "
},
"название_переменной_5": {
"type": "тип_переменной",
"regex": ".*/(\\d{6})"
}
...
}
}
Где название_переменной_Х соответствует названию переменной в шаблоне принтера с названием example. Например, var1-1, var100, 6501310, <BATCH_SERIAL_NUMBER>.
Можно сохранить несколько шаблонов с разными названиями (example.vars, default.vars, dm1.vars). Нужный шаблон указывается в редакторе продукта в СМАРТ Л3 в поле шаблон для печати.

2) Поддерживаемые переменные шаблона
Следующая таблица описывает все допустимые значения параметра type, а также доступные им значения поляараметра format
| type | Описание | |||
| DATAMATRIX_GS | GS1 DataMatrix |
Опционально Длина кода, до которой нужно обрезать его с конца
Пример: "format":"5" "12345678" -> "12345" |
||
| DATAMATRIX_NON_GS |
НЕ-GS1 DataMatrix Без FNC1 и GS Например, сигареты |
Опционально Длина кода, до которой нужно обрезать его с конца |
||
| SGTIN_SERIAL_21 | Серийный номер SGTIN, AI 21 |
Длина серийного номера в коде этой товарной группы
Пример: "format":"6" для молока или "13" для БАДов |
||
| SGTIN_SERIAL_NON_GS | Серий |
|||
| SGTIN_91 | ID криптохвоста SGTIN, AI 91 | |||
| SGTIN_92 | Криптохвост SGTIN, AI 92 | |||
| SGTIN_93 | Криптохвост SGTIN, AI 93 | |||
| BATCH_NAME | Название партии | |||
| SERIES_NAME |
Название серии |
|||
| DATE_PRODUCTION | Дата производства |
Формат даты, где
h – цифра часа m – цифра минут
Примеры: "hh:mm dd/MM/yy" |
||
| DATE_EXPIRE | Дата истечения срока годности | |||
| DATE_CURRENT | Текущая дата | |||
| DATE_AGGREGATION | Дата агрегации | |||
| TEXT | Пользовательский текст | |||
| PRODUCT_NAME | Название продукции | |||
| GTIN | GTIN продукции |
Длина GTIN, до которой нужно обрезать его с начала
Пример: "format":"13" "00812345678918" -> "0812345678918" |
||
| GTIN_NON_CHECK_DIGIT | GTIN продукции без контрольной цифры (последняя цифра в GTIN) |
Длина GTIN, до которой нужно обрезать его с начала
Пример: "format":"12" "0081234567891" -> "081234567891" |
||
| CODE_128 | Линейный код GS1-128 |
Опционально Длина кода, до которой нужно обрезать его с конца |
||
| CODE_128_BMP | Линейный код GS1-128, конвертируемый в .bmp изображение | |||
| CUSTOM_ATTRIBUTE | Специфичный параметр продукта | |||
|
CUSTOM_ATTRIBUTE_TEXT_TO_BMP |
Специфичный параметр продукта, конвертируемый в .bmp изображение |
|
||
| MRP | МРЦ продукции для табачных ТГ | |||
| WEIGHT | Вес / объём продукции | |||
| ACTUAL_WEIGHT | Общий вес всех продуктов в агрегате | |||
| AGGREGATION_CAPACITY | Ёмкость групповой упаковки конкретного уровня |
"1" для групповой упаковки "2" для транспортной "3" для паллетной и выше |
||
| ACTUAL_CAPACITY | Реальное количество вложений в текущем агрегате |
Опционально "1" для групповой упаковки "2" для транспортной "3" для паллетной и выше |
||
| TOTAL_CAPACITY |
Общее количество вложений самого нижнего уровня в агрегате Например: 50, если в одной транспортной упаковке 10 групповых, в которых по 5 индивидуальных |
|||
| NEXT_LEVEL_COUNTER |
Количество кодов в упаковке следующего уровня Например: 3 короб из 50 (AGGREGATION_CAPACITY = 50) |
ID группы устройств
Пример: "format":"1" |
||
| IMAGE | Изображение формата .bmp, расположенное в папке /img рядом с исполняемым .jar | |||
| VARIABLE_TO_TEXT | Конвертируемое в текст значение переменной | |||
| VARIABLE_TO_BMP | Конвертируемое в .bmp картинку текстовое значение переменной | |||
| LINE | Номер линии | |||
| BOX_NUMBER | Номер короба | |||
| EAN | EAN продукции | |||
| SKU |
SKU продукции (артикул / ID в товароучётной системе) |
Далее описаны параметры и их значения, применимые для отдельных типов переменных
| type | Описание | Параметр | Значение |
| GTIN | Уровень упаковки для GTIN |
value
(тип данных string) |
"SGTIN" - GTIN товара "GROUP" - GTIN групповой упаковки "TRANSPORT" - GTIN транспортной упаковки "PALLET" - GTIN паллетной упаковки
Пример: "value":"SGTIN" |
| TEXT | Текстовое значение для печати |
Текст, который будет отправлен на печать Пример: "value":"Колбаса" |
|
|
CUSTOM_ATTRIBUTE CUSTOM_ATTRIBUTE_TEXT_TO_BMP
|
Название атрибута продукта |
Название атрибута продукта, из которого будет взято значение для печати
Пример: "value":"attr_1" |
|