Настройка связи RK7 с ПДС

Печать
PDF

Общая информация

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

 

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

Установка и настройка системы ПДС подробно описана в документе 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  скопировать в рабочую директорию сервера карт следующие файлы:
  • borlndmm.dll
  • dllman.dll
  • errors32.dll
  • Netkern.dll
  • thread32.dll
  • pds_netk.dll
  • TCPSOC.dll
  • Thread32.dll
  • netk.ini - необязательный файл, расположен в директории \bin\For cardserv\ini\

 

  • настроить конфигурационный файл сервера карт CARDSERV.INI:
  • Добавить в секцию [LinkDLL] библиотеку связи pds_netk.dll для взаимодействия с RK7:
[LinkDLL]
...
3 = pds_netk
  • Добавить секцию [pds_netk] с параметрами библиотеки pds_netk.dll:
[pds_netk]

NetServerName=TEST_PDS_NETKERN - сетевое имя сервера карт, то же имя должно быть вписано в свойствах 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) и проверить статус загруженных библиотек связи:

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

 

Настройка редактора карт (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\

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

 

  • настроить конфигурационный файл редактора карт 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

 

  • запустить редактор карт и проверить доступность скидок и бонусов в режиме редактирования карты

 

 

Настройка 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 после считывания карты ПДС

 

joomla