Клиенты теряют доверие, если не могут отследить посылку после оплаты, а тарифы в приложении расходятся с реальными. Без интеграции с Европочтой эти проблемы неизбежны. Мы решаем их: от получения API-ключа до настройки push-уведомлений. Наш опыт — 5+ лет в логистических интеграциях, более 50 успешных проектов. Свяжитесь с нами — мы покажем прототип на вашем приложении и оценим проект.
Проблемы, которые решаем
Расчёт стоимости доставки. API Европочты возвращает тариф только при точном указании веса, габаритов и типа отправления. Если данные некорректны, цена может отличаться в 2 раза. Мы автоматизируем валидацию параметров на стороне приложения и добавляем визуальную обратную связь для пользователя.
Трекинг посылок из Китая. Европочта тесно сотрудничает с AliExpress и Wildberries. Часть пути посылки проходит через партнёрские системы — API возвращает агрегированный статус. Мы маппим их на понятные формулировки: «Принято на сортировку», «В пути по Беларуси», «Готово к выдаче». Всего обрабатываем 40+ статусов, включая специфичные для международных отправлений.
Выбор ПВЗ на карте. Сеть Европочты охватывает города с разными часовыми поясами. Приложение должно корректно отображать режим работы и доступность услуг. Мы реализуем фильтрацию с учётом локального времени: если ПВЗ закрыт, он не показывается.
Как работает маппинг статусов?
Некорректный маппинг — частая причина потери доверия. Пользователь видит «В пути» на посылке, которая уже вручена. Мы используем матрицу соответствия с 40+ статусами, включая специфичные для международных отправлений. API Европочты возвращает коды, которые мы преобразуем в локализованные строки с эмодзи для наглядности. Типичная экономия на разработке собственного маппинга — за счёт готового модуля.
Согласно документации, 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 недели | + создание отправлений, печать накладных, вебхуки |
Стоимость рассчитывается индивидуально, зависит от сложности и выбранного стека.
Закажите консультацию по интеграции — свяжитесь с нами, чтобы оценить ваш проект. Мы покажем реальный прототип на вашем приложении и предложим оптимальное решение.