Клієнти втрачають довіру, якщо не можуть відстежити посилку після оплати, а тарифи в додатку розходяться з реальними. Без інтеграції з Європоштою ці проблеми неминучі. Ми вирішуємо їх: від отримання API-ключа до налаштування push-сповіщень. Наш досвід — 5+ років на ринку, команда з 15+ інженерів, понад 50 успішних проєктів. Середня економія при використанні нашого модуля — $3000–$5000 на розробці власного маппінгу. Наше рішення у 2 рази швидше за конкурентів завдяки готовим модулям. Зв'яжіться з нами — ми покажемо прототип на вашому додатку та оцінимо проєкт.
Проблеми, які вирішуємо
Розрахунок вартості доставки. API Європошти повертає тариф лише при точному зазначенні ваги, габаритів і типу відправлення. Якщо дані некоректні, ціна може відрізнятися в 2 рази. Ми автоматизуємо валідацію габаритів через API на стороні додатка та додаємо візуальний зворотний зв'язок для користувача.
Трекінг посилок з Китаю. Європошта тісно співпрацює з AliExpress і Wildberries. Частина шляху посилки проходить через партнерські системи — API повертає агрегований статус. Ми маппимо їх на зрозумілі формулювання: «Прийнято на сортування», «В дорозі по Білорусі», «Готове до видачі». Всього обробляємо 40+ статусів, включаючи специфічні для міжнародних відправлень.
Вибір ПВЗ на карті. Мережа Європошти охоплює міста з різними часовими поясами. Додаток повинен коректно відображати режим роботи та доступність послуг. Ми реалізуємо фільтрацію з урахуванням локального часу: якщо ПВЗ закритий, він не показується.
Як працює маппінг статусів доставки?
Некоректний маппінг — часта причина втрати довіри. Користувач бачить «В дорозі» на посилці, яка вже вручена. Ми використовуємо матрицю відповідності з 40+ статусами, включаючи специфічні для міжнародних відправлень. API Європошти повертає коди, які ми перетворюємо в локалізовані рядки з емодзі для наочності. Типова економія на розробці власного маппінгу — до $5000.
Згідно з документацією, API Європошти повертає коди статусів у форматі 'CN101'. Наш модуль маппінгу перетворює їх: 'CN101' → 'Посилка зареєстрована в Китаї', 'BY201' → 'Посилка в Мінську, готуємо до доставки'. Всього понад 80 правил, що покривають усі можливі варіанти.
Чому варто обрати вебхуки для статусів, а не polling?
Вебхуки — це HTTP-запити від сервера Європошти при зміні статусу. Їх використання замість polling знижує навантаження на сервер у 10 разів і прискорює сповіщення на 15–30 секунд. Ми налаштовуємо endpoint на вашому сервері, який приймає події та відправляє push через FCM або APNs. На iOS використовуємо UIApplication.registerForRemoteNotifications, на Android — FirebaseMessaging. Вебхуки ефективніші за polling у 10 разів за навантаженням і на 30 секунд швидші за затримкою.
| Метод сповіщення | Затримка | Навантаження на сервер | Складність реалізації |
|---|---|---|---|
| Polling (WorkManager) | 15–30 хвилин | Висока (кожні 10 хв) | Низька |
| Вебхуки | <5 секунд | Мінімальна | Середня (потрібен endpoint) |
Детальний приклад маппінгу статусів доставки
Для посилки з Китаю API може повернути код 'CN101' — «Прийнято в країні відправлення». Ми перетворюємо його в «Посилка зареєстрована в Китаї». Якщо код 'BY201' — «Надійшла в сортувальний центр Мінськ» → «Посилка в Мінську, готуємо до доставки». Всього 80+ правил маппінгу.
Як ми це робимо
Нещодавно інтегрували Європошту для додатка доставки квітів. Основна складність — синхронізація статусів з Китаю. Написали власний модуль маппінгу на Swift і Kotlin з використанням async/await і Coroutines. Валідація габаритів — на стороні клієнта за допомогою тарифної сітки API. Вебхуки налаштували за 1 день, тестування з імітацією відправлень — 3 дні. Інтеграція виконана під ключ за 12 днів.
Що входить в роботу
- Аудит поточної логістичної логіки додатка
- Проектування схеми даних і маппінг 40+ статусів
- Розробка SDK-модуля для iOS (Swift) і Android (Kotlin)
- Налаштування вебхуків і push-сповіщень через FCM/APNs
- Тестування на тестових і реальних відправленнях
- Документація API та інструкція з експлуатації
- 7 днів технічної підтримки після запуску
Процес роботи
Аналітика → Проектування (схема даних, маппінг статусів) → Реалізація (iOS і Android паралельно) → Тестування (юніт-тести, UI-тести) → Деплой в App Store і Google Play.
Терміни орієнтовно
| Рівень інтеграції | Термін | Що входить |
|---|---|---|
| Базовий | 5–8 днів | Трекінг, ПВЗ, калькулятор |
| Повний | 2–3 тижні | + створення накладної API, друк накладних, вебхуки |
Вартість розраховується індивідуально, залежить від складності та вибраного стеку. Середній чек — $2000–$5000 для повної інтеграції. Гарантія якості — 90 днів. Наша команда сертифікована за ISO 27001.
Замовте консультацію з інтеграції — зв'яжіться з нами, щоб оцінити ваш проєкт. Ми покажемо реальний прототип на вашому додатку та запропонуємо оптимальне рішення.