Введение

Персональная депозитно-дисконтная система (далее ПДС) предназначено для ведения собственной базы персональных платежно-дисконтных карт и организации работы с различными элементами системы лояльности (скидки, бонусы, накопления и т.д.)

Настройка системы ПДС

Установка и настройка системы ПДС подробно описана в документе http://support.ucs.ru/ru/node/6673

Важно: Без выполнения требований из статьи http://support.ucs.ru/ru/node/6673 и запуска системы ПДС как самостоятельного ПО дальнейшее прочтение данной статьи не имеет смысла.

Настройка сервера карт (CARDSERV)

Важно: Версия сервера карт (CARDSERV) должна быть не ниже 5.08 (протокол версии 14) , если используется ретранслятор карт Farcards, он должен быть не ниже версии 3.02

Стандартная установка и настройка сервера карт описана в документе http://support.ucs.ru/ru/node/6673#header-4.

После стандартной установки и настройки сервера карт для связи с R-Keeper v7 (далее RK7) необходимо:

  •  из директории \bin\For cardserv дистрибутива соответствующей версии RK7 (архив zip из папки standalone на ФТП) скопировать в рабочую директорию сервера карт следующие файлы:
  • borlndmm.dll
  • dllman.dll
  • errors32.dll
  • Netkern.dll
  • pds_netk.dll
  • TCPSOC.dll
  • Thread32.dll
  • netk.ini - файл, расположен в директории \bin\For cardserv\ini\
  • cardserv.ini - подготовленный файл, расположенный в директории \bin\For cardserv\ini\. Данный файл адаптирован исключительно для связи Сервера карт с RK7. Если связи с RK6 не будет, то используйте этот файл.

Важно: если соответствующего архива из папки standalone\ с версией РК7 нет, но есть инсталлятор кассовой части (RK7_Cash_Setup_7.5.Х.exe), набор библиотек необходимо брать из директории, указанной при установке (1) и обязаьно нажать кнопку "Добавить" (2) после выбора пути, куда будут скопированы библиотеки.

 

Рис. Выбор пути для сохранения pds_netk.dll

  • отредактировать конфигурационный файл сервера карт CARDSERV.INI:
  • Добавить в секцию [LinkDLL] библиотеку связи pds_netk.dll для взаимодействия с RK7:
[LinkDLL]
...
3 = pds_netk
  • Добавить секцию [pds_netk] с параметрами библиотеки pds_netk.dll:
[pds_netk]
NetServerName=PDS_CARDSERVER_1    ;; сетевое имя сервера карт, то же имя должно быть вписано в свойствах PDS interface на кассовом сервере, подробности ниже 
ERRORLOG=pds_netk.stk             ;; имя лог-файла 
ININAME=netk.ini                  ;; имя отдельного конфигурационного файла с настройками протоколов и netkern, необязательный параметр
PROTOCOLS=netkprot\*.dll          ;; маска поиска библиотек протоколов netkern, используется если не задан параметр ININAME 
Timeout=120000                    ;; таймаут в миллисекундах, максимальное разрешённое время выполнения сервером запроса; до версии pds_netk 5 значение по умолчанию было 10000
                                  ;; начиная с версии 10 (7.10.0.32) значение параметра игнорируется, таймаут на сервере отсутствует; проверяется только таймаут, который настраивается 
                                  ;; в свойствах драйвера/интерфейса ПДС для кассового сервера 
DebugMessages=0                   ;; при значении 1 выводит в лог основную информацию по всем запросам
  • запустить сервер карт в режиме приложения (/desktop) и проверить статус загруженных библиотек связи на вкладке Protocols.

Примечание: помните, что для взаимодействия сервера карт и редактора карт необходим протокол RTCP. 

Рис. Загруженные библиотеки связи на примере сервера карт версии 7.22.02

Настройка редактора карт (PCards)

Стандартная установка и настройка редактора карт описана в документе http://support.ucs.ru/ru/node/6673#header-14.

Важно: Редактор карт (PCards.exe) и кассовый сервер RK7 (midserv.exe) используют конфигурационные файлы с одинаковым названием (RKEEPER.INI), поэтому их следует устанавливать в разные каталоги. Если необходимо установить приложения в один каталог, для кассового сервере следует использовать отличительный конфигурационный файл и при запуске кассового сервера принудительно указать  имя этого файла в командной строке.

После стандартной установки и настройки редактора карт для связи с RK7 необходимо:

  • из директории \bin\For cardserv дистрибутива соответствующей версии RK7 скопировать в рабочую директорию редактора карт следующие файлы:
  • borlndmm.dll
  • dllman.dll
  • errors32.dll
  • Netkern.dll
  • thread32.dll
  • Pcget.dll
  • TCPSOC.dll
  • Thread32.dll
  • netk.ini - необязательный файл, расположен в директории \bin\For cardserv\ini\
  • rkeeper.ini - подготовленный файл, расположенный в директории \bin\For cardserv\ini\. Данный файл адаптирован исключительно для связи Редактора карт с RK7. Если связи с RK6 не будет, то используйте этот файл.

