Кассовое ПО Artix позволяет осуществлять выдачу кофе через сервис ScanBox с использованием слипа с QR-кодом.

Для работы с сервисом необходимо наличие в лицензии модуля scanbox. Подробнее о лицензировании можно прочитать в разделе "Новый формат лицензии .li4".

Конфигурирование модуля

Работа с сервисом ScanBox активируется плагином scanbox в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/scanbox.ini в секции [plugins]:

НаименованиеТип данныхВозможные значенияОписаниеПримечания
scanboxстроковый
  • on
  • off
Плагин для работы с сервисом кофемашиныПо умолчанию off


[plugins]
; Работа с сервисом кофемашины
;scanbox = off

Настройка работы с сервисом ScanBox осуществляется в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/scanbox.ini в секции [ScanBox]:

НаименованиеТип данныхОписаниеПримечания
urlстроковыйАдрес сервисаПо умолчанию http://localhost
timeoutцелочисленныйТаймаут обращения к сервисуПо умолчанию 10 секунд на один запрос
tokenстроковыйТокен для генерации штрих-кодаПо умолчанию значение не задано
imeiстроковыйСписок идентификаторов кофемашинПо умолчанию значение не задано
catalogsстроковыйСписок каталогов с товарами, для которых необходимо выполнять запрос

По умолчанию значение не задано.

В списке необходимо указывать коды каталогов. Например:
1,2,3,4

qrLifetimeцелочисленныйВремя жизни штрих-кода в минутахПо умолчанию 15


[ScanBox]
; Настройки плагина для работы с сервисом кофемашины

; Адрес сервиса
; По умолчанию http://localhost
;url = http://localhost

; Таймаут обращения к сервису
; По умолчанию 10 секунд на один запрос
; timeout = 10

; Токен для генерации штрих-кода
;token = "" 

; Список идентификаторов кофемашин
;imei = "" 

; Список каталогов с товарами, для которых необходимо выполнять запрос
;catalogs = 

; Время жизни штрих-кода в минутах
; По умолчанию 15 минут
;qrLifetime = 15

Принцип работы

Для выдачи кофе через сервис ScanBox необходимо:

  1. Создать каталог с кофейными товарами.
  2. Запретить ручной ввод количества для каждого товара из каталога (см. БД Dictionaries таблицу Tmc поле quant_mode).
  3. В дополнительных свойствах для каждого товара указать его код (см. БД Dictionaries таблицу Tmc поле extendetoptions).
  4. Активировать модуль scanbox (см. "Конфигурирование модуля").

  5. Настроить параметры для работы с сервисом (см. "Конфигурирование модуля").

  6. Перезапустить кассовую программу.

  7. На кассе добавить кофе в чек.

    Объединение кофейных позиций в чеке не осуществляется.


  8. Закрыть чек продажи.
    Если товар из кофейного каталога не заведен в системе ScanBox, то будет выведена ошибка обращения к сервису, чек не будет закрыт.

При оплате чека для каждой позиции кофе будет напечатан слип с QR-кодом, шаблон которого находится в /linuxcash/cash/reports/scanbox.xml. Подробнее о редактировании шаблонов можно прочитать в разделе "Движок отчетов".

Полученный слип необходимо отсканировать с помощью устройства SkanBox. Время действия QR-кода может быть ограничено настройками.

Логирование

Логирование работы сервиса ведется в файле /linuxcash/logs/current/terminal.log.