====== Предварительные настройки в 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 |}} ====== Типы цен ====== Если блюда выгружаемые на сайт имеют другие цены, то создаётся отдельный тип цен и привязывается к категории заказа {{ :external:интеграция_с_агрегаторами_доставки:pasted:20241108-103519.png |}} ===== Настройка платной доставки ===== Яндекс.Еда передаёт информацию о стоимости доставки курьерами ресторана. Для этого в r_keeper создаём блюдо с открытой ценой (при дальнейших настройках приложения интеграции это блюдо будет выбираться в специальном поле) {{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-22-13.png |}} ===== Создание расширенного свойства для названий блюд ===== Обязательно нужно создать **расширенное свойство** в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным. Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени указаний на граммовку. Что бы настроить свойство нужно перейти в 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 |}} ====== Настройка "веб-сервиса" ====== Пример настройки подробно описан в статье: [[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 }} === Настройка веб-сервиса через расширенное свойство === Опциональная настройка, нужна если используется несколько сервисов с разными адресами. Нужно зайти в Настройки - > Настройка → Расширенные свойства. Выбрать группу "Свойства для справочников", в окне "Типы расширенных свойств" ПКМ → Создать новый тип с названием и системным именем **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 |}} === Изменение внешнего вида кнопки запуска на кассе (опционально) === По желанию можно визуально отредактировать форму, чтобы кнопка интерфейса была более привлекательной. Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов) {{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_16-53-53.png |}} Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис" {{ :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-082402.png }} ====== Настройка скидки в r_keeper ====== Для работы со скидками в r_keeper нужно создать суммовые скидки «Скидка на блюдо» и «Скидка на заказ». Настройки в 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 |}}