Содержание

1. Предварительные настройки в r_keeper

До установки модуля в менеджерской части r_keeper нужно завести все, что потом выбирается в настройках модуля. Списки в модуле заполняются из справочников r_keeper, правка справочника доходит до модуля в пределах минуты.

XML-интерфейс

Модуль работает с кассовым сервером через HTTP-XML интерфейс. Настройка сервера и работника с полными правами на кассовые операции - в статье Настройка XML интерфейса.

Столы для заказов

Настройки → Столы и залы → Планы залов и столы. Создать отдельный план зала (например, «Доставка») и стол. Модуль умеет разносить заказы по типу доставки (курьер Яндекса, свой курьер, самовывоз) и по платформе (Яндекс Еда, Маркет Деливери) на разные столы, но можно обойтись одним.

Стол «Курьер Яндекса» модуль также использует для получения цен и стоп-листа меню - он должен быть активным.

Стол для заказов доставки в r_keeper

Классификация для меню

В Яндекс уходят только блюда из выбранной классификации:

  1. Меню → Классификации блюд: создать классификацию «Яндекс Еда», статус «Активный».
  2. Создать в ней категории с теми названиями, которые должны быть у разделов меню в Яндекс Еде, сделать их активными.
  3. Расставить категории блюдам, которые нужно выгружать.

Классификация "Яндекс Еда" и ее категории

В меню попадают только категории, в которых есть блюда. Комбо-блюда r_keeper не выгружаются.

Категория заказа

Заказ → Категории заказа: создать категорию «Яндекс (доставка)». В справочнике «Использование категорий заказа» (значок шестеренки) перетащить категорию и указать стол доставки.

Категория заказа "Яндекс (доставка)"

Привязка категории заказа к столу доставки

Тип цен (если цены доставки другие)

Если в Яндексе цены отличаются от цен в зале, создать отдельный тип цен и привязать его к категории заказа. Модуль берет цены по станции, столу «Курьер Яндекса» и категории заказа из настроек. Блюдо без цены уйдет в Яндекс с ценой 0.

Тип цен для доставки

Блюдо платной доставки

Для заказов «Свой курьер» Яндекс передает стоимость доставки. Создать блюдо со свободной ценой - оно выбирается в поле «Блюдо для платной доставки». Без него заказ с платной доставкой в r_keeper не создастся.

Блюдо доставки с открытой ценой

Расширенное свойство для названий блюд

Название для Яндекса берется из расширенного свойства блюда с системным именем yaedaname. Если оно пустое - используется имя блюда. Название должно быть без спецсимволов, без ошибок и без граммовки.

  1. Настройки → Настройка → Расширенные свойства → «Свойства для справочников», ПКМ → Новый тип расширенных свойств. Задать название (например, «Название для Яндекс Еды») и системное имя yaedaname.
  2. В «Список типов» добавить элемент: группа «Меню, Модификаторы, Цены» → «Элемент меню».
  3. Перезапустить менеджерскую часть. Поле появится в свойствах блюд.

Расширенное свойство yaedaname

Элемент меню в списке типов

Название для Яндекс Еды в свойствах блюда

Скидки для акций и промокодов

Создать две суммовые скидки: «Скидка на блюдо» (акции Яндекса на отдельные блюда) и «Скидка на заказ» (промокоды, скидки на весь заказ). Параметры:

Без этих скидок заказ с акцией или промокодом в r_keeper не создастся. Отдельные блюда для акций не нужны: в акции участвует то же блюдо, что и в меню, у него должна быть цена и флаг «свободная цена».

Скидка на блюдо

Скидка на заказ

Блюдо для акции: свободная цена

Расширенные свойства заказа (опционально)

Чтобы имя клиента, телефон и адрес доставки записывались в заказ r_keeper, завести для них расширенные свойства заказа. Потом они выбираются в модуле в группе «Свойства заказа в r_keeper».

Кнопка модуля на кассе

Веб-интерфейс модуля открывается на кассе кнопкой с главного экрана. Настройка - в статье Настройка связи с другими системами для кассы. В свойстве «Строковый» указать адрес вида http://192.168.0.1:5000?source=rk7, где 192.168.0.1 - IP машины с модулем, 5000 - порт модуля. После этого перезапустить MID-сервер и кассу.

Кнопка модуля на главном экране кассы

Если на разных ресторанах модуль стоит по разным адресам, адрес можно вынести в расширенное свойство ресторана:

  1. Настройки → Настройка → Расширенные свойства → «Свойства для справочников»: новый тип с системным именем yaedadlvAdress, в «Список типов» добавить группа «Система» → «Ресторан».
  2. Настройки → Параметры → Установочные → Связь с другими системами → Сервисы: в «URL web-сервиса» в параметре «Строковый» указать [Restaurants.genyaedadlvAdress].
  3. В свойствах ресторана (Сервис → Станции и устройства) в свойстве yaedadlvAdress вписать http://<IP модуля>:5000?source=rk7.

Расширенное свойство yaedadlvAdress

Тип "Ресторан" в списке типов

URL web-сервиса в параметрах

Адрес модуля в свойствах ресторана

Внешний вид кнопки меняется в Настройки → Графический интерфейс → Селекторы (макет главного меню, кнопка «Сервис»).

Селекторы главного меню

Оформление кнопки модуля