Интеграция r_keeper Delivery. Подключение по API

Данные, которые Вы предоставляете нам для интеграции r_keeper с мобильным приложением:

1. Client ID и Client Secret
   Инструкция по настройке: https://docs.rkeeper.ru/delivery/podklyuchenie-po-api-4043842.html

2. Идентификатор заведения (Таблица заведений, столбец "Код объекта").
   Идентификатор заведения из r_keeper Delivery. Берется из таблицы заведений в столбце "Код объекта". https://delivery.ucs.ru/adminka/restaurants

3. Файлы с зонами доставки из r_keeper
   Инструкция по настройке: https://docs.rkeeper.ru/delivery/zony-dostavok-4043851.html

Настройка подключения по API

Для интеграции нужно создать новое подключение по API в личном кабинете r_keeper Delivery и внести ClientId и ClientSecret в настройки на портале eDA
Инструкция по настройке: https://docs.rkeeper.ru/delivery/podklyuchenie-po-api-4043842.html

Настройка синхронизации статусов заказов

Настройка производится на портале rKeeper Delivery https://delivery.ucs.ru/adminka.
Для синхронизации статусов нужно перейти в меню Коммуникации→Внешние API для push-уведомлений и создать новое внешнее API. Указать следующие параметры:

• Заголовок: X-Hook-Token
• Ссылка: https://integration-rkeeper-direct.e-da.site/Order/UpdateOrderHook
• В поле Токен указать уникальный токен (например GUID или ввести случайную последовательность символов). Этот токен нужно затем указать в настройках интеграции на портале eDA в поле Токен веб-хука обновления статуса заказа rKeeper.
  
  

Далее нужно перейти в меню Коммуникации→Шаблоны и создать шаблоны для статусов, которым нужна синхронизация. Указать следующие параметры:

• Канал: api
• Внешнее API: выбрать API, созданное на предыдущем шаге
• Условие отправки: добавить новое условие с параметрами Статус, равно, и выбрать статус, который нужно синхронизировать.

Только для выбранных статусов в платформу eDA будет приходить обновление. Если нужно синхронизировать все статусы, то для каждого статуса нужно создать отдельный шаблон.

Настройка синхронизации статусов на портале eDA

Для включения обработки статусов смены заказов, в настройках супер админа на экране Настройки кабинета→Статусы заказов нужно включить галочку для синхронизации статусов с системой учета.

После этого у пользователей в приложении в истории заказов будут отображаться статусы от системы учета rKeeper.

Настройка смены внутренних статусов заказов при смене статусов заказа rKeeper

Для того, чтобы смена статусов заказа rKeeper приводила к смене статуса в заказе eDa, необходимо указать Регулярное выражение для обновления статуса.

Для интеграции с rKeeper эти выражения должны быть следующими:

• Готовится - ^Готовится$
• Передан курьеру - ^Заказ в пути$
• Завершён - ^Выполнен$
• Отменён - ^Отменен$

Если все сделано правильно и интеграция с rKeeper работает корректно, статусы заказов в ЛК eDa будут сменяться автоматически.

Настройка пуш уведомлений о смене статусов интеграции

Следует учесть, что при настроенной синхронизации смены статусов, пуш уведомления о статусах, если они включены, будут приходить при смене статусов в системе rKeeper и при смене статусов в системе eDa, т.о. пуши о состоянии заказа могут дублироваться.
Например, если в rKeeper заказ получил статус "Готовится", информация об этом получит система eDa отправит пуш уведомление смены статуса системы учета, затем будет проверка соответствия "Регулярного выражения для обновления статуса" и если оно соответствует, то будет произведена смена статуса заказа в системе eDa, в следствии чего будет отправлен пуш уведомление о смене статуса в системе eDa "Готовится", т.о. об одном и том же состоянии заказа клиенту придет сразу 2 пуш-уведомления.

Чтобы этого избежать нужно настроить пуш уведомления статусов так, чтобы приходили статусы только о смене внутренних статусов заказа ("Принят", "Готовится", "Передан курьеру", "Выполнен" и "Отменен")

Или только о смене статусов системы учета

При включенной синхронизации статусов, статусы в истории заказов в МП будут отображаться от статуса системы учета

