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

Начиная с версии 4.6.214 реализована возможность использования подарочных сертификатов системы лояльности Artix совместно с системой лояльности KilBil.

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

Работа в режиме offline не поддержана. Если при закрытии чека сервер системы лояльности недоступен, то будет выведено сообщение «Ошибка соединения с сервером», оплата бонусами невозможна.

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

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

НаименованиеТип данныхВозможные значенияОписаниеПримечания
kilBilстроковый
  • on
  • off
Активация модуля системы лояльности 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логический
  • true
  • false
Применять скидки к чеку без добавления картыПо умолчанию false
enableCertificateлогический
  • true
  • false

Включить систему сертификатов KilBil:

  • при значении true включена система сертификатов KilBil,
  • при значении false отключена система сертификатов KilBil, возможно использование подарочных сертификатов системы лояльности Artix.

По умолчанию true


useCertificateAsDiscountлогический
  • true
  • false
Оплата сертификатом в виде скидкиПо умолчанию 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 необходимо:

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

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

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

  1. Включить способ ввода "Удаленно" для группы карт (БД Dictionaries таблица Cardgroup поле inputmask = 16).
  2. Для группы карт указать:

    • маску допустимых номеров карт:

      ^\+7([0-9]{10})|^7([0-9]{10})|^8([0-9]{10})|(^9[0-9]{9})
    • правило преобразования:

      7\1\2\3\4
    • тип карты cardMode = 20.

  3. Для правила поиска карт установить значение "По номеру карты".
  4. Настроить клавишу "Добавить карту" с командой COMMAND_CARD и параметрами:
    • cardNumberType со значением 1;
    • cardMode со значением 20.

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

Регистрация клиента

Настройками сервера системы лояльности может быть предусмотрена регистрация клиента:

  1. Если при добавлении карты по номеру телефона клиент не найден, то на экран будет выведен диалог:

    Для регистрации клиента необходимо подтвердить операцию. Настройками сервера системы лояльности может быть предусмотрен ввод:
    1. Номера карты лояльности:
    2. Дополнительных данных клиента, поле номер телефона при этом несет информационный характер, изменить его невозможно:
    3. Кода подтверждения, отправленного на номер телефона клиента:

      После успешной регистрации карта будет добавлена в чек.
  2. Если при добавлении карты по номеру карты клиент не найден, то на экран будет выведен диалог:

    После ввода номера телефона клиента, который отсутствует на сервере, на экран
    будет выведен диалог:

    Для регистрации клиента необходимо подтвердить операцию. Настройками сервера системы лояльности может быть предусмотрен ввод:
    1. Номера карты лояльности.
    2. Дополнительных данных клиента, поле номер телефона при этом несет информационный характер, изменить его невозможно.
    3. Кода подтверждения, отправленного на номер телефона клиента.

После успешной регистрации карта будет добавлена в чек.

Замена карты

Если при добавлении карты (по номеру карты) клиент не найден, а на сервере системы лояльности предусмотрена замена карт, то на экран будет выведен диалог:

После ввода номера телефона клиента, который уже зарегистрирован на сервере, на экран будет выведен диалог:

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

Продажа

Для начисления и списания баллов с бонусной карты необходимо добавить карту системы лояльности 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

Кассовое ПО Artix предоставляет возможность работы с сертификатами KilBil.

Для использования сертификатов KilBil требуется:

  1. Активировать модуль системы лояльности KilBil (см. Конфигурирование модуля KilBil).
  2. Настроить подключение к серверу системы лояльности (см. Конфигурирование модуля KilBil).
  3. Включить систему сертификатов KilBil (см. Конфигурирование модуля KilBil).
  4. Заполнить справочник сертификатов в БД 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.

  • No labels