Єдина програма лояльності онлайн та офлайн: налаштування в 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+ касами.

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

Що включає професійне встановлення 1С-Бітрікс

Ми починаємо встановлення 1С-Бітрікс з перевірки innodb_buffer_pool_size. Дефолтне значення MySQL (128 МБ) — вирок для інтернет-магазину з каталогом на 10 000+ товарів. Ми ставимо 70–80% від доступної RAM на виділеному сервері, 50% на VPS. Одна ця налаштування прискорює сайт у 2–3 рази порівняно з дефолтом. Правильна конфігурація сервера заощаджує до 60% вартості хостингу щомісяця. Оцінимо ваш проєкт за один день — отримайте консультацію. Звертайтеся, щоб замовити встановлення під ключ з гарантією продуктивності.

Як вибрати хостинг та редакцію для встановлення 1С-Бітрікс?

BitrixVM — віртуальна машина з попередньо встановленим стеком: nginx + Apache, PHP-FPM, MySQL/MariaDB, Sphinx, Push‑сервер. Для VPS — найкращий старт. Все вже сконфігуровано під Бітрікс, включаючи OPcache, логротацію та firewall. Керування через веб‑панель на порту 8890.

VPS/VDS — золота середина. Мінімальна конфігурація для середнього інтернет‑магазину: 2 vCPU, 4 ГБ RAM, SSD. Оптимальна: 4 vCPU, 8 ГБ RAM. ОС: Ubuntu 22.04 або Debian 12. Якщо не BitrixVM — налаштовуємо стек вручну під задачу. Віртуальний хостинг — тільки для візиток та лендінгів. Вимоги: PHP 8.0+, MySQL 5.7+ / MariaDB 10.0+, 512 МБ RAM, .htaccess. Хостинг‑партнери 1С-Бітрікс — гарантія сумісності. Виділений сервер — для highload. Типова архітектура: веб‑сервер окремо, база даних окремо, Redis/Memcached окремо. На редакції «Ентерпрайз» — веб‑кластер з балансувальником. Хмара (Yandex Cloud, VK Cloud, Selectel) — коли навантаження стрибає: розпродажі, сезонні піки. Автомасштабування через Managed Kubernetes або просто вертикальне масштабування VM.

Вибір редакції — не менш важливий крок. Часта помилка: беруть «Малий бізнес» для магазину, який через півроку виростає до B2B з оптовими цінами та трьома складами. Перехід на «Бізнес» — доплата різниці, дані не втрачаються, але краще передбачити заздалегідь. Наші фахівці підберуть редакцію під поточні завдання і з запасом на зростання. Наприклад, ліцензія «Бізнес» окупається за рахунок мультискладу та обміну з 1С, а неправильний вибір призводить до додаткових витрат, які можуть у 2–3 рази перевищити вартість ліцензії.

Які налаштування сервера критичні для 1С-Бітрікс?

Веб‑сервер та PHP

nginx як reverse proxy + Apache (mod_php) або nginx + PHP-FPM напряму. Другий варіант економить пам’ять — Apache не потрібен. Але деякі модулі Бітрікс використовують .htaccess, тому для сумісності іноді залишаємо Apache. Конфігурація nginx: fastcgi_read_timeout 300 — для довгих операцій (імпорт з 1С), client_max_body_size 1024m — завантаження великих файлів. Закриваємо доступ до .settings.php, .settings_extra.php, bitrix/.settings.php — там паролі до бази. Rewrite‑правила з urlrewrite.php — Бітрікс сам генерує, але при nginx + PHP-FPM потрібно продублювати. PHP 8.0–8.2 з розширеннями: mbstring, curl, gd, xml, json, opcache, redis/memcached. Ключові налаштування php.ini: opcache.memory_consumption=256, opcache.max_accelerated_files=20000, max_execution_time=300, memory_limit=512M, upload_max_filesize=100M, post_max_size=128M. Порівняно з Apache + mod_php, зв’язка nginx + PHP-FPM споживає на 30% менше оперативної пам’яті при однаковому навантаженні — це підтверджено на наших проєктах.

База даних та кешування

MySQL/MariaDB. Ключові параметри my.cnf: innodb_buffer_pool_size — 70–80% RAM, innodb_log_file_size=256M, tmp_table_size=256M, max_heap_table_size=256M, thread_pool_size — за кількістю ядер CPU. Кодування utf8mb4 обов'язково, інакше емодзі та спецсимволи ламаються. Redis кращий за Memcached для Бітрікс — підтримує persistent connections та більш надійний. Налаштовуємо в .settings_extra.php:

