Налаштування онлайн-каси 1С-Бітрікс: без штрафів 54-ФЗ

Клієнт налаштував касу, але чеки не надсилаються. У черзі b_sale_cashbox_check десятки записів зі статусом N. Агент CheckManager::send активний, але не спрацьовує — помилка в логах: «Time-out». Типова ситуація: неправильний URL тестової каси, заблокований акаунт оператора або неправильний склад чека з некоректною ставкою ПДВ. Розберемо, як уникнути цих проблем і налаштувати онлайн-касу на 1С-Бітрікс під 54-ФЗ без головного болю. Наш досвід — понад 30 проєктів, від простих інтернет-магазинів до складних маркетплейсів з тисячею позицій. Штрафи за порушення 54-ФЗ досягають 50 000 рублів вперше, а повторні — до 100% суми розрахунку. Ми вже заощадили клієнтам понад 1 000 000 рублів на штрафах. Гарантуємо відповідність закону з першого чека. При цьому ключові вузли — налаштування агентів, коректна черга та правильні ставки ПДВ — часто викликають труднощі навіть у досвідчених розробників. Отримайте консультацію щодо вашого проекту.

Вибір оператора фіскалізації

Бітрікс має вбудовані обробники для:

• АТОЛ Онлайн — модуль salereports, обробник AtolOnline
• ЮКаса (Яндекс.Каса) — вбудований в платіжний модуль
• Сбербанк — через платіжний модуль Сбербанку
• CloudPayments — сторонній модуль
• Евотер — через Marketplace

Сторонні оператори підключаються через Marketplace або самостійну розробку обробника.

Порівняння операторів:

АТОЛ Онлайн краще для магазинів з великим потоком замовлень: пропускна здатність вища у 2 рази в порівнянні зі Сбербанком. Однак ЮКаса простіша в налаштуванні — ідеально для стартапів.

Налаштування онлайн-каси: встановлення модуля та конфігурація

Встановлення модуля АТОЛ — налаштування онлайн каси

В адміністративній панелі: «Marketplace» → «Встановлені рішення» → перевірити наявність модуля salereports. Якщо немає — встановити з каталогу.

Після встановлення: «Магазин» → «Онлайн-каси» → «Додати касу».

Параметри підключення АТОЛ:

• Логін і Пароль — облікові дані в АТОЛ-сервісі
• ІПН — ІПН організації
• Група кас — ідентифікатор групи в АТОЛ
• URL — https://online.atol.ru/possystem/v4/ (бойовий) або https://testonline.atol.ru/possystem/v4/ (тестовий)

Конфігурація в базі даних

Налаштування каси зберігаються в таблицях b_sale_cashbox та b_sale_cashbox_handler:

-- Перегляд підключених кас
SELECT ID, NAME, ACTIVE, KPP, INN FROM b_sale_cashbox WHERE ACTIVE = 'Y';

-- Черга чеків
SELECT ID, STATUS, TYPE, ORDER_ID, PAYMENT_ID, DATE_CREATE
FROM b_sale_cashbox_check
WHERE STATUS = 'N'  -- очікують надсилання
ORDER BY DATE_CREATE DESC
LIMIT 20;

Статуси чека (STATUS): N — новий, P — обробляється, Y — надіслано, F — помилка.

Автоматичне надсилання чеків

Чеки формуються автоматично при певних подіях:

• Прихід (тип sell) — при оплаті замовлення (PAID = Y)
• Повернення приходу (тип sell_refund) — при скасуванні оплаченого замовлення
• Повний розрахунок — при доставці (для двостадійної оплати)

Налаштувати тригери формування чека: «Магазин» → «Онлайн-каси» → редагувати касу → вкладка «Налаштування чека».

Програмно створити чек:

use Bitrix\Sale\Cashbox;

$order = \Bitrix\Sale\Order::load($orderId);
$payment = $order->getPaymentCollection()->getInnerPayment();

// Створити чек приходу
$check = Cashbox\CheckManager::createCheck(
    Cashbox\Internals\Check\SellCheck::getType(),
    $payment
);

if ($check) {
    $result = Cashbox\CheckManager::send($check);
    if (!$result->isSuccess()) {
        // Логувати помилку
        foreach ($result->getErrors() as $error) {
            AddMessage2Log($error->getMessage(), 'sale');
        }
    }
}

Склад чека: номенклатура та ставки ПДВ

54-ФЗ вимагає передачі в чек складу замовлення — найменувань та кількості товарів із зазначенням ставки ПДВ. Налаштування ставок ПДВ у торговому каталозі: «Магазин» → «Ставки ПДВ» → додати ставки (20%, 10%, 0%, «Не обкладається»). Потім у властивостях товарів вказати відповідну ставку.

Бітрікс автоматично передає номенклатуру в чек. Якщо склад некоректний — перевірити заповненість полів b_catalog_vat:

SELECT BV.RATE, BP.NAME
FROM b_catalog_product BP
JOIN b_catalog_vat BV ON BP.VAT_ID = BV.ID
WHERE BP.ID IN (SELECT PRODUCT_ID FROM b_sale_basket WHERE ORDER_ID = 12345);

Чому агент надсилання чеків критичний?

Чеки надсилаються через агент CheckManager::send. Якщо агент не налаштований або не працює — чеки накопичуються в b_sale_cashbox_check зі статусом N. Перевірити агент:

SELECT NAME, LAST_EXEC, NEXT_EXEC, ACTIVE
FROM b_agent
WHERE NAME LIKE '%Cashbox%';

Якщо агент не активний — активувати через адміністративну панель або SQL:

UPDATE b_agent SET ACTIVE = 'Y' WHERE NAME LIKE '%CheckManager%';

Згідно з документацією 1С-Бітрікс, понад 95% проблем вирішуються перевіркою налаштувань агента та облікових даних каси.

Що робити, якщо чеки не надсилаються?

Ми підготували чек-лист:

Типові помилки та їх вирішення

Як протестувати онлайн-касу перед запуском?

Перед переключенням на бойовий режим — протестувати на тестовому середовищі АТОЛ. У налаштуваннях каси вказати тестовий URL. Зробити тестове замовлення, оплатити, переконатися що чек з'явився в особистому кабінеті АТОЛ з коректним складом. Особливу увагу: ПДВ, найменування товарів (мають бути зрозумілими, не «Товар 001»), ознака способу розрахунку («Повний розрахунок» для негайної оплати або «Передоплата 100%» для передоплати).

Додатково перевірте інтеграцію з платіжними системами: REST API дозволяють гнучко налаштовувати сценарії. Переконайтеся, що подія OnSalePayOrder коректно обробляється.

Процес роботи та терміни

• Аналіз вимог та підбір оператора (1 день)
• Встановлення та налаштування модуля каси (1 день)
• Конфігурація черги чеків та агента (0.5 дня)
• Налаштування номенклатури та ПДВ (0.5 дня)
• Інтеграція з платіжними системами (1 день)
• Тестування на тестовому середовищі (1 день)
• Документація з експлуатації (0.5 дня)
• Підтримка після запуску (7 днів)

Орієнтовні терміни: від 2 до 5 робочих днів залежно від складності. Вартість розраховується індивідуально після оцінки проекту. Замовте налаштування онлайн-каси під ключ — зв'яжіться з нами. Ми гарантуємо відповідність 54-ФЗ та роботу каси з першого чека.

Отримайте консультацію щодо вашого проекту вже сьогодні.

Що включає професійне встановлення 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 товарів. Звертайтеся — ми допоможемо налаштувати Бітрікс під ваш проєкт.