Настройка интеграции с r_keeper

👉🏻 Настройка:

👉🏻 Интерфейс

Регистр важен!

Рекомендуемое значение 60-120 сек.

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

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

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

Маска обработки – iiiiiii (кол-во знаков «i» по дефолту 7, но у клиента может быть нумерация карт с другой разрядностью. Необходимо этот момент уточнить у сотрудников MCRM в чат-боте Поддержки).

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;

function MCR1000648(DeviceSignal: Integer; DeviceIdent: Integer; var Parameter: String): Boolean;
var
  PROMO_PREFIX: String;
  PROMO_POSTFIX: String;
  
  have_prefix:boolean;
  have_postfix:boolean;
begin                                                                                            
  PROMO_PREFIX := 'ZN';
  PROMO_POSTFIX := 'XX';
  
  have_prefix := pos(PROMO_PREFIX, Parameter) > 0;
  have_postfix := (pos(PROMO_POSTFIX, Parameter) = Length(Parameter) - Length(PROMO_POSTFIX) + 1);
  
  //Uncomment suitable
  
  //prefix only
  Result := have_prefix;
  
  //postfix only
  //Result := have_postfix;
  
  //both
  //Result := have_prefix and have_postfix;
end;

Чаще всего используется только префикс. Промокоды имеют примерно такой вид: ZN12345.

При создании промокодов маркетологи определяют префикс, который нужно будет задать в 9 строке скрипта.
Или поступить от обратного, задать в скрипте префикс, который будут использовать маркетологи при создании промокодов.

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

Для акционной валюты дополнительно установить два параметра в группе "Интерфейс":
Код транзакции - 6
Субсчет FarCards - 2

Выберите готовый шаблон по ссылке

farcards.ini
Type = 1 - обязательно!
DLL = mcrm.dll - с таким же именем должен быть и ini-файл. Имя dll менять нельзя!
NetServerName=MCRM - имя интерфейса, созданного в Шаге 1.

mcrm.ini
BaseURL=
ApiKey=
ExtraAccountId=
- эти данные необходимо получить у сотрудников в MCRM.
UseWriteoffApprovement=0
параметр для вкл./выкл. верификации клиента при списании бонусов (0 - не отправлять смс, 1 - отправлять смс с кодом)
ZeroDiscountCode=8 - код скидки из пункта "а" Шага 4.

Для механизма верификации клиента (WriteoffApprovement) существуют ещё 2 скрытых параметра, которые устанавливают время, через которое можно отправить проверочный код повторно и задать кастомный шаблон текста смс с подтверждением. При необходимости запросите их в боте нашей поддержки

Запуск

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

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

При возникновении ошибки, при которой FarCards не находит mcrm.dll (DLL not found: mcrm.dll) нужно установить пакет Visual C++ для Visual Studio 2015

Инсталлятор содержится в архиве со сборкой FarCards

Интерфейс

Списание бонусов осуществляется только с одного из счетов.

Начисление бонусов осуществляется всегда только на основной счет (MCRM Кешбэк).

Промокод добавляется в заказ только после добавления клиента.

Бонусная фича

mcrm.ini

Для отключения передачи номера телефона и email в расширенные свойства заказа и отключения отправки чеков через ОФД в конфиг-файле изменить параметры:

PassGuestPhoneOnAuth - отключение телефона
PassGuestEmailOnAuth - отключение email
принимают значения 0 и 1

0 - отключить

Удачного вам запуска и больших выручек!

Инструкция для официантов

Установите "сервис автоматической авторизации карт" для r_keeper

Рекомендуется для ресторанов с официантами.