Контроль касс
Доступен · от 2 990 ₽/месМодуль связывает видеопоток с кассовым ПО в реальном времени: наложение чека на видео, детекция подозрительных действий кассира, архив транзакций с привязкой к видеозаписи, автоматические алерты.
Содержание
- 1. Обзор модуля
- 2. Что потребуется
- 3. Пошаговое подключение
- 4. Подключение АТОЛ
- 5. Подключение Штрих-М
- 6. Подключение Эвотор
- 7. Подключение Дримкас
- 8. Подключение 1С:Касса
- 9. Универсальный REST API
- 10. Настройка камеры над кассой
- 11. Система аномалий и алертов
- 12. Отчёты и уведомления
- 13. Справочник API
- 14. FAQ
1. Обзор модуля
«Контроль касс» получает данные с кассового терминала (POS) и синхронизирует их с видеопотоком камеры, направленной на кассу. Это позволяет:
- Видеть на видео: какой товар сканируется, сумма чека, способ оплаты
- Автоматически обнаруживать: товар на ленте без сканирования, подозрительные скидки, возвраты без товара
- Архивировать: каждый чек привязывается к видеофрагменту — можно открыть запись за любую транзакцию
- Получать алерты: в Telegram, по email или через webhook при критических событиях
Схема работы: Касса (POS) → ObjectAI (получает события) → Наложение на видео → Анализ аномалий → Алерты + Архив
2. Что потребуется
Оборудование
- • IP-камера с обзором кассовой зоны (разрешение от 1080p)
- • Кассовый терминал с одной из поддерживаемых POS-систем
- • Локальная сеть (камера и касса должны быть в одной сети с сервером ObjectAI)
Программное обеспечение
- • Подписка ObjectAI (тариф Starter и выше или модуль «Контроль касс»)
- • Драйвер кассы с HTTP API (АТОЛ Driver, Штрих-М Web Server) — для локальных касс
- • API-ключ — для облачных POS (Эвотор, Дримкас)
Поддерживаемые POS-системы
| Система | Тип | Подключение | Порт по умолчанию |
|---|---|---|---|
| АТОЛ | Локальный | HTTP API (ATOL Driver) | 16732 |
| Штрих-М | Локальный | HTTP API (Web Server) | 5555 |
| Эвотор | Облачный | REST API + Webhooks | — |
| Дримкас | Облачный | REST API + Webhooks | — |
| 1С:Касса | Локальный | HTTP/OData | 8080 |
| Другая система | Любой | REST API (ваш скрипт) | — |
3. Пошаговое подключение (общий алгоритм)
Войдите в личный кабинет ObjectAI
Перейдите на objectai.ru/app/login и авторизуйтесь. Если аккаунта нет — зарегистрируйтесь (14 дней бесплатно).
Перейдите в раздел «Контроль касс»
В боковом меню нажмите «Контроль касс». Откроется панель управления кассами.
Нажмите «Добавить кассу»
Откроется форма подключения. Заполните поля:
- • Тип POS — выберите вашу кассовую систему
- • IP-адрес — адрес компьютера с кассовым ПО (для локальных систем)
- • Порт — подставится автоматически, при необходимости измените
- • API-ключ — для облачных систем (Эвотор, Дримкас, 1С)
- • ID терминала — уникальное имя кассы (например: «Касса 1»)
- • Камера — RTSP URL камеры над этой кассой
Нажмите «Подключить кассу»
ObjectAI автоматически подключится к POS-системе и начнёт получать данные. Статус подключения отобразится в списке касс.
Настройте зону кассы на видео (опционально)
В настройках камеры задайте прямоугольную зону, где находится кассовая лента. Это позволит обнаруживать товары, которые не были отсканированы.
Готово! Мониторинг запущен
Данные с кассы наложатся на видео, система начнёт анализировать операции и генерировать алерты при аномалиях.
4. Подключение АТОЛ
Предварительная настройка ATOL Driver
- 1. Установите ATOL Driver или ATOL Online на компьютер с кассой. Скачать: integration.atol.ru
- 2. Запустите службу ATOL Driver. Убедитесь, что HTTP API включён:
Настройки ATOL Driver → Сервер → HTTP → Включить
Порт: 16732 (по умолчанию) - 3. Проверьте доступность. В браузере или через curl:
curl http://IP_КАССЫ:16732/api/v2/deviceInfo
Должен вернуть JSON с информацией о ККТ (модель, серийный номер).
- 4. Если компьютер с кассой и ObjectAI на разных машинах — убедитесь, что порт 16732 открыт в файрволе.
Настройка в ObjectAI
- • Тип POS: АТОЛ
- • IP-адрес: IP компьютера с кассой (например, 192.168.1.50). Если касса на том же ПК — 127.0.0.1
- • Порт: 16732
- • API-ключ: не требуется
- • Интервал опроса: 1 сек (рекомендуется)
ObjectAI будет опрашивать ATOL Driver каждую секунду и получать новые операции (чеки, возвраты, отмены).
5. Подключение Штрих-М
Предварительная настройка
- 1. Установите Штрих-М: Драйвер ККТ и включите Web Server (HTTP-сервис).
- 2. В настройках драйвера:
Сервис → Web-сервер → Запустить
Порт: 5555 - 3. Проверка:
curl http://IP_КАССЫ:5555/Status
Настройка в ObjectAI
- • Тип POS: Штрих-М
- • IP-адрес: IP компьютера с кассой
- • Порт: 5555
- • API-ключ: не требуется
6. Подключение Эвотор
Получение API-ключа
- 1. Войдите в Личный кабинет Эвотор: lk.evotor.ru
- 2. Перейдите: Настройки → Интеграции → API
- 3. Создайте новый токен (или скопируйте существующий). Это будет ваш API-ключ.
- 4. Опционально: для Webhook-уведомлений зарегистрируйте URL:
https://ВАШ_ДОМЕН/api/v1/pos/webhook/evotor
Это позволит получать события мгновенно, без задержки опроса.
Настройка в ObjectAI
- • Тип POS: Эвотор
- • IP-адрес / Порт: не требуется (облачное подключение)
- • API-ключ: вставьте токен из ЛК Эвотор
- • Интервал опроса: 2-5 сек (облачный API имеет лимиты)
ObjectAI автоматически определит магазин и начнёт получать данные о чеках.
7. Подключение Дримкас
Получение API-ключа
- 1. Войдите в Кабинет Дримкас: kabinet.dreamkas.ru
- 2. Перейдите: Настройки → API → Токены
- 3. Создайте Bearer-токен для ObjectAI
- 4. Для Webhook:
https://ВАШ_ДОМЕН/api/v1/pos/webhook/dreamkas
Настройка в ObjectAI
- • Тип POS: Дримкас
- • API-ключ: Bearer-токен из кабинета
- • Интервал опроса: 2-5 сек
8. Подключение 1С:Касса
Предварительная настройка
- 1. В 1С настройте публикацию HTTP-сервиса или OData:
Администрирование → Публикация на веб-сервере → HTTP-сервисы
Адрес: http://IP_1C_СЕРВЕРА:8080/hs/pos/ - 2. Создайте пользователя для ObjectAI с правами на чтение чеков
- 3. Проверьте:
curl -u login:password http://IP:8080/hs/pos/ping
Настройка в ObjectAI
- • Тип POS: 1С:Касса
- • IP-адрес: IP сервера 1С
- • Порт: 8080 (или ваш)
- • API-ключ:
логин:пароль(через двоеточие)
9. Универсальный REST API
Если ваша касса не в списке поддерживаемых — используйте универсальный REST API. Вам нужно написать простой скрипт, который будет отправлять события на ObjectAI при каждой операции.
Формат событий
Все события отправляются POST-запросом на:
Начало чека:
Товар отсканирован:
Ручная скидка:
Оплата:
Конец чека:
Возврат:
Открытие денежного ящика:
Пример скрипта (Python)
import requests
OBJECTAI_URL = "http://192.168.1.100:8010"
SESSION_ID = "a93f5b50" # ID кассы в ObjectAI
def send_event(event):
r = requests.post(
f"{OBJECTAI_URL}/sessions/{SESSION_ID}/cash/event",
json=event
)
return r.json()
# Пример: новый чек
send_event({"type": "receipt_start"})
send_event({"type": "item_scanned", "barcode": "460001", "name": "Молоко", "price": 89.90})
send_event({"type": "payment", "method": "card", "amount": 89.90})
send_event({"type": "receipt_end", "total": 89.90, "items_count": 1})
10. Настройка камеры над кассой
Рекомендации по установке
- • Камера должна видеть: кассовую ленту, руки кассира, денежный ящик
- • Разрешение: от 1920x1080 (Full HD)
- • Угол: сверху-сбоку, ~45 градусов
- • Освещение: без бликов на экране кассы
- • FPS: 15-25 кадров/сек достаточно
Типичные RTSP URL
rtsp://admin:pass@IP:554/Streaming/Channels/101
rtsp://admin:pass@IP:554/cam/realmonitor?channel=1&subtype=0
rtsp://admin:pass@IP/axis-media/media.amp
rtsp://admin:pass@IP:554/unicast/c1/s0/live
11. Система аномалий и алертов
ObjectAI автоматически анализирует действия на кассе и генерирует алерты трёх уровней:
| Аномалия | Уровень | Описание |
|---|---|---|
| Товар без сканирования | Warning | В зоне кассы обнаружен товар, но ни один штрихкод не был отсканирован |
| Ящик без продажи | Warning | Денежный ящик открыт без активной транзакции более 5 секунд |
| Чрезмерная скидка | Critical | Ручная скидка превышает установленный лимит (по умолчанию 15%) |
| Много отмен | Critical | Превышено количество отмен за смену (по умолчанию 10) |
| Крупный возврат | Critical | Сумма возврата превышает порог (по умолчанию 5 000 ₽) |
| Быстрое сканирование | Info | Товары сканируются подозрительно быстро (менее 300 мс между позициями) |
| Расхождение веса | Warning | Вес товара на весах отличается от указанного в чеке более чем на 10% |
| Простой кассы | Info | Касса не производит операций более 10 минут |
12. Отчёты и уведомления
Отчёты
- • Ежедневный — чеки, выручка, возвраты, алерты за день
- • Еженедельный — динамика по дням, топ аномалий
- • Месячный — сводка, тренды, сравнение кассиров
- • По смене — итог за смену кассира
Каналы уведомлений
- • Telegram — мгновенные алерты в чат или группу
- • Email — отчёты и критические алерты
- • Webhook — для интеграции с вашими системами
- • Личный кабинет — все данные в реальном времени
13. Справочник API
14. FAQ — Часто задаваемые вопросы
Сколько касс можно подключить?
Нужна ли специальная камера?
Моя касса не в списке поддерживаемых. Что делать?
Как быстро ObjectAI обнаруживает аномалию?
Данные с кассы хранятся на вашем сервере?
Можно ли использовать без камеры?
Как настроить пороги аномалий?
ObjectAI работает с весовым товаром?
Касса за NAT / VPN. Как подключить?
Сколько стоит модуль?
Как проверить что POS подключен правильно?
Можно ли смотреть видео за конкретный чек?
Работает ли модуль в локальной версии ObjectAI?
Как подключить несколько касс к одному ObjectAI?
Поддерживается ли работа с ОФД?
Готовы подключить кассу?
Попробуйте бесплатно 14 дней. Подключение занимает 5-10 минут.