Реализованная интеграция с системой KilBil может не поддерживать определенные функции системы или иметь особенности их реализации. Следует уточнять полноту интеграции в соответствии с функциональными требованиями к системе лояльности.
Начиная с версии 4.6.214 реализована возможность использования подарочных сертификатов системы лояльности Artix совместно с системой лояльности KilBil.
Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий, применение купонов и использование подарочных сертификатов системы лояльности KilBil.
Работа в режиме offline не поддержана. Если при закрытии чека сервер системы лояльности недоступен, то будет выведено сообщение «Ошибка соединения с сервером», оплата бонусами невозможна.
Конфигурирование модуля KilBil
Активация модуля системы лояльности KilBil определяется параметром kilBil
, который задается в конфигурационном файле /linuxcash/cash/conf/ncash.
ini.d/kilbil.ini
в секции [plugins]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
kilBil | строковый |
| Активация модуля системы лояльности KilBil | По умолчанию off |
[plugins] ; Система лояльности KilBil ;kilBil = off
Настройка плагина системы лояльности KilBil производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/kilbil.ini
в секции [KilBil]
.
Наименование | Тип данных | Возможные значения | Описание | Примечания |
---|---|---|---|---|
url | строковый | Адрес сервера системы лояльности KilBil | По умолчанию https://bonus.kilbil.ru/ | |
timeout | целочисленный | Время ожидания ответа от сервера системы лояльности KilBil | По умолчанию 10 секунд | |
apiKey | строковый | Уникальный идентификатор рабочей станции, который является ключом | ||
discountsWithoutCard | логический |
| Применять скидки к чеку без добавления карты | По умолчанию false |
enableCertificate | логический |
| Включить систему сертификатов KilBil:
| По умолчанию |
useCertificateAsDiscount | логический |
| Оплата сертификатом в виде скидки | По умолчанию false |
[KilBil] ; Адрес сервера KilBil ; По умолчанию https://bonus.kilbil.ru/ ;url = https://bonus.kilbil.ru/ ; Время ожидания ответа от сервера ; По умолчанию 10 секунд ;timeout = 10 ; Уникальный идентификатор рабочей станции, который является ключом ;apiKey = "" ; Применять скидки к чеку без добавления карты ; По умолчанию false ;discountsWithoutCard = false ; Включить систему сертификатов KilBil ; По умолчанию true ;enableCertificate = true ; Оплата сертификатом в виде скидки ; По умолчанию false ;useCertificateAsDiscount = false
Бонусная программа KilBil
Для использования системы лояльности KilBil необходимо:
- Завести группу бонусных карт с типом карты KilBil (БД
Dictionaries
таблицаCardgroup
полеcardmode = 20
). - Активировать модуль системы лояльности KilBil (см. Конфигурирование модуля KilBil).
- Настроить подключение к серверу системы лояльности (см. Конфигурирование модуля KilBil).
- Перезапустить кассовую программу.
- Применить бонусную карту в чеке.
Добавление карты по номеру телефона
При использовании системы лояльности KilBil возможно добавление карты по номеру телефона. Для этого необходимо:
- Включить способ ввода "Удаленно" для группы карт (БД
Dictionaries
таблицаCardgroup
полеinputmask = 16
). Для группы карт указать:
маску допустимых номеров карт:
^\+7([0-9]{10})|^7([0-9]{10})|^8([0-9]{10})|(^9[0-9]{9})
правило преобразования:
7\1\2\3\4
тип карты
cardMode = 20
.
- Для правила поиска карт установить значение "По номеру карты".
- Настроить клавишу "Добавить карту" с командой
COMMAND_CARD
и параметрами:cardNumberType
со значением 1;cardMode
со значением20
.
При использовании команды на экран будет выведен диалог для ввода номера телефона. После ввода номера телефона производится поиск карты на сервере системы лояльности. Если карта найдена, то она будет добавлена в чек.
Регистрация клиента
Настройками сервера системы лояльности может быть предусмотрена регистрация клиента:
- Если при добавлении карты по номеру телефона клиент не найден, то на экран будет выведен диалог:
Для регистрации клиента необходимо подтвердить операцию. Настройками сервера системы лояльности может быть предусмотрен ввод:- Номера карты лояльности:
- Дополнительных данных клиента, поле номер телефона при этом несет информационный характер, изменить его невозможно:
- Кода подтверждения, отправленного на номер телефона клиента:
После успешной регистрации карта будет добавлена в чек.
- Номера карты лояльности:
- Если при добавлении карты по номеру карты клиент не найден, то на экран будет выведен диалог:
После ввода номера телефона клиента, который отсутствует на сервере, на экран будет выведен диалог:
Для регистрации клиента необходимо подтвердить операцию. Настройками сервера системы лояльности может быть предусмотрен ввод:- Номера карты лояльности.
- Дополнительных данных клиента, поле номер телефона при этом несет информационный характер, изменить его невозможно.
- Кода подтверждения, отправленного на номер телефона клиента.
После успешной регистрации карта будет добавлена в чек.
Замена карты
Если при добавлении карты (по номеру карты) клиент не найден, а на сервере системы лояльности предусмотрена замена карт, то на экран будет выведен диалог:
После ввода номера телефона клиента, который уже зарегистрирован на сервере, на экран будет выведен диалог:
Для замены карты необходимо подтвердить операцию. Настройками сервера системы лояльности может быть предусмотрен ввод кода подтверждения, отправленного на номер телефона клиента. После успешной замены карта будет добавлена в чек.
Продажа
Для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности KilBil в чек. Обращение к серверу для получения скидки выполняется автоматически при переходе в подытог, для получения суммы доступных баллов обращение к серверу выполняется при оплате баллами.
Если на сервере системы лояльности настроена верификация карты по SMS, то при добавлении карты в чек или при оплате баллами на экран будет выведен диалог для ввода кода подтверждения.
Если в системе лояльности KilBil настроена акция с применением цены товара, то при ее срабатывании на товар предоставляется скидка для получения дисконтной цены.
Возможен некорректный расчет скидок при одновременном использовании внутреннего дисконта и дисконта системы лояльности KilBil.
Списание баллов
Списание баллов выполняется по инициативе кассира. Потраченные баллы фиксируются в кассовой программе как скидка на чек. Для списания можно использовать все доступные баллы.
Начисление баллов
Начисление баллов происходит на стороне сервера системы лояльности KilBil после закрытия чека.
Возврат
В системе лояльности предусмотрена возможность возврата списанных ранее баллов.
Купоны KilBil
Кассовое ПО Artix предоставляет возможность работы с купонами KilBil.
Выдача купонов
Акции на выдачу купона создаются и редактируются на сервере системы лояльности KilBil. При закрытии чека печатается купон, шаблон которого находится в /linuxcash/cash/reports/kilbil_coupon.xml
.
Применение купонов
При использовании системы лояльности KilBil предоставляется возможность получения скидки по купону. Скидка по купону может быть применена на чек. В одном чеке продажи может быть применено несколько купонов.
Добавление купона в чек осуществляется несколькими способами:
- вручную с клавиатуры;
- сканированием штрих-кода;
- по кнопке "Добавить купон" с командой
COMMAND_COUPON_ADD
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
Для распознавания номера/штрих-кода купона на кассе должно быть задано правило разбора по штрих-коду, которое задается в конфигурационном файле /linuxcash/cash/conf/bcode.ini
.
78*=cccccccccc
В данном примере цифры "78" являются префиксами купонов, на что указывают символы "cccccccccc
".
При добавлении купона в чек проверяется его валидность. В случае, если купон невалиден, купон не будет добавлен в чек.
Скидка по купону применяется автоматически при переходе в подытог.
Сертификаты KilBil
Кассовое ПО Artix предоставляет возможность работы с сертификатами KilBil.
Для использования сертификатов KilBil требуется:
- Активировать модуль системы лояльности KilBil (см. Конфигурирование модуля KilBil).
- Настроить подключение к серверу системы лояльности (см. Конфигурирование модуля KilBil).
- Включить систему сертификатов KilBil (см. Конфигурирование модуля KilBil).
- Заполнить справочник сертификатов в БД
Dictionaries
таблицеCertificate
. Обязательные для заполнения поля:code
– код группы сертификатов (указать значениеkilbil
);name
– название (отображается как наименование позиции);tmccode
– код товара при добавлении в чек;deptcode
– отдел;vatcode
– налог;paymentobject
– признак предмета расчета.
Добавление сертификата в чек осуществляется по кнопке "Сертификат" с командой COMMAND_CERTIFICATE
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
При добавлении сертификата в чек на экран будет выведен диалог для ввода номера сертификата. После ввода номера сертификата осуществляется его поиск на сервере системы лояльности. Если сертификат найден, то он будет добавлен в чек.
Сторнирование подарочных сертификатов
Сторнирование подарочных сертификатов, добавленных в чек продажи, осуществляется аналогично удалению товарных позиций.
Оплата сертификатом KilBil
Для оплаты чека продажи сертификатом необходимо в утилите администрирования Yuki добавить валюту "Сертификат KilBil". О настройке валют подробнее можно прочитать в разделе "Валюты".
Оплата сертификатом может быть применена в чеке как оплата валютой или как скидка. Способ оплаты определяется параметром useCertificateAsDiscount
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/kilbil.ini
в секции [KilBil]
:
- при значении параметра
true
оплата сертификатом применяется в виде скидки, - при значении параметра
false
оплата сертификатом производится в качестве оплаты валютой.
Оплату чека можно произвести несколькими сертификатами.
Возврат товара, оплаченного сертификатом
При возврате товара, оплаченного сертификатом, производится возврат денежных средств на сертификат.
Просмотр информации о сертификате
Просмотр информации о сертификате осуществляется по кнопке "Получить информацию по сертификату" с командой COMMAND_CERTIFICATE_INFO
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
По нажатию клавиши на экран будет выведен диалог для ввода номера сертификата. После ввода номера сертификата на экран будет выведена информация о сертификате.
Особенность работы при наличии/отсутствии карты в чеке
При наличии карты в чеке запрос скидок, отправка чеков и выдача купонов осуществляется всегда.
При отсутствии карты в чеке запрос скидок, отправка чеков и выдача купонов осуществляется при включенной настройке discountsWithoutCard
в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/kilbil.ini
.
Отправка чеков
При закрытии чека продажи/возврата/возврата по чеку продажи информация о данном чеке будет отправлена на сервер системы лояльности KilBil.