Настройка r_keeper [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Настройка 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 вписываем значение вида 
<code>
http://127.0.0.1:11130/api/v1/events
</code>
В данном примере: 
127.0.0.1 - IP-адрес компьютера где будет установлен ProAlert-агент. Обычно это компьютер с кассовым сервером.
11130 - порт ProAlert-агента, по которому он готов принимать информацию.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-131715.png}}

<hidden Что делать если HTTP Order Notify уже использует другое ПО>
Например, он может уже использоваться для 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}}

</hidden>

===== Настройка виртуального принтера для 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}}


===== Дополнительные необязательные настройки =====

==== Вывод на виртуальный принтер сервис-чеков ===
<hidden>
На виртуальный принтер телеграм-бота можно печатать из r_keeper любые документы.
Например, можно направить на него какие-то сервис-чеки.
Вся печать будет проброшена в чат с ботом.
**Важно:** нельзя использовать "графические макеты" - они не поддерживаются.
{{:external:pro_alert:01_install_and_settings:pasted:20230216-151807.png}}
</hidden>

==== Настройка учёта рабочего времени на кассовой станции ====
<hidden>
С версии 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}}
</hidden>

==== Настройка  ввода комментария при удалении сохраненного блюд ====
<hidden>
Опция поддержана от версии ProAlert 1.0.41.120. 
Что бы активировать нужно перейти в r_keeper -> Заказ -> Причины удаления. Выбрать нужную причину и в свойствах отметить галочку "Ввод имени".
{{ :external:pro_alert:01_install_and_settings:2025-01-22_16-40-10.png |}}
Как это выглядит со стороны бота:
{{:external:pro_alert:01_install_and_settings:save.jpg?300|}}
</hidden>