Интеграция онлайн-кассы Атол с Битрикс24: облачное решение на .NET

В современном бизнесе интеграция фискальных регистраторов с CRM-системами перестала быть опцией — это необходимость для эффективного ведения дел. Однако существующие решения часто требуют дорогостоящего оборудования или привязывают к конкретным платформам. Мы решили эту проблему, разработав 1ОС.Касса — облачную кассу, которая объединяет преимущества онлайн и оффлайн касс.

Концепция решения

Идея проста: вы покупаете обычный фискальный регистратор Атол (например, модели 30Ф или 35Ф), подключаете его к компьютеру под управлением Windows, Linux или MacOS, размещаете в офисе и устанавливаете наше ПО — ККМ-коннектор. Это программа для приёма команд на печать чеков из интернета.

В качестве центральной системы используется Битрикс24, который выполняет роль:

• Настройки кассы — централизованное управление всеми параметрами

• Интеграции — подключение к различным бизнес-сценариям

• Надёжного транспорта — гарантированная доставка команд на кассу

• Хранилища чеков — все напечатанные документы сохраняются в системе

Поддерживаемые сценарии

1. Онлайн-продажи — автоматическая печать чека при оплате через сайт

2. Оффлайн-продажи — полноценное рабочее место кассира

3. Автоматизация — настройка правил печати в Битрикс24 (например, при успешном завершении сделки)

4. Управление кассами — мониторинг и контроль всех подключённых устройств

И самое приятное: для базовых сценариев достаточно минимального тарифа Битрикс24. Это делает систему доступной даже для малого бизнеса.

Архитектура системы

Классическая трёхкомпонентная схема

Изначально система состоит из трёх узлов:

┌─────────────────┐      ┌──────────────────┐      ┌──────────────┐
│  Веб-приложение │ ───► │ Сервис очередей  │ ───► │ ККМ-коннектор│
│   (Битрикс24)   │      │   (Message Bus)  │      │  + Касса Атол│
└─────────────────┘      └──────────────────┘      └──────────────┘

1. Веб-приложение — интерфейс для взаимодействия пользователя с системой

2. Сервис очередей — обеспечивает гарантированную доставку сообщений между компонентами

3. ККМ-коннектор — программа, которая общается с кассой через драйверы Атол

Упрощённая двухкомпонентная схема

Битрикс24 имеет встроенный модуль Push&Pull, который реализует механизм моментальной доставки событий. Благодаря этому ККМ-коннектор может подключаться напрямую к Битрикс24, минуя промежуточный сервис очередей:

┌─────────────────┐                    ┌──────────────┐
│  Битрикс24      │                    │ ККМ-коннектор│
│  + Push&Pull    │ ◄────────────────► │  + Касса Атол│
└─────────────────┘      WebSocket     └──────────────┘

Это упрощает архитектуру и повышает надёжность системы — меньше компонентов, меньше точек отказа.

Технологический стек

Выбор платформы: .NET

Для ККМ-коннектора требовалась кроссплатформенность — возможность запуска на Windows, Linux и MacOS. Писать три отдельных приложения нерационально, поэтому мы выбрали мультиплатформенную технологию.

Почему .NET?

✅ Широко известная и популярная платформа

✅ Официальная поддержка драйверами Атол

✅ Отсутствие проблем совместимости

✅ Современный .NET (Core/5+) — истинная кроссплатформенность

✅ Высокая производительность и низкое потребление ресурсов

Распространение и обновления

Чтобы обеспечить актуальность ПО для всех клиентов, мы опубликовали ККМ-коннектор в официальных магазинах приложений:

• Windows Store — для пользователей Windows 10/11

• Snap Store — для дистрибутивов Linux

• App Store — для MacOS

Это гарантирует:

• Автоматическую установку обновлений

• Всегда актуальную версию софта

• Безопасность (проверка приложений магазинами)

• Простоту установки для конечных пользователей

Linux-версия: встраиваемое решение на Ubuntu Core

