База знаний
Поддержка
База знаний MCRM

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

Скачайте полную сборку Farcards MCRM.
Шаг 1. PDS Interface
На нужные кассовые сервера добавляем «PDS Interface».
«PDS Server Name» – уникальное имя в сети (например, «MCRM»).
Регистр важен!
«Call timeout» – время в секундах, которое касса будет ждать ответа от FarCard.
Рекомендуемое значение 60-120 сек.
В поле «PassALLBillsXMLdata» выставить значение «Byscript».

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

Если в ресторане используется собственная дисконтная система, то мы добавляем дополнительные интерфейсы.
Шаг 2. Создание интерфейса
Название произвольное, например, "MCRM".
В «файлах библиотек» проверить привязку кассовых серверов к PDS интерфейсам, созданным на предыдущем шаге.
Шаг 3. Создание MCR алгоритмов
а. Алгоритм для поиска по номеру карты.
Объект – интерфейс, созданный во 2-м шаге.
Область – Интерфейс.
Маска обработки – iiiiiii (кол-во знаков «i» по дефолту 7, но у клиента может быть нумерация карт с другой разрядностью. Необходимо этот момент уточнить у сотрудников MCRM в чат-боте Поддержки).
Сразу добавим скрипт для промокодов:
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 строке скрипта.
Или поступить от обратного, задать в скрипте префикс, который будут использовать маркетологи при создании промокодов.
б. Алгоритм для поиска по номеру телефона.
В теле скрипта прописать код:
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;
Шаг 4. Настройка скидок
а. Скидка для кешбэка.
Завести скидку с произвольным названием, например, "MCRM".
Запомнить ее код.
В "Детализации" добавить нулевую детализацию. Т.е. размер скидки всегда равен 0.
б. Скидка для промокода.
Завести еще одну скидку с произвольным названием, например, "MCRM Промокод".
Эта скидка будет использоваться при применении промокодов на "Подарочное блюдо".
В "Детализации" добавить 100% детализацию. Т.е. размер скидки всегда равен 100%.
Ограничить область действия "На блюдо" и "Не вручную".
Задать значение созданной скидки ("MCRM Промокод").
Шаг 5. Настройка валют
а. Валюта для кешбэка.
Завести валюту для оплаты бонусами для основного (дефолтного) бонусного счета.
Задать для валюты название, например, "Бонусы кешбэк".
Тип фискальности валюты доступен только под дилерской учетной записью. Обычно выставляется в значение «Фискальная Скидка» (по требованиям 54-ФЗ).
б. Валюта для дополнительного "акционного" бонусного счета.
Копируем валюту из предыдущего пункта, задаем название, например, "Бонусы акции".
Для акционной валюты дополнительно установить два параметра в группе "Интерфейс":
Код транзакции - 6
Субсчет FarCards - 2
Шаг 6. Доступ для сотрудников
В подразделе "Ограничения" выставить галочку в пункте "Предварительно персонализированные валюты".
Шаг 7. Настройка передачи в MCRM товарных категорий
Выставить галочку в пункте "Использовать в отчетах" или:
В свойствах параметра "Классификация для КДС и VDU" в пункте "Ссылка" выберете ту классификацию, которая будет передаваться с товаром в MCRM в качестве товарной категории.
Шаг 8. Настройка макета пречека
Пример настройки блока "Инфо о карте", в котором выводится максимально возможная сумма списания по обоим бонусным счетам.
Воспользуйтесь файлом-шаблоном макета пречека
Шаг 9. Настройка конфиг-файлов
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.
При применении промокода показывается карточка клиента и надпись в секции "Сообщение" об активации промокода. После этого в заказ добавляется блюдо со 100% скидкой.
Промокод добавляется в заказ только после добавления клиента.

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

Если у клиента в MCRM заполнено поле EMAIL, то оно автоматически добавится в "Пользовательские свойства заказа".
Данная опция позволяет отправить электронный чек клиенту на e-mail.

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

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

По всем возникшим вопросам при настройке обращайтесь к нам через Телеграм.
2023-10-06 12:49 Инструкции