Інтеграція логістичних сервісів Европошти в мобільний додаток
Европошта — білоруський приватний логістичний оператор, що спеціалізується на міжнародних відправленнях та 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 тижні.