Санин Тимофей 22 сентября, 2017 - 10:17 Последняя редакция: 16 августа, 2018 - 12:39 Автор редакции: Дюков Илья

 

 

 

 

 

Киоск пополнения CRM.

 
 

1. Задача

 
Программно-аппаратный комплекс "Киоск пополнения CRM" служит для осуществления зачисления денежных средств на баланс системы лояльности с выдачей клиенту фискального чека без зайдействия ресурсов кассира. С более подробным описанием можно ознакомиться в презентации на FTP "Киоск пополнения CRM" представляет собой комплекс из следующих составляющих:
  • Терминал самообслуживания, конфигурация может варьироваться Ниже приведен пример киоска, на котором производилось тестирование.
  • Серверная часть ПО АБонемент: FireBird сервер, сервер блокировок+ключ, БД ПО Абонемент. Если используется один терминал и не используется само ПО Абонемент, то можно развернуть непосредственно на киоске. Иначе разворачивается на выделенном сервере
  • Интерфейс для работы внешних приложений с БД ПО Абонемент (connecter)
  • Веб-сервер (denwer)
  • PHP скрипты web-модуля "инфокиоск".
 
 

2. Схема взаимодействия

 
Схема взаимодействия (структурно показана на Рис. 1)следующая: веб модуль общается с ПО Connecter и постоянно его опрашивает на вопрос прикладывания карты. В случае, если connecter сообщает, что карта была приложена, веб-модуль производит поиск гостя (алгоритм поиска представлен на Рис. 2). Далее гость выбирает способ оплаты для пополнения кошелька. Connecter активирует соответствующее оборудование (пин-пад, купюроприемник, etc.). После успешной оплаты печатается фискальный чек, в БД ПО Абонемент клиенту зачисляется платеж и начисляется услуга с аналогичной стоимостью, таким образом баланс гостя не меняется, но имеется возможность просмотра отчетности. Также сумма оплаты зачисляется на депозитный счет гостя в CRM.
Рис. 1 Схема взаимодействия модулей.
 
 
 
Рис.2 Алгоритм поиска гостя
 
 
 

3. Необходимые настройки

 

В ПО Абонемент:

  • Так как киоск является кассой, то необходимо завести киоски в ПО Абонемент для каждого терминала
  • Завести услугу для балансировки
  • Установить в общих параметрах флаг "Бонусы накапливаются во внешней PDS"
  • Создать фискальные типы платежей (для наличных и кредитных карт) с бонусным процентом равным 100%

В настройках веб-модуля:

  • настроить соединение с connecter
  • В качестве кодов типов оплат для наличных и кредитных карт указать те, у которых установлен бонусный процент равный 100% из предыдущего пункта
  • Указать ID начисляемой услуги при пополнении баланса.

Для работы с наличными:

  • Установить ядро UCS Премьера (kiosk_host)
  • В папку с Kiosk_host установить BillAcceptorServer (FullVersionXXX\HW\MoneyAcceptor\BillAcceptor.rar)
  • В папку с Connecter установить BillAcceptor.dll и BillAcceptorEx.dll

Настройка Connecter:

Для связи с CRM:

  • В папку с Connecter скопировать актуальные файлы RunPDS.dll и sdmPDS_CS.dll
  • В RunPDS.ini в секции [Merge] прописать pdscs=PDS_CS.ini
  • Настроить PDS_CS.ini:
[BOOT]
PDS = %exepath%\sdmPDS_CS.dll
[DLL]
PDS = PDS-CS
[DLL.PDS-CS]
;дисконтная карта может передаваться другому человеку
DefKindCard = 0
GlobalKey = *%тут прописать global key от CRM%*
;Логин и пароль для подключения к CRM
LoginUser = Администратор
LoginPsw  = 1
;Сетевой адрес и порт, на котором работает CRM
Host=172.22.3.172
Port = 9191
;Классификатор ПО в CRM
TerminalID = 13
;Тип счета, баланс которого отображать
BalanceAccountTypeID = 1
;Тип счета, который будет пополняться
PaymentAccountTypeID = 1
; Указан несуществующий счет, чтобы при пополнении депозитного счета потраты не передавались.
ServiceAccountTypeID = 99999

Log.Name  = !!!!!!!!!pds-cs!!!!!!!!!!!.log
Log.Level = 100
Log.DebugLevel = 100Б
 

4. Работа с киоском

Порядок обслуживания пользователя:

Инкассация киоска.

В настройках веб-модуля необходимо установить флаги:
  • Доступна регистрация кассира
  • Кассир не является пользователем
В БД ПО Абонемент необходимо создать пользователя с правами кассира. Данному пользователю необходимо прикрепить идентификатор. При прикладывании этого идентификатора к считывателю киоска произойдет авторизация кассира и станут доступны служебные функции: X-Отчет, Z-Отчет, внесение, изъятие, etc (см. рисунок ниже)
 
