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

1. Настроить сервис получения информации о картах и клиентах онлайн (конфигурационный файл /linuxcash/cash/conf/ncash.ini.d/artixbonus.ini секция [ArtixBonus.OnlineCards]).
2. Настроить модуль выдачи карт CardIssuance.
3. Настроить систему лояльности Артикс Бонус.
4. В утилите администрирования Yuki настроить клавишу "Добавить карту" с командой COMMAND_CARD и параметрами:
   • cardNumberType = 1 (способа ввода карты);
   • cardMode = 1 (тип карты).

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

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

Выдача карт

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

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

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