Добавление карты может производиться следующими способами:

при переходе в оплату,
по кнопке в формировании чека,
выполнив считывание сканером или ридером в приветствии, формировании или редактировании чека.

Настройки добавления карты в чек

При переходе в оплату

Отображение окна при переходе в оплату задается настройкой:

Наименование параметра	Возможные значения	Описание
Файл `/opt/sst-sco/conf/check.ini`, секция `[Check]`, настройки модуля чека
suggestCardInput	true (по умолчанию) false	Предлагать покупателю ввод карты клиента при переходе в оплату

По кнопке в формировании чека

Для добавления карты по кнопке необходимо задать секцию кнопки действия с командой CHECK_INPUTCARD, подробнее в разделе "Кнопки в режиме формирования чека".

Команда CHECK_INPUTCARD имеет дополнительный параметр сardMode – тип карты. Если тип карты указан, то с помощью команды в чек нельзя добавить карту другого типа.

По нажатию кнопки открывается окно ввода карты.

[Check.FormingForm.actions.1]
; Кнопка отображения каталога для ручного выбора товара
command = PICKLIST_SHOW
text = formingPickList
type = middle

[Check.FormingForm.actions.2]
; Кнопка ввода карты
command = CHECK_INPUTCARD
text = formingAddCard
cardMode = 25

[Check.FormingForm.actions.3]
; Кнопка ввода штрих-кода вручную
command = CHECK_MANUALINPUT
text = formingInput

[Check.FormingForm.actions.4]
; Кнопка получения электронного чека
command = CHECK_INPUTCUSTOMERADDRESS
text = formingElCopy

[I18n.ru]
formingAddCard = Добавить карту
; Остальные языки по аналогии

Способы добавления в окне ввода карты

Можно задать один или несколько способов ввода карты.

Наименование параметра	Возможные значения	Описание
Файл `/opt/sst-sco/conf/check.ini`, секция `[Check]`, настройки модуля чека
cardInputMethods	phone number read (по умолчанию) paymentCode	Способы добавления карты: "phone" - по номеру телефона, "number" - по номеру карты, "read" - считать сканером или ридером, "paymentCode" - по платежному коду. Способы должны быть указаны через запятую, например "phone, number, read". В каком порядке данные способы указаны, в таком и будут отображаться на форме. Если указан один способ, то кнопки выбора отображаться не будут, и будет доступен только этот способ

[Check]
suggestCardInput = true
cardInputMethods = read, phone

Формат отображения карты

Формат отображения карты определяется настройкой:

Наименование параметра Возможные значения Описание

Файл /linuxcash/cash/conf/ncash.ini.d/sstsco.ini, секция [Card], настройки работы с картами

cardNameFormat

По умолчанию %(card.cardGroup.name[s])

Формат отображения карты может содержать свойства объектов:

Использование карты клиента внешних систем лояльности

Реализованное взаимодействие Artix:SCO с системами лояльности может не поддерживать определенные функции систем.

Для использования карт внешних систем лояльности необходимо:

Сконфигурировать систему лояльности, которая будет использоваться.
Задать и настроить группу карт, подробнее в настройках добавления карт в Artix.

В Artix:SCO используются следующие настройки работы с картами внешних систем лояльности:

Наименование	Возможные значения	Описание
Файл `/linuxcash/cash/conf/ncash.ini.d/sstsco.ini`, секция `[Card]`, настройки работы с картами внешних систем лояльности в Artix:SCO
forbidShowCardInfo	true false (по умолчанию)	Запрет показа информации по карте для любых групп карт. В Artix:SCO настройка включена для корректной работы.
findCardByPhoneNumber	true (по умолчанию) false	Искать карту по номеру телефона. Указывает, как именно искать карту при выборе способа "phone". Если: `true` - поиск карты будет произведен по номеру телефона (`cardNumberType = 1`) `false` - поиск карты будет произведен по номеру карты (`cardNumberType = 0`)
cardMode	Тип карты лояльности по умолчанию -1 (не указано)	Карта какой системы лояльности будет искаться при добавлении по номеру телефона или по платежному коду. Указывается для системы, поддерживающей удаленное получение номера карты по номеру телефона или платежному коду
Файл `/linuxcash/cash/conf/ncash.ini.d/sstsco.ini`, секция `[Discounts]`, настройки работы с картами внешних систем лояльности в Artix:SCO
allowPartialPointsSpend	true (по умолчанию) false	Разрешить использовать доступные баллы частично. При: `true` - доступен ввод суммы баллов лояльности для списания, `false` - доступно только подтверждение списания максимальной суммы баллов лояльности. В Artix:SCO настройка выключена для ускорения процесса оплаты

Настройки для внешних систем лояльности

Plazius

При использовании системы лояльности Plazius возможно добавление карты по номеру карты, номеру телефона или по платежному коду.

Настройки:

[Check]
suggestCardInput = true
cardInputMethods = phone, paymentCode, read

[Card]
findCardByPhoneNumber = true
cardMode = 18

Manzana2019

