Настройки Атол.Онлайн со стороны сайта

Регистрация ККТ и договор с ОФД — только половина дела. Чтобы чеки уходили корректно, кассу нужно правильно описать на стороне сайта: доступы, реквизиты, ставки НДС и признаки расчёта. Разберём карточку кассы АТОЛ Онлайн в 1С-Битрикс поле за полем.

Где в Битрикс живут настройки кассы

Всё, что касается фискализации на стороне сайта, сосредоточено в модуле sale, раздел «Магазин → Кассы» (в старых редакциях — «Настройки → Кассы ККМ»). Здесь вы добавляете кассу, выбираете обработчик «АТОЛ Онлайн (v4)» или «АТОЛ Онлайн (v5)» и заполняете её параметры. Версия обработчика должна соответствовать версии API, которую вам выдал АТОЛ, — v5 работает с актуальным протоколом и ФФД 1.2.

Логика простая: одна касса в Битрикс = одна связка «ККТ + группа + СНО». Если у магазина несколько систем налогообложения или несколько ККТ под разные потоки платежей, вы заводите несколько касс и распределяете между ними платёжные системы. Все поля карточки делятся на четыре смысловых блока: доступы к сервису, реквизиты продавца, налоговые параметры и признаки расчёта.

Доступы к сервису и код группы

Первый блок — параметры подключения к облаку АТОЛ. Их вам выдают в личном кабинете сервиса при регистрации ККТ:

• Логин и пароль доступа к API АТОЛ Онлайн — это не логин от кабинета, а отдельная учётная запись для интеграции;
• Код группы ККТ (group_code) — идентификатор пула касс; именно он определяет, на какую физическую ККТ уйдёт чек;
• Тестовый режим — переключатель, который направляет запросы на демо-стенд АТОЛ вместо боевого сервера.

Код группы — самое частое место ошибок. У боевого и тестового контуров коды группы разные, и при переносе с теста на прод его нужно менять вместе с флагом тестового режима. Если оставить тестовый group_code на боевом сайте, чеки будут «уходить», но не фискализироваться на реальной кассе.

Реквизиты продавца в чеке

Второй блок описывает, от чьего имени и куда пробивается чек. Эти поля напрямую попадают в фискальный документ, поэтому ошибки здесь видит и покупатель, и налоговая:

• Электронная почта отправителя чека — адрес, с которого ОФД рассылает электронные чеки покупателям; должен быть реальным и совпадать с зарегистрированным;
• Место расчётов — адрес сайта магазина (например, https://shop.ru), который печатается в чеке как место совершения расчёта;
• Наименование организации и ИНН — как правило, подтягиваются из настроек ККТ на стороне АТОЛ, но в карточке кассы стоит убедиться, что они не переопределены неверно.

Отдельно задаётся система налогообложения по умолчанию (СНО): ОСН, УСН «доходы», УСН «доходы минус расходы», ЕСХН или патент. Значение должно совпадать с тем, что зашито в самой ККТ при регистрации, иначе чек будет отклонён с ошибкой несоответствия СНО.

Соответствие ставок НДС

Битрикс хранит собственные ставки НДС (в разделе «Магазин → Настройки → Ставки налогов»), а ККТ оперирует фиксированным набором фискальных ставок. В карточке кассы вы сопоставляете одно с другим — это блок «Ставки НДС». Правильный маппинг критичен: неверная ставка в чеке — это некорректный фискальный документ.

Для магазина на УСН всё простое: все ставки Битрикс маппятся в «Без НДС». Для ОСН нужно аккуратно развести 10% и 20% по товарным группам. Помните, что ставка НДС для доставки задаётся отдельным полем — доставку тоже нужно пробить как позицию чека с корректной ставкой.

Признаки способа и предмета расчёта

ФФД требует, чтобы каждая позиция чека несла два атрибута: признак способа расчёта (когда платят) и признак предмета расчёта (что продают). В карточке кассы задаются значения по умолчанию, которые подставляются, если у товара не указано своё.

• Признак способа расчёта — «Предоплата 100%», «Аванс», «Полный расчёт», «Частичный расчёт и кредит» и т. д. Для типичного интернет-магазина с оплатой на сайте это «Полный расчёт», если товар отгружается сразу, или «Предоплата 100%», если сначала оплата, потом отгрузка;
• Признак предмета расчёта — «Товар», «Услуга», «Работа», «Платёж», «Агентское вознаграждение» и др.; для обычных товаров — «Товар»;
• Признак предмета расчёта для доставки — как правило, «Услуга».

Значения по умолчанию покрывают 90% ассортимента, но для отдельных товаров (услуги, подарочные сертификаты, маркированная продукция) признаки задаются индивидуально в карточке товара. Если этого не сделать, услуга уедет в чек как «Товар» — формально это нарушение состава фискального документа.

Привязка кассы к платёжным системам

Сама по себе касса не знает, какие заказы фискализировать. Связь задаётся через платёжные системы: в списке касс вы указываете, для каких способов оплаты (ЮKassa, Сбербанк, наличные при получении, безналичный расчёт) эта касса печатает чеки. Один и тот же обработчик АТОЛ можно повесить на несколько платёжных систем.

Второй важный параметр — момент печати чека. В зависимости от бизнес-процесса и ФФД чек может формироваться:

1. При оплате — покупатель заплатил онлайн, система сразу пробивает чек прихода;
2. При отгрузке — если модель «сначала оформили, потом рассчитались/выдали», используется отдельный чек отгрузки;
3. По обоим событиям — при разделении на чек оплаты и чек отгрузки (актуально для предоплаты и постоплаты).

Агенты, cron и контроль результата

Фискализация в Битрикс работает асинхронно. При событии оплаты или отгрузки система не общается с АТОЛ в момент клика покупателя, а ставит чек в очередь. Реальную отправку и получение фискального признака выполняет агент модуля sale. Поэтому обязательное условие корректной работы — агенты на cron, а не «на хитах».

• Проверьте, что в /bitrix/php_interface/dbconn.php задано define("BX_CRON_SUPPORT", true); и агенты вынесены в системный планировщик;
• Убедитесь, что /bitrix/modules/main/tools/cron_events.php вызывается по расписанию — иначе чеки будут копиться в статусе ожидания;
• Результат смотрите в «Магазин → Кассы → Чеки»: там видны статус чека, фискальный признак, дата и текст ошибки, если она была.

Именно связка «правильная карточка кассы + рабочий cron + мониторинг раздела чеков» даёт стабильную фискализацию. Настройки без работающих агентов бесполезны: чеки будут выглядеть созданными, но так и не уйдут в ОФД.

Итог

Настройка АТОЛ Онлайн со стороны сайта — это не одно поле, а четыре согласованных блока: доступы и код группы из нужного контура, реквизиты и СНО, совпадающие с зарегистрированной ККТ, маппинг ставок НДС и признаки способа и предмета расчёта. Поверх этого — привязка к платёжным системам, выбор момента печати чека и обязательный cron для агентов. Ошибка в любом из блоков превращается либо в отклонённый чек, либо в тихо непробитый расчёт.

Если запуск кассы горит, а чеки уходят с ошибками или не уходят вовсе, мы разбираем настройки, чиним агенты и проверяем весь путь от оплаты до фискального признака. Поможем корректно подключить и настроить АТОЛ Онлайн на вашем магазине под 1С-Битрикс и требования 54-ФЗ.