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

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

===== XML-интерфейс =====

Модуль работает с кассовым сервером через HTTP-XML интерфейс. Настройка сервера и работника с полными правами на кассовые операции - в статье [[external:zz_дополнительные_материалы:02_xml_interfaсe_rkeeper|Настройка XML интерфейса]].

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

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

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

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_01.png |Стол для заказов доставки в r_keeper}}

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

В Яндекс уходят только блюда из выбранной классификации:
  - Меню -> Классификации блюд: создать классификацию "Яндекс Еда", статус "Активный".
  - Создать в ней категории с теми названиями, которые должны быть у разделов меню в Яндекс Еде, сделать их активными.
  - Расставить категории блюдам, которые нужно выгружать.

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_02.png |Классификация "Яндекс Еда" и ее категории}}

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

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

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

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_03.png |Категория заказа "Яндекс (доставка)"}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_04.png |Привязка категории заказа к столу доставки}}

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

Если в Яндексе цены отличаются от цен в зале, создать отдельный [[https://docs.rkeeper.ru/rk7/latest/ru/spravochnik-tipy-tsen-4038039.html|тип цен]] и привязать его к категории заказа. Модуль берет цены по станции, столу "Курьер Яндекса" и категории заказа из настроек. Блюдо без цены уйдет в Яндекс с ценой 0.

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_05.png |Тип цен для доставки}}

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

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

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_06.png |Блюдо доставки с открытой ценой}}

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

Название для Яндекса берется из расширенного свойства блюда с системным именем **yaedaname**. Если оно пустое - используется имя блюда. Название должно быть без спецсимволов, без ошибок и без граммовки.
  - Настройки -> Настройка -> Расширенные свойства -> "Свойства для справочников", ПКМ -> Новый тип расширенных свойств. Задать название (например, "Название для Яндекс Еды") и системное имя ''yaedaname''.
  - В "Список типов" добавить элемент: группа "Меню, Модификаторы, Цены" -> "Элемент меню".
  - Перезапустить менеджерскую часть. Поле появится в свойствах блюд.

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_07.png |Расширенное свойство yaedaname}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_08.png |Элемент меню в списке типов}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_09.png |Название для Яндекс Еды в свойствах блюда}}

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

Создать две суммовые скидки: "Скидка на блюдо" (акции Яндекса на отдельные блюда) и "Скидка на заказ" (промокоды, скидки на весь заказ). Параметры:
  * суммовая;
  * не вручную;
  * на блюдо / на заказ - соответственно;
  * многократно;
  * изменяемое значение;
  * комбинировать с любой скидкой.

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

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_10.png |Скидка на блюдо}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_11.png |Скидка на заказ}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_12.png |Блюдо для акции: свободная цена}}

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

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

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

Веб-интерфейс модуля открывается на кассе кнопкой с главного экрана. Настройка - в статье [[external:zz_дополнительные_материалы:05_nastroika_knopki_na_kasse|Настройка связи с другими системами для кассы]]. В свойстве "Строковый" указать адрес вида ''%%http://192.168.0.1:5000?source=rk7%%'', где 192.168.0.1 - IP машины с модулем, 5000 - порт модуля. После этого перезапустить MID-сервер и кассу.

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_13.png |Кнопка модуля на главном экране кассы}}

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

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_14.png |Расширенное свойство yaedadlvAdress}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_15.png |Тип "Ресторан" в списке типов}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_16.png |URL web-сервиса в параметрах}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_17.png |Адрес модуля в свойствах ресторана}}

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

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_18.png |Селекторы главного меню}}

{{ :external:черновик_интеграция_с_агрегаторами_доставки:s1_19.png |Оформление кнопки модуля}}