Модуль CardIssuance предназначен для возможности выдачи карты покупателю непосредственно на кассе.

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

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

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

Наименование	Тип данных	Возможные значения	Описание	Примечания
cardIssuance	строковый	on off	Активация модуля "Выдача карт на кассе"	По умолчанию `off`

[plugins]
; Выдача карт на кассе
;cardIssuance = off

Настройка плагина cardIssuance производится в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/cardissuance.ini в секции [CardIssuance].

Наименование	Тип данных	Возможные значения	Описание	Примечания
url	строковый		URL для обращения к серверу	По умолчанию `url = http://localhost:8094/v1/issuancecard/cardnumber`. Параметр является обязательным.
timeout	целочисленный		Таймаут соединения в секундах	По умолчанию `20` секунд.
inputName	логический	true false	Вводить ФИО клиента	По умолчанию `false`.
inputSex	логический	true false	Вводить пол клиента	По умолчанию `false`.
inputBirthday	логический	true false	Вводить день рождения клиента	По умолчанию `false`.

[CardIssuance]
; URL для обращения к серверу
;url = http://localhost:8094/v1/issuancecard/cardnumber

; Таймаут соединения в секундах
; По умолчанию 20
;timeout = 20

; Вводить ФИО клиента
; По умолчанию false
;inputName = false

; Вводить пол клиента
; По умолчанию false
;inputSex = false

; Вводить день рождения клиента
; По умолчанию false
;inputBirthday = false

Выдача карты

Выдача покупателю карты клиента торговой сети может осуществляться непосредственно на кассе.

Для выдачи карты покупателю в утилите администрирования Yuki необходимо на клавишу настроить действие "Выдача карты" с командой COMMAND_CARDISSUANCE. О настройке действий подробнее можно прочитать в разделе "Настройка действий".

При нажатии на клавишу "Выдача карты" на экран выводится диалог создания нового клиента: ввод номера телефона является обязательным, отображение полей "ФИО клиента", "Дата рождения" и "Пол" настраивается в конфигурационном файле /linuxcash/cash/conf/ncash.ini.d/cardissuance.ini. После ввода данных клиента на экран будет выведен диалог ввода номера новой карты. После ввода номера карты на сервер будет отправлен запрос на выдачу карты. При успешном выполнении запроса в БД сервера будет создан новый клиент, ему будет назначена карта с введенным номером. Далее на сервере будет сгенерирован справочник с новыми данными для выгрузки на кассу. Если операция прошла успешно, то на экран будет выведен диалог добавления карты в чек.

В процессе выдачи карты возможны следующие ошибки:

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