В редакторе Сервис – Станции и устройства – на нужные кассовые сервера добавить «PDS Interfaсe»
1
настройки R-Keeper
PDS Server Name – Уникальное имя в сети, например «AKRK» (Регистр ВАЖЕН!!!).
Call timeout – время (в секундах) сколько касса будет ждать ответа от FarCard. Остальные поля заполняются как показано на скриншоте.
Если в ресторане несколько кассовых серверов, то мы можем все их зацепить на одну копию FarCard. В этом случае «PDS Server Name» для «PDS Interfaсe» каждого кассового сервера делаем одинаковым.
Если в ресторане используется собственная дисконтная система, то мы добавляем дополнительные интерфейсы.
ВАЖНО: В поле PassALLBillsXMLdata – рекомендуется выставить значение Byscript
Файлы библиотек – проверить привязку Кассовых Серверов к 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.