Введение

В статье описано, как настроить систему r_k Delivery, если у вас уже есть r_keeper 7, но не установлен White Server Agent.

r_keeper 7

  • Операционная система: Windows 10 (Windows 7 будет поддерживаться до 1.07.2025)
  • Процессор: Intel Core i5
  • Оперативная память: 8 ГБ
  • Скорость интернет-соединения: 1 Mбит/сек.
  • MS SQL Server 2014 (MS SQL Server 2012 будет поддерживаться до 1.07.2025)

r_k Delivery

  • Компьютер, планшет или кассовая станция с доступом в интернет
  • Браузер Google Chrome 85.0.0+
  • Касса r_keeper из версий ниже
  • Установленный и настроенный WhiteServer Agent v2

Версии r_keeper 7

Для работы работы с r_k Delivery подойдут следующие версии r_keeper 7:

  • В ветке 7.6.2 — версии от 7.6.2.156 и выше
  • В ветке 7.6.4 — версии от 7.6.4.100 и выше
  • В ветке 7.6.5 — любая версия
  • В ветке 7.7.0 — любая версия

Версия WSA v2

  • Не ниже 2.6.1.3

Краткое описание процесса

Для того, чтобы подключиться к системе, необходимо выполнить ряд действий:

  1. Получите лицензии
  2. Установите и настройте WSA v2
  3. Получите доступ к r_k Office
  4. Сделайте настройки в r_k Delivery

Обратите внимание: к одной учетной записи в системе лицензирования может быть привязана только одна корпорация и учетная запись в r_k Office
Если к одной учетной записи будет привязано несколько корпораций или личных кабинетов в r_k Office, настройку r_k Delivery будет выполнить невозможно.

Видеоинструкция по внедрению ниже:

Подключение к системе

Получение лицензий

Перед началом работы убедитесь в наличии необходимых лицензий в системе лицензирования.

Для работы White Server Agent необходима лицензия — Интерфейс White Server 

Для работы системы доставки требуется минимум 3 лицензии:

  1. R-Keeper модуль Интерфейс к r_keeper Delivery

  2. R-Keeper модуль Delivery_Base
  3. R-Keeper модуль Delivery_Filial

  4. R-Keeper модуль XML-интерфейс для WSA ПО
Подождите, пока данные из системы лицензирования подтянутся в WSA. Это может занять около часа.

Другие варианты лицензирования смотрите в статье Лицензирование

Установка и настройка WSAv2

  1. Откройте ссылку  ftp://ftp.ucs.ru/WS/WSAgent/versions/  в проводнике или FTP-клиенте
  2. Авторизуйтесь с помощью Dealer ID
  3. Выберите последнюю версию установщика и скачайте ее на компьютер. Проще всего это сделать, отсортировав файлы по дате изменения
  4. Запустите установщик и выполняйте шаги указанные в мастере установки
  5. Выберите язык установки
  6. Выберите регион сервера:
    Ru — для подключения к RU серверу
    Eu — для подключения к EU серверу
    Test — для подключения к тестовому серверу.

    Серверы изолированы и не синхронизированы друг с другом. При выборе сервера учитывайте, что интеграционные решения, в том числе Доставка r_k Delivery и сами объекты, должны работать в зоне размещения сервера.

    Если на вашем компьютере при установке WSA включена какая-то из систем r_keeper (например, кассовый сервер), то шаги с 7 по 12 могут не возникнуть, т.к. WSA самостоятельно заберет необходимые данные.

  7. Выберите системы, к которым будет подключен агент
  8. Укажите путь к папке сервера справочников. Поле Порт XML-интерфейса   заполнится автоматически после указания правильного пути.

    Обратите внимание!

    Для настройки r_k Cloud в этом окне снимите флаг "Сервер справочников установлен локально" и вместо поля "Путь к установленному R-Keeper" заполните поле "IP сервера справочников". Укажите нужный порт XML-интерфейса.
  9. Нажмите Далее. Установщик укажет, какие настройки следует выполнить в менеджерской станции:
    1. Откройте менеджерскую станцию и перейдите в меню  Настройки > OLAP отчеты > Серверы отчетов 
    2. Выберите желаемый сервер отчетов или справочников
    3. В разделе XML-интерфейс укажите Порт привязки. Порт должен быть свободен и доступен по сети
    4. В разделе HTTP Server укажите свободный порт в поле  HTTP Data Port, при этом настройка  Use Free Listen Port должна быть отключена
    5. Сохраните изменения и согласитесь с предупреждениями о том, что сервер должен быть перезагружен
    6. В разделе HTTP Ограничения укажите во всех полях право  HTTP Access
    7. Если привилегия  HTTP Access  отсутствует, то создайте новую привилегию с таким именем.

    8. Перезапустите сервер справочников или отчетов. После перезагрузки сервера настройки в json-файле WSA v2 обновятся.
    9. Перезапустите кассовый сервер
    10. В установщике поставьте флаг  Готово
  10. Укажите путь к папке кассового сервера. 
      
  11. На шаге настройки StoreHouse 5 укажите:
    1. IP — адрес расположения StoreHouse 5
    2. Port — укажите порт Web API 
    3. Пользователь — укажите логин пользователя в Store House 5
    4. Пароль — укажите пароль этого пользователя.
      Нажмите кнопку Далее. 
  12. На шаге перезапуска RK:
    1. Выключите кассовый сервер и поставьте галочку  r-keeper остановлен
    2. Поставьте галочку Файл скопирован, копировать ничего не нужно
    3. Запустите кассовый сервер и поставьте галочку  r-keeper запущен
    4. Нажмите кнопку Далее
  13. Нажмите  Установить
  14. Дождитесь, пока WSA установится на ваш компьютер.
    При установке WSA проверит, пролицензирован ли r_keeper. О необходимых лицензиях читайте в статье Лицензирование. 
    Если все хорошо, то после установки агент будет запущен.

