Введение и сокращения

Интеграция с DeliveryClub работает через White Server Agent.

  1. WS — White Server
  2. WSA, WSAgent, WS-агент — White Server Agent

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

  • WSA — 1.14.0.31+
  • r_keeper — 7.6.2.156+ или 7.6.4.100+

WSAgent доступен по следующей ссылке: ftp://ftp.ucs.ru/WS/WSAgent/versions/.

Утилиты для лицензирования и регистрации кассовых серверов на стороне WS доступны по ссылке: ftp://ftp.ucs.ru/WS/WSAgent/tools/

Лицензирование

Для работы необходимо наличие следующих мастер-лицензий в системе лицензирования:

  1. Лицензия — Интерфейс White Server для работы WS-агента
  2. Лицензия по подписке — R-Keeper модуль Интерфейс к DeliveryClub ПО для связи агрегатора и ресторана

Процесс получения новых лицензий описан в статье о системе лицензирования. Если мастер-лицензии есть, но они их срок действия заканчивается — сделайте заявку на Продление мастер-лицензий и перегенерируйте лицензию.

Настройка интеграции

r keeper 7

  1. Для связи r_keeper_7 и WS добавьте на кассовый сервер драйвер XML-интерфейса и укажите ему свободный порт. Привяжите драйвер к логическому интерфейсу

    Если WSA и r_keeper установлены на разных компьютерах, используйте шифрование — укажите пароль в поле CryptKey.
  2. Создайте стол, на который будут записываться заказы. Зайдите в Настройки > Столы и залы > План залов и столы и создайте новый план зала
  3. Создайте работника-официанта, через которого будет пробиваться заказы на кассе. Зайдите в Персонал > Работники, и создайте нового работника. Назовите пользователя WSA, укажите пароль и активируйте
  4. Сохраните и закройте меню Работники
  5. Создайте причину внесения предоплат. Перейдите в меню Деньги > Причины внесения/выдачи денег
  6. Нажмите правой кнопкой мыши на свободном месте и выберите пункт Новая причина внесения/выдачи денег
  7. Назовите новую причину — Предоплата, активируйте и сохранитесь
  8. Перезапустите кассовый сервер.

WS-агент

  1. Скачайте последнюю версию WSA с FTP-сервера: ftp://WS/WSAgent/versions/
  2. Добавьте папку с агентом в исключения антивирусной программ — иначе возможна блокировка агента и не будет работать автоматическое обновление.
  3. Запустите WhiteServerAgentConf.exe и войдите под Dealer ID
  4. Проверьте обновления. Перейдите на вкладку Обновление и нажмите кнопку Обновить данные
  5. Если обновления есть — нажмите кнопку Скачать, а затем Обновить.
    1. Если WS не обновляется сам, остановите службу и закройте конфигуратор. 
    2. Зайдите в папку WS\updates и распакуйте с заменой новые версии.
  6. На вкладке Общее выберите систему, с которой настраиваете интеграцию. В нашем случае это RK7 — отметьте его галочкой.

    При использовании прокси-сервера, укажите параметры прокси.
  7. Перейдите на вкладку RK7 и укажите параметры созданного XML-интерфейса. CryptKey указывайте, если он есть в настройках интерфейса
  8. Нажмите кнопку Check connection. WSA проверит связь с кассовым сервером. Если всё в порядке, в разделе Заказы появятся значения [Не выбрано]
  9. Заполните блок Заказы
    1. Укажите кассовую станцию в поле Станция
    2. Выберите тип цены
    3. Выберите стол по умолчанию
    4. Выбирети причины внесения предоплаты — Предоплата
    5. Выберите созданного ранее работника для оплаты — WSA
    6. Выберите причину отмены заказа по умолчанию
    7. Отметьте необходимые галочки по желанию.
  10. Получение необходимы лицензий описано в разделе Лицензирование.
    Перейдите на вкладку Лицензирование и выберите объект. Нажмите на него 2 раза. Появится окно получения лицензии.
  11. Укажите дату окончания лицензии. Кнопка MaxDate служит для выбора максимальной даты
  12. Нажмите кнопку Далее... 

    Лицензия активирована.
  13. Перейдите на вкладку DeliveryClub
  14. Включите параметр Включено в разделе Интеграция с DeliveryClub 
  15. Укажите IP-адрес, на котором будет работать веб-интерфейс принятия заказа. Веб-интерфейс устанавливается вместе с WS-агентом и загружается на кассах. Кассы будут обращаться по этому адресу и получать в ответ веб-форму. 
    Не указывайте localhost — это неверно!
  16. Выберите, что делать с заказом, если кассир его не принял:
    1. Автоматически создавать на кассе
    2. Отклонять с ошибкой
  17. Укажите коды категорий заказов для создаваемого заказа.
    1. OrderCategoryCode — код категории заказа. Посмотреть можно в Заказ > Категории заказа
    2. OrderTypeCode — Код типа заказа, необязательное поле. Указывайте в случае, если в r_keeper настроено использование типа заказа. Посмотреть можно в Заказ > Типы заказа
    3. Укажите Валюту для онлайн оплаты
  18. Перейдите на вкладку White Server и укажите путь к White Server: https://ws.ucs.ru/WSServerLP
  19. Проверьте соединение кнопкой Check connection. Ошибок быть не должно.
  20. На вкладке Служба отображается статус службы WSA. Если служба не установлена, нажмите кнопку Установить
  21. Нажмите кнопку Применить настройки и перезапустить службу для сохранения настроек.

Работа на кассовой станции

Исходим из того что внешний заказ уже принят от DeliveryClub и открыт через WebInterface на кассовой станции.

Заказ не принят кассиром. В настройках WSAgent включен параметр Отклонить заказ — появится выбор причины отклонения заказа.

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

Если необходимо найти заказ по номеру, то нажмите на блок Комментарий и поле Фильтр по комментарию введите номер заказа.