Подключение 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.

• Операционная система:
  • Windows 7 и выше
  • Android 7.0 и выше
  • Linux. Дистрибутив не старше 2022 года.
• Процессор: 2 ядра, 1,5 ГГц и выше
• Оперативная память: 2 ГБ
• Место на жестком диске: 

  • Desktop: 1GB свободного места

  • Android: 1 Gb свободного места, 16Gb общей памяти.

Для работы требуется 2 вида лицензий:

• Мастер-лицензия R-Keeper модуль KDS PRO.
  Мастер-лицензия проверяется онлайн. Ее можно активировать и распределить между серверами KDS в личном кабинете.

• Для r_keeper 7.6.5 и старше дополнительно требуется лицензия на лицензия на интерфейс HttpOrderNotify. Она называется R-Keeper модуль Интерфейс уведомлений о заказах ПО. Лицензия добавляется автоматически при покупке лицензии KDS PRO. Срок действия лицензии для HttpOrderNotify равен сроку действия лицензии KDS PRO.
  
  Количество лицензий R-Keeper модуль Интерфейс уведомлений о заказах ПО должно быть равно количеству дополнительных подключений к HttpOrderNotify.

  

  Обратите внимание, что при первом запуске сервера KDS PRO появляется надпись KDS Server NOT ACTIVATED — это нормально, просто продолжайте установку по инструкции.

  
  Подробнее описано в разделе Лицензирование

Для начала необходимо создать пользователя, который будет связывать 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. Перезапустите кассовый сервер.

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

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

   

   
   В классификации обязательно должна быть хотя бы одна категория с блюдами. Только блюда в этой категории появятся в KDS PRO
   

   

4. Сохраните и закройте классификации.

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

1. Скачайте установщик с FTP-сервера ftp://ftp.ucs.ru/rk7/other/KDS_PRO/
2. Запустите его от имени администратора и следуйте подсказкам

3. Укажите свободный порт веб-интерфейса. Поставьте галочку Установить как служба по необходимости.

     Нажмите сюда, чтобы увидеть информации по установке старых версий

   В корневой папке найдите файл настроек 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.

Для установки клиента с помощью установочного файла:

1. Скачайте установочный файл клиента с FTP-сервера ftp://ftp.ucs.ru/rk7/other/KDS_PRO
2. Запустите установщик и следуйте подсказкам
3. В окне Основные настройки пропишите:
   • Адрес сервера — укажите адрес, доступный по сети
   • Порт сервера — порт должен совпадать с настройками сервера в kds_pro.config
   • Остальные настройки укажите по желанию
     

     

4. Завершите установку клиента.

Если вы хотите установить клиент из архива, скачайте с FTP-сервера ftp://ftp.ucs.ru/rk7/other/KDS_PRO архив и распакуйте его на жесткий диск.

• Клиент для Windows XP это файл KDSProClient_WinXP_setup-1.0.0.1
• Клиент для Windows 7 и выше — это файл KdsProClient_Win7+.7z

Отредактируйте файл browser.cfg блокнотом. Обязательно укажите строчку с host и port, остальные настройки можно оставить по умолчанию.

host=127.0.0.1 ; адрес сервера KDS PRO. Адрес должен быть доступен по сети.
port=1234      ; порт сервера KDS PRO. Порт должен совпадать с настройкой сервера в kds_pro.config
top=0          ; координаты верхнего угла
left=0         ; координаты левого угла
width=1600     ; ширина окна
height=900     ; высота окна
zoom=0.7       ; масштаб

Для запуска клиента:

1. Запустите сервер справочников и кассовый сервер
2. Запустите сервер KDS PRO
3. Запустите клиент KDS PRO. Он находится в папке KDSPRO\Client и называется run.bat. 

Во время первого запуска клиент KDS PRO попросит ввести код активации. Для активации клиента:

1. Перейдите в личный кабинет KDS PRO и выберите нужный сервер
2. Нажмите кнопку Получить код активации в правом верхнем углу
3. На экране появится код активации. Скопируйте его.
   Срок действия кода — 30 минут. Если время истекло, необходимо получить новый код.
   Код активации нужно вводить для каждого клиента KDS PRO. При активации первого клиента будет активирован и сервер KDS PRO.
4. Пропишите в клиенте KDS PRO полученный код и нажмите Ввод. Клиент активируется.
   
5. После успешной активации введите в поле Введите название клиента название клиента из личного кабинета. Каждый клиент необходимо активировать 1 раз.
   
6. Нажмите Вход и попадёте в рабочую форму
7. Создайте заказ на кассе и сохраните. Он должен появится в клиенте
   
8. Авторизация прошла успешно.

Готово

В левом верхнем углу клиента есть 3 индикатора, обозначающие различные статусы.

Описание индикаторов слева направо:

1. Статус лицензии
2. Статус соединения с кассовым сервером
3. Статус получения данных от кассового сервера

Возможные цвета:

• Красный — неактивен
• Жёлтый цвет лицензии — до даты окончания лицензии осталось менее 10 дней.
• Зеленый — активен

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

Справа сверху отображаются иконки интерфейса:

• RU — выбор языка интерфейса. По умолчанию стоит русский язык, чтобы изменить язык, нажмите на иконку
• Пользователи — список пользователей заведения 
• Протокол — страница с логом действий пользователя. Можно выбрать конкретного пользователя и задать дату и время
• Задачи — страница с логом синхронизации сервера. 
• Выход — выход из личного кабинета.

