====== Настройка 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:pro_bonus:03_probonus_work:01_webadmin:30_bot_probonus|динамический QR-код из телеграм-бота]] и т. д.
В простейшем случае, если используются только магнитные карты со стандартной кодировкой (''778=кодресторана=номеркарты''), достаточно будет единственного MCR-алгоритма. Если кроме этого используется [[external:pro_bonus:03_probonus_work:01_webadmin:30_bot_probonus|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 |}}
begin
if (pos('7', Parameter) = 1) and (Length(Parameter) = 11) then
Result := true;
end;
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;
==== 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 |}}
{ ожидаем ХХХ-ХХХ }
if (length(Parameter) = 7) and (pos('-', Parameter) = 4) then Result := True
else Result := False
==== MCR-алгоритм для динамического Apple Wallet ====
{{:external:pro_bonus:02_rkeeper_setup:pasted:20260413-154621.png}}
{{:external:pro_bonus:02_rkeeper_setup:pasted:20260413-154724.png}}
begin
if (length(Parameter) = 8) and (pos('D', Parameter) = 1) then Result := True
else Result := False
end;
==== Универсальный MCR-алгоритм (не рекомендуется) ====
Приведённый ниже алгоритм будет направлять вообще любую полученную кассой информацию (карты, штрихкод и т. д.) на проверку в ProBonus. Можно использовать при отладке, но лучше не оставлять в реальной работе — почти наверняка будет конфликтовать с другими системами лояльности, штрихкодами и т. д.
Отредактируйте скрипт MCR-алгоритма так, чтобы он принимал любую введённую последовательность (''Result := True;'') и отправлял её далее на проверку в систему ProBonus:
{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-100257.png |}}
Приведённый пример MCR-алгоритма будет принимать любую последовательность символов (штрихкод, магнитную карту, код с клавиатуры) в качестве подходящего идентификатора для системы лояльности ProBonus. Если в ресторане параллельно работает несколько разных систем лояльности, то вместо универсального MCR-алгоритма необходимо создать алгоритм(ы) с более точными условиями по маске.
При использовании универсального MCR-алгоритма, если в ресторане используется несколько систем лояльности и введённый идентификатор удовлетворяет правилам двух (или более), сотруднику на кассе будет предложен выбор, в какую систему лояльности отправить запрос для поиска гостя.
{{ :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 |}}
Далее необходимо указать код данной скидки [[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 }}