Интеграция логистических сервисов DHL в мобильное приложение

Интеграция логистических сервисов DHL в мобильное приложение

Типичная ситуация: интернет-магазин с 5000 заказов в месяц тратит до 20 часов в неделю на ручное создание накладных и проверку статусов. Ошибки в расчёте объёмного веса приводят к переплате 30-50%, а выбор неверного API DHL блокирует отправку в отдельных регионах. Мы решаем эти проблемы с помощью интеграции DHL API — от выбора endpoint'ов до публикации в сторах. Автоматизация расчёта тарифов позволяет клиентам экономить до 20% на доставке за счёт выбора оптимального продукта DHL.

DHL Group объединяет несколько подразделений, у каждого свой API. Ошибка в выборе приводит к неработающему функционалу или неожиданным ошибкам авторизации.

Как выбрать подходящий API DHL для мобильного приложения?

Для большинства e-commerce приложений нужен DHL Express API (международные отправления) или DHL Parcel (доставка по Германии/Европе). DHL Express использует Basic Auth, а DHL Parcel — OAuth 2.0. Мы подскажем оптимальный вариант под вашу бизнес-модель.

Как работает авторизация в DHL API?

DHL Express API использует Basic Auth с учётными данными DHL аккаунта. В production нужен реальный аккаунт DHL Express с активированным API-доступом — sandbox и production используют разные credentials. DHL Parcel (новый API) работает через OAuth 2.0 Client Credentials Flow. Получаем access_token через POST /oauth/token и используем в каждом запросе. Токен живёт 3600 секунд — кэшируем и обновляем автоматически.

Расчёт тарифов: почему важен объёмный вес?

Endpoint для расчёта стоимости DHL Express:

GET /rates?accountNumber={account}&originCountryCode=RU &originCityName=Moscow&destinationCountryCode=DE &destinationCityName=Berlin&weight=2.5&length=30 &width=20&height=15&plannedShippingDateAndTime=YYYY-MM-DDTHH:MM:SS 

Возвращает список продуктов (EXPRESS WORLDWIDE, EXPRESS 12:00 и т.д.) с ценами и сроками доставки. В мобильном приложении показываем пользователю сравнение вариантов в виде списка.

Критичный момент: вес и габариты. DHL считает объёмный вес: (длина × ширина × высота) / 5000. Берётся максимум из фактического и объёмного веса. Согласно официальной документации DHL, неточность ввода размеров может увеличить стоимость на 30-50%. Приложение должно объяснять пользователю причину итогового веса. Подробнее о объёмном весе.

Как создать отправление и этикетку?

POST /shipments создаёт отправление и возвращает трек-номер и URL этикетки в формате PDF или ZPL (для термопринтеров). Для генерации этикетки в приложении на iOS используем WKWebView для рендеринга PDF или UIPrintInteractionController для прямой печати. На Android — PdfRenderer или интент на печать через PrintManager.

Трекинг в реальном времени: вебхуки или polling?

DHL Shipment Tracking API (GET /tracking/shipments?trackingNumber=...) возвращает полную историю событий с кодами и описаниями. Частота обновления: раз в 30 минут достаточно для большинства сценариев. Лимиты API в sandbox — 250 запросов в сутки.

Для push-уведомлений о статусе: DHL Tracking Webhook (доступен для enterprise-аккаунтов) отправляет события в реальном времени. Альтернатива — polling через WorkManager / BGAppRefreshTask. Webhook работает в 2 раза эффективнее polling'а по нагрузке на сервер.

Что входит в работу

• Подбор подходящего API DHL (Express, Parcel, eCommerce).
• Реализация авторизации (Basic Auth или OAuth 2.0).
• Интеграция расчёта тарифов и создание заказов.
• Генерация этикеток (PDF/ZPL) и печать.
• Трекинг с real-time уведомлениями.
• Тестирование в sandbox и production.
• Подготовка документации и обучение команды.

Каковы сроки интеграции DHL?

1. Анализ — уточняем требования, выбираем API, проектируем архитектуру (2-3 дня).
2. Интеграция — реализуем авторизацию, расчет, создание отправлений (1-2 недели).
3. Трекинг — добавляем polling или вебхуки, push-уведомления (1 неделя).
4. Тестирование — покрываем edge case'ы, нагрузочное тестирование (3-5 дней).
5. Публикация — загружаем в App Store / Google Play, обновляем конфигурации (2-4 дня).

Ориентировочные сроки: от 2 недель для базового трекинга и расчета до 4 недель для полного цикла с этикетками и вебхуками. Стоимость рассчитывается индивидуально по результатам аудита. Свяжитесь с нами для точной оценки вашего проекта.

Сравнение методов получения статуса доставки

Итог: webhook – лучший выбор для мобильных приложений с высокой нагрузкой.

Получите консультацию по интеграции DHL в ваше мобильное приложение – наш опыт и гарантия качества обеспечат стабильную работу. Экономия на операционных расходах может достигать 15-20% за счёт выбора оптимального тарифа и автоматизации. Окупаемость интеграции в течение 3-6 месяцев.