Теперь необходимо подключить к личному кабинету кассовый сервер и сервер KDS PRO. Начнем с кассового сервера.
После авторизации в личном кабинете система предложит выбрать корпорацию. Начните вводить цифры вашей корпорации, чтобы найти свою корпорацию

Появится список объектов корпорации. Выберите нужную. Если объектов много, вы можете начать вводить в поисковой строке код объекта, чтобы ускорить поиск. 
Нажмите на нужный объект

Вы попадете на страницу серверов объекта, где необходимо создать сервер. Для этого:

1. Нажмите на кнопку Новый сервер
2. Введите название сервера
3. Нажмите кнопку Создать.

Список серверов пополнится созданным.

Далее необходимо настроить подключение к кассовому серверу. Для этого:

1. Нажмите кнопку с тремя линиями  и выберите пункт Настройки
   
2. Перейдите в раздел Связь с RK7 > Кассовые Серверы
3. Нажмите кнопку Добавить 
4. В списке появятся поля для заполнения:
   • Адрес кассового сервера. В нашем случае это 127.0.0.1. Указывайте локальный, а не внешний IP-адрес.
   • Порт кассового сервера. Этот порт задаётся в поле HTTP Data Port кассового сервера. В нашем случае это 8086.
   • Логин пользователя r_keeper 7, которого создали ранее. У него должен быть доступ к HTTP-интерфейсу.
   • Пароль этого пользователя.
     

     

5. Нажмите кнопку Сохранить.
6. Кассовый сервер настроен.

Далее необходимо настроить интерфейс получения заказов. Соединение с ним можно зашифровать, но это необязательно.

1. Перейдите в личном кабинете Настройки сервера > Интерфейс получения заказов 
2. Заполните поля Пользователь и пароль для шифрования интерфейса. Это поле можно не заполнять, но мы рекомендуем использовать их заполнить. Можно указать любые желаемые значения. Для примера мы используем логин lol и пароль 123
   

   

3. Нажмите кнопку Сохранить
   
4. Перейдите в менеджерскую станцию r_keeper
5. Перейдите в меню Сервис > Станции и устройства

6. Выберите настроенный ранее кассовый сервер

   Начиная с версии 7.6.5.371 настройки Http Order Notify переместились в Свойства кассового сервера. У версий r_keeper 7.6.5 и старше раскройте раздел HTTP Order Notify

7. Вставьте строчку подключения в поле DestURLs драйвера HTTP Order Notify кассового сервера  в виде:
   https://имя_пользователя:пароль_пользователя@адрес_сервера_KDS_PRO:порт_сервера_KDS_PRO/orderTaker
   Например: https://lol:123@127.0.0.1:1234/orderTaker. Если используется нестандартный порт, замените 1234 на свой порт.
   

   

   
   a. Если требуется указать несколько строчек подключения, их можно указать через точку запятой ";".
   Например: http://lol:123@127.0.0.1:1234/api/httpNotify/postOrders;https://lol:123@127.0.0.1:4321/orderTaker
   

   

   
   
8. Сохраните изменения.

Интерфейс получения заказов настроен.

Далее необходимо пролицензировать сервер. Для этого:

1. Нажмите значок с тремя линиями и выберите пункт Получить лицензию
   

   

2. Откроется страница получения лицензии
3. Перейдите на вкладку Новая 
4. Выберите тип лицензии. Тип зависит от версии сервера
   • Версия до 1.6.0
   • Версии после 1.6.0
5. Выберите подходящую мастер-лицензию из списка
   

   

6. Укажите количество пользователей
7. Нажмите кнопку Сгенерировать
8. Сервер проверит лицензию и активирует ее. Появится сообщение об успешном получении лицензии
   
9. Сервер станет зеленого цвета и у него появится информация о лицензии.
   

Готово. Лицензия активирована.

После создания и лицензирования сервера в личном кабинете необходимо создать клиентов. Их может быть несколько, но не больше числа мастер-лицензий в системе лицензирования.
Для создания клиента

1. Нажмите на нужный сервер
2. Откроется страница Клиенты сервера. Нажмите кнопку Новый клиент
3. В появившемся окне настроек введите: 
   1. Название клиента — используется для авторизации в клиенте KDS PRO
   2. Название профиля — будет отображаться в клиенте KDS PRO
      В названиях клиента и профиля можно использовать русский язык и пробелы. Регистр не важен.
   3. Выберите Шаблон профиля.
      Шаблон профиля — это набор предустановленных настроек, примерно соответствующих названию профиля.
      

      

4. Нажмите на кнопку Добавить.

Нажмите на профиль, чтобы попасть в его настройки. Здесь можно:

• Настроить жизненный цикл заказа
• Настроить действия, возможные на этом клиенте
• Настроить фильтр заказов
• Настроить параметры, отображения заказа
• Настроить внешний вид, звуки и таймеры

Подробнее о каждом разделе настройки профиля читайте в серии статей Настройка профиля (экранной формы).

Если вы хотите создать и сохранить настройки профиля для будущего использования, их можно экспортировать. Для этого:

1. Нажмите на кнопку Экспорт в верхней части меню
2. Введите название шаблона и нажмите кнопку Экспорт

Теперь при создании клиента можно выбрать созданный шаблон