R-Keeper — кассовый софт компании UCS. В нём ресторан заводит меню, пробивает заказы и строит отчётность. Эта страница — про облачную схему r_keeper Delivery. Подключение через модули Carbis описано на страницах «ProCart» и «Carbis (Мини доставка)».
Что нужно до подключения
У клиента должны быть куплены модули R-Keeper:
- XML для WSA;
- Delivery_Base;
- Filial.
Шаги на стороне R-Keeper
- Подключиться по API по инструкции r_keeper. В результате появятся данные авторизации:
- Client ID — 16 символов;
- Client Secret — публичный ключ, 128 символов.
- Зачем: по этим данным Смартомато подключается к r_keeper Delivery, см. Подключение к кассе.
- Настроить представление меню по инструкции r_keeper. Зачем: из него импортируется меню по ресторанам, см. Синхронизация меню, цен и стоп-листов с кассой.
- Завести «блюдо» доставки с произвольной ценой. Зачем: через него в заказе передаётся цена доставки из Смартомато.
Дополнительно, по задачам клиента
- Сервисный сбор. Завести блюдо с ценой 1 ₽ и сообщить его код. Зачем: этим блюдом в кассу уходит сервисный сбор, см. Итоги заказа и сервисный сбор.
- Оплата бонусами. Бонусы от Смартомато всегда приходят в Кипер скидкой. Для этого нужен внутренний код скидки в Кипере (rk7Id, число). Как внешняя бонусная система будет работать внутри самого Кипера и что в нём можно подключить, статья оставляет открытым вопросом.
- Акции. Сообщить код акции в Кипере. При отправке заказа сумма скидки по акции добавляется к сумме ручной скидки.
Что передать в Смартомато
- Client ID и Client Secret.
- Код блюда доставки.
- Коды типов оплаты: картой онлайн, оплата на внешнем сервисе. Для бонусов — rk7Id скидки.
- При необходимости: код блюда сервисного сбора и коды акций в Кипере.
Типовые ошибки и вопросы клиентов
- Заказы за стол. r_keeper Delivery не поддерживает их по API.
- Меню по ресторанам. Импортируется автоматически.
- Какие статусы уходят в R-Keeper. Никакие: Смартомато статусы только принимает.
- Стопы модификаторов не подтягиваются. API r_keeper Delivery отдаёт стопы только по блюдам, отдельного списка стопов модификаторов нет. Модификаторы ставят на стоп вручную в Смартомато. Стопы блюд синхронизируются как обычно.
- Приборы. В заказе передаётся число персон, равное числу приборов. Отдельными блюдами приборы не передаются.
- Заказ изменили в Кипере. Если включён импорт заказов из R-Keeper, изменения состава, цен и доставки, сделанные в Кипере, в Смартомато не приходят.
- Правки заказа из Смартомато. Если включена передача изменений в R-Keeper, их рекомендуется вносить до оплаты и до подтверждения заказа. Иначе при закрытии заказа в R-Keeper возможны ошибка и расхождение по суммам.