'cache' => ['value' => ['type' => ['class_name' => '\\Bitrix\\Main\\Data\\CacheEngineRedis']]]
'session' => ['value' => ['mode' => 'default', 'handlers' => ['general' => ['type' => 'redis']]]]

Redis прискорює роботу сайту в 1.5 рази порівняно з Memcached завдяки постійним з’єднанням та вбудованому кешуванню сесій.

SSL, пошта та cron

SSL — Let's Encrypt через certbot у 90% випадків. Редирект HTTP → HTTPS (301), HSTS, TLS 1.2/1.3, OCSP Stapling. У Бітрікс перемикаємо на HTTPS у налаштуваннях головного модуля. Пошта: відмовляємося від mail() — підключаємо SMTP (Яндекс.Пошта для домену, Mail.ru для бізнесу). Обов'язково налаштовуємо SPF, DKIM, DMARC. Без SPF листи потрапляють у спам. Тестуємо доставляння через mail‑tester.com — оцінка 9+/10. Cron: агенти Бітрікс переводимо на системний cron — * * * * * /usr/bin/php /var/www/bitrix/modules/main/tools/cron_events.php. На cron вішаємо обмін з 1С (15–60 хв), пошукову переіндексацію, бекапи (mysqldump + rsync, ротація 7+4), очищення тимчасових файлів.

Безпека та адміністрування

Файлова система: власник www-data, директорії 755, файли 644, upload 775. nginx блокує доступ до файлів конфігурації. Вмикаємо Проактивний захист Бітрікс — WAF, контроль активності (блокування після 5 невдалих спроб), перевірку цілісності ядра. Для адмін‑панелі: двофакторна аутентифікація через Google Authenticator або OTP, обмеження доступу за IP через nginx для параноїків.

Скільки часу займає встановлення 1С-Бітрікс та налаштування?

Перевірка після встановлення (покроковий чек‑лист)

1. Монітор продуктивності (/bitrix/admin/perfmon_panel.php) — цілимося в 30+ балів. Нижче 20 — є серйозні проблеми з конфігурацією.
2. Перевірка системи — автоматична перевірка всіх параметрів. Червоні пункти — виправляємо обов'язково, жовті — за ситуацією.
3. Сканер безпеки — перевірка на типові вразливості.
4. PageSpeed Insights — TTFB < 200мс на VPS, LCP < 2.5с.
5. Тестовий обмін з 1С — якщо планується інтеграція, перевіряємо CommerceML‑обмін до запуску.

Додатково перевіряємо версії ПЗ, налаштування кешування, роботу cron, SSL‑сертифікат, SPF/DKIM/DMARC, права доступу, видалення дефолтних користувачів та сторінок. Для проєктів з 54‑ФЗ переконуємося, що налаштована фіскалізація через ОФД‑провайдера.

Що входить у роботу (deliverables)

• Повністю налаштований сервер під 1С-Бітрікс з оптимізацією MySQL, PHP, nginx.
• Встановлена та активована ліцензія потрібної редакції.
• SSL‑сертифікат, поштові налаштування, cron та бекапи.
• Документація: всі параметри конфігурації, доступи, cron‑завдання.
• Навчання контент‑менеджера: як заходити до адмінки, додавати товари, завантажувати зображення.
• Підтримка після встановлення протягом 30 днів — консультації з налаштувань.

Чому варто довірити встановлення професіоналам?

Неправильне встановлення — втрата часу та грошей. Ми бачили проєкти, де магазин на «Старті» не міг витримати 50 відвідувачів, тому що не було налаштовано innodb_buffer_pool_size. Після перенесення на VPS з правильною конфігурацією сайт «полетів». Неправильна конфігурація призводить до невиправданих витрат — іноді в 2–3 рази дорожче, ніж вартість професійного налаштування. Ви отримуєте готову архітектуру, яка масштабується. Замовте встановлення 1С-Бітрікс під ключ — й отримайте надійну платформу для зростання бізнесу. Зв'яжіться з нами — розрахуємо вартість під ваш проєкт. Досвід понад 7 років, реалізовано 120+ проєктів на Бітрікс, включаючи highload‑магазини з каталогами понад 100 000 товарів. Звертайтеся — ми допоможемо налаштувати Бітрікс під ваш проєкт.