БАЗА ЗНАНИЙ
инструкция по настройке farcards для работы с MCRM Superkit
Интеграция с r_keeper
Скачать farcards
PDS Interfaсe
На нужные кассовые сервера добавляем «PDS Interfaсe».

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

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

! В поле «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=120000
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
Открыть заказ, в который нужно применить карту.
Вызвать Диалог ввода номера карты.
Для Ресторана: Доп – Код с клавиатуры.
Для Быстрого чека: Код с клавиатуры.
В открывшемся окне ввести номер карты или номер телефона.
Произойдет запрос данных по введенному номеру.
Если возникнет ошибка, она будет отображена в интерфейсе Кипера.
Если все хорошо, то отобразится окно с информацией по карте.
Для того чтобы применить карту в заказ, необходимо нажать в область с надписью «Картинка».
ОТВЕТЫ НА ЧАСТО ЗАДАВАЕМЫЕ ВОПРОСЫ
Ошибка обращения к Серверу! ResultCode 301.
При данной ошибке необходимо проверить akrk.ini на правильность ввода:
1) URL сервера должен быть вида: «https://***.marketingcrm.online/cashapi/».
2) Проверить REGKEY.
На пречеках не отображается информация о клиенте и его бонусном балансе.
Заполните в «макете предчека» поля, как указано на скриншоте.
Не выходит предчек с информацией о бонусной карте и остатке бонусного баланса.
Проверьте, что в настройках валюты выставлена галочка «Печатать нулевые».
Не получается напечатать чек (ошибка 2088). Заказ зависит от связи с интерфейсом AKRK, который сейчас недоступен. Восстановите связь с интерфейсом, для того чтобы открыть заказ, или свяжитесь со службой техподдержки.
Проверьте правильность настройки 1 шага. Интерфейс должен быть привязан к кассовому серверу.
Ошибка при авторизации карты: «По вашему запросу «номер карты» ничего не найдено. Пожалуйста, попытайтесь снова с другими ключевыми словами».
Необходимо проверить MCR алгоритм, проверить маску: (iiiiiii). Кол-во знаков i должно соответствовать разрядности номеров карт в MCRM.