Документ описывает последовательность действий инженера при подключении внешней бонусной системы MaxBonus к кассовому ПО Барс (модули Администратор и Кассир).
Барс.АдминистраторБарс.КассирПодробная инструкция по типу оплаты "Максбонус"
Путь: Барс.Администратор → Справочники → Типы кассовых валют
Создать две записи:
| Наименование | Код признака | Процессинг | Тип процессинга |
|---|---|---|---|
| МаксБонус | 2 | МаксБонус | MaxBonus |
| МаксМаксСБонус | 2 | МаксМаксСБонус | MaxBonusBonus |
Примечание: Наименования могут быть любыми, но тип процессинга должен строго соответствовать указанному.
Путь: Барс.Администратор → Сервис → Настройки → Глобальные настройки → Внешние бонусные системы
https://<host>:<port>/Путь: Барс.Администратор → Справочники → Справочники штучных товаров
Для каждого товара, который участвует в бонусной программе (в т.ч. для гашения долгов), необходимо заполнить поле Номенклатурный номер (НН) значением, соответствующим id товара в личном кабинете MaxBonus.
Действие: Запустить форму настройки параметров для кассового модуля. Перейти на вкладку Процессинг
| Параметр | Значение | Обязательность |
|---|---|---|
| Процессинг | МаксБонус (или MaxBonus) |
Да |
| Токен | строка, выданная администратором MaxBonus | Да |
⚠️ Важно: Токен задается в локальной конфигурации кассира, а не в глобальных настройках.
Нажать Сохранить. Параметры применяются после перезапуска кассового модуля.
После выполнения настроек убедиться, что:
curl:curl -X GET "https://api.maxbonus.ru:38200/api/cashbox/health" -H "Authorization: Bearer <токен>"
+7 и 8).+7 и 8).✅ После успешной регистрации клиент автоматически авторизуется в кассе.
Начисление бонусов производится при продаже товаров с актуальным номенклатурным номером (НН), для которого заведен соответсвующий тариф\акция на начисление в системе МаксБонус.
В чеке формируется запись:
Банк Максбонус в виде скидки, где указывается сумма скидки бонусами.