Реализованная интеграция с системой KilBil может не поддерживать определенные функции системы или иметь особенности их реализации. Следует уточнять полноту интеграции в соответствии с функциональными требованиями к системе лояльности. |
Начиная с версии 4.6.214 реализована возможность использования подарочных сертификатов системы лояльности Artix совместно с системой лояльности KilBil. |
Кассовое ПО Artix поддерживает применение дисконтных и бонусных воздействий, применение купонов и использование подарочных сертификатов системы лояльности KilBil.
Работа в режиме offline не поддержана. Если при закрытии чека сервер системы лояльности недоступен, то будет выведено сообщение «Ошибка соединения с сервером», оплата бонусами невозможна. |
Активация модуля системы лояльности 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 необходимо:
Dictionaries
таблица Cardgroup
поле cardmode = 20
).При использовании системы лояльности 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 после закрытия чека.
В системе лояльности предусмотрена возможность возврата списанных ранее баллов.
Кассовое ПО 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. |
Кассовое ПО Artix предоставляет возможность работы с сертификатами KilBil.
Для использования сертификатов KilBil требуется:
Dictionaries
таблице Certificate
. Обязательные для заполнения поля:code
– код группы сертификатов (указать значение kilbil
);name
– название (отображается как наименование позиции);tmccode
– код товара при добавлении в чек;deptcode
– отдел;vatcode
– налог;paymentobject
– признак предмета расчета.Добавление сертификата в чек осуществляется по кнопке "Сертификат" с командой COMMAND_CERTIFICATE
. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
При добавлении сертификата в чек на экран будет выведен диалог для ввода номера сертификата. После ввода номера сертификата осуществляется его поиск на сервере системы лояльности. Если сертификат найден, то он будет добавлен в чек.
Сторнирование подарочных сертификатов, добавленных в чек продажи, осуществляется аналогично удалению товарных позиций.
Для оплаты чека продажи сертификатом необходимо в утилите администрирования 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.