Клиент настроил кассу, но чеки не отправляются. В очереди 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 или самостоятельную разработку обработчика.
Сравнение операторов:
| Оператор |
Надёжность |
Скорость отправки |
Сложность настройки |
| АТОЛ Онлайн |
высокая |
до 5 секунд |
средняя |
| ЮКасса |
высокая |
до 3 секунд |
низкая |
| Сбербанк |
высокая |
до 7 секунд |
высокая |
АТОЛ Онлайн лучше для магазинов с большим потоком заказов: пропускная способность выше в 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% проблем решаются проверкой настроек агента и учётных данных кассы.
Что делать, если чеки не отправляются?
Мы подготовили чек-лист:
Чек-лист проверки очереди чеков
- Проверьте активность агента (
b_agent).
- Убедитесь, что URL кассы указан верно (тестовый/боевой).
- Проверьте состав чека: НДС, наименования товаров, признак способа расчёта.
- Протестируйте отправку на тестовой среде АТОЛ.
- Просмотрите логи:
/bitrix/modules/sale/log/.
Типичные ошибки и их решения
| Ошибка |
Причина |
Решение |
| Time-out при отправке |
Неверный URL или заблокирован аккаунт |
Проверить URL, пересоздать ключи API |
| Ошибка 400 |
Неверный состав чека (НДС или наименования) |
Проверить ставки НДС в товарах, заполнить наименования |
| Неактивный агент |
Cron не выполняется или агент отключен |
Активировать агент через админку или SQL |
Как протестировать онлайн-кассу перед запуском?
Перед переключением на боевой режим — протестировать на тестовой среде АТОЛ. В настройках кассы указать тестовый 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 раза по сравнению с дефолтом. Оценим ваш проект за один день — получите консультацию. Обращайтесь, чтобы заказать установку под ключ с гарантией производительности.
Как выбрать хостинг и редакцию для установки 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 с оптовыми ценами и тремя складами. Переход на «Бизнес» — доплата разницы, данные не теряются, но лучше предусмотреть заранее. Наши специалисты подберут редакцию под текущие задачи и с запасом на рост. Например, лицензия «Бизнес» (около 35 000 ₽) окупается за счёт мультисклада и обмена с 1С, а неправильный выбор приводит к потере до 30 000 ₽ ежемесячно на избыточных ресурсах.
| Редакция |
Для кого |
Ключевое ограничение |
| Старт |
Визитки, лендинги |
Нет инфоблоков 2.0, нет торгового каталога |
| Стандарт |
Корпоративные сайты |
Нет e‑commerce модуля |
| Малый бизнес |
Маленькие магазины |
1 тип цены, 1 склад, нет обмена с 1С |
| Бизнес |
Средние магазины, B2B |
Мультисклад, мультивалюта, CommerceML |
| Энтерпрайз |
Highload, кластер |
Веб‑кластер, CDN, мультисайтовость |
Какие настройки сервера критичны для 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.
База данных и кэширование
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']]]]
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С-Битрикс и настройка?
| Задача |
Срок |
| Установка на виртуальный хостинг |
2–4 часа |
| Установка на VPS с настройкой стека |
1–2 дня |
| Установка на dedicated с проектированием архитектуры |
2–5 дней |
| SSL + почта + cron + безопасность |
1–2 дня |
| Настройка бэкапов и мониторинга |
0.5–1 день |
Проверка после установки (пошаговый чек‑лист)
-
Монитор производительности (
/bitrix/admin/perfmon_panel.php) — целимся в 30+ баллов. Ниже 20 — есть серьёзные проблемы с конфигурацией.
-
Проверка системы — автоматическая проверка всех параметров. Красные пункты — исправляем обязательно, жёлтые — по ситуации.
-
Сканер безопасности — проверка на типичные уязвимости.
-
PageSpeed Insights — TTFB < 200мс на VPS, LCP < 2.5с.
-
Тестовый обмен с 1С — если планируется интеграция, проверяем CommerceML‑обмен до запуска.
Дополнительно проверяем версии ПО, настройки кэширования, работу cron, SSL‑сертификат, SPF/DKIM/DMARC, права доступа, удаление дефолтных пользователей и страниц. Для проектов с 54‑ФЗ убеждаемся, что настроена фискализация через ОФД‑провайдера.
Что входит в работу (deliverables)
- Полностью настроенный сервер под 1С-Битрикс с оптимизацией MySQL, PHP, nginx.
- Установленная и активированная лицензия нужной редакции.
- SSL‑сертификат, почтовые настройки, cron и бэкапы.
- Документация: все параметры конфигурации, доступы, cron‑задачи.
- Обучение контент‑менеджера: как заходить в админку, добавлять товары, загружать изображения.
- Поддержка после установки в течение 30 дней — консультации по настройкам.
Почему стоит доверить установку профессионалам?
Неправильная установка — потеря времени и денег. Мы видели проекты, где магазин на «Старте» не мог выдержать 50 посетителей, потому что не был настроен innodb_buffer_pool_size. После переноса на VPS с правильной конфигурацией сайт «полетел». Неправильная конфигурация может обходиться в 30 000 ₽ ежемесячно из‑за избыточного потребления ресурсов. Вы получаете готовую архитектуру, которая масштабируется. Закажите установку 1С-Битрикс под ключ — и получите надёжную платформу для роста бизнеса. Свяжитесь с нами — рассчитаем стоимость под ваш проект. Опыт более 7 лет, реализовано 120+ проектов на Битрикс, включая highload‑магазины с миллионными каталогами. Обращайтесь — мы поможем настроить Битрикс под ваш проект.