R-Keeper
Содержание
Основные изменения(по разделам):
- 6. Настройка сервиса интеграции RestoCRM
- обновлён пример config.ini для версии v.1.9.11
- 10. Расширенные свойства
- добавлено расширенное свойство discountCode
- 11. Повторная авторизация на кассе
- изменился скрипт
- 11. Проверка лояльности перед пречеком и оплатой
- изменился скрипт
- 13. Настройка промокодов
- новый раздел
- 15. Анонимные клиенты
- новый раздел
- 17. Чек лист для проверки интеграции
- новый раздел, рекомендуется выполнять после выполнения всех настроек
Настройка PDS интерфейса
Добавить драйвер PDS интерфейса на кассовом сервере.
Настроить логический интерфейс PDS интерфейса в Сервис > Интерфейсы.
После выполнения настроек необходимо перезапустить кассовый сервер.
Настройка валюты
Настроить валюту для оплаты бонусами как Фискальная скидка.
Обращаем внимание:
- Тип Фискальная скидка превращает оплату в скидку только для фискального регистратора, а на чеке r_keeper печатается оплата.
- Источник https://docs.rkeeper.ru/rk7/latest/ru/svojstva-tipa-valyuty-55973203.html
Валютой можно будет оплатить заказ. Сумма доступных к списанию бонусов будет отображаться в окне информации о клиенте и при добавлении валюты к заказу.
Информация о бонусах в окне Информация о клиенте:
Информация о бонусах при оплате:
Оплату бонусами можно внести предоплатой:
После оплаты заказа бонусы будут списаны со счета клиента.
Настройка скидки
Создать изменяемую скидку с типом Процент и детализацией с процентом 100%.
Скидка будет добавляться к каждому заказу после применения лояльности. Сумма скидки рассчитывается автоматически в соответствии с настройками в ЛК Maxma. Если лояльность не настроена, то скидка будет добавлена с нулевой суммой.
Настройка MCR алгоритма
Создать MCR алгоритм и привязать его к PDS интерфейсу.
Скрипт для MCR алгоритма:
Обращаем внимание:
- Длина кода карты может отличаться в зависимости от настроек Maxma. Чтобы MCR алгоритм отрабатывал корректно, его следует поправить.
- Настройки MCR алгоритма не должны пересекаться с настройками других MCR алгоритмов, чтобы при вводе номера телефона, кода карты или сканирования QR с помощью Мобильного официанта отрабатывал только один MCR алгоритм.
Настройка Farcards
Установить Распространяемый компонент Visual C++ для Visual Studio 2015-2022.exe использовать из дистрибутива или скачать по ссылке https://aka.ms/vs/17/release/vc_redist.x86.exe .
Запустить farcards.exe /install через командную строку, чтобы установить Farcards как службу Windows.
Конфигурационные файлы можно не изменять и оставить дефолтные из дистрибутива.Пример farcards.ini
Пример config.ini
Запустить службу Farcards
В случае возникновения ошибок:
Обновить Распространяемый компонент Visual C++ для Visual Studio 2015-2022.exe использовать из дистрибутива или скачать по ссылке https://aka.ms/vs/17/release/vc_redist.x86.exe .
Настройка сервиса интеграции RestoCRM
Если используется x32 операционная система:
- Обновить Распространяемый компонент Visual C++ для Visual Studio 2015-2022.exe использовать из дистрибутива или скачать по ссылке https://aka.ms/vs/17/release/vc_redist.x86.exe .
Установить службу RestoCRM с помощью сервиса nssm.exe https://nssm.cc/download . Служба устанавливается там же, где устанавливается служба Farcards.
Для этого необходимо:
Скопировать nssm.exe в папку где находится сервис restocrm.exe.
Запустить nssm.exe install через командную строку, откроется GUI, в котором указать путь к файлу restocrm.exe и нажать кнопку “Install service”.
Настроить конфигурационный файл config.ini. Файл config.ini расположен в папке, где находится исполняемый файл restocrm.exe.
Все параметры можно оставить без изменений, кроме выделенных жирным шрифтом.
Все значения параметров Вы должны были получить в процессе выполнения текущей инструкции.
Пример config.ini для версии v.1.10.5для остальных версий config.ini использовать из дистрибутива и заполнять повторно
или можно оставить предыдущий config.ini, но тогда недостающие параметры будут указаны значениями по умолчанию, как на примере ниже.
Запустить установленную службу.
Настройка мобильного официанта
Для корректной работы мобильного официанта с системой лояльности требуется проверить только одну настройку: указать Тип устройства для чтения карт лояльности > Клавиатура.
Подробности по настройке можно посмотреть в статье https://docs.rkeeper.ru/mobwaiter/skidki-po-karte-100336182.html
Настройка макета пречека
Для печати информации о лояльности в пречеке, необходимо использовать макет пречека, который находится в папке с дистрибутивом - файл Пречек Maxma.mak. Макет добавить в справочники Документы и Макеты и Схемы печати.
Пример печати пречека
Настройка макета купона
Для печати информации о лояльности в чеке, необходимо добавить купон, который находится в папке с дистрибутивом - файл Купон СБП QR-код + Maxma.mak. Макет добавить в справочники Документы и Макеты и Схемы печати. Предустановленный купон с наименованием СБП QR-код в Схемах печати можно удалить или сделать неактивным.
Купон будет печататься после чека. Пример печати нефискального чека с купоном:
Расширенные свойства
Открыть Настройка - Настройка - Расширенные свойства и создать:
Расширенное свойство для заказов:
Название: Информация из лояльности
Системное имя: LoyaltyInfo
Расширенное свойство для кассового сервера
Название: IP адрес сервиса RestoCRM
Системное имя: ipaddress
Открыть Список типов
Добавить Кассовый сервер
Расширенное свойство для кассового сервера
Название: Код скидки Системы лояльности
Системное имя: discountCode
Открыть Список типов
Добавить кассовый сервер
Настройка расширенных свойств
Сохраните и перезапустите Сервер справочников, Кассовый сервер и Менеджерскую RK7, чтобы создались расширенные свойства.ipaddress - IP адрес сервиса RestoCRM
Необходим, чтобы касса перед печатью пречека или оплатой заказа смогла обратиться к сервису RestoCRM и проверить заказ, что не было изменений в чеке после применения лояльности и не требуется повторно выполнить лояльность, чтобы пересчитать заказ и выдать корректную скидку/лояльность.
Параметр настраивается в свойствах кассового сервера(скриншот ниже). В настройках указывается IP адрес где запущен сервис RestoCRM так, чтобы касса смогла к нему подключиться.Пример: 192.168.1.111:8001, где 8001 взять из config.ini - параметр PORTRK.
discountCode - Код скидки Системы лояльности
Необходим, для корректной работы скриптов.
Параметр настраивается в свойствах кассового сервера. В настройках указывается код скидки Системы лояльности
Пример настройки расширенных свойств:
Повторная авторизация на кассе
Открыть Сервис - Скрипты и добавить скрипт с наименованием Повторная авторизация.
Код скрипта - параметр SomeScript:
Открыть Сервис - Операции - Пользовательские операции - Выбрать Пользовательская операция 11, переименовать название операции на Повторная авторизация и указать в параметре Скрипт скрипт Повторная авторизация из предыдущего действия.
Обращаем внимание:
- Если Пользовательская операция 11 занята, то можно использовать любую свободную Пользовательскую операцию от 01 до 20, кроме Пользовательская операция 12.
Открыть Настройки - Графический интерфейс - Функциональные клавиши - Прочее, создать функциональную клавишу и указать в параметрах Операция/Операция пуст операцию Повторная авторизация, созданную в предыдущем действии.
Открыть Настройки - Графический интерфейс - Селекторы - Заказ - Селектор операций, сделать копии селекторов Быстрый чек: операции и Чек: операции
Добавить функциональную клавишу Повторная авторизация в Кнопки селектора - Доп.
Открыть Настройки - Графический интерфейс - Использования селекторов и добавить созданные селекторы в фильтры ресторана.
Отображение на кассе после нажатии кнопки Доп:
Проверка лояльности перед пречеком и оплатой
Открыть Сервис - Скрипты и добавить скрипт с наименованием Проверка перед пречеком и оплатой.
Код скрипта - параметр SomeScript:
Открыть Сервис - Операции - Пользовательские операции - Выбрать Пользовательская операция 12, переименовать название операции на Проверка перед пречеком и оплатой и указать в параметре Скрипт скрипт Проверка перед пречеком и оплатой из предыдущего действия.
Обращаем внимание:
- Имя операции обязательно должно быть rkoUser12. Если данное условие не удается выполнить, то обратитесь в ТП RestoCRM.
Далее будет 2 варианта правки Формы Редактирования заказа.
Вариант через правки скрипты на форме, где rkoUser12 - это системное название операции Проверка перед пречеком и оплатой, из предыдущего пункта.
Вариант через загрузки файла формы dfm из дистрибутива. Инструкция ниже:
Открыть Настройки - Графический интерфейс - Формы - Заказ - Редактирование заказа/ Редактирование заказа (быстрый чек) и скопировать предустановленные экземпляры форм.
Новые формы загрузить из файлов форм, которые находятся в папке с дистрибутивом:
- файл Редактор заказа.dfm
- файл Редактор заказа (быстрый чек).dfm
Открыть Настройки - Графический интерфейс - Схемы форм и скопировать предустановленную форму Новый дизайн
Открыть свойства новой схемы форм и указать новые формы Редактирование заказа и Редактирование заказа (быстрый чек)
Открыть Настройки - Графический интерфейс - Использование схем форм и добавить новую схему форм в использование.
Обращаем внимание:
- Для применения новой схемы форм может потребоваться перезапуск кассы.
Перед печатью пречека или перед оплатой на кассе будет выполняться проверка, что чек изменился после последнего применения лояльности к заказу.
Если нажать Да, то повторно применится лояльность к заказу. Сумма скидки и бонусов, доступных к списанию обновятся в соответствии с актуальным заказом.
Если нажать Нет, то ничего не произойдет и окно закроется.
Настройка промокодов
Для использования промокодов необходимо обновить версию сборки не ниже 1.9.9.
Необходимо сделать копию предустановленной формы MCR Симулятор.
Сделайте новую созданную форму активной и загрузите форму MCR Симулятор + Промокод.dfm, которая находится в дистрибутиве версии 1.9.9 не ниже.
После в Схеме форм в Назначении форм для MCR Симулятор необходимо указать форму для промокодов, которую мы создали ранее.
Теперь на кассе форма будет отображаться следующий образом
Номер телефона или код карты можно указать без промокода или с промокодом.
Промокод можно указать без номер телефона или кода карты.
Пример применения телефона + промокод:
Если промокод применен, то мы это увидим после применения авторизации - надпись Применен промокод: rkeeper
Настройка страницы с анкетой гостя
Перейдите в справочник настроек Настройки > Параметры. В навигационном дереве в левой части окна перейдите по пунктам Установочные > Связь с другими системами > Сервисы. Выберите один из четырех доступных сервисов (убедитесь, что выбранный Вами сервис не используется другим ПО) и заполните для него два параметра:
- Имя web-сервиса (будет отображено на кассе): Регистрация гостя в ПЛ
- URL web-сервиса: https://my.maxma.com/minipos/?shop= КОД_МАГАЗИНА&key=СЕКРЕТНЫЙ_КЛЮЧ
Для каждой точки должен быть уникальный URL, в котором КОД_МАГАЗИНА совпадает с кодом ShopCode из config.ini, а СЕКРЕТНЫЙ_КЛЮЧ совпадает с ключом ProcessingKey из config.ini.Пример config.ini можно посмотреть в пункте 6.Настройка сервиса интеграции RestoCRM.
Данные поля доступны для редактирования только под дилерской учетной записью.
После заполнения этих параметров в главном меню кассы отобразится новая кнопка, с подписью, соответствующей введенному имени веб-сервиса.
Автоматическая отправка анонимных заказов
Заказ с анонимным клиентом(или без клиента) может автоматически отправляться в Maxma. Для этого необходимо включить следующий параметр в config.ini(работает с версии 1.10.5):[SERVICE]
# SendAnonymousOrder - автоматически отправлять анонимные заказы
SendAnonymousOrder = true
Анонимные клиент
Скрипт, который привязывать к операции:
На кассе будет возможность вручную проверить лояльность без клиента:
Заказ будет отправляться в Maxma только если включен параметр[SERVICE]
# SendAnonymousOrder - автоматически отправлять анонимные заказы
SendAnonymousOrder = true
Редактирование клиента MAXMA
Требуется версия 1.10.3 и выше
В config.ini необходимо добавить параметр PORTPROXY в разделе SERVICE.[SERVICE]
# Порт для Maxma Proxy
PORTPROXY = 8002
Настроить кнопку которая будет отображаться в интерфейсе кассы rkeeper в Главном меню. Для этого в Настройка > Параметры > Установочные > Связь с другими системами > Сервисы > Выбрать любой свободный сервис и указать ссылку где запущен сервис RestoCRM.
Ссылка обязательно должна быть с указанием протокола http, например:
После настройки на кассе появится кнопка с возможностью редактирования клиента.
Если требуется отредактировать web страницу, то это можно сделать заменив файл www/index.html в папке с сервисом RestoCRM.Файл создается автоматически при запуске сервиса, если в папке его не существует.
Отключение настроек предыдущей интеграции Maxma
Актуально клиентам, которые выполняли настройки в рамках статьи https://help.maxma.com/p/VAQjRaFTxsMi0l/R-keeper .
Удаление PDS интерфейса
В Сервис > Станции и Устройства на кассовом сервере удалить драйвер PDS интерфейса. Значение параметра должно быть PDS Server Name = CLFC.
После удаления обязательно сохранить настройки и перезагрузить кассовый сервер.
Отключение валюту оплаты бонусами
Перевести в статус Неактивен валюту привязанную к интерфейсу CloudLoyalty.
Отключение купона
Открыть Настройки > Печать > Документы и Макеты > Документы CRM > Купон > Найти макет с названием Купон доп.инфо printtext и открыть Ссылающиеся элементы.
Сменить статус всех купонов на Неактивен и сохранить.
Отключение функциональной клавиши
Открыть Сервис > Операции > Пользовательские операции > Найти объект с названием CL Повторная Авторизация и открыть Ссылающиеся элементы.
Сменить статус всех функциональных клавиш на Неактивен и сохранить.
Отключение MCR алгоритма
Открыть Сервис > Обработка сигналов устройств > MCR алгоритмы > Найти объект с названием CloudLoyalty или где параметр Объект = CloudLoyalty, сменить статус на Неактивен и сохранить.
Чек лист для проверки интеграции(рекомендуется к выполнению)
Действие
Ожидаемый результат
Закрыть заказ из зала без лояльности
Заказ закрыт на кассе без ошибок
Закрыть заказ из зала с лояльностью без оплаты бонусами
- с номером телефона
- с кодом карты
- с номером телефона + промокод
- с кодом карты + промокод
- только с промокодом
Заказ закрыт на кассе без ошибок и сохранен в ЛК MaxmaНа чеке и пречеке печатается информация о лояльности из Maxma
Закрыть заказ из зала с лояльностью с оплатой бонусами
- с номером телефона
- с кодом карты
- с номером телефона + промокод
- с кодом карты + промокод
- только с промокодом
Заказ закрыт на кассе без ошибок и сохранен в ЛК Maxma со списанием бонусов
На чеке и пречеке печатается информация о лояльности из Maxma
Закрыть быстрый чек без лояльности
Заказ закрыт на кассе без ошибок
Закрыть быстрый чек с лояльностью без оплаты бонусами
- с номером телефона
- с кодом карты
- с номером телефона + промокод
- с кодом карты + промокод
- только с промокодом
Заказ закрыт на кассе без ошибок и сохранен в ЛК Maxma
На чеке печатается информация о лояльности из Maxma
Закрыть быстрый чек с лояльностью с оплатой бонусами
- с номером телефона
- с кодом карты
- с номером телефона + промокод
- с кодом карты + промокод
- только с промокодом
Заказ закрыт на кассе без ошибок и сохранен в ЛК Maxma со списанием бонусов
На чеке печатается информация о лояльности из Maxma
Кнопка повторная авторизация в заказе из зала для заказов:
- с номером телефона
- с кодом карты
- с номером телефона + промокод
- с кодом карты + промокод
- только с промокодом
Открывается окно с авторизацией клиента
Если заказ был изменен, то будет выполнен пересчет/обновлена лояльность
Кнопка повторная авторизация в быстром чеке для заказов:
- с номером телефона
- с кодом карты
- с номером телефона + промокод
- с кодом карты + промокод
- только с промокодом
Открывается окно с авторизацией клиента
Если заказ был изменен, то будет выполнен пересчет/обновлена лояльность
Проверка изменений чека перед печатью пречека, в ситуации когда после применения лояльности заказ был изменен.Условия срабатывает только если скидка не равна нулю.
Открывается диалоговое окно на кассе с сообщением, что требуется повторно применить авторизацию.
Если начать Да, то выполняется повторная авторизация. Данные скидки пересчитаются.
Проверка изменений чека перед печатью чека, в ситуации когда после применения лояльности заказ был изменен.
Условия срабатывает только если скидка не равна нулю.
Открывается диалоговое окно на кассе с сообщением, что требуется повторно применить авторизацию.
Заказ нельзя закрыть, пока повторно не выполнить лояльность - для этого необходимо выйти из режима оплаты и нажать кнопку Повторная авторизация.
Анонимный клиент. Если в заказе никто не авторизован, то нажать кнопку Рассчитать заказ с анонимным клиентом.
В окне авторизации на кассе будет авторизирован Анонимный клиент.
К заказу будет применена лояльность для Анонимных клиентов.