Last mile · Казахстан
Fast Delivery — курьерская платформа для магазинов Kaspi
Логистическая платформа для магазинов Kaspi.kz: импорт заказов, диспетчеризация курьеров, маршруты, термоэтикетки, возвраты и публичное отслеживание.
На момент описания кейса
110 000+
- заказов в системе
- 110 000+
- магазинов
- ≈90
- рабочих места
- 4
- языка интерфейса
- 2
Один продукт · четыре роли
Логистика в четырёх интерфейсах
У каждого участника свой темп и свои данные, но заказ остаётся единым объектом от выгрузки из Kaspi до подтверждения вручения.
- 01
Map control
Диспетчер
Город как рабочая карта
Курьеры в реальном времени, назначение заказов по зонам, «Актуальные / Архив» и операционная аналитика.
- 02
Order desk
Магазин
От выгрузки до этикетки
Новые заказы из Kaspi, статусы, возвраты и печать термоэтикеток с данными конкретной позиции.
- 03
Courier flow
Курьер
Маршрут на день в кармане
Последовательность точек, QR-приёмка, код выдачи и подтверждение факта доставки.
- 04
Public tracking
Получатель
Статус без регистрации
Публичная страница отслеживания открывается по номеру заказа и показывает актуальное состояние доставки.
Маршрут заказа
Цифровой поток заканчивается физической передачей
- 01
Kaspi Shop API
- 02
Кабинет магазина
- 03
Позиции и этикетка
- 04
Зона и курьер
- 05
QR-приёмка
- 06
Код выдачи
- 07
Подтверждение
- 08
Публичный статус
Полевые заметки интеграции
Kaspi Shop API пришлось изучать на живом кабинете
Поведение API влияло на архитектуру сильнее документации. Четыре наблюдения стали отдельными правилами системы.
Один phoneAlias у сотен заказов
Поле оказалось общей прокси-линией Kaspi с добавочным номером после запятой, а не прямым телефоном покупателя.
Артикул живёт отдельно
Он приходит из ручки позиций и подгружается лениво — именно перед печатью этикетки.
История ограничена
Kaspi API возвращает только последние 14 дней истории; более ранние заказы через него недоступны.
Ошибка не объясняет причину
Неверный X-Merchant-Uid возвращает тот же 401, что и протухший токен: по одному коду причину не различить.
География + физический контур
Карта, зоны и этикетка — части одной модели заказа
PostGIS хранит пространственные правила, Leaflet показывает диспетчеру живую картину, а PDF, штрихкоды и QR связывают цифровой заказ с реальной посылкой.
- PostGIS
- зоны назначения и пространственные данные
- Leaflet
- карта курьеров и заказов
- PDF + barcodes
- термопечать на складе магазина
- Telegram alerts
- технические сигналы для команды
Стек продукта
Backend, web-интерфейсы и печать работают как один контур
Backend & operations
- NestJS
- TypeScript
- PostgreSQL
- PostGIS
- TypeORM
- Redis
- BullMQ
- pdfkit
- bwip-js
- qrcode
- Telegram Bot API
Interfaces & map
- Next.js 15
- App Router
- TanStack Query
- next-intl
- Leaflet
- Tailwind CSS
- Radix UI
Нужно связать онлайн-заказ с офлайн-операцией?