Настройка r_keeper [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Настройка r_keeper ======

**Важно!** Для работы с чеками намеренияя __при наличии двух фискальных регистраторов__ ProBonus корректно работает только в режиме "Единый чек перед оплатой".

===== PDS интерфейс =====
Редактор → Сервис → Станции и устройства → на закладке "Устройства" нужного кассового сервера добавить новый "PDS interface".
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-091311.png |}}
Для нового интерфейса заполнить следующие поля:
  - **PDS Server Name** - Уникальное (в рамках сети) имя. Регистр важен! Далее потребуется для настройки [[external:pro_bonus:02_rkeeper_setup:02_farcard|FarCards]].
  - **Look Up Card By Mail Addr** - Установить значение "Yes, error on not found". 
  - **Pass ALL Receipts XML data** - By script
  - **Authorize before transaction** - Compatible
  - **Pass ALL Bills XML data** - No
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-091620.png |}}

**Важно!** Система ProBonus может работать параллельно с другими системами лояльности. В этом случае на кассовом сервере добавляется несколько PDS интерфейсов с уникальными именами.
**Важно!** После добавления нового интерфейса необходимо перезапустить кассовый (mid) сервер что бы настройки вступили в силу.

===== Интерфейс =====
Редактор → Сервис → Интерфейсы → Добавить новый Интерфейс с именем "ProBonus", активировать и заполнить его свойства следующим образом:
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-093607.png |}}

**Важно!** Если в ресторане используется только одна система лояльности (ProBonus), то можно воспользоваться предустановленным интерфейсом "Персональная дисконтная система(ПДС)".
В случае если работает несколько систем лояльности параллельно - потребуется завести отдельный интерфейс.
   
===== MCR-Алгоритмы =====

Возможны различные варианты настройки, какие именно алгоритмы нужны в вашем случае - зависит от того, каким образом будет авторизация счёта/карты в заказ в r_keeper.
Авторизация возможна через магнитную карту, бесконтактную карту, ввод номера телефона, ввод номера карты вручную через "код с клавиатуры", через [[external:old:04_probonus_tbot:01_setup|динамический QR-код из телеграм-бота]] и т. д.
В простейшем случае, если используются только магнитные карты с  стандартной кодировкой (778=кодресторана=номеркарты) достаточно будет единственного MCR-алгоритма.
Если кроме этого используется [[external:old:04_probonus_tbot:01_setup|QR-код из телеграм-бота]], то добавляем ещё один алгоритм.
Если кроме этого используется ввод номера телефона через "код с клавиатуры", то добавляем ещё один алгоритм.
И так далее, для каждого способа авторизации - свой отдельный MCR-алгоритм, ссылающийся на интерфейс Probonus.

==== MCR-алгоритм для карт с магнитной полосой стандартной кодировки ====
Если используются физические карты стандартной кодировки (778=кодресторана=номеркарты), то можно скопировать предустановленный Mcr алгоритм. 
Редактор -> Сервис -> Обработка сигналов устройств -> Mcr алгоритмы. 
Выбрать и скопировать "Персональная дисконтная система(ПДС)" -> Новый Mcr алгоритм (копия) и установить следующие  параметры:
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-095518.png |}}

Типы устройств (Клавиатура, Магнитная карта, Штрих код) установить согласно тому оборудованию, которое используется для чтения карт в ресторане.

Если карты имеют нестандартную кодировку, то потребуется изменить Скрипт в MCR-алгоритме так, чтобы он выделял истинный номер из имеющейся кодировки.

==== MCR-алгоритм для ввода номера телефона через "код с клавиатуры" ====
Используется если разрешена авторизация гостей в заказе через номер телефона по кнопке "код с клавиатуры".
Это потенциально опасная настройка, возможны махинации персонала.
В данном примере представлен вариант алгоритма для номеров телефона из России (начинается с цифры 7, длина номера 11 цифр). Его можно изменить под свои условия при необходимости.
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221109-092203.png |}}
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221109-092435.png |}}
<hidden Код скрипта>
<code>
begin
  if (pos('7', Parameter) = 1) and (Length(Parameter) = 11) then 
        Result := true;  
