Различия

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

--- external:pro_bonus:02_rkeeper_setup:01_rkeeper [2024/03/28 09:19] – Евгений Агеев
+++ external:pro_bonus:02_rkeeper_setup:01_rkeeper [2025/06/30 11:29] (текущий) – Евгений Агеев
@@ Строка 1: / Строка 1: @@
 ====== Настройка r_keeper ======
+**Важно!** Для работы с чеками намеренияя __при наличии двух фискальных регистраторов__ ProBonus корректно работает только в режиме "Единый чек перед оплатой".
 ===== PDS интерфейс =====
 Редактор → Сервис → Станции и устройства → на закладке "Устройства" нужного кассового сервера добавить новый "PDS interface".
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-091311.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-091311.png |}}
 Для нового интерфейса заполнить следующие поля:
-  - **PDS Server Name** - Уникальное (в рамках сети) имя. Регистр важен! Далее потребуется для настройки FarCard.
+  - **PDS Server Name** - Уникальное (в рамках сети) имя. Регистр важен! Далее потребуется для настройки [[external:pro_bonus:02_rkeeper_setup:02_farcard|FarCards]].
   - **Look Up Card By Mail Addr** - Установить значение "Yes, error on not found".
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-091620.png}}
+  - **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 интерфейсов с уникальными именами.
@@ Строка 13: / Строка 19: @@
 ===== Интерфейс =====
 Редактор → Сервис → Интерфейсы → Добавить новый Интерфейс с именем "ProBonus", активировать и заполнить его свойства следующим образом:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-093607.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-093607.png |}}
 **Важно!** Если в ресторане используется только одна система лояльности (ProBonus), то можно воспользоваться предустановленным интерфейсом "Персональная дисконтная система(ПДС)".
@@ Строка 31: / Строка 37: @@
 Редактор -> Сервис -> Обработка сигналов устройств -> Mcr алгоритмы.
 Выбрать и скопировать "Персональная дисконтная система(ПДС)" -> Новый Mcr алгоритм (копия) и установить следующие  параметры:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-095518.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221009-095518.png |}}
 Типы устройств (Клавиатура, Магнитная карта, Штрих код) установить согласно тому оборудованию, которое используется для чтения карт в ресторане.
@@ Строка 41: / Строка 47: @@
 Это потенциально опасная настройка, возможны махинации персонала.
 В данном примере представлен вариант алгоритма для номеров телефона из России (начинается с цифры 7, длина номера 11 цифр). Его можно изменить под свои условия при необходимости.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221109-092203.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221109-092203.png |}}
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221109-092435.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221109-092435.png |}}
 <hidden Код скрипта>
 begin
@@ Строка 54: / Строка 60: @@
 Особенность - здесь нужно отметить  и чекбокс "штрихкод", и чекбокс "клавиатура", т. к. вместе с QR-кодом в телеграм-боте всегда доступен символьный код для ввода с клавиатуры.
 Для виртуальной карты через Telegram бот с длиной временного кода 6 цифр (XXX-XXX), MCR будет выглядеть так:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221107-102510.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221107-102510.png |}}
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221107-102621.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221107-102621.png |}}
@@ Строка 68: / Строка 74: @@
 Можно использовать при отладке, но лучше не оставлять в реальной работе - почти наверняка будет конфликтовать с другими системами лояльности, штрихкодами и т. д.
 Отредактировать скрипт MCR алгоритма так, чтобы он принимал любую введенную последовательность (Result := True;) и отправлял ее далее на проверку в систему ProBonus:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-100257.png}}
+{{ :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}}
+{{ :external:pro_bonus:02_rkeeper_setup:pasted:20221107-131005.png?800 |}}
 ----
@@ Строка 85: / Строка 91: @@
 Поэтому нужно **обязательно** завести такую "техническую" скидку.
 Редактор -> Деньги -> Скидки и Наценки -> Создать новую скидку с "нейтральным" названием (например, "Карта ProBonus") и настроить ее свойства следующим образом:
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-102719.png}}
+{{ :external:pro_bonus:02_rkeeper_setup:20221009-102719_1.png |}}
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20221009-102724.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:pasted:20221104-113635.png?880}}
+{{ :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-123909.png |}}
 ) Перейти в Деньги - Скидки и наценки. Добавить новую скидку или отредактировать имеющуюся. Во вкладке "Детализация" создать детализацию и указать ранее созданный тип бонуса.
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20230421-124006.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-123707.png |}}
-==== Скидка для акции "Штампики" (опционально) ====
+==== Скидка для "Товарных купонов" и акции "Штампики" (опционально) ====
-Если в вашем ресторане используется акция "Штампики", то необходимо добавить скидку.
+Если в вашем ресторане используются акции "Штампики" или/и "Товарных купонов", то необходимо добавить скидку.
 Для каждой акции создаётся отдельная скидка со следующими настройками:
   * Комбинировать с любой скидкой
@@ Строка 108: / Строка 114: @@
   * В детализации - скидка 100%
-{{ :external:pro_bonus:02_rkeeper_setup:pasted:20231129-112419.png }}
+{{ :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: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}}
+{{ :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|}}
+{{ :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|}}
+{{ :external:pro_bonus:02_rkeeper_setup:2024-03-01_17-14-37.png? }}
@@ Строка 129: / Строка 139: @@
 В случае же с депозитами или бонусами - нужно настраивать.
 Свойства валюты задаются такие же, как и для обычной валюты ПДС оплата.
-Важный параметр - Тип фискальности. Нужно указать "печатать скидку", поскольку при других значениях чеки не будут печататься, либо будет чек на ноль рублей.
+**Важно:**
-{{:external:pro_bonus:02_rkeeper_setup:pasted:20240328-091452.png}}
+- **Тип фискальности**. В случае если средства с баланса счёта в ProBonus используются для не фискальных оплат, нужно указать "печатать скидку". Мы не рекомендуем в общем случае настройки "Суммарно с вычитанием", "Не печатать чек", "Фискальная скидка".
+- **Не учитывать в потратах ПДС**. Для правильного учёта потрат с бонусного баланса, мы рекомендуем оставить чек-бокс пустым. В противном случае некоторые отчёты в интерфейсе ProBonus будут формироваться неправильно.
+{{ :external:pro_bonus:02_rkeeper_setup:20240328-091452.png }}