Установка WSA v2 успешно завершена.


Дополнительную информацию по отдельной установке WSA v2  читайте в статье Установка White Server Agent v2

Проверка подключения WSA

Для работы системы доставки требуется настроенная связь с r_keeper WSA v2.

  1. Перейдите в административную панель WhiteServer. адрес электронной почты и пароль, выданный в письме из отдела лицензирования при получении доступа к системам r_keeper.  Нажмите кнопку Войти.  
  2. Перейдите в раздел Рестораны
  3. Укажите полный код объекта в поле ObjectId и нажмите кнопку Найти
  4. Перейдите в меню редактирования ресторана, нажав на шестеренку . Откроется карточка ресторана.
  5. Убедитесь, что раздел Подключенные системы синего цвета и выбран включенный агент для RKMid
  6. Перейдите в меню Параметры создания заказа
  7. Нажмите кнопку Обновить справочники, чтобы параметры загрузились с кассового сервера.
  8. Необходимые настройки для подключения к Delivery будут заполнены автоматически. Детальные описания параметров находятся в таблице ниже:
    • Идентификатор кассира
    • Код стола
    • Идентификатор кассы
    • Код типа заказа
    • Код категории заказа
    • В блоке Необязательные параметры:
      • Выберите Валюту заказов. Укажите валюту, которая используется для онлайн-оплат.
      • Код селектора меню — оставьте пустое значение
      • Укажите Причину отмены заказа
      • В поле Время подтверждения заказа в секундах — укажите 0
      • Включите настройку Cоздавать не подтвержденный заказ 
      • Выключите настройку Создавать заказ как черновик

        Внимание!
        Если пропустить настройку Необязательных параметров, то r_k Delivery может работать некорректно.

    • Сохраните изменения, нажав кнопку Сохранить
  9. Новые настройки применятся для агента с ролью RkMid.

Системы r_keeper 7 и r_k Delivery связаны между собой и готовы к работе.

Получение доступа к r_k Office

Чтобы получить доступ к административной панели r_k Delivery, необходимо сначала получить доступ к системе r_k Office.
Доступ к личному кабинету r_k Office открывает дилер.

Для подключения необходимы следующие данные:

  • Телефон пользователя
  • ФИО пользователя
  • Код корпорации
  • Код объекта 
  • Email
  • Укажите, что необходим доступ к r_k Delivery.

После того как заявка будет выполнена, вам на почту придут логин и пароль для доступа к r_k Office:

Настройки в административной панели

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

В r_k Delivery есть несколько подсистем:

Авторизуйтесь в r_keeper Office, используя данные из полученного письма и перейдите в r_k Delivery.

При первом входе в административную панель потребуется указать код корпорации.

Код корпорации - это тот же код, который был указан в заявке для доступа в r_k Office.
Название корпорации появится над кнопкой выхода.

После указания корпорации начнется загрузка заведений с активной лицензией на r_k Delivery. Процесс займет не больше 5 минут.

Если вы не указали код корпорации, а страница куда-то исчезла, перейдите по ссылке https://delivery.ucs.ru/adminka/corporations/import.

Заполнение данных заведения

После ввода кода корпорации система загрузит меню из r_keeper 7 без фильтров. Если меню не загрузилось, посмотрите соответствующую статью.

Перейдите в меню Заведения и выберите свое из списка. Нажмите на него и укажите:

  • Фактический адрес
  • Юридический адрес
  • Часовой пояс
  • задайте ограничения для выгрузки меню. Рекомендуем указать категорию заказа.

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

Создание сотрудников

Без сотрудников не может работать ни одна система доставки. В r_k Delivery есть 2 роли сотрудников:

Для работы в интерфейсе заведения необходимо создать хотя бы 1 сотрудника с ролью Менеджер доставки.

Зоны доставки и курьеры

По умолчанию в r_k Delivery доступен только самовывоз. Для доставки заказов необходимо настроить зоны доставки и курьеров.

При создании заказа на доставку система проверяет адрес гостя и определяет подходящее заведение по зоне доставки.

Статусы заказа

В системе уже существуют предустановленные Статусы заказа. Если их недостаточно, добавьте свои. Здесь же можно настроить причины отмены заказа.

При возникновении проблем с нехваткой времени  при создании заказа — настройте время выполнения заказ согласно инструкции Настройки

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

Создание тестового заказа

Ну и последнее, что требуется сделать — создать тестовый заказ. 

  1. Перейдите в интерфейс заведения
  2. Нажмите кнопку
  3. Укажите имя, телефон, адрес и другие данные
  4. Добавьте в заказ блюда из меню
  5. Выберите способ оплаты
  6. Готово, заказ создан, все настроено правильно.