Особого внимания заслуживает версия для Linux. Мы используем Ubuntu Core — специальную редакцию Ubuntu, адаптированную для работы в необслуживаемом режиме на встраиваемых аппаратных платформах.

Почему Ubuntu Core?

Ubuntu Core разработана для IoT-устройств и промышленных сценариев. Основные преимущества:

• Транзакционные обновления — система обновляется атомарно, с возможностью отката

• Надёжность — минимальный набор компонентов, только необходимое ПО

• Безопасность — все приложения изолированы (snap-пакеты)

• Необслуживаемая работа — система может работать годами без вмешательства человека

• Решение на Raspberry Pi

В сочетании с Raspberry Pi получается просто бомба!

Raspberry Pi + Ubuntu Core + ККМ-коннектор + Атол 30Ф = Облачная касса

Преимущества:

💰 Недорого — Raspberry Pi 4 стоит около 5000₽

🔧 Компактно — размер с банковскую карту

⚡ Надёжно — нет движущихся частей, SSD на карте памяти

🔄 Самообновляемо — Ubuntu Core и snap автоматически обновляют всё ПО

🌡️ Промышленное применение — работает в широком диапазоне температур

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

Мобильное решение: чат-бот в мессенджере MAX

Наличие API открывает новые возможности. Что если нужно обеспечить кассами разъездных сотрудников — мастеров, курьеров, выездных специалистов?

В последнем релизе мы добавили чат-бота для мессенджера MAX (встроенный мессенджер Битрикс24).

Как это работает:

1. Мастер находится у клиента на выезде

2. Через чат-бота в MAX формирует чек (указывает товары, суммы)

3. Команда отправляется на стационарную кассу в офисе

4. Чек печатается

5. QR-код приходит обратно мастеру в чат

6. Мастер показывает QR-код клиенту для сканирования

  Мастер             MAX-бот            Офисная касса
    │                  │                      │
    │──формирует чек──>│                      │
    │                  │──команда печати─────>│
    │                  │                      │──печать
    │                  │<─────QR-код──────────│
    │<────QR в чат─────│                      │
    │                  │                      │

Получается удобно: мастеру не нужно носить с собой кассу, клиент получает легальный чек, бухгалтерия довольна.

Технические детали реализации

Протокол взаимодействия

Для связи между компонентами используется:

• WebSocket (через Push&Pull) — для real-time команд

• REST API — для управления настройками и получения истории

• Драйвер Атол — для низкоуровневой работы с ККМ

Гарантированная доставка

Push&Pull в Битрикс24 обеспечивает:

• Подтверждение доставки сообщений

• Очередь команд при недоступности кассы

• Повторные попытки отправки

• Логирование всех операций

Безопасность

• Все соединения используют HTTPS/WSS

• Аутентификация через токены Битрикс24

• Права доступа настраиваются в CRM

• Snap-изоляция приложений в Linux

Результаты и выводы

Мы создали систему, которая:

✅ Превращает обычную кассу Атол в облачную

✅ Интегрируется с CRM без лишних посредников

✅ Работает на всех популярных платформах

✅ Поддерживает как стационарные, так и мобильные сценарии

✅ Автоматически обновляется

✅ Требует минимального тарифа Битрикс24

1ОС.Касса — это пример того, как современные технологии (.NET, Ubuntu Core, snap-пакеты, мессенджеры) могут решить реальную бизнес-задачу элегантно и недорого.

Планы развития

• Поддержка других производителей ККМ (Штрих-М, Эвотор)

• Расширенная аналитика продаж

• Интеграция с маркетплейсами

• Мобильное приложение для iOS/Android

---

Полезные ссылки:

• Битрикс24 API - https://dev.1c-bitrix.ru/rest_help/ ^[1]

• Драйверы Атол - https://integration.atol.ru/ ^[2]

• Ubuntu Core Documentation - https://ubuntu.com/core/docs ^[3]

• .NET Cross-platform - https://dotnet.microsoft.com/ ^[4]

---

Если у вас есть вопросы по архитектуре или внедрению — задавайте в комментариях!