Интеграция логистических сервисов Европочты в мобильное приложение
Европочта — белорусский частный логистический оператор, специализирующийся на международных отправлениях и e-commerce доставке. Предоставляет API для расчёта стоимости, создания отправлений, трекинга и работы с сетью пунктов выдачи.
API Европочты: доступные методы
Для работы с API Европочты необходима регистрация на портале разработчиков и получение API-ключа. Основные группы методов:
Калькулятор доставки: расчёт стоимости по весу, габаритам, типу отправления и направлению. Важно передавать параметры точно: Европочта различает «трекинговое отправление» и «отправление без трека» с разными тарифами.
Создание накладной: электронный документ для отправки. API возвращает номер отправления и PDF накладной для печати.
Трекинг: получение истории движения отправления по его номеру.
ПВЗ (пункты выдачи заказов): список пунктов с координатами, режимом работы и доступными услугами.
Интеграция трекинга
Запросы к API Европочты авторизуются через API-ключ в заголовке X-Api-Key. Ответы — JSON. Список статусов фиксированный, маппим их на понятные пользователю строки на стороне приложения.
Особенность: Европочта активно работает с отправлениями из Китая (AliExpress, Wildberries). При трекинге таких посылок часть истории движения приходит от партнёрских трекинг-систем (например, Cainiao) — API возвращает агрегированный статус. Не все промежуточные события отображаются, и это нормально.
Выбор ПВЗ на карте
Карта ПВЗ — стандартная функция для e-commerce приложений. Список точек получаем через API, кэшируем локально с TTL 24 часа. На iOS рендерим через MapKit, на Android — через Google Maps SDK.
Фильтр по режиму работы реализуем на клиенте: парсим расписание из строки вида "Пн-Пт: 9:00-20:00, Сб: 10:00-18:00" и сравниваем с текущим временем с учётом часового пояса пункта. Это нетривиально если сеть ПВЗ работает в разных городах с разными часовыми поясами.
Уведомления о статусе
Push-уведомления при изменении статуса — обязательная функция для логистических приложений. Схема: фоновая задача (WorkManager / BGAppRefreshTask) периодически проверяет статус активных отправлений, при изменении показывает локальный пуш.
Альтернатива: вебхуки от Европочты (если поддерживаются) — сервер получает событие и отправляет FCM/APNs пуш клиенту. Это надёжнее и экономит батарею.
Сроки: базовая интеграция трекинга и ПВЗ — 5-8 дней. Полный цикл с созданием отправлений и печатью накладных — 2-3 недели.