Различия

Показаны различия между двумя версиями страницы.

--- external:pro_bonus:02_rkeeper_setup:01_rkeeper [2024/07/26 07:16] – Евгений Агеев
+++ external:pro_bonus:02_rkeeper_setup:01_rkeeper [2026/10/22 06:16] (текущий) – Исправлены орфография, пунктуация и оформление; ссылки на старую страницу бота заменены на 30_bot_probonus Алексей Коробов
@@ Строка 1: / Строка 1: @@
 ====== Настройка r_keeper ======
+**Важно!** Для работы с чеками намерения __при наличии двух фискальных регистраторов__ ProBonus корректно работает только в режиме «Единый чек перед оплатой».
 ===== PDS интерфейс =====
-Редактор → Сервис → Станции и устройства → на закладке "Устройства" нужного кассового сервера добавить новый "PDS interface".
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-091311.png}}
-Для нового интерфейса заполнить следующие поля:
-  - **PDS Server Name** - Уникальное (в рамках сети) имя. Регистр важен! Далее потребуется для настройки FarCard.
-  - **Look Up Card By Mail Addr** - Установить значение "Yes, error on not found".
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-091620.png}}
-**Важно!** Система ProBonus может работать параллельно с другими системами лояльности. В этом случае на кассовом сервере добавляется несколько PDS интерфейсов с уникальными именами.
+**Редактор → Сервис → Станции и устройства** → на закладке **Устройства** нужного кассового сервера добавьте новый **PDS interface**.
-**Важно!** После добавления нового интерфейса необходимо перезапустить кассовый (mid) сервер что бы настройки вступили в силу.
+{{ :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), то можно воспользоваться предустановленным интерфейсом "Персональная дисконтная система(ПДС)".
+**Редактор → Сервис → Интерфейсы** → добавьте новый интерфейс с именем ''ProBonus'', активируйте его и заполните его свойства следующим образом:
-В случае если работает несколько систем лояльности параллельно - потребуется завести отдельный интерфейс.
-===== MCR-Алгоритмы =====
-Возможны различные варианты настройки, какие именно алгоритмы нужны в вашем случае - зависит от того, каким образом будет авторизация счёта/карты в заказ в r_keeper.
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-093607.png |}}
-Авторизация возможна через магнитную карту, бесконтактную карту, ввод номера телефона, ввод номера карты вручную через "код с клавиатуры", через [[external:old:04_probonus_tbot:01_setup|динамический QR-код из телеграм-бота]] и т. д.
-В простейшем случае, если используются только магнитные карты с  стандартной кодировкой (778=кодресторана=номеркарты) достаточно будет единственного MCR-алгоритма.
+**Важно!** Если в ресторане используется только одна система лояльности (ProBonus), то можно воспользоваться предустановленным интерфейсом «Персональная дисконтная система (ПДС)». В случае, если работает несколько систем лояльности параллельно, потребуется завести отдельный интерфейс.
-Если кроме этого используется [[external:old:04_probonus_tbot:01_setup|QR-код из телеграм-бота]], то добавляем ещё один алгоритм.
-Если кроме этого используется ввод номера телефона через "код с клавиатуры", то добавляем ещё один алгоритм.
+===== MCR-алгоритмы =====
-И так далее, для каждого способа авторизации - свой отдельный MCR-алгоритм, ссылающийся на интерфейс Probonus.
+Возможны различные варианты настройки. Какие именно алгоритмы нужны в вашем случае, зависит от того, каким образом будет авторизация счёта/карты в заказ в 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}}
-Типы устройств (Клавиатура, Магнитная карта, Штрих код) установить согласно тому оборудованию, которое используется для чтения карт в ресторане.
+Если используются физические карты стандартной кодировки (''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 |}}
-Если карты имеют нестандартную кодировку, то потребуется изменить Скрипт в MCR-алгоритме так, чтобы он выделял истинный номер из имеющейся кодировки.
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221109-092435.png |}}
-==== 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}}
+**Редактор → Сервис → Обработка сигналов устройств → 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-алгоритм для динамического Apple Wallet ====
+{{:external:pro_bonus:02_rkeeper_setup:pasted:20260413-154621.png}}
+{{:external:pro_bonus:02_rkeeper_setup:pasted:20260413-154724.png}}
+<code>
+begin
+  if (length(Parameter) = 8) and (pos('D', Parameter) = 1)  then Result := True
+  else  Result := False
+end;
+</code>
 ==== Универсальный MCR-алгоритм (не рекомендуется) ====
