Versions Compared

Key

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

...

Panel

Table of Contents


Panel

Начиная с версии 4.6.106 добавлена возможность получения бонусных воздействий из внешней Реализованная интеграция с системой ABMLoyalty может не поддерживать определенные функции системы или иметь особенности их реализации. Следует уточнять полноту интеграции в соответствии с функциональными требованиями к системе лояльности.

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

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

Info

Взаимодействие с внешней системой лояльности ABMLoyalty возможно только в кассовом ПО Artix, работающем под Ubuntu 14.04 и выше.

При настройке в личном кабинете системы лояльности необходимо указать branch_id, в качестве которого используется код магазина (/linuxcash/cash/data/cash.reg).

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

Активация модуля внешней системы лояльности ABMLoyalty определяется параметром системы лояльности ABMLoyalty определяется параметром abmloyalty, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/abmloyalty.ini в секции [plugins].

НаименованиеТип данныхВозможные значенияОписаниеПримечания
abmloyaltyлогическийстроковый
  • on
  • off
Активация модуля системы лояльности ABMLoyaltyПо умолчанию off


Code Block
titleПример настройки
[plugins]
; Система лояльности ABMLoyalty
;abmloyalty = off

...

НаименованиеТип данныхВозможные значениеОписаниеПримечания

serverUrl

строковый
Адрес сервера системы лояльности ABMLoyaltyПо умолчанию http://127.0.0.1/

timeout

целочисленный
Таймаут запроса к серверу системы лояльности ABMLoyaltyПо умолчанию 10 секунд.

user

строковый
Имя пользователя для авторизации в системе лояльности ABMLoyalty

password

строковый
Пароль пользователя для авторизации в системе лояльности ABMLoyalty

smsVerification

логический
  • true
  • false
СМСSMS-верификация при списании баллов в системе лояльности ABMLoyaltyПо умолчанию false.
currencyNameстроковый
Наименование валюты бонусовПо умолчанию "BON".
bonusRatioстроковый
Отношение бонусных единиц к денежным

Первый параметр - бонусы, второй - деньги.
По умолчанию "1:1".


Code Block
languagetext
titleПример настройки
[ABMLoyalty]
; Настройки плагина системы лояльности ABMLoyalty
; Адрес сервера ABMLoyalty
; Значение по умолчанию http://127.0.0.1/ 
;serverUrl = "http://127.0.0.1/"
; Таймаут запроса к серверу ABMLoyalty
; Значение по умолчанию 10
;timeout = 10
; Имя пользователя для авторизации на сервере
; Значение по умолчанию ""
;user = ""
; Пароль пользователя для авторизации на сервере
; Значение по умолчанию ""
;password = ""
; СМС-верификация при списании баллов
; Значение по умолчанию false
;smsVerification = false
; Наименование валюты бонусов
; По умолчанию "BON"
;currencyName = "BON"
; Отношение бонусных единиц к денежным
; Первый параметр - бонусы, второй - деньги
; По умолчанию "1:1"
;bonusRatio="1:1"

В зависимости от доступности сервера внешней системы лояльности ABMLoyalty операции могут проводиться в режиме online или offline. При этом:

  • Запрос информации о карте и списание бонусных баллов всегда проводится online.
  • Возврат начисленных/списанных бонусов всегда производится offline через очередь artix-queue.
  • Операции по начислению и отмене начисления производятся online, если бонусный сервер внешней лояльности не доступен - в режиме offline.
Info

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

Бонусные программы ABMLoyalty

...

Бонусная программа ABMLoyalty

 Для использования системы лояльности ABMLoyalty необходимо:

  1. Завести группу бонусных карт с типом карты ABMLoyalty (БД Dictionaries таблица Cardgroup поле cardmode = 12).
  2. Активировать модуль лояльности ABMLoyalty системы лояльности ABMLoyalty (см. Конфигурирование модуля ABMLoyalty).
  3. Настроить подключение к серверу ABMLoyalty, указать логин и пароль внешней системы лояльности (см. Конфигурирование модуля ABMLoyalty).
  4. Перезапустить кассовую программу.
  5. Применить бонусную карту в чеке.

