| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия |
| external:интеграция_с_агрегаторами_доставки:01preliminary_config_rk7 [2021/07/12 16:02] – Алексей Коробов | external:интеграция_с_агрегаторами_доставки:01preliminary_config_rk7 [2025/02/03 11:50] (текущий) – Евгений Агеев |
|---|
| ====== Предварительные настройки в r_keeper ====== | ====== Предварительные настройки в r_keeper ====== |
| |
| ===== Создание стола для сохранения заказа ===== | ===== Настройка XML интерфейса ===== |
| |
| <hidden> | Модуль интеграции взаимодействует с кассовым сервером r_keeper с использованием XML-HTTP интерфейса. Настройка Сервера и Работника подробно описана в статье: [[external:zz_дополнительные_материалы:02_xml_interfaсe_rkeeper|Настройка XML интерфейса]] |
| |
| Настройки - столы и залы - планы залов и столы. Создаём отдельный план зала(например, Доставка) и стол, защищаем кассовым правом. | ===== Создание стола для сохранения заказа ===== |
| |
| {{ :external:интеграция_с_агрегаторами_доставки:pasted:20210705-154519.png }} | |
| |
| </hidden> | Настройки → Столы и залы → Планы залов и столы. Создаём отдельный план зала(например, Доставка) и стол. |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_14-52-12_3_.png |}} |
| ===== Создание работника для xml ===== | |
| | |
| <hidden> | |
| | |
| * В справочнике Персонал→Работники создать новую роль с названием "XML-Editing", поставить статус-"Активный", выдать группе максимум кассовых прав (Секция "Кассовые ограничния - операции". | |
| * Для новой роли создать работника с именем http (либо другое, написанное на латинице), поставить статус-"Активный" | |
| * Для работника с именем http, в свойствах в параметре «Учетная запись» задать произвольный пароль. | |
| * В свойствах группы работников в "Привилегиях на объекты" «HTTP Access»,«Тип цены основная», «Фискальные отчеты» поставить галочку. Привилегия "HTTP Access" должна быть предварительно создана. | |
| * Не забываем добавить роли право "Яндекс еда" | |
| | |
| Право создаётся в справочнике Персонал→Права | |
| | |
| {{ :external:интеграция_с_агрегаторами_доставки:pasted:20210705-155459.png }} | |
| | |
| {{ :external:интеграция_с_агрегаторами_доставки:pasted:20210705-160611.png }} | |
| | |
| </hidden> | |
| | |
| ===== Настройка Http-сервера ===== | |
| | |
| <hidden> | |
| | |
| * В справочнике Сервис→Станции и Устройства выбрать кассовый сервер, с которым будет работать модуль. | |
| * В свойствах кассового сервера задать свободный порт в параметре HTTP Data port. Оставлять порт 80 - не рекомендуется. | |
| * В параметрах HTTP API, Web interface, XML interface установить значение "HTTP Access" (это название привилегии на объект, которое также должно быть у учетки из "Персонал-работники" | |
| | |
| {{ :external:интеграция_с_агрегаторами_доставки:pasted:20210705-162712.png }} | |
| | |
| * Проверить, что у всех станций есть право "Яндекс Еда" | |
| | |
| {{ :external:интеграция_с_агрегаторами_доставки:pasted:20210705-161612.png }} | |
| | |
| </hidden> | |
| |
| ===== Настройка классификаций блюд ===== | ===== Настройка классификаций блюд ===== |
| |
| <hidden> | |
| |
| Для синхронизации меню между r_keeper и Яндекс.Еда необходимо указать какие блюда следует выгружать, а какие нет. Для этого необходимо создать новую классификацию блюд: | Для синхронизации меню между r_keeper и Яндекс.Еда необходимо указать какие блюда следует выгружать, а какие нет. Для этого необходимо создать новую классификацию блюд: |
| |
| - В справочнике Меню→Классификации блюд создать новую классификацию "Яндекс.Еда". Установить статус-"Активный". | - В справочнике Меню → Классификации блюд создать новую классификацию "Яндекс.Еда". Установить статус-"Активный". |
| - Для данной классификации создать новые категории (с такими же названиями, как и разделы меню в Яндекс.Еде), сделать их активными. | - Для данной классификации создать новые категории (с такими же названиями, как и разделы меню в Яндекс.Еде), сделать их активными. |
| - Расставить категории всем имеющимся блюдам. | - Расставить категории всем имеющимся блюдам. |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_16-33-47_2_.png |}} |
| |
| {{ :external:интеграция_с_агрегаторами_доставки:pasted:20210708-081930.png }} | ===== Создание "Категории заказа" ===== |
| |
| </hidden> | Заказ → Категории заказа. Нужно создать отдельную категорию заказа "Яндекс (доставка)" и настроить использование этой категории заказа для стола доставки. |
| | Пример настройки: |
| | {{ :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 |}} |
| |
| **ВАЖНО!!! Обязательно ** создаём **__расширенное свойство__** в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным. | После того как был добавлен новый тип цен, нужно отправить заявку в Яндекс.Еда через чат поддержки с типом Обновить парсинг, а в комментарии указать какой тип цены использовать. |
| |
| Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени пограммовку | ===== Настройка платной доставки ===== |
| |
| Настройки → Настройка → Расширенные свойства. | Яндекс.Еда передаёт информацию о стоимости доставки курьерами ресторана. Для этого в r_keeper создаём блюдо с открытой ценой (при дальнейших настройках приложения интеграции это блюдо будет выбираться в специальном поле) |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-22-13.png |}} |
| |
| {{ :internal:pasted:20210616-171438.png }} | ===== Создание расширенного свойства для названий блюд ===== |
| | |
| В открывшемся окне переходим в "Свойства для справочников", ПКМ → Новый тип расширенных свойств. Задаём название и **"Список типов"** - Элемент меню | |
| | |
| {{ :internal:pasted:20210629-080040.png }} | |
| |
| Открыв окно "Список типов" жмём ПКМ и "Добавить элемент" | Обязательно нужно создать **расширенное свойство** в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным. Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени указаний на граммовку. |
| |
| {{ :internal:pasted:20210629-080431.png }} | Что бы настроить свойство нужно перейти в r_keeper Настройки → Настройка → Расширенные свойства. В открывшемся окне нужно перейти в "Свойства для справочников", ПКМ → Новый тип расширенных свойств. Для типа нужно задать название и системное имя. |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-39-15.png |}} |
| |
| Выбираем группу "Меню, Модификаторы, Цены" → Элемент меню{{ :internal:pasted:20210629-080632.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 |}} |
| |
| {{ :internal:pasted:20210629-082302.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 }} |
| |
| В свойстве "Строковый" пишем адрес и порт модуля в формате [[http://123.123.123.123:5000?source=rk7|http://192.168.0.1:5000?source=rk7]] | |
| |
| где 192.168.0.1 - ip адрес машины, на которой запущен server.exe модуля | |
| |
| 5000 - порт модуля по умолчанию | |
| |
| \\ {{ :internal:pasted:20210629-141336.png }} | |
| |
| После этого можно будет открывать веб-интерфейс приложения с главного экрана кассы (см.скриншот) | |
| |
| {{ :internal:pasted:20210615-122335.png }} | |
| |
| ===== Настройка веб-сервиса через расширенное свойство (опционально, например, если у вас используется несколько сервисов с разными адресами) ===== | === Настройка веб-сервиса через расширенное свойство === |
| | Опциональная настройка, нужна если используется несколько сервисов с разными адресами. |
| |
| <hidden> | <hidden> |
| |
| Заходит в Настройки - > Настройка → Расширенные свойства | Нужно зайти в Настройки - > Настройка → Расширенные свойства. Выбрать группу "Свойства для справочников", в окне "Типы расширенных свойств" ПКМ → Создать новый тип с названием и системным именем **yaedadlvAdress** |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-03-06.png |}} |
| |
| {{ :internal:pasted:20210616-171438.png }} | Далее открыть "Список Типов" нажав по полю двойным кликом. В открывшемся окне ПКМ → Добавить Элемент |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-06-03.png |}} |
| |
| Выбираем группу "Свойства для справочников", в окне "Типы расширенных свойств" ПКМ → Создать новый тип с названием и системным именем **yaedadlvAdress** | Затем выбираем группу "Система" и двойным кликом добавляем "Ресторан" в список. |
| | {{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-05-00.png |}} |
| |
| {{ :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-081735.png }} | После настройки расширенного свойства нужно перейти в Настройки → Параметры → Установочные → Связь с другими системами → Сервисы |
| | |
| Открываем "Список Типов" нажав на троеточие либо двойным кликом | |
| | |
| {{ :internal:интеграция_яндекс.еда_-_rk7:pasted:20210703-143319.png }} | |
| | |
| В открывшемся окне ПКМ → Добавить Элемент | |
| | |
| {{ :internal:интеграция_яндекс.еда_-_rk7:pasted:20210703-143314.png }} | |
| | |
| Затем выбираем группу "Система" и "Ресторан" | |
| | |
| {{ :internal:pasted:20210629-141358.png }} | |
| | |
| {{ :internal:pasted:20210629-141353.png }} | |
| | |
| После настройки расширенного свойства переходим в Настройки → Параметры → Установочные → Связь с другими системами → Сервисы | |
| |
| в URL web-сервиса в параметре "Строковый" вставляем [Restaurants.genyaedadlvAdress] | в URL web-сервиса в параметре "Строковый" вставляем [Restaurants.genyaedadlvAdress] |
| yaedadlvAdress - в нашем случае и есть то самое расширенное свойство | yaedadlvAdress - в нашем случае и есть то самое расширенное свойство |
| |
| {{ :internal:pasted:20210629-141322.png }} | {{ :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]]** | В свойствах ресторана "Сервис - > Станции и устройства" заходим в Расширенные свойства и в созданном **yaedadlvAdress** прописываем строку подключения к машине с модулем интеграции в формате: **[[http://192.168.0.1:5000?source=rk7|http://192.168.0.1:5000?source=rk7]]** |
| **5000** - порт по умолчанию | **5000** - порт по умолчанию |
| |
| {{ :internal:pasted:20210629-141328.png }} | {{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-30-34_2_.png |}} |
| |
| </hidden> | </hidden> |
| |
| ===== Изменение внешнего вида кнопки запуска на кассе (опционально) ===== | === Изменение внешнего вида кнопки запуска на кассе (опционально) === |
| |
| <hidden> | <hidden> |
| Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов) | Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов) |
| |
| {{ :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-082250.png }} | {{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_16-53-53.png |}} |
| |
| Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис" | Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис" |
| </hidden> | </hidden> |
| |
| | ====== Настройка скидки в 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 |}} |
| |