-Приведённый ниже алгоритм будет направлять вообще любую полученную кассой информацию (карты, штрихкод и т. д.) на проверку в ProBonus.
-Можно использовать при отладке, но лучше не оставлять в реальной работе - почти наверняка будет конфликтовать с другими системами лояльности, штрихкодами и т. д.
-Отредактировать скрипт MCR алгоритма так, чтобы он принимал любую введенную последовательность (Result := True;) и отправлял ее далее на проверку в систему ProBonus:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-100257.png}}
-Приведенный пример MCR алгоритма будет принимать любую последовательность символов (штрих-код, магнитную карту, код с клавиатуры) в качестве подходящего идентификатора для системы лояльности ProBonus. Если в ресторане работает параллельно несколько разных систем лояльности, то необходимо вместо универсального 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 |}}
-При использовании универсального MCR-алгоритма, если в ресторане используется несколько систем лояльности и введенный идентификатор удовлетворяет правилам 2 (или более), то сотруднику на кассе будет предложен выбор, в какую систему лояльности отправить запрос для поиска гостя.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221107-131005.png?800}}
 ----
-===== Скидки и Бонусы =====
+===== Скидки и бонусы =====
-Скидки и Бонусы, с которыми будет работать система ProBonus, создаются штатными средствами Редактор -> Деньги -> Скидки и Наценки. Т.е. точно так же как и при работе с PDS, CRM и Loyalty.
-Когда на кассе применяют карту ProBonus - в заказ добавляется соответствующая скидка. При этом, следует помнить, что на эту скидку так же действуют все правила и ограничения (расписание, уровень доступа, суммовые ограничения, настройки композиции с другими скидками и т.п.) заведенные для нее в редакторе r_keeper.
+Скидки и бонусы, с которыми будет работать система ProBonus, создаются штатными средствами: **Редактор → Деньги → Скидки и наценки**. То есть точно так же, как и при работе с PDS, CRM и Loyalty.
+Когда на кассе применяют карту ProBonus, в заказ добавляется соответствующая скидка. При этом следует помнить, что на эту скидку также действуют все правила и ограничения (расписание, уровень доступа, суммовые ограничения, настройки композиции с другими скидками и т. п.), заведённые для неё в редакторе r_keeper.
 ==== Нулевая скидка ====
-Одной из особенностей работы технологии FarCard является необходимость использования "нулевой" скидки (т.е. скидка добавляется в заказ, но не влияет на его сумму). Например, когда карта является только платежной (кредитной или дебетовой).
-Поэтому нужно **обязательно** завести такую "техническую" скидку.
-Редактор -> Деньги -> Скидки и Наценки -> Создать новую скидку с "нейтральным" названием (например, "Карта ProBonus") и настроить ее свойства следующим образом:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-102719.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]].
+Одной из особенностей работы технологии 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-05-21_13-09-56.png |}}
+{{ :external:pro_bonus:02_rkeeper_setup:2024-12-11_14-21-13.png |}}
 ==== Настройка бонуса ====