...

  1. в чеке

...

СМС-верификация

При использовании внешней системы лояльности ABMLoyalty есть возможность использовать SMS-верификацию при списании баллов. Для этого параметру smsVerification в конфигурационном файле (см. Конфигурирование модуля) необходимо задать значение true. При активированной настройке, для оплаты баллами программой запрашивается код, система лояльности направляет смс-сообщение с кодом верификации на номер телефона клиента, к которому привязана карта:

...

  1. .

...

Добавление карты по номеру телефона

При использовании системы лояльности ABMLoyalty есть возможность добавления возможно добавление карты по номеру телефона. Для этого необходимо:

  1. Включить способ ввода "Удаленно" для группы карт (БД Dictionaries таблица Cardgroup поле inputmask  поле inputmask = 16).
  2. Настроить клавишу "Добавить карту" с командой COMMAND_CARD и параметрами:
    • cardNumberType со со значением 1.,
    • cardMode со значением 12.

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

Если к номеру телефона привязана:

  • одна карта - она автоматически добавляется в чек.;
  • две и более карт - на экране кассы откроется диалоговое окно – на экран будет выведен диалог для выбора карты. После подтверждения выбора , карта добавится в чек.

Если при запросе к серверу лояльности ABMLoyalty карта клиента не будет найдена, то на экран кассира выведется будет выведена ошибка. Сервер системы лояльности возвращает следующие ошибки поиска:

  • "Пользователь не найден - " – возникает в случае отсутствия указанного номера телефона на сервере системы лояльности ABMLoyalty.;
  • "Нет карт для телефона <номер_телефона>  - телефона>" – возникает в случае, когда карта для номера телефона отсутствует.

Продажа

Для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности ABMLoyalty в чек. Обращение к серверу для получения суммы доступных баллов выполняется при оплате баллами.

Списание баллов

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

Начисление баллов

Начисление баллов происходит на стороне сервера системы лояльности ABMLoyalty после закрытия чека.

Возврат

В системе лояльности предусмотрена возможность возврата списанных ранее баллов.

SMS-верификация

При использовании системы лояльности ABMLoyalty возможно использование SMS-верификации при списании баллов. Данное поведение регулируется параметром smsVerification в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/abmloyalty.ini в секции [ABMLoyalty].

Если настройка smsVerification включена, то для оплаты баллами запрашивается код, система лояльности отправляет sms-сообщение с кодом верификации на номер телефона клиента, к которому привязана карта:

  • при вводе верного кода происходит списание бонусов с карты;
  • при вводе неверного кода на экран будет выведено сообщение "Неправильный код".

Отношение бонусных и денежных единиц

При использовании внешней системы системы лояльности ABMLoyalty есть возможность возможно задавать отношение бонусных единиц к денежным при списании и начислении баллов. Для этого параметру Данное поведение регулируется параметром bonusRatio в конфигурационном файле (см. Конфигурирование модуля) необходимо задать значение true.При активированной настройке в диалоге оплаты /linuxcash/cash/conf/ncash.ini.d/abmloyalty.ini в секции [ABMLoyalty].

Если настройка bonusRatio включена, то в диалоге оплаты баллами все суммы отображаются в бонусных баллах. После подтверждения списания баллов на экране кассира суммы оплаты баллами начисленных и начисляемых списанных баллов отображаются в денежном эквиваленте. При закрытии чека в БД кассы записываются суммы начисленных суммы начисленных и списанных бонусов в денежном эквиваленте.

Info

Для корректной работы кассы необходимо, чтобы настройки отношения бонусных и денежных единиц в кассе и на сервере системы лояльности ABMLoyalty совпадали.

Отправка чеков

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

Режимы работы

В зависимости от доступности сервера системы лояльности ABMLoyalty операции могут производиться в режиме online или offline. При этом:

  • запрос информации о карте и списание бонусных баллов всегда производятся online;
  • возврат начисленных/списанных бонусов всегда производится offline через очередь Artix-Queue;
  • операции по начислению и отмене начисления производятся online. Если сервер лояльности недоступен, то операции производятся в режиме offline.