Бонусы WellCa на кассе r_keeper

Бонусы считает WellCa, а касса r_keeper показывает их кассиру и печатает остаток на слипе. При закрытии чека касса сама сообщает нам, сколько бонусов списано или начислено — вручную ничего сводить не нужно.

Это обратное направление по сравнению с подключением своей программы FarCard: там баланс живёт у вашего прежнего поставщика лояльности, здесь — у нас. Выбирать нужно что-то одно.

Что для этого нужно

1. r_keeper 7 версии 6.04 и выше. Обмен с внешней системой лояльности по HTTP появился начиная с этой версии.
2. Лицензия HttpFarcards на объект. Её заказывают у вашего партнёра (дилера) r_keeper — без неё касса просто не станет обращаться к внешней системе. Лицензия платная и оформляется на каждое заведение отдельно.
3. Настройка на кассовом сервере. Дилер прописывает адрес нашего сервера в файле ExtDllHttp.ini (секция [Server], параметр Address) и активирует лицензию утилитой Http_LicGen.exe.

Пункты 2 и 3 делает дилер — у нас доступа к вашему кассовому серверу нет.

Что сделать у нас

1. Откройте Настройки → Бонусы на кассе. Раздел появляется, если ваша касса — r_keeper.
2. Нажмите «Сгенерировать код» — получится персональный адрес вида .../api/rkeeper/farcards/<код>. Этот адрес и передайте дилеру: он содержит секретную часть, поэтому пересылать его в открытых чатах не стоит.
3. Впишите код ресторана — тот, которым касса подписывает свои запросы. Его подскажет дилер.
4. Логин и пароль заполнять не нужно: касса их не отправляет. В ExtDllHttp.ini логин с паролем относятся к прокси системы лицензирования r_keeper, а не к нам — поэтому пароль, по которому мы узнаём вашу кассу, это и есть секретная часть адреса.
5. Включите «Принимать запросы кассы» и сохраните.

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

Что сделать на кассе

Заведите тип оплаты «Бонусы WellCa» и свяжите его с внешней системой лояльности — именно им кассир оплачивает часть чека. Это тоже настройка дилера.

Как это выглядит в зале

1. Кассир вводит номер карты или телефон гостя.
2. Касса спрашивает у нас баланс и показывает его на экране.
3. Кассир выбирает оплату бонусами и указывает сумму.
4. При закрытии чека касса присылает нам списание, а на слипе печатается остаток бонусов.

Возврат чека касса присылает так же — бонусы вернутся гостю автоматически.

Если что-то не работает

На странице настроек внизу есть журнал операций: каждое обращение кассы, включая отказы с причиной. Пусто — значит касса до нас ещё не доходила: проверьте с дилером адрес в ExtDllHttp.ini и лицензию. Частая причина — закрытый доступ наружу из сети заведения. Видны отказы «недостаточно бонусов» или «карта не найдена» — связь есть, дело в данных гостя.

Повторные запросы кассы не приводят к двойному списанию: чек с тем же номером мы узнаём и второй раз бонусы не снимаем.

Документация r_keeper

• Описание HTTP-протокола FarCards — техническое описание для дилера.
• Портал документации r_keeper.

Дальше

Про остальные интерфейсы — столы, меню, доставку — в статье Подключение R-Keeper.