Технические настройки QR-меню [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Технические настройки QR-меню ======
Все дальнейшие настройки приложения QR-меню производятся через web интерфейс, который доступен по адресу [[http://127.0.0.1:11010/|127.0.0.1:11010]], в разделе "Параметры системы".
Также можно работать с настройками по локальной сети через адрес вида http://192.168.1.123:11010 где 192.168.1.123:11010 это адрес и порт компьютера на котором установлено приложение.
**Войти в web интерфейс из Интернета (через проброшенный порт на роутере) невозможно**, так сделано по соображениям безопасности.

===== Настройки соединения с кассовым сервером r_keeper =====
В данном разделе необходимо: 
  * Ввести ip адрес и порт по которому доступен HTTP XML интерфейс кассового сервера. Эта настройка производилась [[external:qr_меню/01_установка/02_найстроки_rkeeper#настройка_http_xml_интерфейса|тут]].
  * Ввести Имя пользователя и Пароль для доступа. Эта настройка производилась [[external:qr_меню/01_установка/02_найстроки_rkeeper#настройка_пользователя_для_http_xml_интерфейса|тут]].
  * Нажать кнопку "Сохранить и Проверить" и убедиться в том что связь успешно установлена.
{{:external:qr_меню:01_установка:pasted:20220518-104540.jpeg?800}}
*Режим разработчика - служебная настройка для отладки инженерами Карбис. [[https://wikiint.carbis.ru/internal/qr_menu_%D1%80%D0%B5%D0%B6%D0%B8%D0%BC_%D1%80%D0%B0%D0%B7%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D1%87%D0%B8%D0%BA%D0%B0|Режим разработчика]]


**Важно!**
Без успешной настройки в данном разделе дальнейшая работа не возможна.

===== Справочники r_keeper =====
В данном разделе нужно выбрать элементы основных справочников r_keeper данные из которых необходимы для работы. Назначение параметров описано во всплывающей подсказке (?)
{{:external:qr_меню:01_установка:pasted:20210912-134323.png?600}}

Пункты "Валюта онлайн платежа", "Причина внесения-выдачи денег" и "Работник" нужно заполнять только в случае если в модуле QR-меню у Гостя есть возможность совершения онлайн оплаты.
**Начиная с версии 1.14.26.1028**
Пункт "Причина удаления" так же нужно заполнять только в случае если в модуле QR-меню у Гостя есть возможность совершения онлайн оплаты.

==== Использовать SaaS XML лицензию ====

Если для создания заказов используется лицензия на XML WriteOrder (LifeTime), то ее настройка производится в [[external:qr_меню:01_установка/02_найстроки_rkeeper#лицензирование_xml_интерфейса|менеджерской r_keeper]] и данный пункт настраивать не требуется.

Если же для работы QR-меню используется SaaS XML ([[https://wiki.carbis.ru/external/интеграция_с_агрегаторами_доставки/xml_saas_howto#как_использовать_saas-лицензию|подробнее]]), то необходимо включить данный раздел и произвести его настройку.

Первоначально окно с настройками выглядит следующим образом:
{{:external:qr_меню:01_установка:pasted:20210912-142346.png?600}}
После корректного ввода логина/пароля дилера и выбора типа SaaS лицензии необходимо нажать кнопку "Сохранить".
Будет осуществлен запрос на сервер лицензирования UCS и в случае корректных данных окно примет следующий вид:
{{:external:qr_меню:01_установка:pasted:20210912-142808.png?600}}

**Важно!** 
Кнопку "Синхронизировать порядковый номер запроса" нажимать не требуется!
Но если вы ее нажмете - ничего страшного не произойдет :)
Сообщение "Инстанс лицензии не найден" не является ошибкой, и говорит лишь о том, что еще не было произведено ни одного запроса к кассовому серверу с использованием текущей XML SaaS лицензии.
**Если сообщение не пропадает возможное решение данной проблемы описано тут:** [[external:qr_меню:09_history:05_konown_errors|Известные ошибки]]

===== Регистрация на сервере приложений =====
Для работы QR-меню в ресторане необходимо иметь "белый" IP адрес, а также требуется осуществить проброс порта службы "Carbis QRMenu Agent" (по умолчанию 11010). Обращения извне будут только с Ip-адреса 91.218.115.203, можно "пробрасывать порт" с использованием белого списка.
<hidden Как узнать белый IP и проверить порт>
Убедиться в корректном пробросе порта можно при помощи внешних сервисов, например [[https://2ip.ru/check-port/?port=11010|2ip.ru]]
{{:external:qr_меню:01_установка:pasted:20210912-145420.png?400}}

Дополнительно, на главной странице этого сервиса, можно посмотреть свой "белый" IP адрес (он нам пригодится в дальнейшем).
</hidden>
\\
Далее, требуется ввести "Название ресторана", "Внешний ip адрес" и "Внешний порт" и нажать кнопку "Зарегистрировать".
{{:external:qr_меню:01_установка:pasted:20210912-150423.png?600}}

Если проверка пройдет успешно, то окно примет следующий вид:
{{:external:qr_меню:01_установка:pasted:20210912-150858.png?600}}

===== Смена сервера приложения=====
<hidden>

{{:external:qr_меню:01_установка:2026-02-05_16-15-04.png?600|}}

Для смены сервера приложения требуется:
1. Перейти в основную папку в которой расположен модуль QR меню.
2. Открыть файл с настройками QR меню.

{{:external:qr_меню:01_установка:2026-02-05_13-48-24.png?600|}}

3. В файле настроек найти параметр "head_server"

{{:external:qr_меню:01_установка:2026-02-05_13-51-20.png?600|}}

4. Ввести данные адреса головного сервера, в дальнейшим используемого модулем QR меню. 

{{:external:qr_меню:01_установка:2026-02-05_13-51-20.png?600|}}

**Важно! На скриншоте используется стандартный адрес.**

</hidden>
===== Настройки локального сервера =====
В данном разделе можно изменить некоторые настройки приложения qr_menu_agent. 
Например, изменить уровень логирования для поиска проблемы.
Или изменить язык интерфейса серверной части ПО (смотри раздел [[external:qr_меню:05_локализация:|Локализация]]) 

{{:external:qr_меню:01_установка:pasted:20210912-153636.png?600}}

**Важно!**
Не рекомендуется изменять данные настройки без четкого понимания того зачем вы это делаете.