Єдина програма лояльності онлайн та офлайн: налаштування в 1С-Бітрікс

Налаштування єдиної програми лояльності онлайн та офлайн в 1С-Бітрікс

Ми стикалися з ситуацією: клієнт накопичив 500 бонусів на сайті, приходить до магазину — касир їх не бачить. Або покупка в магазині не нараховує бали на онлайн-акаунт. Розрив між онлайн та офлайн програмою лояльності — це не лише UX-проблема, але й прямі втрати повторних продажів. Ми налаштовуємо єдину систему лояльності під ключ: інтеграція сайту та кас, синхронізація бонусів у реальному часі, повна прозорість для клієнта.

Як влаштована лояльність в Бітрікс

Модуль sale реалізує дисконтну систему через b_sale_user_discount (персональні знижки) та бонусну систему через b_sale_discount (правила кошика). Для повноцінної програми лояльності з накопичувальними балами потрібен або окремий модуль, або інтеграція із зовнішньою системою. В Бітрікс24 є CRM-модуль з бонусами (b_crm_loyalty_bonus_transaction), але для інтернет-магазину без Бітрікс24 частіше застосовується або модуль marketingcrm, або власна таблиця транзакцій. За нашим досвідом, кастомна реалізація дає найбільшу гнучкість та надійність — ви не прив'язані до обмежень типового модуля.

Структура зберігання бонусів: таблиці та транзакції

Мінімальна структура для єдиної програми:

CREATE TABLE bl_loyalty_account ( id SERIAL PRIMARY KEY, user_id INT UNIQUE, -- b_user.ID (онлайн) card_number VARCHAR(20) UNIQUE, -- номер карти для офлайн balance NUMERIC(10,2) DEFAULT 0, created_at TIMESTAMP DEFAULT NOW() ); CREATE TABLE bl_loyalty_transaction ( id SERIAL PRIMARY KEY, account_id INT NOT NULL REFERENCES bl_loyalty_account(id), amount NUMERIC(10,2) NOT NULL, -- додатне=нарахування, від'ємне=списання type VARCHAR(20) NOT NULL, -- 'earn_online', 'earn_offline', 'spend', 'expire' order_id INT, -- b_sale_order.ID або зовнішній ID офлайн-чека source VARCHAR(20) NOT NULL, -- 'web', 'pos', 'mobile' created_at TIMESTAMP DEFAULT NOW() ); 

Транзакційна модель з історією — єдиний надійний спосіб зберігати бонуси. Ніколи не оновлюйте balance напряму без запису транзакції. balance — це або денормалізований агрегат (оновлюється тригером БД), або рахується як SUM(amount) по таблиці транзакцій. Останній підхід безпечніший, але повільніший при частих запитах балансу.

Як ідентифікувати клієнта на офлайн-касі?

Ключове завдання: касир повинен знайти акаунт клієнта. Способи ідентифікації:

• Номер карти лояльності (фізична карта або штрихкод у мобільному додатку)
• Номер телефону (найпоширеніший)
• QR-код з токеном (генерується в особистому кабінеті сайту)

При ідентифікації за телефоном касове ПЗ надсилає запит до API Бітрікс:

// /local/ajax/loyalty/find-account.php $phone = normalizePhone($_POST['phone']); $bitrixUser = \CUser::GetList([], ['PERSONAL_PHONE' => $phone])->Fetch(); if ($bitrixUser) { $account = getLoyaltyAccount($bitrixUser['ID']); echo json_encode(['balance' => $account['balance'], 'account_id' => $account['id']]); } 

Нарахування бонусів при онлайн-замовленні

Обробник зміни статусу замовлення — після доставки/завершення:

AddEventHandler('sale', 'OnSaleStatusOrderChange', function(\Bitrix\Main\Event $event) { $order = $event->getParameter('ENTITY'); $status = $order->getField('STATUS_ID'); if ($status !== 'F') return; // Тільки завершені замовлення $userId = $order->getUserId(); $bonus = round($order->getPrice() * BONUS_RATE); // BONUS_RATE = 0.05 (5%) addLoyaltyTransaction($userId, $bonus, 'earn_online', $order->getId(), 'web'); }); 

Списання бонусів при онлайн-оплаті

Бонуси застосовуються через правило кошика або через кастомний платіжний метод. Правило кошика (b_sale_discount) може давати знижку фіксованою сумою. Для більш гнучкої схеми — власний «платіжний метод» типу «Оплата бонусами», який під час проведення замовлення списує транзакцію з bl_loyalty_transaction.

Чому транзакційне списання критично важливе?

Офлайн-каса викликає три endpoint:

1. GET /loyalty/balance?phone=... — перевірити баланс
2. POST /loyalty/spend — списати бонуси при продажу (має бути транзакційним: початок продажу → резервування → підтвердження)
3. POST /loyalty/earn — нарахувати бонуси після продажу

Резервування при списанні — критично важливий крок. Без нього два паралельних запити від різних кас можуть одночасно прочитати баланс 500 бонусів і двічі списати по 500, пішовши в мінус. Резервування через SELECT ... FOR UPDATE в PostgreSQL або через строгий UPDATE з перевіркою результату:

UPDATE bl_loyalty_account SET balance = balance - :amount WHERE id = :account_id AND balance >= :amount RETURNING balance; -- Якщо оновлено 0 рядків — недостатньо бонусів 

Цей підхід надійніший за використання блокувань на рівні додатку.

Порівняння підходів: кастомна таблиця vs модуль Бітрікс

Кастомна таблиця програє модулям за швидкістю впровадження, але в 2-3 рази надійніша при високих навантаженнях та нестандартних бізнес-логіках.

Що входить у роботу

• Проєктування структури таблиць bl_loyalty_account та bl_loyalty_transaction
• Розробка REST API для касових систем (баланс, нарахування, списання)
• Створення обробників подій OnSaleStatusOrderChange для онлайн-нарахувань
• Механізм ідентифікації клієнта за телефоном/картою
• Транзакційне списання із захистом від race condition
• Адміністративний інтерфейс для перегляду та скасування транзакцій
• Документація по API та інструкція для касирів
• Тестування та гарантія 30 днів

Строки та бюджет

Налаштування єдиної програми лояльності займає від 5 до 15 робочих днів залежно від складності (кількість кас, необхідність інтеграції з 1С, вимоги до звітності). Вартість розраховується індивідуально після аудиту поточної системи. Оцінимо ваш проект за 1 день.

Типові помилки при налаштуванні

• Оновлення балансу напряму без транзакції — втрата даних при збої.
• Відсутність блокувань при списанні — подвійне списання.
• Ігнорування API-логіювання — складно налагоджувати.
• Використання лише модуля marketingcrm для офлайн — не підтримує резервування.

Уникнути цих помилок допомагає досвід — ми реалізували понад 30 проектів з лояльності на Бітрікс, включаючи мережі з 50+ касами.

Зв'яжіться з нами для консультації: розкажемо, як об'єднати онлайн та офлайн лояльність у вашому бізнесі.