Описание функций:
  • X-отчет - снять Х-отчет с фискального регистратора
  • Z-отчет - закрыть смену (снять Z-отчет с фискального регистратора)
  • Z-отчет с автоматическим внесением - закрыть смену (снять Z-отчет с фискального регистратора), после которого будет выполнено автоматическое внесение наличности на всю сумму в кассе. Используется в случаях, когда закрывается кассовая смена, но деньги остаются в кассе.
  • Смена кассира - смена текущего кассира в программе Абонемент на используемом киоске
  • Внесение и изъятие наличных - кассовые функции внесения и изъятия денег в кассу (будет запрошена сумма, после подтверждения напечатан соответствующий документ на ФР
  • Закрытие смены терминала - закрыти смены на терминале кредитных кард (сверка итогов и инкассация терминала).
 
 

Порядок запуска.

  1. BillAcceptorServer. Он же запускает kiosk_host.
  2. Denwer (если он развернут на самом киоске)
  3. TcpCardReader
  4. Connecter
  5. Браузер
Для реализации автоматического запуска можно добавить в автозагрузку .bat файл со следующим содержанием:
rem Файл служит для запуска всех необходимых утилит для работы инфотерминала
rem а так же стартует браузер в полноэкранном режиме
rem в начале завершается процесс EXPLORER для отключения рабочего стола.
TaskKill /F /IM explorer* 
start "" "C:\_UCS\_KIOSK\kiosk_host\BillAcceptorServer.exe" 
start "" C:\_UCS\_KIOSK\Denw\denwer\Run.exe

start "" C:\_UCS\_KIOSK\TcpCardReader\TcpCardReader.exe
start /min "" C:\_UCS\_KIOSK\Connecter\connecter.lnk
ping -n 10 127.0.0.1 > nul 
start "" "C:\Program Files\Google\Chrome\Application\chrome.exe" -kiosk http://127.0.0.1/info_crm/ –overscroll-history-navigation=0
 
 

5. Особенности

 
  • Для настройки и получения финансовой отчетности необходимо рабочее место ПО Абонемент.
  • Все гости из CRM дублируются в БД ПО Абонемент.
  • Для работы Kiosk_host необходим ключ премьеры с модулем киоска.
  • В связке VKP-80-II-SX, чтобы чеки не "выплевывались", а презентовались необходимо отключить печать клише в настройках ФР: https://казначей.онлайн/forum/index.php?topic=61.0
  • Может возникнуть ситуация, что при корректных настройках принтера кириллица печатается иероглифами. Это случается из-за того, что казначей неверно выставляет кодовую страницу. Поможет заливка на принтер альтернативного FONT модуля: https://drive.google.com/open?id=0B683WItGLEHHVWo1T2tKTzR0UzA

6. Версии ПО

Тестирование проивзодилось на следующих версиях ПО и модулей:

  • Абонемент v1.129
  • Connecter v1.58.0.2
  • Инфокиоск v4.41
  • CRM v5.09.05.003
 

7. Пример киоска

 
Внешний вид:                                           Внешний вид киоска на объекте:
                 
 
 
Оборудование:
  • Корпус терминала САГА ТП-10/20 (любой цвет по каталогу RAL) 
  • Системная плата J1800I-C + Intel C2.41GHz, двухъядерный 
  • DIMM 2048Mb  
  • Блок питания ATX 350W FSP  
  • Жесткий диск 2.5" 500Gb 
  • ЖК дисплей с сенсорной технологией 17-дюйма  
  • Фильтр на 6 розеток + предохранитель 
  • Фискальный регистратор «КАЗНАЧЕЙ»  + Фискальный накопитель
  • Купюроприемник CashCode SM с кассетой до 1500 банкнот (протокол CCNet)  
  • ИБП 500ВА 
  • Право на использование Windows Embedded POSReady 7
  • Iron Logic Matrix III RS-232 

Примерная стоимость: 2600$

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

  • Пин-пад SZZT ZT588 СА или ZT598L (поддерживаемый Сбербанком)
  • Картридер Sankyo ICT3K7

При этом стоимость увеличится примерно на 800$

Работа возможна только с процессингом Сбербанка через Pilot_NT.dll

 

8. Возможные ошибки (раздел будет пополняться)

Проблема Вероятная причина
Все проходит до момента нажатия пользователем кнопки "ОПЛАТИТЬ", после чего не печатается чек, на экране видем сообщение Bad Parameters В настройках киоска (http://..../settings) неверно задан параметр "ID начисляемой услуги при пополнении баланса" . Следует обратить внимание, что это именно ID услуги, а не код.
   

 

9. Ключевые доработки и исправления

Версии ПО Суть изменения

Connecter v1.58.0.12
Kiosk v.4.41

Значительно увеличена скорость обработки запросов.
Снижена задержка между прикладыванием карты и появлением сплэш-скрина.
Connecter v1.60.xxx

Ручная блокировка киоска из меню кассира
Автоматическая блокировка киоска при первой ошибке ФР. Разблокируется после успешной операции с ФР, пример: во время печати чека возникает ошибка ФР, киоск блокируется, авторизоваться можно только кассиром. После устранения проблемы ФР кассир снимает Х-отчет, киоск продолжает работать в штатном режиме.