Интеграция r_keeper Delivery. Подключение по API
Данные, которые Вы предоставляете нам для интеграции r_keeper с мобильным приложением:
Client ID и Client Secret
Инструкция по настройке: https://docs.rkeeper.ru/delivery/podklyuchenie-po-api-4043842.htmlИдентификатор заведения (Таблица заведений, столбец "Код объекта").
Идентификатор заведения из r_keeper Delivery. Берется из таблицы заведений в столбце "Код объекта". https://delivery.ucs.ru/adminka/restaurants
- Файлы с зонами доставки из r_keeper
Инструкция по настройке: https://docs.rkeeper.ru/delivery/zony-dostavok-4043851.html
Настройка подключения по API
Для интеграции нужно создать новое подключение по API в личном кабинете r_keeper Delivery и внести ClientId и ClientSecret в настройки на портале «Платформа еДА»
Инструкция по настройке:
https://docs.rkeeper.ru/delivery/podklyuchenie-po-api-4043842.html
Настройка скидок
Интеграция с Premium Bonus
⚠️ Будут применяться только скидки и бонусы rKeeper и Premium Bonus, скидки и бонусы платформы еДА будут отключены.
Документация rKeeper: https://docs.rkeeper.ru/delivery/premium-bonus-77467895.html
Настройки rKeeper Delivery:
Настройки на портале «Платформа еДА»:
Автоматические кассовые скидки rKeeper
⚠️ Будут применяться только автоматические кассовые скидки rKeeper, скидки и бонусы платформы еДА будут отключены.
Настройки rKeeper Delivery:
Настройки на портале «Платформа еДА»:
Свободная скидка rKeeper
⚠️ Будут применяться только скидки и бонусы платформы еДА, скидки и бонусы rKeeper будут игнорироваться.
В заказ rKeeper будут передаваться скидки и бонусы заказа Платформы еДА в виде значения свободной скидки rKeeper. Чтобы интеграция корректно работала с этой настройкой, все остальные скидки rKeeper кроме свободной скидки должны быть отключены.
В настройках на портале «Платформа еДА» нужно указать идентификатор свободной скидки, указанный в настройках rKeeper Delivery.
Настройки rKeeper Delivery:
Настройки на портале «Платформа еДА»:
Настройка синхронизации статусов заказов
Настройка производится на портале rKeeper Delivery https://delivery.ucs.ru/adminka.
Для синхронизации статусов нужно перейти в меню Коммуникации→Внешние API для push-уведомлений и создать новое внешнее API. Указать следующие параметры:
- Заголовок:
X-Hook-Token - Ссылка:
https://integration-rkeeper-direct.e-da.site/Order/UpdateOrderHook - В поле
Токенуказать уникальный токен (например GUID или ввести случайную последовательность символов). Этот токен нужно затем указать в настройках интеграции на портале «Платформа еДА» в полеТокен веб-хука обновления статуса заказа rKeeper.
Далее нужно перейти в меню Коммуникации→Шаблоны и создать шаблоны для статусов, которым нужна синхронизация. Указать следующие параметры:
- Канал:
api - Внешнее API: выбрать API, созданное на предыдущем шаге
- Условие отправки: добавить новое условие с параметрами
Статус,равно, и выбрать статус, который нужно синхронизировать.
Только для выбранных статусов в платформу «Платформа еДА» будет приходить обновление. Если нужно синхронизировать все статусы, то для каждого статуса нужно создать отдельный шаблон.
Настройка синхронизации статусов на портале «Платформа еДА»
Для включения обработки статусов смены заказов, в настройках супер админа на экране Настройки кабинета→Статусы заказов нужно включить галочку для синхронизации статусов с системой учета.
После этого у пользователей в приложении в истории заказов будут отображаться статусы от системы учета rKeeper.
Настройка смены внутренних статусов заказов при смене статусов заказа rKeeper
Для того, чтобы смена статусов заказа rKeeper приводила к смене статуса в заказе «Платформа еДА», необходимо указать Регулярное выражение для обновления статуса.
Для интеграции с rKeeper эти выражения должны быть следующими:
- Готовится -
^Готовится$ - Передан курьеру -
^Заказ в пути$ - Завершён -
^Выполнен$ - Отменён -
^Отменен$
Если все сделано правильно и интеграция с rKeeper работает корректно, статусы заказов в ЛК «Платформа еДА» будут сменяться автоматически.
Настройка пуш уведомлений о смене статусов интеграции
Следует учесть, что при настроенной синхронизации смены статусов, пуш уведомления о статусах, если они включены, будут приходить при смене статусов в системе rKeeper и при смене статусов в системе «Платформа еДА», т.о. пуши о состоянии заказа могут дублироваться.
Например, если в rKeeper заказ получил статус "Готовится", информация об этом получит система «Платформа еДА» отправит пуш уведомление смены статуса системы учета, затем будет проверка соответствия "Регулярного выражения для обновления статуса" и если оно соответствует, то будет произведена смена статуса заказа в системе «Платформа еДА», в следствии чего будет отправлен пуш уведомление о смене статуса в системе «Платформа еДА» "Готовится", т.о. об одном и том же состоянии заказа клиенту придет сразу 2 пуш-уведомления.
Чтобы этого избежать нужно настроить пуш уведомления статусов так, чтобы приходили статусы только о смене внутренних статусов заказа ("Принят", "Готовится", "Передан курьеру", "Выполнен" и "Отменен")
Или только о смене статусов системы учета
При включенной синхронизации статусов, статусы в истории заказов в МП будут отображаться от статуса системы учета
Настройки приема заказов
Заказы попадают сначала в колл-центр, потом на портал менеджера доставки и потом на кассу. Можно настроить, чтобы передача заказа из колл-центра на портал менеджера доставки и из портала менеджера доставки на кассу осуществлялась автоматически или вручную оператором колл-центра и менеджером доставки.
Передача заказа из колл-центра на портал менеджера доставки
Нужно зайти в настройки на портале менеджера доставки и выбрать режим обработки заказа:
Варианты настройки:
Автоматическое подтверждение - заказы будут передаваться из колл-центра автоматически. Этот вариант нужно обязательно выбрать, если колл-центр не используется
Заказы не подтверждаются - оператор колл-центра должен вручную подтвердить заказ
Передача заказа из портала менеджера доставки на кассу
Нужно перейти в "Заведения", выбрать заведение, и выбрать способ приема заказа.
Настройка для автоматического приема заказа:
Настройка для ручного приема заказа:
Настройка зон доставки
Настройка зон доставки r_keeper Delivery
Нужно перейти на страницу "Зоны доставки" и нажать кнопку "Создать зону доставки"
Пример настроек зоны доставки:
Перенос зон доставки на портал «Платформа еДА»
Для загрузки зон доставки на портал «Платформа еДА» нужно сформировать файл GeoJSON. Для этого нужно экспортировать все зоны доставки r_keeper в файлы GeoJSON и затем объединить эти файлы в один общий файл для загрузки на портал «Платформа еДА».
Для получения файлов GeoJSON нужно открыть редактирование зоны доставки, нажать кнопку "Экспорт в GeoJSON" и сохранить полученный файл.
Получится список файлов:
Полученный список файлов нужно загрузить на сайт https://geojson.io/:
И выгрузить зоны доставки одним файлом map.json:
Далее нужно загрузить полученный файл map.json на портале «Платформа еДА» в зонах доставки:
Стоимость доставки на портале «Платформа еДА» нужно настроить в соответствии с зонами доставки r_keeper. Пример для зоны доставки Доставка Москва 2:
Настройка на портале «Платформа еДА»:
Так же можно ознакомиться с видео инструкцией по настройке зон доставки
"Зоны доставки r-keeper"
https://youtu.be/PM0mbjJCZWs
Ссылка на сайт из видео инструкции для объединения файлов JSON https://findthatpostcode.uk/
Настройка внешнего меню
На портале r_keeper Delivery для товаров загружается изображение и описание:
Скрытие товаров для доставки в меню
Для добавления стоимости доставки в заказы r_keeper добавляется специальный товар, цена которого равна цене доставки. Эти товары также попадают во внешнее меню r_keeper. Чтобы скрыть эти товары в приложении «Платформа еДА» нужно добавить товары с соответствующими артикулами в каталог «Платформа еДА» и установить для этих товаров флаг "Не показывать в каталоге":
Создание товаров с модификаторами в r_keeper
Настройка r_keeper осуществляется в приложении "r_keeper7 Станция менеджера".
Товары в r_keeper создаются в справочнике "Меню". При создании товара нужно заполнить поля "Название", "Основная цена".
В справочнике "Меню → Модификаторы" создать новую группу модификаторов.
Далее создать модификаторы в группе. Также для модификаторов можно указать ограничение "Макс. для одного блюда".
Далее в справочнике "Меню → Схемы модификаторов" создать новую схему. Схема будет привязана к товару.
В созданную схему модификаторов добавить нужные группы модификаторов и в свойствах каждой группы внутри схемы указать флаг "Изменяет цену". Также в свойствах группы можно указать ограничения "Минимальное количество", "Максимальное количество".
Для добавления модификаторов к товару нужно в справочнике "Меню" в свойствах товара выбрать нужную схему модификаторов в параметре "Схема модификаторов".
Для систем учета r-Keeper Delivery предусмотрена возможность отображать в приложении внешний номер заказа, который присваивается в самой системе учета, вместо внутреннего номера нашего сервиса. При необходимости вы можете настроить обрезку этого номера до нужного количества символов.
Обратите внимание: использование внешнего номера заказа доступно только при включенной опции «Ждать подтверждения создания заказа» в настройках вашей системы учета. Убедитесь, что эта опция активна - иначе внешний номер отображаться не будет.
Синхронизация категорий
Так же вы можете посмотреть видео инструкцию по синхронизации категорий в МП и r_keeper по ссылке на нашем YouTube канале и в группе ВК
YouTube канал - Актоника
Группа в ВК - Платформа еДА
Синхронизация товаров и модификатор
Так же вы можете посмотреть видео инструкцию синхронизации товаров и модификаторов в МП и r_keeper по ссылке на нашем YouTube канале и в группе ВК