🚛
ВЭД, AI, Автоматизация, Enterprise

AI-декларации — 5 минут, 3 канала связи, любой язык документов

Таможенный брокер

AI-автоматизация деклараций: документы в WhatsApp/Telegram → готовый ALTA XML за 5 минут. Gemini читает CMR на любом языке. Смотреть кейс →

🟠 Большой🚀 В работе🟠 Документы/Финансы🧠 AI6 месяцев
FastAPIPostgreSQLGemini 2.5 FlashWhatsAppTelegramALTA XML

О проекте

Таможенный брокер тонул в бумажной работе: клиенты присылают документы в WhatsApp, Telegram и на почту. На каждую партию — часы ручного ввода данных в систему ALTA. Теперь AI извлекает всё из документов автоматически, формирует XML и загружает в таможенную систему. Брокер только проверяет и подтверждает.

165K+
строк кода
Gemini
2.5 Flash
3
канала связи
ALTA
XML

Функциональность

🤖

Gemini 2.5 Flash AI

Извлечение данных из CMR, инвойсов, упаковочных листов любого формата и языка.

💬

WhatsApp Business

Полноценная интеграция: приём документов, отправка статусов, диалоги с клиентами.

📱

Telegram Bot

Альтернативный канал связи с теми же возможностями.

📧

Email интеграция

Автоматическая обработка входящих писем с документами.

📄

ALTA XML генерация

Автоматическое формирование деклараций в формате российской таможенной системы.

🔄

Синхронизация статусов

Мониторинг деклараций: подача, проверка, выпуск, уведомления клиентов.

Ключевые процессы

Пользовательские сценарии и потоки данных

Обработка партии

Полный цикл от получения документов до готовой декларации.

Приём документов
AI-извлечение
Валидация
Генерация XML
Проверка
Загрузка в ALTA

Мониторинг статуса

Отслеживание декларации от подачи до выпуска.

Подана
На проверке
Запрос документов
Выпущена
Уведомление клиента

Коммуникация с клиентом

Взаимодействие через любой канал связи.

Приём сообщения
Распознавание канала
Обработка документов
Статус клиенту
Запрос уточнений

Роли и интерфейсы

👤

Декларант

Проверка извлечённых данных, корректировка XML, загрузка в таможенную систему

👤

Клиент

Отправка документов через WhatsApp/Telegram/Email, получение статусов

👤

Менеджер

Мониторинг очереди партий, контроль сроков, работа с проблемными декларациями

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

Backend (Bot)

  • Python 3.12
  • FastAPI
  • SQLAlchemy 2.0
  • Celery
  • APScheduler

Backend (Sync)

  • Python 3.12
  • FastAPI
  • Alembic
  • PostgreSQL

AI

  • Google Gemini 2.5 Flash
  • Document AI
  • PDF/Image processing

Коммуникации

  • WhatsApp Business API
  • Telegram Bot API
  • SMTP/IMAP

Инфраструктура

  • Docker Compose
  • Redis
  • PostgreSQL
  • Nginx

Объём кода

165,733
строк кода
148,660
Python (оба сервера)
14,238
JavaScript/TypeScript
2,835
XML шаблоны
🔐

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

  • Мультиканальность: WhatsApp Business, Telegram, Email в одной системе
  • Gemini 2.5 Flash для мультиязычного OCR (русский, английский, китайский)
  • Строгая валидация XML по схеме ALTA перед загрузкой
  • Автоматические уведомления клиентам о статусе декларации
  • История всех коммуникаций с клиентом по каждой партии
🤖

AI-функции

  • Gemini 2.5 Flash для извлечения данных из документов
  • Мультиязычная обработка: русский, английский, китайский
  • Автоматическая классификация типов документов
  • Валидация извлечённых данных против справочников
  • Генерация XML-деклараций по шаблонам ALTA

⚠️Проблема

На каждую партию груза уходят часы: вручную перепечатывать данные из CMR, инвойсов, упаковочных листов.

Документы присылают как попало: фото, сканы, PDF — и на русском, и на английском, и на китайском.

Клиенты пишут кто в WhatsApp, кто в Telegram, кто на почту — нужно мониторить все каналы.

Формат ALTA очень строгий — малейшая ошибка в XML, и декларация не загрузится.

💡Решение

AI читает любые документы — CMR, инвойсы, упаковочные листы. Фото со смартфона, скан, PDF — без разницы.

