Для использования функционала выдачи карт лояльности Артикс Бонус необходимо:

  1. Настроить сервис получения информации о картах и клиентах онлайн (конфигурационный файл /linuxcash/cash/conf/ncash.ini.d/artixbonus.ini секция [ArtixBonus.OnlineCards]).

  2. Настроить модуль выдачи карт CardIssuance.

    Для создания карты отправляется запрос на сервис выдачи карт.

  3. Настроить систему лояльности Артикс Бонус.
  4. В утилите администрирования Yuki настроить клавишу "Добавить карту" с командой COMMAND_CARD и параметрами:
    • cardNumberType = 1 (способа ввода карты);

    • cardMode = 1 (тип карты);

    • smsVerification = true (SMS-верификация при выдаче виртуальной карты).

      Начиная с версии 4.6 | 5.309 добавлена возможность выдачи виртуальной карты без SMS-верификации.

      Для возможности создания карты без подтверждения из СМС необходимо у команды COMMAND_CARD указать параметр smsVerification = false.

  5. Настроить группу карт с типом карты "Артикс Бонус" (БД Dictionaries таблица Cardgroup поле cardmode = 1) и способом ввода "Удаленно" (БД Dictionaries таблица Cardgroup поле inputmask = 16).

    Обязательным условием корректной работы с картами является настройка маски допустимых номеров карт (БД Dictionaries таблица Cardgroup поле regexpattern).

Выдача карт

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

  1. Если сервис вернул один номер карты, то осуществляется получение информации о карте онлайн.
  2. Если сервис вернул несколько номеров карт, то на экран будет выведен диалог "Выберите карту": 
  3. Если карта не найдена, то на экране отображается диалог "Карта не найдена. Создать?":
    • При подтверждении операции:
      • если SMS-верификация включена (параметр smsVerification = true), то на экране отображается диалог "Введите код подтверждения из СМС":
        • После ввода кода подтверждения будет отправлен запрос на создание карты, номер карты генерируется на сервере. Далее осуществляется получение информации о карте онлайн.

        • При отказе от ввода кода подтверждения диалог будет закрыт. Карта в чек не добавляется.

      • если SMS-верификация выключена (параметр smsVerification = false), то код подтверждения не запрашивается. Карта создается и добавляется в чек.
    • При отказе от операции карта в чек не добавляется.
  4. Если клиент не найден, то на экране отображается диалог "Клиент с указанным номером телефона не найден. Создать?": 
    • При отказе от операции карта в чек не добавляется;
    • При подтверждении операции: 
      • если настройками предусмотрено заполнение дополнительных полей (CardIssuance), на экране отображается диалог ввода анкетных данных клиента. Поле "Номер телефона" заполнено введенным ранее номером телефона и не доступно для редактирования. После заполнения анкетных данных отображается диалог "Введите код подтверждения из СМС".

      • если заполнение дополнительных полей не предусмотрено, то на экране отображается диалог "Введите код подтверждения из СМС".

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

        • При отказе от ввода кода подтверждения диалог будет закрыт. Карта в чек не добавляется.

      • если SMS-верификация включена (параметр smsVerification = false), то код подтверждения не запрашивается. Карта создается и добавляется в чек.
  • No labels