Для работы с системой KilBil файл лицензии должен содержать модуль kilBil. Подробнее об этом можно прочитать в разделе "Новый формат лицензии .li4".
Реализованная интеграция с системой 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.