end;
</code>
</hidden>


<hidden Код скрипта чуть сложнее, с возможностью ввода номера в любом формате>
<code>
begin
//простой вариант, с клавиатуры ввели номер в том виде в каком он хранится в ProBonus
  if (pos('7', Parameter) = 1) and (Length(Parameter) = 11) then 
        Result := true; 
        
//с клавиатуры ввели номер начинающийся с "+7", отрезаем "+" в начале       
  if (pos('+', Parameter) = 1) and (pos('7', Parameter) = 2) and (Length(Parameter) = 12) then
     begin   
        Delete(Parameter, 1, 1)
        Result := true;
     end;
     
//с клавиатуры ввели номер начинающийся с "8", меняем этот символ на "7"         
  if (pos('8', Parameter) = 1) and (Length(Parameter) = 11) then
     begin
        Parameter[1] := '7';
        Result := true; 
     end;

//с клавиатуры ввели номер вообще без префикса "7", "+7" или "8", добавляем в начале номера "7"   
  if (Length(Parameter) = 10) then
     begin
        Insert('7', Parameter, 1);
        Result := true; 
     end;
                             
end;
</code>
</hidden>

==== MCR-алгоритм для динамического QR-кода из телеграм-бота ====
Редактор -> Сервис -> Обработка сигналов устройств -> Mcr алгоритмы. 
Особенность - здесь нужно отметить  и чекбокс "штрихкод", и чекбокс "клавиатура", т. к. вместе с QR-кодом в телеграм-боте всегда доступен символьный код для ввода с клавиатуры.
Для виртуальной карты через Telegram бот с длиной временного кода 6 цифр (XXX-XXX), MCR будет выглядеть так:
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221107-102510.png |}}
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221107-102621.png |}}


<hidden Код скрипта>
<code>
  { ожидаем ХХХ-ХХХ }
  if (length(Parameter) = 7) and (pos('-', Parameter) = 4)  then Result := True
  else  Result := False
</code>
</hidden>

==== Универсальный MCR-алгоритм (не рекомендуется) ====
Приведённый ниже алгоритм будет направлять вообще любую полученную кассой информацию (карты, штрихкод и т. д.) на проверку в ProBonus.
Можно использовать при отладке, но лучше не оставлять в реальной работе - почти наверняка будет конфликтовать с другими системами лояльности, штрихкодами и т. д. 
Отредактировать скрипт MCR алгоритма так, чтобы он принимал любую введенную последовательность (Result := True;) и отправлял ее далее на проверку в систему ProBonus:
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-100257.png |}}
Приведенный пример MCR алгоритма будет принимать любую последовательность символов (штрих-код, магнитную карту, код с клавиатуры) в качестве подходящего идентификатора для системы лояльности ProBonus. Если в ресторане работает параллельно несколько разных систем лояльности, то необходимо вместо универсального MCR-алгоритма, создать алгоритм(ы) с более точными условиями по маске.


При использовании универсального MCR-алгоритма, если в ресторане используется несколько систем лояльности и введенный идентификатор удовлетворяет правилам 2 (или более), то сотруднику на кассе будет предложен выбор, в какую систему лояльности отправить запрос для поиска гостя.
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221107-131005.png?800 |}}
----

===== Скидки и Бонусы =====
Скидки и Бонусы, с которыми будет работать система ProBonus, создаются штатными средствами Редактор -> Деньги -> Скидки и Наценки. Т.е. точно так же как и при работе с PDS, CRM и Loyalty.

Когда на кассе применяют карту ProBonus - в заказ добавляется соответствующая скидка. При этом, следует помнить, что на эту скидку так же действуют все правила и ограничения (расписание, уровень доступа, суммовые ограничения, настройки композиции с другими скидками и т.п.) заведенные для нее в редакторе r_keeper.

