подключение
R-Keeper
к Marketing CRM Pro

MCRM:

СКАЧАТЬ FARCARDS:

Шаг 1:

В редакторе Сервис – Станции и устройства – на нужные кассовые сервера добавить «PDS Interfaсe»
Сервис - Скрипты – Группа «Анализ чека (системы лояльности)» - сделать новый скрипт с любым именем
1

настройки
R-Keeper

2
PDS Server Name – Уникальное имя в сети, например «AKRK» (Регистр ВАЖЕН!!!).

Call timeout – время (в секундах) сколько касса будет ждать ответа от FarCard.
Остальные поля заполняются как показано на скриншоте.

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

Если в ресторане используется собственная дисконтная система, то мы добавляем дополнительные интерфейсы.
ВАЖНО:
В поле PassALLBillsXMLdata – рекомендуется выставить значение Byscript
В тело скрипта (Другое - SomeScript) вставить код, указанный ниже.

Данный скрипт нужен для того что бы в FarCard передавалось содержимое только тех чеков, в которых была применена карта.
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;
Сервис – Интерфейсы – Создать новый
Сервис – Обработка сигналов устройств – MCR Алгоритмы
3
4
Название – Любое осмысленное, например AKRK.

Условие отправки XML заказа – выбрать скрипт созданный в п 2.

Файлы библиотек – проверить привязку Кассовых Серверов к PDS интерфейсам, созданным в п 1.
Создать 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;
После выполнения всех настроек необходимо перезапустить кассовый сервер RKeeper.
Настройки FarCard
Деньги – Скидки
Деньги – Валюты
5
6
7
Завести скидку с любым названием, например «AKRK 0», и запомнить ее код.

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

Тип фискальности валюты доступен только под Дилерской учетной записью. Обычно выставляется в значение «Фискальная Скидка» (по требованиям 54-ФЗ).
Завести валюту для оплаты бонусом и запомнить ее код.
Настройка akrk.ini
Настройка FARCARDS.INI
[FarServer]
Type = 1 <-Обязательно 1!!!
DLL = akrk.dll <- Имя dll с таким же именем должен быть ini файл. Имя dll менять НЕ ЖЕЛАТЕЛЬНО!!!
Log = 1
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
Имя 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

Шаг 2:

Farcards.exe /desktop – запуск в качестве консольного приложения.
Настройка передачи товарных категорий в MCRM
1

запуск FarCard

2
В параметрах akrk.ini меняем адрес сервера на

http://office.akrk.info/exchange/

После завершения установки рекомендуется:

- проверить отображение данных по карте и баланса на предчеке и фискальном чеке;

- настроить печать чека с балансом на принтере станции официанта;

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

Ошибка выглядит так (см. фото).
Решение:
Настройка ограничения оплаты бонусами
3
Чтобы настроить ограничение по гашению бонусов в процентах от чека.
Работа
на кассе
4
Открываем Заказ, в который нужно применить карту.
Вызвать диалог ввода номера карты:

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

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

Apple требует, чтобы были заполнены все поля в данной форме.
Название юридического лица
ФИО
контактное лицо от вашего бизнеса, на чье имя и телефон поступит звонок от Apple с целью подтверждения намерений работать с AppleWallet
Должность
Email
Телефон
Дата рождения
Точное написание имени как на банковской карте
Номер банковской карты
Важно, с банковской карты позднее будет произведена оплата 99$ в Apple (ежегодный платёж)
Абсолютно безопасно.
Ваши данные будут использованы только для подачи заявки в Apple.