Versions Compared

Old Version 1

changes.mady.by.user Заварзина Элина

Saved on

compared with

New Version Current

changes.mady.by.user Миллер Виктория

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Правило интерпретации задается в конфигурационном файле /linuxcash/cash/conf/bcode.ini.

Code Block
titleПример настройки
777777*=XXXXXXS*

...

Наименование
Тип данных
Описание
Примечания
prefixForEncryptedCouponчисловойПрефикс зашифрованного номера купона

По умолчанию 777777.

Данный префикс используется только кассой.

...

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

Добавление купона в чек осуществляется несколькими способами:

...

При добавлении купона в чек проверяется срок проверяются:

  1. Срок действия купона.

...


  1. Если срок действия купона еще не наступил или уже истек, то на экран выводится соответствующее сообщение с указанием срока действия. Купон при этом в чек не добавляется.
  2. Акция, которой соответствует купон.
    Если в чек для гашения (применения скидки по купону) уже был добавлен другой купон, соответствующий той же акции, то купон в чек не добавляется.

Количество купонов в чеке продажи на выдачу и на гашение (применение скидки по купону) не ограничено.

При возврате по чеку продажи купоны в чеке не восстанавливаются.

...

При закрытии чека продажи данные о купоне, который был выдан или погашен в чеке, сохраняются в БД Documents в таблицу Couponitem в поле generatednumber (для неуникальных купонов совпадает с полем number):

  • для купонов c типом QR - – зашифрованный номер купона с префиксом,
  • для купонов c типом EAN13 - – номер купона с префиксом.

Уникальные купоны

Panel

Начиная с версии 4.6.

132 отправка сообщений об операциях с купонами будет реализована только через очередь Artix-Queue.

Начиная с версии 4.6.149-5 осуществлен полноценный переход с интерфейса thrift на rest.

Tip

Сейчас по интерфейсу thrift осуществляется работа с бонусами, сертификатами и купонами, что будет изменено после обновления.
Миграция настроек при обновлении кассы происходить не будет. Вместо этого порт 7791 будет заменён на 8080 при запросе к бонусному серверу, серверу сертификатов и купонному серверу. Это же касается и сообщений взятых из очереди.

Таким образом, чтобы исключить проблемы после обновления касс на новый релиз, для последующей работы с бонусным сервером, сервером сертификатов, купонным сервером, необходимо на соответствующих серверах установить пакет artix-accounting-rest.

Также рекомендуется обновить ваш бонусный сервер, сервер сертификатов и купонный сервер до версии #284.

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

Кассовое ПО Artix позволяет выдавать уникальные купоны и отслеживать их статус на сервере купонов.

...

Info
Для отправки сообщений об операциях с купонами может быть использован брокер сообщений Qpid или использована очередь сообщений Artix-Queue.

...

  • при значении параметра on плагин плагин активен и на кассе может выполняться генерация и гашение уникальных купонов,
  • при значении параметра off плагин не активен, генерация и гашение уникальных купонов невозможны.

...

Настройка плагина онлайн-купонов выполняется в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/onlinecoupon.ini в секции [OnlineCoupon].

Наименование
Тип данных
Описание
Примечания
prefixстроковыйПрефикс онлайн-купона

Длина префикса определяется количеством печатаемых символов для определенного формата штрих-кода. Количество символов в штрих-коде определяется как n-9, непечатаемые символы не учитываются, например, контрольная сумма. Если в штрих-коде допустимы только цифры, то префикс может состоять только из цифр.

Например, для штрих-кода в формате EAN13 не более 3 цифр.

hostстроковыйАдрес сервера онлайн-купонов
portчисловойПорт подключения к серверу онлайн-купонов

По умолчанию 8080.

timeoutчисловойТаймаут обращения к серверу онлайн-купонов
, в секундах
По умолчанию 5 секунд.
userстроковыйИмя пользователя для авторизации на бонусном сервере
passwordстроковыйПароль для авторизации на бонусном сервере
allowMultipleCouponsPerCampaignлогическийРазрешить добавление в чек нескольких купонов, выданных по одной акцииПо умолчанию false.


Code Block
languagetext
titleПример настройки
[OnlineCoupon]
; Настройка плагина онлайн- купонов

; Префикс онлайн- купона
; для штрих-кода в формате EAN13 не более 3 цифр
;prefix = 888

; Адрес сервера онлайн- купонов
;host = localhost

; Порт
;port = 8080

; Таймаут запроса к серверу онлайн- купонов
; значение по умолчанию 5
;timeout = 5

; Имя пользователя для авторизации на сервере
;user =

; Пароль для авторизации на сервере
;password =

; Разрешить добавление в чек нескольких купонов, выданных по одной акции
; значение по умолчанию false
;allowMultipleCouponsPerCampaign = false

Правило интерпретации задается в конфигурационном файле /linuxcash/cash/conf/bcode.ini.

Code Block
titleПример настройки
888*=OOO*

...

Префикс может быть задан только один. При необходимости использования нескольких префиксов следует указать префикс для каждой акции в системе лояльности Loyalty Management. При добавлении купона префикс считывается из акции, если в акции префикс не задан, то из конфигурационного файла /linuxcash/cash/conf/ncash.ini.d/onlinecoupon.ini.

Работа с купонами

Генерация купонов