-) Создать тип бонуса. Перейти в Деньги - Типы бонусов. В открывшемся окне ПКМ - Новый тип бонуса.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20230421-123909.png}}
-) Перейти в Деньги - Скидки и наценки. Добавить новую скидку или отредактировать имеющуюся. Во вкладке "Детализация" создать детализацию и указать ранее созданный тип бонуса.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20230421-124006.png}}
-) Не забываем указать процент бонуса у валюты, при оплате которой будут начисляться бонусы
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20230421-123707.png}}
-==== Скидка для акции "Штампики" (опционально) ====
+) Создайте тип бонуса. Перейдите в **Деньги → Типы бонусов**. В открывшемся окне: ПКМ → **Новый тип бонуса**.
-Если в вашем ресторане используется акция "Штампики", то необходимо добавить скидку.
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20230421-123909.png |}}
+) Перейдите в **Деньги → Скидки и наценки**. Добавьте новую скидку или отредактируйте имеющуюся. На вкладке **Детализация** создайте детализацию и укажите ранее созданный тип бонуса.
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20230421-124006.png |}}
+) Не забудьте указать процент бонуса у валюты, при оплате которой будут начисляться бонусы.
+{{ :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 }}
+  * Не вручную.
+  * В детализации — скидка 100%.
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20231129-112419.png |}}
+Детализация скидки:
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20231129-112301.png |}}
 ==== Скидка и бонус одновременно (опционально) ====
-==== Передача изображения в карточку гостя на кассе ====
+Создаётся скидка с одной детализацией, у которой задан процент скидки и процент бонуса.
-Передача доступна с версий ProBonus v1.2.14.95, Farcards v1.0.0.8.
+{{ :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}}
-Возможность прикреплять индивидуальную картинку (или фото) к каждому счёту - отсутствует.
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20240304-073940.png |}}
-Само изображение можно изменить в папке img в корневой папке, куда установлен Probonus.
-Обязательно изменить название картинки на pb_img.
+Возможность прикреплять индивидуальную картинку (или фото) к каждому счёту отсутствует.
+Само изображение можно изменить в папке ''img'' в корневой папке, куда установлен ProBonus. Обязательно измените название картинки на ''pb_img''.
 {{ :external:pro_bonus:02_rkeeper_setup:2024-03-01_17-29-45.png? }}
-Для того, что бы передача изображения работала нужно сделать дополнительные настройки в Менеджерской станции R-Keeper.
-Перейти в "Настройки"->"Параметры"->"Установочные"->"Связь с другими системами"->"Персональные карты"->"ПДС Показывать картинку". В свойствах во вкладке "Основные" установить галочку напротив параметра "Логический".
+Чтобы передача изображения работала, нужно сделать дополнительные настройки в менеджерской станции r_keeper.
+Перейдите в **Настройки → Параметры → Установочные → Связь с другими системами → Персональные карты → ПДС Показывать картинку**. В свойствах на вкладке **Основные** установите галочку напротив параметра **Логический**.
 {{ :external:pro_bonus:02_rkeeper_setup:2024-03-01_17-14-37.png? }}
+===== Настройка валюты =====
+Если система ProBonus используется только для скидок, то создавать и настраивать валюту нет необходимости. В случае же с депозитами или бонусами — нужно настраивать.
+Свойства валюты задаются такие же, как и для обычной валюты «ПДС оплата».
+**Важно:**
+  * **Тип фискальности.** В случае, если средства с баланса счёта в ProBonus используются для нефискальных оплат, нужно указать «Печатать скидку». Мы не рекомендуем в общем случае настройки «Суммарно с вычитанием», «Не печатать чек», «Фискальная скидка».
+  * **Не учитывать в потратах ПДС.** Для правильного учёта потрат с бонусного баланса мы рекомендуем оставить чекбокс пустым. В противном случае некоторые отчёты в интерфейсе ProBonus будут формироваться неправильно.
-====== Настройка валюты ======
-Если система ProBonus используется только для скидок, то создавать и настраивать валюту нет необходимости.
-В случае же с депозитами или бонусами - нужно настраивать.
-Свойства валюты задаются такие же, как и для обычной валюты ПДС оплата.
-**Важно:**
-- **Тип фискальности**. В случае если средства с баланса счёта в ProBonus используются для не фискальных оплат, нужно указать "печатать скидку". Мы не рекомендуем в общем случае настройки "Суммарно с вычитанием", "Не печатать чек", "Фискальная скидка".
-- **Не учитывать в потратах ПДС**. Для правильного учёта потрат с бонусного баланса, мы рекомендуем оставить чек-бокс пустым. В противном случае некоторые отчёты в интерфейсе ProBonus будут формироваться неправильно.
 {{ :external:pro_bonus:02_rkeeper_setup:20240328-091452.png }}