Подключение Атол.Онлайн к Битрикс

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

Что такое АТОЛ Онлайн и зачем облачная касса

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

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

Где в Битрикс подключается касса

Вся работа с онлайн-кассами в 1С-Битрикс живёт в модуле sale («Интернет-магазин»). Раздел находится в административной части: Магазин → Кассы → Список касс. Здесь по кнопке добавления вы создаёте новую кассу и выбираете обработчик.

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

После выбора обработчика форма перестроится и покажет поля, специфичные именно для АТОЛ: реквизиты доступа, система налогообложения, параметры ставок. Пока касса не привязана к оплатам (об этом ниже), чеки формироваться не будут, даже если реквизиты введены верно.

Параметры подключения обработчика АТОЛ

Ключевой этап — перенос реквизитов доступа из личного кабинета АТОЛ Онлайн в настройки кассы. Обработчик обращается к API АТОЛ, поэтому набор полей строго определён.

Логин и пароль для API — это отдельные учётные данные, а не пара для входа в веб-кабинет. Код группы определяет, на какую именно арендованную кассу уйдёт документ; при ошибке в нём чек будет уходить «в никуда» или возвращать ошибку авторизации.

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

Сама по себе заведённая касса ничего не фискализирует — её нужно связать с теми оплатами, по которым должны выбиваться чеки. В карточке кассы есть блок «Платёжные системы» (в некоторых редакциях — соответствие видов оплат кассе).

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

Именно эта связка отвечает на вопрос «когда бить чек»: как только заказ с привязанной платёжной системой переходит в состояние оплаты, Битрикс ставит задание на формирование чека и отправляет его в АТОЛ.

ФФД, система налогообложения и ставки НДС

Чтобы чек прошёл проверку ОФД, налоговые параметры на сайте должны совпадать с тем, что зарегистрировано у кассы. В настройках обработчика задаются:

• Версия ФФД — формат фискальных документов. Он должен соответствовать версии, зарегистрированной на ККТ в АТОЛ (актуальные магазины работают на ФФД 1.2).
• Система налогообложения (СНО) — ОСН, УСН доход, УСН доход-расход и т. д. Указывается ровно та, что закреплена за кассой.
• Ставки НДС — сопоставление ставок Битрикс (из свойств товаров) со значениями, которые понимает касса: 20%, 10%, без НДС и др.

Здесь же настраивается, какой контакт покупателя уходит в чек — e-mail или телефон. По 54-ФЗ электронный чек нужно отправить клиенту, поэтому хотя бы одно из этих полей в заказе должно быть заполнено.

Когда формируются чеки и как это связано со статусами

В облачной схеме чек бьётся автоматически по событию оплаты, а не вручную. Логика такая:

1. Покупатель оплачивает заказ через привязанную платёжную систему.
2. Платёж помечается как поступивший — заказ переходит в состояние «оплачен».
3. Битрикс формирует фискальный документ и отправляет его в АТОЛ Онлайн через API.
4. Касса выбивает чек, ОФД возвращает фискальные признаки, и они сохраняются у заказа.

Отправка чеков идёт через агент модуля магазина — фоновую задачу, которая периодически отправляет накопленные документы и забирает результат. Поэтому чек появляется не мгновенно, а с небольшой задержкой; если агенты на сайте не выполняются, чеки будут «зависать» в очереди.

Тестовый режим и проверка подключения

Перед боевым запуском подключение проверяют в тестовом контуре, чтобы не выбить некорректные реальные чеки. У АТОЛ есть тестовая площадка API с отдельными учётными данными.

• Включите тестовый режим в настройках кассы и укажите тестовые логин, пароль и код группы, выданные АТОЛ.
• Оформите тестовый заказ, проведите оплату и убедитесь, что заказ переходит в оплаченный статус, а чек получает фискальные данные.
• Проверьте карточку заказа: у неё должны появиться сведения по чеку — статус, фискальный признак, дата.

Убедившись, что документы уходят без ошибок, переключите кассу на боевые реквизиты и отключите тестовый режим. Первую реальную оплату полезно проконтролировать вручную: проверить, что чек дошёл до ОФД и клиент получил его на почту или телефон.

Итог

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

Если чеки не выбиваются, отклоняются ОФД из-за расхождения реквизитов или зависают в очереди из-за не настроенных агентов — мы подключаем и отлаживаем облачную кассу под ключ: от корректной настройки обработчика и налоговых параметров до стабильной фоновой отправки документов на боевом сайте.