Телеграм-бот для выгрузки отчётов по кассе Эвотор

Описание

Клиент — владелец торговой точки, использующей кассу Эвотор. Он столкнулся с проблемой: ежедневно получать отчёты по продажам и остаткам было неудобно. Приходилось заходить в личный кабинет, вручную копировать данные, тратить время на оформление таблиц, либо перепоручать это персоналу, что влекло за собой ошибки или утечку данных.

Клиент хотел:
• полностью автоматизировать процесс получения отчётов.
• исключить необходимость вручную заходить в ЛК Эвотора.
• иметь возможность получать текущую выручку и статистику одним кликом с телефона.
• хранить данные в Google Sheets для последующего анализа и интеграции с другими таблицами и финансовым учетом.

Решение

Задача заключалась в автоматизации сбора данных с кассы Эвотор, их выгрузке в Google Sheets и управлении этим процессом через Telegram. Учитывая это, проект был разделён на три логических модуля, каждый из которых решал отдельную часть задачи:
1. Модуль сбора данных с API Эвотор
Реализован Python-скрипт, регулярно подключающийся к API Эвотора. Для получения нужной информации были использованы следующие эндпоинты:
Скрипт обрабатывает JSON-ответы от API, форматирует их в плоскую табличную структуру и готовит к экспорту.
2. Интеграция с Google Sheets
Для отправки данных в Google Sheets используется официальное API Google. Программа:
• создаёт при первом запуске таблицу с необходимыми листами (если их нет)
• очищает и перезаписывает данные при каждой выгрузке
• работает с API через сервисный аккаунт, авторизация осуществляется через credentials.json
3. Telegram-бот
Управляющий интерфейс реализован в виде Telegram-бота:
• подключён к основному скрипту через общий обработчик команд
• хранит настройки пользователя (расписание выгрузок) в JSON-файле
• отправляет краткие отчёты в чат по запросу
• так же, по запросу, меняет время плановой выгрузки в Google Sheets
Для безопасности реализована проверка ID пользователя — команды принимает только владелец.

Результат

Клиент получил полностью автономное и безопасное решение, которое:
• Работает в фоне без участия человека
• Отправляет статистику и выручку в Telegram каждый день
• Позволяет запустить ручную выгрузку или изменить расписание в любой момент
• Хранит полную историю отчётов в Google Sheets, что упрощает аналитику и учёт
Решение уже внедрено в действующую точку продаж.
Преимущества на практике:
• Экономия ~30 минут в день на ручной сбор данных
• Снижение риска ошибок и потери информации
• Увеличенная прозрачность для владельца: бизнес "на ладони"
• Возможность масштабирования на другие точки и упрощения аудита
В дальнейшем клиент планирует установить бота на ноутбуки других торговых точек и объединить данные в одну сводную таблицу по сети.

Ссылки на примеры реализации

 github.com/jo-safe/EvotorBot

Презентация проекта