Введение

Для работы Delivery требуется установленный White Server Agent (WSA).

Настройка агента для Delivery

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

Чтобы корректно настроить WSA для работы с r_k Delivery:

  1. Перейдите в административную панель WhiteServer. Используйте дилерский логин и пароль для доступа.

  2. Перейдите в раздел Рестораны
  3. Укажите полный код объекта в поле ObjectId и нажмите кнопку Найти
  4. Перейдите в меню редактирования ресторана, нажав на шестеренку
  5. Откроется список агентов на объекте
  6. Выберите агент и нажмите для редактирования настроек
  7. Перейдите на вкладку Конфигурация

  8. Вставьте вашу конфигурацию в белое поле ниже:

    На скриншоте приведен пример кусочка конфигурации
  9. Нажмите кнопку Применить настройки
  10. Новые настройки применятся для агента.

Параметры агента для Delivery

Пример рабочей конфигурации WSA ниже.
Отредактируйте конфигурацию под свои настройки, прежде чем использовать.

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

Формат json не поддерживает комментарии, поэтому из примера ниже их следует удалить. Удалить следует весь текст строки, начиная с //

Рекомендуемые настройки

Есть несколько параметров, которые мы рекомендуем использовать со значениями ниже:

  • "CreateOrdersAsDeffered": false,
  • "CashierTimeoutSec": 0,
  • "ConfirmOrderIfIgnoredOnKass": true

Описание этих параметров есть в таблице ниже.

Пример конфигурации агента

{
  "RKeeper": {
    "OrderCreationPreferences": {
      "PriceTypeId": 1126163,
      "DefaultStationId": 16865,
      "DefaultCashierId": 1000037,
      "DefaultTableCode": 1,
      "OrderCategoryCode": 5,
      "OrderTypeCode": 5,
      "VoidingReasonCode": 1,
      "OrderConfirmationHost": "127.0.0.1",
      "CreateOrdersAsDeffered": false, //тогда заказ появится в KDS Pro (если true - не появиться, пока не будет сохранен)
      "CashierTimeoutSec": 0, // форма принятия заказа на кассе появляться не будет, заказ сразу сохранить на кассу
      "ConfirmOrderIfIgnoredOnKass": true // Эта строчка обязательна! Требуется для сохранения заказа в кассу
     },
    "TcpConnetion": {
      "IP": "127.0.0.1",
      "Port": 2333,
      "CryptKey": "",
      "ConnectionName": "R-Keeper XML API",
      "ErrorBufferDefaulSize": 1024
    },
    "RefServer": {
      "TcpConnetion": {
        "IP": "127.0.0.1",
        "Port": 5555
      }
    }
  },
  "Kestrel": {
    "EndPoints": {
      "Http": {
        "Url": "http://0.0.0.0:5050" 
      }
    }
  }
}
YML
Порт 5050 указан для примера. Убедитесь, что он открыт. 

Доступные в конфигурации параметры описаны ниже.

Параметры для Delivery

Параметр

Обязателен?

Описание параметра

PriceTypeId

да

Идентификатор r_keeper типа цены, используемый при получении меню.

ConfirmOrderIfIgnoredOnKass

да

Требуется для сохранения заказа в кассу. Если true, агент продолжит создавать заказ, если он был проигнорирован на кассе (просрочен CashierTimeoutSec). Если false - на WhiteServer будет передано сообщение об ошибке (об отказе заказа).

OrderConfirmationHostдаВидимое на кассе r_keeper имя узла или его IP-адрес, на котором развёрнут сайт Агента с формой подтверждения создания заказа.

DefaultStationId

да

Идентификатор r_keeper кассы, на которой: будет показано окно для подтверждения создания заказа, будет создан заказ, будет оплачен заказ.

DefaultCashierId

да

Идентификатор r_keeper кассира, от имени которого будут проводится оплата заказа.

DefaultTableCode

да

Код r_keeper стола, для которого будет создан заказ.

OrderCategoryCode

да

Код r_keeper категории заказа.

OrderTypeCode

да

Код r_keeper типа заказа.

VoidingReasonCode

нет

Код r_keeper причины отмены отказа (точнее, удаления из него блюд).

CreateOrdersAsDefferedнетЕсли false — то заказ появится в KDS Pro. Если true - не появится, пока не будет сохранен.
CashierTimeoutSecнетВремя в секундах ожидания подтверждения создания заказа на кассе. По истечении этого времени окно на кассе закроется и Агент будет знать, что заказ проигнорирован.

CurrencyCode

нет

Код r_keeper валюты, которой будет проводится оплата онлайн-заказов (по умолчанию используются рубли).

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

CustomExtSource

нет

Если значение задано, при отправке заказа в r_keeper к нему добавляется атрибут "ExtSource" с этим значением. Сейчас известно только значение "42" для этого атрибута.