Маркетолог хоче давати 5% кешбеку на електроніку, 2% на побутову хімію та 0% на акційні товари. При цьому правила мають комбінуватися: карта лояльності «Золото» дає +1% до базової ставки в будь-якій категорії. Стандартний модуль знижок (catalog.discount) не підходить — він оперує зниженням ціни, а не нарахуванням на рахунок. Потрібна окрема система правил. Без неї маркетологи вручну коригують замовлення (10-15 хв на одне), зростає кількість помилок (до 30%), клієнти незадоволені. Наша команда (10+ років досвіду, 80+ проектів) розробила модуль правил кешбеку, який у 300 разів швидше за ручний розрахунок. У цій статті — готова архітектура та PHP-код для 1С-Бітрікс. Ми спеціалізуємося на комерційній розробці для 1С-Бітрікс.
Як налаштувати правила кешбеку за категоріями?
Правила зберігаються в таблиці local_cashback_rules. Мінімальна структура:
CREATE TABLE local_cashback_rules (
ID INT AUTO_INCREMENT PRIMARY KEY,
RULE_TYPE ENUM('category','product','user_group','promo') NOT NULL,
ENTITY_ID INT, -- ID розділу інфоблоку, товару, групи
CASHBACK_PCT DECIMAL(5,2), -- відсоток нарахування
PRIORITY INT DEFAULT 10,-- чим менше, тим вищий пріоритет
DATE_FROM DATE,
DATE_TO DATE,
ACTIVE CHAR(1) DEFAULT 'Y'
);
Правила з RULE_TYPE = 'category' прив'язані до розділів інфоблоку каталогу. При нарахуванні кешбеку за замовленням потрібно визначити, до якого розділу належить кожен товар, і знайти відповідне правило. Детальніше про систему знижок.
Визначення категорії товару для кешбеку
Товар може бути прив'язаний до кількох розділів (множинна прив'язка). Для вибору правила беремо «основний» розділ:
function getCashbackRateForProduct(int $productId): float
{
// Основний розділ через b_iblock_element
$element = \CIBlockElement::GetByID($productId)->Fetch();
$sectionId = (int)$element['IBLOCK_SECTION_ID'];
// Шукаємо правило: спочатку за точним розділом, потім за батьками
while ($sectionId > 0) {
$rule = CashbackRuleTable::getActiveRuleForSection($sectionId);
if ($rule) {
return (float)$rule['CASHBACK_PCT'];
}
// Йдемо вгору по дереву розділів
$section = \CIBlockSection::GetByID($sectionId)->Fetch();
$sectionId = (int)$section['IBLOCK_SECTION_ID'];
}
// Правило за замовчуванням
return CashbackConfig::getDefaultRate();
}
Успадкування правил по дереву розділів: якщо на «Електроніка» встановлено 5%, а на «Ноутбуки» немає явного правила — ноутбуки отримають 5% від батьківського розділу. Явне правило на дочірньому розділі завжди перекриває батьківське.
Пріоритет і комбінування правил
Складна логіка з кількома одночасно активними правилами — через пріоритети:
function resolveCashbackRate(int $productId, int $userId): float
{
$baseRate = getCashbackRateForProduct($productId);
// Додаткові правила за групою користувача
$userGroups = CUser::GetUserGroup($userId);
$bonusRates = [];
foreach ($userGroups as $groupId) {
$rule = CashbackRuleTable::getQuery()
->setFilter([
'RULE_TYPE' => 'user_group',
'ENTITY_ID' => $groupId,
'ACTIVE' => 'Y',
'<=DATE_FROM' => new \Bitrix\Main\Type\Date(),
'>=DATE_TO' => new \Bitrix\Main\Type\Date(),
])
->setOrder(['PRIORITY' => 'ASC'])
->fetchObject();
if ($rule) {
$bonusRates[] = (float)$rule->getCashbackPct();
}
}
// Стратегія: беремо максимальний бонус від групи + базова категорійна ставка
$bonusRate = empty($bonusRates) ? 0 : max($bonusRates);
return $baseRate + $bonusRate;
}
Стратегію додавання або заміни обирає бізнес. Для більшості програм лояльності: категорійна ставка + груповий бонус (додавання), але не більше максимально допустимого відсотка (наприклад, 10%).
Винятки: акційні товари та промо-періоди
Нульова ставка на акційні товари реалізується правилом з CASHBACK_PCT = 0 та максимальним пріоритетом (найменше число в полі PRIORITY). Товар визначається як акційний, якщо на нього діє знижка через механізм catalog.discount або через користувацьку властивість IS_PROMO = Y.
Промо-періоди — ті ж правила з DATE_FROM і DATE_TO. Автоматичне ввімкнення/вимкнення без втручання розробника.
Докладніше про пріоритети
Пріоритет 1 — найвищий. Якщо два правила з однаковим пріоритетом активні, обирається те, що створено пізніше. Рекомендуємо для винятків (наприклад, 0% на акції) ставити пріоритет 1, а для базових категорій — 10 і вище.Які типові помилки при налаштуванні?
- Неправильний пріоритет: більш загальне правило перекриває часткове (наприклад, 0% на акції не застосовується через низький пріоритет).
- Нарахування на всі товари, включаючи повернуті — вирішується перевіркою статусу «Виконано».
- Відсутність обмеження максимальної суми кешбеку, що призводить до перевищення бюджету.
Нарахування та управління
Нарахування після завершення замовлення
Кешбек нараховується при зміні статусу замовлення на «Виконано» (не при оплаті — щоб не нараховувати на повернені товари):
AddEventHandler('sale', 'OnSaleStatusOrder', function(string $statusId, \Bitrix\Sale\Order $order) {
if ($statusId !== 'F') { // F = Виконано
return;
}
$userId = $order->getUserId();
$totalCashback = 0;
foreach ($order->getBasket() as $item) {
$productId = (int)$item->getProductId();
$rate = resolveCashbackRate($productId, $userId);
$cashback = $item->getPrice() * $item->getQuantity() * ($rate / 100);
$totalCashback += $cashback;
// Фіксуємо по позиції для детальної історії
CashbackTransactionTable::add([
'USER_ID' => $userId,
'ORDER_ID' => $order->getId(),
'PRODUCT_ID' => $productId,
'AMOUNT' => $cashback,
'RATE' => $rate,
'TYPE' => 'accrual',
]);
}
CashbackBalanceTable::credit($userId, $totalCashback);
});
Управління правилами з адмінки
Інтерфейс управління правилами будується на CAdminList + CAdminForm або React-компонентом у розділі /local/admin/. Щоб створити правило, виконайте:
- Перейдіть до розділу управління правилами.
- Виберіть тип правила (категорія, товар, група користувачів, промо).
- Вкажіть відсоток нарахування та пріоритет.
- Збережіть.
Мінімальний набір: список правил із фільтром за типом/активністю, форма редагування з деревом розділів каталогу для вибору категорії.
Етапи впровадження та типові помилки
Процес роботи та що входить
- Аналіз вимог до програми лояльності та існуючих знижок.
- Проектування таблиць і логіки пріоритетів.
- Реалізація правил категорій, груп та винятків.
- Тестування на тестовому контурі з реальними замовленнями.
- Деплой на продакшн та документування.
Повний склад налаштування правил кешбеку:
- Створення таблиць
local_cashback_rulesтаcashback_transactions. - Реалізація агента нарахування за статусом «Виконано».
- Інтерфейс управління правилами в адмінці.
- Інтеграція з групами користувачів та промо-акціями.
- Документація з конфігурації та навчання маркетологів.
- Досвід інженерів — 10+ років у Бітрікс-розробці, гарантія коректної реалізації.
Порівняння підходів та терміни
| Критерій | Ручний розрахунок | Автоматична система |
|---|---|---|
| Час обробки одного замовлення | 10–15 хв | 1–2 сек (у 450 разів швидше) |
| Помилки | до 30% | <1% |
| Масштабованість | Обмежена | Необмежена |
| Економія на місяць (1000 замовлень) | — | до 5000 грн |
Терміни:
| Задача | Термін |
|---|---|
| Базова логіка категорій | 3–5 днів |
| Групові бонуси та винятки | 3–5 днів |
| Нарахування та історія | 2–3 дні |
| Адмінка | 3–5 днів |
| Повний проект | 2–3 тижні |
Чому автоматизація кешбеку вигідна?
Автоматизація скорочує час обробки замовлень на 95% та виключає помилки при ручному розрахунку. Наприклад, інтернет-магазин з 1000 замовлень на місяць економить до 5000 грн. Бюджет програми лояльності стає прозорим — ви завжди знаєте, скільки нараховано та за якими правилами. Ми використовуємо досвід сертифікованих Бітрікс-розробників для гарантії якості. Наша команда — 5 років на ринку, 80+ завершених проектів.
Перевірка коректності нарахування кешбеку
Після впровадження проведіть тестування: створіть тестове замовлення з товарами різних категорій, перевірте суму нарахованого кешбеку в особистому кабінеті. Переконайтеся, що акційні товари оброблені правильно. Наша команда надає детальний звіт за результатами тестування.
Зв'яжіться з нами, щоб обговорити вашу програму лояльності. Замовте впровадження модуля кешбеку під ключ — ми адаптуємо рішення під ваш асортимент та групи користувачів.