Pcget.dll – интерфейсная библиотека для Pcards.exe, используется для авторизации пользователей и получения данных по скидкам и бонусам из системы R-Keeper 7. Для получения информации по скидкам и бонусам в секции [PCGET] необходимо прописать сетевое имя сервера справочников.

  • отредактировать конфигурационный файл редактора карт RKEEPER.INI:
  • добавить секцию [PCGET] с параметрами библиотеки Pcget.dll:
[PCGET]
Server = RK7_REF_SRV – имя сервера справочников RK7
Client = PCARDS_CLIENT1  – уникальное имя клиента
ShowMarkups = 0 – загружать(1) или нет(0) наценки в список скидок
LastLoginName=  – имя последнего пользователя, вошедшего в редактор карт, заполняется автоматически
  • добавить секцию [NETKERN] для сетевых параметров - более детальная информация  в документе http://support.ucs.ru/ru/node/5235
[NETKERN]
PROTOCOLS= tcpsoc.dll
  • добавить секцию [TCPDNS] с параметрами, детализирующими расположение сервера справочников системы RK7:
[TCPDNS]
RK7_REF_SRV = AAA.BBB.CCC.DDD:1234 - где AAA.BBB.CCC.DDD - IP адрес машины, на которой работает сервер справочников, и 1234 - порт сервера справочников
  • запустить редактор карт. Если база новая, то используйте следующие данные для входа: пользователь = ucs, пароль = ucs

Примечание: права в редакторе карт редактируются для роли, поэтому необходимо дать все права группе Administrator. Для этого необходимо зайти в справочник "Файл - Пользователи", выбрать роль и разрешить все операции.

Рис. Редактирование прав группы пользователей

  • далее необходимо проверить доступность скидок и бонусов в режиме редактирования данных клиента (подробнее как добавить клиента и карту читайте в пользовательском руководстве)

Настройка R-Keeper v7

Настройка менеджерской станции

Для настройки менеджерской станции RK7 необходимо:

  • запустить менеджерскую станцию, открыть меню "Настройки" ⇒ "Параметры" и перейти в раздел [Установочные] - [Связь с другими системами] - [Персональные карточки] - [ПДС Сервер]

  • в свойствах параметра "ПДС сервер" в разделе "Основное" прописать имя сервера карт, значение которого должно соответствовать значению параметра NetServerName из конфигурационного файл сервера карт CARDSERV.INI (необязательно)

Рис. Настройка параметра "ПДС Сервер"

Примечание: Настройка параметра "ПДС сервер" не актуальна при использовании нескольких ПДС-интерфейсов на одном кассовом сервере. Приоритет данного имени сервера ниже имени, прописанного в свойствах интерфейса на кассовом сервере (рис.ниже)

  • в меню менеджерской "Сервис"  "Станции и Устройства" выбрать необходимые кассовый сервер и на закладке "Устройства" добавить интерфейс "PDS Interface"

  • в свойствах интерфейса прописать имя сервера карт - параметр PDS Server Name, значение которого должно соответствовать значению параметра NetServerName из конфигурационного файл сервера карт CARDSERV.INI

Рис. Параметры интерфейса "PDS Interface"

  • при необходимости, заполнить или настроить остальные параметры интерфейса:
  • Currency Rate Class Code = 1 – код класса ставок валюты ПДС (1 – класс национальной валюты)
  • Tax Code = 1 – код налога
  • Call Timeout = 120 – таймаут обращения к серверу ПДС в секундах
  • Maximal Discount Value=0 = Discount limit spent totally – интерпретация нулевого значения лимита скидки, возвращаемого сервером карт: Discount limit spent totally – лимит скидки полностью исчерпан (значение по-умолчанию), No limits – игнорировать лимит скидки
  • Defaulter Type Code as = Defaulter type code – интерпретация кода неплательщика: Defaulter type code – использовать как код типа неплательщика (значение по-умолчанию), Currency subaccount base – добавка к номеру субсчёта, т.е. для разных карт будут добавляться разные числа (коды) к номеру субсчета
  • в меню менеджерской "Сервис"  "Интерфейсы" выбрать логический интерфейс "Персональная дисконтная система(ПДС)" и проверить установленные соответствия для кассовых серверов и ПДС-интерфейсов затем перезагрузить кассовый сервер

Рис. Свойства логического интерфейса "Персональная дисконтная система(ПДС)"

  • в меню менеджерской "Сервис"  "Обработка сигналов устройств"  "MCR алгоритмы" настроить MCR-алгоритм

MCR алгоритм ПДС должен иметь область «Интерфейс», объект – предустановленный логический интерфейс "Персональная дисконтная система (ПДС)"

Параметр MCR алгоритма – строка, содержащая код карты в десятичном виде, если считывающее устройство передаёт код в шестнадцатеричном виде, его надо преобразовать в десятичный с помощью функций inttostr и strtoint. Например: Parameter:=inttostr(strtoint(‘$’+Parameter)).

