Главная Интеграции Лояльность ProBonus

ProBonus

Обновлено Oct 21, 2026

ProBonus — бонусная система, документация которой ведётся на wiki.carbis.ru. Через интеграцию Смартомато получает баланс гостя, заводит новых гостей, синхронизирует имя, дату рождения, почту и бонусную карту, начисляет и списывает бонусы и назначает бонусную категорию по уровню гостя. Гость определяется по номеру телефона.

Что нужно до подключения

  • Адрес API ProBonus, логин и пароль для доступа к API.
  • В ProBonus создана группа счетов.
  • Известны правила начисления и списания бонусов.
  • Если используются уровни гостей — они настроены в ProBonus и известны их коды rkCode.
  • Сценарий начисления согласован заранее. Обычно Смартомато само считает бонусы и передаёт в ProBonus готовую сумму. Настройки начисления в ProBonus работают, когда покупки и бонусные операции регистрирует r_keeper или ProCart, и такой сценарий нужно отдельно согласовать до включения.

Шаги на стороне ProBonus и кассы

  1. Создать в ProBonus группу счетов (инструкция Carbis). Зачем: в ней Смартомато заводит счета новым гостям.
  2. Настроить начисление бонусов в ProBonus, если по согласованному сценарию его регистрирует касса.
  3. Узнать id группы счетов: в интерфейсе ProBonus открыть «Группы счетов».

Уровни гостей

  1. В r_keeper настроить скидки или бонусы для каждого уровня.
  2. В ProBonus создать составную скидку или бонус (инструкция Carbis).
  3. Добавить уровни и условия перехода между ними.
  4. Выписать rkCode каждого уровня. Зачем: Смартомато сопоставляет уровень по rkCode текущего уровня, а не по id составной скидки. Проценты начисления и списания ProBonus не передаёт, их задают у нас.

Касса r_keeper: код карты из приложения

Чтобы касса распознавала код карты лояльности из личного кабинета как карту ProBonus, на кассе настраивают MCR-алгоритм (инструкция Carbis): в пункте «Обработка по маске» добавляют маску iiiiiiiiii (десять букв i).

Проверка

Найти в ProBonus тестового гостя с известным балансом и уровнем. Дальше его карточку, тестовый заказ с бонусами, начисление и отмену проверяют на нашей стороне, см. Внешние системы лояльности.

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

  • Инструкции Carbis по шагам — ссылки выше.
  • Документация API: http://saturn.carbis.ru:6896/docs.
  • Коллекция Postman «ProBonus.postman_collection.json» приложена к исходной статье.

Что передать в Смартомато

  • Адрес API ProBonus.
  • Логин и пароль для API.
  • Id группы счетов.
  • Правила начисления и списания, а если есть уровни — список уровней с их rkCode.
  • Согласованный сценарий: считает ли бонусы Смартомато или покупки регистрирует касса (r_keeper, ProCart).

Типовые ошибки и вопросы клиентов

  • Ошибка 500 при публикации заказа или открытии списка клиентов. Обычно неверен id группы счетов. Клиент заходит в ProBonus → «Группы счетов» и сообщает нужный id.
  • Касса выдаёт ошибку при сканировании кода карты лояльности. Не настроен MCR-алгоритм, см. «Касса r_keeper» выше.
  • Гостю не назначился уровень. Со стороны ProBonus стоит проверить, приходит ли у гостя rkCode. Остальные причины на нашей стороне, см. Уровни лояльности.

Связанные статьи