==== Нулевая скидка ====
Одной из особенностей работы технологии FarCard является необходимость использования "нулевой" скидки (т.е. скидка добавляется в заказ, но не влияет на его сумму). Например, когда карта является только платежной (кредитной или дебетовой).
Поэтому нужно **обязательно** завести такую "техническую" скидку.
Редактор -> Деньги -> Скидки и Наценки -> Создать новую скидку с "нейтральным" названием (например, "Карта ProBonus") и настроить ее свойства следующим образом:
{{ :external:pro_bonus:02_rkeeper_setup:20221009-102719_1.png |}}
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-102724.png |}}

Далее необходимо указать КОД данной скидки [[https://wiki.carbis.ru/external/pro_bonus/01_setup/04_rkeeper#настройка_связи_с_r_keeper|в настройках системы ProBonus]].

{{ :external:pro_bonus:02_rkeeper_setup:2024-12-11_14-21-13.png |}}

==== Настройка бонуса ====
1) Создать тип бонуса. Перейти в Деньги - Типы бонусов. В открывшемся окне ПКМ - Новый тип бонуса.
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20230421-123909.png |}}
2) Перейти в Деньги - Скидки и наценки. Добавить новую скидку или отредактировать имеющуюся. Во вкладке "Детализация" создать детализацию и указать ранее созданный тип бонуса.
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20230421-124006.png |}}
3) Не забываем указать процент бонуса у валюты, при оплате которой будут начисляться бонусы
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20230421-123707.png |}}

==== Скидка для "Товарных купонов" и акции "Штампики" (опционально) ====
Если в вашем ресторане используются акции "Штампики" или/и "Товарных купонов", то необходимо добавить скидку.
Для каждой акции создаётся отдельная скидка со следующими настройками:
  * Комбинировать с любой скидкой
  * На блюдо
  * Не вручную
  * В детализации - скидка 100%

{{ :external:pro_bonus:02_rkeeper_setup:pasted:20231129-112419.png |}}
Детализация скидки 
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20231129-112301.png |}}

==== Скидка и бонус одновременно (опционально) ====
Создаётся скидка с одной детализацией, у которой задан процент скидки и процент бонуса
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20240726-104613.png |}}

===== Передача изображения в карточку гостя на кассе =====
Передача доступна с версий ProBonus v1.2.14.95, Farcards v1.0.0.8.
На текущий момент передаётся картинка вида:
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20240304-073940.png |}}
Возможность прикреплять индивидуальную картинку (или фото) к каждому счёту - отсутствует.
Само изображение можно изменить в папке img в корневой папке, куда установлен Probonus.
Обязательно изменить название картинки на pb_img.
{{ :external:pro_bonus:02_rkeeper_setup:2024-03-01_17-29-45.png? }}
Для того, что бы передача изображения работала нужно сделать дополнительные настройки в Менеджерской станции R-Keeper.
Перейти в "Настройки"->"Параметры"->"Установочные"->"Связь с другими системами"->"Персональные карты"->"ПДС Показывать картинку". В свойствах во вкладке "Основные" установить галочку напротив параметра "Логический".
{{ :external:pro_bonus:02_rkeeper_setup:2024-03-01_17-14-37.png? }}


====== Настройка валюты ======
Если система ProBonus используется только для скидок, то создавать и настраивать валюту нет необходимости. 
В случае же с депозитами или бонусами - нужно настраивать.
Свойства валюты задаются такие же, как и для обычной валюты ПДС оплата. 
**Важно:** 
- **Тип фискальности**. В случае если средства с баланса счёта в ProBonus используются для не фискальных оплат, нужно указать "печатать скидку". Мы не рекомендуем в общем случае настройки "Суммарно с вычитанием", "Не печатать чек", "Фискальная скидка".
- **Не учитывать в потратах ПДС**. Для правильного учёта потрат с бонусного баланса, мы рекомендуем оставить чек-бокс пустым. В противном случае некоторые отчёты в интерфейсе ProBonus будут формироваться неправильно.
{{ :external:pro_bonus:02_rkeeper_setup:20240328-091452.png }}