Интеграции с внешними системами
Обзор
| Система | Клиент | Назначение | URL (dev) |
|---|---|---|---|
| ERP | ErpClient | Синхронизация данных с учётной системой | http://mx-dev-app01.mixit.local |
| ApiShip | ApiShipClient | Интеграция с курьерскими службами | https://api.dev.apiship.ru |
| Сервис серийных номеров | SerialNumberServiceClient | Генерация и резервирование серийных номеров | http://localhost:30140 |
| AWS S3 | Spring Cloud AWS | Хранение файлов (отчёты, этикетки, фото) | Через AWS SDK |
| Telegram | Telegram Bots API | Уведомления о событиях | Telegram Bot API |
ERP-интеграция (ErpClient)
HTTP-клиент для синхронизации данных с ERP-системой.
Конфигурация:
wms.erp.url=http://mx-dev-app01.mixit.local
ApiShip (ApiShipClient)
Интеграция с агрегатором курьерских служб для расчёта доставки и отслеживания отправлений.
Конфигурация:
wms.apiship.url=https://api.dev.apiship.ru
Сервис серийных номеров (SerialNumberServiceClient)
Отдельный микросервис для генерации и резервирования серийных номеров (маркировка, Честный Знак).
Конфигурация:
wms.serial-number-service.url=http://localhost:30140
Планировщик: автоматическое пополнение пула серийных номеров (интервал 5 минут).
AWS S3
Хранение файлов через Spring Cloud AWS 3.4.0:
- Фотографии товаров при приёмке
- Сгенерированные отчёты (PDF)
- Этикетки
- Прикреплённые файлы к документам
Telegram-уведомления
Telegram Bots API 6.9.7.1 используется для оперативных уведомлений:
- Удаление незавершённых документов перемещения (
MovementScheduleManager) - Системные оповещения
Печать
JasperReports 7.0.1
- PDF-отчёты (складские отчёты, акты, накладные)
- Шаблоны
.jrxmlв ресурсах
ZPL-этикетки
- Формат ZPL для термопринтеров (Zebra и аналоги)
- Этикетки товаров, мест хранения, грузовых мест
- Barcode4J для генерации штрихкодов
Apache POI 5.4.1
- Excel-файлы (выгрузки, шаблоны импорта)
Планировщики (Schedulers)
| Задача | Интервал | Описание |
|---|---|---|
| Аллокация заказов | 5 мин | Автоматическое распределение заказов |
| Формирование батчей | 5 мин | Создание батчей из заказов |
| Автоподпитка | 1 час | Автоматическое создание документов подпитки |
| Очистка перемещений | 1 час | Удаление незавершённых перемещений |
| Пул серийных номеров | 5 мин | Пополнение пула серийных номеров |
| Очистка состояний | 1 час | Сброс устаревших state machine состояний |
| Исторические снимки | Ежедневно | Создание снимков StorageRegistry на следующий месяц |