Подключение R-Keeper: что запросить у своего поставщика

Если заведение работает на R-Keeper, WellCa подключается к нему по трём отдельным интерфейсам. Они независимы: можно начать с одного и добавить остальные позже.

Всё, что перечислено ниже, выдаёт ваш партнёр (дилер) R-Keeper — компания, которая обслуживает вашу кассу. У нас этих данных нет и получить их за вас мы не можем: доступы к вашей системе выдаются только владельцу.

Что даёт каждый интерфейс

• White Server — столы, заказы и меню. Это основа: без него мы не видим ваш зал и позиции.
• WebDelivery — заказы доставки.
• Лояльность (FarCard) — баланс и бонусы гостя. Здесь два пути: оставить свою программу (тогда баланс считает прежний поставщик, а мы его показываем) либо перейти на бонусы WellCa — тогда считаем мы, а касса списывает бонусы в чеке. Второй путь описан отдельно: Бонусы WellCa на кассе r_keeper.

Что попросить у партнёра R-Keeper

Можно переслать этот список дословно.

1. White Server

1. Включить White Server для нашего ресторана и выдать лицензионный ключ.
2. Создать отдельного пользователя для интеграции — логин и пароль (не сотрудника, а служебный доступ).
3. Сообщить адрес и порт, по которому сервис доступен, например https://ws.вашдомен.ru:9000.

2. WebDelivery (если нужна доставка)

1. Выдать SID — ключ доступа из личного кабинета WebDelivery.
2. Сообщить ID объекта (objectId) — номер вашего ресторана в системе доставки.
3. Если ресторанов несколько и они объединены в сеть — ещё и ID корпорации.

3. Лояльность FarCard (если оставляете свою программу)

1. Адрес API лояльности.
2. Постоянный API-ключ для доступа.

Доступ по сети — самое частое, обо что спотыкаются

White Server обычно стоит внутри заведения и снаружи закрыт. Чтобы мы могли к нему обращаться, партнёр должен:

• открыть доступ к адресу и порту снаружи (проброс порта или VPN);
• закрепить постоянный адрес — «серый» динамический IP не подойдёт, связь будет рваться после каждой перезагрузки роутера;
• по возможности выдать доступ по HTTPS, а не по открытому HTTP;
• добавить наши адреса в белый список, если у вас ограничен доступ по IP — конкретные адреса пришлёт ваш менеджер WellCa.

Проверьте доступность заранее: если White Server открывается только из локальной сети заведения, интеграция не заработает, сколько бы правильных ключей вы ни ввели.

Куда вводить данные

Если вы регистрируетесь впервые — выберите R-Keeper на шаге «Что у вас за система», и мастер сам попросит эти поля на шаге «Начальная настройка». Ничего страшного, если данных ещё нет: нажмите «Настроить потом», регистрация пройдёт до конца.

Если вы уже работаете в WellCa — пришлите реквизиты своему менеджеру: подключение R-Keeper мы пока делаем на своей стороне и проверяем связь вместе с вами.

Что важно знать заранее

R-Keeper не присылает нам события кассы сам — в отличие от iiko, у него нет вебхуков о закрытых чеках. Поэтому на старте связка даёт столы, меню, заказы, доставку и работу с бонусами, а вот автоматическое начисление за визит и аналитика продаж в реальном времени требуют отдельной настройки. Обсудите это с менеджером — решение зависит от вашей версии R-Keeper.

Документация R-Keeper

• Портал документации R-Keeper — общий вход, есть поиск.
• White Server — раздел про интерфейс, к которому мы подключаемся.
• Доставка (Delivery) и описание API WebDelivery.
• r_keeper 7 — документация по самой кассовой системе.

Дальше

Хотите считать бонусы у нас, а списывать их на кассе — Бонусы WellCa на кассе r_keeper. Ведёте учёт в 1С — посмотрите обмен с 1С:Фреш. Общие настройки заведения и доступы описаны в статье Организация, оплата и доступы.

Доступные операции и ограничения

White Server позволяет загрузить залы и столы, а WebDelivery — доступные типы оплат. Если доступ не настроен или касса вернула некорректный ответ, синхронизация покажет ошибку вместо пустого успешного результата.

Номера столов должны быть уникальными в заведении. Если в разных залах одинаковые номера или повторяются идентификаторы, импорт останавливается: это защищает существующие столы от объединения.

Изменение статуса заказа, поиск гостя по внутреннему идентификатору R-Keeper, история операций и сводная статистика внешней лояльности пока не поддерживаются этим подключением. Неподдерживаемая операция возвращает явное ограничение; отсутствие статистики не означает нулевые показатели.