...

  • для EAN13 номер купона содержит префикс (не более 3 цифр) и сгенерированный уникальный идентификатор (9 цифр - – фиксированный размер). Для данного типа штрих-кода идентификатор содержит только цифры;

  • для QR и CODE128 номер купона содержит префикс и сгенерированный уникальный идентификатор. Размер сгенерированного уникального идентификатора можно изменить с помощью параметров QR и CODE128 в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/onlinecoupon.ini в секции [OnlineCoupon.Size]. По умолчанию 9 символов. Идентификатор содержит заглавные буквы латинского алфавита и цифры.

    Info

    Если указанная длина превышает 32 символа, то идентификатор будет дополнен символами F слева.


Наименование

Тип данных

Описание

Примечания

QRчисловойРазмер генерируемого номера купона для штрих-кода типа QRПо умолчанию 9 символов
CODE128числовойРазмер генерируемого номера купона для штрих-кода типа CODE128По умолчанию 9 символов


Code Block
titleПример настройки
[OnlineCoupon.Size]
; Настройка размера генерируемого номера купона в зависимости от типа штрих-кода
; Для EAN13 настройка недоступна

; Размер генерируемого номера купона для штрих-кода типа QR
; значение по умолчанию 9 символов
;QR = 9

; Размер генерируемого номера купона для штрих-кода типа CODE128
; значение по умолчанию 9 символов
;CODE128 = 9

При закрытии чека печатается купон со штрих-кодом, состоящим из префикса и сгенерированного уникального идентификатора, номер купона записывается в поле generatednumber в таблицу Couponitem БД Documents. В БД сервера купонов записывается информация о номере купона, полученном от системы лояльности и указанном в акции (поле number), и сроках его жизни. Купону будет присвоен статус выданного.

Печать купонов перед закрытием чека

Купоны могут быть напечатаны перед закрытием чека, данное поведение регулируется параметром printBeforeClose в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/artixcoupon.ini в секции [ArtixCoupon]:

  • при значении параметра true печать купонов выполняется перед закрытием чека,

    Info

    Если в акции указан модификатор "После закрытия чека", то печать купонов будет выполняться после закрытия чека.


  • при значении параметра false печать купонов выполняется после закрытия чека.
НаименованиеТип данныхВозможные значенияОписаниеПримечания
printBeforeCloseлогический
  • true
  • false
Печать купонов перед закрытием чекаПо умолчанию false


Code Block
languagetext
titleПример настройки
[ArtixCoupon]
; Печать купонов перед закрытием чека
; По умолчанию false
;printBeforeClose = false

Гашение купонов

Для срабатывания скидки по купону необходимо добавить купон в чек:

  • вручную с клавиатуры,
  • сканированием штрихсканированием штрих-кода,
  • по кнопке "Добавить купон" с командой COMMAND_COUPON_ADD. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

...

Купон может быть добавлен в чек только в случае наличия связи с сервером купонов. Количество купонов, которые можно добавить в чек для гашения, не ограничено.

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

...

При добавлении в чек нескольких купонов, соответствующих одной акции, срабатывает только первый. При закрытии чека на экран выводится список неиспользованных купонов, которые необходимо вернуть покупателю. Для купонов, которые не были использованы, в БД Documents в таблице Couponitem записывается status = 3.

В кассовом ПО Artix реализована возможность добавления в чек нескольких уникальных купонов, действующих в рамках одной акции, регулируется параметром allowMultipleCouponsPerCampaign в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/onlinecoupon.ini в секции [OnlineCoupon]:

  • при значении параметра true разрешено добавление в чек нескольких уникальных купонов, действующих в рамках одной акции,
  • при значении параметра false запрещено добавление в чек нескольких уникальных купонов, действующих в рамках одной акции. Значение по умолчанию.

Сторнирование купонов

Для сторнирования одного или нескольких купонов из чека необходимо в утилите администрирования Yuki на клавишу настроить действие "Удаление купона" с командой COMMAND_COUPON_DELETE и параметром deleteAllCoupons:

...

Тип купонаФормат печати купонаИспользование сроков жизниИспользование префикса купона из настроек кассыИспользование префикса купона из настроек LMLoyalty ManagementСпособ добавления на кассе
НеуникальныйEAN13Не используются, срок жизни определяется сроком действия акции на гашениеНе используется, на купоне печатается только префикс из LMLoyalty Management

Печатается на чеке при выдаче купона. Для того чтобы при считывании купона касса распознала введенный номер префикс из акции на гашение, заданной в LMLoyalty Management, должен соответствовать правилам разбора штрих-кода, указанным в bcode.ini.

сканирование / ручной ввод


   
CODE128
QRИспользуются сроки жизни купонов и срок действия акции на гашение

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

Используется, при выдаче купона префикс и сроки жизни купона шифруются и записываются в QR-код.

При считывании купона для гашения номер купона расшифровывается и подставляется в чек.

УникальныйEAN13Передается на сервер купонов при выдаче купона, при гашении купона запрашивается на сервере, и по этому префиксу определяется к какой акции относится купон и предоставляется соответствующая скидка.
CODE128
QR

...

В кассовом ПО Artix реализована возможность настройки отображения информации о купоне после его добавления. Отображаемая информация регулируется настройками couponInfo в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/gui.ini в секции [GUI.SelectedPositionInfo]. Настройки отображения информации о купоне задаются параметром couponInfo<N>, где <N> это порядковый номер строки. Максимальное количество отображаемых строк - – 5. Подробнее о правилах формирования значений для параметра couponInfo<N> можно прочитать в разделе "Правила форматирования".

...