====== Настройка r_keeper ======
ProAlert-агент устанавливается локально в ресторане, как правило на компьютер с кассовым сервером. Перед тем как это делать, нужно произвести предварительные настройки внутри r_keeper.
ProAlert-агент взаимодействует с кассовой частью r_keeper через три механизма:
1) Общается с кассовым сервером через HTTP-XML интерфейс;
2) Получает от кассового сервера информацию через интерфейс HTTP Order Notify;
3) Выступает в роли виртуального сервис-принтера, получая от r_keeper печать отчётов или иных кассовых документов;
===== Настройка связи с HTTP-XML интерфейсом =====
На **кассовом сервере** нужно настроить HTTP-XML интерфейс.
Производится стандартно, особенностей нет.
Статья, описывающая настройку: [[external:zz_дополнительные_материалы:02_xml_interfaсe_rkeeper|Настройка XML интерфейса]]
Запоминаем IP-адрес кассового сервера и порт, на котором настроен интерфейс.
===== Настройка HTTP Order Notify =====
Начиная с версии 7.6.5.371 настройки Http Order Notify находятся в «Свойствах» кассового сервера. У версий ниже указанной интерфейс добавляется на закладку «Устройства» кассового сервера.
В данной статье пример настройки для актуальных версий r_keeper.
Сервис -> Станции и устройства. В секции настроек "Http Order Notify" в параметре DestURLs вписываем значение вида
http://127.0.0.1:11130/api/v1/events
В данном примере:
127.0.0.1 - IP-адрес компьютера где будет установлен ProAlert-агент. Обычно это компьютер с кассовым сервером.
11130 - порт ProAlert-агента, по которому он готов принимать информацию.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-131715.png}}
Например, он может уже использоваться для KDS Pro или Guest Screen.
В этом случае в DestURLs вписываются сразу две настройки через ";"
Пример как будет выглядеть тогда строка настройки:
http://127.0.0.1:11130/api/v1/events;https://127.0.0.1:1234/orderTaker
В этом случае нужно обязательно вписывать лицензию на http order notify, которая всегда доступна вместе с лицензией KDS Pro или Guest Screen.
Если интерфейс используется только для бота ProAlert - то эту лицензию вписывать не нужно.
В системе лицензирования она называется «R-Keeper модуль Интерфейс уведомлений о заказах ПО». Генерируется без кода запроса, вписывается в свойства ресторана.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-132359.png}}
===== Настройка виртуального принтера для ProAlert =====
Настройки -> Печать -> Назначения принтеров.
Создаём новое назначение принтера, называем его "Бот ProAlert". Галку "На ресторан" **ставить нужно**. Данный параметр критичен, без него работать не будет.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-150755.png}}
Сервис -> Станции и устройства.
Находим станцию, которая всегда включена при работе ресторана. Это может быть касса или WinPrint.
На эту кассу добавляем драйвер "Print to TCP/IP Printer (Windows)" и принтер "Plain Text".
IP-адрес - указываем адрес компьютера, на котором будет установлен ProAlert-агент.
Порт - указываем порт, на котором ProAlert-агент будет принимать печать из r_keeper.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-133159.png}}
{{:external:pro_alert:01_install_and_settings:pasted:20230216-133248.png}}
На закладке "принтеры" создаём логический принтер и привязываем к созданному только что на закладке "Устройства".
{{:external:pro_alert:01_install_and_settings:pasted:20230216-133432.png}}
В свойствах ресторана указываем назначение принтера "бот ProAlert" = "принтер ProAlert".
{{:external:pro_alert:01_install_and_settings:pasted:20230216-142500.png}}
На данное назначение принтера теперь можно отправлять любые документы - пречеки, сервис-чеки, отчёты и т. д. Всё что касса отправит на этот принтер, будет передано в бота "как есть".
Убедитесь, что на этот виртуальный принтер направлено только назначение принтера "бот ProAlert". Не нужно направлять на него "для XML-отчётов".
**Важно:** нельзя использовать "графические макеты" - они не поддерживаются.
===== Настройка автоотчёта общей смены =====
Чтобы при закрытии общей смены на кассе в telegram-бот автоматически приходили нужные отчёты за день, нужно настроить "Автоотчёт общей смены" в используемой в ресторане схеме печати.
Настройки -> Печать -> Схемы печати.
Выбрать используемую в данном ресторане и найти в ней представление документа "Автоотчёт общей смены".
Выбрать "класс основного принтера" = "бот ProAlert".
Выбрать макеты отчётов, которые требуются при закрытии общей смены.
**Важно:** чтобы это работало, внутри чата в телеграм в настройках фильтров уведомлений должно быть включено "Печать документов из r_keeper".
{{:external:pro_alert:01_install_and_settings:pasted:20230216-143343.png}}
===== Дополнительные необязательные настройки =====
==== Вывод на виртуальный принтер сервис-чеков ===
На виртуальный принтер телеграм-бота можно печатать из r_keeper любые документы.
Например, можно направить на него какие-то сервис-чеки.
Вся печать будет проброшена в чат с ботом.
**Важно:** нельзя использовать "графические макеты" - они не поддерживаются.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-151807.png}}
==== Настройка учёта рабочего времени на кассовой станции ====
С версии r_keeper 7.07.00.369 появилась возможность передавать информацию о движении персонала (прибытие/убытие) и отработанных часах прямо в бота ProAlert.
Настройка учёта рабочего времени, а так же принцип работы описаны [[https://docs.rkeeper.ru/rk7/latest/ru/uchet-rabochego-vremeni-na-kassovoj-stantsii-4042853.html|в данной статье]].
{{:external:pro_alert:01_install_and_settings:2024-09-09_15-52-10.png}}