Предварительные настройки в r_keeper [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Предварительные настройки в r_keeper ======

===== Настройка XML интерфейса =====

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

===== Создание стола для сохранения заказа =====


Настройки → Столы и залы → Планы залов и столы. Создаём отдельный план зала(например, Доставка) и стол.
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_14-52-12_3_.png |}}

===== Настройка классификаций блюд =====

Для синхронизации меню между r_keeper и Яндекс.Еда необходимо указать какие блюда следует выгружать, а какие нет. Для этого необходимо создать новую классификацию блюд:

  - В справочнике Меню → Классификации блюд создать новую классификацию "Яндекс.Еда". Установить статус-"Активный".
  - Для данной классификации создать новые категории (с такими же названиями, как и разделы меню в Яндекс.Еде), сделать их активными.
  - Расставить категории всем имеющимся блюдам.
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_16-33-47_2_.png |}}

===== Создание "Категории заказа" =====

Заказ → Категории заказа. Нужно создать отдельную категорию заказа "Яндекс (доставка)" и настроить использование этой категории заказа для стола доставки.
Пример настройки:
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_15-31-56.png |}}

После создания отдельной Категории заказа нужно, через справочник "Использование категорий заказа" (Значок шестерёнки) привязать созданный стол для доставки.
Для этого после открытия справочника "Использование категорий заказа", перетащить ЛКМ нужную категорию и указать стол для доставки.
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_11-19-34_2_.png |}}

====== Типы цен ======
Если блюда выгружаемые на сайт имеют другие цены, то создаётся отдельный тип цен и привязывается к категории заказа. Подробнee в [[https://docs.rkeeper.ru/rk7/latest/ru/spravochnik-tipy-tsen-4038039.html|статье]] 
{{ :external:интеграция_с_агрегаторами_доставки:pasted:20241108-103519.png |}}

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

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

Яндекс.Еда передаёт информацию о стоимости доставки курьерами ресторана. Для этого в r_keeper создаём блюдо с открытой ценой (при дальнейших настройках приложения интеграции это блюдо будет выбираться в специальном поле)
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-22-13.png |}}

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

Обязательно нужно создать **расширенное свойство**  в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным. Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени указаний на граммовку.
<hidden>
Что бы настроить свойство нужно перейти в r_keeper Настройки → Настройка → Расширенные свойства. В открывшемся окне нужно перейти  в "Свойства для справочников", ПКМ → Новый тип расширенных свойств. Для типа нужно задать название и системное имя.
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-39-15.png |}}

Далее нужно добавить "Элемент меню" в "Список типов". Для этого двойным щелчком ЛКМ нужно перейти в новое поле списка типов и этого через ПКМ в открывшемся меню нажать "Добавить элемент". Выбираем группу «Меню, Модификаторы, Цены» → "Элемент меню"
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-35-29.png |}}
После чего в поле списка типов добавится элемент.
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-37-03.png |}}
После настройки расширенного свойства необходимо перезапустить менеджерскую часть

Пример:
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-46-27_2_.png |}}
</hidden>

====== Настройка "веб-сервиса" ======

Пример настройки подробно описан в статье: [[external:zz_дополнительные_материалы:05_nastroika_knopki_na_kasse|Настройка связи с другими системами для кассы]]
В свойстве "Строковый" необходимо вписать и порт модуля в формате [[http://123.123.123.123:5000?source=rk7|http://192.168.0.1:5000?source=rk7]]
где 192.168.0.1 - ip адрес машины, на которой запущен server.exe модуля, а 5000 - порт модуля по умолчанию.
После этого нужно будет перезапустить MID и Кассу. В результате на кассе будет открывать веб-интерфейс приложения с главного экрана кассы (см.скриншот)

{{  :internal:pasted:20210615-122335.png  }}


=== Настройка веб-сервиса через расширенное свойство ===
Опциональная настройка, нужна если используется несколько сервисов с разными адресами.

<hidden>

Нужно зайти в Настройки - > Настройка → Расширенные свойства. Выбрать группу "Свойства для справочников", в окне "Типы расширенных свойств" ПКМ → Создать новый тип с названием и системным именем **yaedadlvAdress**
{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-03-06.png |}}

Далее открыть "Список Типов" нажав по полю двойным кликом. В открывшемся окне ПКМ → Добавить Элемент
{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-06-03.png |}}

Затем выбираем группу "Система" и двойным кликом добавляем "Ресторан" в список.
{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-05-00.png |}}

После настройки расширенного свойства нужно перейти в Настройки → Параметры → Установочные → Связь с другими системами → Сервисы

в URL web-сервиса в параметре "Строковый" вставляем [Restaurants.genyaedadlvAdress]

yaedadlvAdress - в нашем случае и есть то самое расширенное свойство

{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-22-25.png |}}

В свойствах ресторана "Сервис - > Станции и устройства" заходим в Расширенные свойства и в созданном **yaedadlvAdress**  прописываем строку подключения к машине с модулем интеграции в формате: **[[http://192.168.0.1:5000?source=rk7|http://192.168.0.1:5000?source=rk7]]**

здесь **192.168.0.1 **- локальный **ip адрес**  станции, на которой стоит модуль ya_eda.exe

**5000**  - порт по умолчанию

{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-30-34_2_.png |}}

</hidden>

=== Изменение внешнего вида кнопки запуска на кассе (опционально) ===

<hidden>

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

Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов)

{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_16-53-53.png |}}

Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис"

{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-082402.png  }}

</hidden>

====== Настройка скидки в r_keeper ======

Для работы со скидками в r_keeper нужно создать суммовые скидки «Скидка на блюдо» и «Скидка на заказ».

<hidden>
Настройки в r_keeper следующие:
  * Суммовая;
  * Не вручную;
  * На блюдо/На заказ - соответственно назначению;
  * Многократно;
  * Изменяемое значение;
  * Комбинировать с любой скидкой.

{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_16-42-12.png |}}
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_15-45-03.png |}}
{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_16-49-55.png |}}
</hidden>

====== Настройка блюда для акции ======
** Не требуется** создание отдельных блюд для акций. В акции могут участвовать те же блюда, что выгружаются в меню.
Что бы блюдо смогло участвовать в акции потребуется выставить блюду флаг "свободная цена", в настройках r_keeper.
**Обязательна предварительная настройка суммовых скидок!**
<hidden>
Блюдо выгруженное в меню и блюдо для акции - это одно и то же блюдо. У этого блюда должна быть выставлена цена и флаг "свободная цена".
{{ :external:интеграция_с_агрегаторами_доставки:2026-08-17_15-48-19.png |}}
После того, как настройка на стороне r_keeper выполнена в настройках модуля блюду нужно установить параметр "promos". После выгрузки меню "Яндекс" будет помечать это блюдо, как акционное.
{{ :external:интеграция_с_агрегаторами_доставки:2026-08-17_15-59-20.png |}}
Ниже представлен пример того, как блюдо будет обработано модулем.
{{ :external:интеграция_с_агрегаторами_доставки:2026-08-17_15-56-22.png |}}

</hidden>