Інтеграція логістичних сервісів DHL у мобільний додаток

Інтеграція логістичних сервісів DHL у мобільний додаток

Типова ситуація: інтернет-магазин з 5000 замовлень на місяць витрачає до 20 годин на тиждень на ручне створення накладних та перевірку статусів. Помилки в розрахунку об'ємної ваги призводять до переплати 30-50%, а вибір невірного API DHL блокує відправлення в окремих регіонах. Наші спеціалісти мають понад 8 років досвіду в інтеграції логістичних API, реалізували 30+ успішних проектів. Ми вирішуємо ці проблеми за допомогою інтеграції 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=UA &originCityName=Kyiv&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 за навантаженням на сервер.

Практичний кейс

Для клієнта — інтернет-магазину електроніки з 3000 замовлень на місяць — ми інтегрували DHL Express API. Раніше співробітники витрачали 15 годин на тиждень на створення накладних вручну. Після інтеграції час скоротився до 1 години на перевірку помилок. Крім того, автоматичний вибір оптимального тарифу зменшив середню вартість доставки на 18%. Проект включав авторизацію, розрахунок вартості з урахуванням об'ємної ваги, генерацію етикеток та трекінг через webhook.

Що входить в роботу

• Підбір відповідного 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 місяців.