Рис. Параметры MCR-алгоритма для использования с ПДС-интерфейсом

Допускается использование карт сотрудников в качестве карт ПДС - в этом случае должно быть два MCR алгоритма: один с областью "Интерфейс", другой с областью "Работник". В редакторе заказа MCR алгоритм «работник» будет игнорироваться, если не входить в форму «временная регистрация».

Подробнее про MCR алгоритмы см. документ Настройка MCR алгоритмов http://support.ucs.ru/ru/node/8055

 

Оплата и пополнение карт ПДС на кассе РК7

Для возможности оплаты и пополнения карт ПДС на кассе RK7 необходимо:

  • запустить менеджерскую станцию, открыть меню "Настройки" ⇒ "Параметры" и перейти в раздел [Параметры работы станции] - [Редактирование заказа] - [Расчёт/Оплата заказа]
  • выбрать параметр "Оплата платежной картой" и выбрать для свойства "Значение" вариант "Спрашивать":

Рис. Свойства параметра "Оплата платежной картой"

 

  • в меню менеджерской "Деньги" ⇒ "Валюты" выбрать валюту для ПДС и в свойстве "Интерфейс" указать логический интерфейс ПДС, также установить свойство "Код транзакции" в значение 0.

Примечание: секция "Интерфейс" доступна только для дилеров

Рис. Свойства валюты для ПДС

Важно: Параметр "Интерфейс необходим" в версиях 7.5.3.260 и выше исключен.

  • в меню менеджерской "Деньги" ⇒ "Скидки и Наценки" создать суммовую наценку , которая будет использоваться при пополнении карты, установить свойство "Код транзакции" в значение 0

Примечание: секция "Интерфейс" доступна только для дилеров

Рис. Свойства наценки для пополнения карт ПДС

  • в меню менеджерской "Деньги" ⇒ "Причины внесения/выдачи денег" создать причину и заполнить следующие свойства:
    • Пополнение баланса - Фискальное
    • Внесение денег - Да
    • Наценка - выбрать наценку, созданную на предыдущем этапе

Рис. Свойства причины внесения/выдачи денег для пополнения карт ПДС

  • чтобы внесенные суммы не отражались на фискальном регистраторе как внесение, в свойствах схемы печати "Пополнение баланса" для свойства "Класс осн. принтера" указать другой принтер либо выбрать вариант "Не печатать":

Рис. Свойства схемы печати "Пополнение баланса"

  • для печати макетов "Пополнение баланса" и "Изъятие денег с карты ПДС", необходимо сделать копии макетов "Пополнение баланса" и "Изъятие денег с карты ПДС", затем в свойствах выставить флаг "ТРЕНИРОВКА":

Рис. Свойства макетов "Пополнение баланса" и "Изъятие денег с карты ПДС"

  • считать карту на кассовой станции в режиме редактирования заказа - должно появиться окно с информацией по карте и ее владельцу (в данном примере карты нет в базе). 

Рис. Пример окна на кассовой станции RK7 после считывания карты ПДС

Примечание: если в редакторе карт у клиента есть фотография, а на кассе она не отображается, то необходимо в менеджерской станции РК7 включить параметр [Все] - [Установочные] - [Связь с другими системами] - [Персональные карточки] - [ПДС Показывать картинку].

 

Отладка взаимодействия кассового сервера RK7 по PDS-протоколу

В некоторых случаях может потребоваться отладка (расширенное логирование) взаимодействия кассового сервера RK7 (MIDSERV) по PDS-протоколу (Farcards, Cardserv).

 

Исходные условия для использования отладки:

  • версия pds_netk.dll должна быть не ниже 7.0.29.0 (актуальную версию библиотеки можно взять из любого текущего бинарного дистрибутива RK7 в каталоге  \bin\For cardserv)
  • при обновлении pds_netk.dll рекомендуется также обновлять набор сопутствующих библиотек (errors32.dll, Netkern.dll и т.д. - полный список см. выше)
  • библиотеки необходимо обновлять во всех рабочих каталогах, где они используются (RK7, Cardserv, Farcards и т.д.)

 

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

  • в конфигурационном файле FARCARDS.INI и/или CARDSERV.INI в секции [pds_netk] добавить параметр DebugMessages=1:
[pds_netk]
...
DebugMessages=1
...

 

  • в конфигурационном файле кассового сервера RKEEPER.INI в секции [Config] добавить параметр DebugMessages=34:
[Config]
...
DebugMessages=34
...

 

  • перезапустить все приложения (кассовый сервер, Farcards, Cardserv и т.д.)

 

Расширенное логирование будет фиксироваться в файле pds_netk.stk. 

При необходимости передать результат отладки (например, в службу поддержки) в дополнении к файлу pds_netk.stk также потребуются логи кассовой станции (cash.stk), кассового сервера (midsrv.stk), Farcards (Farcards.LOG) и/или Cardserv (Cardserv.log)