Подготовка и подключение RKeeper

Следуйте инструкции отдельно для каждого филиала Result.Rest. Если одно API-подключение r_k Delivery открывает доступ к нескольким ресторанам, его реквизиты можно использовать повторно, но в каждом филиале нужно выбрать свой ресторан.

Что подготовить

  • доступ администратора к r_k Delivery;

  • лицензию R-Keeper модуль Delivery_Api для каждого ресторана;

  • опубликованное представление меню;

  • Client ID и Client Secret;

  • GUID валюты для онлайн-оплаты, если она используется;

  • ID свободной скидки, если скидки Result.Rest должны передаваться в RKeeper;

  • схему статусов заказов.

1. Проверьте лицензию

Для каждого ресторана, из которого Result.Rest будет получать меню или в который будет создавать заказы, должна действовать лицензия R-Keeper модуль Delivery_Api.

Проверить назначение лицензии можно в официальной статье «Лицензирование».

2. Создайте подключение по API

  1. Откройте административную панель r_k Delivery.

  2. Перейдите в «Интеграции» → «Подключение по API» → «Подключение по API».

  3. Нажмите «Добавить подключение по API».

  4. Укажите название Result.Rest и e-mail контактного лица.

  5. В блоке «Доступные заведения» выберите рестораны, которые нужно подключить.

  6. В блоке «Меню» выберите представление для сайта и приложения.

  7. Если используется онлайн-оплата, выберите валюту в блоке «Параметры заказа».

  8. Сохраните подключение и снова откройте его карточку.

  9. Скопируйте Client ID и Client Secret без пробелов в начале и конце.

Настройка «Предоставить доступ ко всем заказам заведений» позволяет этому API-подключению подтверждать заказы, созданные другими подключениями. Включайте её только тогда, когда такой доступ действительно нужен.

Осторожно. Не публикуйте Client Secret. Если ключ был сгенерирован повторно, обновите его во всех филиалах Result.Rest, которые используют это подключение.

Официальное описание полей: «Подключение по API».

3. Проверьте представление меню

Представление «Касса»

В представление «Касса» попадают блюда всех заведений. Оно автоматически синхронизируется с кассой каждые 60 минут.

Проверьте наличие нужных разделов, блюд, ингредиентов, модификаторов, цен и артикулов.

Отдельное представление

Для сайта или приложения можно использовать отдельное представление:

  1. откройте раздел «Меню»;

  2. создайте новое представление или скопируйте существующее;

  3. добавьте нужные группы и блюда;

  4. нажмите «Опубликовать меню для заведений»;

  5. выберите это представление в карточке API-подключения.

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

Если филиалам нужны разные представления, создайте отдельное API-подключение для каждого представления. Подробнее: «Представления».

4. Настройте валюту для онлайн-оплаты

GUID валюты нужен для заказов с типом оплаты «Онлайн».

  1. Убедитесь, что нужная валюта создана в RKeeper.

  2. В карточке API-подключения откройте блок «Параметры заказа».

  3. Выберите валюту из списка. При ручном вводе используйте GUID как в кассе, без фигурных скобок {}.

  4. Сохраните подключение.

Если онлайн-оплата не используется, этот шаг можно пропустить. Подробнее: «Валюта, оплата».

5. Подготовьте свободную скидку

Шаг нужен, только если скидки, рассчитанные в Result.Rest, должны передаваться в RKeeper.

  1. В менеджерской станции r_keeper создайте суммовую свободную скидку.

  2. Включите у неё параметр «Изменяемое значение».

  3. Сохраните скидку и скопируйте её идентификатор.

  4. Позже укажите его в поле «ID свободной скидки» в филиале Result.Rest.

Если передавать скидки Result.Rest не нужно, оставьте это поле пустым. Требования к параметру свободной скидки описаны в статье «Создание заказа с кассовой скидкой».

6. Проверьте статусы заказов

В административной панели r_k Delivery откройте раздел «Статусы заказа». В схеме могут использоваться следующие этапы:

  1. Новый.

  2. Подтверждён.

  3. Принят в ресторане.

  4. Передан на кухню.

  5. Готовится.

  6. Приготовлен.

  7. Сборка заказа.

  8. Собран.

  9. У курьера.

  10. Заказ в пути.

  11. Выполнен.

  12. Отменён.

  13. Доставлен.

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

Для самовывоза статусы «У курьера» и «Заказ в пути» недоступны. Подробнее: «Статусы заказа».

7. Подключите филиал Result.Rest

  1. Откройте «Панель управления» → «Филиалы».

  2. Создайте филиал или откройте существующий.

  3. В блоке «Внешние программы учёта» выберите R_Keeper.

  4. Вставьте Client ID и Client Secret.

  5. Нажмите «Обновить данные».

  6. В поле «Ресторан» выберите заведение, соответствующее филиалу.

  7. При необходимости укажите ID свободной скидки.

  8. Сопоставьте статусы r_k Delivery со статусами Result.Rest.

  9. Сохраните филиал.

Описание каждого поля: Подключение RKeeper к филиалу.

8. Проверьте результат

После нажатия «Обновить данные» в форме должен появиться список доступных ресторанов. Сохраните филиал и оформите тестовый заказ.

Проверьте:

  • заказ поступил в нужный ресторан;

  • товары, ингредиенты и модификаторы передались без пропусков;

  • количество, цены, скидка и итоговая сумма совпадают с Result.Rest;

  • способ оплаты определился правильно;

  • комментарий к заказу доступен сотрудникам ресторана;

  • статусы обновляются по настроенному сопоставлению.

Если проверка не пройдена, откройте ошибки и проверку обмена.

После успешного теста можно выполнить импорт каталога из RKeeper.