Подключение Orange Data к Битрикс

Orange Data — облачный сервис фискализации: ваши арендованные ККТ стоят в дата-центре оператора, а сайт лишь передаёт данные чека по API. В 1С-Битрикс для этого есть штатный обработчик кассы, но его подключение отличается от привычного Атол.Онлайн: авторизация идёт не по логину и паролю, а по паре RSA-ключей и клиентскому SSL-сертификату.

Что такое Orange Data и когда её выбирают

Orange Data — это сервис облачной фискализации по 54-ФЗ. Вы не ставите физическую кассу в офисе: оператор размещает арендуемую вами ККТ с фискальным накопителем в своём дата-центре, а интернет-магазин отправляет туда состав чека через REST API. В ответ приходит фискальный признак, и покупателю уходит электронный чек на почту или телефон.

Такую модель обычно выбирают, когда:

• у магазина только онлайн-оплаты и нет физической точки продаж, где стояла бы касса;
• нужен быстрый старт без закупки и обслуживания «железа»;
• важна отказоустойчивость — за состоянием ФН и сроками замены следит оператор.

В 1С-Битрикс Orange Data поддерживается на уровне модуля sale отдельным обработчиком кассы, поэтому дописывать код для базовой отправки чеков не требуется — вся логика уже в классе \Bitrix\Sale\Cashbox\CashboxOrangeData.

Что подготовить до настройки в Битрикс

Главная особенность Orange Data — авторизация запросов по криптографии, а не по паре «логин/пароль». Поэтому до входа в админку сайта нужно собрать пакет данных в личном кабинете оператора.

1. Договор и арендованная ККТ. Убедитесь, что касса привязана к вашему ИНН и зарегистрирована в ФНС — Orange Data делает это на своей стороне, но проверить статус нужно.
2. Пара RSA-ключей для подписи. Вы генерируете закрытый и открытый ключ (например, через openssl), открытый загружаете в кабинет Orange Data, а закрытый в формате PEM оставляете у себя — его вставим в настройки Битрикс.
3. Клиентский SSL-сертификат и ключ к нему. Оператор выдаёт сертификат для взаимной TLS-аутентификации (mTLS): без него запросы к боевому API не пройдут.

Добавление кассы в админке

Заходим в раздел Магазин → Настройки → Онлайн-кассы. Нажимаем «Добавить кассу» и в поле «Обработчик» выбираем Orange Data. Появляется форма с настройками, специфичными именно для этого оператора.

Обязательно задайте:

• Название — понятное для администраторов (например, «Orange Data — боевая»);
• Активность — «Да», иначе касса не будет получать задания на чеки;
• Число одновременно обрабатываемых чеков — оставьте значение по умолчанию, если нет большого потока заказов.

Обмен с оператором в Битрикс идёт через агент на cron (очередь чеков), поэтому убедитесь, что на сайте настроено регулярное выполнение агентов и хитов — иначе чеки будут копиться в статусе ожидания.

Ключевые поля обработчика

Настройки Orange Data делятся на реквизиты доступа и параметры чека по умолчанию. Ниже — назначение основных полей.

Тестовый и боевой адреса API Битрикс подставляет автоматически при переключении флага «Тестовый режим», поэтому вручную URL прописывать не нужно. Важно лишь не перепутать окружения: тестовые ключи не работают на боевом контуре, и наоборот.

Налоги, признаки расчёта и платёжные системы

Чтобы чек прошёл фискализацию, состав заказа должен корректно преобразоваться в позиции чека. За это отвечают несколько сопоставлений.

• Ставка НДС. В настройках кассы задаётся ставка по умолчанию, но приоритетнее — ставка НДС, указанная у товара и в свойствах торгового предложения. Если у части каталога НДС не проставлен, чек уйдёт с неверной ставкой.
• Признак предмета расчёта. Товар, услуга, платёж — задаётся в настройках кассы и может уточняться по типам позиций. Для доставки обычно выбирают «услуга».
• Признак способа расчёта. Полный расчёт, предоплата, аванс — зависит от вашей схемы оплаты.

Отдельно свяжите кассу с платёжными системами: в настройках Orange Data выбирается, для каких Магазин → Платёжные системы она формирует чеки. Если этого не сделать, оплата пройдёт, а фискального чека не будет.

Проверка первого чека

Перед выводом в бой прогоните полный цикл в тестовом режиме. Оформите заказ, оплатите его тестовым способом и проследите путь чека.

1. Откройте заказ и вкладку с чеками, либо раздел Магазин → Онлайн-кассы → Чеки.
2. Убедитесь, что чек создан и перешёл из статуса ожидания в «Напечатан» (получен фискальный признак).
3. Проверьте состав: наименования, количество, суммы, ставку НДС, признаки предмета и способа расчёта.

Если чек «завис» в очереди, первым делом проверьте выполнение агентов и наличие ошибок в журнале. После успешного теста переключите кассу на боевые ключи и снимите флаг «Тестовый режим».

Типичные ошибки при подключении

Большинство проблем с Orange Data — не в логике Битрикс, а в реквизитах доступа и окружении сервера.

• Ошибка авторизации / 401. Открытый ключ не загружен в кабинет оператора, либо в Битрикс вставлен ключ от другого окружения.
• Сбой TLS-рукопожатия. Не приложен клиентский сертификат или на хостинге закрыт исходящий доступ к порту API оператора.
• Чеки не уходят вообще. Не работают агенты и cron, либо касса не привязана к платёжной системе.
• Неверный НДС в чеке. У товаров не заданы ставки, применяется значение по умолчанию.

Итог

Подключение Orange Data к 1С-Битрикс сводится к трём шагам: подготовить ключи и сертификат в личном кабинете оператора, создать кассу с обработчиком Orange Data в разделе «Онлайн-кассы» и аккуратно сопоставить налоги, признаки расчёта и платёжные системы. Отдельного внимания требуют mTLS-авторизация и стабильная работа агентов — именно на них спотыкается большинство внедрений.

Если каталог сложный, систем налогообложения несколько или нужна нестандартная логика чеков, настройку лучше делать под контролем интегратора. Мы подключаем облачные кассы, проверяем корректность фискализации на реальных сценариях и берём магазин на сопровождение, чтобы чеки уходили без сбоев.