База знаний

инструкция по настройке farcards для работы с MCRM Superkit

Интеграция с r_keeper

Скачать farcards

PDS Interfaсe

На нужные кассовые сервера добавляем «PDS Interfaсe».

«PDS Server Name» – уникальное имя в сети, например «AKRK».
! Регистр важен.

«Call timeout» – время в секундах, которое касса будет ждать ответа от FarCard. Рекомендуемое значение=60


! В поле «PassALLBillsXMLdata» рекомендуется выставить значение «Byscript».

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

Сервис

→ Интерфейсы

→ Создать новый

Название произвольное, например, «AKRK».
В «Файлах библиотек» проверить привязку кассовых серверов к PDS интерфейсам, созданным на предыдущем шаге.

Сервис

→ Станции и устройства

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

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

ШАГ 1 ИЗ 11

ШАГ 2 ИЗ 11

Создание интерфейса

ШАГ 3 ИЗ 11

Сервис

→ Обработка сигналов устройств

→ MCR Алгоритмы

Объект – интерфейс, созданный в 3 шаге.

Область – Интерфейс.
Маска обработки – iiiiiii (7 знаков «i»).

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

Создание MCR алгоритмов

ШАГ 4 ИЗ 11

В теле скрипта пишем код:

function MCR1000047(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;
var RestCode: integer;
beginif length(Parameter) = 10 then Result := true
else Result := false;
end;

Алгоритм для поиска по «Номеру карты»:

Алгоритм для поиска по «Номеру телефона»:

Настройка скидки

Завести скидку с произвольным названием, например, «AKRK 0».
Запомнить ее код.

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

Деньги

→ Валюта

Завести валюту для оплаты бонусом.
Запомнить ее код.

! Тип фискальности валюты доступен только под дилерской учетной записью. Обычно выставляется в значение «Фискальная Скидка» (по требованиям 54-ФЗ).

Деньги

→ Скидки

ШАГ 5 ИЗ 11

Настройка валюты

ШАГ 6 ИЗ 11

Работники

Проверить, что у сотрудника есть право на операцию: «Предварительно персонализированные валюты».

Доступ сотрудников

ШАГ 7 ИЗ 11

После выполнения всех настроек необходимо перезапустить кассовый сервер R-Keeper.

Перезапуск r_keeper

ШАГ 8 ИЗ 11

Настройки FarCard

Настройка 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=300000
DebugMessages=1

Настройка akrk.ini

Имя 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.

Запуск в качестве консольного приложения

Farcards.exe /desktop

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

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

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

Настроить права для ввода номера карты или телефона через виртуальную клавиатуру.

! При возникновении ошибки (см. скриншот) на старой версии, где не проходит запрос к серверу по https, нужно в параметрах akrk.ini поменять адрес сервера с «https://» на «http://».

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

ШАГ 9 ИЗ 11

Настройка передачи товарных категорий в MCRM

ШАГ 10 ИЗ 11

Запуск FarCards

Работа на кассе

ШАГ 11 ИЗ 11

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

Вызвать Диалог ввода номера карты.

Для Ресторана: Доп – Код с клавиатуры.

Для Быстрого чека: Код с клавиатуры.

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

Произойдет запрос данных по введенному номеру.

Если возникнет ошибка, она будет отображена в интерфейсе Кипера.

Если все хорошо, то отобразится окно с информацией по карте.

Для того чтобы применить карту в заказ, необходимо нажать в область с надписью «Картинка».

ОТВЕТЫ НА ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