Подключение r_keeper
к Marketing CRM Pro
Настройки r_keeper
1
В редакторе СервисСтанции и устройства – на нужные кассовые сервера добавить «PDS Interfaсe»
PDS Server Name – Уникальное имя в сети, например «AKRK» (Регистр ВАЖЕН!!!).
Call timeout – время (в секундах) сколько касса будет ждать ответа от FarCard.

Остальные поля заполняются как показано на скриншоте.

Если в ресторане несколько кассовых серверов, то мы можем все их зацепить на одну копию FarCard. В этом случае «PDS Server Name» для «PDS Interfaсe» каждого кассового сервера делаем одинаковым.

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

ВАЖНО: В поле Pass ALL Bills XML data – рекомендуется выставить значение By script
2
Сервис - Скрипты – Группа «Анализ чека (системы лояльности)» - сделать новый скрипт с любым именем
В тело скрипта (Другое - SomeScript) вставить код:
procedure ReceiptXMLAnalysis1000710(AXMLReceiptParameters: TXMLReceiptParameters);
var p1 : Integer;
fullxml :String;
begin
    fullxml:=AXMLReceiptParameters.ReceiptXML;
    p1:=pos('<ITEM cardcode=""/>', fullxml);     
    If (p1 = 0) then
    AXMLReceiptParameters.DoTransfer := true
    else
    AXMLReceiptParameters.DoTransfer := false  
end;
Данный скрипт нужен для того что бы в FarCard передавалось содержимое только тех чеков, в которых была применена карта.
3
Сервис – Интерфейсы – Создать новый
Название – Любое осмысленное, например AKRK

Условие отправки XML заказа – выбрать скрипт созданный в п 2.
Файлы библиотек – проверить привязку Кассовых Серверов к PDS интерфейсам, созданным в п 1.

4
Сервис – Обработка сигналов устройств – MCR Алгоритмы. Создать 2 новых алгоритма.
Для поиска по «Номеру карты»:
Объект – это интерфейс созданный в п 3. (Область - Интерфейс)

Маска обработки – iiiiiii (7 знаков «i»).

Маска нужна для того что бы система не реагировала на номера введенные на кассе, но не подходящие под формат номера карты (7 знаков).

Для поиска карты по «Номеру телефона» создаем отдельный алгоритм:
В теле скрипта пишем:
function MCR1000047(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;
var RestCode: integer;
begin
 if length(Parameter) = 10 then  Result := true 
else       Result := false;
end;
5
Деньги – Скидки.
Завести скидку с любым названием, например «AKRK 0», и запомнить ее код.

В детализации скидки добавить нулевую детализацию (т.е. размер скидки всегда равен 0)

6
Деньги – Валюты – Завести валюту для оплаты бонусом и запомнить ее код.
ВАЖНО: Тип фискальности валюты доступен только под Дилерской учетной записью. Обычно выставляется в значение «Фискальная Скидка» (по требованиям 54-ФЗ).
7
После выполнения всех настроек необходимо перезапустить кассовый сервер RKeeper.
Настройки FarCard
Настройка FARCARDS.INI
[FarServer]
Type = 1 <-Обязательно 1!!!
DLL = akrk.dll <- Имя dll с таким же именем должен быть ini файл. Имя dll менять НЕ ЖЕЛАТЕЛЬНО!!!
Log = 10
XMLCP=1251
[LinkDLL]
3 = pds_netk
[pds_netk]
NetServerName=AKRK <-Имя интерфейса созданного в п1 при настройке RKeeper
ERRORLOG=pds_netk.stk
ININAME=netk.ini
PROTOCOLS=*.dll
Timeout=120000
DebugMessages=1

Настройка akrk.ini
Имя ini файла должно совпадать с именем dll!!!
;Так выглядит комментарий
[Log]
;уровень логирования. 0 (по умолчанию) - пишем все события, 1 - только важные (загрузка, ошибки и т.п.)
LogLevel=0
[Param]
;Адрес сервера куда слать запросы (обязательный параметр)
Server =https://office.akrk.info/exchange/
;restoID - идентификатор объекта (обязательный параметр)
restoID = 38
;key - "секретный" ключ добавляется ко всем запросам
key = de581240b40e8916b8ac3042cac4587c
;Время ожидания ответа от сервера в секундах (не обязательный, по умолчанию 10, перебивается настройками RKeeper)
TimeOut=10
;Код нулевой скидки в RKeeper
ZeroDiscCode=15
;Код бонусной валюты, которая используется для оплаты счетов бонусами
BonusPayCode=97
;Заглушка "ФИО" гостя для отображения в чеке и на экране кассира
GuestName=AKRK


Запуск FarCard
Farcards.exe /desktop – запуск в качестве консольного приложения
ВАЖНО: На старых версиях не проходит запрос к серверу по https
Ошибка выглядит так:
Решение.
В параметрах akrk.ini меняем адрес сервера на http://office.akrk.info/exchange/

После завершения установки рекомендуется:
- проверить отображение данных по карте и баланса на предчеке и фискальном чеке.
- настроить печать чека с балансом на принтере станции официанта
- настроить права для ввода номера карты или телефона через виртуальную клавиатуру

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

Настройка ограничения оплаты бонусами
Чтобы настроить ограничение по гашению бонусов в процентах от чека:

Работа на кассе
1. Открываем Заказ, в который нужно применить карту.

2. Вызвать диалог ввода номера карты:
a. Для Ресторана: Доп – Код с клавиатуры
b. Для Быстрого чека: Код с клавиатуры

3. В открывшемся окне ввести номер каты или номер телефона

4. Произойдет запрос данных по введенному номеру.
а. Если возникнет ошибка, она будет отображена в интерфейсе Кипера
b. Если все хорошо, то отобразится окно с информацией по карте
5. Для того что бы применить карту в заказ необходимо нажать в область с надписью «Картинка»