Настройки приема заказов

Заказы попадают сначала в колл-центр, потом на портал менеджера доставки и потом на кассу. Можно настроить, чтобы передача заказа из колл-центра на портал менеджера доставки и из портала менеджера доставки на кассу осуществлялась автоматически или вручную оператором колл-центра и менеджером доставки.

Передача заказа из колл-центра на портал менеджера доставки

Нужно зайти в настройки на портале менеджера доставки и выбрать режим обработки заказа:

Варианты настройки:

Автоматическое подтверждение - заказы будут передаваться из колл-центра автоматически. Этот вариант нужно обязательно выбрать, если колл-центр не используется
Заказы не подтверждаются - оператор колл-центра должен вручную подтвердить заказ

Передача заказа из портала менеджера доставки на кассу

Нужно перейти в "Заведения", выбрать заведение, и выбрать способ приема заказа.

Настройка для автоматического приема заказа:

Настройка для ручного приема заказа:

Настройка зон доставки

Настройка зон доставки r_keeper Delivery

Нужно перейти на страницу "Зоны доставки" и нажать кнопку "Создать зону доставки"

Пример настроек зоны доставки:

Перенос зон доставки на портал eDA

Для загрузки зон доставки на портал eDA нужно сформировать файл GeoJSON. Для этого нужно экспортировать все зоны доставки r_keeper в файлы GeoJSON и затем объединить эти файлы в один общий файл для загрузки на портал eDA.
Для получения файлов GeoJSON нужно открыть редактирование зоны доставки, нажать кнопку "Экспорт в GeoJSON" и сохранить полученный файл.

Получится список файлов:

Полученный список файлов нужно загрузить на сайт https://geojson.io/:

И выгрузить зоны доставки одним файлом map.json:

Далее нужно загрузить полученный файл map.json на портале eDA в зонах доставки:

Стоимость доставки на портале eDA нужно настроить в соответствии с зонами доставки r_keeper. Пример для зоны доставки Доставка Москва 2:

Настройка на портале eDA:

Так же можно ознакомиться с видео инструкцией по настройке зон доставки

"Зоны доставки r-keeper"
https://youtu.be/PM0mbjJCZWs

Ссылка на сайт из видео инструкции для объединения файлов JSON https://findthatpostcode.uk/

Настройка внешнего меню

На портале r_keeper Delivery для товаров загружается изображение и описание:

Скрытие товаров для доставки в меню

Для добавления стоимости доставки в заказы r_keeper добавляется специальный товар, цена которого равна цене доставки. Эти товары также попадают во внешнее меню r_keeper. Чтобы скрыть эти товары в приложении eDA нужно добавить товары с соответствующими артикулами в каталог eDA и установить для этих товаров флаг "Не показывать в каталоге":

Создание товаров с модификаторами в r_keeper

Настройка r_keeper осуществляется в приложении "r_keeper7 Станция менеджера".

Товары в r_keeper создаются в справочнике "Меню". При создании товара нужно заполнить поля "Название", "Основная цена".

В справочнике "Меню → Модификаторы" создать новую группу модификаторов.

Далее создать модификаторы в группе. Также для модификаторов можно указать ограничение "Макс. для одного блюда".

Далее в справочнике "Меню → Схемы модификаторов" создать новую схему. Схема будет привязана к товару.

В созданную схему модификаторов добавить нужные группы модификаторов и в свойствах каждой группы внутри схемы указать флаг "Изменяет цену". Также в свойствах группы можно указать ограничения "Минимальное количество", "Максимальное количество".

Для добавления модификаторов к товару нужно в справочнике "Меню" в свойствах товара выбрать нужную схему модификаторов в параметре "Схема модификаторов".

Синхронизация категорий

Так же вы можете посмотреть видео инструкцию по синхронизации категорий в МП и r_keeper по ссылке на нашем YouTube канале и в группе ВК

YouTube канал - Актоника

Группа в ВК - eDA

Синхронизация товаров и модификатор

Так же вы можете посмотреть видео инструкцию синхронизации товаров и модификаторов в МП и r_keeper по ссылке на нашем YouTube канале и в группе ВК

YouTube канал - Актоника

Группа в ВК - eDA