Идентификация клиента

Если в чек добавлена карта системы лояльности Manzana2019 с признаком идентификации клиента, то при переходе к выбору оплаты отображается уведомление о вызове консультанта. После авторизации консультанта будет выведен диалог для идентификации клиента (ФИО клиента и текст сообщения) с кнопками "Подтверждаю" и "Не подтверждаю". Изменить текст сообщения для идентификации клиента можно здесь.

Для прохождения идентификации покупатель должен предоставить консультанту документ, удостоверяющий личность. Решение об успешной идентификации покупателя принимает консультант:

при подтверждении личности клиента доступно списание бонусных баллов по добавленной карте,
при отказе от подтверждения карта удаляется из чека, происходит переход к выбору оплаты.

Списание баллов

Списание баллов выполняется при переходе в оплату в окне "Информация о бонусах". Для списания баллов необходимо нажать кнопку "Списание бонусов" и ввести сумму списания, затем нажать кнопку "Продолжить".

Списание баллов может осуществляться с проверкой карты по динамическому штрих-коду. При переходе в подытог выполняется проверка соответствия динамической части штрих-кода карты и поля "CodeValid", полученного от сервера системы лояльности Manzana2019. Если значения не соответствуют, то для снятия запрета будет отображен диалог ввода кода CVV карты:

при вводе корректного кода CVV будет открыто окно "Информация о бонусах", запрос ввода CVV больше не будет отображен для данной карты в чеке (до удаления карты),
при вводе некорректного кода CVV на экран будет выведен диалог "Введен неверный код. Списание бонусов запрещено. Продолжить без списания бонусов?" с возможностью повторить ввод кода CVV или продолжить оформление чека без списания бонусных баллов.

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

Купоны

При использовании системы лояльности Manzana2019 возможно получение скидки по купону. В одном чеке продажи может быть применено несколько купонов.

Для добавления купона в чек необходимо:

Добавить в чек товар.
Добавить в чек карту лояльности Manzana2019.
Открыть диалог по кнопке с командой SST_CHECK_INPUTCOUPON. О настройке действий подробнее можно прочитать в разделе "Настройка действий".
В появившемся диалоге "Добавление купона" добавить купон.
Нажать кнопку "Ок" для закрытия сообщения о добавлении купона.

Купоны не будут отображаться в документе.

Скидка по купону применяется автоматически при переходе в подытог:

если в чеке имеются неактивные купоны, то на экран будет выведен диалог "Удаление неактивных купонов" со списком неактивных купонов. Неактивные купоны будут удалены автоматически,
если в чеке все купоны активны, то на экран будет выведен диалог "Система лояльности" для оплаты чека баллами.

Manzana Loyalty Online

При использовании электронных фишек системы лояльности Manzana Loyalty Online диалог с начислением фишек по умолчанию отображается для консультанта. Изменить настройки отображения диалогов можно здесь.

Настройками могут быть заданы ограничения добавления карты системы лояльности Manzana Loyalty Online в чек в зависимости от ее статуса. Подробнее об этом можно прочитать здесь.

Loymax

Для использования системы лояльности Loymax необходимо:

Настроить кассу для работы с бонусной программой Loymax.
Включить и настроить проверку действительности QR-кода.

Использование цифровой клавиатуры в диалогах ввода

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

Функционал поддержан для диалогов Manzana2019 и Manzana Loyalty Online.

В SCO для верификации карт внешних лояльностей по умолчанию используется полноразмерная клавиатура. Существует возможность использовать цифровую клавиатуру вместо полноразмерной в диалогах ввода, данное поведение задается параметром showDigitalKeyboard:

Наименование Возможные значения Описание

Файл /linuxcash/cash/conf/ncash.ini.d/gui.ini, секция [UI.<наименование_диалога>]

showDigitalKeyboard

true
false (по умолчанию)

Использование цифровой клавиатуры вместо полноразмерной в диалогах ввода. При значении:

true используется цифровая клавиатура,
false используется полноразмерная клавиатура.

В секции указывается наименование диалога, для которого требуется использование цифровой клавиатуры:

[UI.manzanaVerification]
showDigitalKeyboard=true

[UI.manzana2019Verification]
showDigitalKeyboard=true

Для inputVerificationCode в SCO всегда отображается цифровой диалог.

Просмотр информации о карте

При просмотре информации о карте выводится имя клиента, номер телефона, email, номер карты. Информация о карте может выводиться только по инициативе консультанта.

Для отображения информации по инициативе консультанта необходимо настроить действие с командой COMMAND_CARDINFO. Для корректной работы необходимо выключить:

настройку forbidShowCardInfo,
флаг "Показывать информацию о карте" для группы карт.

При просмотре информации о карте системы лояльности Manzana2019 значение поля "Email" остается пустым.
Просмотр информации о карте системы лояльности Manzana Loyalty Online или Loymax возможен только после добавления карты в чек.

Подробнее о просмотре информации после добавления карты в чек, можно прочитать в статье "Просмотр информации о карте".