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

MCRM:

СКАЧАТЬ FARCARDS:

Шаг 1:

В редакторе Сервис – Станции и устройства – на нужные кассовые сервера добавить «PDS Interfaсe»
1

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

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

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

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

Если в ресторане используется собственная дисконтная система, то мы добавляем дополнительные интерфейсы.
ВАЖНО:
В поле PassALLBillsXMLdata – рекомендуется выставить значение Byscript
Сервис – Интерфейсы – Создать новый
Сервис – Обработка сигналов устройств – MCR Алгоритмы
3
Название – Любое осмысленное, например AKRK.

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

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

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

Маска нужна для того что бы система не реагировала на номера введенные на кассе, но не подходящие под формат номера карты (7 знаков).
Для поиска карты по «Номеру телефона» создаем отдельный алгоритм:
В теле скрипта пишем код, указанный ниже.
2
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
Завести скидку с любым названием, например «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!!!
[PARAMS]
;URL для отправки запросов
BaseURL=https://***.marketingcrm.online/cashapi/
;Cекретный API ключ
RegKey=***
[DISCOUNT]
;Код нулевой скидки из справочников rk7
Discount=*
[LOG]
LogLevel=10
OldLogs=7
LogMem=1

BaseURL и RegKey - необходимо получить от клиента Или сотрудника MCRM

7
4
6
Работники
Проверить, что у сотрудника есть право на операцию:
предварительно персонализированные валюты

Шаг 2:

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

запуск FarCard

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

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

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

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

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

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

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

а. Если возникнет ошибка, она будет отображена в интерфейсе Кипера
Для того что бы применить карту в заказ необходимо нажать в область с надписью «Картинка».
b. Если все хорошо, то отобразится окно с информацией по карте
Частые вопросы и ответы:
Ошибка обращения к Серверу! ResultCode 301
При данной ошибке нужно проверить akrk.ini на правильность ввода:
1) url сервера. Он должен быть вида: https://***.marketingcrm.online/cashapi/
2) Проверить REGKEY
На пречеках не отображается информация о клиенте и его бонусном балансе
Заполните в "макете предчека" поля аналогично скриншоту
Не выходит предчек с информацией о бонусной карте и остатке бонусного баланса
Проверьте что в настройках валюты выставлена галочка: "Печатать нулевые"
Ошибка 2088. Не получается напечатать чек. Заказ зависит от связи с интерфейсом AKRK, который сейчас не доступен. Восстановите связь с интерфейсом для того чтобы открыть заказ. Или свяжитесь со службой тех. поддержки
Проверьте правильность настройки Шага 1 пункта 1 текущей инструкции. Интерфейс должен быть привязан к кассовому серверу
Ошибка при авторизации карты "По вашему запросу "номер карты" ничего не найдено. Пожалуйста, попытайтесь снова с другими ключевыми словами".
Необходимо проверить mcr-алгоритм, проверить маску: (iiiiiii). Кол-во знаков i должно соответствовать разрядности номеров карт в MCRM.
Отправить данные для получения лицензии Apple.

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