Понимает все языки — Gemini 2.5 Flash одинаково хорошо читает русский, английский и китайский.

Один интерфейс для всех каналов — WhatsApp, Telegram, Email сливаются в единую систему обработки.

XML генерируется автоматически — в строгом формате ALTA, готовый к загрузке.

Отслеживание в реальном времени — клиент видит статус: принято, обрабатывается, выпущено.

Результаты

  • Декларация готова за минуты вместо часов ручной работы.
  • Документы на любом языке обрабатываются одинаково быстро.
  • Клиенты могут писать в любой мессенджер — всё попадёт в систему.
  • Ноль ошибок форматирования — XML всегда валидный для ALTA.

Вот представьте...

История одного запроса

📋
Утро декларанта

WhatsApp: 47 непрочитанных. Telegram: ещё 23. Почта: 15 писем с вложениями. Клиенты скинули документы — кто куда смог. А тебе из этого хаоса нужно сделать декларации. До 17:00. Иначе — штраф за простой.

😤
Китайская рулетка

Инвойс на китайском. CMR — криво отсканирован. Упаковочный лист — фото с телефона, половина в тени. И всё это нужно перевести, разобрать и вбить в ALTA. Вручную. Каждое поле. А формат строгий — одна ошибка, и декларация отклоняется.

Скинул — готово

Клиент написал в WhatsApp, приложил фотки документов. Через 5 минут: «Ваша декларация готова, проверьте.» Gemini прочитал китайский. Распознал фото. Сформировал XML. Тебе только глянуть и подтвердить.

🔮
Ушёл домой в 6

Те же 80 партий, что раньше занимали весь день до ночи. Теперь — до шести вечера. Клиенты видят статус в реальном времени. Ошибок форматирования — ноль. ALTA принимает с первого раза.

Глоссарий AI-терминов

Ключевые понятия для понимания проекта

GEO-оптимизация(GEO)

Оптимизация контента для AI-поисковиков (ChatGPT, Perplexity, Claude).

AI-агенты(AI-AGENTS)

Автономные AI-системы, выполняющие задачи самостоятельно без контроля человека.

E-E-A-T(EEAT)

Критерии Google: опыт, экспертиза, авторитетность, надёжность. Важны для SEO и GEO.

LLM (Large Language Model)(LLM)

Нейросеть для понимания и генерации текста (GPT-4, Claude, Gemini).

RAG (Retrieval-Augmented Generation)(RAG)

Технология для работы AI с вашими данными: документами, базами знаний.

Промпт (Prompt)(PROMPT)

Текстовая инструкция для AI. Качество промпта = качество результата.

MVP (Minimum Viable Product)(MVP)

Минимальная версия продукта для проверки гипотезы на пользователях.

Технологический стек(TECH-STACK)

Набор технологий проекта: языки, фреймворки, базы данных, облако.

Интеграция(INTEGRATION)

Связывание AI с системами компании: CRM, ERP, 1C, мессенджеры.

Развёртывание (Deployment)(DEPLOYMENT)

Запуск решения в production с мониторингом и масштабированием.

Частые вопросы

Какие типы документов система умеет распознавать?

CMR (международные накладные), инвойсы, упаковочные листы любых форматов: фото со смартфона, сканы, PDF. Gemini 2.5 Flash справляется даже с криво отсканированными документами.

На каких языках система понимает документы?

Русский, английский, китайский — основные языки международной торговли. Gemini 2.5 Flash обеспечивает качественное распознавание и извлечение данных на всех этих языках.

Как клиенты отправляют документы?

Через любой удобный канал: WhatsApp, Telegram или email. Все сообщения попадают в единую систему обработки, клиент получает уведомления о статусе декларации.

Что если AI неправильно распознал данные?

Декларант всегда проверяет извлечённые данные перед загрузкой в ALTA. Система подсвечивает поля с низкой уверенностью распознавания. Ошибки можно исправить в интерфейсе до генерации XML.

Нужен похожий проект?

Расскажите о вашей задаче — обсудим, как мы можем помочь. Рекомендации предоставляем по запросу.

Обсудить проект
Автор материала
Сергей Цветков
Основатель «ДИДЖИТАЛ-ПРО ТЕХ» (Digital-Pro Tech)
20 лет в IT и бизнесе. 150+ проектов по внедрению AI и BI. Практический опыт, а не теория.
Опубликовано: 5 июня 2025
Обновлено: 14 января 2026