external:интеграция_с_агрегаторами_доставки:01preliminary_config_rk7

Различия

Показаны различия между двумя версиями страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия		 Предыдущая версия
external:интеграция_с_агрегаторами_доставки:01preliminary_config_rk7 [2024/06/26 07:10] – Евгений Горностальexternal:интеграция_с_агрегаторами_доставки:01preliminary_config_rk7 [2026/08/17 16:05] (текущий) – Евгений Горносталь
Строка 1: Строка 1:
 ====== Предварительные настройки в r_keeper ====== ====== Предварительные настройки в r_keeper ======
  
-===== Создание расширенного свойства для названий блюд =====+===== Настройка XML интерфейса =====
  
-**ВАЖНО!!! Обязательно ** создаём **__расширенное свойство__**  в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным. +Модуль интеграции взаимодействует с кассовым сервером r_keeper с использованием XML-HTTP интерфейса. Настройка Сервера и Работника подробно описана в статье: [[external:zz_дополнительные_материалы:02_xml_interfaсe_rkeeper|Настройка XML интерфейса]]
- +
-<hidden> +
- +
-Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени пограммовку +
- +
-Настройки → Настройка → Расширенные свойства. +
- +
-{{  :internal:pasted:20210616-171438.png  }} +
- +
-В открывшемся окне переходим в "Свойства для справочников", ПКМ → Новый тип расширенных свойств. Задаём название и **"Список типов"** - Элемент меню +
- +
-{{  :internal:pasted:20210629-080040.png  }} +
- +
-Открыв окно "Список типов" жмём ПКМ и "Добавить элемент" +
- +
-{{  :internal:pasted:20210629-080431.png  }} +
- +
-Выбираем группу "Меню, Модификаторы, Цены" → Элемент меню{{  :internal:pasted:20210629-080632.png  }} +
-После настройки расширенного свойства необходимо перезапустить менеджерскую часть +
- +
-Пример: +
- +
-{{  :internal:pasted:20210629-082302.png  }} +
- +
-</hidden>+
  
 ===== Создание стола для сохранения заказа ===== ===== Создание стола для сохранения заказа =====
  
-<hidden> 
  
-Настройки - столы и залы - планы залов и столы. Создаём отдельный план зала(например, Доставка) и стол, защищаем кассовым правом.+Настройки → Столы и залы → Планы залов и столы. Создаём отдельный план зала(например, Доставка) и стол. 
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_14-52-12_3_.png |}}
  
-{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210705-154519.png  }}+===== Настройка классификаций блюд =====
  
-</hidden>+Для синхронизации меню между r_keeper и Яндекс.Еда необходимо указать какие блюда следует выгружать, а какие нет. Для этого необходимо создать новую классификацию блюд:
  
-===== Если в ресторане есть платная доставка =====+  - В справочнике Меню → Классификации блюд создать новую классификацию "Яндекс.Еда". Установить статус-"Активный". 
 +  - Для данной классификации создать новые категории (с такими же названиями, как и разделы меню в Яндекс.Еде), сделать их активными. 
 +  - Расставить категории всем имеющимся блюдам. 
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_16-33-47_2_.png |}}
  
-<hidden>+===== Создание "Категории заказа" =====
  
-Яндекс.Еда передаёт информацию о стоимости доставки курьерами ресторана. Для этого в кипере создаём блюдо с открытой ценой (при дальнейших настройках приложения интеграции это блюдо будет выбираться в специальном поле)+Заказ → Категории заказа. Нужно создать отдельную категорию заказа "Яндекс (доставка)" и настроить использование этой категории заказа для стола доставки. 
 +Пример настройки: 
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-27_15-31-56.png |}}
  
-{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210813-150237.png  }}+После создания отдельной Категории заказа нужно, через справочник "Использование категорий заказа" (Значок шестерёнки) привязать созданный стол для доставки. 
 +Для этого после открытия справочника "Использование категорий заказа", перетащить ЛКМ нужную категорию и указать стол для доставки. 
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_11-19-34_2_.png |}}
  
-</hidden>+====== Типы цен ====== 
 +Если блюда выгружаемые на сайт имеют другие цены, то создаётся отдельный тип цен и привязывается к категории заказа. Подробнee в [[https://docs.rkeeper.ru/rk7/latest/ru/spravochnik-tipy-tsen-4038039.html|статье]]  
 +{{ :external:интеграция_с_агрегаторами_доставки:pasted:20241108-103519.png |}}
  
-===== Создание "категории заказа" =====+После того как был добавлен новый тип цен, нужно отправить заявку в Яндекс.Еда через чат поддержки с типом Обновить парсинг, а в комментарии указать какой тип цены использовать.
  
-<hidden>+===== Настройка платной доставки =====
  
-Заказ - категории заказа. Создаём отдельную категорию заказа "Яндекс (доставка)". Настраиваем использование этой категории заказа для стола доставки.+Яндекс.Еда передаёт информацию о стоимости доставки курьерами ресторана. Для этого в r_keeper создаём блюдо с открытой ценой (при дальнейших настройках приложения интеграции это блюдо будет выбираться в специальном поле) 
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-22-13.png |}}
  
