Перед началом установки KDS PRO необходимо провести ряд предварительных настроек в r_keeper.

Создание пользователя

Для начала необходимо создать пользователя, который будет связывать KDS PRO и r_keeper 7.

  1. Перейдите в Персонал > Работники
  2. Выберите ресторан, в котором будет использоваться KDS PRO 
  3. Создайте роль и назовите ее HTTP Access
  4. Перейдите в Свойства роли
  5. Раскройте раздел Менеджерские ограничения > Привилегия на объекты и поставьте галочку в поле HTTP Access/HTTP Драйвер

  6. Создайте работника в роли HTTP Access. Имя работника должно быть написано латинскими буквами без пробелов, например, http.
  7. В поле Учетная запись укажите пароль работника и сохраните изменения.

Настройка интерфейсов

Далее необходимо настроить доступ к кассовому серверу по HTTP.

  1. Перейдите в меню Сервис > Станции и устройства
  2. Перейдите в кассовый сервер, который будет передавать заказы в KDS PRO.
  3. В свойствах кассового сервера укажите свободный порт в поле HTTP Data Port. Этот порт позже нужно будет прописать в личном кабинете.
  4. В разделе HTTP Ограничения в каждом поле выберите значение HTTP Access
  5. По желанию можно указать папку для сохранения лога запросов и ответов в поле HTTP log path
  6. Далее необходимо прописать строку подключения к KDS PRO. Начиная с версии 7.6.5.371 настройки Http Order Notify переместились в Свойства кассового сервера. У версий r_keeper 7.6.5 и старше раскройте раздел HTTP Order Notify
  7. В параметре драйвера DestURLs пропишите строку подключения в виде:
    https://имя_пользователя:пароль_пользователя@адрес_сервера_KDS_PRO:порт_сервера_KDS_PRO/orderTaker
    Например: https://127.0.0.1:1234/orderTaker

    1. Если требуется указать несколько строчек подключения, их можно указать через точку запятой ";".
      Например: http://127.0.0.1:2121/api/httpNotify/postOrders;https://127.0.0.1:1234/orderTaker
  8. Сохраните изменения
  9. Перезапустите кассовый сервер.

Если у вас версия r_keeper меньше 7.6.5, то интерфейс HTTP Order Notify необходимо на кассовый сервер добавить самостоятельно. Для этого:

  1. Для работы KDS PRO требуется драйвер не ниже 18 версии. Поэтому, если ваша версия ниже — перед добавлением интерфейса на кассовый сервер, скачайте драйвер с FTP: ftp://ftp.ucs.ru/rk7/other/KDS_PRO/Extra_Files/httpnotf.udb
  2. Скопируйте файл httpnotf.udb с заменой в папку сервера справочников
  3. Перезапустите кассовый сервер
  4. Добавьте на кассовый сервер драйвер HTTP Order Notify

  5. Настройте драйвер для всех кассовых серверов по необходимости.
  6. В параметре драйвера DestURLs пропишите строку подключения в виде:
    https://имя_пользователя:пароль_пользователя@адрес_сервера_KDS_PRO:порт_сервера_KDS_PRO/orderTaker

  7. Имя пользователя и пароль указывать не обязательно. Вписывайте их только, если они есть в личном кабинете. Эти данные есть в личном кабинете, их описание ниже. Порт сервера находится в файле настроек kds_pro.config.
  8. Перейдите в Сервис > Интерфейсы и создайте новый интерфейс
  9. В разделе Файлы библиотек (DLL) выберите нужный ресторан и укажите драйвер кассовому серверу HTTP Order Notify
  10. Активируйте интерфейс и сохраните.

Настройка классификации

Настройте классификацию и категории товаров для KDS PRO.

  1. Перейдите в меню Настройки > Параметры > Установочные > Связь с другими системами > KDS и VDU > Классификация для КДС и VDU
  2. Откройте Свойства параметра
  3. В поле Ссылка выберите классификацию для КДС, например Сервис-печать
    В классификации обязательно должна быть хотя бы одна категория с блюдами. Только блюда в этой категории появятся в KDS PRO
  4. Сохраните и закройте классификации.

Готово, классификация настроена. Теперь можно установить сервер KDS PRO.

Установка сервера

Системные требования

  • Операционная система:
    • Windows 7 и выше
    • Android 7.0 и выше
    • Linux: Ubuntu или CentOS 2020 года
  • Процессор: 2 ядра с частотой 1,5 ГГц и выше
  • Оперативная память: 2 ГБ
  • Место на жестком диске:
    • Desktop — 1 ГБ свободного места
    • Android — 1 ГБ свободного места, 16 Гб общей памяти
  • r_keeper не ниже 7.6.2.295.

Установка

  1. Скачайте установщик с FTP-сервера ftp://ftp.ucs.ru/rk7/other/KDS_PRO/
  2. Запустите его от имени администратора и следуйте подсказкам
  3. Укажите свободный порт веб-интерфейса. Поставьте галочку Установить как служба по необходимости
У версий сервера ниже <1.7.67 нет установщика. Для их установки скачайте и распакуйте архив KdsProServer.7z с FTP-сервера ftp://ftp.ucs.ru/rk7/other/KDS_PRO/ В пути к файлам сервера не должно быть пробелов, заменяйте их на "_" или "-".

В корневой папке найдите файл настроек kds_pro.config. Это текстовый файл, откройте его блокнотом и укажите свободный порт, как написано ниже. По нему клиенты системы будут подключаться к серверу:

webServerPort=1234

Если версия сервера ниже 1.6, файл kds_pro.config находится в папке \bin\. Если его там нет — создайте. 

Сервер работает только через HTTPS. Для запуска нескольких серверов, необходимо указывать разные порты.
Если есть у вас есть фаерволл, добавьте в исключения исполняемый файл java.exe, который находится в папке установки java: \java\bin\.

Для простого запуска сервера запустите файл \KDSPRO\bin\runConsole.bat. Чтобы установить сервер как службу, есть группа bat-файлов, которые находятся в папке \KDSPRO\bin\. Их функционал описан ниже:

  • installService.bat — установка сервера как службы.
    Запускать от имени администратора. После установки службу необходимо запустить.
    Иногда после установки службу нельзя запустить через оснастку Службы. В этом случае перезагрузите компьютер.
  • queryService.bat — возвращает состояние службы
  • runConsole.bat — запуск сервера как приложения
  • startService.bat — запуск службы сервера
  • stopService.bat — остановка службы сервера
  • uninstallService.bat — удаление службы сервера. Запускать от администратора

Важно

KDS PRO подключается к кассовому серверу. Поэтому запускайте его только при запущенном кассовом сервере.

Если вы остановили сервер, но новый пишет, что порт занят — откройте диспетчер задач и закройте сервер через него.

Для корректной работы KDS PRO Server требуются открытые порты:

  • kds.ucs.ru:443, протокол TCP
  • kds.ucs.ru:5674, протокол AMQP 
  • l.ucs.ru:60606, протокол TCP.

Далее необходимо настроить сервер и клиент KDS в личном кабинете. Подробнее читайте в следующей статье Настройки в личном кабинете.