-</hidden> +===== Создание расширенного свойства для названий блюд =====
- +
-===== Создание работника для xml =====+
  
 +Обязательно нужно создать **расширенное свойство**  в RK7 с системным именем **yaedaname**. Это поле появится в справочнике "Меню" в свойствах блюд. В него необходимо вписывать названия блюд в соответствии с требованиями "Яндекса". Если название соответствует сразу - поле можно оставлять незаполненным. Название блюда для Яндекс.Еды должно быть без спец.символов, без орфографических ошибок и не иметь в имени указаний на граммовку.
 <hidden> <hidden>
 +Что бы настроить свойство нужно перейти в r_keeper Настройки → Настройка → Расширенные свойства. В открывшемся окне нужно перейти  в "Свойства для справочников", ПКМ → Новый тип расширенных свойств. Для типа нужно задать название и системное имя.
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-39-15.png |}}
  
-  * В справочнике Персонал→Работники создать новую роль с названием "XML-Editing", поставить статус-"Активный", выдать группе максимум кассовых прав (Секция "Кассовые ограничния - операции". +Далее нужно добавить "Элемент меню" в "Список типов". Для этого двойным щелчком ЛКМ нужно перейти в новое поле списка типов и этого через ПКМ в открывшемся меню нажать "Добавить элемент". Выбираем группу «Меню, Модификаторы, Цены» → "Элемент меню" 
-  * Для новой роли создать работника с именем http (либо другое, написанное на латинице), поставить статус-"Активный" +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-35-29.png |}} 
-  * Для работника с именем http, в свойствах в параметре «Учетная запись» задать произвольный пароль. +После чего в поле списка типов добавится элемент. 
-  * В свойствах группы работников в "Привилегиях на объекты" «HTTP Access»,«Тип цены основная», «Фискальные отчеты» поставить галочку. Привилегия "HTTP Access" должна быть предварительно создана. +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-37-03.png |}} 
-  * Не забываем добавить роли право "Яндекс еда" +После настройки расширенного свойства необходимо перезапустить менеджерскую часть
- +
-Право создаётся в справочнике Персонал → Права +
- +
-{{  :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 и Яндекс.Еда необходимо указать какие блюда следует выгружать, а какие нет. Для этого необходимо создать новую классификацию блюд: +
- +
-  - В справочнике Меню → Классификации блюд создать новую классификацию "Яндекс.Еда". Установить статус-"Активный". +
-  - Для данной классификации создать новые категории (с такими же названиями, как и разделы меню в Яндекс.Еде), сделать их активными. +
-  - Расставить категории всем имеющимся блюдам. +
- +
-{{  :external:интеграция_с_агрегаторами_доставки:pasted:20210708-081930.png  }}+
  
 +Пример:
 +{{ :external:интеграция_с_агрегаторами_доставки:2024-06-26_15-46-27_2_.png |}}
 </hidden> </hidden>
  
 ====== Настройка "веб-сервиса" ====== ====== Настройка "веб-сервиса" ======
  
-<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 и Кассу. В результате на кассе будет открывать веб-интерфейс приложения с главного экрана кассы (см.скриншот)
-Настройки → Параметры → Установочные → Связь с другими системами → Сервисы +
- +
-В свойстве "Строковый" пишем адрес и порт модуля в формате [[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  }} {{  :internal:pasted:20210615-122335.png  }}
- 
-</hidden> 
  
  
-===== Настройка веб-сервиса через расширенное свойство =====+=== Настройка веб-сервиса через расширенное свойство ===
 Опциональная настройка, нужна если используется несколько сервисов с разными адресами. Опциональная настройка, нужна если используется несколько сервисов с разными адресами.
  
 <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]
Строка 162: Строка 88:
 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]]**
Строка 170: Строка 96:
 **5000**  - порт по умолчанию **5000**  - порт по умолчанию
  
-{{  :internal:pasted:20210629-141328.png  }}+{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_17-30-34_2_.png |}}
  
 </hidden> </hidden>
  
-===== Изменение внешнего вида кнопки запуска на кассе (опционально) =====+=== Изменение внешнего вида кнопки запуска на кассе (опционально) ===
  
 <hidden> <hidden>
Строка 182: Строка 108:
 Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов) Настройки → Графический интерфейс → Селекторы. Выбираем группу селекторов, которая используется (можно посмотреть в Настройки → Графический интерфейс → Использование селекторов)
  
-{{  :internal:интеграция_яндекс.еда_-_rk7:pasted:20210702-082250.png  }}+{{ :external:интеграция_с_агрегаторами_доставки:2024-07-10_16-53-53.png |}}
  
 Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис" Затем открываем макет Главного меню и переходим к настройке кнопки "Сервис"
Строка 190: Строка 116:
 </hidden> </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>
  
  • external/интеграция_с_агрегаторами_доставки/01preliminary_config_rk7.1719375024.txt.gz
  • Последнее изменение: 2024/06/26 07:10
  • — Евгений Горносталь